@d9-network/ink 1.0.2 → 1.1.0

package/README.md

@@ -44,6 +44,9 @@ if (result.success) {
 - **AccountId with D9 prefix**: All addresses automatically use D9 SS58 prefix (9)
 - **Event parsing**: Type-safe decoding of contract events
 - **Comprehensive error handling**: Detailed error types for debugging
+- **PSP22 selector constants**: Pre-defined selectors for PSP22 token standard
+- **Type inference utilities**: Declare typed properties without instantiation
+- **Extrinsic parser**: High-level API for indexers to parse contract calls
 
 ## API Overview
 
@@ -71,6 +74,99 @@ if (result.success) {
 | `LangError`     | ink! language error   |
 | `NetworkError`  | RPC/WebSocket error   |
 
+### Type Inference Utilities
+
+Use these to declare typed properties without manual generic parameters:
+
+```typescript
+import { contracts } from "@d9-network/spec";
+import type { ContractCallParserOf, ContractEventParserOf } from "@d9-network/ink";
+
+class MyIndexer {
+  // Fully typed without specifying generics!
+  private callParser: ContractCallParserOf<typeof contracts.usdt>;
+  private eventParser: ContractEventParserOf<typeof contracts.usdt>;
+}
+```
+
+| Export                 | Description                               |
+| ---------------------- | ----------------------------------------- |
+| `ContractCallParserOf` | Infer ContractCallParser type from descriptor |
+| `ContractEventParserOf`| Infer ContractEventParser type from descriptor |
+| `D9InkContractOf`      | Infer D9InkContract type from descriptor |
+
+### Selector Utilities
+
+```typescript
+import { PSP22_SELECTORS, isPSP22Call, extractSelectorHex } from "@d9-network/ink";
+
+// Check if call data is a PSP22 transfer
+if (isPSP22Call(callData, "transfer")) {
+  console.log("This is a transfer!");
+}
+
+// Or compare selectors directly
+const selector = extractSelectorHex(callData);
+if (selector === PSP22_SELECTORS.transfer) {
+  console.log("Transfer detected");
+}
+```
+
+| Export               | Description                              |
+| -------------------- | ---------------------------------------- |
+| `PSP22_SELECTORS`    | Pre-defined PSP22 selectors              |
+| `isPSP22Call`        | Check if call matches PSP22 method       |
+| `getSelectorForLabel`| Get selector for a message label         |
+| `getLabelForSelector`| Get message label for a selector         |
+| `buildSelectorMap`   | Build selector lookup map from metadata  |
+
+### Extrinsic Parser (for Indexers)
+
+High-level API for parsing contract calls from blockchain extrinsics:
+
+```typescript
+import { ExtrinsicParser } from "@d9-network/ink";
+import { contracts } from "@d9-network/spec";
+
+const parser = new ExtrinsicParser(contracts.usdt, {
+  contractAddresses: [USDT_ADDRESS],
+});
+
+// Parse extrinsics from a block
+for (const extrinsic of block.extrinsics) {
+  const parsed = parser.parseExtrinsic(extrinsic);
+  if (parsed?.call.type === "PSP22::transfer") {
+    // Fully typed args!
+    console.log(`Transfer: ${parsed.call.args.value} to ${parsed.call.args.to}`);
+  }
+}
+```
+
+### Chain Event Type Guards
+
+Eliminate `as any` casts when handling chain events:
+
+```typescript
+import { isContractCalledEvent, isContractEmittedEvent, type ChainEventRecord } from "@d9-network/ink";
+
+const events: ChainEventRecord[] = await api.query.System.Events.getValue();
+
+for (const event of events) {
+  if (isContractCalledEvent(event)) {
+    // event.event.value.value is properly typed!
+    const { caller, contract } = event.event.value.value;
+  }
+}
+```
+
+| Export                    | Description                        |
+| ------------------------- | ---------------------------------- |
+| `ChainEventRecord`        | Typed chain event structure        |
+| `isContractEmittedEvent`  | Type guard for ContractEmitted     |
+| `isContractCalledEvent`   | Type guard for Contracts.Called    |
+| `isBalancesTransferEvent` | Type guard for Balances.Transfer   |
+| `isApplyExtrinsicPhase`   | Check if event is in ApplyExtrinsic phase |
+
 ## Documentation
 
 For complete documentation, examples, and API reference, visit: