@d9-network/ink 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { A as RawContractCall, C as isMessageCall, D as CallFilterOptions, E as isCallType, M as TypedContractCall, O as ExtractMessageLabels, S as getSelectorForLabel, T as ContractCallParser, _ as SelectorInfo, b as getAllSelectors, g as PSP22_SELECTORS, h as PSP22SelectorKey, j as TypedCallFilterOptions, k as MessageInfo, t as index_d_exports, v as buildLabelMap, w as isPSP22Call, x as getLabelForSelector, y as buildSelectorMap } from "./index-DgYVGyHC.cjs";
 import { Binary, Enum, HexString, PolkadotClient, PolkadotSigner, SS58String } from "polkadot-api";
 import { Event, InkCallableDescriptor, InkDescriptors, InkMetadata, InkStorageDescriptor } from "@polkadot-api/ink-contracts";
 import { Observable } from "rxjs";
@@ -17,7 +18,14 @@ interface RawContractEvent {
   blockHash: string;
   /** Event index in block */
   eventIndex: number;
-  /** Contract address that emitted the event */
+  /**
+   * Extrinsic index that caused this event (if in ApplyExtrinsic phase)
+   *
+   * This is extracted from the event's `phase.value` when `phase.type === "ApplyExtrinsic"`.
+   * Useful for indexers to correlate events with their originating transactions.
+   */
+  extrinsicIndex?: number;
+  /** Contract address that emitted the event (always in D9 format) */
   contractAddress: SS58String;
   /** Event data (SCALE encoded) */
   data: Uint8Array;
@@ -302,86 +310,6 @@ declare function extractContractEmittedData(event: ChainEventRecord): {
   topics: Uint8Array[];
 } | null;
 //#endregion
-//#region src/call-types.d.ts
-/**
- * Raw call data from a transaction
- */
-interface RawContractCall {
-  /** The call data (SCALE encoded selector + args) */
-  data: Uint8Array;
-  /** Contract address being called */
-  contractAddress?: SS58String;
-  /** Transaction hash (if from a transaction) */
-  txHash?: string;
-  /** Block number (if from a transaction) */
-  blockNumber?: number;
-  /** Block hash (if from a transaction) */
-  blockHash?: string;
-}
-/**
- * Extract message labels as a union type from InkCallableDescriptor
- * e.g. ExtractMessageLabels<Messages> = "PSP22::transfer" | "PSP22::balance_of" | ...
- */
-type ExtractMessageLabels<M$1 extends InkCallableDescriptor> = keyof M$1 & string;
-/**
- * Type-safe parsed contract call with discriminated union
- * Enables type narrowing: `if (call.type === "PSP22::transfer") { call.args.to }`
- */
-type TypedContractCall<M$1 extends InkCallableDescriptor> = { [K in keyof M$1 & string]: {
-  /** Call type/method name (discriminant for type narrowing) */
-  type: K;
-  /** Decoded call arguments (type-safe based on method) */
-  args: M$1[K]["message"];
-  /** 4-byte selector */
-  selector: Uint8Array;
-  /** Original raw call data */
-  raw: RawContractCall;
-} }[keyof M$1 & string];
-/**
- * Call filter options
- */
-interface CallFilterOptions {
-  /** Message labels to include (e.g., ["PSP22::transfer", "PSP22::approve"]) */
-  messageLabels?: string[];
-}
-/**
- * Type-safe call filter options with literal message labels
- * Provides compile-time validation of message label names
- *
- * @typeParam M - The InkCallableDescriptor type (message definitions)
- *
- * @example
- * ```ts
- * const options: TypedCallFilterOptions<typeof contracts.usdt.__types.messages> = {
- *   messageLabels: ["PSP22::transfer", "PSP22::approve"], // Must be valid message names
- * };
- * ```
- */
-interface TypedCallFilterOptions<M$1 extends InkCallableDescriptor> {
-  /** Message labels to include (type-safe) */
-  messageLabels?: Array<ExtractMessageLabels<M$1>>;
-}
-/**
- * Message info from metadata
- */
-interface MessageInfo {
-  /** Message label (e.g., "PSP22::transfer") */
-  label: string;
-  /** 4-byte selector */
-  selector: Uint8Array;
-  /** Whether the message is mutable (writes state) */
-  mutates: boolean;
-  /** Whether the message is payable */
-  payable: boolean;
-  /** Argument definitions */
-  args: Array<{
-    label: string;
-    type: {
-      type: number;
-    };
-  }>;
-}
-//#endregion
 //#region src/message-builder.d.ts
 /**
  * Message attributes from metadata
@@ -1393,182 +1321,6 @@ declare function createNativeTransferStream(client: PolkadotClient, getEvents: (
   blockHash: string;
 }>;
 //#endregion
-//#region src/calls.d.ts
-/**
- * Type-safe call parser for a specific contract
- *
- * @typeParam S - The storage descriptor type
- * @typeParam M - The InkCallableDescriptor type (message definitions)
- * @typeParam C - The constructors descriptor type
- * @typeParam E - The events Enum type
- */
-declare class ContractCallParser<S extends InkStorageDescriptor = InkStorageDescriptor, M$1 extends InkCallableDescriptor = InkCallableDescriptor, C extends InkCallableDescriptor = InkCallableDescriptor, E extends Event = Event> {
-  private messageDecoders;
-  private selectorToLabel;
-  private metadata;
-  constructor(descriptor: InkDescriptors<S, M$1, C, E>);
-  /**
-   * Parse raw call data into a type-safe contract call
-   *
-   * @param callData - The raw call data (selector + encoded args) or RawContractCall
-   * @returns Parsed call or null if cannot parse
-   *
-   * @example
-   * ```ts
-   * const call = parser.parseCall(callData);
-   * if (call?.type === "PSP22::transfer") {
-   *   // call.args is typed as { to: SS58String; value: bigint; data: Uint8Array }
-   *   console.log(call.args.to);
-   * }
-   * ```
-   */
-  parseCall(callData: Uint8Array | RawContractCall): TypedContractCall<M$1> | null;
-  /**
-   * Parse multiple calls and optionally filter by message labels
-   *
-   * @param calls - Array of raw call data
-   * @param options - Filter options
-   * @returns Array of parsed calls
-   */
-  parseCalls(calls: Array<Uint8Array | RawContractCall>, options?: CallFilterOptions): TypedContractCall<M$1>[];
-  /**
-   * Filter calls by specific type with proper type narrowing
-   *
-   * This method provides better type safety than parseCalls with messageLabels
-   * because TypeScript can narrow the return type to only the specified call type.
-   *
-   * @param calls - Array of raw call data
-   * @param label - The message label to filter by
-   * @returns Array of calls narrowed to the specific type
-   *
-   * @example
-   * ```ts
-   * const transfers = parser.filterByType(callDataArray, "PSP22::transfer");
-   *
-   * for (const t of transfers) {
-   *   // t.args is fully typed as PSP22::transfer args
-   *   console.log(t.args.to, t.args.value);
-   * }
-   * ```
-   */
-  filterByType<L extends string>(calls: Array<Uint8Array | RawContractCall>, label: L): Array<TypedContractCall<M$1> & {
-    type: L;
-  }>;
-  /**
-   * Get information about a message by label
-   */
-  getMessageInfo(label: string): MessageInfo | null;
-  /**
-   * Get all available message labels
-   */
-  getMessageLabels(): string[];
-  /**
-   * Check if a selector matches a specific message
-   */
-  matchesMessage(selector: Uint8Array, label: string): boolean;
-  /**
-   * Get selector for a message label
-   *
-   * @param label - Message label (e.g., "PSP22::transfer")
-   * @returns Selector as Uint8Array or null if not found
-   *
-   * @example
-   * ```ts
-   * const selector = parser.getSelector("PSP22::transfer");
-   * // selector is Uint8Array([0xdb, 0x20, 0xf9, 0xf5])
-   * ```
-   */
-  getSelector(label: string): Uint8Array | null;
-  /**
-   * Get selector as hex string for a message label
-   *
-   * @param label - Message label (e.g., "PSP22::transfer")
-   * @returns Selector hex string (without 0x) or null if not found
-   *
-   * @example
-   * ```ts
-   * const selectorHex = parser.getSelectorHex("PSP22::transfer");
-   * // selectorHex is "db20f9f5"
-   * ```
-   */
-  getSelectorHex(label: string): string | null;
-  /**
-   * Get the label for a selector
-   *
-   * @param selector - Selector as Uint8Array or hex string (with or without 0x)
-   * @returns Message label or null if not found
-   *
-   * @example
-   * ```ts
-   * const label = parser.getLabel("db20f9f5");
-   * // label is "PSP22::transfer"
-   *
-   * // Also works with Uint8Array
-   * const label2 = parser.getLabel(callData.slice(0, 4));
-   * ```
-   */
-  getLabel(selector: Uint8Array | string): string | null;
-  /**
-   * Get all selector-to-label mappings
-   *
-   * @returns Map of selector hex (without 0x) -> label
-   *
-   * @example
-   * ```ts
-   * const map = parser.getSelectorMap();
-   * for (const [selectorHex, label] of map) {
-   *   console.log(`${selectorHex} -> ${label}`);
-   * }
-   * ```
-   */
-  getSelectorMap(): Map<string, string>;
-  /**
-   * Check if a selector exists in this contract
-   *
-   * @param selector - Selector to check (Uint8Array or hex string)
-   * @returns True if selector is valid for this contract
-   *
-   * @example
-   * ```ts
-   * if (parser.hasSelector("db20f9f5")) {
-   *   // This selector is valid for this contract
-   * }
-   * ```
-   */
-  hasSelector(selector: Uint8Array | string): boolean;
-  /**
-   * Normalize selector to hex string (without 0x prefix)
-   */
-  private normalizeSelector;
-}
-/**
- * Type guard for narrowing call types
- *
- * Use this function when you have a `TypedContractCall` and need to
- * narrow it to a specific call type. This is useful when the type
- * information is lost (e.g., after serialization or in generic functions).
- *
- * @typeParam M - The InkCallableDescriptor type (message definitions)
- * @typeParam L - The specific message label to check
- * @param call - The call to check
- * @param label - The message label to match
- * @returns True if the call type matches the label
- *
- * @example
- * ```ts
- * const call = parser.parseCall(callData);
- *
- * if (call && isCallType(call, "PSP22::transfer")) {
- *   // TypeScript knows call.args is transfer args
- *   console.log(call.args.to);
- *   console.log(call.args.value);
- * }
- * ```
- */
-declare function isCallType<M$1 extends InkCallableDescriptor, L extends ExtractMessageLabels<M$1>>(call: TypedContractCall<M$1>, label: L): call is Extract<TypedContractCall<M$1>, {
-  type: L;
-}>;
-//#endregion
 //#region src/infer-types.d.ts
 /**
  * Infer ContractCallParser type from a contract descriptor
@@ -1637,163 +1389,6 @@ type ContractEventParserOf<D> = D extends InkDescriptors<infer S, infer M, infer
  */
 type D9InkContractOf<D> = D extends InkDescriptors<infer _S, infer M, infer _C, infer E> ? D9InkContract<M extends InkCallableDescriptor ? M : InkCallableDescriptor, E extends Event ? E : Event> : never;
 //#endregion
-//#region src/selectors.d.ts
-/**
- * Information about a contract message selector
- */
-interface SelectorInfo {
-  /** Message label (e.g., "PSP22::transfer") */
-  label: string;
-  /** 4-byte selector */
-  selector: Uint8Array;
-  /** Hex string without 0x prefix (e.g., "db20f9f5") */
-  selectorHex: string;
-  /** Whether the message mutates state */
-  mutates: boolean;
-  /** Whether the message is payable */
-  payable: boolean;
-}
-/**
- * PSP22 standard selectors for quick reference
- *
- * These are derived from the PSP22 standard and are consistent across implementations.
- * Use these when you need to quickly check if call data matches a specific PSP22 method.
- *
- * @example
- * ```ts
- * import { PSP22_SELECTORS, extractSelectorHex } from "@d9-network/ink";
- *
- * const selectorHex = extractSelectorHex(callData);
- * if (selectorHex === PSP22_SELECTORS.transfer) {
- *   // This is a PSP22::transfer call
- * }
- * ```
- */
-declare const PSP22_SELECTORS: {
-  /** PSP22::total_supply - 0x162df8c2 */
-  readonly totalSupply: "162df8c2";
-  /** PSP22::balance_of - 0x6568382f */
-  readonly balanceOf: "6568382f";
-  /** PSP22::allowance - 0x4d47d921 */
-  readonly allowance: "4d47d921";
-  /** PSP22::transfer - 0xdb20f9f5 */
-  readonly transfer: "db20f9f5";
-  /** PSP22::transfer_from - 0x54b3c76e */
-  readonly transferFrom: "54b3c76e";
-  /** PSP22::approve - 0xb20f1bbd */
-  readonly approve: "b20f1bbd";
-  /** PSP22::increase_allowance - 0x96d6b57a */
-  readonly increaseAllowance: "96d6b57a";
-  /** PSP22::decrease_allowance - 0xfecb57d5 */
-  readonly decreaseAllowance: "fecb57d5";
-};
-/**
- * PSP22 selector type for type safety
- */
-type PSP22SelectorKey = keyof typeof PSP22_SELECTORS;
-/**
- * Build a selector lookup map from contract metadata
- *
- * @param metadata - Contract metadata
- * @returns Map of selector hex (without 0x) -> SelectorInfo
- *
- * @example
- * ```ts
- * import { contracts } from "@d9-network/spec";
- * import { buildSelectorMap } from "@d9-network/ink";
- *
- * const selectors = buildSelectorMap(contracts.usdt.metadata);
- * const info = selectors.get("db20f9f5");
- * if (info) {
- *   console.log(info.label); // "PSP22::transfer"
- * }
- * ```
- */
-declare function buildSelectorMap(metadata: InkMetadata): Map<string, SelectorInfo>;
-/**
- * Build a reverse lookup map (label -> selector info)
- *
- * @param metadata - Contract metadata
- * @returns Map of label -> SelectorInfo
- *
- * @example
- * ```ts
- * const labelMap = buildLabelMap(contracts.usdt.metadata);
- * const info = labelMap.get("PSP22::transfer");
- * console.log(info?.selectorHex); // "db20f9f5"
- * ```
- */
-declare function buildLabelMap(metadata: InkMetadata): Map<string, SelectorInfo>;
-/**
- * Get selector for a message label
- *
- * @param metadata - Contract metadata
- * @param label - Message label (e.g., "PSP22::transfer")
- * @returns Selector info or null if not found
- *
- * @example
- * ```ts
- * const info = getSelectorForLabel(contracts.usdt.metadata, "PSP22::transfer");
- * console.log(info?.selectorHex); // "db20f9f5"
- * ```
- */
-declare function getSelectorForLabel(metadata: InkMetadata, label: string): SelectorInfo | null;
-/**
- * Get message label for a selector
- *
- * @param metadata - Contract metadata
- * @param selector - Selector as Uint8Array or hex string (with or without 0x)
- * @returns Selector info or null if not found
- *
- * @example
- * ```ts
- * const info = getLabelForSelector(contracts.usdt.metadata, "db20f9f5");
- * console.log(info?.label); // "PSP22::transfer"
- *
- * // Also works with Uint8Array
- * const info2 = getLabelForSelector(contracts.usdt.metadata, callData.slice(0, 4));
- * ```
- */
-declare function getLabelForSelector(metadata: InkMetadata, selector: Uint8Array | string): SelectorInfo | null;
-/**
- * Check if call data matches a specific message
- *
- * @param metadata - Contract metadata
- * @param callData - Call data bytes or hex string
- * @param label - Message label to check
- * @returns True if the call data selector matches the label
- *
- * @example
- * ```ts
- * if (isMessageCall(contracts.usdt.metadata, callData, "PSP22::transfer")) {
- *   // This is a transfer call
- * }
- * ```
- */
-declare function isMessageCall(metadata: InkMetadata, callData: Uint8Array | string, label: string): boolean;
-/**
- * Check if call data matches a PSP22 method
- *
- * @param callData - Call data bytes or hex string
- * @param method - PSP22 method name (e.g., "transfer", "transferFrom")
- * @returns True if the call data selector matches the PSP22 method
- *
- * @example
- * ```ts
- * if (isPSP22Call(callData, "transfer")) {
- *   // This is a PSP22::transfer call
- * }
- * ```
- */
-declare function isPSP22Call(callData: Uint8Array | string, method: PSP22SelectorKey): boolean;
-/**
- * Get all selectors from contract metadata
- *
- * @param metadata - Contract metadata
- * @returns Array of SelectorInfo for all messages
- */
-declare function getAllSelectors(metadata: InkMetadata): SelectorInfo[];
-//#endregion
 //#region src/extrinsic-parser.d.ts
 /**
  * Raw extrinsic data that may contain a contract call
@@ -2128,5 +1723,5 @@ declare function compareGasWeight(a: GasWeight, b: GasWeight): -1 | 0 | 1;
  */
 declare function gasExceedsLimit(gas: GasWeight, limit: GasWeight): boolean;
 //#endregion
-export { AbortedError, type BalancesTransferChainEvent, type BlockHeader, type CallFilterOptions, type ChainEventRecord, ContractCallParser, type ContractCallParserOf, type ContractCallResult, type ContractCalledChainEvent, type ContractCalledValue, type ContractEmittedChainEvent, type ContractEmittedValue, ContractError, type ContractErrorType, ContractEventParser, type ContractEventParserOf, ContractExecutionError, type ContractMessageBuilder, type ContractStorage, type ContractsCallValue, type CreateContractOptions, type CreateD9InkSdkOptions, type D9InkContract, type D9InkContractFromDescriptor, type D9InkContractOf, type D9InkSdk, type D9InkSdkOptions, type D9InkSdkWithRpc, DecodeError, type DecodedContractEvent, EncodeError, EstimatedCost, type EventFilterOptions, type EventSubscriptionOptions, type ExtractEnumDef, type ExtractEventLabels, type ExtractMessageLabels, type ExtrinsicCall, ExtrinsicParser, type ExtrinsicParserOptions, FormattedGasInfo, type GasInfo, GasWeight, type InferEvents, type InferMessages, InkCodecs, LangError, type MessageAttributes, type MessageInfo, MetadataError, NetworkError, type PSP22SelectorKey, PSP22_SELECTORS, type ParsedContractExtrinsic, type QueryOptions, type QueryResult, type QuerySuccessValue, type RawContractCall, type RawContractEvent, type RawExtrinsic, type ResponseDecoder, type RuntimeVersion, type SelectorInfo, type SendOptions, type SendableTransaction, SignerError, type StorageChangeSet, type StorageDepositInfo, type SubstrateRpcMethods, type SystemHealth, TimeoutError, TransactionError, type TxResult, type TypedCallFilterOptions, type TypedContractCall, type TypedContractEvent, type TypedEventFilterOptions, type TypedMessage, type TypedRpc, applyGasMargin, buildAllEventDecoders, buildAllMessageDecoders, buildEventDecoder, buildLabelMap, buildMessageDecoder, buildSelectorMap, compareGasWeight, createAsciiEventTopic, createCodecRegistry, createContractEventStream, createD9InkContract, createD9InkSdk, createExtrinsicParser, createMessageBuilder, createNativeTransferStream, createPSP22TransferStream, createTypedRpc, decodeContractCallResult, decodeInkValue, encodeCall, encodeContractCall, encodeContractCallWithLimits, estimateTransactionCost, extractContractEmittedData, formatGasInfo, gasExceedsLimit, getAllSelectors, getEventSignature, getLabelForSelector, getSelectorForLabel, isApplyExtrinsicPhase, isBalancesTransferEvent, isCallType, isContractCalledEvent, isContractEmittedEvent, isContractError, isErrorType, isEventType, isLangError, isMessageCall, isPSP22Call, unwrapInkResult };
+export { AbortedError, type BalancesTransferChainEvent, type BlockHeader, type CallFilterOptions, type ChainEventRecord, ContractCallParser, type ContractCallParserOf, type ContractCallResult, type ContractCalledChainEvent, type ContractCalledValue, type ContractEmittedChainEvent, type ContractEmittedValue, ContractError, type ContractErrorType, ContractEventParser, type ContractEventParserOf, ContractExecutionError, type ContractMessageBuilder, type ContractStorage, type ContractsCallValue, type CreateContractOptions, type CreateD9InkSdkOptions, type D9InkContract, type D9InkContractFromDescriptor, type D9InkContractOf, type D9InkSdk, type D9InkSdkOptions, type D9InkSdkWithRpc, DecodeError, type DecodedContractEvent, EncodeError, EstimatedCost, type EventFilterOptions, type EventSubscriptionOptions, type ExtractEnumDef, type ExtractEventLabels, type ExtractMessageLabels, type ExtrinsicCall, ExtrinsicParser, type ExtrinsicParserOptions, FormattedGasInfo, type GasInfo, GasWeight, type InferEvents, type InferMessages, InkCodecs, LangError, type MessageAttributes, type MessageInfo, MetadataError, NetworkError, type PSP22SelectorKey, PSP22_SELECTORS, type ParsedContractExtrinsic, type QueryOptions, type QueryResult, type QuerySuccessValue, type RawContractCall, type RawContractEvent, type RawExtrinsic, type ResponseDecoder, type RuntimeVersion, type SelectorInfo, type SendOptions, type SendableTransaction, SignerError, type StorageChangeSet, type StorageDepositInfo, type SubstrateRpcMethods, type SystemHealth, TimeoutError, TransactionError, type TxResult, type TypedCallFilterOptions, type TypedContractCall, type TypedContractEvent, type TypedEventFilterOptions, type TypedMessage, type TypedRpc, applyGasMargin, buildAllEventDecoders, buildAllMessageDecoders, buildEventDecoder, buildLabelMap, buildMessageDecoder, buildSelectorMap, compareGasWeight, createAsciiEventTopic, createCodecRegistry, createContractEventStream, createD9InkContract, createD9InkSdk, createExtrinsicParser, createMessageBuilder, createNativeTransferStream, createPSP22TransferStream, createTypedRpc, decodeContractCallResult, decodeInkValue, encodeCall, encodeContractCall, encodeContractCallWithLimits, estimateTransactionCost, extractContractEmittedData, formatGasInfo, gasExceedsLimit, getAllSelectors, getEventSignature, getLabelForSelector, getSelectorForLabel, index_d_exports as indexer, isApplyExtrinsicPhase, isBalancesTransferEvent, isCallType, isContractCalledEvent, isContractEmittedEvent, isContractError, isErrorType, isEventType, isLangError, isMessageCall, isPSP22Call, unwrapInkResult };
 //# sourceMappingURL=index.d.cts.map