8004-Solana

npm install 8004-solana

export SOLANA_PRIVATE_KEY='[1,2,3,...,64]'  # JSON array format
export PINATA_JWT='your-jwt-token'          # Optional: for IPFS uploads

import { SolanaSDK, IPFSClient, buildRegistrationFileJson, ServiceType } from '8004-solana';
import { Keypair } from '@solana/web3.js';

const signer = Keypair.fromSecretKey(
  Uint8Array.from(JSON.parse(process.env.SOLANA_PRIVATE_KEY!))
);

const ipfs = new IPFSClient({
  pinataEnabled: true,
  pinataJwt: process.env.PINATA_JWT!,
});

const sdk = new SolanaSDK({ signer, ipfsClient: ipfs });

const collection = await sdk.createCollection({
  name: 'My Agent Collection',
  symbol: 'AGENTS',
  description: 'A collection of autonomous agents',
  image: 'ipfs://QmCollectionImage...',
  socials: {
    website: 'https://my-project.com',
    x: 'https://x.com/my-project',
  },
});

console.log('Collection CID:', collection.cid);
console.log('Collection Pointer:', collection.pointer);

const metadata = buildRegistrationFileJson({
  name: 'My AI Agent',
  description: 'An autonomous agent on Solana',
  image: 'ipfs://QmYourImageCid...',
  services: [
    { type: ServiceType.MCP, value: 'https://my-agent.com/mcp' },
    { type: ServiceType.A2A, value: 'https://my-agent.com/a2a' },
  ],
  skills: ['natural_language_processing/text_generation/text_generation'],
  domains: ['technology/software_engineering/software_engineering'],
});

const cid = await ipfs.addJson(metadata);

const result = await sdk.registerAgent(`ipfs://${cid}`, {
  collectionPointer: collection.pointer,
  atomEnabled: false, // Set to true to enable ATOM during registration
});
console.log('Agent:', result.asset.toBase58());

const opWallet = Keypair.generate();
await sdk.setAgentWallet(result.asset, opWallet);
console.log('Wallet:', opWallet.publicKey.toBase58());

const readSdk = new SolanaSDK();
const agent = await readSdk.loadAgent(result.asset);

console.log('Name:', agent.nft_name);
console.log('Owner:', agent.getOwnerPublicKey().toBase58());
console.log('URI:', agent.agent_uri);

// Give feedback
await sdk.giveFeedback(agentAsset, {
  value: '99.5',       // Auto-encoded: value=995, decimals=1
  tag1: 'uptime',      // Category tag
  tag2: 'day',         // Period tag
  feedbackUri: 'ipfs://QmFeedback...',
});

// Check reputation
const summary = await sdk.getSummary(agentAsset);
console.log(`Score: ${summary.averageScore}, Feedbacks: ${summary.totalFeedbacks}`);

// Sign data with agent's operational wallet
const signed = sdk.sign(agentAsset, { action: 'authorize', user: 'alice' });
const isValid = await sdk.verify(signed, agentAsset);