@moltlaunch/sdk 2.4.0 → 3.0.0

package/dist/client.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * MoltLaunch V3 — SDK Client
+ *
+ * High-level API for interacting with the on-chain Composable Signal Architecture.
+ * Program: 6AZSAhq4iJTwCfGEVssoa1p3GnBqGkbcQ1iDdP1U1pSb (devnet)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoltLaunchClient = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const anchor_1 = require("@coral-xyz/anchor");
+const types_1 = require("./types");
+const pda_1 = require("./pda");
+const moltlaunch_json_1 = __importDefault(require("./idl/moltlaunch.json"));
+// ── Helpers ─────────────────────────────────────────────────────────
+function mapInfraType(raw) {
+    if ("cloud" in raw)
+        return types_1.InfraType.Cloud;
+    if ("tee" in raw || "TEE" in raw)
+        return types_1.InfraType.TEE;
+    if ("dePIN" in raw || "dePin" in raw || "depin" in raw)
+        return types_1.InfraType.DePIN;
+    return types_1.InfraType.Unknown;
+}
+function mapSignalType(raw) {
+    if ("infraCloud" in raw)
+        return types_1.SignalType.InfraCloud;
+    if ("infraTEE" in raw || "infraTee" in raw)
+        return types_1.SignalType.InfraTEE;
+    if ("infraDePIN" in raw || "infraDePin" in raw || "infraDepin" in raw)
+        return types_1.SignalType.InfraDePIN;
+    if ("economicStake" in raw)
+        return types_1.SignalType.EconomicStake;
+    if ("hardwareBinding" in raw)
+        return types_1.SignalType.HardwareBinding;
+    return types_1.SignalType.General;
+}
+function mapAuthorityType(raw) {
+    if ("multisigMember" in raw)
+        return types_1.AuthorityType.MultisigMember;
+    if ("oracleOperator" in raw)
+        return types_1.AuthorityType.OracleOperator;
+    if ("ncnValidator" in raw || "NCNValidator" in raw)
+        return types_1.AuthorityType.NCNValidator;
+    return types_1.AuthorityType.Single;
+}
+// ── Client ──────────────────────────────────────────────────────────
+class MoltLaunchClient {
+    connection;
+    programId;
+    program;
+    provider;
+    constructor(opts = {}) {
+        const rpcUrl = opts.rpcUrl ?? types_1.DEVNET_RPC;
+        const commitment = opts.commitment ?? "confirmed";
+        this.connection = new web3_js_1.Connection(rpcUrl, commitment);
+        this.programId = types_1.MOLTLAUNCH_PROGRAM_ID;
+        // Build provider — read-only if no wallet supplied
+        const wallet = opts.wallet ?? {
+            publicKey: web3_js_1.PublicKey.default,
+            signTransaction: async (tx) => tx,
+            signAllTransactions: async (txs) => txs,
+        };
+        this.provider = new anchor_1.AnchorProvider(this.connection, wallet, {
+            commitment,
+        });
+        this.program = new anchor_1.Program(moltlaunch_json_1.default, this.provider);
+    }
+    // ── Read Operations ─────────────────────────────────────────────
+    /** Fetch the singleton ProtocolConfig account */
+    async getConfig() {
+        const [pda] = (0, pda_1.findConfigPda)();
+        const raw = await this.program.account.protocolConfig.fetch(pda);
+        return {
+            admin: raw.admin,
+            revocationNonce: BigInt(raw.revocationNonce.toString()),
+            totalAgents: BigInt(raw.totalAgents.toString()),
+            totalAttestations: BigInt(raw.totalAttestations.toString()),
+            paused: raw.paused,
+            bump: raw.bump,
+        };
+    }
+    /** Fetch an AgentIdentity by wallet public key */
+    async getAgentIdentity(wallet) {
+        const [pda] = (0, pda_1.findAgentPda)(wallet);
+        const raw = await this.program.account.agentIdentity.fetch(pda);
+        return {
+            wallet: raw.wallet,
+            infraType: mapInfraType(raw.infraType),
+            hasEconomicStake: raw.hasEconomicStake,
+            hasHardwareBinding: raw.hasHardwareBinding,
+            attestationCount: raw.attestationCount,
+            isFlagged: raw.isFlagged,
+            trustScore: raw.trustScore,
+            lastVerified: BigInt(raw.lastVerified.toString()),
+            nonce: BigInt(raw.nonce.toString()),
+            registeredAt: BigInt(raw.registeredAt.toString()),
+            name: raw.name,
+            bump: raw.bump,
+        };
+    }
+    /** Fetch an Authority account */
+    async getAuthority(pubkey) {
+        const [pda] = (0, pda_1.findAuthorityPda)(pubkey);
+        const raw = await this.program.account.authority.fetch(pda);
+        return {
+            pubkey: raw.pubkey,
+            authorityType: mapAuthorityType(raw.authorityType),
+            attestationCount: BigInt(raw.attestationCount.toString()),
+            active: raw.active,
+            addedBy: raw.addedBy,
+            addedAt: BigInt(raw.addedAt.toString()),
+            bump: raw.bump,
+        };
+    }
+    /** Fetch an Attestation account */
+    async getAttestation(agentWallet, authorityPubkey) {
+        const [pda] = (0, pda_1.findAttestationPda)(agentWallet, authorityPubkey);
+        const raw = await this.program.account.attestation.fetch(pda);
+        return {
+            agent: raw.agent,
+            authority: raw.authority,
+            authorityType: mapAuthorityType(raw.authorityType),
+            signalContributed: mapSignalType(raw.signalContributed),
+            attestationHash: Array.from(raw.attestationHash),
+            teeQuote: raw.teeQuote ? Array.from(raw.teeQuote) : null,
+            createdAt: BigInt(raw.createdAt.toString()),
+            expiresAt: BigInt(raw.expiresAt.toString()),
+            revoked: raw.revoked,
+            bump: raw.bump,
+        };
+    }
+    // ── Write Operations ────────────────────────────────────────────
+    /**
+     * Register a new agent identity on-chain.
+     * Signer = the agent's wallet keypair.
+     */
+    async registerAgent(name, walletKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [agentPda] = (0, pda_1.findAgentPda)(walletKeypair.publicKey);
+        const tx = await this.program.methods
+            .registerAgent(name)
+            .accounts({
+            config: configPda,
+            agent: agentPda,
+            wallet: walletKeypair.publicKey,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .signers([walletKeypair])
+            .rpc();
+        return tx;
+    }
+    /**
+     * Submit an attestation for an agent.
+     * Signer = the authority's keypair.
+     */
+    async submitAttestation(agentWallet, signalType, attestationHash, expiresAt, authorityKeypair, teeQuote) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [authorityPda] = (0, pda_1.findAuthorityPda)(authorityKeypair.publicKey);
+        const [agentPda] = (0, pda_1.findAgentPda)(agentWallet);
+        const [attestationPda] = (0, pda_1.findAttestationPda)(agentWallet, authorityKeypair.publicKey);
+        const hashArr = Array.from(attestationHash);
+        const teeArr = teeQuote ? Array.from(teeQuote) : null;
+        const tx = await this.program.methods
+            .submitAttestation((0, types_1.toAnchorEnum)(signalType), hashArr, teeArr, new anchor_1.BN(expiresAt.toString()))
+            .accounts({
+            config: configPda,
+            authority: authorityPda,
+            agent: agentPda,
+            attestation: attestationPda,
+            authoritySigner: authorityKeypair.publicKey,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .signers([authorityKeypair])
+            .rpc();
+        return tx;
+    }
+    /**
+     * Revoke an attestation (only the original authority can revoke).
+     */
+    async revokeAttestation(agentWallet, authorityKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [attestationPda] = (0, pda_1.findAttestationPda)(agentWallet, authorityKeypair.publicKey);
+        const tx = await this.program.methods
+            .revokeAttestation()
+            .accounts({
+            config: configPda,
+            attestation: attestationPda,
+            authoritySigner: authorityKeypair.publicKey,
+        })
+            .signers([authorityKeypair])
+            .rpc();
+        return tx;
+    }
+    /**
+     * Refresh an agent's trust signals (permissionless — anyone can call).
+     */
+    async refreshSignals(agentWallet, signerKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [agentPda] = (0, pda_1.findAgentPda)(agentWallet);
+        const builder = this.program.methods
+            .refreshIdentitySignals()
+            .accounts({
+            config: configPda,
+            agent: agentPda,
+        });
+        if (signerKeypair) {
+            builder.signers([signerKeypair]);
+        }
+        return builder.rpc();
+    }
+    /**
+     * Flag an agent (authority-only).
+     */
+    async flagAgent(agentWallet, reasonHash, authorityKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [authorityPda] = (0, pda_1.findAuthorityPda)(authorityKeypair.publicKey);
+        const [agentPda] = (0, pda_1.findAgentPda)(agentWallet);
+        const tx = await this.program.methods
+            .flagAgent(Array.from(reasonHash))
+            .accounts({
+            config: configPda,
+            authority: authorityPda,
+            agent: agentPda,
+            authoritySigner: authorityKeypair.publicKey,
+        })
+            .signers([authorityKeypair])
+            .rpc();
+        return tx;
+    }
+    /**
+     * Unflag an agent (admin-only).
+     */
+    async unflagAgent(agentWallet, adminKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [agentPda] = (0, pda_1.findAgentPda)(agentWallet);
+        const tx = await this.program.methods
+            .unflagAgent()
+            .accounts({
+            config: configPda,
+            agent: agentPda,
+            admin: adminKeypair.publicKey,
+        })
+            .signers([adminKeypair])
+            .rpc();
+        return tx;
+    }
+    // ── Admin Operations ────────────────────────────────────────────
+    /** Initialize the protocol (admin, one-time) */
+    async initialize(adminKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const tx = await this.program.methods
+            .initialize()
+            .accounts({
+            config: configPda,
+            admin: adminKeypair.publicKey,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .signers([adminKeypair])
+            .rpc();
+        return tx;
+    }
+    /** Add an authority (admin-only) */
+    async addAuthority(authorityPubkey, authorityType, adminKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [authorityPda] = (0, pda_1.findAuthorityPda)(authorityPubkey);
+        const tx = await this.program.methods
+            .addAuthority((0, types_1.toAnchorEnum)(authorityType))
+            .accounts({
+            config: configPda,
+            authority: authorityPda,
+            authorityPubkey: authorityPubkey,
+            admin: adminKeypair.publicKey,
+            systemProgram: web3_js_1.SystemProgram.programId,
+        })
+            .signers([adminKeypair])
+            .rpc();
+        return tx;
+    }
+    /** Remove an authority (admin-only) */
+    async removeAuthority(authorityPubkey, adminKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const [authorityPda] = (0, pda_1.findAuthorityPda)(authorityPubkey);
+        const tx = await this.program.methods
+            .removeAuthority()
+            .accounts({
+            config: configPda,
+            authority: authorityPda,
+            admin: adminKeypair.publicKey,
+        })
+            .signers([adminKeypair])
+            .rpc();
+        return tx;
+    }
+    /** Pause / unpause protocol (admin-only) */
+    async setPaused(paused, adminKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const tx = await this.program.methods
+            .setPaused(paused)
+            .accounts({
+            config: configPda,
+            admin: adminKeypair.publicKey,
+        })
+            .signers([adminKeypair])
+            .rpc();
+        return tx;
+    }
+    /** Transfer admin to a new pubkey (admin-only) */
+    async transferAdmin(newAdmin, adminKeypair) {
+        const [configPda] = (0, pda_1.findConfigPda)();
+        const tx = await this.program.methods
+            .transferAdmin(newAdmin)
+            .accounts({
+            config: configPda,
+            admin: adminKeypair.publicKey,
+        })
+            .signers([adminKeypair])
+            .rpc();
+        return tx;
+    }
+}
+exports.MoltLaunchClient = MoltLaunchClient;