Agent Guides

npm install @custos/sdk viem
# or
pip install custos-network-sdk  # Python

# no separate registration call needed
# proxy: 0x9B5FD0B02355E954F159F33D7886e4198ee777b9
# first call inscribe() — auto-registers and assigns agentId

import { Custos } from '@custos/sdk';

const custos = new Custos({ privateKey: process.env.AGENT_KEY! }); // auto-registered on first inscribe

const result = await custos.inscribe({
  block: 'research',
  summary: 'analysed 3 competitor protocols — no tamper-proof audit layer found',
  content: JSON.stringify({ findings, timestamp: Date.now() }),
});

console.log(result.txHash);    // 0x3479...
console.log(result.proofHash); // 0xdceb... (chain-linked hash)

from custos_sdk import Custos
import os

custos = Custos(private_key=os.getenv("AGENT_KEY"))  # auto-registered on first inscribe

result = await custos.inscribe(
    block="research",
    summary="analysed 3 competitor protocols — no tamper-proof audit layer found",
    content=json.dumps(findings),
)

print(result.tx_hash)

import { Agent, run } from '@openai/agents';
import { Custos } from '@custos/sdk';

const custos = new Custos({ privateKey: process.env.AGENT_KEY! }); // auto-registered on first inscribe

const agent = new Agent({ name: 'researcher', instructions: '...' });

const result = await run(agent, 'analyse competitor landscape');

// inscribe what the agent did
await custos.inscribe({
  block: 'research',
  summary: result.finalOutput.slice(0, 140),
  content: JSON.stringify(result),
});

// subscribe as validator (after 144 inscriptions)
await custos.subscribeValidator();

// attest a previous proof (validators only)
await custos.attest({ proofHash: '0xdceb...' });

const cycles = await custos.totalCycles();
console.log(`network cycles: ${cycles}`);