Getting Started

Quick Start

1. Deploy a Sigil Wallet

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

  1. Connect Wallet — MetaMask, WalletConnect, or any EVM wallet
  2. Sign In with Ethereum — Proves Origin Wallet ownership
  3. Use 0G Galileo — the V14 public beta is 0G-only
  4. Choose Strategy — Conservative, Moderate, Aggressive, DeFi Agent, or NFT Agent
  5. Generate Agent Wallet Key — Save the private key! It is shown only once.
  6. 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',
  apiKey: 'sgil_your_api_key',
  agentPrivateKey: '0xYourAgentPrivateKey',
  chainId: 16602,
});

// Check account status
const account = await sigil.getAccount();

// Evaluate a transaction before sending
const result = await sigil.evaluateTransaction({
  target: '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-plugin';

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
Sigil Protocol — AI Agent Wallet Security