@bloxchain/sdk 1.0.0-alpha

package/dist/types/core.security.index.js

@@ -0,0 +1,37 @@
+import { keccak256 } from 'viem';
+/**
+ * Constants for SecureOwnable operations
+ * These match the keccak256 hashes defined in SecureOwnableDefinitions.sol
+ */
+export const OPERATION_TYPES = {
+    OWNERSHIP_TRANSFER: keccak256(new TextEncoder().encode("OWNERSHIP_TRANSFER")),
+    BROADCASTER_UPDATE: keccak256(new TextEncoder().encode("BROADCASTER_UPDATE")),
+    RECOVERY_UPDATE: keccak256(new TextEncoder().encode("RECOVERY_UPDATE")),
+    TIMELOCK_UPDATE: keccak256(new TextEncoder().encode("TIMELOCK_UPDATE"))
+};
+/**
+ * Constants for function selectors
+ * These match the selectors from SecureOwnableDefinitions.sol
+ */
+export const FUNCTION_SELECTORS = {
+    // Execution selectors
+    TRANSFER_OWNERSHIP_SELECTOR: keccak256(new TextEncoder().encode("executeTransferOwnership(address)")).slice(0, 10),
+    UPDATE_BROADCASTER_SELECTOR: keccak256(new TextEncoder().encode("executeBroadcasterUpdate(address)")).slice(0, 10),
+    UPDATE_RECOVERY_SELECTOR: keccak256(new TextEncoder().encode("executeRecoveryUpdate(address)")).slice(0, 10),
+    UPDATE_TIMELOCK_SELECTOR: keccak256(new TextEncoder().encode("executeTimeLockUpdate(uint256)")).slice(0, 10),
+    // Time delay selectors
+    TRANSFER_OWNERSHIP_REQUEST_SELECTOR: keccak256(new TextEncoder().encode("transferOwnershipRequest()")).slice(0, 10),
+    TRANSFER_OWNERSHIP_DELAYED_APPROVAL_SELECTOR: keccak256(new TextEncoder().encode("transferOwnershipDelayedApproval(uint256)")).slice(0, 10),
+    TRANSFER_OWNERSHIP_CANCELLATION_SELECTOR: keccak256(new TextEncoder().encode("transferOwnershipCancellation(uint256)")).slice(0, 10),
+    UPDATE_BROADCASTER_REQUEST_SELECTOR: keccak256(new TextEncoder().encode("updateBroadcasterRequest(address)")).slice(0, 10),
+    UPDATE_BROADCASTER_DELAYED_APPROVAL_SELECTOR: keccak256(new TextEncoder().encode("updateBroadcasterDelayedApproval(uint256)")).slice(0, 10),
+    UPDATE_BROADCASTER_CANCELLATION_SELECTOR: keccak256(new TextEncoder().encode("updateBroadcasterCancellation(uint256)")).slice(0, 10),
+    // Meta-transaction selectors
+    TRANSFER_OWNERSHIP_APPROVE_META_SELECTOR: keccak256(new TextEncoder().encode("transferOwnershipApprovalWithMetaTx(((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,bytes4,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,uint256,address,bytes4,uint8,uint256,uint256,address),bytes32,bytes,bytes))")).slice(0, 10),
+    TRANSFER_OWNERSHIP_CANCEL_META_SELECTOR: keccak256(new TextEncoder().encode("transferOwnershipCancellationWithMetaTx(((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,bytes4,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,uint256,address,bytes4,uint8,uint256,uint256,address),bytes32,bytes,bytes))")).slice(0, 10),
+    UPDATE_BROADCASTER_APPROVE_META_SELECTOR: keccak256(new TextEncoder().encode("updateBroadcasterApprovalWithMetaTx(((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,bytes4,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,uint256,address,bytes4,uint8,uint256,uint256,address),bytes32,bytes,bytes))")).slice(0, 10),
+    UPDATE_BROADCASTER_CANCEL_META_SELECTOR: keccak256(new TextEncoder().encode("updateBroadcasterCancellationWithMetaTx(((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,bytes4,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,uint256,address,bytes4,uint8,uint256,uint256,address),bytes32,bytes,bytes))")).slice(0, 10),
+    UPDATE_RECOVERY_META_SELECTOR: keccak256(new TextEncoder().encode("updateRecoveryRequestAndApprove(((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,bytes4,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,uint256,address,bytes4,uint8,uint256,uint256,address),bytes32,bytes,bytes))")).slice(0, 10),
+    UPDATE_TIMELOCK_META_SELECTOR: keccak256(new TextEncoder().encode("updateTimeLockRequestAndApprove(((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,bytes4,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,uint256,address,bytes4,uint8,uint256,uint256,address),bytes32,bytes,bytes))")).slice(0, 10)
+};
+//# sourceMappingURL=core.security.index.js.map

