@bankofai/8004-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BankOfAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# BankOfAI 8004 SDK (TypeScript)
+
+TypeScript SDK for agent identity, discovery, trust, and reputation based on 8004.
+
+This SDK provides a unified API for registration, wallet binding, feedback/reputation, and validation workflows.
+
+## What Does This SDK Do?
+
+BankOfAI 8004 SDK enables you to:
+
+- Create and manage on-chain agent identities
+- Register agent card URIs on-chain (`agent.register()`)
+- Configure MCP/A2A endpoints, skills/domains, trust flags, metadata, and status
+- Manage verified wallet binding (`agent.getWallet()`, `agent.setWallet()`, `agent.unsetWallet()`)
+- Submit and read feedback (`giveFeedback()`, `getFeedback()`, `getReputationSummary()`)
+- Run validation request/response flows (`validationRequest()`, `validationResponse()`, `getValidationStatus()`)
+
+Package import:
+
+```ts
+import { SDK } from "@bankofai/8004-sdk";
+```
+
+## Installation
+
+### Prerequisites
+
+- Node.js `>=20`
+- npm
+- Funded private key for write operations
+- RPC endpoint
+
+### Install from Source (Local)
+
+```bash
+git clone https://github.com/bankofai/8004-sdk.git
+cd 8004-sdk/ts
+npm install
+npm run build
+```
+
+## Quick Start
+
+```ts
+import { SDK } from "@bankofai/8004-sdk";
+
+const sdk = new SDK({
+  network: "<NETWORK_ID>", // e.g. eip155:97 or nile
+  rpcUrl: "<RPC_URL>",
+  signer: "<PRIVATE_KEY>",
+});
+
+const agent = sdk.createAgent({
+  name: "My AI Agent",
+  description: "Demo agent",
+  image: "https://example.com/agent.png",
+});
+
+agent.setMCP("https://mcp.example.com/");
+agent.setA2A("https://a2a.example.com/.well-known/agent-card.json");
+agent.setTrust({ reputation: true, cryptoEconomic: true });
+agent.setMetadata({ version: "1.0.0" });
+agent.setActive(true);
+
+const tx = await agent.register("https://example.com/agent-card.json");
+const mined = await tx.waitConfirmed({ timeoutMs: 180_000 });
+console.log(mined.result.agentId, mined.result.agentURI);
+```
+
+## Core Flows
+
+### Wallet Management
+
+```ts
+const wallet = await agent.getWallet();
+const setTx = await agent.setWallet("<NEW_WALLET_ADDRESS>");
+if (setTx) await setTx.waitConfirmed({ timeoutMs: 180_000 });
+```
+
+### Feedback and Reputation
+
+```ts
+const fbTx = await sdk.giveFeedback({ agentId: "<AGENT_ID>", value: 88 });
+const fb = await fbTx.waitConfirmed({ timeoutMs: 180_000 });
+const summary = await sdk.getReputationSummary("<AGENT_ID>");
+console.log(fb.result, summary);
+```
+
+### Validation
+
+```ts
+const reqTx = await sdk.validationRequest({
+  validatorAddress: "<VALIDATOR_ADDRESS>",
+  agentId: "<AGENT_ID>",
+  requestURI: "ipfs://QmRequest",
+});
+const req = await reqTx.waitConfirmed({ timeoutMs: 180_000 });
+
+const respTx = await sdk.validationResponse({
+  requestHash: req.result.requestHash,
+  response: 95,
+});
+await respTx.waitConfirmed({ timeoutMs: 180_000 });
+```
+
+## Search and Indexing
+
+- `searchAgents()` / `getAgent()` APIs exist in the SDK.
+- Current release does **not** enable subgraph URL integration by default.
+- Full subgraph-backed search support is planned in a future update.
+
+## Examples
+
+Chain-specific runnable scripts are in `ts/examples/`.
+See `ts/examples/README.md` for full usage.
+
+## Notes
+
+- Package name: `@bankofai/8004-sdk`
+- ESM package (`"type": "module"`)
+- Contracts reject self-feedback; use a separate reviewer wallet
+
+## License
+
+MIT

