@etherkit/viem-tx-tracker 0.0.2 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -3
- package/dist/TrackedWalletClient.d.ts.map +1 -1
- package/dist/TrackedWalletClient.js +3 -5
- package/dist/TrackedWalletClient.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +22 -61
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/TrackedWalletClient.ts +3 -5
- package/src/index.ts +1 -11
- package/src/types.ts +18 -71
package/README.md
CHANGED
|
@@ -21,11 +21,11 @@ npm install @etherkit/tx-observer
|
|
|
21
21
|
## Quick Start
|
|
22
22
|
|
|
23
23
|
```typescript
|
|
24
|
-
import {
|
|
24
|
+
import { createTransactionObserver } from '@etherkit/tx-observer';
|
|
25
25
|
import type { OnchainOperation, BroadcastedTransaction, OnchainOperationEvent } from '@etherkit/tx-observer';
|
|
26
26
|
|
|
27
27
|
// Initialize the processor
|
|
28
|
-
const processor =
|
|
28
|
+
const processor = createTransactionObserver({
|
|
29
29
|
finality: 12, // blocks until considered final
|
|
30
30
|
throttle: 5000, // optional: throttle process() calls
|
|
31
31
|
provider: window.ethereum,
|
|
@@ -71,7 +71,7 @@ setInterval(() => processor.process(), 5000);
|
|
|
71
71
|
|
|
72
72
|
## API Reference
|
|
73
73
|
|
|
74
|
-
### `
|
|
74
|
+
### `createTransactionObserver(config)`
|
|
75
75
|
|
|
76
76
|
Creates a new operation processor instance.
|
|
77
77
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TrackedWalletClient.d.ts","sourceRoot":"","sources":["../src/TrackedWalletClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,OAAO,EAEZ,KAAK,KAAK,EAIV,KAAK,YAAY,EAGjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAMX,mBAAmB,EAGnB,MAAM,YAAY,CAAC;AA+CpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACxC,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAE1D,YAAY,EAAE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EACxD,YAAY,EAAE,YAAY,GACxB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,
|
|
1
|
+
{"version":3,"file":"TrackedWalletClient.d.ts","sourceRoot":"","sources":["../src/TrackedWalletClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,OAAO,EAEZ,KAAK,KAAK,EAIV,KAAK,YAAY,EAGjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAMX,mBAAmB,EAGnB,MAAM,YAAY,CAAC;AA+CpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACxC,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAE1D,YAAY,EAAE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EACxD,YAAY,EAAE,YAAY,GACxB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAwXnD"}
|
|
@@ -135,14 +135,12 @@ export function createTrackedWalletClient(walletClient, publicClient) {
|
|
|
135
135
|
*/
|
|
136
136
|
function createTrackedTransaction(txHash, from, nonce, metadata, request) {
|
|
137
137
|
return {
|
|
138
|
-
|
|
139
|
-
txHash,
|
|
138
|
+
hash: txHash,
|
|
140
139
|
from,
|
|
141
140
|
nonce,
|
|
142
|
-
chainId: walletClient.chain?.id
|
|
141
|
+
chainId: walletClient.chain?.id,
|
|
143
142
|
metadata: (metadata ?? {}),
|
|
144
|
-
|
|
145
|
-
request,
|
|
143
|
+
broadcastTimestampMs: Date.now(),
|
|
146
144
|
};
|
|
147
145
|
}
|
|
148
146
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TrackedWalletClient.js","sourceRoot":"","sources":["../src/TrackedWalletClient.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"TrackedWalletClient.js","sourceRoot":"","sources":["../src/TrackedWalletClient.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
export type
|
|
1
|
+
export type * from './types.js';
|
|
2
2
|
export { createTrackedWalletClient } from './TrackedWalletClient.js';
|
|
3
3
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAC;AAGhC,OAAO,EAAC,yBAAyB,EAAC,MAAM,0BAA0B,CAAC"}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,UAAU;AACV,OAAO,EAAC,yBAAyB,EAAC,MAAM,0BAA0B,CAAC"}
|
package/dist/types.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { Abi, Account,
|
|
1
|
+
import type { Abi, Account, Chain, ContractFunctionArgs, ContractFunctionName, Hash, PublicClient, SendTransactionParameters, TransactionReceipt, TransactionSerialized, Transport, WalletClient, WriteContractParameters } from 'viem';
|
|
2
2
|
/**
|
|
3
3
|
* Block tags that can be used to specify nonce fetching strategy
|
|
4
4
|
*/
|
|
@@ -10,79 +10,40 @@ export type BlockTag = 'latest' | 'pending' | 'earliest' | 'safe' | 'finalized';
|
|
|
10
10
|
* - undefined: fetch nonce using 'pending' (default)
|
|
11
11
|
*/
|
|
12
12
|
export type NonceOption = number | BlockTag;
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
}
|
|
13
|
+
export type ExpectedUpdate = {
|
|
14
|
+
address: `0x${string}`;
|
|
15
|
+
event: {
|
|
16
|
+
topics: `0x${string}`[];
|
|
17
|
+
};
|
|
18
|
+
} | {
|
|
19
|
+
address: `0x${string}`;
|
|
20
|
+
call: {
|
|
21
|
+
data: `0x${string}`;
|
|
22
|
+
result: `0x${string}`;
|
|
23
|
+
};
|
|
24
|
+
};
|
|
22
25
|
/**
|
|
23
26
|
* Metadata that can be attached to a transaction for tracking purposes.
|
|
24
27
|
* All fields are optional and extensible.
|
|
25
28
|
*/
|
|
26
29
|
export interface TransactionMetadata {
|
|
27
|
-
/**
|
|
28
|
-
* Optional custom ID - if provided, used instead of tx hash for tracking.
|
|
29
|
-
* Useful for correlating transactions with business logic (e.g., order IDs).
|
|
30
|
-
*/
|
|
31
30
|
id?: string;
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
*/
|
|
35
|
-
title?: string;
|
|
36
|
-
/**
|
|
37
|
-
* Detailed description of what the transaction does.
|
|
38
|
-
*/
|
|
31
|
+
name?: string;
|
|
32
|
+
args?: any[];
|
|
39
33
|
description?: string;
|
|
40
|
-
|
|
41
|
-
* Expected event signature/filter for success detection.
|
|
42
|
-
* Even if tx hash changes due to replacement, we can detect success by watching for this event.
|
|
43
|
-
*/
|
|
44
|
-
expectedEvent?: ExpectedEvent;
|
|
45
|
-
/**
|
|
46
|
-
* Extensible: user can add any additional fields.
|
|
47
|
-
*/
|
|
34
|
+
expectedUpdate?: ExpectedUpdate;
|
|
48
35
|
[key: string]: unknown;
|
|
49
36
|
}
|
|
50
37
|
/**
|
|
51
38
|
* A tracked transaction record with all relevant information for tracking.
|
|
52
39
|
*/
|
|
53
40
|
export interface TrackedTransaction<M extends TransactionMetadata = TransactionMetadata> {
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
*/
|
|
61
|
-
txHash: Hash;
|
|
62
|
-
/**
|
|
63
|
-
* Sender address.
|
|
64
|
-
*/
|
|
65
|
-
from: Address;
|
|
66
|
-
/**
|
|
67
|
-
* Transaction nonce (actual nonce from fetched tx, or intended if fetch failed).
|
|
68
|
-
*/
|
|
69
|
-
nonce: number;
|
|
70
|
-
/**
|
|
71
|
-
* Chain ID.
|
|
72
|
-
*/
|
|
73
|
-
chainId: number;
|
|
74
|
-
/**
|
|
75
|
-
* The full metadata provided by the caller.
|
|
76
|
-
*/
|
|
77
|
-
metadata: M;
|
|
78
|
-
/**
|
|
79
|
-
* Timestamp when the transaction was initiated (ms since epoch).
|
|
80
|
-
*/
|
|
81
|
-
initiatedAt: number;
|
|
82
|
-
/**
|
|
83
|
-
* The original transaction request data.
|
|
84
|
-
*/
|
|
85
|
-
request: unknown;
|
|
41
|
+
chainId?: number;
|
|
42
|
+
readonly hash: `0x${string}`;
|
|
43
|
+
readonly from: `0x${string}`;
|
|
44
|
+
nonce?: number;
|
|
45
|
+
readonly broadcastTimestampMs: number;
|
|
46
|
+
readonly metadata: M;
|
|
86
47
|
}
|
|
87
48
|
/**
|
|
88
49
|
* Extended WriteContractParameters with optional metadata and flexible nonce.
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,GAAG,EACH,OAAO,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -224,14 +224,12 @@ export function createTrackedWalletClient<
|
|
|
224
224
|
request: unknown,
|
|
225
225
|
): TrackedTransaction<M> {
|
|
226
226
|
return {
|
|
227
|
-
|
|
228
|
-
txHash,
|
|
227
|
+
hash: txHash,
|
|
229
228
|
from,
|
|
230
229
|
nonce,
|
|
231
|
-
chainId: walletClient.chain?.id
|
|
230
|
+
chainId: walletClient.chain?.id,
|
|
232
231
|
metadata: (metadata ?? {}) as M,
|
|
233
|
-
|
|
234
|
-
request,
|
|
232
|
+
broadcastTimestampMs: Date.now(),
|
|
235
233
|
};
|
|
236
234
|
}
|
|
237
235
|
|
package/src/index.ts
CHANGED
|
@@ -1,15 +1,5 @@
|
|
|
1
1
|
// Types
|
|
2
|
-
export type
|
|
3
|
-
BlockTag,
|
|
4
|
-
ExpectedEvent,
|
|
5
|
-
NonceOption,
|
|
6
|
-
TrackedRawTransactionParameters,
|
|
7
|
-
TrackedSendTransactionParameters,
|
|
8
|
-
TrackedTransaction,
|
|
9
|
-
TrackedWalletClient,
|
|
10
|
-
TrackedWriteContractParameters,
|
|
11
|
-
TransactionMetadata,
|
|
12
|
-
} from './types.js';
|
|
2
|
+
export type * from './types.js';
|
|
13
3
|
|
|
14
4
|
// Factory
|
|
15
5
|
export {createTrackedWalletClient} from './TrackedWalletClient.js';
|
package/src/types.ts
CHANGED
|
@@ -28,46 +28,26 @@ export type BlockTag = 'latest' | 'pending' | 'earliest' | 'safe' | 'finalized';
|
|
|
28
28
|
*/
|
|
29
29
|
export type NonceOption = number | BlockTag;
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
}
|
|
31
|
+
export type ExpectedUpdate =
|
|
32
|
+
| {
|
|
33
|
+
address: `0x${string}`;
|
|
34
|
+
event: {topics: `0x${string}`[]};
|
|
35
|
+
}
|
|
36
|
+
| {
|
|
37
|
+
address: `0x${string}`;
|
|
38
|
+
call: {data: `0x${string}`; result: `0x${string}`};
|
|
39
|
+
};
|
|
40
40
|
|
|
41
41
|
/**
|
|
42
42
|
* Metadata that can be attached to a transaction for tracking purposes.
|
|
43
43
|
* All fields are optional and extensible.
|
|
44
44
|
*/
|
|
45
45
|
export interface TransactionMetadata {
|
|
46
|
-
/**
|
|
47
|
-
* Optional custom ID - if provided, used instead of tx hash for tracking.
|
|
48
|
-
* Useful for correlating transactions with business logic (e.g., order IDs).
|
|
49
|
-
*/
|
|
50
46
|
id?: string;
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
* Human-readable title for the transaction.
|
|
54
|
-
*/
|
|
55
|
-
title?: string;
|
|
56
|
-
|
|
57
|
-
/**
|
|
58
|
-
* Detailed description of what the transaction does.
|
|
59
|
-
*/
|
|
47
|
+
name?: string;
|
|
48
|
+
args?: any[];
|
|
60
49
|
description?: string;
|
|
61
|
-
|
|
62
|
-
/**
|
|
63
|
-
* Expected event signature/filter for success detection.
|
|
64
|
-
* Even if tx hash changes due to replacement, we can detect success by watching for this event.
|
|
65
|
-
*/
|
|
66
|
-
expectedEvent?: ExpectedEvent;
|
|
67
|
-
|
|
68
|
-
/**
|
|
69
|
-
* Extensible: user can add any additional fields.
|
|
70
|
-
*/
|
|
50
|
+
expectedUpdate?: ExpectedUpdate;
|
|
71
51
|
[key: string]: unknown;
|
|
72
52
|
}
|
|
73
53
|
|
|
@@ -77,45 +57,12 @@ export interface TransactionMetadata {
|
|
|
77
57
|
export interface TrackedTransaction<
|
|
78
58
|
M extends TransactionMetadata = TransactionMetadata,
|
|
79
59
|
> {
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
* The transaction hash once known.
|
|
87
|
-
*/
|
|
88
|
-
txHash: Hash;
|
|
89
|
-
|
|
90
|
-
/**
|
|
91
|
-
* Sender address.
|
|
92
|
-
*/
|
|
93
|
-
from: Address;
|
|
94
|
-
|
|
95
|
-
/**
|
|
96
|
-
* Transaction nonce (actual nonce from fetched tx, or intended if fetch failed).
|
|
97
|
-
*/
|
|
98
|
-
nonce: number;
|
|
99
|
-
|
|
100
|
-
/**
|
|
101
|
-
* Chain ID.
|
|
102
|
-
*/
|
|
103
|
-
chainId: number;
|
|
104
|
-
|
|
105
|
-
/**
|
|
106
|
-
* The full metadata provided by the caller.
|
|
107
|
-
*/
|
|
108
|
-
metadata: M;
|
|
109
|
-
|
|
110
|
-
/**
|
|
111
|
-
* Timestamp when the transaction was initiated (ms since epoch).
|
|
112
|
-
*/
|
|
113
|
-
initiatedAt: number;
|
|
114
|
-
|
|
115
|
-
/**
|
|
116
|
-
* The original transaction request data.
|
|
117
|
-
*/
|
|
118
|
-
request: unknown;
|
|
60
|
+
chainId?: number;
|
|
61
|
+
readonly hash: `0x${string}`;
|
|
62
|
+
readonly from: `0x${string}`;
|
|
63
|
+
nonce?: number;
|
|
64
|
+
readonly broadcastTimestampMs: number;
|
|
65
|
+
readonly metadata: M;
|
|
119
66
|
}
|
|
120
67
|
|
|
121
68
|
/**
|