aptos-x402 3.0.0 → 3.0.2

package/dist/lib/aptos-utils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Aptos Utilities for x402
+ *
+ * Utilities for building, signing, and submitting Aptos transactions.
+ */
+import { Aptos, Account, SimpleTransaction, AccountAuthenticator } from "@aptos-labs/ts-sdk";
+export interface FeePayerTransactionResult {
+    transaction: SimpleTransaction;
+    senderAuthenticator: AccountAuthenticator;
+}
+/**
+ * Get Aptos client based on network (CAIP-2 format)
+ */
+export declare function getAptosClient(network?: string): Aptos;
+/**
+ * Create an Account from a private key
+ */
+export declare function getAccountFromPrivateKey(privateKeyHex: string): Account;
+/**
+ * Build a sponsored fungible asset transfer transaction
+ */
+export declare function buildFeePayerFATransfer(aptos: Aptos, sender: Account, recipient: string, amount: string | bigint, assetMetadata: string): Promise<SimpleTransaction>;
+/**
+ * Sign a transaction as the sender
+ */
+export declare function signAsSender(aptos: Aptos, signer: Account, transaction: SimpleTransaction): AccountAuthenticator;
+/**
+ * Submit a transaction with sender signature
+ */
+export declare function submitTransaction(aptos: Aptos, transaction: SimpleTransaction, senderAuthenticator: AccountAuthenticator): Promise<string>;
+/**
+ * Get fungible asset balance
+ */
+export declare function getFungibleAssetBalance(aptos: Aptos, accountAddress: string, assetMetadata: string): Promise<string>;
+/**
+ * Check if an account exists on chain
+ */
+export declare function accountExists(aptos: Aptos, accountAddress: string): Promise<boolean>;
+/**
+ * Get chain ID from CAIP-2 network
+ */
+export declare function getChainId(network: string): number;
+/**
+ * Get CAIP-2 network from chain ID
+ */
+export declare function getNetworkFromChainId(chainId: number): string;
+//# sourceMappingURL=aptos-utils.d.ts.map

package/dist/lib/aptos-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aptos-utils.d.ts","sourceRoot":"","sources":["../../lib/aptos-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,EAGL,OAAO,EAEP,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,mBAAmB,EAAE,oBAAoB,CAAC;CAC3C;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,MAAkB,GAAG,KAAK,CAKjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAGvE;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,iBAAiB,GAC7B,oBAAoB,CAEtB;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,iBAAiB,EAC9B,mBAAmB,EAAE,oBAAoB,GACxC,OAAO,CAAC,MAAM,CAAC,CAMjB;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/lib/aptos-utils.js