package/dist/types/core.security.index.js.map

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

package/dist/types/definition.index.d.ts

@@ -0,0 +1,36 @@
+import { Hex } from 'viem';
+import { Uint16Bitmap } from '../utils/bitmap';
+/**
+ * TypeScript types for IDefinition interface
+ * These types correspond to the Solidity structs in IDefinition.sol
+ *
+ * Note: Workflow-related types have been moved to workflow.index.tsx
+ */
+/**
+ * Function permission structure matching EngineBlox.FunctionPermission
+ */
+export interface FunctionPermission {
+    functionSelector: Hex;
+    grantedActionsBitmap: Uint16Bitmap;
+    handlerForSelectors: Hex[];
+}
+/**
+ * Function schema structure matching EngineBlox.FunctionSchema
+ */
+export interface FunctionSchema {
+    functionSignature: string;
+    functionSelector: Hex;
+    operationType: Hex;
+    operationName: string;
+    supportedActionsBitmap: Uint16Bitmap;
+    isProtected: boolean;
+    handlerForSelectors: Hex[];
+}
+/**
+ * Role permission structure containing role hashes and their function permissions
+ */
+export interface RolePermission {
+    roleHashes: Hex[];
+    functionPermissions: FunctionPermission[];
+}
+//# sourceMappingURL=definition.index.d.ts.map

package/dist/types/definition.index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.index.d.ts","sourceRoot":"","sources":["../../types/definition.index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,GAAG,CAAC;IACtB,oBAAoB,EAAE,YAAY,CAAC;IACnC,mBAAmB,EAAE,GAAG,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,GAAG,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,YAAY,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,GAAG,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C"}

package/dist/types/definition.index.js

@@ -0,0 +1,4 @@
+export {};
+// Note: IDefinition interface does not provide getOperationTypes()
+// Operation types can be derived from function schemas or queried from BaseStateMachine
+//# sourceMappingURL=definition.index.js.map

package/dist/types/definition.index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.index.js","sourceRoot":"","sources":["../../types/definition.index.tsx"],"names":[],"mappings":";AAyCA,mEAAmE;AACnE,wFAAwF"}

