@solana/transactions 2.0.0-experimental.78768fc → 2.0.0-experimental.7aeac5a

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.
Files changed (71) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +272 -5
  3. package/dist/index.browser.cjs +490 -292
  4. package/dist/index.browser.cjs.map +1 -1
  5. package/dist/index.browser.js +476 -293
  6. package/dist/index.browser.js.map +1 -1
  7. package/dist/index.native.js +476 -293
  8. package/dist/index.native.js.map +1 -1
  9. package/dist/index.node.cjs +488 -292
  10. package/dist/index.node.cjs.map +1 -1
  11. package/dist/index.node.js +476 -293
  12. package/dist/index.node.js.map +1 -1
  13. package/dist/types/accounts.d.ts +2 -2
  14. package/dist/types/accounts.d.ts.map +1 -0
  15. package/dist/types/blockhash.d.ts +5 -7
  16. package/dist/types/blockhash.d.ts.map +1 -0
  17. package/dist/types/compilable-transaction.d.ts +7 -0
  18. package/dist/types/compilable-transaction.d.ts.map +1 -0
  19. package/dist/types/compile-address-table-lookups.d.ts +3 -3
  20. package/dist/types/compile-address-table-lookups.d.ts.map +1 -0
  21. package/dist/types/compile-header.d.ts +1 -1
  22. package/dist/types/compile-header.d.ts.map +1 -0
  23. package/dist/types/compile-instructions.d.ts +1 -1
  24. package/dist/types/compile-instructions.d.ts.map +1 -0
  25. package/dist/types/compile-lifetime-token.d.ts +1 -1
  26. package/dist/types/compile-lifetime-token.d.ts.map +1 -0
  27. package/dist/types/compile-static-accounts.d.ts +3 -3
  28. package/dist/types/compile-static-accounts.d.ts.map +1 -0
  29. package/dist/types/compile-transaction.d.ts +6 -7
  30. package/dist/types/compile-transaction.d.ts.map +1 -0
  31. package/dist/types/create-transaction.d.ts +1 -1
  32. package/dist/types/create-transaction.d.ts.map +1 -0
  33. package/dist/types/decompile-transaction.d.ts +13 -0
  34. package/dist/types/decompile-transaction.d.ts.map +1 -0
  35. package/dist/types/durable-nonce.d.ts +9 -8
  36. package/dist/types/durable-nonce.d.ts.map +1 -0
  37. package/dist/types/fee-payer.d.ts +6 -5
  38. package/dist/types/fee-payer.d.ts.map +1 -0
  39. package/dist/types/index.d.ts +12 -8
  40. package/dist/types/index.d.ts.map +1 -0
  41. package/dist/types/instructions.d.ts +2 -2
  42. package/dist/types/instructions.d.ts.map +1 -0
  43. package/dist/types/message.d.ts +6 -10
  44. package/dist/types/message.d.ts.map +1 -0
  45. package/dist/types/serializers/address-table-lookup.d.ts +5 -3
  46. package/dist/types/serializers/address-table-lookup.d.ts.map +1 -0
  47. package/dist/types/serializers/header.d.ts +5 -3
  48. package/dist/types/serializers/header.d.ts.map +1 -0
  49. package/dist/types/serializers/index.d.ts +3 -0
  50. package/dist/types/serializers/index.d.ts.map +1 -0
  51. package/dist/types/serializers/instruction.d.ts +5 -3
  52. package/dist/types/serializers/instruction.d.ts.map +1 -0
  53. package/dist/types/serializers/message.d.ts +5 -5
  54. package/dist/types/serializers/message.d.ts.map +1 -0
  55. package/dist/types/serializers/transaction-version.d.ts +5 -5
  56. package/dist/types/serializers/transaction-version.d.ts.map +1 -0
  57. package/dist/types/serializers/transaction.d.ts +9 -5
  58. package/dist/types/serializers/transaction.d.ts.map +1 -0
  59. package/dist/types/signatures.d.ts +9 -5
  60. package/dist/types/signatures.d.ts.map +1 -0
  61. package/dist/types/types.d.ts +6 -13
  62. package/dist/types/types.d.ts.map +1 -0
  63. package/dist/types/unsigned-transaction.d.ts +1 -1
  64. package/dist/types/unsigned-transaction.d.ts.map +1 -0
  65. package/dist/types/wire-transaction.d.ts +2 -2
  66. package/dist/types/wire-transaction.d.ts.map +1 -0
  67. package/package.json +24 -17
  68. package/dist/index.development.js +0 -1327
  69. package/dist/index.development.js.map +0 -1
  70. package/dist/index.production.min.js +0 -20
  71. package/dist/types/serializers/unimplemented.d.ts +0 -3
@@ -1,11 +1,37 @@
1
1
  'use strict';
2
2
 
3
- var umiSerializers = require('@metaplex-foundation/umi-serializers');
3
+ var codecsStrings = require('@solana/codecs-strings');
4
4
  var addresses = require('@solana/addresses');
5
+ var functional = require('@solana/functional');
6
+ var codecsCore = require('@solana/codecs-core');
7
+ var codecsDataStructures = require('@solana/codecs-data-structures');
8
+ var codecsNumbers = require('@solana/codecs-numbers');
5
9
  var keys = require('@solana/keys');
6
10
 
7
- // ../build-scripts/env-shim.ts
8
- var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
11
+ // ../rpc-types/dist/index.node.js
12
+ var base58Encoder;
13
+ function assertIsBlockhash(putativeBlockhash) {
14
+ if (!base58Encoder)
15
+ base58Encoder = codecsStrings.getBase58Encoder();
16
+ try {
17
+ if (
18
+ // Lowest value (32 bytes of zeroes)
19
+ putativeBlockhash.length < 32 || // Highest value (32 bytes of 255)
20
+ putativeBlockhash.length > 44
21
+ ) {
22
+ throw new Error("Expected input string to decode to a byte array of length 32.");
23
+ }
24
+ const bytes = base58Encoder.encode(putativeBlockhash);
25
+ const numBytes = bytes.byteLength;
26
+ if (numBytes !== 32) {
27
+ throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
28
+ }
29
+ } catch (e) {
30
+ throw new Error(`\`${putativeBlockhash}\` is not a blockhash`, {
31
+ cause: e
32
+ });
33
+ }
34
+ }
9
35
 
