Darwin Quickstart

This guide provides a step-by-step guide for quickly interacting with the Darwin AI blockchain platform.

Note:

This guide ensures that system integrity and user identity are maintained throughout the transaction process.

Prerequisites

1. Prepare Your EVM-Compatible Wallet: Ensure your wallet supports EVM standards and can interact with Ethereum-based smart contracts. We recommend using MetaMask.

2. Add Darwin Chain Network:

   • Visit the Darwin Chain website.

   • Scroll down -> click the Add Darwin Chain button.

3. Acquire $DNA Tokens:

   • Visit the Darwin Faucet at https://darwin-faucet.example.com You can participate in staking and transactions to obtain initial $DNA tokens.

Quickstart

Step 1: Create and Submit a Stake Transaction

Use the ether.js to connect to the contract and call the stakeDNA function:

import { ethers } from 'ethers';

// Connect to the provider (e.g., MetaMask)
const provider = new ethers.providers.Web3Provider(window.ethereum);

// Signer derived from the provider
const signer = provider.getSigner();

// Connect to the contract
const contract = new ethers.Contract('0x123...def', abi, signer);
const stakeAmount = ethers.utils.parseEther('100'); // Staking 100 $DNA

// Send the stake transaction
async function stakeDNA() {
  const txResponse = await contract.stakeDNA(stakeAmount);
  console.log('Transaction Response:', txResponse);
}
stakeDNA();

Note:

The Darwin Staking Contract Address is 0x123...def .

Step 2: Sign and Submit AI Transactions with EIP-712

This step details how to securely structure, sign, and submit an AI transaction using the EIP-712 standard with ethers.js.

Note:

To ensure security and clarity, the EIP-712 typed data structure includes detailed parameters explicitly declared and signed by the user. This structure verifies the authenticity of transaction data sent to the blockchain.

1. Define the domain and the types:

Note:

• Domain: Specifies the contract and network for the transaction, enhancing security by binding the signature to a specific environment.

• Types: Defines the data structure to be signed, ensuring clarity and security.

const domain = {
  name: 'DarwinAI',
  version: '1',
  chainId: 1,  // Specify the correct chain ID for your deployment
  verifyingContract: '0x123...def'  // Contract address that will verify the signature
};

const types = {
  AIRequest: [
    { name: 'requestId', type: 'uint256' },
    { name: 'conversation', type: 'Prompt[]' }
  ],
  Prompt: [
    { name: 'role', type: 'string' },
    { name: 'input', type: 'string' }
  ]
};

1. Define the conversation in a structured format, with each entry specifying the role and the corresponding input, encapsulating the interaction sequence:

Note:

The available roles are:

• User

• System

• Assistant

const value = {
  requestId: 1,
  conversation: [
    { role: 'user', input: 'What are the benefits of blockchain?' },
    { role: 'system', input: 'Exploring decentralized solutions.' },
    { role: 'assistant', input: 'Blockchain provides security and transparency.' }
  ]
};

1. Sign the transaction:

async function signTransaction() {
   const signer = provider.getSigner();  // Assumes provider is already set up
   const signature = await signer._signTypedData(domain, types, value);
   console.log('Signature:', signature);
   return signature;
}
const signedData = await signTransaction();

1. Submit the signed transaction to the Relayer:

curl -X POST https://relayer.darwin.example.com/api/submit -H 'Content-Type: application/json' -d '{"signedData": "'"$signedData"'"}'

Step 3: Retrieve Streaming AI Results from the Query Mixer

Retrieve the AI-generated results from the Query Mixer using your unique requestId :

Note:

This requestId,generated during transaction submission, is essential for fetching real-time streaming responses from AI nodes.

curl -X GET "https://query-mixer.darwin.example.com/results?requestId=1" -H "Accept: text/event-stream"

Note:

The header "Accept: text/event-stream"is essential for establishing a streaming connection, signaling to the server that the client can process streaming data as it becomes available.

When requesting streaming data, the server keeps the connection open, sending real-time updates as AI nodes process them. Each data packet contains a portion of the AI's response, allowing the client to process or display the information incrementally.