@bbuilders/djeon402-core 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,1051 @@
+import { Address, Hex, Hash } from 'viem';
+
+declare const DJEON402_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "name";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferFrom";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "permit";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "nonces";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "DOMAIN_SEPARATOR";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "transferWithAuthorization";
+    readonly inputs: 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";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "receiveWithAuthorization";
+    readonly inputs: 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";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "cancelAuthorization";
+    readonly inputs: readonly [{
+        readonly name: "authorizer";
+        readonly type: "address";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "authorizationState";
+    readonly inputs: readonly [{
+        readonly name: "authorizer";
+        readonly type: "address";
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "mint";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "burn";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "blacklist";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "unBlacklist";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "isBlacklisted";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "unpause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "paused";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "hasRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "grantRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "revokeRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "DEFAULT_ADMIN_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "MINTER_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "BURNER_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "PAUSER_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "BLACKLISTER_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "KYC_ADMIN_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "function";
+    readonly name: "version";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Approval";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Mint";
+    readonly inputs: readonly [{
+        readonly name: "minter";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Burn";
+    readonly inputs: readonly [{
+        readonly name: "burner";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Blacklisted";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "UnBlacklisted";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Paused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Unpaused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "AuthorizationUsed";
+    readonly inputs: readonly [{
+        readonly name: "authorizer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "AuthorizationCanceled";
+    readonly inputs: readonly [{
+        readonly name: "authorizer";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "nonce";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientBalance";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientAllowance";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AccountBlacklisted";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ContractPaused";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AccessDenied";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidSignature";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuthorizationExpired";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuthorizationNotYetValid";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AuthorizationAlreadyUsed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PermitExpired";
+    readonly inputs: readonly [];
+}];
+declare const KYC_REGISTRY_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "getKYCData";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "level";
+        readonly type: "uint8";
+    }, {
+        readonly name: "expiryDate";
+        readonly type: "uint256";
+    }, {
+        readonly name: "kycHash";
+        readonly type: "string";
+    }, {
+        readonly name: "isActive";
+        readonly type: "bool";
+    }, {
+        readonly name: "dailyLimit";
+        readonly type: "uint256";
+    }, {
+        readonly name: "dailySpent";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getKYCLevel";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isKYCValid";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getRemainingDailyLimit";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isProviderApproved";
+    readonly inputs: readonly [{
+        readonly name: "provider";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "verifyKYC";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly name: "level";
+        readonly type: "uint8";
+    }, {
+        readonly name: "expiryDate";
+        readonly type: "uint256";
+    }, {
+        readonly name: "kycHash";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "updateKYC";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly name: "level";
+        readonly type: "uint8";
+    }, {
+        readonly name: "expiryDate";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "revokeKYC";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setDailyLimit";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly name: "newLimit";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "checkDailyLimit";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "approveProvider";
+    readonly inputs: readonly [{
+        readonly name: "provider";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "revokeProvider";
+    readonly inputs: readonly [{
+        readonly name: "provider";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "KYCVerified";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "level";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "expiryDate";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "dailyLimit";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "KYCRevoked";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "KYCUpdated";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "level";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "expiryDate";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}];
+
+declare const DEFAULT_CHAIN_ID = 31337;
+declare const DEFAULT_RPC_URL = "http://127.0.0.1:8545";
+declare const DJEON402_DECIMALS = 18;
+declare const EIP712_DOMAIN_NAME = "DONGJEON402 Token";
+declare const EIP712_DOMAIN_VERSION = "1";
+declare const TRANSFER_WITH_AUTHORIZATION_TYPEHASH: `0x${string}`;
+declare const RECEIVE_WITH_AUTHORIZATION_TYPEHASH: `0x${string}`;
+declare const CANCEL_AUTHORIZATION_TYPEHASH: `0x${string}`;
+declare const KYC_LEVEL_NAMES: readonly ["None", "Tier1", "Tier2", "Tier3"];
+declare const DEFAULT_VALID_AFTER = 0n;
+declare const DEFAULT_VALID_BEFORE: () => bigint;
+
+interface TokenInfo {
+    name: string;
+    symbol: string;
+    decimals: number;
+    totalSupply: string;
+    totalSupplyRaw: string;
+    paused: boolean;
+    contractAddress: Address;
+}
+interface BalanceResult {
+    address: Address;
+    balance: string;
+    balanceRaw: string;
+}
+interface AllowanceResult {
+    owner: Address;
+    spender: Address;
+    allowance: string;
+    allowanceRaw: string;
+}
+interface TransferResult {
+    success: boolean;
+    hash: Hash;
+    from?: Address;
+    to?: Address;
+    amount?: string;
+    amountRaw?: string;
+    blockNumber: string;
+    status?: 'success' | 'reverted';
+}
+interface RolesResult {
+    DEFAULT_ADMIN_ROLE: Hex;
+    MINTER_ROLE: Hex;
+    BURNER_ROLE: Hex;
+    PAUSER_ROLE: Hex;
+    BLACKLISTER_ROLE: Hex;
+}
+interface RoleCheckResult {
+    role: Hex;
+    address: Address;
+    hasRole: boolean;
+}
+interface BlacklistResult {
+    address: Address;
+    isBlacklisted: boolean;
+}
+type KYCLevel = 0 | 1 | 2 | 3;
+type KYCLevelName = 'None' | 'Tier1' | 'Tier2' | 'Tier3';
+interface KYCDocument {
+    filename: string;
+    content: string;
+}
+interface KYCData {
+    level: KYCLevel;
+    levelName: KYCLevelName;
+    expiryDate: number;
+    expiryDateReadable: string;
+    kycHash: string;
+    isActive: boolean;
+    dailyLimit: string;
+    dailyLimitRaw: string;
+    dailySpent: string;
+    dailySpentRaw: string;
+    userAddress: Address;
+}
+interface KYCVerifyParams {
+    adminPrivateKey: `0x${string}`;
+    userAddress: Address;
+    level: KYCLevel;
+    expiryDate?: number;
+    documents: KYCDocument[];
+}
+interface KYCUpdateParams {
+    adminPrivateKey: `0x${string}`;
+    userAddress: Address;
+    level: KYCLevel;
+    expiryDate?: number;
+}
+interface KYCRevokeParams {
+    adminPrivateKey: `0x${string}`;
+    userAddress: Address;
+}
+interface KYCSetLimitParams {
+    adminPrivateKey: `0x${string}`;
+    userAddress: Address;
+    limitUSD: string;
+}
+interface KYCCheckLimitParams {
+    adminPrivateKey: `0x${string}`;
+    userAddress: Address;
+    amountUSD: string;
+}
+interface KYCCheckLimitResult {
+    allowed: boolean;
+    hash?: Hash;
+}
+interface RemainingDailyLimit {
+    remaining: string;
+    remainingRaw: string;
+    userAddress: Address;
+}
+interface TransferAuthorizationSignature {
+    from: Address;
+    to: Address;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: Hex;
+    v: number;
+    r: Hex;
+    s: Hex;
+}
+interface ReceiveAuthorizationSignature {
+    from: Address;
+    to: Address;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: Hex;
+    v: number;
+    r: Hex;
+    s: Hex;
+}
+interface SignTransferAuthParams {
+    privateKey: `0x${string}`;
+    from: Address;
+    to: Address;
+    amount: string;
+    validAfter?: bigint;
+    validBefore?: bigint;
+    nonce?: Hex;
+}
+interface SignReceiveAuthParams {
+    privateKey: `0x${string}`;
+    from: Address;
+    to: Address;
+    amount: string;
+    validAfter?: bigint;
+    validBefore?: bigint;
+    nonce?: Hex;
+}
+interface ExecuteTransferAuthParams {
+    executorPrivateKey: `0x${string}`;
+    authorization: TransferAuthorizationSignature;
+}
+interface ExecuteReceiveAuthParams {
+    receiverPrivateKey: `0x${string}`;
+    authorization: ReceiveAuthorizationSignature;
+}
+interface CancelAuthorizationParams {
+    privateKey: `0x${string}`;
+    authorizer: Address;
+    nonce: Hex;
+}
+interface CancelAuthorizationResult {
+    success: boolean;
+    hash: Hash;
+    blockNumber: string;
+}
+interface X402PaymentParams {
+    payerPrivateKey: `0x${string}`;
+    executorPrivateKey: `0x${string}`;
+    from: Address;
+    to: Address;
+    amount: string;
+}
+interface AuthorizationStateResult {
+    authorizer: Address;
+    nonce: Hex;
+    isUsed: boolean;
+}
+interface SDKConfig {
+    rpcUrl: string;
+    contractAddress: Address;
+    kycRegistryAddress?: Address;
+    chainId: number;
+}
+interface ClientSDKConfig {
+    rpcUrl?: string;
+    contractAddress: Address;
+    kycRegistryAddress?: Address;
+    chainId: number;
+}
+
+/**
+ * Format raw token amount to human-readable string
+ * @param value Raw value (with decimals)
+ * @param decimals Token decimals (default: 6)
+ * @returns Formatted string
+ */
+declare function formatTokenAmount(value: bigint, decimals?: number): string;
+/**
+ * Parse human-readable amount to raw value
+ * @param value Human-readable value
+ * @param decimals Token decimals (default: 6)
+ * @returns Raw value (bigint)
+ */
+declare function parseTokenAmount(value: string, decimals?: number): bigint;
+/**
+ * Format timestamp to ISO string
+ * @param timestamp Unix timestamp
+ * @returns ISO string or "No Expiry"
+ */
+declare function formatTimestamp(timestamp: bigint | number): string;
+/**
+ * Get KYC level name
+ * @param level KYC level (0-3)
+ * @returns Level name
+ */
+declare function getKYCLevelName(level: 0 | 1 | 2 | 3): 'None' | 'Tier1' | 'Tier2' | 'Tier3';
+
+/**
+ * Validate Ethereum address
+ * @param address Address to validate
+ * @throws Error if invalid
+ */
+declare function validateAddress(address: string): asserts address is Address;
+/**
+ * Validate private key format
+ * @param privateKey Private key to validate
+ * @throws Error if invalid
+ */
+declare function validatePrivateKey(privateKey: string): asserts privateKey is `0x${string}`;
+/**
+ * Validate amount is positive
+ * @param amount Amount to validate
+ * @throws Error if invalid
+ */
+declare function validateAmount(amount: string): void;
+/**
+ * Validate KYC level
+ * @param level KYC level to validate
+ * @throws Error if invalid
+ */
+declare function validateKYCLevel(level: number): asserts level is 0 | 1 | 2 | 3;
+/**
+ * Validate hex string
+ * @param hex Hex string to validate
+ * @throws Error if invalid
+ */
+declare function validateHex(hex: string): asserts hex is Hex;
+
+export { type AllowanceResult, type AuthorizationStateResult, type BalanceResult, type BlacklistResult, CANCEL_AUTHORIZATION_TYPEHASH, type CancelAuthorizationParams, type CancelAuthorizationResult, type ClientSDKConfig, DEFAULT_CHAIN_ID, DEFAULT_RPC_URL, DEFAULT_VALID_AFTER, DEFAULT_VALID_BEFORE, DJEON402_ABI, DJEON402_DECIMALS, EIP712_DOMAIN_NAME, EIP712_DOMAIN_VERSION, type ExecuteReceiveAuthParams, type ExecuteTransferAuthParams, type KYCCheckLimitParams, type KYCCheckLimitResult, type KYCData, type KYCDocument, type KYCLevel, type KYCLevelName, type KYCRevokeParams, type KYCSetLimitParams, type KYCUpdateParams, type KYCVerifyParams, KYC_LEVEL_NAMES, KYC_REGISTRY_ABI, RECEIVE_WITH_AUTHORIZATION_TYPEHASH, type ReceiveAuthorizationSignature, type RemainingDailyLimit, type RoleCheckResult, type RolesResult, type SDKConfig, type SignReceiveAuthParams, type SignTransferAuthParams, TRANSFER_WITH_AUTHORIZATION_TYPEHASH, type TokenInfo, type TransferAuthorizationSignature, type TransferResult, type X402PaymentParams, formatTimestamp, formatTokenAmount, getKYCLevelName, parseTokenAmount, validateAddress, validateAmount, validateHex, validateKYCLevel, validatePrivateKey };