10
36
  // src/unsigned-transaction.ts
11
37
  function getUnsignedTransaction(transaction) {
@@ -22,24 +48,20 @@ function getUnsignedTransaction(transaction) {
22
48
  }
23
49
 
24
50
  // src/blockhash.ts
25
- function assertIsBlockhash(putativeBlockhash) {
51
+ function isTransactionWithBlockhashLifetime(transaction) {
52
+ const lifetimeConstraintShapeMatches = "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.blockhash === "string" && typeof transaction.lifetimeConstraint.lastValidBlockHeight === "bigint";
53
+ if (!lifetimeConstraintShapeMatches)
54
+ return false;
26
55
  try {
27
- if (
28
- // Lowest value (32 bytes of zeroes)
29
- putativeBlockhash.length < 32 || // Highest value (32 bytes of 255)
30
- putativeBlockhash.length > 44
31
- ) {
32
- throw new Error("Expected input string to decode to a byte array of length 32.");
33
- }
34
- const bytes3 = umiSerializers.base58.serialize(putativeBlockhash);
35
- const numBytes = bytes3.byteLength;
36
- if (numBytes !== 32) {
37
- throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
38
- }
39
- } catch (e) {
40
- throw new Error(`\`${putativeBlockhash}\` is not a blockhash`, {
41
- cause: e
42
- });
56
+ assertIsBlockhash(transaction.lifetimeConstraint.blockhash);
57
+ return true;
58
+ } catch {
59
+ return false;
60
+ }
61
+ }
62
+ function assertIsTransactionWithBlockhashLifetime(transaction) {
63
+ if (!isTransactionWithBlockhashLifetime(transaction)) {
64
+ throw new Error("Transaction does not have a blockhash lifetime");
43
65
  }
44
66
  }
45
67
  function setTransactionLifetimeUsingBlockhash(blockhashLifetimeConstraint, transaction) {
@@ -117,7 +139,7 @@ function isAdvanceNonceAccountInstruction(instruction) {
117
139
  instruction.accounts?.length === 3 && // First account is nonce account address
118
140
  instruction.accounts[0].address != null && instruction.accounts[0].role === AccountRole.WRITABLE && // Second account is recent blockhashes sysvar
119
141
  instruction.accounts[1].address === RECENT_BLOCKHASHES_SYSVAR_ADDRESS && instruction.accounts[1].role === AccountRole.READONLY && // Third account is nonce authority account
120
- instruction.accounts[2].address != null && instruction.accounts[2].role === AccountRole.READONLY_SIGNER;
142
+ instruction.accounts[2].address != null && isSignerRole(instruction.accounts[2].role);
121
143
  }
122
144
  function isAdvanceNonceAccountInstructionData(data) {
123
145
  return data.byteLength === 4 && data[0] === 4 && data[1] === 0 && data[2] === 0 && data[3] === 0;
@@ -125,21 +147,38 @@ function isAdvanceNonceAccountInstructionData(data) {
125
147
  function isDurableNonceTransaction(transaction) {
126
148
  return "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.nonce === "string" && transaction.instructions[0] != null && isAdvanceNonceAccountInstruction(transaction.instructions[0]);
127
149
  }
150
+ function isAdvanceNonceAccountInstructionForNonce(instruction, nonceAccountAddress, nonceAuthorityAddress) {
151
+ return instruction.accounts[0].address === nonceAccountAddress && instruction.accounts[2].address === nonceAuthorityAddress;
152
+ }
128
153
  function setTransactionLifetimeUsingDurableNonce({
129
154
  nonce,
130
155
  nonceAccountAddress,
131
156
  nonceAuthorityAddress
132
157
  }, transaction) {
133
- const isAlreadyDurableNonceTransaction = isDurableNonceTransaction(transaction);
134
- if (isAlreadyDurableNonceTransaction && transaction.lifetimeConstraint.nonce === nonce && transaction.instructions[0].accounts[0].address === nonceAccountAddress && transaction.instructions[0].accounts[2].address === nonceAuthorityAddress) {
135
- return transaction;
158
+ let newInstructions;
159
+ const firstInstruction = transaction.instructions[0];
160
+ if (firstInstruction && isAdvanceNonceAccountInstruction(firstInstruction)) {
161
+ if (isAdvanceNonceAccountInstructionForNonce(firstInstruction, nonceAccountAddress, nonceAuthorityAddress)) {
162
+ if (isDurableNonceTransaction(transaction) && transaction.lifetimeConstraint.nonce === nonce) {
163
+ return transaction;
164
+ } else {
165
+ newInstructions = [firstInstruction, ...transaction.instructions.slice(1)];
166
+ }
167
+ } else {
168
+ newInstructions = [
169
+ createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
170
+ ...transaction.instructions.slice(1)
171
+ ];
172
+ }
173
+ } else {
174
+ newInstructions = [
175
+ createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
176
+ ...transaction.instructions
177
+ ];
136
178
  }
137
179
  const out = {
138
180
  ...getUnsignedTransaction(transaction),
139
- instructions: [
140
- createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
141
- ...isAlreadyDurableNonceTransaction ? transaction.instructions.slice(1) : transaction.instructions
142
- ],
181
+ instructions: newInstructions,
143
182
  lifetimeConstraint: {
144
183
  nonce
145
184
  }
@@ -178,6 +217,151 @@ function prependTransactionInstruction(instruction, transaction) {
178
217
  Object.freeze(out);
179
218
  return out;
180
219
  }
220
+
221
+ // src/decompile-transaction.ts
222
+ function getAccountMetas(message) {
223
+ const { header } = message;
224
+ const numWritableSignerAccounts = header.numSignerAccounts - header.numReadonlySignerAccounts;
225
+ const numWritableNonSignerAccounts = message.staticAccounts.length - header.numSignerAccounts - header.numReadonlyNonSignerAccounts;
226
+ const accountMetas = [];
227
+ let accountIndex = 0;
228
+ for (let i = 0; i < numWritableSignerAccounts; i++) {
229
+ accountMetas.push({
230
+ address: message.staticAccounts[accountIndex],
231
+ role: AccountRole.WRITABLE_SIGNER
232
+ });
233
+ accountIndex++;
234
+ }
235
+ for (let i = 0; i < header.numReadonlySignerAccounts; i++) {
236
+ accountMetas.push({
237
+ address: message.staticAccounts[accountIndex],
238
+ role: AccountRole.READONLY_SIGNER
239
+ });
240
+ accountIndex++;
241
+ }
242
+ for (let i = 0; i < numWritableNonSignerAccounts; i++) {
243
+ accountMetas.push({
244
+ address: message.staticAccounts[accountIndex],
245
+ role: AccountRole.WRITABLE
246
+ });
247
+ accountIndex++;
248
+ }
249
+ for (let i = 0; i < header.numReadonlyNonSignerAccounts; i++) {
250
+ accountMetas.push({
251
+ address: message.staticAccounts[accountIndex],
252
+ role: AccountRole.READONLY
253
+ });
254
+ accountIndex++;
255
+ }
256
+ return accountMetas;
257
+ }
258
+ function getAddressLookupMetas(compiledAddressTableLookups, addressesByLookupTableAddress) {
259
+ const compiledAddressTableLookupAddresses = compiledAddressTableLookups.map((l) => l.lookupTableAddress);
260
+ const missing = compiledAddressTableLookupAddresses.filter((a) => addressesByLookupTableAddress[a] === void 0);
261
+ if (missing.length > 0) {
262
+ const missingAddresses = missing.join(", ");
263
+ throw new Error(`Addresses not provided for lookup tables: [${missingAddresses}]`);
264
+ }
265
+ const readOnlyMetas = [];
266
+ const writableMetas = [];
267
+ for (const lookup of compiledAddressTableLookups) {
268
+ const addresses = addressesByLookupTableAddress[lookup.lookupTableAddress];
269
+ const highestIndex = Math.max(...lookup.readableIndices, ...lookup.writableIndices);
270
+ if (highestIndex >= addresses.length) {
271
+ throw new Error(
272
+ `Cannot look up index ${highestIndex} in lookup table [${lookup.lookupTableAddress}]. The lookup table may have been extended since the addresses provided were retrieved.`
273
+ );
274
+ }
275
+ const readOnlyForLookup = lookup.readableIndices.map((r) => ({
276
+ address: addresses[r],
277
+ addressIndex: r,
278
+ lookupTableAddress: lookup.lookupTableAddress,
279
+ role: AccountRole.READONLY
280
+ }));
281
+ readOnlyMetas.push(...readOnlyForLookup);
282
+ const writableForLookup = lookup.writableIndices.map((w) => ({
283
+ address: addresses[w],
284
+ addressIndex: w,
285
+ lookupTableAddress: lookup.lookupTableAddress,
286
+ role: AccountRole.WRITABLE
287
+ }));
288
+ writableMetas.push(...writableForLookup);
289
+ }
290
+ return [...writableMetas, ...readOnlyMetas];
291
+ }
292
+ function convertInstruction(instruction, accountMetas) {
293
+ const programAddress = accountMetas[instruction.programAddressIndex]?.address;
294
+ if (!programAddress) {
295
+ throw new Error(`Could not find program address at index ${instruction.programAddressIndex}`);
296
+ }
297
+ const accounts = instruction.accountIndices?.map((accountIndex) => accountMetas[accountIndex]);
298
+ const { data } = instruction;
299
+ return {
300
+ programAddress,
301
+ ...accounts && accounts.length ? { accounts } : {},
302
+ ...data && data.length ? { data } : {}
303
+ };
304
+ }
305
+ function getLifetimeConstraint(messageLifetimeToken, firstInstruction, lastValidBlockHeight) {
306
+ if (!firstInstruction || !isAdvanceNonceAccountInstruction(firstInstruction)) {
307
+ return {
308
+ blockhash: messageLifetimeToken,
309
+ lastValidBlockHeight: lastValidBlockHeight ?? 2n ** 64n - 1n
310
+ // U64 MAX
311
+ };
312
+ } else {
313
+ const nonceAccountAddress = firstInstruction.accounts[0].address;
314
+ addresses.assertIsAddress(nonceAccountAddress);
315
+ const nonceAuthorityAddress = firstInstruction.accounts[2].address;
316
+ addresses.assertIsAddress(nonceAuthorityAddress);
317
+ return {
318
+ nonce: messageLifetimeToken,
319
+ nonceAccountAddress,
320
+ nonceAuthorityAddress
321
+ };
322
+ }
323
+ }
324
+ function convertSignatures(compiledTransaction) {
325
+ const {
326
+ compiledMessage: { staticAccounts },
327
+ signatures
328
+ } = compiledTransaction;
329
+ return signatures.reduce((acc, sig, index) => {
330
+ const allZeros = sig.every((byte) => byte === 0);
331
+ if (allZeros)
332
+ return acc;
333
+ const address = staticAccounts[index];
334
+ return { ...acc, [address]: sig };
335
+ }, {});
336
+ }
337
+ function decompileTransaction(compiledTransaction, config) {
338
+ const { compiledMessage } = compiledTransaction;
339
+ const feePayer = compiledMessage.staticAccounts[0];
340
+ if (!feePayer)
341
+ throw new Error("No fee payer set in CompiledTransaction");
342
+ const accountMetas = getAccountMetas(compiledMessage);
343
+ const accountLookupMetas = "addressTableLookups" in compiledMessage && compiledMessage.addressTableLookups !== void 0 && compiledMessage.addressTableLookups.length > 0 ? getAddressLookupMetas(compiledMessage.addressTableLookups, config?.addressesByLookupTableAddress ?? {}) : [];
344
+ const transactionMetas = [...accountMetas, ...accountLookupMetas];
345
+ const instructions = compiledMessage.instructions.map(
346
+ (compiledInstruction) => convertInstruction(compiledInstruction, transactionMetas)
347
+ );
348
+ const firstInstruction = instructions[0];
349
+ const lifetimeConstraint = getLifetimeConstraint(
350
+ compiledMessage.lifetimeToken,
351
+ firstInstruction,
352
+ config?.lastValidBlockHeight
353
+ );
354
+ const signatures = convertSignatures(compiledTransaction);
355
+ return functional.pipe(
356
+ createTransaction({ version: compiledMessage.version }),
357
+ (tx) => setTransactionFeePayer(feePayer, tx),
358
+ (tx) => instructions.reduce((acc, instruction) => {
359
+ return appendTransactionInstruction(instruction, acc);
360
+ }, tx),
361
+ (tx) => "blockhash" in lifetimeConstraint ? setTransactionLifetimeUsingBlockhash(lifetimeConstraint, tx) : setTransactionLifetimeUsingDurableNonce(lifetimeConstraint, tx),
362
+ (tx) => Object.keys(signatures).length > 0 ? { ...tx, signatures } : tx
363
+ );
364
+ }
181
365
  function upsert(addressMap, address, update) {
182
366
  addressMap[address] = update(addressMap[address] ?? { role: AccountRole.READONLY });
183
367
  }
@@ -230,7 +414,7 @@ function getAddressMapFromInstructions(feePayer, instructions) {
230
414
  const shouldReplaceEntry = (
231
415
  // Consider using the new LOOKUP_TABLE if its address is different...
232
416
  entry.lookupTableAddress !== accountMeta.lookupTableAddress && // ...and sorts before the existing one.
233
- (addressComparator || (addressComparator = addresses.getBase58EncodedAddressComparator()))(
417
+ (addressComparator ||= addresses.getAddressComparator())(
234
418
  accountMeta.lookupTableAddress,
235
419
  entry.lookupTableAddress
236
420
  ) < 0
@@ -336,7 +520,7 @@ function getOrderedAccountsFromAddressMap(addressMap) {
336
520
  if (leftIsWritable !== isWritableRole(rightEntry.role)) {
337
521
  return leftIsWritable ? -1 : 1;
338
522
  }
339
- addressComparator || (addressComparator = addresses.getBase58EncodedAddressComparator());
523
+ addressComparator ||= addresses.getAddressComparator();
340
524
  if (leftEntry[TYPE] === 1 /* LOOKUP_TABLE */ && rightEntry[TYPE] === 1 /* LOOKUP_TABLE */ && leftEntry.lookupTableAddress !== rightEntry.lookupTableAddress) {
341
525
  return addressComparator(leftEntry.lookupTableAddress, rightEntry.lookupTableAddress);
342
526
  } else {
@@ -349,23 +533,22 @@ function getOrderedAccountsFromAddressMap(addressMap) {
349
533
  return orderedAccounts;
350
534
  }
351
535
  function getCompiledAddressTableLookups(orderedAccounts) {
352
- var _a;
353
536
  const index = {};
354
537
  for (const account of orderedAccounts) {
355
538
  if (!("lookupTableAddress" in account)) {
356
539
  continue;
357
540
  }
358
- const entry = index[_a = account.lookupTableAddress] || (index[_a] = {
541
+ const entry = index[account.lookupTableAddress] ||= {
359
542
  readableIndices: [],
360
543
  writableIndices: []
361
- });
544
+ };
362
545
  if (account.role === AccountRole.WRITABLE) {
363
546
  entry.writableIndices.push(account.addressIndex);
364
547
  } else {
365
548
  entry.readableIndices.push(account.addressIndex);
366
549
  }
367
550
  }
368
- return Object.keys(index).sort(addresses.getBase58EncodedAddressComparator()).map((lookupTableAddress) => ({
551
+ return Object.keys(index).sort(addresses.getAddressComparator()).map((lookupTableAddress) => ({
369
552
  lookupTableAddress,
370
553
  ...index[lookupTableAddress]
371
554
  }));
@@ -444,266 +627,215 @@ function compileMessage(transaction) {
444
627
  version: transaction.version
445
628
  };
446
629
  }
447
- function getAddressTableLookupCodec() {
448
- return umiSerializers.struct(
449
- [
450
- [
451
- "lookupTableAddress",
452
- addresses.getBase58EncodedAddressCodec(
453
- __DEV__ ? {
454
- description: "The address of the address lookup table account from which instruction addresses should be looked up"
455
- } : void 0
456
- )
457
- ],
630
+ var memoizedAddressTableLookupEncoder;
631
+ function getAddressTableLookupEncoder() {
632
+ if (!memoizedAddressTableLookupEncoder) {
633
+ memoizedAddressTableLookupEncoder = codecsDataStructures.getStructEncoder([
634
+ ["lookupTableAddress", addresses.getAddressEncoder()],
458
635
  [
459
636
  "writableIndices",
460
- umiSerializers.array(umiSerializers.u8(), {
461
- ...__DEV__ ? {
462
- description: "The indices of the accounts in the lookup table that should be loaded as writeable"
463
- } : null,
464
- size: umiSerializers.shortU16()
465
- })
637
+ codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), { size: codecsNumbers.getShortU16Encoder() })
466
638
  ],
467
639
  [
468
640
  "readableIndices",
469
- umiSerializers.array(umiSerializers.u8(), {
470
- ...__DEV__ ? {
471
- description: "The indices of the accounts in the lookup table that should be loaded as read-only"
472
- } : void 0,
473
- size: umiSerializers.shortU16()
474
- })
641
+ codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), { size: codecsNumbers.getShortU16Encoder() })
475
642
  ]
476
- ],
477
- __DEV__ ? {
478
- description: "A pointer to the address of an address lookup table, along with the readonly/writeable indices of the addresses that should be loaded from it"
479
- } : void 0
480
- );
643
+ ]);
644
+ }
645
+ return memoizedAddressTableLookupEncoder;
646
+ }
647
+ var memoizedAddressTableLookupDecoder;
648
+ function getAddressTableLookupDecoder() {
649
+ if (!memoizedAddressTableLookupDecoder) {
650
+ memoizedAddressTableLookupDecoder = codecsDataStructures.getStructDecoder([
651
+ ["lookupTableAddress", addresses.getAddressDecoder()],
652
+ ["writableIndices", codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), { size: codecsNumbers.getShortU16Decoder() })],
653
+ ["readableIndices", codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), { size: codecsNumbers.getShortU16Decoder() })]
654
+ ]);
655
+ }
656
+ return memoizedAddressTableLookupDecoder;
657
+ }
658
+ var memoizedU8Encoder;
659
+ function getMemoizedU8Encoder() {
660
+ if (!memoizedU8Encoder)
661
+ memoizedU8Encoder = codecsNumbers.getU8Encoder();
662
+ return memoizedU8Encoder;
663
+ }
664
+ var memoizedU8Decoder;
665
+ function getMemoizedU8Decoder() {
666
+ if (!memoizedU8Decoder)
667
+ memoizedU8Decoder = codecsNumbers.getU8Decoder();
668
+ return memoizedU8Decoder;
669
+ }
670
+ function getMessageHeaderEncoder() {
671
+ return codecsDataStructures.getStructEncoder([
672
+ ["numSignerAccounts", getMemoizedU8Encoder()],
673
+ ["numReadonlySignerAccounts", getMemoizedU8Encoder()],
674
+ ["numReadonlyNonSignerAccounts", getMemoizedU8Encoder()]
675
+ ]);
481
676
  }
482
- function getMessageHeaderCodec() {
483
- return umiSerializers.struct(
484
- [
485
- [
486
- "numSignerAccounts",
487
- umiSerializers.u8(
488
- __DEV__ ? {
489
- description: "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction"
490
- } : void 0
491
- )
492
- ],
493
- [
494
- "numReadonlySignerAccounts",
495
- umiSerializers.u8(
496
- __DEV__ ? {
497
- description: "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction, but may not be writable"
498
- } : void 0
499
- )
500
- ],
501
- [
502
- "numReadonlyNonSignerAccounts",
503
- umiSerializers.u8(
504
- __DEV__ ? {
505
- description: "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable"
506
- } : void 0
507
- )
508
- ]
509
- ],
510
- __DEV__ ? {
511
- description: "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses"
512
- } : void 0
513
- );
677
+ function getMessageHeaderDecoder() {
678
+ return codecsDataStructures.getStructDecoder([
679
+ ["numSignerAccounts", getMemoizedU8Decoder()],
680
+ ["numReadonlySignerAccounts", getMemoizedU8Decoder()],
681
+ ["numReadonlyNonSignerAccounts", getMemoizedU8Decoder()]
682
+ ]);
514
683
  }
515
- function getInstructionCodec() {
516
- return umiSerializers.mapSerializer(
517
- umiSerializers.struct([
518
- [
519
- "programAddressIndex",
520
- umiSerializers.u8(
521
- __DEV__ ? {
522
- description: "The index of the program being called, according to the well-ordered accounts list for this transaction"
523
- } : void 0
524
- )
525
- ],
526
- [
527
- "accountIndices",
528
- umiSerializers.array(
529
- umiSerializers.u8({
530
- description: __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : ""
531
- }),
532
- {
533
- description: __DEV__ ? "An optional list of account indices, according to the well-ordered accounts list for this transaction, in the order in which the program being called expects them" : "",
534
- size: umiSerializers.shortU16()
535
- }
536
- )
537
- ],
538
- [
539
- "data",
540
- umiSerializers.bytes({
541
- description: __DEV__ ? "An optional buffer of data passed to the instruction" : "",
542
- size: umiSerializers.shortU16()
543
- })
544
- ]
684
+ var memoizedGetInstructionEncoder;
685
+ function getInstructionEncoder() {
686
+ if (!memoizedGetInstructionEncoder) {
687
+ memoizedGetInstructionEncoder = codecsCore.mapEncoder(
688
+ codecsDataStructures.getStructEncoder([
689
+ ["programAddressIndex", codecsNumbers.getU8Encoder()],
690
+ ["accountIndices", codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), { size: codecsNumbers.getShortU16Encoder() })],
691
+ ["data", codecsDataStructures.getBytesEncoder({ size: codecsNumbers.getShortU16Encoder() })]
692
+ ]),
693
+ // Convert an instruction to have all fields defined
694
+ (instruction) => {
695
+ if (instruction.accountIndices !== void 0 && instruction.data !== void 0) {
696
+ return instruction;
697
+ }
698
+ return {
699
+ ...instruction,
700
+ accountIndices: instruction.accountIndices ?? [],
701
+ data: instruction.data ?? new Uint8Array(0)
702
+ };
703
+ }
704
+ );
705
+ }
706
+ return memoizedGetInstructionEncoder;
707
+ }
708
+ var memoizedGetInstructionDecoder;
709
+ function getInstructionDecoder() {
710
+ if (!memoizedGetInstructionDecoder) {
711
+ memoizedGetInstructionDecoder = codecsCore.mapDecoder(
712
+ codecsDataStructures.getStructDecoder([
713
+ ["programAddressIndex", codecsNumbers.getU8Decoder()],
714
+ ["accountIndices", codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), { size: codecsNumbers.getShortU16Decoder() })],
715
+ ["data", codecsDataStructures.getBytesDecoder({ size: codecsNumbers.getShortU16Decoder() })]
716
+ ]),
717
+ // Convert an instruction to exclude optional fields if they are empty
718
+ (instruction) => {
719
+ if (instruction.accountIndices.length && instruction.data.byteLength) {
720
+ return instruction;
721
+ }
722
+ const { accountIndices, data, ...rest } = instruction;
723
+ return {
724
+ ...rest,
725
+ ...accountIndices.length ? { accountIndices } : null,
726
+ ...data.byteLength ? { data } : null
727
+ };
728
+ }
729
+ );
730
+ }
731
+ return memoizedGetInstructionDecoder;
732
+ }
733
+ var VERSION_FLAG_MASK = 128;
734
+ function getTransactionVersionEncoder() {
735
+ return codecsCore.createEncoder({
736
+ getSizeFromValue: (value) => value === "legacy" ? 0 : 1,
737
+ maxSize: 1,
738
+ write: (value, bytes, offset) => {
739
+ if (value === "legacy") {
740
+ return offset;
741
+ }
742
+ if (value < 0 || value > 127) {
743
+ throw new Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
744
+ }
745
+ bytes.set([value | VERSION_FLAG_MASK], offset);
746
+ return offset + 1;
747
+ }
748
+ });
749
+ }
750
+ function getTransactionVersionDecoder() {
751
+ return codecsCore.createDecoder({
752
+ maxSize: 1,
753
+ read: (bytes, offset) => {
754
+ const firstByte = bytes[offset];
755
+ if ((firstByte & VERSION_FLAG_MASK) === 0) {
756
+ return ["legacy", offset];
757
+ } else {
758
+ const version = firstByte ^ VERSION_FLAG_MASK;
759
+ return [version, offset + 1];
760
+ }
761
+ }
762
+ });
763
+ }
764
+
765
+ // src/serializers/message.ts
766
+ function getCompiledMessageLegacyEncoder() {
767
+ return codecsDataStructures.getStructEncoder(getPreludeStructEncoderTuple());
768
+ }
769
+ function getCompiledMessageVersionedEncoder() {
770
+ return codecsCore.mapEncoder(
771
+ codecsDataStructures.getStructEncoder([
772
+ ...getPreludeStructEncoderTuple(),
773
+ ["addressTableLookups", getAddressTableLookupArrayEncoder()]
545
774
  ]),
546
775
  (value) => {
547
- if (value.accountIndices !== void 0 && value.data !== void 0) {
776
+ if (value.version === "legacy") {
548
777
  return value;
549
778
  }
550
779
  return {
551
780
  ...value,
552
- accountIndices: value.accountIndices ?? [],
553
- data: value.data ?? new Uint8Array(0)
554
- };
555
- },
556
- (value) => {
557
- if (value.accountIndices.length && value.data.byteLength) {
558
- return value;
559
- }
560
- const { accountIndices, data, ...rest } = value;
561
- return {
562
- ...rest,
563
- ...accountIndices.length ? { accountIndices } : null,
564
- ...data.byteLength ? { data } : null
781
+ addressTableLookups: value.addressTableLookups ?? []
565
782
  };
566
783
  }
567
784
  );
568
785
  }
569
-
570
- // src/serializers/unimplemented.ts
571
- function getError(type, name) {
572
- const functionSuffix = name + type[0].toUpperCase() + type.slice(1);
573
- return new Error(
574
- `No ${type} exists for ${name}. Use \`get${functionSuffix}()\` if you need a ${type}, and \`get${name}Codec()\` if you need to both encode and decode ${name}`
575
- );
576
- }
577
- function getUnimplementedDecoder(name) {
578
- return () => {
579
- throw getError("decoder", name);
580
- };
581
- }
582
-
583
- // src/serializers/transaction-version.ts
584
- var VERSION_FLAG_MASK = 128;
585
- var BASE_CONFIG = {
586
- description: __DEV__ ? "A single byte that encodes the version of the transaction" : "",
587
- fixedSize: null,
588
- maxSize: 1
589
- };
590
- function deserialize(bytes3, offset = 0) {
591
- const firstByte = bytes3[offset];
592
- if ((firstByte & VERSION_FLAG_MASK) === 0) {
593
- return ["legacy", offset];
594
- } else {
595
- const version = firstByte ^ VERSION_FLAG_MASK;
596
- return [version, offset + 1];
597
- }
598
- }
599
- function serialize(value) {
600
- if (value === "legacy") {
601
- return new Uint8Array();
602
- }
603
- if (value < 0 || value > 127) {
604
- throw new Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
605
- }
606
- return new Uint8Array([value | VERSION_FLAG_MASK]);
607
- }
608
- function getTransactionVersionCodec() {
609
- return {
610
- ...BASE_CONFIG,
611
- deserialize,
612
- serialize
613
- };
614
- }
615
-
616
- // src/serializers/message.ts
617
- var BASE_CONFIG2 = {
618
- description: __DEV__ ? "The wire format of a Solana transaction message" : "",
619
- fixedSize: null,
620
- maxSize: null
621
- };
622
- function serialize2(compiledMessage) {
623
- if (compiledMessage.version === "legacy") {
624
- return umiSerializers.struct(getPreludeStructSerializerTuple()).serialize(compiledMessage);
625
- } else {
626
- return umiSerializers.mapSerializer(
627
- umiSerializers.struct([
628
- ...getPreludeStructSerializerTuple(),
629
- ["addressTableLookups", getAddressTableLookupsSerializer()]
630
- ]),
631
- (value) => {
632
- if (value.version === "legacy") {
633
- return value;
634
- }
635
- return {
636
- ...value,
637
- addressTableLookups: value.addressTableLookups ?? []
638
- };
639
- }
640
- ).serialize(compiledMessage);
641
- }
786
+ function getPreludeStructEncoderTuple() {
787
+ return [
788
+ ["version", getTransactionVersionEncoder()],
789
+ ["header", getMessageHeaderEncoder()],
790
+ ["staticAccounts", codecsDataStructures.getArrayEncoder(addresses.getAddressEncoder(), { size: codecsNumbers.getShortU16Encoder() })],
791
+ ["lifetimeToken", codecsStrings.getStringEncoder({ encoding: codecsStrings.getBase58Encoder(), size: 32 })],
792
+ ["instructions", codecsDataStructures.getArrayEncoder(getInstructionEncoder(), { size: codecsNumbers.getShortU16Encoder() })]
793
+ ];
642
794
  }
643
- function getPreludeStructSerializerTuple() {
795
+ function getPreludeStructDecoderTuple() {
644
796
  return [
645
- ["version", getTransactionVersionCodec()],
646
- ["header", getMessageHeaderCodec()],
647
- [
648
- "staticAccounts",
649
- umiSerializers.array(addresses.getBase58EncodedAddressCodec(), {
650
- description: __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "",
651
- size: umiSerializers.shortU16()
652
- })
653
- ],
654
- [
655
- "lifetimeToken",
656
- umiSerializers.string({
657
- description: __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "",
658
- encoding: umiSerializers.base58,
659
- size: 32
660
- })
661
- ],
662
- [
663
- "instructions",
664
- umiSerializers.array(getInstructionCodec(), {
665
- description: __DEV__ ? "A compact-array of instructions belonging to this transaction" : "",
666
- size: umiSerializers.shortU16()
667
- })
668
- ]
797
+ ["version", getTransactionVersionDecoder()],
798
+ ["header", getMessageHeaderDecoder()],
799
+ ["staticAccounts", codecsDataStructures.getArrayDecoder(addresses.getAddressDecoder(), { size: codecsNumbers.getShortU16Decoder() })],
800
+ ["lifetimeToken", codecsStrings.getStringDecoder({ encoding: codecsStrings.getBase58Decoder(), size: 32 })],
801
+ ["instructions", codecsDataStructures.getArrayDecoder(getInstructionDecoder(), { size: codecsNumbers.getShortU16Decoder() })],
802
+ ["addressTableLookups", getAddressTableLookupArrayDecoder()]
669
803
  ];
670
804
  }
671
- function getAddressTableLookupsSerializer() {
672
- return umiSerializers.array(getAddressTableLookupCodec(), {
673
- ...__DEV__ ? { description: "A compact array of address table lookups belonging to this transaction" } : null,
674
- size: umiSerializers.shortU16()
675
- });
805
+ function getAddressTableLookupArrayEncoder() {
806
+ return codecsDataStructures.getArrayEncoder(getAddressTableLookupEncoder(), { size: codecsNumbers.getShortU16Encoder() });
807
+ }
808
+ function getAddressTableLookupArrayDecoder() {
809
+ return codecsDataStructures.getArrayDecoder(getAddressTableLookupDecoder(), { size: codecsNumbers.getShortU16Decoder() });
676
810
  }
677
811
  function getCompiledMessageEncoder() {
678
- return {
679
- ...BASE_CONFIG2,
680
- deserialize: getUnimplementedDecoder("CompiledMessage"),
681
- serialize: serialize2
682
- };
812
+ return codecsCore.createEncoder({
813
+ getSizeFromValue: (compiledMessage) => {
814
+ if (compiledMessage.version === "legacy") {
815
+ return getCompiledMessageLegacyEncoder().getSizeFromValue(compiledMessage);
816
+ } else {
817
+ return getCompiledMessageVersionedEncoder().getSizeFromValue(compiledMessage);
818
+ }
819
+ },
820
+ write: (compiledMessage, bytes, offset) => {
821
+ if (compiledMessage.version === "legacy") {
822
+ return getCompiledMessageLegacyEncoder().write(compiledMessage, bytes, offset);
823
+ } else {
824
+ return getCompiledMessageVersionedEncoder().write(compiledMessage, bytes, offset);
825
+ }
826
+ }
827
+ });
683
828
  }
684
-
685
- // src/signatures.ts
686
- async function getCompiledMessageSignature(message, secretKey) {
687
- const wireMessageBytes = getCompiledMessageEncoder().serialize(message);
688
- const signature = await keys.signBytes(secretKey, wireMessageBytes);
689
- return signature;
829
+ function getCompiledMessageDecoder() {
830
+ return codecsCore.mapDecoder(codecsDataStructures.getStructDecoder(getPreludeStructDecoderTuple()), ({ addressTableLookups, ...restOfMessage }) => {
831
+ if (restOfMessage.version === "legacy" || !addressTableLookups?.length) {
832
+ return restOfMessage;
833
+ }
834
+ return { ...restOfMessage, addressTableLookups };
835
+ });
690
836
  }
691
- async function signTransaction(keyPair, transaction) {
692
- const compiledMessage = compileMessage(transaction);
693
- const [signerPublicKey, signature] = await Promise.all([
694
- addresses.getAddressFromPublicKey(keyPair.publicKey),
695
- getCompiledMessageSignature(compiledMessage, keyPair.privateKey)
696
- ]);
697
- const nextSignatures = {
698
- ..."signatures" in transaction ? transaction.signatures : null,
699
- ...{ [signerPublicKey]: signature }
700
- };
701
- const out = {
702
- ...transaction,
703
- signatures: nextSignatures
704
- };
705
- Object.freeze(out);
706
- return out;
837
+ function getCompiledMessageCodec() {
838
+ return codecsCore.combineCodec(getCompiledMessageEncoder(), getCompiledMessageDecoder());
707
839
  }
708
840
 
709
841
  // src/compile-transaction.ts
@@ -725,45 +857,109 @@ function getCompiledTransaction(transaction) {
725
857
  }
726
858
 
727
859
  // src/serializers/transaction.ts
728
- var BASE_CONFIG3 = {
729
- description: __DEV__ ? "The wire format of a Solana transaction" : "",
730
- fixedSize: null,
731
- maxSize: null
732
- };
733
- function serialize3(transaction) {
734
- const compiledTransaction = getCompiledTransaction(transaction);
735
- return umiSerializers.struct([
860
+ function getCompiledTransactionEncoder() {
861
+ return codecsDataStructures.getStructEncoder([
862
+ ["signatures", codecsDataStructures.getArrayEncoder(codecsDataStructures.getBytesEncoder({ size: 64 }), { size: codecsNumbers.getShortU16Encoder() })],
863
+ ["compiledMessage", getCompiledMessageEncoder()]
864
+ ]);
865
+ }
866
+ function getCompiledTransactionDecoder() {
867
+ return codecsDataStructures.getStructDecoder([
736
868
  [
737
869
  "signatures",
738
- umiSerializers.array(umiSerializers.bytes({ size: 64 }), {
739
- ...__DEV__ ? { description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } : null,
740
- size: umiSerializers.shortU16()
870
+ codecsDataStructures.getArrayDecoder(codecsDataStructures.getBytesDecoder({ size: 64 }), {
871
+ size: codecsNumbers.getShortU16Decoder()
741
872
  })
742
873
  ],
743
- ["compiledMessage", getCompiledMessageEncoder()]
744
- ]).serialize(compiledTransaction);
874
+ ["compiledMessage", getCompiledMessageDecoder()]
875
+ ]);
745
876
  }
746
877
  function getTransactionEncoder() {
747
- return {
748
- ...BASE_CONFIG3,
749
- deserialize: getUnimplementedDecoder("CompiledMessage"),
750
- serialize: serialize3
878
+ return codecsCore.mapEncoder(getCompiledTransactionEncoder(), getCompiledTransaction);
879
+ }
880
+ function getTransactionDecoder(config) {
881
+ return codecsCore.mapDecoder(
882
+ getCompiledTransactionDecoder(),
883
+ (compiledTransaction) => decompileTransaction(compiledTransaction, config)
884
+ );
885
+ }
886
+ function getTransactionCodec(config) {
887
+ return codecsCore.combineCodec(getTransactionEncoder(), getTransactionDecoder(config));
888
+ }
889
+ var base58Decoder;
890
+ function getSignatureFromTransaction(transaction) {
891
+ if (!base58Decoder)
892
+ base58Decoder = codecsStrings.getBase58Decoder();
893
+ const signatureBytes = transaction.signatures[transaction.feePayer];
894
+ if (!signatureBytes) {
895
+ throw new Error(
896
+ "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
897
+ );
898
+ }
899
+ const transactionSignature = base58Decoder.decode(signatureBytes);
900
+ return transactionSignature;
901
+ }
902
+ async function partiallySignTransaction(keyPairs, transaction) {
903
+ const compiledMessage = compileMessage(transaction);
904
+ const nextSignatures = "signatures" in transaction ? { ...transaction.signatures } : {};
905
+ const wireMessageBytes = getCompiledMessageEncoder().encode(compiledMessage);
906
+ const publicKeySignaturePairs = await Promise.all(
907
+ keyPairs.map(
908
+ (keyPair) => Promise.all([addresses.getAddressFromPublicKey(keyPair.publicKey), keys.signBytes(keyPair.privateKey, wireMessageBytes)])
909
+ )
910
+ );
911
+ for (const [signerPublicKey, signature] of publicKeySignaturePairs) {
912
+ nextSignatures[signerPublicKey] = signature;
913
+ }
914
+ const out = {
915
+ ...transaction,
916
+ signatures: nextSignatures
751
917
  };
918
+ Object.freeze(out);
919
+ return out;
752
920
  }
753
-
754
- // src/wire-transaction.ts
755
- function getBase64EncodedWireTransaction(transaction) {
756
- const wireTransactionBytes = getTransactionEncoder().serialize(transaction);
757
- {
758
- return Buffer.from(wireTransactionBytes).toString("base64");
921
+ async function signTransaction(keyPairs, transaction) {
922
+ const out = await partiallySignTransaction(keyPairs, transaction);
923
+ assertTransactionIsFullySigned(out);
924
+ Object.freeze(out);
925
+ return out;
926
+ }
927
+ function assertTransactionIsFullySigned(transaction) {
928
+ const signerAddressesFromInstructions = transaction.instructions.flatMap((i) => i.accounts?.filter((a) => isSignerRole(a.role)) ?? []).map((a) => a.address);
929
+ const requiredSigners = /* @__PURE__ */ new Set([transaction.feePayer, ...signerAddressesFromInstructions]);
930
+ const missingSigs = [];
931
+ requiredSigners.forEach((address) => {
932
+ if (!transaction.signatures[address]) {
933
+ missingSigs.push(address);
934
+ }
935
+ });
936
+ if (missingSigs.length > 0) {
937
+ throw new Error("Transaction is missing signatures for addresses: " + missingSigs.join(", "));
759
938
  }
760
939
  }
940
+ function getBase64EncodedWireTransaction(transaction) {
941
+ const wireTransactionBytes = getTransactionEncoder().encode(transaction);
942
+ return codecsStrings.getBase64Decoder().decode(wireTransactionBytes);
943
+ }
761
944
 
762
945
  exports.appendTransactionInstruction = appendTransactionInstruction;
763
- exports.assertIsBlockhash = assertIsBlockhash;
764
946
  exports.assertIsDurableNonceTransaction = assertIsDurableNonceTransaction;
947
+ exports.assertIsTransactionWithBlockhashLifetime = assertIsTransactionWithBlockhashLifetime;
948
+ exports.assertTransactionIsFullySigned = assertTransactionIsFullySigned;
949
+ exports.compileMessage = compileMessage;
765
950
  exports.createTransaction = createTransaction;
951
+ exports.decompileTransaction = decompileTransaction;
766
952
  exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
953
+ exports.getCompiledMessageCodec = getCompiledMessageCodec;
954
+ exports.getCompiledMessageDecoder = getCompiledMessageDecoder;
955
+ exports.getCompiledMessageEncoder = getCompiledMessageEncoder;
956
+ exports.getCompiledTransactionDecoder = getCompiledTransactionDecoder;
957
+ exports.getSignatureFromTransaction = getSignatureFromTransaction;
958
+ exports.getTransactionCodec = getTransactionCodec;
959
+ exports.getTransactionDecoder = getTransactionDecoder;
960
+ exports.getTransactionEncoder = getTransactionEncoder;
961
+ exports.isAdvanceNonceAccountInstruction = isAdvanceNonceAccountInstruction;
962
+ exports.partiallySignTransaction = partiallySignTransaction;
767
963
  exports.prependTransactionInstruction = prependTransactionInstruction;
768
964
  exports.setTransactionFeePayer = setTransactionFeePayer;
769
965
  exports.setTransactionLifetimeUsingBlockhash = setTransactionLifetimeUsingBlockhash;