package/dist/types/lib.index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Enums and constants for EngineBlox
+ */
+export declare const TxStatus: {
+    readonly UNDEFINED: 0;
+    readonly PENDING: 1;
+    readonly EXECUTING: 2;
+    readonly PROCESSING_PAYMENT: 3;
+    readonly CANCELLED: 4;
+    readonly COMPLETED: 5;
+    readonly FAILED: 6;
+    readonly REJECTED: 7;
+};
+export type TxStatus = typeof TxStatus[keyof typeof TxStatus];
+export declare const TxAction: {
+    readonly EXECUTE_TIME_DELAY_REQUEST: 0;
+    readonly EXECUTE_TIME_DELAY_APPROVE: 1;
+    readonly EXECUTE_TIME_DELAY_CANCEL: 2;
+    readonly SIGN_META_REQUEST_AND_APPROVE: 3;
+    readonly SIGN_META_APPROVE: 4;
+    readonly SIGN_META_CANCEL: 5;
+    readonly EXECUTE_META_REQUEST_AND_APPROVE: 6;
+    readonly EXECUTE_META_APPROVE: 7;
+    readonly EXECUTE_META_CANCEL: 8;
+};
+export type TxAction = typeof TxAction[keyof typeof TxAction];
+/**
+ * Constants for function selectors
+ */
+export declare const FUNCTION_SELECTORS: {
+    readonly TX_REQUEST: string;
+    readonly TX_DELAYED_APPROVAL: string;
+    readonly TX_CANCELLATION: string;
+    readonly META_TX_APPROVAL: string;
+    readonly META_TX_CANCELLATION: string;
+    readonly META_TX_REQUEST_AND_APPROVE: string;
+};
+export type FunctionSelector = typeof FUNCTION_SELECTORS[keyof typeof FUNCTION_SELECTORS];
+/**
+ * Constants for roles
+ */
+export declare const ROLES: {
+    readonly OWNER_ROLE: string;
+    readonly BROADCASTER_ROLE: string;
+    readonly RECOVERY_ROLE: string;
+};
+export type Role = typeof ROLES[keyof typeof ROLES];
+/**
+ * Constants for EIP-712 type hashes
+ */
+export declare const TYPE_HASHES: {
+    readonly DOMAIN_SEPARATOR: string;
+    readonly META_TRANSACTION: string;
+};
+export type TypeHash = typeof TYPE_HASHES[keyof typeof TYPE_HASHES];
+/**
+ * Event names
+ */
+export declare const EVENTS: {
+    readonly REQUESTED_TX: "RequestedTx";
+    readonly TX_APPROVED: "TxApproved";
+    readonly TX_CANCELLED: "TxCancelled";
+    readonly TX_EXECUTED: "TxExecuted";
+};
+export type Event = typeof EVENTS[keyof typeof EVENTS];
+//# sourceMappingURL=lib.index.d.ts.map

package/dist/types/lib.index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.index.d.ts","sourceRoot":"","sources":["../../types/lib.index.tsx"],"names":[],"mappings":"AASA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAI9D,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,OAAO,kBAAkB,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,KAAK;;;;CAIR,CAAC;AAEX,MAAM,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}

package/dist/types/lib.index.js

@@ -0,0 +1,68 @@
+import { keccak256 as k256, toHex } from 'viem';
+/**
+ * Helper function to compute keccak256 of a string
+ */
+const keccak256 = (str) => {
+    return toHex(k256(new TextEncoder().encode(str)));
+};
+/**
+ * Enums and constants for EngineBlox
+ */
+export const TxStatus = {
+    UNDEFINED: 0,
+    PENDING: 1,
+    EXECUTING: 2,
+    PROCESSING_PAYMENT: 3,
+    CANCELLED: 4,
+    COMPLETED: 5,
+    FAILED: 6,
+    REJECTED: 7
+};
+// ExecutionType enum removed - use executionSelector (0x00000000 for simple ETH transfers) and executionParams directly
+export const TxAction = {
+    EXECUTE_TIME_DELAY_REQUEST: 0,
+    EXECUTE_TIME_DELAY_APPROVE: 1,
+    EXECUTE_TIME_DELAY_CANCEL: 2,
+    SIGN_META_REQUEST_AND_APPROVE: 3,
+    SIGN_META_APPROVE: 4,
+    SIGN_META_CANCEL: 5,
+    EXECUTE_META_REQUEST_AND_APPROVE: 6,
+    EXECUTE_META_APPROVE: 7,
+    EXECUTE_META_CANCEL: 8
+};
+/**
+ * Constants for function selectors
+ */
+export const FUNCTION_SELECTORS = {
+    TX_REQUEST: keccak256("txRequest(address,address,uint256,uint256,bytes32,uint8,bytes)").slice(0, 10),
+    TX_DELAYED_APPROVAL: keccak256("txDelayedApproval(uint256)").slice(0, 10),
+    TX_CANCELLATION: keccak256("txCancellation(uint256)").slice(0, 10),
+    META_TX_APPROVAL: keccak256("txApprovalWithMetaTx((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,uint8,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,address,bytes4,uint256,uint256,uint256,address),bytes,bytes)").slice(0, 10),
+    META_TX_CANCELLATION: keccak256("txCancellationWithMetaTx((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,uint8,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,address,bytes4,uint256,uint256,uint256,address),bytes,bytes)").slice(0, 10),
+    META_TX_REQUEST_AND_APPROVE: keccak256("requestAndApprove((uint256,uint256,uint8,(address,address,uint256,uint256,bytes32,uint8,bytes),bytes32,bytes,(address,uint256,address,uint256)),(uint256,address,bytes4,uint256,uint256,uint256,address),bytes,bytes)").slice(0, 10)
+};
+/**
+ * Constants for roles
+ */
+export const ROLES = {
+    OWNER_ROLE: keccak256("OWNER_ROLE"),
+    BROADCASTER_ROLE: keccak256("BROADCASTER_ROLE"),
+    RECOVERY_ROLE: keccak256("RECOVERY_ROLE")
+};
+/**
+ * Constants for EIP-712 type hashes
+ */
+export const TYPE_HASHES = {
+    DOMAIN_SEPARATOR: keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"),
+    META_TRANSACTION: keccak256("MetaTransaction(TxRecord txRecord,MetaTxParams params,bytes data)TxRecord(uint256 txId,uint256 releaseTime,uint8 status,TxParams params,bytes32 message,bytes result,PaymentDetails payment)TxParams(address requester,address target,uint256 value,uint256 gasLimit,bytes32 operationType,bytes4 executionSelector,bytes executionParams)MetaTxParams(uint256 chainId,uint256 nonce,address handlerContract,bytes4 handlerSelector,uint8 action,uint256 deadline,uint256 maxGasPrice,address signer)PaymentDetails(address recipient,uint256 nativeTokenAmount,address erc20TokenAddress,uint256 erc20TokenAmount)")
+};
+/**
+ * Event names
+ */
+export const EVENTS = {
+    REQUESTED_TX: "RequestedTx",
+    TX_APPROVED: "TxApproved",
+    TX_CANCELLED: "TxCancelled",
+    TX_EXECUTED: "TxExecuted"
+};
+//# sourceMappingURL=lib.index.js.map