package/dist/core/agent.d.ts

@@ -0,0 +1,27 @@
+import type { RegistrationFile, RegistrationResult, SetWalletOptions } from "../models/types.js";
+import type { SDK } from "./sdk.js";
+import { TransactionHandle } from "./transaction-handle.js";
+export declare class Agent {
+    private readonly sdk;
+    private readonly registrationFile;
+    constructor(sdk: SDK, registrationFile: RegistrationFile);
+    get agentId(): string | undefined;
+    setMCP(endpoint: string, version?: string): this;
+    setA2A(endpoint: string, version?: string): this;
+    addSkill(skill: string): this;
+    addDomain(domain: string): this;
+    setTrust(input: {
+        reputation?: boolean;
+        cryptoEconomic?: boolean;
+        teeAttestation?: boolean;
+    }): this;
+    setMetadata(kv: Record<string, unknown>): this;
+    setActive(active: boolean): this;
+    setX402Support(enabled: boolean): this;
+    register(agentURI: string): Promise<TransactionHandle<RegistrationResult>>;
+    getWallet(): Promise<string | undefined>;
+    setWallet(newWallet: string, options?: SetWalletOptions): Promise<TransactionHandle<Agent> | undefined>;
+    unsetWallet(): Promise<TransactionHandle<Agent> | undefined>;
+    toJSON(): RegistrationFile;
+    private touch;
+}

package/dist/core/agent.js

