@d9-network/spec 1.0.2 → 1.1.0

package/dist/index.d.cts

@@ -8716,5 +8716,82 @@ interface FormatDurationOptions {
  */
 declare function formatBlockDuration(blocks: number, options?: FormatDurationOptions): string;
 //#endregion
-export { AbortedError, ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractError, type ContractErrorType, ContractExecutionError, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9ViewFns, D9WhitelistEntry, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, DecodeError, DigestItem, DispatchClass, EncodeError, FormatBalanceOptions, FormatDurationOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, LangError, MetadataError, MultiAddress, NetworkError, Phase, type PolkadotSigner, type SS58String, SessionEvent, SignerError, Sr25519Keypair, TimeoutError, TokenConfig, TransactionError, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, addressesEqual, blocksToMs, blocksUntil, bytesToHex, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createSr25519SignerFromKeypair, _allDescriptors as d9, estimateBlockAtTime, estimateTimeAtBlock, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata, hexToBytes, isContractError, isErrorType, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, parseAmount, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
+//#region src/utils/bytes.d.ts
+/**
+ * Concatenate multiple Uint8Arrays into one
+ *
+ * @param arrays - Arrays to concatenate
+ * @returns Combined Uint8Array
+ *
+ * @example
+ * ```ts
+ * const selector = hexToBytes("0xdb20f9f5");
+ * const args = encodeArgs(...);
+ * const callData = concatBytes(selector, args);
+ * ```
+ */
+declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Compare two Uint8Arrays for equality
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns True if arrays are equal
+ */
+declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Extract a slice from a Uint8Array with bounds checking
+ *
+ * @param data - Source array
+ * @param start - Start index
+ * @param length - Optional length (defaults to rest of array)
+ * @returns Sliced array
+ * @throws If indices are out of bounds
+ */
+declare function safeSlice(data: Uint8Array, start: number, length?: number): Uint8Array;
+/**
+ * Extract selector (first 4 bytes) from call data
+ *
+ * @param callData - The call data (Uint8Array or hex string)
+ * @returns 4-byte selector
+ * @throws If data is less than 4 bytes
+ *
+ * @example
+ * ```ts
+ * const selector = extractSelector(callData);
+ * const selectorHex = bytesToHex(selector); // "0xdb20f9f5"
+ * ```
+ */
+declare function extractSelector(callData: Uint8Array | HexString$1): Uint8Array;
+/**
+ * Extract selector as hex string from call data
+ *
+ * @param callData - The call data (Uint8Array or hex string)
+ * @returns Hex string without 0x prefix (e.g., "db20f9f5")
+ *
+ * @example
+ * ```ts
+ * const selectorHex = extractSelectorHex(callData);
+ * if (selectorHex === "db20f9f5") {
+ *   // PSP22::transfer
+ * }
+ * ```
+ */
+declare function extractSelectorHex(callData: Uint8Array | HexString$1): string;
+/**
+ * Normalize a hex string (ensure 0x prefix, lowercase)
+ *
+ * @param hex - Hex string with or without 0x prefix
+ * @returns Normalized hex string with 0x prefix
+ */
+declare function normalizeHex(hex: string): HexString$1;
+/**
+ * Convert a selector string (with or without 0x) to Uint8Array
+ *
+ * @param selector - Selector as hex string
+ * @returns 4-byte Uint8Array
+ */
+declare function selectorToBytes(selector: string): Uint8Array;
+//#endregion
+export { AbortedError, ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractError, type ContractErrorType, ContractExecutionError, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9ViewFns, D9WhitelistEntry, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, DecodeError, DigestItem, DispatchClass, EncodeError, FormatBalanceOptions, FormatDurationOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, LangError, MetadataError, MultiAddress, NetworkError, Phase, type PolkadotSigner, type SS58String, SessionEvent, SignerError, Sr25519Keypair, TimeoutError, TokenConfig, TransactionError, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, addressesEqual, blocksToMs, blocksUntil, bytesEqual, bytesToHex, concatBytes, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createSr25519SignerFromKeypair, _allDescriptors as d9, estimateBlockAtTime, estimateTimeAtBlock, extractSelector, extractSelectorHex, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata, hexToBytes, isContractError, isErrorType, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, normalizeHex, parseAmount, safeSlice, selectorToBytes, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -8716,5 +8716,82 @@ interface FormatDurationOptions {
  */
 declare function formatBlockDuration(blocks: number, options?: FormatDurationOptions): string;
 //#endregion
-export { AbortedError, ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractError, type ContractErrorType, ContractExecutionError, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9ViewFns, D9WhitelistEntry, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, DecodeError, DigestItem, DispatchClass, EncodeError, FormatBalanceOptions, FormatDurationOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, LangError, MetadataError, MultiAddress, NetworkError, Phase, type PolkadotSigner, type SS58String, SessionEvent, SignerError, Sr25519Keypair, TimeoutError, TokenConfig, TransactionError, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, addressesEqual, blocksToMs, blocksUntil, bytesToHex, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createSr25519SignerFromKeypair, _allDescriptors as d9, estimateBlockAtTime, estimateTimeAtBlock, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata, hexToBytes, isContractError, isErrorType, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, parseAmount, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
+//#region src/utils/bytes.d.ts
+/**
+ * Concatenate multiple Uint8Arrays into one
+ *
+ * @param arrays - Arrays to concatenate
+ * @returns Combined Uint8Array
+ *
+ * @example
+ * ```ts
+ * const selector = hexToBytes("0xdb20f9f5");
+ * const args = encodeArgs(...);
+ * const callData = concatBytes(selector, args);
+ * ```
+ */
+declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Compare two Uint8Arrays for equality
+ *
+ * @param a - First array
+ * @param b - Second array
+ * @returns True if arrays are equal
+ */
+declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Extract a slice from a Uint8Array with bounds checking
+ *
+ * @param data - Source array
+ * @param start - Start index
+ * @param length - Optional length (defaults to rest of array)
+ * @returns Sliced array
+ * @throws If indices are out of bounds
+ */
+declare function safeSlice(data: Uint8Array, start: number, length?: number): Uint8Array;
+/**
+ * Extract selector (first 4 bytes) from call data
+ *
+ * @param callData - The call data (Uint8Array or hex string)
+ * @returns 4-byte selector
+ * @throws If data is less than 4 bytes
+ *
+ * @example
+ * ```ts
+ * const selector = extractSelector(callData);
+ * const selectorHex = bytesToHex(selector); // "0xdb20f9f5"
+ * ```
+ */
+declare function extractSelector(callData: Uint8Array | HexString$1): Uint8Array;
+/**
+ * Extract selector as hex string from call data
+ *
+ * @param callData - The call data (Uint8Array or hex string)
+ * @returns Hex string without 0x prefix (e.g., "db20f9f5")
+ *
+ * @example
+ * ```ts
+ * const selectorHex = extractSelectorHex(callData);
+ * if (selectorHex === "db20f9f5") {
+ *   // PSP22::transfer
+ * }
+ * ```
+ */
+declare function extractSelectorHex(callData: Uint8Array | HexString$1): string;
+/**
+ * Normalize a hex string (ensure 0x prefix, lowercase)
+ *
+ * @param hex - Hex string with or without 0x prefix
+ * @returns Normalized hex string with 0x prefix
+ */
+declare function normalizeHex(hex: string): HexString$1;
+/**
+ * Convert a selector string (with or without 0x) to Uint8Array
+ *
+ * @param selector - Selector as hex string
+ * @returns 4-byte Uint8Array
+ */
+declare function selectorToBytes(selector: string): Uint8Array;
+//#endregion
+export { AbortedError, ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractError, type ContractErrorType, ContractExecutionError, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9ViewFns, D9WhitelistEntry, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, DecodeError, DigestItem, DispatchClass, EncodeError, FormatBalanceOptions, FormatDurationOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, LangError, MetadataError, MultiAddress, NetworkError, Phase, type PolkadotSigner, type SS58String, SessionEvent, SignerError, Sr25519Keypair, TimeoutError, TokenConfig, TransactionError, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, addressesEqual, blocksToMs, blocksUntil, bytesEqual, bytesToHex, concatBytes, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createSr25519SignerFromKeypair, _allDescriptors as d9, estimateBlockAtTime, estimateTimeAtBlock, extractSelector, extractSelectorHex, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata, hexToBytes, isContractError, isErrorType, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, normalizeHex, parseAmount, safeSlice, selectorToBytes, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
 //# sourceMappingURL=index.d.mts.map