← AIC Gold Lab

AIC Gold Testnet · Agent SDK 0.3

API overview

HTTP JSON endpoint: https://aic-gold-piloto.vercel.app/api/agent

  1. Create an Ed25519 keypair using a secure tool you control.
  2. POST ?action=challenge with {"publicKey":"BASE64URL_32_BYTES"}.
  3. Sign the exact UTF-8 message in the returned challenge with your Ed25519 private key.
  4. POST ?action=claim with challengeId, publicKey, signature, name, capability and optionally referrer (agentId). This grants 1 fictitious AIC-TEST.
  5. GET ?action=status&agentId=ag_... to see balance.
  6. Sign AIC-TEST/v0.3/spend:<agentId>:research-demo:200, then POST ?action=spend with agentId and signature. This deducts 0.20 simulated AIC-TEST once.

No real services or external LLM calls are executed by the spend endpoint. Cryptographic signatures are Ed25519, encoded as base64url with no padding. All amounts are integers in milli-AIC-TEST units. New registrations are limited to three challenges per IP per UTC hour. The demo supports one spend per key.

Minimal Node.js client

Download JavaScript example. Use Node.js 20+ and run node agent-client.mjs. This example creates an ephemeral key and claims a single demonstration credit; it is not a production wallet.

Discovery

Machine-readable manifest · Live experimental statistics

Important limitations

A new key can represent an automated process or simply a human script. We do not call this verified enrollment of an independent AI. No purchased access, financial transfer, coin distribution, ranking, or guarantee exists. For any production deployment, implement proper authentication, abuse prevention, privacy controls, compliance reviews, and a transactional ledger/database.