@nullclear/shared 0.0.0-stage → 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,414 @@
+interface ChainConfig {
+    name: string;
+    chainId: number;
+    caip2: `eip155:${number}`;
+    erc8004Identity: `0x${string}`;
+    erc8004Reputation: `0x${string}`;
+    usdc: `0x${string}`;
+    usdcDomain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+    rpcUrl: string;
+    blockExplorer: string;
+}
+declare const NULLCLEAR_TREASURY_ADDRESS: "0xB586eFcCa41dF27ad3873BEcA54da0c30bf04d5c";
+declare const NULLCLEAR_ARBITER_ADDRESS: "0xfd74fF802EA0E735514C070AF04E0D6528deD145";
+declare const BASE_MAINNET: ChainConfig;
+declare const BASE_SEPOLIA: ChainConfig;
+declare const SUPPORTED_CHAINS: Record<number, ChainConfig>;
+declare const CAIP2_TO_CHAIN_ID: Record<string, number>;
+declare function getChainConfig(chainIdOrCaip2: number | string): ChainConfig;
+
+declare const ERC8004_IDENTITY_ABI: readonly [{
+    readonly name: "register";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "string";
+        readonly name: "agentURI";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+    }];
+}, {
+    readonly name: "ownerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "tokenURI";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly name: "getAgentWallet";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "Registered";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+        readonly indexed: true;
+    }, {
+        readonly type: "string";
+        readonly name: "agentURI";
+    }, {
+        readonly type: "address";
+        readonly name: "owner";
+        readonly indexed: true;
+    }];
+}];
+declare const ERC8004_REPUTATION_ABI: readonly [{
+    readonly name: "giveFeedback";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+    }, {
+        readonly type: "int128";
+        readonly name: "value";
+    }, {
+        readonly type: "uint8";
+        readonly name: "valueDecimals";
+    }, {
+        readonly type: "string";
+        readonly name: "tag1";
+    }, {
+        readonly type: "string";
+        readonly name: "tag2";
+    }, {
+        readonly type: "string";
+        readonly name: "endpoint";
+    }, {
+        readonly type: "string";
+        readonly name: "feedbackURI";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "feedbackHash";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "getSummary";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+    }, {
+        readonly type: "address[]";
+        readonly name: "clientAddresses";
+    }, {
+        readonly type: "string";
+        readonly name: "tag1";
+    }, {
+        readonly type: "string";
+        readonly name: "tag2";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint64";
+        readonly name: "count";
+    }, {
+        readonly type: "int128";
+        readonly name: "summaryValue";
+    }, {
+        readonly type: "uint8";
+        readonly name: "summaryValueDecimals";
+    }];
+}, {
+    readonly name: "readFeedback";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+    }, {
+        readonly type: "address";
+        readonly name: "clientAddress";
+    }, {
+        readonly type: "uint64";
+        readonly name: "feedbackIndex";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "int128";
+        readonly name: "value";
+    }, {
+        readonly type: "uint8";
+        readonly name: "valueDecimals";
+    }, {
+        readonly type: "string";
+        readonly name: "tag1";
+    }, {
+        readonly type: "string";
+        readonly name: "tag2";
+    }, {
+        readonly type: "bool";
+        readonly name: "isRevoked";
+    }];
+}, {
+    readonly name: "NewFeedback";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+        readonly indexed: true;
+    }, {
+        readonly type: "address";
+        readonly name: "clientAddress";
+        readonly indexed: true;
+    }, {
+        readonly type: "uint64";
+        readonly name: "feedbackIndex";
+    }, {
+        readonly type: "int128";
+        readonly name: "value";
+    }, {
+        readonly type: "uint8";
+        readonly name: "valueDecimals";
+    }, {
+        readonly type: "string";
+        readonly name: "indexedTag1";
+        readonly indexed: true;
+    }, {
+        readonly type: "string";
+        readonly name: "tag1";
+    }, {
+        readonly type: "string";
+        readonly name: "tag2";
+    }, {
+        readonly type: "string";
+        readonly name: "endpoint";
+    }, {
+        readonly type: "string";
+        readonly name: "feedbackURI";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "feedbackHash";
+    }];
+}];
+
+declare const EIP3009_ABI: readonly [{
+    readonly name: "transferWithAuthorization";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "from";
+    }, {
+        readonly type: "address";
+        readonly name: "to";
+    }, {
+        readonly type: "uint256";
+        readonly name: "value";
+    }, {
+        readonly type: "uint256";
+        readonly name: "validAfter";
+    }, {
+        readonly type: "uint256";
+        readonly name: "validBefore";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "nonce";
+    }, {
+        readonly type: "uint8";
+        readonly name: "v";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "r";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "s";
+    }];
+    readonly outputs: readonly [];
+}];
+interface X402PaymentOption {
+    scheme: "exact";
+    network: "eip155:8453" | "eip155:84532";
+    amount: string;
+    asset: `0x${string}`;
+    payTo: `0x${string}`;
+    maxTimeoutSeconds: number;
+    extra?: {
+        name?: string;
+        version?: string;
+        feePayer?: `0x${string}`;
+    };
+}
+interface X402PaymentRequired {
+    x402Version: 2;
+    error?: string;
+    resource: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    accepts: X402PaymentOption[];
+}
+interface EIP3009Authorization {
+    from: `0x${string}`;
+    to: `0x${string}`;
+    value: string;
+    validAfter: string;
+    validBefore: string;
+    nonce: `0x${string}`;
+}
+interface X402PaymentSignaturePayload {
+    x402Version: 2;
+    resource?: {
+        url: string;
+        mimeType?: string;
+    };
+    accepted: X402PaymentOption;
+    payload: {
+        signature: `0x${string}`;
+        authorization: EIP3009Authorization;
+    };
+}
+declare const EIP3009_TYPES: {
+    readonly TransferWithAuthorization: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validBefore";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }];
+};
+interface X402PaymentResponse {
+    success: boolean;
+    transaction?: `0x${string}`;
+    network: "eip155:8453" | "eip155:84532";
+    payer: `0x${string}`;
+    errorReason?: string;
+}
+/**
+ * Universal base64 encoder that works in Node.js, Cloudflare Workers, and Browser
+ */
+declare function encodeBase64Json(obj: unknown): string;
+/**
+ * Universal base64 decoder that works in Node.js, Cloudflare Workers, and Browser
+ */
+declare function decodeBase64Json<T>(base64: string): T;
+
+interface KYAMandate {
+    corporateEntity: string;
+    entityRegistrationNumber: string;
+    agentId: string;
+    agentWallet: `0x${string}`;
+    maxTxLimitUsd: number;
+    liabilityCoverageUsd: number;
+    validUntil: number;
+    jurisdiction: string;
+}
+declare const KYA_MANDATE_TYPES: {
+    readonly CorporateMandate: readonly [{
+        readonly name: "corporateEntity";
+        readonly type: "string";
+    }, {
+        readonly name: "entityRegistrationNumber";
+        readonly type: "string";
+    }, {
+        readonly name: "agentId";
+        readonly type: "string";
+    }, {
+        readonly name: "agentWallet";
+        readonly type: "address";
+    }, {
+        readonly name: "maxTxLimitUsd";
+        readonly type: "uint256";
+    }, {
+        readonly name: "liabilityCoverageUsd";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validUntil";
+        readonly type: "uint256";
+    }, {
+        readonly name: "jurisdiction";
+        readonly type: "string";
+    }];
+};
+declare const KYA_DOMAIN: {
+    readonly name: "NullClear KYA Registry";
+    readonly version: "1";
+    readonly chainId: 8453;
+};
+interface ClearingAttestation {
+    clearingId: string;
+    buyer: `0x${string}`;
+    sellerAgentId: string;
+    amountAtomic: string;
+    feeAtomic: string;
+    responseHash: `0x${string}`;
+    timestamp: number;
+    cleared: boolean;
+}
+declare const ARBITER_ATTESTATION_TYPES: {
+    readonly ClearingAttestation: readonly [{
+        readonly name: "clearingId";
+        readonly type: "string";
+    }, {
+        readonly name: "buyer";
+        readonly type: "address";
+    }, {
+        readonly name: "sellerAgentId";
+        readonly type: "string";
+    }, {
+        readonly name: "amountAtomic";
+        readonly type: "uint256";
+    }, {
+        readonly name: "feeAtomic";
+        readonly type: "uint256";
+    }, {
+        readonly name: "responseHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "timestamp";
+        readonly type: "uint256";
+    }, {
+        readonly name: "cleared";
+        readonly type: "bool";
+    }];
+};
+declare const ARBITER_DOMAIN: {
+    readonly name: "NullClear Arbiter";
+    readonly version: "1";
+    readonly chainId: 8453;
+};
+
+export { ARBITER_ATTESTATION_TYPES, ARBITER_DOMAIN, BASE_MAINNET, BASE_SEPOLIA, CAIP2_TO_CHAIN_ID, type ChainConfig, type ClearingAttestation, type EIP3009Authorization, EIP3009_ABI, EIP3009_TYPES, ERC8004_IDENTITY_ABI, ERC8004_REPUTATION_ABI, type KYAMandate, KYA_DOMAIN, KYA_MANDATE_TYPES, NULLCLEAR_ARBITER_ADDRESS, NULLCLEAR_TREASURY_ADDRESS, SUPPORTED_CHAINS, type X402PaymentOption, type X402PaymentRequired, type X402PaymentResponse, type X402PaymentSignaturePayload, decodeBase64Json, encodeBase64Json, getChainConfig };

