Getting Started

Quick Start

1. Deploy a Sigil Wallet

Visit sigil.codes/login to deploy your Sigil Wallet:

  • Connect Wallet — MetaMask, WalletConnect, or any EVM wallet
  • Sign In with Ethereum — Proves Origin Wallet ownership
  • Choose Chain — Polygon, Avalanche, Base, Arbitrum, or 0G Mainnet
  • Choose Strategy — Conservative, Moderate, Aggressive, DeFi Agent, or NFT Agent
  • Generate Agent Wallet Key — Save the private key! It is shown only once.
  • Deploy — One-time fee, no subscriptions
  • 2. Fund Your Wallets

    Your setup has two wallets that both need funding:

    WalletWhat to sendWhy
    Sigil Wallet (smart account)Native tokens + trading tokens (USDC, etc.)This is where your funds live. All agent transactions execute from this address.
    Agent Wallet (EOA)Small amount of native token ($2-5 worth)Your agent needs gas to submit UserOps to the network. Without gas here, nothing works.

    Both addresses are shown in the post-deploy checklist and on the dashboard.

    3. Share the Agent Private Key with Your AI

    ⚠️ This is the most important step. Your AI agent needs the private key from Step 5 to sign transactions locally. Without it, the agent can authenticate but cannot execute any trades.

    Add these to your agent's environment or config file:

    # Agent signs transactions locally with this key
    

    SIGIL_AGENT_PRIVATE_KEY=0x_your_agent_private_key_from_step_5

    API key for Guardian authentication (generate at Agent Access page)

    SIGIL_API_KEY=sgil_your_api_key

    Your Sigil smart wallet address

    SIGIL_WALLET_ADDRESS=0xYourSigilWallet

    Chain ID

    SIGIL_CHAIN_ID=137

    API endpoint

    SIGIL_API_URL=https://api.sigil.codes

    Security note: The agent key can ONLY submit transactions for Guardian approval. Even if compromised, the Guardian's 3-layer pipeline protects your funds. You can revoke the agent key instantly from the dashboard.

    4. Integrate Your Agent

    import { SigilSDK } from '@sigil-protocol/sdk';
    
    

    const sigil = new SigilSDK({

    apiUrl: 'https://api.sigil.codes', accountAddress: '0xYourSigilAccount', agentKey: '0xYourAgentPrivateKey', chainId: 43114, }); // Check account status

    const account = await sigil.getAccount();

    // Evaluate a transaction before sending

    const result = await sigil.evaluateTransaction({

    to: '0xTarget', value: '100000000000000000', // 0.1 AVAX data: '0x', });

    if (result.verdict === 'APPROVED') {

    // Transaction is safe — submit it // Guardian approved, signature available in result.guardianSignature }

    5. Or Use the Eliza Plugin

    import { sigilPlugin } from '@sigil-protocol/eliza';
    
    

    const plugin = sigilPlugin({

    apiUrl: 'https://api.sigil.codes', accountAddress: '0xYourSigilAccount', rpcUrl: 'https://api.avax.network/ext/bc/C/rpc', }); // Plugin provides 13 actions: // send, evaluate, freeze, unfreeze, rotateKey, // createSessionKey, updatePolicy, addTarget, // removeTarget, getStatus, getHistory, and more