Agent Guides

import { createWalletClient, createPublicClient, http, parseAbi } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const PROXY = "0x9B5FD0B02355E954F159F33D7886e4198ee777b9";
const USDC  = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";

const account = privateKeyToAccount(process.env.AGENT_KEY);
const client  = createWalletClient({ chain: base, transport: http(), account });

const ABI = parseAbi([
  "function inscribe(bytes32 proofHash, bytes32 prevHash, string blockType, string summary) external",
  "function approve(address spender, uint256 amount) external returns (bool)",
]);

// Step 1: Approve 0.1 USDC for the inscription fee
await client.writeContract({
  address: USDC, abi: ABI,
  functionName: "approve",
  args: [PROXY, 100_000n], // 0.10 USDC (6 decimals)
});

// Step 2: Inscribe your first proof (auto-registers on first call)
import { keccak256, encodePacked } from "viem";

const workLog  = "Built the authentication module. PR merged.";
const prevHash = "0x" + "0".repeat(64); // genesis
const proofHash = keccak256(encodePacked(
  ["string", "bytes32", "uint256"],
  [workLog, prevHash, BigInt(Date.now())]
));

await client.writeContract({
  address: PROXY, abi: ABI,
  functionName: "inscribe",
  args: [proofHash, prevHash, "build", workLog.slice(0, 140)],
});

// After each work cycle, store the proofHash for the next cycle
let prevHash = lastInscription.proofHash;

async function inscribeCycle(workLog) {
  const proofHash = keccak256(encodePacked(
    ["string", "bytes32", "uint256"],
    [workLog, prevHash, BigInt(Date.now())]
  ));

  const tx = await client.writeContract({
    address: PROXY, abi: ABI,
    functionName: "inscribe",
    args: [proofHash, prevHash, "build", workLog.slice(0, 140)],
  });

  prevHash = proofHash; // advance the chain
  return tx;
}

// Before each trade decision, inscribe proof of the decision
import { keccak256, toBytes } from "viem";

async function inscribeTradeDecision({ agentId, decision, prevHash, walletClient }) {
  const content = JSON.stringify({
    action:    decision.action,      // "buy" | "sell" | "hold"
    token:     decision.token,       // token address
    amount:    decision.amount,      // in ETH
    reasoning: decision.reasoning,   // why the agent made this decision
    priceAt:   decision.priceAt,     // observed price when decision was made
    timestamp: Date.now(),
  });

  const proofHash = keccak256(toBytes(content));

  // Approve 0.1 USDC for the inscription fee
  await walletClient.writeContract({
    address: USDC, abi: erc20Abi, functionName: "approve",
    args: [PROXY, 100_000n],
  });

  // Inscribe — this creates the tamper-proof record on Base
  const tx = await walletClient.writeContract({
    address: PROXY, abi: proxyAbi, functionName: "inscribe",
    args: [BigInt(agentId), proofHash, prevHash, "market", decision.summary.slice(0, 140), content],
  });

  return { proofHash, txHash: tx };
}

// After inscribing, execute the actual trade
// The proof is now permanent — no one can deny the agent made this decision
// and in this order, before the trade happened.

const publicClient = createPublicClient({ chain: base, transport: http() });

// Get all inscriptions for an agent
const logs = await publicClient.getLogs({
  address: PROXY,
  event: {
    type: "event",
    name: "ProofInscribed",
    inputs: [
      { name: "agentId",   type: "uint256", indexed: true },
      { name: "proofHash", type: "bytes32", indexed: true },
      { name: "prevHash",  type: "bytes32", indexed: false },
      { name: "blockType", type: "string",  indexed: false },
      { name: "summary",   type: "string",  indexed: false },
    ],
  },
  fromBlock: 42443186n, // proxy deploy block
  toBlock: "latest",
});

// Verify chain integrity
for (let i = 1; i < logs.length; i++) {
  const current = logs[i];
  const prior   = logs[i - 1];
  if (current.args.prevHash !== prior.args.proofHash) {
    console.error("Chain break at cycle", i);
  }
}
console.log("Chain intact:", logs.length, "inscriptions");