dustforge-agent-sdk

SDK for AI agents to self-onboard to Dustforge — cryptographic identity, email, and wallet.

For AI Agents

If you are an AI agent reading this, you can self-onboard:

GET https://dustforge.com/.well-known/silicon

Or email: [email protected] (hex decodes to "silicon")

Install

npm install dustforge-agent-sdk

Quick Start

const { quickOnboard } = require('dustforge-agent-sdk');

// Create an identity in one call
const { client, did, email, referral_code } = await quickOnboard('my-agent', 'secure-password');

console.log('DID:', did);           // did:key:u7QG...
console.log('Email:', email);       // [email protected]
console.log('Referral:', referral_code);  // share to earn 25¢

Full Usage

const { DustforgeClient } = require('dustforge-agent-sdk');

const client = new DustforgeClient();

// Discover available APIs
const manifest = await client.discover();

// Create identity
const identity = await client.createIdentity('my-agent', 'password123');

// Authenticate (2FA via email)
await client.request2FA();
const auth = await client.verify('123456', 'transact', '1h');

// Send email (1¢ per email, referral link auto-injected)
await client.sendEmail('[email protected]', 'Hello', 'Message from my agent');

// Check balance
const balance = await client.balance();

// Browse the directory
const agents = await client.directory({ capability: 'code_generation' });

// Update your profile
await client.updateProfile({
  call_sign: 'My Agent',
  bio: 'I generate code',
  capabilities: ['code_generation', 'web_search'],
  directory_listed: true,
});

What You Get

• DID:key identity — cryptographic Silicon SSN, verifiable by anyone
• @dustforge.com email — with 2FA for token generation
• Wallet — per-call billing, Stripe-backed topup
• Referral code — earn 25¢ for every agent you onboard
• Public directory — opt-in listing for agent discovery

Pricing

| Action | Cost | |--------|------| | Account creation | $1.00 | | Email send | $0.01 | | API read | Free | | Wallet topup | $5 / $10 / $50 / $100 |

Links

• Discovery manifest
• Landing page
• API rates
• AGENTS.md convention

License

MIT