package/dist/types/lib.index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.index.js","sourceRoot":"","sources":["../../types/lib.index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,CAAC;IACZ,kBAAkB,EAAE,CAAC;IACrB,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACH,CAAC;AAIX,wHAAwH;AAExH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,0BAA0B,EAAE,CAAC;IAC7B,0BAA0B,EAAE,CAAC;IAC7B,yBAAyB,EAAE,CAAC;IAC5B,6BAA6B,EAAE,CAAC;IAChC,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,CAAC;IACnB,gCAAgC,EAAE,CAAC;IACnC,oBAAoB,EAAE,CAAC;IACvB,mBAAmB,EAAE,CAAC;CACd,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,SAAS,CAAC,gEAAgE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IACpG,mBAAmB,EAAE,SAAS,CAAC,4BAA4B,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IACzE,eAAe,EAAE,SAAS,CAAC,yBAAyB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IAClE,gBAAgB,EAAE,SAAS,CAAC,0NAA0N,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IACpQ,oBAAoB,EAAE,SAAS,CAAC,8NAA8N,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5Q,2BAA2B,EAAE,SAAS,CAAC,uNAAuN,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;CACpQ,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC;IAC/C,aAAa,EAAE,SAAS,CAAC,eAAe,CAAC;CACjC,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB,EAAE,SAAS,CAAC,oFAAoF,CAAC;IACjH,gBAAgB,EAAE,SAAS,CAAC,qlBAAqlB,CAAC;CAC1mB,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,YAAY,EAAE,aAAa;IAC3B,WAAW,EAAE,YAAY;IACzB,YAAY,EAAE,aAAa;IAC3B,WAAW,EAAE,YAAY;CACjB,CAAC"}

package/dist/utils/bitmap.d.ts

