@d9-network/spec 0.0.13 → 0.0.15

package/dist/index.d.cts

@@ -8965,6 +8965,18 @@ declare class ContractEventParser<S extends InkStorageDescriptor = InkStorageDes
    * ```
    */
   parseEvent(chainEvent: unknown): TypedContractEvent<E> | null;
+  /**
+   * Extract event label from ASCII-encoded topic (D9 chain format)
+   *
+   * D9 chain uses a format where:
+   * - First byte is 0x00 (null)
+   * - Remaining 31 bytes are ASCII characters of `ContractName::EventLabel`
+   * - Total is exactly 32 bytes (truncated/padded as needed)
+   *
+   * @param topic - The 32-byte topic from the event
+   * @returns The extracted event label, or null if not in ASCII format
+   */
+  private extractEventLabelFromAsciiTopic;
   /**
    * Filter a batch of events and return type-safe results
    *
@@ -9009,10 +9021,6 @@ declare class ContractEventParser<S extends InkStorageDescriptor = InkStorageDes
    * Compare two Uint8Arrays for equality
    */
   private bytesEqual;
-  /**
-   * Build event signature map from metadata
-   */
-  private static buildEventSignatureMap;
 }
 /**
  * Type guard for narrowing event types
@@ -9191,5 +9199,304 @@ declare function createAccountFromPrivateKey(options: {
   keyType: "sr25519" | "ed25519" | "secp256k1";
 }): WalletAccount;
 //#endregion
-export { ArithmeticError, BalanceStatus, BalancesTypesReasons, ContractEventParser, CreateD9SdkClientOptions, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9SdkClientReturn, D9ViewFns, D9WhitelistEntry, type DecodedContractEvent, DigestItem, DispatchClass, type EventFilterOptions, type EventSubscriptionOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, MultiAddress, Phase, type PolkadotSigner, type RawContractEvent, type SS58String, SessionEvent, Sr25519Keypair, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, bytesToHex, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createContractEventStream, createD9SdkClient, createNativeTransferStream, createPSP22TransferStream, createSr25519SignerFromKeypair, _allDescriptors as d9, generateMnemonic, getMetadata, hexToBytes, isHexString, mnemonicToMiniSecret, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, validateMnemonic };
+//#region src/wallet/validation.d.ts
+/**
+ * Check if a value is a valid SS58 address
+ *
+ * @param address - The value to check
+ * @returns True if the value is a valid SS58 address
+ *
+ * @example
+ * ```typescript
+ * isValidAddress("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"); // true
+ * isValidAddress("invalid"); // false
+ * isValidAddress(null); // false
+ * ```
+ */
+declare function isValidAddress(address: unknown): address is SS58String$1;
+/**
+ * Check if a value is a valid D9 address (SS58 prefix 9)
+ *
+ * @param address - The value to check
+ * @returns True if the value is a valid D9 address
+ *
+ * @example
+ * ```typescript
+ * isValidD9Address("XYZd9..."); // true (if valid D9 prefix)
+ * isValidD9Address("5GrwvaEF..."); // false (Polkadot prefix)
+ * ```
+ */
+declare function isValidD9Address(address: unknown): address is SS58String$1;
+/**
+ * Check if a value is a valid address for a specific network
+ *
+ * @param address - The value to check
+ * @param expectedPrefix - The expected SS58 prefix
+ * @returns True if the value is a valid address with the expected prefix
+ *
+ * @example
+ * ```typescript
+ * isValidAddressForNetwork(address, 0); // Polkadot
+ * isValidAddressForNetwork(address, 2); // Kusama
+ * isValidAddressForNetwork(address, 9); // D9
+ * ```
+ */
+declare function isValidAddressForNetwork(address: unknown, expectedPrefix: number): address is SS58String$1;
+/**
+ * Get the SS58 prefix of an address
+ *
+ * @param address - The SS58 address
+ * @returns The SS58 prefix
+ * @throws Error if the address is invalid
+ *
+ * @example
+ * ```typescript
+ * getAddressPrefix("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"); // 42 (Substrate generic)
+ * ```
+ */
+declare function getAddressPrefix(address: SS58String$1): number;
+/**
+ * Compare two addresses for equality (same public key)
+ *
+ * Addresses with different SS58 prefixes can represent the same account.
+ * This function compares the underlying public keys.
+ *
+ * @param a - First address
+ * @param b - Second address
+ * @returns True if both addresses represent the same public key
+ *
+ * @example
+ * ```typescript
+ * // Same account, different network formats
+ * const polkadotAddr = "15oF4uVJwmo4TdGW7VfQxNLavjCXviqxT9S1MgbjMNHr6Sp5";
+ * const genericAddr = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";
+ * addressesEqual(polkadotAddr, genericAddr); // true
+ * ```
+ */
+declare function addressesEqual(a: SS58String$1, b: SS58String$1): boolean;
+/**
+ * Convert an address to a specific SS58 format
+ *
+ * @param address - The SS58 address
+ * @param targetPrefix - The target SS58 prefix
+ * @returns The address encoded with the target prefix
+ * @throws Error if the address is invalid
+ *
+ * @example
+ * ```typescript
+ * const d9Address = toNetworkAddress("5GrwvaEF...", 9);
+ * ```
+ */
+declare function toNetworkAddress(address: SS58String$1, targetPrefix: number): SS58String$1;
+/**
+ * Convert an address to D9 format
+ *
+ * @param address - The SS58 address
+ * @returns The address encoded with D9 prefix (9)
+ *
+ * @example
+ * ```typescript
+ * const d9Address = toD9Address("5GrwvaEF...");
+ * ```
+ */
+declare function toD9Address(address: SS58String$1): SS58String$1;
+//#endregion
+//#region src/utils/balance.d.ts
+/**
+ * Balance formatting utilities for D9 blockchain
+ */
+declare const D9_DECIMALS = 12;
+declare const D9_SYMBOL = "D9";
+declare const D9_SS58_PREFIX = 9;
+declare const USDT_DECIMALS = 2;
+declare const USDT_SYMBOL = "USDT";
+/**
+ * Token configuration for formatting
+ */
+interface TokenConfig {
+  decimals: number;
+  symbol: string;
+}
+/**
+ * Pre-configured D9 token
+ */
+declare const D9_TOKEN: TokenConfig;
+/**
+ * Pre-configured USDT token
+ */
+declare const USDT_TOKEN: TokenConfig;
+/**
+ * Options for formatting balance
+ */
+interface FormatBalanceOptions {
+  /** Number of decimal places (default: token's decimals) */
+  decimals?: number;
+  /** Maximum decimal places to display (default: 4) */
+  maxDecimals?: number;
+  /** Whether to trim trailing zeros (default: true) */
+  trimTrailingZeros?: boolean;
+  /** Thousands separator (default: none) */
+  thousandsSeparator?: string;
+}
+/**
+ * Format a raw planck value to a human-readable balance string
+ *
+ * @param planck - The raw balance in planck units (smallest unit)
+ * @param options - Formatting options
+ * @returns Formatted balance string
+ *
+ * @example
+ * ```typescript
+ * formatBalance(1_500_000_000_000n, { decimals: 12 }); // "1.5"
+ * formatBalance(1_500_000_000_000n, { decimals: 12, maxDecimals: 2 }); // "1.50"
+ * formatBalance(1_000_000_000_000_000n, { decimals: 12, thousandsSeparator: "," }); // "1,000"
+ * ```
+ */
+declare function formatBalance(planck: bigint, options?: FormatBalanceOptions): string;
+/**
+ * Parse a human-readable amount string to planck units
+ *
+ * @param amount - The amount as a string or number
+ * @param options - Parse options
+ * @returns The amount in planck units (bigint)
+ *
+ * @example
+ * ```typescript
+ * parseAmount("1.5", { decimals: 12 }); // 1_500_000_000_000n
+ * parseAmount(1.5, { decimals: 12 }); // 1_500_000_000_000n
+ * parseAmount("1,000.50", { decimals: 12 }); // 1_000_500_000_000_000n
+ * ```
+ */
+declare function parseAmount(amount: string | number, options?: {
+  decimals?: number;
+}): bigint;
+/**
+ * Format a token amount with symbol
+ *
+ * @param planck - The raw balance in planck units
+ * @param token - Token configuration
+ * @param options - Additional formatting options
+ * @returns Formatted string with token symbol
+ *
+ * @example
+ * ```typescript
+ * formatTokenAmount(1_500_000_000_000n, D9_TOKEN); // "1.5 D9"
+ * formatTokenAmount(1000n, USDT_TOKEN); // "10 USDT"
+ * ```
+ */
+declare function formatTokenAmount(planck: bigint, token: TokenConfig, options?: Omit<FormatBalanceOptions, "decimals">): string;
+//#endregion
+//#region src/utils/time.d.ts
+/**
+ * Block time utilities for D9 blockchain
+ */
+declare const D9_BLOCK_TIME_MS = 3000;
+declare const BLOCKS_PER_MINUTE = 20;
+declare const BLOCKS_PER_HOUR = 1200;
+declare const BLOCKS_PER_DAY = 28800;
+declare const BLOCKS_PER_WEEK = 201600;
+/**
+ * Convert milliseconds to blocks
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Number of blocks (rounded down)
+ *
+ * @example
+ * ```typescript
+ * msToBlocks(60_000); // 20 blocks (1 minute)
+ * msToBlocks(3_600_000); // 1200 blocks (1 hour)
+ * ```
+ */
+declare function msToBlocks(ms: number): number;
+/**
+ * Convert blocks to milliseconds
+ *
+ * @param blocks - Number of blocks
+ * @returns Duration in milliseconds
+ *
+ * @example
+ * ```typescript
+ * blocksToMs(20); // 60_000 (1 minute)
+ * blocksToMs(1200); // 3_600_000 (1 hour)
+ * ```
+ */
+declare function blocksToMs(blocks: number): number;
+/**
+ * Estimate the block number at a target time
+ *
+ * @param targetTime - The target time to estimate block for
+ * @param currentBlock - The current block number
+ * @param currentTime - The current time (default: now)
+ * @returns Estimated block number at target time
+ *
+ * @example
+ * ```typescript
+ * const targetBlock = estimateBlockAtTime(
+ *   new Date(Date.now() + 3_600_000), // 1 hour from now
+ *   1000, // current block
+ * ); // ~2200
+ * ```
+ */
+declare function estimateBlockAtTime(targetTime: Date, currentBlock: number, currentTime?: Date): number;
+/**
+ * Estimate the time at a target block
+ *
+ * @param targetBlock - The target block number
+ * @param currentBlock - The current block number
+ * @param currentTime - The current time (default: now)
+ * @returns Estimated time at target block
+ *
+ * @example
+ * ```typescript
+ * const unlockTime = estimateTimeAtBlock(
+ *   2200, // target block
+ *   1000, // current block
+ * ); // ~1 hour from now
+ * ```
+ */
+declare function estimateTimeAtBlock(targetBlock: number, currentBlock: number, currentTime?: Date): Date;
+/**
+ * Calculate the number of blocks until a target time
+ *
+ * @param targetTime - The target time
+ * @param currentBlock - The current block number
+ * @param currentTime - The current time (default: now)
+ * @returns Number of blocks until target time (negative if in the past)
+ *
+ * @example
+ * ```typescript
+ * const blocksRemaining = blocksUntil(unlockTime, currentBlock);
+ * if (blocksRemaining > 0) {
+ *   console.log(`${blocksRemaining} blocks until unlock`);
+ * }
+ * ```
+ */
+declare function blocksUntil(targetTime: Date, currentBlock: number, currentTime?: Date): number;
+/**
+ * Format options for duration display
+ */
+interface FormatDurationOptions {
+  /** Whether to show short units (d, h, m, s) or long (days, hours, minutes, seconds) */
+  short?: boolean;
+  /** Maximum number of units to display (default: 2) */
+  maxUnits?: number;
+}
+/**
+ * Format a block duration as a human-readable string
+ *
+ * @param blocks - Number of blocks
+ * @param options - Formatting options
+ * @returns Human-readable duration string
+ *
+ * @example
+ * ```typescript
+ * formatBlockDuration(20); // "1 minute"
+ * formatBlockDuration(1200); // "1 hour"
+ * formatBlockDuration(BLOCKS_PER_DAY); // "1 day"
+ * formatBlockDuration(30000, { short: true }); // "1d 1h"
+ * ```
+ */
+declare function formatBlockDuration(blocks: number, options?: FormatDurationOptions): string;
+//#endregion
+export { ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractEventParser, CreateD9SdkClientOptions, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9SdkClientReturn, D9ViewFns, D9WhitelistEntry, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, type DecodedContractEvent, DigestItem, DispatchClass, type EventFilterOptions, type EventSubscriptionOptions, FormatBalanceOptions, FormatDurationOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, MultiAddress, Phase, type PolkadotSigner, type RawContractEvent, type SS58String, SessionEvent, Sr25519Keypair, TokenConfig, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, addressesEqual, blocksToMs, blocksUntil, bytesToHex, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createContractEventStream, createD9SdkClient, createNativeTransferStream, createPSP22TransferStream, createSr25519SignerFromKeypair, _allDescriptors as d9, estimateBlockAtTime, estimateTimeAtBlock, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata, hexToBytes, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, parseAmount, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -8965,6 +8965,18 @@ declare class ContractEventParser<S extends InkStorageDescriptor = InkStorageDes
    * ```
    */
   parseEvent(chainEvent: unknown): TypedContractEvent<E> | null;
