@bloxchain/sdk 1.0.0-alpha → 1.0.0-alpha.10

package/dist/contracts/SecureOwnable.js

@@ -1,6 +1,7 @@
 import SecureOwnableABIJson from '../abi/SecureOwnable.abi.json';
 import { BaseStateMachine } from './BaseStateMachine';
 import { INTERFACE_IDS } from '../utils/interface-ids';
+import { updateRecoveryExecutionParams as defUpdateRecoveryExecutionParams, updateTimeLockExecutionParams as defUpdateTimeLockExecutionParams } from '../lib/definitions/SecureOwnableDefinitions';
 /**
  * @title SecureOwnable
  * @notice TypeScript wrapper for SecureOwnable smart contract
@@ -26,8 +27,8 @@ export class SecureOwnable extends BaseStateMachine {
         return this.executeWriteContract('transferOwnershipCancellationWithMetaTx', [metaTx], options);
     }
     // Broadcaster Management
-    async updateBroadcasterRequest(newBroadcaster, options) {
-        return this.executeWriteContract('updateBroadcasterRequest', [newBroadcaster], options);
+    async updateBroadcasterRequest(newBroadcaster, location, options) {
+        return this.executeWriteContract('updateBroadcasterRequest', [newBroadcaster, location], options);
     }
     async updateBroadcasterDelayedApproval(txId, options) {
         return this.executeWriteContract('updateBroadcasterDelayedApproval', [txId], options);
@@ -43,28 +44,26 @@ export class SecureOwnable extends BaseStateMachine {
     }
     // Recovery Management
     /**
-     * @dev Wrapper matching ISecureOwnable interface; delegates to updateRecoveryExecutionParams
+     * @dev Wrapper matching ISecureOwnable interface; delegates to definition helper (no contract call)
      */
     async updateRecoveryExecutionOptions(newRecoveryAddress) {
         return this.updateRecoveryExecutionParams(newRecoveryAddress);
     }
     async updateRecoveryExecutionParams(newRecoveryAddress) {
-        // Contract ABI encodes bytes as Hex string; read directly as Hex
-        return this.executeReadContract('updateRecoveryExecutionParams', [newRecoveryAddress]);
+        return Promise.resolve(defUpdateRecoveryExecutionParams(newRecoveryAddress));
     }
     async updateRecoveryRequestAndApprove(metaTx, options) {
         return this.executeWriteContract('updateRecoveryRequestAndApprove', [metaTx], options);
     }
     // TimeLock Management
     /**
-     * @dev Wrapper matching ISecureOwnable interface; delegates to updateTimeLockExecutionParams
+     * @dev Wrapper matching ISecureOwnable interface; delegates to definition helper (no contract call)
      */
     async updateTimeLockExecutionOptions(newTimeLockPeriodSec) {
         return this.updateTimeLockExecutionParams(newTimeLockPeriodSec);
     }
     async updateTimeLockExecutionParams(newTimeLockPeriodSec) {
-        // Contract ABI encodes bytes as Hex string; read directly as Hex
-        return this.executeReadContract('updateTimeLockExecutionParams', [newTimeLockPeriodSec]);
+        return Promise.resolve(defUpdateTimeLockExecutionParams(newTimeLockPeriodSec));
     }
     async updateTimeLockRequestAndApprove(metaTx, options) {
         return this.executeWriteContract('updateTimeLockRequestAndApprove', [metaTx], options);

package/dist/contracts/SecureOwnable.js.map

@@ -1 +1 @@
-{"version":3,"file":"SecureOwnable.js","sourceRoot":"","sources":["../../contracts/SecureOwnable.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"SecureOwnable.js","sourceRoot":"","sources":["../../contracts/SecureOwnable.tsx"],"names":[],"mappings":"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"}

package/dist/contracts/core/BaseStateMachine.d.ts

@@ -0,0 +1,98 @@
+import { Address, PublicClient, WalletClient, Chain, Hex } from 'viem';
+import { TransactionOptions, TransactionResult } from '../../interfaces/base.index';
+import { IBaseStateMachine } from '../../interfaces/base.state.machine.index';
+import { TxRecord, MetaTransaction, MetaTxParams } from '../../interfaces/lib.index';
+import { TxAction } from '../../types/lib.index';
+import { FunctionSchema } from '../../types/definition.index';
+/**
+ * @title BaseStateMachine
+ * @notice TypeScript wrapper for BaseStateMachine smart contract with common utilities
+ */
+export declare abstract class BaseStateMachine implements IBaseStateMachine {
+    protected client: PublicClient;
+    protected walletClient: WalletClient | undefined;
+    protected contractAddress: Address;
+    protected chain: Chain;
+    protected abi: any;
+    constructor(client: PublicClient, walletClient: WalletClient | undefined, contractAddress: Address, chain: Chain, abi: any);
+    /**
+     * Validates that wallet client is available for write operations
+     */
+    protected validateWalletClient(): void;
+    /**
+     * Common method to execute write contract operations
+     */
+    protected executeWriteContract(functionName: string, args: any[], options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * Common method to execute read contract operations
+     */
+    protected executeReadContract<T>(functionName: string, args?: any[]): Promise<T>;
+    createMetaTxParams(handlerContract: Address, handlerSelector: Hex, action: TxAction, deadline: bigint, maxGasPrice: bigint, signer: Address): Promise<MetaTxParams>;
+    generateUnsignedMetaTransactionForNew(requester: Address, target: Address, value: bigint, gasLimit: bigint, operationType: Hex, executionSelector: Hex, executionParams: Hex, metaTxParams: MetaTxParams): Promise<MetaTransaction>;
+    generateUnsignedMetaTransactionForExisting(txId: bigint, metaTxParams: MetaTxParams): Promise<MetaTransaction>;
+    getTransactionHistory(fromTxId: bigint, toTxId: bigint): Promise<TxRecord[]>;
+    getTransaction(txId: bigint): Promise<TxRecord>;
+    getPendingTransactions(): Promise<bigint[]>;
+    getRole(roleHash: Hex): Promise<{
+        roleName: string;
+        roleHashReturn: Hex;
+        maxWallets: bigint;
+        walletCount: bigint;
+        isProtected: boolean;
+    }>;
+    hasRole(roleHash: Hex, wallet: Address): Promise<boolean>;
+    /**
+     * Gets all roles assigned to a wallet
+     * @param wallet The wallet address to get roles for
+     * @returns Array of role hashes assigned to the wallet
+     * @notice Requires caller to have any role for privacy protection
+     * @notice This function uses the reverse index for efficient lookup
+     */
+    getWalletRoles(wallet: Address): Promise<Hex[]>;
+    /**
+     * Gets all authorized wallets for a role
+     * @param roleHash The role hash to get wallets for
+     * @returns Array of authorized wallet addresses
+     * @notice Requires caller to have any role for privacy protection
+     */
+    getWalletsInRole(roleHash: Hex): Promise<Address[]>;
+    isActionSupportedByFunction(functionSelector: Hex, action: TxAction): Promise<boolean>;
+    getActiveRolePermissions(roleHash: Hex): Promise<any[]>;
+    functionSchemaExists(functionSelector: Hex): Promise<boolean>;
+    getFunctionSchema(functionSelector: Hex): Promise<FunctionSchema>;
+    getSignerNonce(signer: Address): Promise<bigint>;
+    getSupportedOperationTypes(): Promise<Hex[]>;
+    getSupportedRoles(): Promise<Hex[]>;
+    getSupportedFunctions(): Promise<Hex[]>;
+    getTimeLockPeriodSec(): Promise<bigint>;
+    initialized(): Promise<boolean>;
+    /**
+     * @dev Returns the owner of the contract
+     * @return The owner of the contract
+     */
+    owner(): Promise<Address>;
+    /**
+     * @dev Returns all broadcaster addresses
+     * @return Array of broadcaster addresses
+     */
+    getBroadcasters(): Promise<Address[]>;
+    /**
+     * @dev Returns the recovery address
+     * @return The recovery address
+     */
+    getRecovery(): Promise<Address>;
+    /**
+     * @dev Returns all hook contracts registered for a function selector
+     * @param functionSelector The function selector to query hooks for
+     * @return Array of hook contract addresses
+     */
+    getHooks(functionSelector: Hex): Promise<Address[]>;
+    supportsInterface(interfaceId: Hex): Promise<boolean>;
+    /**
+     * @dev Check if this contract supports IBaseStateMachine interface
+     * @return Promise<boolean> indicating if IBaseStateMachine is supported
+     */
+    supportsBaseStateMachineInterface(): Promise<boolean>;
+}
+export default BaseStateMachine;
+//# sourceMappingURL=BaseStateMachine.d.ts.map

package/dist/contracts/core/BaseStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseStateMachine.d.ts","sourceRoot":"","sources":["../../../contracts/core/BaseStateMachine.tsx"],"names":[],"mappings":"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"}

package/dist/contracts/core/BaseStateMachine.js

@@ -0,0 +1,271 @@
+import { handleViemError } from '../../utils/viem-error-handler';
+/**
+ * @title BaseStateMachine
+ * @notice TypeScript wrapper for BaseStateMachine smart contract with common utilities
+ */
+export class BaseStateMachine {
+    constructor(client, walletClient, contractAddress, chain, abi) {
+        this.client = client;
+        this.walletClient = walletClient;
+        this.contractAddress = contractAddress;
+        this.chain = chain;
+        this.abi = abi;
+    }
+    // ============ COMMON UTILITY METHODS ============
+    /**
+     * Validates that wallet client is available for write operations
+     */
+    validateWalletClient() {
+        if (!this.walletClient) {
+            throw new Error('Wallet client is required for this operation');
+        }
+    }
+    /**
+     * Common method to execute write contract operations
+     */
+    async executeWriteContract(functionName, args, options) {
+        this.validateWalletClient();
+        // Viem's writeContract will use the WalletClient's account if available
+        // Only pass account explicitly if it differs from WalletClient's account
+        // Otherwise, let Viem use the WalletClient's account automatically
+        const walletClientAccount = this.walletClient.account?.address;
+        const requestedAccount = options.from.toLowerCase();
+        // For meta-transaction functions, ensure the structure is correct
+        if (functionName.includes('RequestAndApprove') || functionName.includes('MetaTx')) {
+            if (args.length > 0 && args[0] && typeof args[0] === 'object' && 'txRecord' in args[0]) {
+                const metaTx = args[0];
+                // Ensure all nested structures are properly formatted
+                if (metaTx.txRecord && typeof metaTx.txRecord === 'object') {
+                    // Ensure txRecord.params exists and is an object
+                    if (!metaTx.txRecord.params || typeof metaTx.txRecord.params !== 'object') {
+                        throw new Error('Invalid meta-transaction: txRecord.params must be an object');
+                    }
+                    // Ensure txRecord.payment exists and is an object
+                    if (!metaTx.txRecord.payment || typeof metaTx.txRecord.payment !== 'object') {
+                        throw new Error('Invalid meta-transaction: txRecord.payment must be an object');
+                    }
+                }
+                if (metaTx.params && typeof metaTx.params === 'object') {
+                    // Ensure params is properly formatted
+                    if (typeof metaTx.params.action !== 'number') {
+                        throw new Error('Invalid meta-transaction: params.action must be a number');
+                    }
+                }
+            }
+        }
+        const writeContractParams = {
+            chain: this.chain,
+            address: this.contractAddress,
+            abi: this.abi,
+            functionName,
+            args,
+        };
+        // Only set account if it differs from WalletClient's account
+        // This ensures consistency and avoids potential conflicts
+        if (!walletClientAccount || walletClientAccount.toLowerCase() !== requestedAccount) {
+            writeContractParams.account = options.from;
+        }
+        try {
+            // First, simulate the contract call to get better error messages
+            try {
+                await this.client.simulateContract({
+                    ...writeContractParams,
+                    account: writeContractParams.account || this.walletClient.account
+                });
+            }
+            catch (simulateError) {
+                // Re-throw to get better error handling
+                throw simulateError;
+            }
+            const hash = await this.walletClient.writeContract(writeContractParams);
+            return {
+                hash,
+                wait: () => this.client.waitForTransactionReceipt({ hash })
+            };
+        }
+        catch (error) {
+            // Use utility to handle and enhance error with contract error decoding
+            // handleViemError returns Promise<never> and always throws, so this will never return
+            // TypeScript doesn't recognize Promise<never> in control flow, so we explicitly throw
+            throw await handleViemError(error, this.abi);
+        }
+    }
+    /**
+     * Common method to execute read contract operations
+     */
+    async executeReadContract(functionName, args = []) {
+        try {
+            const result = await this.client.readContract({
+                address: this.contractAddress,
+                abi: this.abi,
+                functionName,
+                args,
+                // Include account for permission checks if wallet client is available
+                account: this.walletClient?.account
+            });
+            return result;
+        }
+        catch (error) {
+            // Try to decode the error if it's a contract revert
+            if (error.data || error.cause?.data) {
+                const errorData = error.data || error.cause?.data;
+                if (errorData && typeof errorData === 'string' && errorData.startsWith('0x')) {
+                    try {
+                        const { decodeErrorResult } = await import('viem');
+                        const decoded = decodeErrorResult({
+                            abi: this.abi,
+                            data: errorData
+                        });
+                        throw new Error(`${decoded.errorName}(${JSON.stringify(decoded.args)})`);
+                    }
+                    catch (decodeError) {
+                        // If decoding fails, throw the original error
+                        throw error;
+                    }
+                }
+            }
+            throw error;
+        }
+    }
+    // ============ META-TRANSACTION UTILITIES ============
+    async createMetaTxParams(handlerContract, handlerSelector, action, deadline, maxGasPrice, signer) {
+        return this.executeReadContract('createMetaTxParams', [
+            handlerContract,
+            handlerSelector,
+            action,
+            deadline,
+            maxGasPrice,
+            signer
+        ]);
+    }
+    async generateUnsignedMetaTransactionForNew(requester, target, value, gasLimit, operationType, executionSelector, executionParams, metaTxParams) {
+        return this.executeReadContract('generateUnsignedMetaTransactionForNew', [
+            requester,
+            target,
+            value,
+            gasLimit,
+            operationType,
+            executionSelector,
+            executionParams,
+            metaTxParams
+        ]);
+    }
+    async generateUnsignedMetaTransactionForExisting(txId, metaTxParams) {
+        return this.executeReadContract('generateUnsignedMetaTransactionForExisting', [
+            txId,
+            metaTxParams
+        ]);
+    }
+    // ============ STATE QUERIES ============
+    async getTransactionHistory(fromTxId, toTxId) {
+        return this.executeReadContract('getTransactionHistory', [fromTxId, toTxId]);
+    }
+    async getTransaction(txId) {
+        return this.executeReadContract('getTransaction', [txId]);
+    }
+    async getPendingTransactions() {
+        return this.executeReadContract('getPendingTransactions');
+    }
+    // ============ ROLE AND PERMISSION QUERIES ============
+    async getRole(roleHash) {
+        return this.executeReadContract('getRole', [roleHash]);
+    }
+    async hasRole(roleHash, wallet) {
+        return this.executeReadContract('hasRole', [roleHash, wallet]);
+    }
+    /**
+     * Gets all roles assigned to a wallet
+     * @param wallet The wallet address to get roles for
+     * @returns Array of role hashes assigned to the wallet
+     * @notice Requires caller to have any role for privacy protection
+     * @notice This function uses the reverse index for efficient lookup
+     */
+    async getWalletRoles(wallet) {
+        return this.executeReadContract('getWalletRoles', [wallet]);
+    }
+    /**
+     * Gets all authorized wallets for a role
+     * @param roleHash The role hash to get wallets for
+     * @returns Array of authorized wallet addresses
+     * @notice Requires caller to have any role for privacy protection
+     */
+    async getWalletsInRole(roleHash) {
+        return this.executeReadContract('getWalletsInRole', [roleHash]);
+    }
+    async isActionSupportedByFunction(functionSelector, action) {
+        return this.executeReadContract('isActionSupportedByFunction', [functionSelector, action]);
+    }
+    async getActiveRolePermissions(roleHash) {
+        return this.executeReadContract('getActiveRolePermissions', [roleHash]);
+    }
+    async functionSchemaExists(functionSelector) {
+        return this.executeReadContract('functionSchemaExists', [functionSelector]);
+    }
+    async getFunctionSchema(functionSelector) {
+        return this.executeReadContract('getFunctionSchema', [functionSelector]);
+    }
+    async getSignerNonce(signer) {
+        return this.executeReadContract('getSignerNonce', [signer]);
+    }
+    // ============ SYSTEM STATE QUERIES ============
+    async getSupportedOperationTypes() {
+        return this.executeReadContract('getSupportedOperationTypes');
+    }
+    async getSupportedRoles() {
+        return this.executeReadContract('getSupportedRoles');
+    }
+    async getSupportedFunctions() {
+        return this.executeReadContract('getSupportedFunctions');
+    }
+    async getTimeLockPeriodSec() {
+        return this.executeReadContract('getTimeLockPeriodSec');
+    }
+    async initialized() {
+        return this.executeReadContract('initialized');
+    }
+    // ============ SYSTEM ROLE QUERY FUNCTIONS ============
+    /**
+     * @dev Returns the owner of the contract
+     * @return The owner of the contract
+     */
+    async owner() {
+        return this.executeReadContract('owner');
+    }
+    /**
+     * @dev Returns all broadcaster addresses
+     * @return Array of broadcaster addresses
+     */
+    async getBroadcasters() {
+        return this.executeReadContract('getBroadcasters');
+    }
+    /**
+     * @dev Returns the recovery address
+     * @return The recovery address
+     */
+    async getRecovery() {
+        return this.executeReadContract('getRecovery');
+    }
+    /**
+     * @dev Returns all hook contracts registered for a function selector
+     * @param functionSelector The function selector to query hooks for
+     * @return Array of hook contract addresses
+     */
+    async getHooks(functionSelector) {
+        return this.executeReadContract('getHooks', [functionSelector]);
+    }
+    // ============ INTERFACE SUPPORT ============
+    async supportsInterface(interfaceId) {
+        return this.executeReadContract('supportsInterface', [interfaceId]);
+    }
+    /**
+     * @dev Check if this contract supports IBaseStateMachine interface
+     * @return Promise<boolean> indicating if IBaseStateMachine is supported
+     */
+    async supportsBaseStateMachineInterface() {
+        // Import dynamically to avoid circular dependencies
+        const { INTERFACE_IDS } = await import('../../utils/interface-ids');
+        return this.supportsInterface(INTERFACE_IDS.IBaseStateMachine);
+    }
+}
+export default BaseStateMachine;
+//# sourceMappingURL=BaseStateMachine.js.map

package/dist/contracts/core/BaseStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseStateMachine.js","sourceRoot":"","sources":["../../../contracts/core/BaseStateMachine.tsx"],"names":[],"mappings":"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"}

package/dist/contracts/core/GuardController.d.ts

@@ -0,0 +1,120 @@
+import { Address, PublicClient, WalletClient, Chain, Hex } from 'viem';
+import { TransactionOptions, TransactionResult } from '../../interfaces/base.index';
+import { IGuardController } from '../../interfaces/core.execution.index';
+import { MetaTransaction } from '../../interfaces/lib.index';
+import { BaseStateMachine } from './BaseStateMachine';
+/**
+ * @title GuardController
+ * @notice TypeScript wrapper for GuardController smart contract
+ * @dev Lightweight controller for generic contract delegation with full EngineBlox workflows
+ *
+ * This contract provides a complete solution for delegating control to external addresses.
+ * It extends BaseStateMachine for core state machine functionality and supports all EngineBlox
+ * execution patterns including time-locked transactions, meta-transactions, and payment management.
+ *
+ * This contract is modular and can be combined with RuntimeRBAC and SecureOwnable for role management.
+ */
+export declare class GuardController extends BaseStateMachine implements IGuardController {
+    constructor(client: PublicClient, walletClient: WalletClient | undefined, contractAddress: Address, chain: Chain);
+    /**
+     * @notice Initializer to initialize GuardController
+     * @param initialOwner The initial owner address
+     * @param broadcaster The broadcaster address
+     * @param recovery The recovery address
+     * @param timeLockPeriodSec The timelock period in seconds
+     * @param eventForwarder The event forwarder address
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     */
+    initialize(initialOwner: Address, broadcaster: Address, recovery: Address, timeLockPeriodSec: bigint, eventForwarder: Address, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Requests a time-locked execution via EngineBlox workflow
+     * @param target The address of the target contract
+     * @param value The ETH value to send (0 for standard function calls)
+     * @param functionSelector The function selector to execute (0x00000000 for simple ETH transfers)
+     * @param params The encoded parameters for the function (empty for simple ETH transfers)
+     * @param gasLimit The gas limit for execution
+     * @param operationType The operation type hash
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice Creates a time-locked transaction that must be approved after the timelock period
+     * @notice Requires EXECUTE_TIME_DELAY_REQUEST permission for the function selector
+     * @notice For standard function calls: value=0, functionSelector=non-zero, params=encoded data
+     * @notice For simple ETH transfers: value>0, functionSelector=0x00000000, params=""
+     */
+    executeWithTimeLock(target: Address, value: bigint, functionSelector: Hex, params: Hex, gasLimit: bigint, operationType: Hex, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Approves and executes a time-locked transaction
+     * @param txId The transaction ID
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice Requires STANDARD execution type and EXECUTE_TIME_DELAY_APPROVE permission for the execution function
+     */
+    approveTimeLockExecution(txId: bigint, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Cancels a time-locked transaction
+     * @param txId The transaction ID
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice Requires STANDARD execution type and EXECUTE_TIME_DELAY_CANCEL permission for the execution function
+     */
+    cancelTimeLockExecution(txId: bigint, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Approves a time-locked transaction using a meta-transaction
+     * @param metaTx The meta-transaction containing the transaction record and signature
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice Requires STANDARD execution type and EXECUTE_META_APPROVE permission for the execution function
+     */
+    approveTimeLockExecutionWithMetaTx(metaTx: MetaTransaction, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Cancels a time-locked transaction using a meta-transaction
+     * @param metaTx The meta-transaction containing the transaction record and signature
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice Requires STANDARD execution type and EXECUTE_META_CANCEL permission for the execution function
+     */
+    cancelTimeLockExecutionWithMetaTx(metaTx: MetaTransaction, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Requests and approves a transaction in one step using a meta-transaction
+     * @param metaTx The meta-transaction containing the transaction record and signature
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice Requires STANDARD execution type
+     * @notice Validates function schema and permissions for the execution function (same as executeWithTimeLock)
+     * @notice Requires EXECUTE_META_REQUEST_AND_APPROVE permission for the execution function selector
+     */
+    requestAndApproveExecution(metaTx: MetaTransaction, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Creates execution params for a guard configuration batch (definition helper; no contract call)
+     * @param actions Guard configuration actions
+     * @return Promise<Hex> The execution params to be used in a meta-transaction
+     */
+    guardConfigBatchExecutionParams(actions: Array<{
+        actionType: number;
+        data: Hex;
+    }>): Promise<Hex>;
+    /**
+     * @dev Requests and approves a guard configuration batch using a meta-transaction
+     * @param metaTx The meta-transaction describing the guard configuration batch
+     * @param options Transaction options including from address
+     * @return TransactionResult with hash and wait function
+     * @notice OWNER signs, BROADCASTER executes according to GuardControllerDefinitions
+     * @notice Supports whitelist management and function schema registration
+     */
+    guardConfigBatchRequestAndApprove(metaTx: MetaTransaction, options: TransactionOptions): Promise<TransactionResult>;
+    /**
+     * @dev Gets all whitelisted targets for a function selector (from BaseStateMachine).
+     * @param functionSelector The function selector
+     * @return Promise<Address[]> Array of whitelisted target addresses
+     * @notice Requires caller to have any role (via _validateAnyRole) for privacy protection
+     */
+    getFunctionWhitelistTargets(functionSelector: Hex): Promise<Address[]>;
+    /**
+     * @dev Check if this contract supports IGuardController interface
+     * @return Promise<boolean> indicating if IGuardController is supported
+     */
+    supportsGuardControllerInterface(): Promise<boolean>;
+}
+export default GuardController;
+//# sourceMappingURL=GuardController.d.ts.map

package/dist/contracts/core/GuardController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuardController.d.ts","sourceRoot":"","sources":["../../../contracts/core/GuardController.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,SAAQ,gBAAiB,YAAW,gBAAgB;gBAE7E,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,eAAe,EAAE,OAAO,EACxB,KAAK,EAAE,KAAK;IAOd;;;;;;;;;OASG;IACG,UAAU,CACd,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAU7B;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,CACvB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,GAAG,EACrB,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,GAAG,EAClB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;;;;;OAMG;IACG,wBAAwB,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;;;;;OAMG;IACG,uBAAuB,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;;;;;OAMG;IACG,kCAAkC,CACtC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;;;;;OAMG;IACG,iCAAiC,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;;;;;;;OAQG;IACG,0BAA0B,CAC9B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAU7B;;;;OAIG;IACG,+BAA+B,CACnC,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,GAChD,OAAO,CAAC,GAAG,CAAC;IAIf;;;;;;;OAOG;IACG,iCAAiC,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;OAKG;IACG,2BAA2B,CAC/B,gBAAgB,EAAE,GAAG,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC;IAcrB;;;OAGG;IACG,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC;CAY3D;AAED,eAAe,eAAe,CAAC"}