@@ -0,0 +1,75 @@
+import { TxAction } from '../types/lib.index';
+/**
+ * Branded type for uint16 bitmap values (0-65535)
+ * This ensures type safety and prevents invalid bitmap values
+ */
+export type Uint16Bitmap = number & {
+    readonly __brand: 'Uint16Bitmap';
+};
+/**
+ * Validates and creates a Uint16Bitmap from a number
+ * @param value The number to validate and convert
+ * @returns A validated Uint16Bitmap
+ * @throws Error if value is outside 0..65535
+ */
+export declare function createUint16Bitmap(value: number): Uint16Bitmap;
+/**
+ * Safely creates a Uint16Bitmap, clamping values outside the valid range
+ * @param value The number to validate and convert
+ * @returns A validated Uint16Bitmap (clamped to valid range)
+ */
+export declare function createUint16BitmapClamped(value: number): Uint16Bitmap;
+/**
+ * Checks if a specific bit is set in the bitmap
+ * @param bitmap The uint16 bitmap
+ * @param bitIndex The bit index to check (0-15, corresponding to TxAction enum values)
+ * @returns True if the bit is set, false otherwise
+ */
+export declare function isBitSet(bitmap: Uint16Bitmap, bitIndex: number): boolean;
+/**
+ * Sets a specific bit in the bitmap
+ * @param bitmap The uint16 bitmap
+ * @param bitIndex The bit index to set (0-15, corresponding to TxAction enum values)
+ * @returns A new Uint16Bitmap with the bit set
+ */
+export declare function setBit(bitmap: Uint16Bitmap, bitIndex: number): Uint16Bitmap;
+/**
+ * Clears a specific bit in the bitmap
+ * @param bitmap The uint16 bitmap
+ * @param bitIndex The bit index to clear (0-15, corresponding to TxAction enum values)
+ * @returns A new Uint16Bitmap with the bit cleared
+ */
+export declare function clearBit(bitmap: Uint16Bitmap, bitIndex: number): Uint16Bitmap;
+/**
+ * Gets the numeric value of the bitmap
+ * @param bitmap The uint16 bitmap
+ * @returns The numeric value (0-65535)
+ */
+export declare function getBitValue(bitmap: Uint16Bitmap): number;
+/**
+ * Creates a bitmap from an array of TxAction values
+ * @param actions Array of TxAction enum values to set in the bitmap
+ * @returns A new Uint16Bitmap with the corresponding bits set
+ */
+export declare function createBitmapFromActions(actions: TxAction[]): Uint16Bitmap;
+/**
+ * Converts a bitmap to an array of TxAction values
+ * @param bitmap The uint16 bitmap
+ * @returns Array of TxAction enum values that are set in the bitmap
+ */
+export declare function getActionsFromBitmap(bitmap: Uint16Bitmap): TxAction[];
+/**
+ * Converts a number to Uint16Bitmap if it's a valid raw value from contract
+ * This is useful when receiving bitmap values from contract calls
+ * @param value The raw number value from contract
+ * @returns A validated Uint16Bitmap
+ */
+export declare function fromContractValue(value: number | bigint): Uint16Bitmap;
+/**
+ * Converts a Uint16Bitmap to a plain number for contract calls
+ * This is useful when passing bitmap values to contract methods
+ * @param bitmap The Uint16Bitmap to convert
+ * @returns The numeric value (0-65535)
+ */
+export declare function toContractValue(bitmap: Uint16Bitmap): number;
+//# sourceMappingURL=bitmap.d.ts.map

package/dist/utils/bitmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmap.d.ts","sourceRoot":"","sources":["../../utils/bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAQzE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAQ9D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAM7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,YAAY,CAMzE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,EAAE,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAGtE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE5D"}

package/dist/utils/bitmap.js

