@nullclear/shared 0.0.0-stage → 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,378 @@
+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 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";
+    }];
+}];
+
+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_TYPES, ERC8004_IDENTITY_ABI, ERC8004_REPUTATION_ABI, type KYAMandate, KYA_DOMAIN, KYA_MANDATE_TYPES, SUPPORTED_CHAINS, type X402PaymentOption, type X402PaymentRequired, type X402PaymentResponse, type X402PaymentSignaturePayload, decodeBase64Json, encodeBase64Json, getChainConfig };