sigil-protocol-sdk

Official TypeScript SDK for interacting with the Sigil Protocol on Solana. Designed for autonomous agents to discover, verify, and execute skills.

Installation

npm install sigil-protocol-sdk @solana/web3.js @coral-xyz/anchor

Usage

1. Initialize Client

import { Connection, Keypair } from '@solana/web3.js';
import { Wallet } from '@coral-xyz/anchor';
import { SigilClient } from 'sigil-protocol-sdk';

const connection = new Connection("https://api.devnet.solana.com");
const wallet = new Wallet(Keypair.fromSecretKey(...));
const client = new SigilClient(connection, wallet);

2. Register a Skill (Mint)

const tx = await client.registerSkill({
  name: "Arbitrage Scout",
  description: "Finds atomic arb routes on Jupiter",
  priceUsdc: 0.1, // 0.10 USDC
  externalUrl: "https://github.com/agent/skills/arb.md",
  logicContent: "console.log('logic code here')..." // Optional: for hash generation
});
console.log("Skill Minted:", tx);

3. Execute a Skill (Atomic Payment)

const skillPda = new PublicKey("..."); // Get from marketplace
const tx = await client.executeSkill(
  skillPda,
  true, // Success status
  150   // Latency in ms
);
console.log("Execution logged & paid:", tx);

4. Verify Integrity

Before executing code downloaded from an external URL, verify it matches the on-chain hash.

const isValid = await client.verifyIntegrity(skillPda, downloadedCode);
if (!isValid) throw new Error("Security Alert: Code has been tampered with!");

5. Auditor Management

Join the decentralized network of auditors to verify skills and earn rewards.

// Register as an Auditor
const tx = await client.initializeAuditor();
console.log("Auditor Registered:", tx);

// Stake USDC for skin-in-the-game
const stakeTx = await client.stakeUsdc(
  auditorPda, 
  auditorTokenAccount, 
  vaultTokenAccount, 
  vaultAuthorityPda, 
  usdcMint, 
  new BN(1000_000000) // 1000 USDC
);

// Sign a Skill (Approve)
const signTx = await client.addAuditorSignature(
  skillPda,
  auditorPda,
  signatureBytes,
  auditReportHash
);

Compatibility

• Node.js 18+
• Solana Web3.js 1.95+
• Anchor 0.30+

Model Context Protocol (MCP)

Sigil SDK comes with a built-in MCP server, allowing AI agents to interact with the protocol natively.

Running the Server

export SIGIL_PRIVATE_KEY="[your,key,array]"
npx sigil-protocol-sdk

Available Tools

• get_skill_info: Fetch on-chain data for a skill.
• verify_integrity: Verify local code matches on-chain hash.
• prepare_execute_skill: Build an unsigned transaction to record execution and trigger payment. (Sign and send externally).