tempo.ts 0.1.2 → 0.1.4
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/dist/chains.d.ts +1180 -0
- package/dist/chains.d.ts.map +1 -0
- package/dist/chains.js +30 -0
- package/dist/chains.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -0
- package/dist/internal/types.d.ts +284 -0
- package/dist/internal/types.d.ts.map +1 -0
- package/dist/internal/types.js +2 -0
- package/dist/internal/types.js.map +1 -0
- package/dist/ox/SignatureEnvelope.d.ts +245 -0
- package/dist/ox/SignatureEnvelope.d.ts.map +1 -0
- package/dist/ox/SignatureEnvelope.js +437 -0
- package/dist/ox/SignatureEnvelope.js.map +1 -0
- package/dist/ox/TokenId.d.ts +25 -0
- package/dist/ox/TokenId.d.ts.map +1 -0
- package/dist/ox/TokenId.js +41 -0
- package/dist/ox/TokenId.js.map +1 -0
- package/dist/ox/TokenRole.d.ts +11 -0
- package/dist/ox/TokenRole.d.ts.map +1 -0
- package/dist/ox/TokenRole.js +22 -0
- package/dist/ox/TokenRole.js.map +1 -0
- package/dist/ox/Transaction.d.ts +198 -0
- package/dist/ox/Transaction.d.ts.map +1 -0
- package/dist/ox/Transaction.js +162 -0
- package/dist/ox/Transaction.js.map +1 -0
- package/dist/ox/TransactionEnvelopeAA.d.ts +461 -0
- package/dist/ox/TransactionEnvelopeAA.d.ts.map +1 -0
- package/dist/ox/TransactionEnvelopeAA.js +528 -0
- package/dist/ox/TransactionEnvelopeAA.js.map +1 -0
- package/dist/ox/TransactionRequest.d.ts +64 -0
- package/dist/ox/TransactionRequest.d.ts.map +1 -0
- package/dist/ox/TransactionRequest.js +75 -0
- package/dist/ox/TransactionRequest.js.map +1 -0
- package/dist/ox/index.d.ts +6 -0
- package/dist/ox/index.d.ts.map +1 -0
- package/dist/ox/index.js +6 -0
- package/dist/ox/index.js.map +1 -0
- package/dist/prool/Instance.d.ts +88 -0
- package/dist/prool/Instance.d.ts.map +1 -0
- package/dist/prool/Instance.js +96 -0
- package/dist/prool/Instance.js.map +1 -0
- package/dist/prool/index.d.ts +2 -0
- package/dist/prool/index.d.ts.map +1 -0
- package/dist/prool/index.js +2 -0
- package/dist/prool/index.js.map +1 -0
- package/dist/viem/Abis.d.ts +1885 -0
- package/dist/viem/Abis.d.ts.map +1 -0
- package/dist/viem/Abis.js +1174 -0
- package/dist/viem/Abis.js.map +1 -0
- package/dist/viem/Actions/amm.d.ts +2006 -0
- package/dist/viem/Actions/amm.d.ts.map +1 -0
- package/dist/viem/Actions/amm.js +900 -0
- package/dist/viem/Actions/amm.js.map +1 -0
- package/dist/viem/Actions/dex.d.ts +3279 -0
- package/dist/viem/Actions/dex.d.ts.map +1 -0
- package/dist/viem/Actions/dex.js +1357 -0
- package/dist/viem/Actions/dex.js.map +1 -0
- package/dist/viem/Actions/fee.d.ts +374 -0
- package/dist/viem/Actions/fee.d.ts.map +1 -0
- package/dist/viem/Actions/fee.js +235 -0
- package/dist/viem/Actions/fee.js.map +1 -0
- package/dist/viem/Actions/index.d.ts +6 -0
- package/dist/viem/Actions/index.d.ts.map +1 -0
- package/dist/viem/Actions/index.js +6 -0
- package/dist/viem/Actions/index.js.map +1 -0
- package/dist/viem/Actions/policy.d.ts +1672 -0
- package/dist/viem/Actions/policy.d.ts.map +1 -0
- package/dist/viem/Actions/policy.js +875 -0
- package/dist/viem/Actions/policy.js.map +1 -0
- package/dist/viem/Actions/token.d.ts +13714 -0
- package/dist/viem/Actions/token.d.ts.map +1 -0
- package/dist/viem/Actions/token.js +3058 -0
- package/dist/viem/Actions/token.js.map +1 -0
- package/dist/viem/Addresses.d.ts +9 -0
- package/dist/viem/Addresses.d.ts.map +1 -0
- package/dist/viem/Addresses.js +9 -0
- package/dist/viem/Addresses.js.map +1 -0
- package/dist/viem/Chain.d.ts +365 -0
- package/dist/viem/Chain.d.ts.map +1 -0
- package/dist/viem/Chain.js +22 -0
- package/dist/viem/Chain.js.map +1 -0
- package/dist/viem/Client.d.ts +27 -0
- package/dist/viem/Client.d.ts.map +1 -0
- package/dist/viem/Client.js +28 -0
- package/dist/viem/Client.js.map +1 -0
- package/dist/viem/Decorator.d.ts +2161 -0
- package/dist/viem/Decorator.d.ts.map +1 -0
- package/dist/viem/Decorator.js +122 -0
- package/dist/viem/Decorator.js.map +1 -0
- package/dist/viem/Formatters.d.ts +4 -0
- package/dist/viem/Formatters.d.ts.map +1 -0
- package/dist/viem/Formatters.js +76 -0
- package/dist/viem/Formatters.js.map +1 -0
- package/dist/viem/Tick.d.ts +111 -0
- package/dist/viem/Tick.d.ts.map +1 -0
- package/dist/viem/Tick.js +127 -0
- package/dist/viem/Tick.js.map +1 -0
- package/dist/viem/TokenIds.d.ts +3 -0
- package/dist/viem/TokenIds.d.ts.map +1 -0
- package/dist/viem/TokenIds.js +3 -0
- package/dist/viem/TokenIds.js.map +1 -0
- package/dist/viem/Transaction.d.ts +57 -0
- package/dist/viem/Transaction.d.ts.map +1 -0
- package/dist/viem/Transaction.js +137 -0
- package/dist/viem/Transaction.js.map +1 -0
- package/dist/viem/Transport.d.ts +16 -0
- package/dist/viem/Transport.d.ts.map +1 -0
- package/dist/viem/Transport.js +33 -0
- package/dist/viem/Transport.js.map +1 -0
- package/dist/viem/index.d.ts +14 -0
- package/dist/viem/index.d.ts.map +1 -0
- package/dist/viem/index.js +14 -0
- package/dist/viem/index.js.map +1 -0
- package/dist/viem/internal/types.d.ts +10 -0
- package/dist/viem/internal/types.d.ts.map +1 -0
- package/dist/viem/internal/types.js +2 -0
- package/dist/viem/internal/types.js.map +1 -0
- package/dist/viem/internal/utils.d.ts +8 -0
- package/dist/viem/internal/utils.d.ts.map +1 -0
- package/dist/viem/internal/utils.js +9 -0
- package/dist/viem/internal/utils.js.map +1 -0
- package/package.json +2 -2
- package/src/viem/index.ts +4 -1
|
@@ -0,0 +1,528 @@
|
|
|
1
|
+
import * as AccessList from 'ox/AccessList';
|
|
2
|
+
import * as Address from 'ox/Address';
|
|
3
|
+
import * as Errors from 'ox/Errors';
|
|
4
|
+
import * as Hash from 'ox/Hash';
|
|
5
|
+
import * as Hex from 'ox/Hex';
|
|
6
|
+
import * as Rlp from 'ox/Rlp';
|
|
7
|
+
import * as Signature from 'ox/Signature';
|
|
8
|
+
import * as TransactionEnvelope from 'ox/TransactionEnvelope';
|
|
9
|
+
import * as SignatureEnvelope from './SignatureEnvelope.js';
|
|
10
|
+
import * as TokenId from './TokenId.js';
|
|
11
|
+
export const feePayerMagic = '0x78';
|
|
12
|
+
export const serializedType = '0x76';
|
|
13
|
+
export const type = 'aa';
|
|
14
|
+
/**
|
|
15
|
+
* Asserts a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA} is valid.
|
|
16
|
+
*
|
|
17
|
+
* @example
|
|
18
|
+
* ```ts twoslash
|
|
19
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
20
|
+
*
|
|
21
|
+
* TransactionEnvelopeAA.assert({
|
|
22
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000', value: 0n }],
|
|
23
|
+
* chainId: 1,
|
|
24
|
+
* maxFeePerGas: 1000000000n,
|
|
25
|
+
* })
|
|
26
|
+
* ```
|
|
27
|
+
*
|
|
28
|
+
* @param envelope - The transaction envelope to assert.
|
|
29
|
+
*/
|
|
30
|
+
export function assert(envelope) {
|
|
31
|
+
const { calls, chainId, maxFeePerGas, maxPriorityFeePerGas, validBefore, validAfter, } = envelope;
|
|
32
|
+
// Calls must not be empty
|
|
33
|
+
if (!calls || calls.length === 0)
|
|
34
|
+
throw new CallsEmptyError();
|
|
35
|
+
// validBefore must be greater than validAfter if both are set
|
|
36
|
+
if (typeof validBefore === 'number' &&
|
|
37
|
+
typeof validAfter === 'number' &&
|
|
38
|
+
validBefore <= validAfter) {
|
|
39
|
+
throw new InvalidValidityWindowError({
|
|
40
|
+
validBefore: validBefore,
|
|
41
|
+
validAfter: validAfter,
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
// Validate each call
|
|
45
|
+
if (calls)
|
|
46
|
+
for (const call of calls)
|
|
47
|
+
if (call.to)
|
|
48
|
+
Address.assert(call.to, { strict: false });
|
|
49
|
+
// Validate chain ID
|
|
50
|
+
if (chainId <= 0)
|
|
51
|
+
throw new TransactionEnvelope.InvalidChainIdError({ chainId });
|
|
52
|
+
// Validate max fee per gas
|
|
53
|
+
if (maxFeePerGas && BigInt(maxFeePerGas) > 2n ** 256n - 1n)
|
|
54
|
+
throw new TransactionEnvelope.FeeCapTooHighError({
|
|
55
|
+
feeCap: maxFeePerGas,
|
|
56
|
+
});
|
|
57
|
+
if (maxPriorityFeePerGas &&
|
|
58
|
+
maxFeePerGas &&
|
|
59
|
+
maxPriorityFeePerGas > maxFeePerGas)
|
|
60
|
+
throw new TransactionEnvelope.TipAboveFeeCapError({
|
|
61
|
+
maxFeePerGas,
|
|
62
|
+
maxPriorityFeePerGas,
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Deserializes a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA} from its serialized form.
|
|
67
|
+
*
|
|
68
|
+
* @example
|
|
69
|
+
* ```ts twoslash
|
|
70
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
71
|
+
*
|
|
72
|
+
* const envelope = TransactionEnvelopeAA.deserialize('0x76f84a0182031184773594008477359400809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c0808080')
|
|
73
|
+
* // @log: {
|
|
74
|
+
* // @log: type: 'aa',
|
|
75
|
+
* // @log: nonce: 785n,
|
|
76
|
+
* // @log: maxFeePerGas: 2000000000n,
|
|
77
|
+
* // @log: gas: 1000000n,
|
|
78
|
+
* // @log: calls: [{ to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8', value: 1000000000000000000n }],
|
|
79
|
+
* // @log: }
|
|
80
|
+
* ```
|
|
81
|
+
*
|
|
82
|
+
* @param serialized - The serialized transaction.
|
|
83
|
+
* @returns Deserialized Transaction Envelope.
|
|
84
|
+
*/
|
|
85
|
+
export function deserialize(serialized) {
|
|
86
|
+
const transactionArray = Rlp.toHex(Hex.slice(serialized, 1));
|
|
87
|
+
const [chainId, maxPriorityFeePerGas, maxFeePerGas, gas, calls, accessList, nonceKey, nonce, validBefore, validAfter, feeToken, feePayerSignatureOrSender, signature,] = transactionArray;
|
|
88
|
+
if (!(transactionArray.length === 12 || transactionArray.length === 13))
|
|
89
|
+
throw new TransactionEnvelope.InvalidSerializedError({
|
|
90
|
+
attributes: {
|
|
91
|
+
chainId,
|
|
92
|
+
maxPriorityFeePerGas,
|
|
93
|
+
maxFeePerGas,
|
|
94
|
+
gas,
|
|
95
|
+
calls,
|
|
96
|
+
accessList,
|
|
97
|
+
nonceKey,
|
|
98
|
+
nonce,
|
|
99
|
+
validBefore,
|
|
100
|
+
validAfter,
|
|
101
|
+
feeToken,
|
|
102
|
+
feePayerSignatureOrSender,
|
|
103
|
+
...(transactionArray.length > 12
|
|
104
|
+
? {
|
|
105
|
+
signature,
|
|
106
|
+
}
|
|
107
|
+
: {}),
|
|
108
|
+
},
|
|
109
|
+
serialized,
|
|
110
|
+
type,
|
|
111
|
+
});
|
|
112
|
+
let transaction = {
|
|
113
|
+
chainId: Number(chainId),
|
|
114
|
+
type,
|
|
115
|
+
};
|
|
116
|
+
if (Hex.validate(gas) && gas !== '0x')
|
|
117
|
+
transaction.gas = BigInt(gas);
|
|
118
|
+
if (Hex.validate(nonce))
|
|
119
|
+
transaction.nonce = nonce === '0x' ? 0n : BigInt(nonce);
|
|
120
|
+
if (Hex.validate(maxFeePerGas) && maxFeePerGas !== '0x')
|
|
121
|
+
transaction.maxFeePerGas = BigInt(maxFeePerGas);
|
|
122
|
+
if (Hex.validate(maxPriorityFeePerGas) && maxPriorityFeePerGas !== '0x')
|
|
123
|
+
transaction.maxPriorityFeePerGas = BigInt(maxPriorityFeePerGas);
|
|
124
|
+
if (Hex.validate(nonceKey))
|
|
125
|
+
transaction.nonceKey = nonceKey === '0x' ? 0n : BigInt(nonceKey);
|
|
126
|
+
if (Hex.validate(validBefore) && validBefore !== '0x')
|
|
127
|
+
transaction.validBefore = Number(validBefore);
|
|
128
|
+
if (Hex.validate(validAfter) && validAfter !== '0x')
|
|
129
|
+
transaction.validAfter = Number(validAfter);
|
|
130
|
+
if (Hex.validate(feeToken) && feeToken !== '0x')
|
|
131
|
+
transaction.feeToken = feeToken;
|
|
132
|
+
// Parse calls array
|
|
133
|
+
if (calls && calls !== '0x') {
|
|
134
|
+
const callsArray = calls;
|
|
135
|
+
transaction.calls = callsArray.map((callTuple) => {
|
|
136
|
+
const [to, value, data] = callTuple;
|
|
137
|
+
const call = {};
|
|
138
|
+
if (to && to !== '0x')
|
|
139
|
+
call.to = to;
|
|
140
|
+
if (value && value !== '0x')
|
|
141
|
+
call.value = BigInt(value);
|
|
142
|
+
if (data && data !== '0x')
|
|
143
|
+
call.data = data;
|
|
144
|
+
return call;
|
|
145
|
+
});
|
|
146
|
+
}
|
|
147
|
+
if (accessList?.length !== 0 && accessList !== '0x')
|
|
148
|
+
transaction.accessList = AccessList.fromTupleList(accessList);
|
|
149
|
+
if (feePayerSignatureOrSender !== '0x' &&
|
|
150
|
+
feePayerSignatureOrSender !== undefined) {
|
|
151
|
+
if (feePayerSignatureOrSender === '0x00' ||
|
|
152
|
+
Address.validate(feePayerSignatureOrSender))
|
|
153
|
+
transaction.feePayerSignature = null;
|
|
154
|
+
else
|
|
155
|
+
transaction.feePayerSignature = Signature.fromTuple(feePayerSignatureOrSender);
|
|
156
|
+
}
|
|
157
|
+
const signatureEnvelope = signature
|
|
158
|
+
? SignatureEnvelope.deserialize(signature)
|
|
159
|
+
: undefined;
|
|
160
|
+
if (signatureEnvelope)
|
|
161
|
+
transaction = {
|
|
162
|
+
...transaction,
|
|
163
|
+
signature: signatureEnvelope,
|
|
164
|
+
};
|
|
165
|
+
assert(transaction);
|
|
166
|
+
return transaction;
|
|
167
|
+
}
|
|
168
|
+
/**
|
|
169
|
+
* Converts an arbitrary transaction object into an AA Transaction Envelope.
|
|
170
|
+
*
|
|
171
|
+
* @example
|
|
172
|
+
* ```ts twoslash
|
|
173
|
+
* import { Value } from 'ox'
|
|
174
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
175
|
+
*
|
|
176
|
+
* const envelope = TransactionEnvelopeAA.from({ // [!code focus]
|
|
177
|
+
* chainId: 1, // [!code focus]
|
|
178
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000', value: Value.fromEther('1') }], // [!code focus]
|
|
179
|
+
* maxFeePerGas: Value.fromGwei('10'), // [!code focus]
|
|
180
|
+
* maxPriorityFeePerGas: Value.fromGwei('1'), // [!code focus]
|
|
181
|
+
* }) // [!code focus]
|
|
182
|
+
* ```
|
|
183
|
+
*
|
|
184
|
+
* @example
|
|
185
|
+
* ### Attaching Signatures
|
|
186
|
+
*
|
|
187
|
+
* It is possible to attach a `signature` to the transaction envelope.
|
|
188
|
+
*
|
|
189
|
+
* ```ts twoslash
|
|
190
|
+
* // @noErrors
|
|
191
|
+
* import { Secp256k1, Value } from 'ox'
|
|
192
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
193
|
+
*
|
|
194
|
+
* const envelope = TransactionEnvelopeAA.from({
|
|
195
|
+
* chainId: 1,
|
|
196
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000', value: Value.fromEther('1') }],
|
|
197
|
+
* maxFeePerGas: Value.fromGwei('10'),
|
|
198
|
+
* maxPriorityFeePerGas: Value.fromGwei('1'),
|
|
199
|
+
* })
|
|
200
|
+
*
|
|
201
|
+
* const signature = Secp256k1.sign({
|
|
202
|
+
* payload: TransactionEnvelopeAA.getSignPayload(envelope),
|
|
203
|
+
* privateKey: '0x...',
|
|
204
|
+
* })
|
|
205
|
+
*
|
|
206
|
+
* const envelope_signed = TransactionEnvelopeAA.from(envelope, { // [!code focus]
|
|
207
|
+
* signature, // [!code focus]
|
|
208
|
+
* }) // [!code focus]
|
|
209
|
+
* // @log: {
|
|
210
|
+
* // @log: chainId: 1,
|
|
211
|
+
* // @log: calls: [{ to: '0x0000000000000000000000000000000000000000', value: 1000000000000000000n }],
|
|
212
|
+
* // @log: maxFeePerGas: 10000000000n,
|
|
213
|
+
* // @log: maxPriorityFeePerGas: 1000000000n,
|
|
214
|
+
* // @log: type: 'aa',
|
|
215
|
+
* // @log: r: 125...n,
|
|
216
|
+
* // @log: s: 642...n,
|
|
217
|
+
* // @log: yParity: 0,
|
|
218
|
+
* // @log: }
|
|
219
|
+
* ```
|
|
220
|
+
*
|
|
221
|
+
* @example
|
|
222
|
+
* ### From Serialized
|
|
223
|
+
*
|
|
224
|
+
* It is possible to instantiate an AA Transaction Envelope from a {@link ox#TransactionEnvelopeAA.Serialized} value.
|
|
225
|
+
*
|
|
226
|
+
* ```ts twoslash
|
|
227
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
228
|
+
*
|
|
229
|
+
* const envelope = TransactionEnvelopeAA.from('0x76f84a0182031184773594008477359400809470997970c51812dc3a010c7d01b50e0d17dc79c8880de0b6b3a764000080c0808080')
|
|
230
|
+
* // @log: {
|
|
231
|
+
* // @log: chainId: 1,
|
|
232
|
+
* // @log: calls: [{ to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8', value: 1000000000000000000n }],
|
|
233
|
+
* // @log: maxFeePerGas: 10000000000n,
|
|
234
|
+
* // @log: type: 'aa',
|
|
235
|
+
* // @log: }
|
|
236
|
+
* ```
|
|
237
|
+
*
|
|
238
|
+
* @param envelope - The transaction object to convert.
|
|
239
|
+
* @param options - Options.
|
|
240
|
+
* @returns An AA Transaction Envelope.
|
|
241
|
+
*/
|
|
242
|
+
export function from(envelope, options = {}) {
|
|
243
|
+
const { feePayerSignature, signature } = options;
|
|
244
|
+
const envelope_ = (typeof envelope === 'string' ? deserialize(envelope) : envelope);
|
|
245
|
+
assert(envelope_);
|
|
246
|
+
return {
|
|
247
|
+
...envelope_,
|
|
248
|
+
...(signature ? { signature: SignatureEnvelope.from(signature) } : {}),
|
|
249
|
+
...(feePayerSignature
|
|
250
|
+
? { feePayerSignature: Signature.from(feePayerSignature) }
|
|
251
|
+
: {}),
|
|
252
|
+
type: 'aa',
|
|
253
|
+
};
|
|
254
|
+
}
|
|
255
|
+
/**
|
|
256
|
+
* Serializes a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA}.
|
|
257
|
+
*
|
|
258
|
+
* @example
|
|
259
|
+
* ```ts twoslash
|
|
260
|
+
* // @noErrors
|
|
261
|
+
* import { Value } from 'ox'
|
|
262
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
263
|
+
*
|
|
264
|
+
* const envelope = TransactionEnvelopeAA.from({
|
|
265
|
+
* chainId: 1,
|
|
266
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000', value: Value.fromEther('1') }],
|
|
267
|
+
* maxFeePerGas: Value.fromGwei('10'),
|
|
268
|
+
* })
|
|
269
|
+
*
|
|
270
|
+
* const serialized = TransactionEnvelopeAA.serialize(envelope) // [!code focus]
|
|
271
|
+
* ```
|
|
272
|
+
*
|
|
273
|
+
* @example
|
|
274
|
+
* ### Attaching Signatures
|
|
275
|
+
*
|
|
276
|
+
* It is possible to attach a `signature` to the serialized Transaction Envelope.
|
|
277
|
+
*
|
|
278
|
+
* ```ts twoslash
|
|
279
|
+
* // @noErrors
|
|
280
|
+
* import { Secp256k1, Value } from 'ox'
|
|
281
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
282
|
+
*
|
|
283
|
+
* const envelope = TransactionEnvelopeAA.from({
|
|
284
|
+
* chainId: 1,
|
|
285
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000', value: Value.fromEther('1') }],
|
|
286
|
+
* maxFeePerGas: Value.fromGwei('10'),
|
|
287
|
+
* })
|
|
288
|
+
*
|
|
289
|
+
* const signature = Secp256k1.sign({
|
|
290
|
+
* payload: TransactionEnvelopeAA.getSignPayload(envelope),
|
|
291
|
+
* privateKey: '0x...',
|
|
292
|
+
* })
|
|
293
|
+
*
|
|
294
|
+
* const serialized = TransactionEnvelopeAA.serialize(envelope, { // [!code focus]
|
|
295
|
+
* signature, // [!code focus]
|
|
296
|
+
* }) // [!code focus]
|
|
297
|
+
*
|
|
298
|
+
* // ... send `serialized` transaction to JSON-RPC `eth_sendRawTransaction`
|
|
299
|
+
* ```
|
|
300
|
+
*
|
|
301
|
+
* @param envelope - The Transaction Envelope to serialize.
|
|
302
|
+
* @param options - Options.
|
|
303
|
+
* @returns The serialized Transaction Envelope.
|
|
304
|
+
*/
|
|
305
|
+
export function serialize(envelope, options = {}) {
|
|
306
|
+
const { accessList, calls, chainId, feeToken, gas, nonce, nonceKey, maxFeePerGas, maxPriorityFeePerGas, validBefore, validAfter, } = envelope;
|
|
307
|
+
assert(envelope);
|
|
308
|
+
const accessTupleList = AccessList.toTupleList(accessList);
|
|
309
|
+
const signature = options.signature || envelope.signature;
|
|
310
|
+
// Encode calls as RLP list of [to, value, data] tuples
|
|
311
|
+
const callsTupleList = calls.map((call) => [
|
|
312
|
+
call.to ?? '0x',
|
|
313
|
+
call.value ? Hex.fromNumber(call.value) : '0x',
|
|
314
|
+
call.data ?? '0x',
|
|
315
|
+
]);
|
|
316
|
+
const feePayerSignatureOrSender = (() => {
|
|
317
|
+
if (options.sender)
|
|
318
|
+
return options.sender;
|
|
319
|
+
const feePayerSignature = typeof options.feePayerSignature !== 'undefined'
|
|
320
|
+
? options.feePayerSignature
|
|
321
|
+
: envelope.feePayerSignature;
|
|
322
|
+
if (feePayerSignature === null)
|
|
323
|
+
return '0x00';
|
|
324
|
+
if (!feePayerSignature)
|
|
325
|
+
return '0x';
|
|
326
|
+
return Signature.toTuple(feePayerSignature);
|
|
327
|
+
})();
|
|
328
|
+
const serialized = [
|
|
329
|
+
Hex.fromNumber(chainId),
|
|
330
|
+
maxPriorityFeePerGas ? Hex.fromNumber(maxPriorityFeePerGas) : '0x',
|
|
331
|
+
maxFeePerGas ? Hex.fromNumber(maxFeePerGas) : '0x',
|
|
332
|
+
gas ? Hex.fromNumber(gas) : '0x',
|
|
333
|
+
callsTupleList,
|
|
334
|
+
accessTupleList,
|
|
335
|
+
nonceKey ? Hex.fromNumber(nonceKey) : '0x',
|
|
336
|
+
nonce ? Hex.fromNumber(nonce) : '0x',
|
|
337
|
+
typeof validBefore === 'number' ? Hex.fromNumber(validBefore) : '0x',
|
|
338
|
+
typeof validAfter === 'number' ? Hex.fromNumber(validAfter) : '0x',
|
|
339
|
+
typeof feeToken === 'bigint' || typeof feeToken === 'string'
|
|
340
|
+
? TokenId.toAddress(feeToken)
|
|
341
|
+
: '0x',
|
|
342
|
+
feePayerSignatureOrSender,
|
|
343
|
+
...(signature
|
|
344
|
+
? [SignatureEnvelope.serialize(SignatureEnvelope.from(signature))]
|
|
345
|
+
: []),
|
|
346
|
+
];
|
|
347
|
+
return Hex.concat(options.format === 'feePayer' ? feePayerMagic : serializedType, Rlp.fromHex(serialized));
|
|
348
|
+
}
|
|
349
|
+
/**
|
|
350
|
+
* Returns the payload to sign for a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA}.
|
|
351
|
+
*
|
|
352
|
+
* @example
|
|
353
|
+
* The example below demonstrates how to compute the sign payload which can be used
|
|
354
|
+
* with ECDSA signing utilities like {@link ox#Secp256k1.(sign:function)}.
|
|
355
|
+
*
|
|
356
|
+
* ```ts twoslash
|
|
357
|
+
* // @noErrors
|
|
358
|
+
* import { Secp256k1 } from 'ox'
|
|
359
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
360
|
+
*
|
|
361
|
+
* const envelope = TransactionEnvelopeAA.from({
|
|
362
|
+
* chainId: 1,
|
|
363
|
+
* calls: [{ to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8', value: 1000000000000000000n }],
|
|
364
|
+
* nonce: 0n,
|
|
365
|
+
* maxFeePerGas: 1000000000n,
|
|
366
|
+
* gas: 21000n,
|
|
367
|
+
* })
|
|
368
|
+
*
|
|
369
|
+
* const payload = TransactionEnvelopeAA.getSignPayload(envelope) // [!code focus]
|
|
370
|
+
* // @log: '0x...'
|
|
371
|
+
*
|
|
372
|
+
* const signature = Secp256k1.sign({ payload, privateKey: '0x...' })
|
|
373
|
+
* ```
|
|
374
|
+
*
|
|
375
|
+
* @param envelope - The transaction envelope to get the sign payload for.
|
|
376
|
+
* @returns The sign payload.
|
|
377
|
+
*/
|
|
378
|
+
export function getSignPayload(envelope) {
|
|
379
|
+
return hash(envelope, { presign: true });
|
|
380
|
+
}
|
|
381
|
+
/**
|
|
382
|
+
* Hashes a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA}. This is the "transaction hash".
|
|
383
|
+
*
|
|
384
|
+
* @example
|
|
385
|
+
* ```ts twoslash
|
|
386
|
+
* // @noErrors
|
|
387
|
+
* import { Secp256k1 } from 'ox'
|
|
388
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
389
|
+
*
|
|
390
|
+
* const envelope = TransactionEnvelopeAA.from({
|
|
391
|
+
* chainId: 1,
|
|
392
|
+
* calls: [{ to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8', value: 1000000000000000000n }],
|
|
393
|
+
* nonce: 0n,
|
|
394
|
+
* maxFeePerGas: 1000000000n,
|
|
395
|
+
* gas: 21000n,
|
|
396
|
+
* })
|
|
397
|
+
*
|
|
398
|
+
* const signature = Secp256k1.sign({
|
|
399
|
+
* payload: TransactionEnvelopeAA.getSignPayload(envelope),
|
|
400
|
+
* privateKey: '0x...'
|
|
401
|
+
* })
|
|
402
|
+
*
|
|
403
|
+
* const envelope_signed = TransactionEnvelopeAA.from(envelope, { signature })
|
|
404
|
+
*
|
|
405
|
+
* const hash = TransactionEnvelopeAA.hash(envelope_signed) // [!code focus]
|
|
406
|
+
* ```
|
|
407
|
+
*
|
|
408
|
+
* @param envelope - The AA Transaction Envelope to hash.
|
|
409
|
+
* @param options - Options.
|
|
410
|
+
* @returns The hash of the transaction envelope.
|
|
411
|
+
*/
|
|
412
|
+
export function hash(envelope, options = {}) {
|
|
413
|
+
const serialized = serialize({
|
|
414
|
+
...envelope,
|
|
415
|
+
...(options.presign
|
|
416
|
+
? {
|
|
417
|
+
signature: undefined,
|
|
418
|
+
}
|
|
419
|
+
: {}),
|
|
420
|
+
});
|
|
421
|
+
return Hash.keccak256(serialized);
|
|
422
|
+
}
|
|
423
|
+
/**
|
|
424
|
+
* Returns the fee payer payload to sign for a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA}.
|
|
425
|
+
*
|
|
426
|
+
* @example
|
|
427
|
+
* ```ts twoslash
|
|
428
|
+
* // @noErrors
|
|
429
|
+
* import { Secp256k1 } from 'ox'
|
|
430
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
431
|
+
*
|
|
432
|
+
* const envelope = TransactionEnvelopeAA.from({
|
|
433
|
+
* chainId: 1,
|
|
434
|
+
* calls: [{ to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8', value: 1000000000000000000n }],
|
|
435
|
+
* nonce: 0n,
|
|
436
|
+
* maxFeePerGas: 1000000000n,
|
|
437
|
+
* gas: 21000n,
|
|
438
|
+
* })
|
|
439
|
+
*
|
|
440
|
+
* const payload = TransactionEnvelopeAA.getFeePayerSignPayload(envelope, {
|
|
441
|
+
* sender: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
|
|
442
|
+
* }) // [!code focus]
|
|
443
|
+
* // @log: '0x...'
|
|
444
|
+
*
|
|
445
|
+
* const signature = Secp256k1.sign({ payload, privateKey: '0x...' })
|
|
446
|
+
* ```
|
|
447
|
+
*
|
|
448
|
+
* @param envelope - The transaction envelope to get the fee payer sign payload for.
|
|
449
|
+
* @param options - Options.
|
|
450
|
+
* @returns The fee payer sign payload.
|
|
451
|
+
*/
|
|
452
|
+
export function getFeePayerSignPayload(envelope, options) {
|
|
453
|
+
const { sender } = options;
|
|
454
|
+
const serialized = serialize({ ...envelope, signature: undefined }, {
|
|
455
|
+
sender,
|
|
456
|
+
format: 'feePayer',
|
|
457
|
+
});
|
|
458
|
+
return Hash.keccak256(serialized);
|
|
459
|
+
}
|
|
460
|
+
/**
|
|
461
|
+
* Validates a {@link ox#TransactionEnvelopeAA.TransactionEnvelopeAA}. Returns `true` if the envelope is valid, `false` otherwise.
|
|
462
|
+
*
|
|
463
|
+
* @example
|
|
464
|
+
* ```ts twoslash
|
|
465
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
466
|
+
*
|
|
467
|
+
* const valid = TransactionEnvelopeAA.validate({
|
|
468
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000', value: 0n }],
|
|
469
|
+
* chainId: 1,
|
|
470
|
+
* maxFeePerGas: 1000000000n,
|
|
471
|
+
* })
|
|
472
|
+
* // @log: true
|
|
473
|
+
* ```
|
|
474
|
+
*
|
|
475
|
+
* @param envelope - The transaction envelope to validate.
|
|
476
|
+
*/
|
|
477
|
+
export function validate(envelope) {
|
|
478
|
+
try {
|
|
479
|
+
assert(envelope);
|
|
480
|
+
return true;
|
|
481
|
+
}
|
|
482
|
+
catch {
|
|
483
|
+
return false;
|
|
484
|
+
}
|
|
485
|
+
}
|
|
486
|
+
/**
|
|
487
|
+
* Thrown when a transaction's calls list is empty.
|
|
488
|
+
*
|
|
489
|
+
* @example
|
|
490
|
+
* ```ts twoslash
|
|
491
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
492
|
+
*
|
|
493
|
+
* TransactionEnvelopeAA.assert({
|
|
494
|
+
* calls: [],
|
|
495
|
+
* chainId: 1,
|
|
496
|
+
* })
|
|
497
|
+
* // @error: TransactionEnvelopeAA.CallsEmptyError: Calls list cannot be empty.
|
|
498
|
+
* ```
|
|
499
|
+
*/
|
|
500
|
+
export class CallsEmptyError extends Errors.BaseError {
|
|
501
|
+
name = 'TransactionEnvelopeAA.CallsEmptyError';
|
|
502
|
+
constructor() {
|
|
503
|
+
super('Calls list cannot be empty.');
|
|
504
|
+
}
|
|
505
|
+
}
|
|
506
|
+
/**
|
|
507
|
+
* Thrown when validBefore is not greater than validAfter.
|
|
508
|
+
*
|
|
509
|
+
* @example
|
|
510
|
+
* ```ts twoslash
|
|
511
|
+
* import { TransactionEnvelopeAA } from 'ox/tempo'
|
|
512
|
+
*
|
|
513
|
+
* TransactionEnvelopeAA.assert({
|
|
514
|
+
* calls: [{ to: '0x0000000000000000000000000000000000000000' }],
|
|
515
|
+
* chainId: 1,
|
|
516
|
+
* validBefore: 100n,
|
|
517
|
+
* validAfter: 200n,
|
|
518
|
+
* })
|
|
519
|
+
* // @error: TransactionEnvelopeAA.InvalidValidityWindowError: validBefore (100) must be greater than validAfter (200).
|
|
520
|
+
* ```
|
|
521
|
+
*/
|
|
522
|
+
export class InvalidValidityWindowError extends Errors.BaseError {
|
|
523
|
+
name = 'TransactionEnvelopeAA.InvalidValidityWindowError';
|
|
524
|
+
constructor({ validBefore, validAfter, }) {
|
|
525
|
+
super(`validBefore (${validBefore}) must be greater than validAfter (${validAfter}).`);
|
|
526
|
+
}
|
|
527
|
+
}
|
|
528
|
+
//# sourceMappingURL=TransactionEnvelopeAA.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"TransactionEnvelopeAA.js","sourceRoot":"","sources":["../../src/ox/TransactionEnvelopeAA.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type * as Authorization from 'ox/Authorization';
|
|
2
|
+
import type * as Errors from 'ox/Errors';
|
|
3
|
+
import * as Hex from 'ox/Hex';
|
|
4
|
+
import * as ox_TransactionRequest from 'ox/TransactionRequest';
|
|
5
|
+
import type { Compute } from '../internal/types.js';
|
|
6
|
+
import * as TokenId from './TokenId.js';
|
|
7
|
+
import type { Call } from './TransactionEnvelopeAA.js';
|
|
8
|
+
/** A Transaction Request that is generic to all transaction types, as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/4aca1d7a3e5aab24c8f6437131289ad386944eaa/src/schemas/transaction.yaml#L358-L423). */
|
|
9
|
+
export type TransactionRequest<bigintType = bigint, numberType = number, type extends string = string> = Compute<ox_TransactionRequest.TransactionRequest<bigintType, numberType, type> & {
|
|
10
|
+
calls?: readonly Call<bigintType>[] | undefined;
|
|
11
|
+
feeToken?: TokenId.TokenIdOrAddress | undefined;
|
|
12
|
+
validBefore?: numberType | undefined;
|
|
13
|
+
validAfter?: numberType | undefined;
|
|
14
|
+
}>;
|
|
15
|
+
/** RPC representation of a {@link ox#TransactionRequest.TransactionRequest}. */
|
|
16
|
+
export type Rpc = TransactionRequest<Hex.Hex, Hex.Hex, string>;
|
|
17
|
+
/**
|
|
18
|
+
* Converts a {@link ox#TransactionRequest.TransactionRequest} to a {@link ox#TransactionRequest.Rpc}.
|
|
19
|
+
*
|
|
20
|
+
* @example
|
|
21
|
+
* ```ts twoslash
|
|
22
|
+
* import { Value } from 'ox'
|
|
23
|
+
* import { TransactionRequest } from 'ox/tempo'
|
|
24
|
+
*
|
|
25
|
+
* const request = TransactionRequest.toRpc({
|
|
26
|
+
* feeToken: '0x20c0000000000000000000000000000000000000',
|
|
27
|
+
* to: '0x0000000000000000000000000000000000000000',
|
|
28
|
+
* value: Value.fromEther('0.01'),
|
|
29
|
+
* })
|
|
30
|
+
* ```
|
|
31
|
+
*
|
|
32
|
+
* @example
|
|
33
|
+
* ### Using with a Provider
|
|
34
|
+
*
|
|
35
|
+
* You can use {@link ox#Provider.(from:function)} to instantiate an EIP-1193 Provider and
|
|
36
|
+
* send a transaction to the Wallet using the `eth_sendTransaction` method.
|
|
37
|
+
*
|
|
38
|
+
* ```ts twoslash
|
|
39
|
+
* import 'ox/window'
|
|
40
|
+
* import { Provider, Value } from 'ox'
|
|
41
|
+
* import { TransactionRequest } from 'ox/tempo'
|
|
42
|
+
*
|
|
43
|
+
* const provider = Provider.from(window.ethereum!)
|
|
44
|
+
*
|
|
45
|
+
* const request = TransactionRequest.toRpc({
|
|
46
|
+
* feeToken: '0x20c0000000000000000000000000000000000000',
|
|
47
|
+
* to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
|
|
48
|
+
* value: Value.fromEther('0.01'),
|
|
49
|
+
* })
|
|
50
|
+
*
|
|
51
|
+
* const hash = await provider.request({ // [!code focus]
|
|
52
|
+
* method: 'eth_sendTransaction', // [!code focus]
|
|
53
|
+
* params: [request], // [!code focus]
|
|
54
|
+
* }) // [!code focus]
|
|
55
|
+
* ```
|
|
56
|
+
*
|
|
57
|
+
* @param request - The request to convert.
|
|
58
|
+
* @returns An RPC request.
|
|
59
|
+
*/
|
|
60
|
+
export declare function toRpc(request: TransactionRequest): Rpc;
|
|
61
|
+
export declare namespace toRpc {
|
|
62
|
+
type ErrorType = Authorization.toRpcList.ErrorType | Hex.fromNumber.ErrorType | Errors.GlobalErrorType;
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=TransactionRequest.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"TransactionRequest.d.ts","sourceRoot":"","sources":["../../src/ox/TransactionRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,aAAa,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,KAAK,MAAM,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,GAAG,MAAM,QAAQ,CAAA;AAC7B,OAAO,KAAK,qBAAqB,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAEtD,wPAAwP;AACxP,MAAM,MAAM,kBAAkB,CAC5B,UAAU,GAAG,MAAM,EACnB,UAAU,GAAG,MAAM,EACnB,IAAI,SAAS,MAAM,GAAG,MAAM,IAC1B,OAAO,CACT,qBAAqB,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG;IACvE,KAAK,CAAC,EAAE,SAAS,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,SAAS,CAAA;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAC/C,WAAW,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IACpC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;CACpC,CACF,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,GAAG,CA+BtD;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAY,SAAS,GACjB,aAAa,CAAC,SAAS,CAAC,SAAS,GACjC,GAAG,CAAC,UAAU,CAAC,SAAS,GACxB,MAAM,CAAC,eAAe,CAAA;CAC3B"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import * as Hex from 'ox/Hex';
|
|
2
|
+
import * as ox_TransactionRequest from 'ox/TransactionRequest';
|
|
3
|
+
import * as TokenId from './TokenId.js';
|
|
4
|
+
import * as Transaction from './Transaction.js';
|
|
5
|
+
/**
|
|
6
|
+
* Converts a {@link ox#TransactionRequest.TransactionRequest} to a {@link ox#TransactionRequest.Rpc}.
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
9
|
+
* ```ts twoslash
|
|
10
|
+
* import { Value } from 'ox'
|
|
11
|
+
* import { TransactionRequest } from 'ox/tempo'
|
|
12
|
+
*
|
|
13
|
+
* const request = TransactionRequest.toRpc({
|
|
14
|
+
* feeToken: '0x20c0000000000000000000000000000000000000',
|
|
15
|
+
* to: '0x0000000000000000000000000000000000000000',
|
|
16
|
+
* value: Value.fromEther('0.01'),
|
|
17
|
+
* })
|
|
18
|
+
* ```
|
|
19
|
+
*
|
|
20
|
+
* @example
|
|
21
|
+
* ### Using with a Provider
|
|
22
|
+
*
|
|
23
|
+
* You can use {@link ox#Provider.(from:function)} to instantiate an EIP-1193 Provider and
|
|
24
|
+
* send a transaction to the Wallet using the `eth_sendTransaction` method.
|
|
25
|
+
*
|
|
26
|
+
* ```ts twoslash
|
|
27
|
+
* import 'ox/window'
|
|
28
|
+
* import { Provider, Value } from 'ox'
|
|
29
|
+
* import { TransactionRequest } from 'ox/tempo'
|
|
30
|
+
*
|
|
31
|
+
* const provider = Provider.from(window.ethereum!)
|
|
32
|
+
*
|
|
33
|
+
* const request = TransactionRequest.toRpc({
|
|
34
|
+
* feeToken: '0x20c0000000000000000000000000000000000000',
|
|
35
|
+
* to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
|
|
36
|
+
* value: Value.fromEther('0.01'),
|
|
37
|
+
* })
|
|
38
|
+
*
|
|
39
|
+
* const hash = await provider.request({ // [!code focus]
|
|
40
|
+
* method: 'eth_sendTransaction', // [!code focus]
|
|
41
|
+
* params: [request], // [!code focus]
|
|
42
|
+
* }) // [!code focus]
|
|
43
|
+
* ```
|
|
44
|
+
*
|
|
45
|
+
* @param request - The request to convert.
|
|
46
|
+
* @returns An RPC request.
|
|
47
|
+
*/
|
|
48
|
+
export function toRpc(request) {
|
|
49
|
+
const request_rpc = ox_TransactionRequest.toRpc(request);
|
|
50
|
+
if (request.calls)
|
|
51
|
+
request_rpc.calls = request.calls.map((call) => ({
|
|
52
|
+
to: call.to ?? '0x',
|
|
53
|
+
value: call.value ? Hex.fromNumber(call.value) : '0x',
|
|
54
|
+
data: call.data ?? '0x',
|
|
55
|
+
}));
|
|
56
|
+
if (typeof request.feeToken !== 'undefined')
|
|
57
|
+
request_rpc.feeToken = TokenId.toAddress(request.feeToken);
|
|
58
|
+
if (typeof request.validBefore !== 'undefined')
|
|
59
|
+
request_rpc.validBefore = Hex.fromNumber(request.validBefore);
|
|
60
|
+
if (typeof request.validAfter !== 'undefined')
|
|
61
|
+
request_rpc.validAfter = Hex.fromNumber(request.validAfter);
|
|
62
|
+
if (request.calls ||
|
|
63
|
+
typeof request.feeToken !== 'undefined' ||
|
|
64
|
+
typeof request.validBefore !== 'undefined' ||
|
|
65
|
+
typeof request.validAfter !== 'undefined' ||
|
|
66
|
+
request.type === 'aa') {
|
|
67
|
+
request_rpc.type = Transaction.toRpcType.aa;
|
|
68
|
+
delete request_rpc.data;
|
|
69
|
+
delete request_rpc.input;
|
|
70
|
+
delete request_rpc.to;
|
|
71
|
+
delete request_rpc.value;
|
|
72
|
+
}
|
|
73
|
+
return request_rpc;
|
|
74
|
+
}
|
|
75
|
+
//# sourceMappingURL=TransactionRequest.js.map
|