@d9-network/spec 1.0.2 → 1.2.2

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

package/dist/index.mjs

@@ -10630,5 +10630,111 @@ function formatBlockDuration(blocks, options = {}) {
 }
 
 //#endregion
-export { AbortedError, ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractError, ContractExecutionError, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, DecodeError, DigestItem, DispatchClass, EncodeError, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, LangError, MetadataError, MultiAddress, NetworkError, Phase, SessionEvent, SignerError, TimeoutError, TransactionError, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, addressesEqual, blocksToMs, blocksUntil, bytesToHex, contracts_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createSr25519SignerFromKeypair, d9_default as d9, estimateBlockAtTime, estimateTimeAtBlock, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata2 as getMetadata, hexToBytes, isContractError, isErrorType, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, parseAmount, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
+//#region src/utils/bytes.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);
+* ```
+*/
+function concatBytes(...arrays) {
+	const totalLength = arrays.reduce((sum, arr$1) => sum + arr$1.length, 0);
+	const result = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const arr$1 of arrays) {
+		result.set(arr$1, offset);
+		offset += arr$1.length;
+	}
+	return result;
+}
+/**
+* Compare two Uint8Arrays for equality
+*
+* @param a - First array
+* @param b - Second array
+* @returns True if arrays are equal
+*/
+function bytesEqual(a, b) {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+	return true;
+}
+/**
+* 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
+*/
+function safeSlice(data, start, length) {
+	if (start < 0 || start > data.length) throw new RangeError(`Start index ${start} out of bounds (0-${data.length})`);
+	const end = length !== void 0 ? start + length : data.length;
+	if (end > data.length) throw new RangeError(`End index ${end} exceeds array length ${data.length}`);
+	return data.slice(start, end);
+}
+/**
+* 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"
+* ```
+*/
+function extractSelector(callData) {
+	const bytes = callData instanceof Uint8Array ? callData : hexToBytes(callData);
+	if (bytes.length < 4) throw new Error(`Call data too short (${bytes.length} bytes), need at least 4 bytes for selector`);
+	return bytes.slice(0, 4);
+}
+/**
+* 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
+* }
+* ```
+*/
+function extractSelectorHex(callData) {
+	return bytesToHex(extractSelector(callData)).slice(2);
+}
+/**
+* Normalize a hex string (ensure 0x prefix, lowercase)
+*
+* @param hex - Hex string with or without 0x prefix
+* @returns Normalized hex string with 0x prefix
+*/
+function normalizeHex(hex$1) {
+	return `0x${(hex$1.startsWith("0x") ? hex$1.slice(2) : hex$1).toLowerCase()}`;
+}
+/**
+* Convert a selector string (with or without 0x) to Uint8Array
+*
+* @param selector - Selector as hex string
+* @returns 4-byte Uint8Array
+*/
+function selectorToBytes(selector) {
+	return hexToBytes(normalizeHex(selector));
+}
+
+//#endregion
+export { AbortedError, ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractError, ContractExecutionError, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, DecodeError, DigestItem, DispatchClass, EncodeError, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, LangError, MetadataError, MultiAddress, NetworkError, Phase, SessionEvent, SignerError, TimeoutError, TransactionError, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, addressesEqual, blocksToMs, blocksUntil, bytesEqual, bytesToHex, concatBytes, contracts_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createSr25519SignerFromKeypair, d9_default as d9, estimateBlockAtTime, estimateTimeAtBlock, extractSelector, extractSelectorHex, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata2 as 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.mjs.map