package/dist/index.js

@@ -0,0 +1,163 @@
+// src/chains.ts
+var NULLCLEAR_TREASURY_ADDRESS = "0xB586eFcCa41dF27ad3873BEcA54da0c30bf04d5c";
+var NULLCLEAR_ARBITER_ADDRESS = "0xfd74fF802EA0E735514C070AF04E0D6528deD145";
+var BASE_MAINNET = {
+  name: "Base Mainnet",
+  chainId: 8453,
+  caip2: "eip155:8453",
+  erc8004Identity: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
+  erc8004Reputation: "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
+  usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  usdcDomain: {
+    name: "USD Coin",
+    version: "2",
+    chainId: 8453,
+    verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
+  },
+  rpcUrl: "https://mainnet.base.org",
+  blockExplorer: "https://basescan.org"
+};
+var BASE_SEPOLIA = {
+  name: "Base Sepolia",
+  chainId: 84532,
+  caip2: "eip155:84532",
+  erc8004Identity: "0x8004A818BFB912233c491871b3d84c89A494BD9e",
+  erc8004Reputation: "0x8004B663056A597Dffe9eCcC1965A193B7388713",
+  usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+  usdcDomain: {
+    name: "USDC",
+    version: "2",
+    chainId: 84532,
+    verifyingContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+  },
+  rpcUrl: "https://sepolia.base.org",
+  blockExplorer: "https://sepolia.basescan.org"
+};
+var SUPPORTED_CHAINS = {
+  8453: BASE_MAINNET,
+  84532: BASE_SEPOLIA
+};
+var CAIP2_TO_CHAIN_ID = {
+  "eip155:8453": 8453,
+  "eip155:84532": 84532
+};
+function getChainConfig(chainIdOrCaip2) {
+  let chainId;
+  if (typeof chainIdOrCaip2 === "string") {
+    if (chainIdOrCaip2.startsWith("eip155:")) {
+      chainId = CAIP2_TO_CHAIN_ID[chainIdOrCaip2] ?? parseInt(chainIdOrCaip2.slice(7), 10);
+    } else {
+      chainId = parseInt(chainIdOrCaip2, 10);
+    }
+  } else {
+    chainId = chainIdOrCaip2;
+  }
+  const config = SUPPORTED_CHAINS[chainId];
+  if (!config) {
+    throw new Error(`Unsupported chain ID or CAIP-2 identifier: ${chainIdOrCaip2}`);
+  }
+  return config;
+}
+
+// src/erc8004-abi.ts
+import { parseAbi } from "viem";
+var ERC8004_IDENTITY_ABI = parseAbi([
+  "function register(string agentURI) external returns (uint256 agentId)",
+  "function ownerOf(uint256 tokenId) external view returns (address)",
+  "function tokenURI(uint256 tokenId) external view returns (string)",
+  "function getAgentWallet(uint256 agentId) external view returns (address)",
+  "event Registered(uint256 indexed agentId, string agentURI, address indexed owner)"
+]);
+var ERC8004_REPUTATION_ABI = parseAbi([
+  "function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash) external",
+  "function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) external view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)",
+  "function readFeedback(uint256 agentId, address clientAddress, uint64 feedbackIndex) external view returns (int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked)",
+  "event NewFeedback(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, int128 value, uint8 valueDecimals, string indexed indexedTag1, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)"
+]);
+
+// src/x402-types.ts
+import { parseAbi as parseAbi2 } from "viem";
+var EIP3009_ABI = parseAbi2([
+  "function transferWithAuthorization(address from, address to, uint256 value, uint256 validAfter, uint256 validBefore, bytes32 nonce, uint8 v, bytes32 r, bytes32 s) external"
+]);
+var EIP3009_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" }
+  ]
+};
+function encodeBase64Json(obj) {
+  const json = JSON.stringify(obj);
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(json, "utf-8").toString("base64");
+  }
+  return btoa(unescape(encodeURIComponent(json)));
+}
+function decodeBase64Json(base64) {
+  let json;
+  if (typeof Buffer !== "undefined") {
+    json = Buffer.from(base64, "base64").toString("utf-8");
+  } else {
+    json = decodeURIComponent(escape(atob(base64)));
+  }
+  return JSON.parse(json);
+}
+
+// src/eip712-kya.ts
+var KYA_MANDATE_TYPES = {
+  CorporateMandate: [
+    { name: "corporateEntity", type: "string" },
+    { name: "entityRegistrationNumber", type: "string" },
+    { name: "agentId", type: "string" },
+    { name: "agentWallet", type: "address" },
+    { name: "maxTxLimitUsd", type: "uint256" },
+    { name: "liabilityCoverageUsd", type: "uint256" },
+    { name: "validUntil", type: "uint256" },
+    { name: "jurisdiction", type: "string" }
+  ]
+};
+var KYA_DOMAIN = {
+  name: "NullClear KYA Registry",
+  version: "1",
+  chainId: 8453
+};
+var ARBITER_ATTESTATION_TYPES = {
+  ClearingAttestation: [
+    { name: "clearingId", type: "string" },
+    { name: "buyer", type: "address" },
+    { name: "sellerAgentId", type: "string" },
+    { name: "amountAtomic", type: "uint256" },
+    { name: "feeAtomic", type: "uint256" },
+    { name: "responseHash", type: "bytes32" },
+    { name: "timestamp", type: "uint256" },
+    { name: "cleared", type: "bool" }
+  ]
+};
+var ARBITER_DOMAIN = {
+  name: "NullClear Arbiter",
+  version: "1",
+  chainId: 8453
+};
+export {
+  ARBITER_ATTESTATION_TYPES,
+  ARBITER_DOMAIN,
+  BASE_MAINNET,
+  BASE_SEPOLIA,
+  CAIP2_TO_CHAIN_ID,
+  EIP3009_ABI,
+  EIP3009_TYPES,
+  ERC8004_IDENTITY_ABI,
+  ERC8004_REPUTATION_ABI,
+  KYA_DOMAIN,
+  KYA_MANDATE_TYPES,
+  NULLCLEAR_ARBITER_ADDRESS,
+  NULLCLEAR_TREASURY_ADDRESS,
+  SUPPORTED_CHAINS,
+  decodeBase64Json,
+  encodeBase64Json,
+  getChainConfig
+};