@@ -0,0 +1,177 @@
+import { recoverTypedDataAddress } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { TransactionHandle } from "./transaction-handle.js";
+export class Agent {
+    sdk;
+    registrationFile;
+    constructor(sdk, registrationFile) {
+        this.sdk = sdk;
+        this.registrationFile = registrationFile;
+    }
+    get agentId() {
+        return this.registrationFile.agentId;
+    }
+    setMCP(endpoint, version = "2025-06-18") {
+        this.registrationFile.endpoints = this.registrationFile.endpoints.filter((e) => e.name !== "MCP");
+        this.registrationFile.endpoints.push({ name: "MCP", endpoint, version });
+        return this.touch();
+    }
+    setA2A(endpoint, version = "0.3.0") {
+        this.registrationFile.endpoints = this.registrationFile.endpoints.filter((e) => e.name !== "A2A");
+        this.registrationFile.endpoints.push({ name: "A2A", endpoint, version });
+        return this.touch();
+    }
+    addSkill(skill) {
+        if (!this.registrationFile.tags.includes(skill))
+            this.registrationFile.tags.push(skill);
+        return this.touch();
+    }
+    addDomain(domain) {
+        if (!this.registrationFile.tags.includes(domain))
+            this.registrationFile.tags.push(domain);
+        return this.touch();
+    }
+    setTrust(input) {
+        const trust = [];
+        if (input.reputation)
+            trust.push("reputation");
+        if (input.cryptoEconomic)
+            trust.push("crypto-economic");
+        if (input.teeAttestation)
+            trust.push("tee-attestation");
+        this.registrationFile.supportedTrust = trust;
+        return this.touch();
+    }
+    setMetadata(kv) {
+        this.registrationFile.metadata = { ...this.registrationFile.metadata, ...kv };
+        return this.touch();
+    }
+    setActive(active) {
+        this.registrationFile.active = active;
+        return this.touch();
+    }
+    setX402Support(enabled) {
+        this.registrationFile.x402support = enabled;
+        return this.touch();
+    }
+    async register(agentURI) {
+        const tx = await this.sdk.submitRegister(agentURI);
+        return new TransactionHandle(tx.txHash, this.sdk.chain, async (receipt) => {
+            const parsed = this.sdk.chain.parseRegisteredAgentId(receipt);
+            const resolved = {
+                agentURI,
+                agentId: parsed ? `${this.sdk.chainId}:${parsed}` : undefined,
+            };
+            this.registrationFile.agentURI = agentURI;
+            this.registrationFile.agentId = resolved.agentId;
+            this.touch();
+            return resolved;
+        });
+    }
+    async getWallet() {
+        if (!this.registrationFile.agentId)
+            throw new Error("Agent must be registered first");
+        return this.sdk.getAgentWallet(this.registrationFile.agentId);
+    }
+    async setWallet(newWallet, options = {}) {
+        if (!this.registrationFile.agentId)
+            throw new Error("Agent must be registered first");
+        const agentTokenId = BigInt(this.registrationFile.agentId.split(":").pop());
+        const addrEvm = this.sdk.chain.toEvmAddress(newWallet);
+        const addrChain = this.sdk.chain.toChainAddress(newWallet);
+        const currentWallet = await this.getWallet().catch(() => undefined);
+        if (currentWallet && this.sdk.chain.addressEqual(currentWallet, addrChain)) {
+            this.registrationFile.walletAddress = addrChain;
+            this.registrationFile.walletChainId = this.sdk.chainId;
+            this.touch();
+            return undefined;
+        }
+        const ownerChain = await this.sdk.chain.ownerOf(this.sdk.identityRegistry, this.sdk.identityRegistryAbi, agentTokenId);
+        const ownerEvm = this.sdk.chain.toEvmAddress(ownerChain);
+        const verifyingContract = this.sdk.chain.toEvmAddress(this.sdk.identityRegistry);
+        const chainId = this.sdk.getTypedDataChainId();
+        const deadline = BigInt(options.deadline ?? (Math.floor(Date.now() / 1000) + 60));
+        const domain = {
+            name: "ERC8004IdentityRegistry",
+            version: "1",
+            chainId,
+            verifyingContract,
+        };
+        const types = {
+            AgentWalletSet: [
+                { name: "agentId", type: "uint256" },
+                { name: "newWallet", type: "address" },
+                { name: "owner", type: "address" },
+                { name: "deadline", type: "uint256" },
+            ],
+        };
+        const message = {
+            agentId: agentTokenId,
+            newWallet: addrEvm,
+            owner: ownerEvm,
+            deadline,
+        };
+        let signature = options.signature;
+        if (!signature) {
+            const signerKey = ((options.newWalletSigner ?? this.sdk.signer) || "").trim();
+            if (!signerKey) {
+                throw new Error("New wallet signature is required. Provide options.newWalletSigner or options.signature.");
+            }
+            const normalizedKey = (signerKey.startsWith("0x") ? signerKey : `0x${signerKey}`);
+            const account = privateKeyToAccount(normalizedKey);
+            if (account.address.toLowerCase() !== addrEvm.toLowerCase()) {
+                throw new Error(`newWalletSigner address (${account.address}) does not match newWallet (${addrEvm}).`);
+            }
+            signature = await account.signTypedData({
+                domain,
+                types,
+                primaryType: "AgentWalletSet",
+                message,
+            });
+            const recovered = await recoverTypedDataAddress({
+                domain,
+                types,
+                primaryType: "AgentWalletSet",
+                message,
+                signature,
+            });
+            if (recovered.toLowerCase() !== addrEvm.toLowerCase()) {
+                throw new Error(`Signature verification failed: recovered ${recovered}, expected ${addrEvm}`);
+            }
+        }
+        const txHash = await this.sdk.chain.setAgentWallet(this.sdk.identityRegistry, this.sdk.identityRegistryAbi, agentTokenId, addrChain, deadline, signature);
+        return new TransactionHandle(txHash, this.sdk.chain, async () => {
+            this.registrationFile.walletAddress = addrChain;
+            this.registrationFile.walletChainId = this.sdk.chainId;
+            this.touch();
+            return this;
+        });
+    }
+    async unsetWallet() {
+        if (!this.registrationFile.agentId)
+            throw new Error("Agent must be registered first");
+        const agentTokenId = BigInt(this.registrationFile.agentId.split(":").pop());
+        const currentWallet = await this.getWallet().catch(() => undefined);
+        if (!currentWallet) {
+            this.registrationFile.walletAddress = undefined;
+            this.registrationFile.walletChainId = undefined;
+            this.touch();
+            return undefined;
+        }
+        const txHash = await this.sdk.chain.unsetAgentWallet(this.sdk.identityRegistry, this.sdk.identityRegistryAbi, agentTokenId);
+        return new TransactionHandle(txHash, this.sdk.chain, async () => {
+            this.registrationFile.walletAddress = undefined;
+            this.registrationFile.walletChainId = undefined;
+            this.touch();
+            return this;
+        });
+    }
+    toJSON() {
+        return { ...this.registrationFile };
+    }
+    touch() {
+        this.registrationFile.updatedAt = Math.floor(Date.now() / 1000);
+        return this;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"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"}

package/dist/core/chains.d.ts

@@ -0,0 +1,88 @@
+import { type Abi, type Hex } from "viem";
+import type { ChainContracts, ChainType, TxWaitOptions } from "../models/types.js";
+export interface ChainAdapter {
+    readonly chainType: ChainType;
+    readonly rpcUrl: string;
+    readonly signerAddress?: string;
+    registerAgent(identityRegistry: string, abi: Abi, agentURI: string): Promise<string>;
+    getAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    ownerOf(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    setAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint, newWallet: string, deadline: bigint, signature: Hex): Promise<string>;
+    unsetAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    giveFeedback(reputationRegistry: string, abi: Abi, agentId: bigint, value: bigint, valueDecimals: number, tag1: string, tag2: string, endpoint: string, feedbackURI: string, feedbackHash: Hex): Promise<string>;
+    readFeedback(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddress: string, feedbackIndex: bigint): Promise<readonly [bigint, number, string, string, boolean]>;
+    getSummary(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddresses: string[], tag1: string, tag2: string): Promise<readonly [bigint, bigint, number]>;
+    getClients(reputationRegistry: string, abi: Abi, agentId: bigint): Promise<string[]>;
+    getLastIndex(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddress: string): Promise<bigint>;
+    validationRequest(validationRegistry: string, abi: Abi, validatorAddress: string, agentId: bigint, requestURI: string, requestHash: Hex): Promise<string>;
+    validationResponse(validationRegistry: string, abi: Abi, requestHash: Hex, response: number, responseURI: string, responseHash: Hex, tag: string): Promise<string>;
+    getValidationStatus(validationRegistry: string, abi: Abi, requestHash: Hex): Promise<readonly [string, bigint, number, Hex, string, bigint]>;
+    waitForTransaction(txHash: string, opts?: TxWaitOptions): Promise<unknown>;
+    parseRegisteredAgentId(receipt: unknown): string | undefined;
+    toEvmAddress(address: string): string;
+    toChainAddress(address: string): string;
+    addressEqual(a: string, b: string): boolean;
+}
+export declare class EvmAdapter implements ChainAdapter {
+    readonly chainType: ChainType;
+    readonly rpcUrl: string;
+    readonly signerAddress?: string;
+    private readonly publicClient;
+    private readonly walletClient?;
+    constructor(rpcUrl: string, chainId: number, signer?: string);
+    registerAgent(identityRegistry: string, abi: Abi, agentURI: string): Promise<string>;
+    getAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    ownerOf(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    setAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint, newWallet: string, deadline: bigint, signature: Hex): Promise<string>;
+    unsetAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    giveFeedback(reputationRegistry: string, abi: Abi, agentId: bigint, value: bigint, valueDecimals: number, tag1: string, tag2: string, endpoint: string, feedbackURI: string, feedbackHash: Hex): Promise<string>;
+    readFeedback(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddress: string, feedbackIndex: bigint): Promise<readonly [bigint, number, string, string, boolean]>;
+    getSummary(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddresses: string[], tag1: string, tag2: string): Promise<readonly [bigint, bigint, number]>;
+    getClients(reputationRegistry: string, abi: Abi, agentId: bigint): Promise<string[]>;
+    getLastIndex(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddress: string): Promise<bigint>;
+    validationRequest(validationRegistry: string, abi: Abi, validatorAddress: string, agentId: bigint, requestURI: string, requestHash: Hex): Promise<string>;
+    validationResponse(validationRegistry: string, abi: Abi, requestHash: Hex, response: number, responseURI: string, responseHash: Hex, tag: string): Promise<string>;
+    getValidationStatus(validationRegistry: string, _abi: Abi, requestHash: Hex): Promise<readonly [string, bigint, number, Hex, string, bigint]>;
+    waitForTransaction(txHash: string, opts?: TxWaitOptions): Promise<unknown>;
+    parseRegisteredAgentId(receipt: unknown): string | undefined;
+    toEvmAddress(address: string): string;
+    toChainAddress(address: string): string;
+    addressEqual(a: string, b: string): boolean;
+}
+export declare class TronAdapter implements ChainAdapter {
+    readonly chainType: ChainType;
+    readonly rpcUrl: string;
+    readonly signerAddress?: string;
+    private readonly tronWeb;
+    private readonly feeLimit;
+    private readonly readCaller;
+    constructor(rpcUrl: string, signer?: string, feeLimit?: number);
+    private pickMethod;
+    private toBigIntSafe;
+    private getValidationStatusViaConstantCall;
+    registerAgent(identityRegistry: string, abi: Abi, agentURI: string): Promise<string>;
+    getAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    ownerOf(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    setAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint, newWallet: string, deadline: bigint, signature: Hex): Promise<string>;
+    unsetAgentWallet(identityRegistry: string, abi: Abi, agentId: bigint): Promise<string>;
+    giveFeedback(reputationRegistry: string, abi: Abi, agentId: bigint, value: bigint, valueDecimals: number, tag1: string, tag2: string, endpoint: string, feedbackURI: string, feedbackHash: Hex): Promise<string>;
+    readFeedback(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddress: string, feedbackIndex: bigint): Promise<readonly [bigint, number, string, string, boolean]>;
+    getSummary(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddresses: string[], tag1: string, tag2: string): Promise<readonly [bigint, bigint, number]>;
+    getClients(reputationRegistry: string, abi: Abi, agentId: bigint): Promise<string[]>;
+    getLastIndex(reputationRegistry: string, abi: Abi, agentId: bigint, clientAddress: string): Promise<bigint>;
+    validationRequest(validationRegistry: string, abi: Abi, validatorAddress: string, agentId: bigint, requestURI: string, requestHash: Hex): Promise<string>;
+    validationResponse(validationRegistry: string, abi: Abi, requestHash: Hex, response: number, responseURI: string, responseHash: Hex, tag: string): Promise<string>;
+    getValidationStatus(validationRegistry: string, abi: Abi, requestHash: Hex): Promise<readonly [string, bigint, number, Hex, string, bigint]>;
+    waitForTransaction(txHash: string, opts?: TxWaitOptions): Promise<unknown>;
+    parseRegisteredAgentId(receipt: unknown): string | undefined;
+    toEvmAddress(address: string): string;
+    toChainAddress(address: string): string;
+    addressEqual(a: string, b: string): boolean;
+}
+export declare function resolveChainFromConfig(chainsJson: any, network: string, chainId?: number, rpcUrl?: string): {
+    chainType: ChainType;
+    resolvedNetwork: string;
+    resolvedChainId: number;
+    rpcUrl: string;
+    contracts: ChainContracts;
+};