+  /**
+   * Extract event label from ASCII-encoded topic (D9 chain format)
+   *
+   * D9 chain uses a format where:
+   * - First byte is 0x00 (null)
+   * - Remaining 31 bytes are ASCII characters of `ContractName::EventLabel`
+   * - Total is exactly 32 bytes (truncated/padded as needed)
+   *
+   * @param topic - The 32-byte topic from the event
+   * @returns The extracted event label, or null if not in ASCII format
+   */
+  private extractEventLabelFromAsciiTopic;
   /**
    * Filter a batch of events and return type-safe results
    *
@@ -9009,10 +9021,6 @@ declare class ContractEventParser<S extends InkStorageDescriptor = InkStorageDes
    * Compare two Uint8Arrays for equality
    */
   private bytesEqual;
-  /**
-   * Build event signature map from metadata
-   */
-  private static buildEventSignatureMap;
 }
 /**
  * Type guard for narrowing event types
@@ -9191,5 +9199,304 @@ declare function createAccountFromPrivateKey(options: {
   keyType: "sr25519" | "ed25519" | "secp256k1";
 }): WalletAccount;
 //#endregion
-export { ArithmeticError, BalanceStatus, BalancesTypesReasons, ContractEventParser, CreateD9SdkClientOptions, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9SdkClientReturn, D9ViewFns, D9WhitelistEntry, type DecodedContractEvent, DigestItem, DispatchClass, type EventFilterOptions, type EventSubscriptionOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, MultiAddress, Phase, type PolkadotSigner, type RawContractEvent, type SS58String, SessionEvent, Sr25519Keypair, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, bytesToHex, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createContractEventStream, createD9SdkClient, createNativeTransferStream, createPSP22TransferStream, createSr25519SignerFromKeypair, _allDescriptors as d9, generateMnemonic, getMetadata, hexToBytes, isHexString, mnemonicToMiniSecret, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, validateMnemonic };
+//#region src/wallet/validation.d.ts
+/**
+ * Check if a value is a valid SS58 address
+ *
+ * @param address - The value to check
+ * @returns True if the value is a valid SS58 address
+ *
+ * @example
+ * ```typescript
+ * isValidAddress("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"); // true
+ * isValidAddress("invalid"); // false
+ * isValidAddress(null); // false
+ * ```
+ */
+declare function isValidAddress(address: unknown): address is SS58String$1;
+/**
+ * Check if a value is a valid D9 address (SS58 prefix 9)
+ *
+ * @param address - The value to check
+ * @returns True if the value is a valid D9 address
+ *
+ * @example
+ * ```typescript
+ * isValidD9Address("XYZd9..."); // true (if valid D9 prefix)
+ * isValidD9Address("5GrwvaEF..."); // false (Polkadot prefix)
+ * ```
+ */
+declare function isValidD9Address(address: unknown): address is SS58String$1;
+/**
+ * Check if a value is a valid address for a specific network
+ *
+ * @param address - The value to check
+ * @param expectedPrefix - The expected SS58 prefix
+ * @returns True if the value is a valid address with the expected prefix
+ *
+ * @example
+ * ```typescript
+ * isValidAddressForNetwork(address, 0); // Polkadot
+ * isValidAddressForNetwork(address, 2); // Kusama
+ * isValidAddressForNetwork(address, 9); // D9
+ * ```
+ */
+declare function isValidAddressForNetwork(address: unknown, expectedPrefix: number): address is SS58String$1;
+/**
+ * Get the SS58 prefix of an address
+ *
+ * @param address - The SS58 address
+ * @returns The SS58 prefix
+ * @throws Error if the address is invalid
+ *
+ * @example
+ * ```typescript
+ * getAddressPrefix("5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"); // 42 (Substrate generic)
+ * ```
+ */
+declare function getAddressPrefix(address: SS58String$1): number;
+/**
+ * Compare two addresses for equality (same public key)
+ *
+ * Addresses with different SS58 prefixes can represent the same account.
+ * This function compares the underlying public keys.
+ *
+ * @param a - First address
+ * @param b - Second address
+ * @returns True if both addresses represent the same public key
+ *
+ * @example
+ * ```typescript
+ * // Same account, different network formats
+ * const polkadotAddr = "15oF4uVJwmo4TdGW7VfQxNLavjCXviqxT9S1MgbjMNHr6Sp5";
+ * const genericAddr = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";
+ * addressesEqual(polkadotAddr, genericAddr); // true
+ * ```
+ */
+declare function addressesEqual(a: SS58String$1, b: SS58String$1): boolean;
+/**
+ * Convert an address to a specific SS58 format
+ *
+ * @param address - The SS58 address
+ * @param targetPrefix - The target SS58 prefix
+ * @returns The address encoded with the target prefix
+ * @throws Error if the address is invalid
+ *
+ * @example
+ * ```typescript
+ * const d9Address = toNetworkAddress("5GrwvaEF...", 9);
+ * ```
+ */
+declare function toNetworkAddress(address: SS58String$1, targetPrefix: number): SS58String$1;
+/**
+ * Convert an address to D9 format
+ *
+ * @param address - The SS58 address
+ * @returns The address encoded with D9 prefix (9)
+ *
+ * @example
+ * ```typescript
+ * const d9Address = toD9Address("5GrwvaEF...");
+ * ```
+ */
+declare function toD9Address(address: SS58String$1): SS58String$1;
+//#endregion
+//#region src/utils/balance.d.ts
+/**
+ * Balance formatting utilities for D9 blockchain
+ */
+declare const D9_DECIMALS = 12;
+declare const D9_SYMBOL = "D9";
+declare const D9_SS58_PREFIX = 9;
+declare const USDT_DECIMALS = 2;
+declare const USDT_SYMBOL = "USDT";
+/**
+ * Token configuration for formatting
+ */
+interface TokenConfig {
+  decimals: number;
+  symbol: string;
+}
+/**
+ * Pre-configured D9 token
+ */
+declare const D9_TOKEN: TokenConfig;
+/**
+ * Pre-configured USDT token
+ */
+declare const USDT_TOKEN: TokenConfig;
+/**
+ * Options for formatting balance
+ */
+interface FormatBalanceOptions {
+  /** Number of decimal places (default: token's decimals) */
+  decimals?: number;
+  /** Maximum decimal places to display (default: 4) */
+  maxDecimals?: number;
+  /** Whether to trim trailing zeros (default: true) */
+  trimTrailingZeros?: boolean;
+  /** Thousands separator (default: none) */
+  thousandsSeparator?: string;
+}
+/**
+ * Format a raw planck value to a human-readable balance string
+ *
+ * @param planck - The raw balance in planck units (smallest unit)
+ * @param options - Formatting options
+ * @returns Formatted balance string
+ *
+ * @example
+ * ```typescript
+ * formatBalance(1_500_000_000_000n, { decimals: 12 }); // "1.5"
+ * formatBalance(1_500_000_000_000n, { decimals: 12, maxDecimals: 2 }); // "1.50"
+ * formatBalance(1_000_000_000_000_000n, { decimals: 12, thousandsSeparator: "," }); // "1,000"
+ * ```
+ */
+declare function formatBalance(planck: bigint, options?: FormatBalanceOptions): string;
+/**
+ * Parse a human-readable amount string to planck units
+ *
+ * @param amount - The amount as a string or number
+ * @param options - Parse options
+ * @returns The amount in planck units (bigint)
+ *
+ * @example
+ * ```typescript
+ * parseAmount("1.5", { decimals: 12 }); // 1_500_000_000_000n
+ * parseAmount(1.5, { decimals: 12 }); // 1_500_000_000_000n
+ * parseAmount("1,000.50", { decimals: 12 }); // 1_000_500_000_000_000n
+ * ```
+ */
+declare function parseAmount(amount: string | number, options?: {
+  decimals?: number;
+}): bigint;
+/**
+ * Format a token amount with symbol
+ *
+ * @param planck - The raw balance in planck units
+ * @param token - Token configuration
+ * @param options - Additional formatting options
+ * @returns Formatted string with token symbol
+ *
+ * @example
+ * ```typescript
+ * formatTokenAmount(1_500_000_000_000n, D9_TOKEN); // "1.5 D9"
+ * formatTokenAmount(1000n, USDT_TOKEN); // "10 USDT"
+ * ```
+ */
+declare function formatTokenAmount(planck: bigint, token: TokenConfig, options?: Omit<FormatBalanceOptions, "decimals">): string;
+//#endregion
+//#region src/utils/time.d.ts
+/**
+ * Block time utilities for D9 blockchain
+ */
+declare const D9_BLOCK_TIME_MS = 3000;
+declare const BLOCKS_PER_MINUTE = 20;
+declare const BLOCKS_PER_HOUR = 1200;
+declare const BLOCKS_PER_DAY = 28800;
+declare const BLOCKS_PER_WEEK = 201600;
+/**
+ * Convert milliseconds to blocks
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Number of blocks (rounded down)
+ *
+ * @example
+ * ```typescript
+ * msToBlocks(60_000); // 20 blocks (1 minute)
+ * msToBlocks(3_600_000); // 1200 blocks (1 hour)
+ * ```
+ */
+declare function msToBlocks(ms: number): number;
+/**
+ * Convert blocks to milliseconds
+ *
+ * @param blocks - Number of blocks
+ * @returns Duration in milliseconds
+ *
+ * @example
+ * ```typescript
+ * blocksToMs(20); // 60_000 (1 minute)
+ * blocksToMs(1200); // 3_600_000 (1 hour)
+ * ```
+ */
+declare function blocksToMs(blocks: number): number;
+/**
+ * Estimate the block number at a target time
+ *
+ * @param targetTime - The target time to estimate block for
+ * @param currentBlock - The current block number
+ * @param currentTime - The current time (default: now)
+ * @returns Estimated block number at target time
+ *
+ * @example
+ * ```typescript
+ * const targetBlock = estimateBlockAtTime(
+ *   new Date(Date.now() + 3_600_000), // 1 hour from now
+ *   1000, // current block
+ * ); // ~2200
+ * ```
+ */
+declare function estimateBlockAtTime(targetTime: Date, currentBlock: number, currentTime?: Date): number;
+/**
+ * Estimate the time at a target block
+ *
+ * @param targetBlock - The target block number
+ * @param currentBlock - The current block number
+ * @param currentTime - The current time (default: now)
+ * @returns Estimated time at target block
+ *
+ * @example
+ * ```typescript
+ * const unlockTime = estimateTimeAtBlock(
+ *   2200, // target block
+ *   1000, // current block
+ * ); // ~1 hour from now
+ * ```
+ */
+declare function estimateTimeAtBlock(targetBlock: number, currentBlock: number, currentTime?: Date): Date;
+/**
+ * Calculate the number of blocks until a target time
+ *
+ * @param targetTime - The target time
+ * @param currentBlock - The current block number
+ * @param currentTime - The current time (default: now)
+ * @returns Number of blocks until target time (negative if in the past)
+ *
+ * @example
+ * ```typescript
+ * const blocksRemaining = blocksUntil(unlockTime, currentBlock);
+ * if (blocksRemaining > 0) {
+ *   console.log(`${blocksRemaining} blocks until unlock`);
+ * }
+ * ```
+ */
+declare function blocksUntil(targetTime: Date, currentBlock: number, currentTime?: Date): number;
+/**
+ * Format options for duration display
+ */
+interface FormatDurationOptions {
+  /** Whether to show short units (d, h, m, s) or long (days, hours, minutes, seconds) */
+  short?: boolean;
+  /** Maximum number of units to display (default: 2) */
+  maxUnits?: number;
+}
+/**
+ * Format a block duration as a human-readable string
+ *
+ * @param blocks - Number of blocks
+ * @param options - Formatting options
+ * @returns Human-readable duration string
+ *
+ * @example
+ * ```typescript
+ * formatBlockDuration(20); // "1 minute"
+ * formatBlockDuration(1200); // "1 hour"
+ * formatBlockDuration(BLOCKS_PER_DAY); // "1 day"
+ * formatBlockDuration(30000, { short: true }); // "1d 1h"
+ * ```
+ */
+declare function formatBlockDuration(blocks: number, options?: FormatDurationOptions): string;
+//#endregion
+export { ArithmeticError, BLOCKS_PER_DAY, BLOCKS_PER_HOUR, BLOCKS_PER_MINUTE, BLOCKS_PER_WEEK, BalanceStatus, BalancesTypesReasons, ContractEventParser, CreateD9SdkClientOptions, D9, D9Apis, D9CallData, D9Calls, D9Constants, D9DispatchError, D9Errors, D9Events, D9Extensions, D9Queries, D9SdkClientReturn, D9ViewFns, D9WhitelistEntry, D9_BLOCK_TIME_MS, D9_DECIMALS, D9_SS58_PREFIX, D9_SYMBOL, D9_TOKEN, type DecodedContractEvent, DigestItem, DispatchClass, type EventFilterOptions, type EventSubscriptionOptions, FormatBalanceOptions, FormatDurationOptions, GrandpaEquivocation, GrandpaEvent, GrandpaStoredState, type HexString, MultiAddress, Phase, type PolkadotSigner, type RawContractEvent, type SS58String, SessionEvent, Sr25519Keypair, TokenConfig, TransactionPaymentEvent, TransactionPaymentReleases, TransactionalError, USDT_DECIMALS, USDT_SYMBOL, USDT_TOKEN, WalletAccount, WhitelistEntriesByChain, WhitelistEntry, addressesEqual, blocksToMs, blocksUntil, bytesToHex, index_d_exports as contracts, createAccountFromMnemonic, createAccountFromPrivateKey, createContractEventStream, createD9SdkClient, createNativeTransferStream, createPSP22TransferStream, createSr25519SignerFromKeypair, _allDescriptors as d9, estimateBlockAtTime, estimateTimeAtBlock, formatBalance, formatBlockDuration, formatTokenAmount, generateMnemonic, getAddressPrefix, getMetadata, hexToBytes, isHexString, isValidAddress, isValidAddressForNetwork, isValidD9Address, mnemonicToMiniSecret, msToBlocks, parseAmount, sr25519AddressFromKeypair, sr25519AddressFromSecretKeyHex, sr25519DeriveFromMiniSecret, sr25519KeypairFromMiniSecret, ss58DecodePublicKey, ss58Reencode, toD9Address, toNetworkAddress, validateMnemonic };
 //# sourceMappingURL=index.d.mts.map