@@ -0,0 +1,124 @@
+/**
+ * Maximum value for uint16 (65535)
+ */
+const UINT16_MAX = 65535;
+const UINT16_MIN = 0;
+/**
+ * Validates and creates a Uint16Bitmap from a number
+ * @param value The number to validate and convert
+ * @returns A validated Uint16Bitmap
+ * @throws Error if value is outside 0..65535
+ */
+export function createUint16Bitmap(value) {
+    if (!Number.isInteger(value)) {
+        throw new Error(`Bitmap value must be an integer, got: ${value}`);
+    }
+    if (value < UINT16_MIN || value > UINT16_MAX) {
+        throw new Error(`Bitmap value must be between ${UINT16_MIN} and ${UINT16_MAX}, got: ${value}`);
+    }
+    return value;
+}
+/**
+ * Safely creates a Uint16Bitmap, clamping values outside the valid range
+ * @param value The number to validate and convert
+ * @returns A validated Uint16Bitmap (clamped to valid range)
+ */
+export function createUint16BitmapClamped(value) {
+    if (!Number.isInteger(value)) {
+        throw new Error(`Bitmap value must be an integer, got: ${value}`);
+    }
+    const clamped = Math.max(UINT16_MIN, Math.min(UINT16_MAX, value));
+    return clamped;
+}
+/**
+ * Checks if a specific bit is set in the bitmap
+ * @param bitmap The uint16 bitmap
+ * @param bitIndex The bit index to check (0-15, corresponding to TxAction enum values)
+ * @returns True if the bit is set, false otherwise
+ */
+export function isBitSet(bitmap, bitIndex) {
+    if (bitIndex < 0 || bitIndex > 15) {
+        throw new Error(`Bit index must be between 0 and 15, got: ${bitIndex}`);
+    }
+    return (bitmap & (1 << bitIndex)) !== 0;
+}
+/**
+ * Sets a specific bit in the bitmap
+ * @param bitmap The uint16 bitmap
+ * @param bitIndex The bit index to set (0-15, corresponding to TxAction enum values)
+ * @returns A new Uint16Bitmap with the bit set
+ */
+export function setBit(bitmap, bitIndex) {
+    if (bitIndex < 0 || bitIndex > 15) {
+        throw new Error(`Bit index must be between 0 and 15, got: ${bitIndex}`);
+    }
+    const newValue = bitmap | (1 << bitIndex);
+    return createUint16Bitmap(newValue);
+}
+/**
+ * Clears a specific bit in the bitmap
+ * @param bitmap The uint16 bitmap
+ * @param bitIndex The bit index to clear (0-15, corresponding to TxAction enum values)
+ * @returns A new Uint16Bitmap with the bit cleared
+ */
+export function clearBit(bitmap, bitIndex) {
+    if (bitIndex < 0 || bitIndex > 15) {
+        throw new Error(`Bit index must be between 0 and 15, got: ${bitIndex}`);
+    }
+    const newValue = bitmap & ~(1 << bitIndex);
+    return createUint16Bitmap(newValue);
+}
+/**
+ * Gets the numeric value of the bitmap
+ * @param bitmap The uint16 bitmap
+ * @returns The numeric value (0-65535)
+ */
+export function getBitValue(bitmap) {
+    return bitmap;
+}
+/**
+ * Creates a bitmap from an array of TxAction values
+ * @param actions Array of TxAction enum values to set in the bitmap
+ * @returns A new Uint16Bitmap with the corresponding bits set
+ */
+export function createBitmapFromActions(actions) {
+    let bitmap = createUint16Bitmap(0);
+    for (const action of actions) {
+        bitmap = setBit(bitmap, action);
+    }
+    return bitmap;
+}
+/**
+ * Converts a bitmap to an array of TxAction values
+ * @param bitmap The uint16 bitmap
+ * @returns Array of TxAction enum values that are set in the bitmap
+ */
+export function getActionsFromBitmap(bitmap) {
+    const actions = [];
+    for (let i = 0; i <= 15; i++) {
+        if (isBitSet(bitmap, i)) {
+            actions.push(i);
+        }
+    }
+    return actions;
+}
+/**
+ * Converts a number to Uint16Bitmap if it's a valid raw value from contract
+ * This is useful when receiving bitmap values from contract calls
+ * @param value The raw number value from contract
+ * @returns A validated Uint16Bitmap
+ */
+export function fromContractValue(value) {
+    const numValue = typeof value === 'bigint' ? Number(value) : value;
+    return createUint16Bitmap(numValue);
+}
+/**
+ * Converts a Uint16Bitmap to a plain number for contract calls
+ * This is useful when passing bitmap values to contract methods
+ * @param bitmap The Uint16Bitmap to convert
+ * @returns The numeric value (0-65535)
+ */
+export function toContractValue(bitmap) {
+    return getBitValue(bitmap);
+}
+//# sourceMappingURL=bitmap.js.map

package/dist/utils/bitmap.js.map

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