@recoillink/aleo-sdk 0.0.0-stage → 45.0.1

package/dist/clients/signer.js

@@ -0,0 +1,137 @@
+import { TokenType } from '@recoillink/provider-sdk/warp';
+import { assert, isNullish, retryAsync } from '@recoillink/utils';
+import { getFileOverrideProgramId, loadProgramsInDeployOrder, } from '../utils/helper.node.js';
+import { RETRY_ATTEMPTS, RETRY_DELAY_MS, SUFFIX_LENGTH_LONG, getProgramSuffix, } from '../utils/helper.js';
+import { AleoProvider } from './provider.node.js';
+export class AleoSigner extends AleoProvider {
+    static WARP_SUFFIX_ALREADY_DEPLOYED_ERROR = 'already deployed, please choose another suffix';
+    programManager;
+    static async connectWithSigner(metadata, privateKey) {
+        assert(!isNullish(metadata.chainId), `chainId not defined in chain metadata`);
+        const rpcUrls = (metadata.rpcUrls ?? []).map((rpc) => rpc.http);
+        return new AleoSigner(rpcUrls, metadata, privateKey);
+    }
+    constructor(rpcUrls, chainMetadata, privateKey) {
+        super(rpcUrls, chainMetadata.chainId, chainMetadata);
+        this.programManager = this.getProgramManager(privateKey);
+    }
+    async getIsmManager() {
+        // Use the configured ISM manager program ID (from env or default)
+        const ismManagerProgramId = this.ismManager;
+        // Check if it's already deployed
+        const isDeployed = await this.isProgramDeployed(ismManagerProgramId);
+        if (!isDeployed) {
+            const suffix = getProgramSuffix(ismManagerProgramId);
+            await this.deployProgram('ism_manager', suffix);
+        }
+        return ismManagerProgramId;
+    }
+    async isProgramDeployed(programId) {
+        try {
+            await this.aleoClient.getProgram(programId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    isProgramAlreadyExistsError(err, programId) {
+        return (err instanceof Error &&
+            err.message.includes('already exists on the network') &&
+            err.message.includes(programId));
+    }
+    async getWarpTokenSuffix(tokenType, preferredSuffix, maxAttempts = 20) {
+        if (tokenType === TokenType.native) {
+            return 'credits';
+        }
+        // If a file override is set, validate the override program isn't already deployed
+        const warpProgram = tokenType === TokenType.collateral ? 'hyp_collateral' : 'hyp_synthetic';
+        const overrideProgramId = getFileOverrideProgramId(warpProgram);
+        if (overrideProgramId) {
+            const isDeployed = await this.isProgramDeployed(overrideProgramId);
+            assert(!isDeployed, `${overrideProgramId} ${AleoSigner.WARP_SUFFIX_ALREADY_DEPLOYED_ERROR}`);
+            return ''; // suffix unused — program name comes from the override file
+        }
+        const configuredSuffix = preferredSuffix || this.warpSuffix;
+        if (configuredSuffix) {
+            const tokenProgramId = `${this.prefix}_warp_token_${configuredSuffix}.aleo`;
+            const isAlreadyDeployed = await this.isProgramDeployed(tokenProgramId);
+            assert(!isAlreadyDeployed, `Warp route with suffix ${configuredSuffix} ${AleoSigner.WARP_SUFFIX_ALREADY_DEPLOYED_ERROR}`);
+            return configuredSuffix;
+        }
+        for (let i = 0; i < maxAttempts; i++) {
+            const suffix = this.generateSuffix(SUFFIX_LENGTH_LONG);
+            const tokenProgramId = `${this.prefix}_warp_token_${suffix}.aleo`;
+            if (!(await this.isProgramDeployed(tokenProgramId))) {
+                return suffix;
+            }
+        }
+        throw new Error(`Could not find an unused suffix for ${tokenType} after ${maxAttempts} attempts`);
+    }
+    async deployProgram(programName, coreSuffix, warpSuffix) {
+        const programs = loadProgramsInDeployOrder(this.prefix, programName, coreSuffix, warpSuffix);
+        for (const { id, program } of programs) {
+            if (await this.isProgramDeployed(id)) {
+                continue;
+            }
+            try {
+                const tx = this.skipProofs
+                    ? await this.programManager.buildDevnodeDeploymentTransaction({
+                        program,
+                        priorityFee: 0,
+                        privateFee: false,
+                    })
+                    : await this.programManager.buildDeploymentTransaction(program, 0, false, undefined, undefined, undefined);
+                const txId = await this.programManager.networkClient.submitTransaction(tx);
+                await this.aleoClient.waitForTransactionConfirmation(txId);
+            }
+            catch (err) {
+                if (this.isProgramAlreadyExistsError(err, id)) {
+                    continue;
+                }
+                throw err;
+            }
+        }
+        return programs.reduce((acc, p) => ({ ...acc, [p.name]: p.id }), {});
+    }
+    getSignerAddress() {
+        return this.programManager.account.address().to_string();
+    }
+    getNetworkPrefix() {
+        return this.prefix;
+    }
+    /**
+     * Get the hook manager program ID for a given mailbox suffix.
+     * Deploys the hook_manager program if it's not already deployed.
+     *
+     * @param suffix - The mailbox suffix
+     * @returns The hook manager program ID
+     */
+    async getHookManager(suffix) {
+        const programs = await this.deployProgram('hook_manager', suffix);
+        const hookManagerProgramId = programs['hook_manager'];
+        assert(hookManagerProgramId, `hook_manager program not deployed`);
+        return hookManagerProgramId;
+    }
+    supportsTransactionBatching() {
+        return false;
+    }
+    async transactionToPrintableJson(transaction) {
+        return transaction;
+    }
+    async sendAndConfirmTransaction(transaction) {
+        const tx = this.skipProofs
+            ? await this.programManager.buildDevnodeExecutionTransaction(transaction)
+            : await this.programManager.buildExecutionTransaction(transaction);
+        const txId = await retryAsync(() => this.programManager.networkClient.submitTransaction(tx), RETRY_ATTEMPTS, RETRY_DELAY_MS);
+        const receipt = await this.aleoClient.waitForTransactionConfirmation(txId);
+        return {
+            ...receipt,
+            transactionHash: receipt.transaction.id,
+        };
+    }
+    async sendAndConfirmBatchTransactions(_transactions) {
+        throw new Error(`${AleoSigner.name} does not support transaction batching`);
+    }
+}
+//# sourceMappingURL=signer.js.map

package/dist/clients/signer.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const ALEO_NULL_ADDRESS = "aleo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq3ljyzc";
+export declare const ALEO_NATIVE_DENOM = "credits";
+export declare const AleoNetworkId: {
+    readonly MAINNET: 0;
+    readonly TESTNET: 1;
+};
+export type AleoNetworkId = (typeof AleoNetworkId)[keyof typeof AleoNetworkId];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,oEACqC,CAAC;AACpE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAG3C,eAAO,MAAM,aAAa;aACxB,OAAO,EAAE,CAAC;aACV,OAAO,EAAE,CAAC;CACF,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,8 @@
+export const ALEO_NULL_ADDRESS = 'aleo1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq3ljyzc';
+export const ALEO_NATIVE_DENOM = 'credits';
+// CAST: Preserve literal IDs so AleoNetworkId remains the 0 | 1 union.
+export const AleoNetworkId = {
+    MAINNET: 0,
+    TESTNET: 1,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,iEAAiE,CAAC;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;CACF,CAAC"}

package/dist/hook/base.d.ts

@@ -0,0 +1,19 @@
+import { type AnyAleoNetworkClient } from '../clients/base.js';
+/**
+ * Get the newly created hook address after hook creation transaction.
+ * This should be called AFTER the hook creation transaction has been confirmed.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookManagerProgramId - The hook manager program ID
+ * @param nonce - The nonce captured before hook creation
+ * @returns The full hook address (e.g., "hook_manager_xxx.aleo/aleo1...")
+ *
+ * @example
+ * ```typescript
+ * const expectedNonce = await getNewContractExpectedNonce(client, hookManagerProgramId);
+ * const receipt = await signer.sendAndConfirmTransaction(createHookTx);
+ * const hookAddress = await getNewHookAddress(client, hookManagerProgramId, expectedNonce);
+ * ```
+ */
+export declare function getNewHookAddress(aleoClient: AnyAleoNetworkClient, hookManagerProgramId: string, nonce: string): Promise<string>;
+//# sourceMappingURL=base.d.ts.map

package/dist/hook/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/hook/base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,oBAAoB,EAChC,oBAAoB,EAAE,MAAM,EAC5B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/hook/base.js

@@ -0,0 +1,29 @@
+import { retryAsync } from '@recoillink/utils';
+import { RETRY_ATTEMPTS, RETRY_DELAY_MS } from '../utils/helper.js';
+/**
+ * Get the newly created hook address after hook creation transaction.
+ * This should be called AFTER the hook creation transaction has been confirmed.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookManagerProgramId - The hook manager program ID
+ * @param nonce - The nonce captured before hook creation
+ * @returns The full hook address (e.g., "hook_manager_xxx.aleo/aleo1...")
+ *
+ * @example
+ * ```typescript
+ * const expectedNonce = await getNewContractExpectedNonce(client, hookManagerProgramId);
+ * const receipt = await signer.sendAndConfirmTransaction(createHookTx);
+ * const hookAddress = await getNewHookAddress(client, hookManagerProgramId, expectedNonce);
+ * ```
+ */
+export async function getNewHookAddress(aleoClient, hookManagerProgramId, nonce) {
+    const hookAddressRaw = await retryAsync(async () => {
+        const result = await aleoClient.getProgramMappingValue(hookManagerProgramId, 'hook_addresses', nonce);
+        if (result === null) {
+            throw new Error(`could not read hook address with nonce ${nonce} from hook_manager ${hookManagerProgramId}`);
+        }
+        return result;
+    }, RETRY_ATTEMPTS, RETRY_DELAY_MS);
+    return `${hookManagerProgramId}/${hookAddressRaw}`;
+}
+//# sourceMappingURL=base.js.map

package/dist/hook/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/hook/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAgC,EAChC,oBAA4B,EAC5B,KAAa;IAEb,MAAM,cAAc,GAAG,MAAM,UAAU,CACrC,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,sBAAsB,CACpD,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,CACN,CAAC;QACF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,0CAA0C,KAAK,sBAAsB,oBAAoB,EAAE,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EACD,cAAc,EACd,cAAc,CACf,CAAC;IAEF,OAAO,GAAG,oBAAoB,IAAI,cAAc,EAAE,CAAC;AACrD,CAAC"}

package/dist/hook/hook-artifact-manager.d.ts

@@ -0,0 +1,25 @@
+import { type ArtifactReader, type ArtifactWriter } from '@recoillink/provider-sdk/artifact';
+import { type DeployedHookAddress, type DeployedHookArtifact, type HookType, type IRawHookArtifactManager, type RawHookArtifactConfigs } from '@recoillink/provider-sdk/hook';
+import { type AnyAleoNetworkClient } from '../clients/base.js';
+import { type AleoSigner } from '../clients/signer.js';
+/**
+ * Aleo Hook Artifact Manager implementing IRawHookArtifactManager.
+ *
+ * This manager:
+ * - Provides factory methods for creating type-specific hook readers and writers
+ * - Supports IGP and MerkleTree hook types
+ * - Automatically detects hook type when reading deployed hooks
+ *
+ * Design: The mailbox address is optional at construction and only validated
+ * when creating writers for deployment. This allows the manager to be used
+ * for read-only operations without requiring deployment context.
+ */
+export declare class AleoHookArtifactManager implements IRawHookArtifactManager {
+    private readonly aleoClient;
+    private readonly mailboxAddress?;
+    constructor(aleoClient: AnyAleoNetworkClient, mailboxAddress?: string | undefined);
+    readHook(address: string): Promise<DeployedHookArtifact>;
+    createReader<T extends HookType>(type: T): ArtifactReader<RawHookArtifactConfigs[T], DeployedHookAddress>;
+    createWriter<T extends HookType>(type: T, signer: AleoSigner): ArtifactWriter<RawHookArtifactConfigs[T], DeployedHookAddress>;
+}
+//# sourceMappingURL=hook-artifact-manager.d.ts.map

package/dist/hook/hook-artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-artifact-manager.d.ts","sourceRoot":"","sources":["../../src/hook/hook-artifact-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAG5B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASvD;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;IAEnE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAFlC,YACmB,UAAU,EAAE,oBAAoB,EAChC,cAAc,CAAC,EAAE,MAAM,YAAA,EACtC;IAEE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAe7D;IAED,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,GACN,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAkBhE;IAED,YAAY,CAAC,CAAC,SAAS,QAAQ,EAC7B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,UAAU,GACjB,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAqBhE;CACF"}

package/dist/hook/hook-artifact-manager.js

@@ -0,0 +1,62 @@
+import { AltVM } from '@recoillink/provider-sdk';
+import { altVmHookTypeToProviderHookType, throwUnsupportedHookType, } from '@recoillink/provider-sdk/hook';
+import { assert } from '@recoillink/utils';
+import { getHookType } from './hook-query.js';
+import { AleoIgpHookReader, AleoIgpHookWriter } from './igp-hook.js';
+import { AleoMerkleTreeHookReader, AleoMerkleTreeHookWriter, } from './merkle-tree-hook.js';
+/**
+ * Aleo Hook Artifact Manager implementing IRawHookArtifactManager.
+ *
+ * This manager:
+ * - Provides factory methods for creating type-specific hook readers and writers
+ * - Supports IGP and MerkleTree hook types
+ * - Automatically detects hook type when reading deployed hooks
+ *
+ * Design: The mailbox address is optional at construction and only validated
+ * when creating writers for deployment. This allows the manager to be used
+ * for read-only operations without requiring deployment context.
+ */
+export class AleoHookArtifactManager {
+    aleoClient;
+    mailboxAddress;
+    constructor(aleoClient, mailboxAddress) {
+        this.aleoClient = aleoClient;
+        this.mailboxAddress = mailboxAddress;
+    }
+    async readHook(address) {
+        // Detect hook type first
+        const aleoHookType = await getHookType(this.aleoClient, address);
+        if (aleoHookType === AltVM.HookType.CUSTOM ||
+            aleoHookType === AltVM.HookType.PAUSABLE) {
+            return throwUnsupportedHookType(aleoHookType, 'Aleo');
+        }
+        // Get the appropriate reader and read the hook
+        const reader = this.createReader(altVmHookTypeToProviderHookType(aleoHookType));
+        return reader.read(address);
+    }
+    createReader(type) {
+        const readers = {
+            [AltVM.HookType.MERKLE_TREE]: () => new AleoMerkleTreeHookReader(this.aleoClient),
+            [AltVM.HookType.INTERCHAIN_GAS_PAYMASTER]: () => new AleoIgpHookReader(this.aleoClient),
+        };
+        const reader = readers[type];
+        if (!reader) {
+            return throwUnsupportedHookType(type, 'Aleo');
+        }
+        return reader();
+    }
+    createWriter(type, signer) {
+        const mailboxAddress = this.mailboxAddress;
+        assert(mailboxAddress, 'mailbox address required for hook deployment');
+        const writers = {
+            [AltVM.HookType.MERKLE_TREE]: () => new AleoMerkleTreeHookWriter(this.aleoClient, signer, mailboxAddress),
+            [AltVM.HookType.INTERCHAIN_GAS_PAYMASTER]: () => new AleoIgpHookWriter(this.aleoClient, signer, mailboxAddress),
+        };
+        const writer = writers[type];
+        if (!writer) {
+            return throwUnsupportedHookType(type, 'Aleo');
+        }
+        return writer();
+    }
+}
+//# sourceMappingURL=hook-artifact-manager.js.map

package/dist/hook/hook-artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-artifact-manager.js","sourceRoot":"","sources":["../../src/hook/hook-artifact-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAKjD,OAAO,EAML,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IAEf,UAAU;IACV,cAAc;IAFjC,YACmB,UAAgC,EAChC,cAAuB;0BADvB,UAAU;8BACV,cAAc;IAC9B,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,yBAAyB;QACzB,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjE,IACE,YAAY,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM;YACtC,YAAY,KAAK,KAAK,CAAC,QAAQ,CAAC,QAAQ,EACxC,CAAC;YACD,OAAO,wBAAwB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QAED,+CAA+C;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,+BAA+B,CAAC,YAAY,CAAC,CAC9C,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,YAAY,CACV,IAAO;QAEP,MAAM,OAAO,GAKR;YACH,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CACjC,IAAI,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC;YAC/C,CAAC,KAAK,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,GAAG,EAAE,CAC9C,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC;SACzC,CAAC;QAEF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,YAAY,CACV,IAAO,EACP,MAAkB;QAElB,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,MAAM,CAAC,cAAc,EAAE,8CAA8C,CAAC,CAAC;QAEvE,MAAM,OAAO,GAKR;YACH,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CACjC,IAAI,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC;YACvE,CAAC,KAAK,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,GAAG,EAAE,CAC9C,IAAI,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC;SACjE,CAAC;QAEF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/hook/hook-query.d.ts

@@ -0,0 +1,44 @@
+import { AltVM } from '@recoillink/provider-sdk';
+import { type AnyAleoNetworkClient } from '../clients/base.js';
+import { AleoHookType } from '../utils/types.js';
+/**
+ * Query the hook type for a given hook address.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @returns The hook type
+ */
+export declare function getHookType(aleoClient: AnyAleoNetworkClient, hookAddress: string): Promise<AltVM.HookType>;
+/**
+ * Query the configuration for a MerkleTree hook.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @returns The MerkleTree hook configuration
+ */
+export declare function getMerkleTreeHookConfig(aleoClient: AnyAleoNetworkClient, hookAddress: string): Promise<{
+    type: AleoHookType.MERKLE_TREE;
+    address: string;
+}>;
+/**
+ * Query the configuration for an IGP (Interchain Gas Paymaster) hook.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @returns The IGP hook configuration with owner and destination gas configs
+ */
+export declare function getIgpHookConfig(aleoClient: AnyAleoNetworkClient, hookAddress: string): Promise<{
+    type: AleoHookType.INTERCHAIN_GAS_PAYMASTER;
+    address: string;
+    owner: string;
+    destinationGasConfigs: {
+        [domainId: string]: {
+            gasOracle: {
+                tokenExchangeRate: string;
+                gasPrice: string;
+            };
+            gasOverhead: string;
+        };
+    };
+}>;
+//# sourceMappingURL=hook-query.d.ts.map

package/dist/hook/hook-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-query.d.ts","sourceRoot":"","sources":["../../src/hook/hook-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGjD,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAM/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiBjD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAqCzB;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAYD;AASD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,IAAI,EAAE,YAAY,CAAC,wBAAwB,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE;QACrB,CAAC,QAAQ,EAAE,MAAM,GAAG;YAClB,SAAS,EAAE;gBACT,iBAAiB,EAAE,MAAM,CAAC;gBAC1B,QAAQ,EAAE,MAAM,CAAC;aAClB,CAAC;YACF,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH,CAAC,CA+ED"}

package/dist/hook/hook-query.js

@@ -0,0 +1,103 @@
+import { AltVM } from '@recoillink/provider-sdk';
+import { assert } from '@recoillink/utils';
+import { queryMappingValue, tryQueryMappingValue, } from '../utils/base-query.js';
+import { fromAleoAddress } from '../utils/helper.js';
+import { AleoHookType } from '../utils/types.js';
+/**
+ * Type guard to check if a number is a valid AleoHookType
+ */
+function isAleoHookType(maybeHookType) {
+    switch (maybeHookType) {
+        case AleoHookType.CUSTOM:
+        case AleoHookType.MERKLE_TREE:
+        case AleoHookType.INTERCHAIN_GAS_PAYMASTER:
+        case AleoHookType.PAUSABLE:
+            return true;
+    }
+    return false;
+}
+/**
+ * Query the hook type for a given hook address.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @returns The hook type
+ */
+export async function getHookType(aleoClient, hookAddress) {
+    const { address, programId } = fromAleoAddress(hookAddress);
+    const result = await queryMappingValue(aleoClient, programId, 'hooks', address, (raw) => {
+        assert(typeof raw === 'number', `Expected hook type to be a number but got ${typeof raw}`);
+        return raw;
+    });
+    assert(isAleoHookType(result), `Unknown hook type ${result} for address: ${hookAddress}`);
+    switch (result) {
+        case AleoHookType.CUSTOM:
+            return AltVM.HookType.CUSTOM;
+        case AleoHookType.MERKLE_TREE:
+            return AltVM.HookType.MERKLE_TREE;
+        case AleoHookType.INTERCHAIN_GAS_PAYMASTER:
+            return AltVM.HookType.INTERCHAIN_GAS_PAYMASTER;
+        case AleoHookType.PAUSABLE:
+            return AltVM.HookType.PAUSABLE;
+        default:
+            throw new Error(`Unknown hook type ${result} for address: ${hookAddress}`);
+    }
+}
+/**
+ * Query the configuration for a MerkleTree hook.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @returns The MerkleTree hook configuration
+ */
+export async function getMerkleTreeHookConfig(aleoClient, hookAddress) {
+    const hookType = await getHookType(aleoClient, hookAddress);
+    assert(hookType === AltVM.HookType.MERKLE_TREE, `Expected MerkleTree hook but got ${hookType} at address ${hookAddress}`);
+    return {
+        type: AleoHookType.MERKLE_TREE,
+        address: hookAddress,
+    };
+}
+/**
+ * Query the configuration for an IGP (Interchain Gas Paymaster) hook.
+ *
+ * @param aleoClient - The Aleo network client
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @returns The IGP hook configuration with owner and destination gas configs
+ */
+export async function getIgpHookConfig(aleoClient, hookAddress) {
+    const hookType = await getHookType(aleoClient, hookAddress);
+    assert(hookType === AltVM.HookType.INTERCHAIN_GAS_PAYMASTER, `Expected IGP hook but got ${hookType} at address ${hookAddress}`);
+    const { programId, address } = fromAleoAddress(hookAddress);
+    const destinationGasConfigs = {};
+    const igpData = await queryMappingValue(aleoClient, programId, 'igps', address, (raw) => {
+        const igpData = raw;
+        assert(igpData?.hook_owner, `Invalid IGP data structure for hook ${hookAddress}, expected object with hook_owner field`);
+        return igpData;
+    });
+    const owner = igpData.hook_owner;
+    const gasConfigLength = await tryQueryMappingValue(aleoClient, programId, 'destination_gas_config_length', address, (raw) => raw);
+    for (let i = 0; i < (gasConfigLength || 0); i++) {
+        const gasConfigKey = await aleoClient.getProgramMappingPlaintext(programId, 'destination_gas_config_iter', `{hook:${address},index:${i}u32}`);
+        const destinationGasConfig = await tryQueryMappingValue(aleoClient, programId, 'destination_gas_configs', gasConfigKey.toString(), (raw) => raw);
+        // This is necessary because `destination_gas_config_iter` maintains keys for all destination domain entries,
+        // including those from domains that have already been removed. When a domain is
+        // deleted from the Destination Gas Configs, its key remains in the map and `destination_gas_configs` simply returns null.
+        if (!destinationGasConfig)
+            continue;
+        destinationGasConfigs[gasConfigKey.toObject().destination] = {
+            gasOracle: {
+                tokenExchangeRate: destinationGasConfig.exchange_rate.toString(),
+                gasPrice: destinationGasConfig.gas_price.toString(),
+            },
+            gasOverhead: destinationGasConfig.gas_overhead.toString(),
+        };
+    }
+    return {
+        type: AleoHookType.INTERCHAIN_GAS_PAYMASTER,
+        address: hookAddress,
+        owner,
+        destinationGasConfigs,
+    };
+}
+//# sourceMappingURL=hook-query.js.map

package/dist/hook/hook-query.js.map

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

package/dist/hook/hook-tx.d.ts

@@ -0,0 +1,46 @@
+import { type AleoTransaction } from '../utils/types.js';
+/**
+ * Build transaction to create a MerkleTree hook
+ *
+ * @param hookManagerProgramId - The hook manager program ID
+ * @param dispatchProxyProgramId - The dispatch proxy program ID
+ * @returns The transaction object
+ */
+export declare function getCreateMerkleTreeHookTx(hookManagerProgramId: string, dispatchProxyProgramId: string): AleoTransaction;
+/**
+ * Build transaction to create an IGP (InterchainGasPaymaster) hook
+ *
+ * @param hookManagerProgramId - The hook manager program ID
+ * @returns The transaction object
+ */
+export declare function getCreateIgpHookTx(hookManagerProgramId: string): AleoTransaction;
+/**
+ * Build transaction to set IGP hook owner
+ *
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @param newOwner - The new owner address
+ * @returns The transaction object
+ */
+export declare function getSetIgpHookOwnerTx(hookAddress: string, newOwner: string): AleoTransaction;
+/**
+ * Build transaction to set destination gas configuration
+ *
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @param gasConfig - The gas configuration for the destination
+ * @returns The transaction object
+ */
+export declare function getSetDestinationGasConfigTx(hookAddress: string, gasConfig: {
+    remoteDomainId: number;
+    gasOverhead: string;
+    tokenExchangeRate: string;
+    gasPrice: string;
+}): AleoTransaction;
+/**
+ * Build transaction to remove destination gas configuration
+ *
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @param remoteDomainId - The remote domain ID to remove
+ * @returns The transaction object
+ */
+export declare function getRemoveDestinationGasConfigTx(hookAddress: string, remoteDomainId: number): AleoTransaction;
+//# sourceMappingURL=hook-tx.d.ts.map

package/dist/hook/hook-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tx.d.ts","sourceRoot":"","sources":["../../src/hook/hook-tx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,oBAAoB,EAAE,MAAM,EAC5B,sBAAsB,EAAE,MAAM,GAC7B,eAAe,CAQjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,oBAAoB,EAAE,MAAM,GAC3B,eAAe,CAQjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,eAAe,CAUjB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE;IACT,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,eAAe,CAcjB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,eAAe,CAUjB"}

package/dist/hook/hook-tx.js

@@ -0,0 +1,89 @@
+import { getAddressFromProgramId } from '../utils/helper.crypto.js';
+import { fromAleoAddress } from '../utils/helper.js';
+/**
+ * Build transaction to create a MerkleTree hook
+ *
+ * @param hookManagerProgramId - The hook manager program ID
+ * @param dispatchProxyProgramId - The dispatch proxy program ID
+ * @returns The transaction object
+ */
+export function getCreateMerkleTreeHookTx(hookManagerProgramId, dispatchProxyProgramId) {
+    return {
+        programName: hookManagerProgramId,
+        functionName: 'init_merkle_tree',
+        priorityFee: 0,
+        privateFee: false,
+        inputs: [getAddressFromProgramId(dispatchProxyProgramId)],
+    };
+}
+/**
+ * Build transaction to create an IGP (InterchainGasPaymaster) hook
+ *
+ * @param hookManagerProgramId - The hook manager program ID
+ * @returns The transaction object
+ */
+export function getCreateIgpHookTx(hookManagerProgramId) {
+    return {
+        programName: hookManagerProgramId,
+        functionName: 'init_igp',
+        priorityFee: 0,
+        privateFee: false,
+        inputs: [],
+    };
+}
+/**
+ * Build transaction to set IGP hook owner
+ *
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @param newOwner - The new owner address
+ * @returns The transaction object
+ */
+export function getSetIgpHookOwnerTx(hookAddress, newOwner) {
+    const { programId, address } = fromAleoAddress(hookAddress);
+    return {
+        programName: programId,
+        functionName: 'transfer_igp_ownership',
+        priorityFee: 0,
+        privateFee: false,
+        inputs: [address, newOwner],
+    };
+}
+/**
+ * Build transaction to set destination gas configuration
+ *
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @param gasConfig - The gas configuration for the destination
+ * @returns The transaction object
+ */
+export function getSetDestinationGasConfigTx(hookAddress, gasConfig) {
+    const { programId, address } = fromAleoAddress(hookAddress);
+    return {
+        programName: programId,
+        functionName: 'set_destination_gas_config',
+        priorityFee: 0,
+        privateFee: false,
+        inputs: [
+            address,
+            `${gasConfig.remoteDomainId}u32`,
+            `{gas_overhead:${gasConfig.gasOverhead}u128,exchange_rate:${gasConfig.tokenExchangeRate}u128,gas_price:${gasConfig.gasPrice}u128}`,
+        ],
+    };
+}
+/**
+ * Build transaction to remove destination gas configuration
+ *
+ * @param hookAddress - The full hook address (e.g., "hook_manager.aleo/aleo1...")
+ * @param remoteDomainId - The remote domain ID to remove
+ * @returns The transaction object
+ */
+export function getRemoveDestinationGasConfigTx(hookAddress, remoteDomainId) {
+    const { programId, address } = fromAleoAddress(hookAddress);
+    return {
+        programName: programId,
+        functionName: 'remove_destination_gas_config',
+        priorityFee: 0,
+        privateFee: false,
+        inputs: [address, `${remoteDomainId}u32`],
+    };
+}
+//# sourceMappingURL=hook-tx.js.map

package/dist/hook/hook-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tx.js","sourceRoot":"","sources":["../../src/hook/hook-tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,oBAA4B,EAC5B,sBAA8B;IAE9B,OAAO;QACL,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,oBAA4B;IAE5B,OAAO;QACL,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,UAAU;QACxB,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,QAAgB;IAEhB,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE5D,OAAO;QACL,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,WAAmB,EACnB,SAKC;IAED,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE5D,OAAO;QACL,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,4BAA4B;QAC1C,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;YACN,OAAO;YACP,GAAG,SAAS,CAAC,cAAc,KAAK;YAChC,iBAAiB,SAAS,CAAC,WAAW,sBAAsB,SAAS,CAAC,iBAAiB,kBAAkB,SAAS,CAAC,QAAQ,OAAO;SACnI;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,WAAmB,EACnB,cAAsB;IAEtB,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE5D,OAAO;QACL,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,+BAA+B;QAC7C,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,cAAc,KAAK,CAAC;KAC1C,CAAC;AACJ,CAAC"}