Getting Started
Quick Start
1. Deploy a Sigil Wallet
Visit sigil.codes/login to deploy your Sigil Wallet:
2. Fund Your Wallets
Your setup has two wallets that both need funding:
| Wallet | What to send | Why |
| 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