@@ -0,0 +1,120 @@
+/**
+ * Aptos Utilities for x402
+ *
+ * Utilities for building, signing, and submitting Aptos transactions.
+ */
+import { Aptos, AptosConfig, Network, Account, Ed25519PrivateKey, } from "@aptos-labs/ts-sdk";
+import { parseCAIP2Network } from "./x402-protocol-types";
+// ============================================
+// CLIENT MANAGEMENT
+// ============================================
+/**
+ * Get Aptos client based on network (CAIP-2 format)
+ */
+export function getAptosClient(network = "aptos:2") {
+    const parsed = parseCAIP2Network(network);
+    const aptosNetwork = parsed?.chainId === '1' ? Network.MAINNET : Network.TESTNET;
+    return new Aptos(new AptosConfig({ network: aptosNetwork }));
+}
+/**
+ * Create an Account from a private key
+ */
+export function getAccountFromPrivateKey(privateKeyHex) {
+    const cleanKey = privateKeyHex.replace(/^0x/, "");
+    return Account.fromPrivateKey({ privateKey: new Ed25519PrivateKey(cleanKey) });
+}
+// ============================================
+// TRANSACTION BUILDING (Fungible Assets Only)
+// ============================================
+/**
+ * Build a sponsored fungible asset transfer transaction
+ */
+export async function buildFeePayerFATransfer(aptos, sender, recipient, amount, assetMetadata) {
+    return await aptos.transaction.build.simple({
+        sender: sender.accountAddress,
+        withFeePayer: true,
+        data: {
+            function: "0x1::primary_fungible_store::transfer",
+            typeArguments: ["0x1::fungible_asset::Metadata"],
+            functionArguments: [assetMetadata, recipient, BigInt(amount.toString())],
+        },
+    });
+}
+// ============================================
+// TRANSACTION SIGNING
+// ============================================
+/**
+ * Sign a transaction as the sender
+ */
+export function signAsSender(aptos, signer, transaction) {
+    return aptos.transaction.sign({ signer, transaction });
+}
+// ============================================
+// TRANSACTION SUBMISSION
+// ============================================
+/**
+ * Submit a transaction with sender signature
+ */
+export async function submitTransaction(aptos, transaction, senderAuthenticator) {
+    const committed = await aptos.transaction.submit.simple({
+        transaction,
+        senderAuthenticator,
+    });
+    return committed.hash;
+}
+// ============================================
+// ACCOUNT UTILITIES
+// ============================================
+/**
+ * Get fungible asset balance
+ */
+export async function getFungibleAssetBalance(aptos, accountAddress, assetMetadata) {
+    try {
+        const balances = await aptos.getCurrentFungibleAssetBalances({
+            options: {
+                where: {
+                    owner_address: { _eq: accountAddress },
+                    asset_type: { _eq: assetMetadata },
+                },
+            },
+        });
+        return balances.length > 0 ? balances[0].amount.toString() : "0";
+    }
+    catch {
+        return "0";
+    }
+}
+/**
+ * Check if an account exists on chain
+ */
+export async function accountExists(aptos, accountAddress) {
+    try {
+        await aptos.getAccountInfo({ accountAddress });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================
+// NETWORK UTILITIES
+// ============================================
+/**
+ * Get chain ID from CAIP-2 network
+ */
+export function getChainId(network) {
+    const parsed = parseCAIP2Network(network);
+    if (parsed?.chainId) {
+        const id = parseInt(parsed.chainId, 10);
+        if (!isNaN(id))
+            return id;
+    }
+    return 2; // Default testnet
+}
+/**
+ * Get CAIP-2 network from chain ID
+ */
+export function getNetworkFromChainId(chainId) {
+    return `aptos:${chainId}`;
+}
+//# sourceMappingURL=aptos-utils.js.map

package/dist/lib/aptos-utils.js.map

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

package/dist/lib/arc8004/chain/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ARC-8004 On-Chain Module
+ *
+ * Provides on-chain provider abstraction for blockchain operations
+ *
+ * @packageDocumentation
+ */
+export type { OnChainProvider, MintIdentityResult, VerifyIdentityResult, AttestationResult, OnChainAgentScore, } from './types';
+export { NullOnChainProvider, AptosOnChainProvider, createOnChainProvider, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/arc8004/chain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/arc8004/chain/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/lib/arc8004/chain/index.js

@@ -0,0 +1,9 @@
+/**
+ * ARC-8004 On-Chain Module
+ *
+ * Provides on-chain provider abstraction for blockchain operations
+ *
+ * @packageDocumentation
+ */
+export { NullOnChainProvider, AptosOnChainProvider, createOnChainProvider, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/lib/arc8004/chain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/arc8004/chain/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/lib/arc8004/chain/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * ARC-8004 On-Chain Provider Interface
+ *
+ * Abstracts blockchain operations for ARC-8004, allowing:
+ * - Null implementation for off-chain only mode
+ * - Aptos implementation for full on-chain support
+ * - Custom implementations for other blockchains
+ *
+ * @packageDocumentation
+ */
+import type { Account } from '@aptos-labs/ts-sdk';
+import type { AgentCard } from '../types';
+/**
+ * Result of minting an identity NFT on-chain
+ */
+export interface MintIdentityResult {
+    /** On-chain token address */
+    tokenAddress: string;
+    /** Transaction hash */
+    txHash: string;
+}
+/**
+ * Result of verifying an identity on-chain
+ */
+export interface VerifyIdentityResult {
+    /** Transaction hash */
+    txHash: string;
+}
+/**
+ * Result of creating an on-chain attestation
+ */
+export interface AttestationResult {
+    /** Attestation/transaction hash */
+    attestationHash: string;
+}
+/**
+ * On-chain agent score data
+ */
+export interface OnChainAgentScore {
+    /** Total sum of all scores received */
+    totalScore: number;
+    /** Number of feedback submissions */
+    feedbackCount: number;
+    /** Average score scaled by 100 (e.g., 450 = 4.50) */
+    averageScoreScaled: number;
+    /** Computed trust level (0-5) */
+    trustLevel: number;
+    /** Last update timestamp (unix seconds) */
+    lastUpdated: number;
+}
+/**
+ * Interface for on-chain operations
+ * Implement this interface to provide custom blockchain integration
+ */
+export interface OnChainProvider {
+    /**
+     * Whether on-chain operations are enabled
+     */
+    readonly enabled: boolean;
+    /**
+     * Mint an agent identity NFT on-chain
+     *
+     * @param agentId - Unique agent identifier
+     * @param agentCard - Agent metadata
+     * @param signer - Account to sign the transaction
+     * @returns Token address and transaction hash
+     */
+    mintIdentity(agentId: string, agentCard: AgentCard, signer: Account): Promise<MintIdentityResult>;
+    /**
+     * Verify an agent identity on-chain
+     *
+     * @param tokenAddress - On-chain token address
+     * @param signer - Admin account to sign verification
+     * @returns Transaction hash
+     */
+    verifyIdentity(tokenAddress: string, signer: Account): Promise<VerifyIdentityResult>;
+    /**
+     * Create an on-chain feedback attestation
+     *
+     * @param agentId - Agent receiving feedback
+     * @param clientAddress - Address of client giving feedback
+     * @param score - Overall score (1-5)
+     * @param paymentHash - Optional related payment hash
+     * @param signer - Account to sign the transaction
+     * @returns Attestation hash
+     */
+    attestFeedback(agentId: string, clientAddress: string, score: number, paymentHash: string | undefined, signer: Account): Promise<AttestationResult>;
+    /**
+     * Submit a task validation on-chain
+     *
+     * @param taskId - Task identifier
+     * @param agentId - Agent that performed the task
+     * @param validatorId - Validator identifier
+     * @param proof - Optional cryptographic proof
+     * @param signer - Account to sign the transaction
+     * @returns Attestation hash
+     */
+    submitValidation(taskId: string, agentId: string, validatorId: string, proof: string | undefined, signer: Account): Promise<AttestationResult>;
+    /**
+     * Check if an identity exists on-chain
+     *
+     * @param tokenAddress - Token address to check
+     * @returns Whether the identity exists
+     */
+    identityExists(tokenAddress: string): Promise<boolean>;
+    /**
+     * Get account balance (for checking if account can pay fees)
+     *
+     * @param address - Account address
+     * @returns Balance in native units (e.g., octas for Aptos)
+     */
+    getAccountBalance(address: string): Promise<bigint>;
+    /**
+     * Get aggregated agent score from on-chain
+     *
+     * @param agentId - Agent identifier
+     * @returns On-chain agent score data or null if not found
+     */
+    getAgentScore(agentId: string): Promise<OnChainAgentScore | null>;
+    /**
+     * Check if an agent has any on-chain reputation
+     *
+     * @param agentId - Agent identifier
+     * @returns Whether the agent has on-chain reputation data
+     */
+    hasOnChainReputation(agentId: string): Promise<boolean>;
+}
+/**
+ * Null implementation of OnChainProvider
+ * Used when on-chain operations are disabled
+ * All operations return empty results or throw appropriate errors
+ */
+export declare class NullOnChainProvider implements OnChainProvider {
+    readonly enabled = false;
+    mintIdentity(): Promise<MintIdentityResult>;
+    verifyIdentity(): Promise<VerifyIdentityResult>;
+    attestFeedback(): Promise<AttestationResult>;
+    submitValidation(): Promise<AttestationResult>;
+    identityExists(): Promise<boolean>;
+    getAccountBalance(): Promise<bigint>;
+    getAgentScore(): Promise<OnChainAgentScore | null>;
+    hasOnChainReputation(): Promise<boolean>;
+}
+/**
+ * Aptos blockchain implementation of OnChainProvider
+ */
+export declare class AptosOnChainProvider implements OnChainProvider {
+    private aptos;
+    readonly enabled = true;
+    private moduleAddress;
+    constructor(aptos: import('@aptos-labs/ts-sdk').Aptos, moduleAddress: string);
+    mintIdentity(agentId: string, agentCard: AgentCard, signer: Account): Promise<MintIdentityResult>;
+    verifyIdentity(tokenAddress: string, signer: Account): Promise<VerifyIdentityResult>;
+    attestFeedback(agentId: string, clientAddress: string, score: number, paymentHash: string | undefined, signer: Account): Promise<AttestationResult>;
+    submitValidation(taskId: string, agentId: string, validatorId: string, proof: string | undefined, signer: Account): Promise<AttestationResult>;
+    identityExists(tokenAddress: string): Promise<boolean>;
+    getAccountBalance(address: string): Promise<bigint>;
+    getAgentScore(agentId: string): Promise<OnChainAgentScore | null>;
+    hasOnChainReputation(agentId: string): Promise<boolean>;
+    /**
+     * Extract token address from mint transaction events
+     */
+    private extractTokenAddressFromTx;
+}
+/**
+ * Create an on-chain provider based on configuration
+ *
+ * @param config - Configuration options
+ * @returns OnChainProvider instance
+ *
+ * @example Disabled (null provider)
+ * ```typescript
+ * const provider = createOnChainProvider({ enabled: false });
+ * ```
+ *
+ * @example Aptos provider
+ * ```typescript
+ * const provider = createOnChainProvider({
+ *   enabled: true,
+ *   moduleAddress: '0x...',
+ *   network: 'testnet',
+ * });
+ * ```
+ */
+export declare function createOnChainProvider(config: {
+    enabled: boolean;
+    moduleAddress?: string;
+    network?: string;
+}): OnChainProvider;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/arc8004/chain/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../lib/arc8004/chain/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/arc8004/chain/types.js

@@ -0,0 +1,278 @@
+/**
+ * ARC-8004 On-Chain Provider Interface
+ *
+ * Abstracts blockchain operations for ARC-8004, allowing:
+ * - Null implementation for off-chain only mode
+ * - Aptos implementation for full on-chain support
+ * - Custom implementations for other blockchains
+ *
+ * @packageDocumentation
+ */
+// ============================================
+// Null On-Chain Provider
+// ============================================
+/**
+ * Null implementation of OnChainProvider
+ * Used when on-chain operations are disabled
+ * All operations return empty results or throw appropriate errors
+ */
+export class NullOnChainProvider {
+    enabled = false;
+    async mintIdentity() {
+        throw new Error('On-chain operations are disabled. Set onChainEnabled: true to enable.');
+    }
+    async verifyIdentity() {
+        throw new Error('On-chain operations are disabled. Set onChainEnabled: true to enable.');
+    }
+    async attestFeedback() {
+        // For attestations, we can silently skip rather than throw
+        return { attestationHash: '' };
+    }
+    async submitValidation() {
+        // For validations, we can silently skip rather than throw
+        return { attestationHash: '' };
+    }
+    async identityExists() {
+        return false;
+    }
+    async getAccountBalance() {
+        return BigInt(0);
+    }
+    async getAgentScore() {
+        return null;
+    }
+    async hasOnChainReputation() {
+        return false;
+    }
+}
+// ============================================
+// Aptos On-Chain Provider
+// ============================================
+/**
+ * Aptos blockchain implementation of OnChainProvider
+ */
+export class AptosOnChainProvider {
+    aptos;
+    enabled = true;
+    moduleAddress;
+    constructor(aptos, moduleAddress) {
+        this.aptos = aptos;
+        this.moduleAddress = moduleAddress;
+    }
+    async mintIdentity(agentId, agentCard, signer) {
+        // Generate metadata URI (data URL with JSON)
+        const metadataUri = `data:application/json;base64,${Buffer.from(JSON.stringify(agentCard)).toString('base64')}`;
+        const transaction = await this.aptos.transaction.build.simple({
+            sender: signer.accountAddress,
+            data: {
+                function: `${this.moduleAddress}::agent_identity::mint_identity`,
+                functionArguments: [
+                    agentId,
+                    agentCard.name,
+                    metadataUri,
+                    JSON.stringify(agentCard.capabilities),
+                ],
+            },
+        });
+        const committed = await this.aptos.signAndSubmitTransaction({
+            signer,
+            transaction,
+        });
+        await this.aptos.waitForTransaction({ transactionHash: committed.hash });
+        // Extract token address from events
+        const tokenAddress = await this.extractTokenAddressFromTx(committed.hash);
+        return {
+            tokenAddress,
+            txHash: committed.hash,
+        };
+    }
+    async verifyIdentity(tokenAddress, signer) {
+        const transaction = await this.aptos.transaction.build.simple({
+            sender: signer.accountAddress,
+            data: {
+                function: `${this.moduleAddress}::agent_identity::verify_identity`,
+                functionArguments: [tokenAddress],
+            },
+        });
+        const committed = await this.aptos.signAndSubmitTransaction({
+            signer,
+            transaction,
+        });
+        await this.aptos.waitForTransaction({ transactionHash: committed.hash });
+        return { txHash: committed.hash };
+    }
+    async attestFeedback(agentId, clientAddress, score, paymentHash, signer) {
+        const transaction = await this.aptos.transaction.build.simple({
+            sender: signer.accountAddress,
+            data: {
+                function: `${this.moduleAddress}::reputation::attest_feedback`,
+                functionArguments: [
+                    agentId,
+                    clientAddress,
+                    score,
+                    paymentHash || '',
+                ],
+            },
+        });
+        const committed = await this.aptos.signAndSubmitTransaction({
+            signer,
+            transaction,
+        });
+        await this.aptos.waitForTransaction({ transactionHash: committed.hash });
+        return { attestationHash: committed.hash };
+    }
+    async submitValidation(taskId, agentId, validatorId, proof, signer) {
+        const transaction = await this.aptos.transaction.build.simple({
+            sender: signer.accountAddress,
+            data: {
+                function: `${this.moduleAddress}::validation::submit_validation`,
+                functionArguments: [
+                    taskId,
+                    agentId,
+                    validatorId,
+                    proof || '',
+                ],
+            },
+        });
+        const committed = await this.aptos.signAndSubmitTransaction({
+            signer,
+            transaction,
+        });
+        await this.aptos.waitForTransaction({ transactionHash: committed.hash });
+        return { attestationHash: committed.hash };
+    }
+    async identityExists(tokenAddress) {
+        try {
+            const resource = await this.aptos.getAccountResource({
+                accountAddress: tokenAddress,
+                resourceType: `${this.moduleAddress}::agent_identity::AgentIdentity`,
+            });
+            return !!resource;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getAccountBalance(address) {
+        try {
+            return BigInt(await this.aptos.getAccountAPTAmount({ accountAddress: address }));
+        }
+        catch {
+            return BigInt(0);
+        }
+    }
+    async getAgentScore(agentId) {
+        try {
+            const result = await this.aptos.view({
+                payload: {
+                    function: `${this.moduleAddress}::reputation::get_agent_score`,
+                    functionArguments: [agentId],
+                },
+            });
+            // Result is tuple: (total_score, feedback_count, average_score_scaled, trust_level, last_updated)
+            if (result && Array.isArray(result) && result.length >= 5) {
+                const [totalScore, feedbackCount, averageScoreScaled, trustLevel, lastUpdated] = result;
+                // If feedback count is 0, no reputation exists
+                if (Number(feedbackCount) === 0) {
+                    return null;
+                }
+                return {
+                    totalScore: Number(totalScore),
+                    feedbackCount: Number(feedbackCount),
+                    averageScoreScaled: Number(averageScoreScaled),
+                    trustLevel: Number(trustLevel),
+                    lastUpdated: Number(lastUpdated),
+                };
+            }
+            return null;
+        }
+        catch (error) {
+            console.warn('[ARC8004] Failed to get agent score from chain:', error);
+            return null;
+        }
+    }
+    async hasOnChainReputation(agentId) {
+        try {
+            const result = await this.aptos.view({
+                payload: {
+                    function: `${this.moduleAddress}::reputation::has_reputation`,
+                    functionArguments: [agentId],
+                },
+            });
+            return result && Array.isArray(result) && result[0] === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Extract token address from mint transaction events
+     */
+    async extractTokenAddressFromTx(txHash) {
+        const txDetails = await this.aptos.getTransactionByHash({ transactionHash: txHash });
+        if (txDetails && 'events' in txDetails && Array.isArray(txDetails.events)) {
+            // Look for IdentityCreated event
+            const identityCreatedEvent = txDetails.events.find((event) => {
+                const eventTypeStr = typeof event.type === 'string' ? event.type : '';
+                return eventTypeStr.includes('IdentityCreated');
+            });
+            if (identityCreatedEvent && identityCreatedEvent.data) {
+                const eventData = identityCreatedEvent.data;
+                if (eventData.token_address) {
+                    return eventData.token_address;
+                }
+                if (eventData.token_addr) {
+                    return eventData.token_addr;
+                }
+            }
+        }
+        // Fallback: try to extract from transaction changes
+        if (txDetails && 'changes' in txDetails && Array.isArray(txDetails.changes)) {
+            const identityChange = txDetails.changes.find((change) => {
+                const data = change.data;
+                return data?.type && String(data.type).includes('agent_identity::AgentIdentity');
+            });
+            if (identityChange && typeof identityChange.address === 'string') {
+                return identityChange.address;
+            }
+        }
+        throw new Error('Failed to extract token address from mint transaction');
+    }
+}
+// ============================================
+// Factory Function
+// ============================================
+/**
+ * Create an on-chain provider based on configuration
+ *
+ * @param config - Configuration options
+ * @returns OnChainProvider instance
+ *
+ * @example Disabled (null provider)
+ * ```typescript
+ * const provider = createOnChainProvider({ enabled: false });
+ * ```
+ *
+ * @example Aptos provider
+ * ```typescript
+ * const provider = createOnChainProvider({
+ *   enabled: true,
+ *   moduleAddress: '0x...',
+ *   network: 'testnet',
+ * });
+ * ```
+ */
+export function createOnChainProvider(config) {
+    if (!config.enabled) {
+        return new NullOnChainProvider();
+    }
+    if (!config.moduleAddress) {
+        console.warn('[ARC8004] On-chain enabled but moduleAddress not provided. Using NullOnChainProvider.');
+        return new NullOnChainProvider();
+    }
+    // Lazy import Aptos client
+    const { getAptosClient } = require('../../aptos-utils');
+    const aptos = getAptosClient(config.network || 'aptos-testnet');
+    return new AptosOnChainProvider(aptos, config.moduleAddress);
+}
+//# sourceMappingURL=types.js.map