@solana/transactions 2.0.0-experimental.c2d0ddc → 2.0.0-experimental.c42ccfd

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 +545 -328
  4. package/dist/index.browser.cjs.map +1 -1
  5. package/dist/index.browser.js +532 -330
  6. package/dist/index.browser.js.map +1 -1
  7. package/dist/index.native.js +534 -330
  8. package/dist/index.native.js.map +1 -1
  9. package/dist/index.node.cjs +545 -328
  10. package/dist/index.node.cjs.map +1 -1
  11. package/dist/index.node.js +532 -330
  12. package/dist/index.node.js.map +1 -1
  13. package/dist/types/accounts.d.ts +3 -3
  14. package/dist/types/accounts.d.ts.map +1 -0
  15. package/dist/types/blockhash.d.ts +7 -1
  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 +2 -2
  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 +5 -0
  34. package/dist/types/decompile-transaction.d.ts.map +1 -0
  35. package/dist/types/durable-nonce.d.ts +23 -10
  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 +11 -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 +6 -5
  58. package/dist/types/serializers/transaction.d.ts.map +1 -0
  59. package/dist/types/signatures.d.ts +10 -7
  60. package/dist/types/signatures.d.ts.map +1 -0
  61. package/dist/types/types.d.ts +13 -13
  62. package/dist/types/types.d.ts.map +1 -0
  63. package/dist/types/unsigned-transaction.d.ts +4 -0
  64. package/dist/types/unsigned-transaction.d.ts.map +1 -0
  65. package/dist/types/wire-transaction.d.ts +3 -3
  66. package/dist/types/wire-transaction.d.ts.map +1 -0
  67. package/package.json +26 -22
  68. package/dist/index.development.js +0 -1265
  69. package/dist/index.development.js.map +0 -1
  70. package/dist/index.production.min.js +0 -17
  71. package/dist/types/serializers/unimplemented.d.ts +0 -3
@@ -1,9 +1,32 @@
1
- import { base58, struct, array, bytes, shortU16, mapSerializer, string, u8 } from '@metaplex-foundation/umi-serializers';
2
- import { getBase58EncodedAddressFromPublicKey, signBytes, getBase58EncodedAddressComparator, getBase58EncodedAddressCodec } from '@solana/keys';
1
+ import { getBase58Encoder, getBase58Decoder, getBase64Decoder, getStringEncoder, getStringDecoder } from '@solana/codecs-strings';
2
+ import { getAddressFromPublicKey, getAddressComparator, getAddressEncoder, getAddressDecoder, assertIsAddress } from '@solana/addresses';
3
+ import { createEncoder, mapDecoder, combineCodec, mapEncoder, createDecoder } from '@solana/codecs-core';
4
+ import { getStructDecoder, getStructEncoder, getArrayEncoder, getArrayDecoder, getBytesEncoder, getBytesDecoder } from '@solana/codecs-data-structures';
5
+ import { getShortU16Encoder, getShortU16Decoder, getU8Encoder, getU8Decoder } from '@solana/codecs-numbers';
6
+ import { pipe } from '@solana/functional';
7
+ import { signBytes } from '@solana/keys';
3
8
 
4
- // ../build-scripts/env-shim.ts
5
- var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
9
+ // src/blockhash.ts
10
+
11
+ // src/unsigned-transaction.ts
12
+ function getUnsignedTransaction(transaction) {
13
+ if ("signatures" in transaction) {
14
+ const {
15
+ signatures: _,
16
+ // eslint-disable-line @typescript-eslint/no-unused-vars
17
+ ...unsignedTransaction
18
+ } = transaction;
19
+ return unsignedTransaction;
20
+ } else {
21
+ return transaction;
22
+ }
23
+ }
24
+
25
+ // src/blockhash.ts
26
+ var base58Encoder;
6
27
  function assertIsBlockhash(putativeBlockhash) {
28
+ if (!base58Encoder)
29
+ base58Encoder = getBase58Encoder();
7
30
  try {
8
31
  if (
9
32
  // Lowest value (32 bytes of zeroes)
@@ -12,8 +35,8 @@ function assertIsBlockhash(putativeBlockhash) {
12
35
  ) {
13
36
  throw new Error("Expected input string to decode to a byte array of length 32.");
14
37
  }
15
- const bytes3 = base58.serialize(putativeBlockhash);
16
- const numBytes = bytes3.byteLength;
38
+ const bytes = base58Encoder.encode(putativeBlockhash);
39
+ const numBytes = bytes.byteLength;
17
40
  if (numBytes !== 32) {
18
41
  throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
19
42
  }
@@ -23,6 +46,33 @@ function assertIsBlockhash(putativeBlockhash) {
23
46
  });
24
47
  }
25
48
  }
49
+ function isTransactionWithBlockhashLifetime(transaction) {
50
+ const lifetimeConstraintShapeMatches = "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.blockhash === "string" && typeof transaction.lifetimeConstraint.lastValidBlockHeight === "bigint";
51
+ if (!lifetimeConstraintShapeMatches)
52
+ return false;
53
+ try {
54
+ assertIsBlockhash(transaction.lifetimeConstraint.blockhash);
55
+ return true;
56
+ } catch {
57
+ return false;
58
+ }
59
+ }
60
+ function assertIsTransactionWithBlockhashLifetime(transaction) {
61
+ if (!isTransactionWithBlockhashLifetime(transaction)) {
62
+ throw new Error("Transaction does not have a blockhash lifetime");
63
+ }
64
+ }
65
+ function setTransactionLifetimeUsingBlockhash(blockhashLifetimeConstraint, transaction) {
66
+ if ("lifetimeConstraint" in transaction && transaction.lifetimeConstraint.blockhash === blockhashLifetimeConstraint.blockhash && transaction.lifetimeConstraint.lastValidBlockHeight === blockhashLifetimeConstraint.lastValidBlockHeight) {
67
+ return transaction;
68
+ }
69
+ const out = {
70
+ ...getUnsignedTransaction(transaction),
71
+ lifetimeConstraint: blockhashLifetimeConstraint
72
+ };
73
+ Object.freeze(out);
74
+ return out;
75
+ }
26
76
 
27
77
  // src/create-transaction.ts
28
78
  function createTransaction({
@@ -36,66 +86,6 @@ function createTransaction({
36
86
  return out;
37
87
  }
38
88
 
39
- // src/fee-payer.ts
40
- function setTransactionFeePayer(feePayer, transaction) {
41
- if ("feePayer" in transaction && feePayer === transaction.feePayer) {
42
- return transaction;
43
- }
44
- let out;
45
- if ("signatures" in transaction) {
46
- const {
47
- signatures: _,
48
- // eslint-disable-line @typescript-eslint/no-unused-vars
49
- ...unsignedTransaction
50
- } = transaction;
51
- out = {
52
- ...unsignedTransaction,
53
- feePayer
54
- };
55
- } else {
56
- out = {
57
- ...transaction,
58
- feePayer
59
- };
60
- }
61
- Object.freeze(out);
62
- return out;
63
- }
64
-
65
- // src/instructions.ts
66
- function replaceInstructions(transaction, nextInstructions) {
67
- let out;
68
- if ("signatures" in transaction) {
69
- const {
70
- signatures: _,
71
- // eslint-disable-line @typescript-eslint/no-unused-vars
72
- ...unsignedTransaction
73
- } = transaction;
74
- out = {
75
- ...unsignedTransaction,
76
- instructions: nextInstructions
77
- };
78
- } else {
79
- out = {
80
- ...transaction,
81
- instructions: nextInstructions
82
- };
83
- }
84
- return out;
85
- }
86
- function appendTransactionInstruction(instruction, transaction) {
87
- const nextInstructions = [...transaction.instructions, instruction];
88
- const out = replaceInstructions(transaction, nextInstructions);
89
- Object.freeze(out);
90
- return out;
91
- }
92
- function prependTransactionInstruction(instruction, transaction) {
93
- const nextInstructions = [instruction, ...transaction.instructions];
94
- const out = replaceInstructions(transaction, nextInstructions);
95
- Object.freeze(out);
96
- return out;
97
- }
98
-
99
89
  // ../instructions/dist/index.browser.js
100
90
  var AccountRole = /* @__PURE__ */ ((AccountRole2) => {
101
91
  AccountRole2[AccountRole2["WRITABLE_SIGNER"] = /* 3 */
@@ -118,6 +108,113 @@ function isWritableRole(role) {
118
108
  function mergeRoles(roleA, roleB) {
119
109
  return roleA | roleB;
120
110
  }
111
+
112
+ // src/durable-nonce.ts
113
+ var RECENT_BLOCKHASHES_SYSVAR_ADDRESS = "SysvarRecentB1ockHashes11111111111111111111";
114
+ var SYSTEM_PROGRAM_ADDRESS = "11111111111111111111111111111111";
115
+ function assertIsDurableNonceTransaction(transaction) {
116
+ if (!isDurableNonceTransaction(transaction)) {
117
+ throw new Error("Transaction is not a durable nonce transaction");
118
+ }
119
+ }
120
+ function createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress) {
121
+ return {
122
+ accounts: [
123
+ { address: nonceAccountAddress, role: AccountRole.WRITABLE },
124
+ {
125
+ address: RECENT_BLOCKHASHES_SYSVAR_ADDRESS,
126
+ role: AccountRole.READONLY
127
+ },
128
+ { address: nonceAuthorityAddress, role: AccountRole.READONLY_SIGNER }
129
+ ],
130
+ data: new Uint8Array([4, 0, 0, 0]),
131
+ programAddress: SYSTEM_PROGRAM_ADDRESS
132
+ };
133
+ }
134
+ function isAdvanceNonceAccountInstruction(instruction) {
135
+ return instruction.programAddress === SYSTEM_PROGRAM_ADDRESS && // Test for `AdvanceNonceAccount` instruction data
136
+ instruction.data != null && isAdvanceNonceAccountInstructionData(instruction.data) && // Test for exactly 3 accounts
137
+ instruction.accounts?.length === 3 && // First account is nonce account address
138
+ instruction.accounts[0].address != null && instruction.accounts[0].role === AccountRole.WRITABLE && // Second account is recent blockhashes sysvar
139
+ instruction.accounts[1].address === RECENT_BLOCKHASHES_SYSVAR_ADDRESS && instruction.accounts[1].role === AccountRole.READONLY && // Third account is nonce authority account
140
+ instruction.accounts[2].address != null && isSignerRole(instruction.accounts[2].role);
141
+ }
142
+ function isAdvanceNonceAccountInstructionData(data) {
143
+ return data.byteLength === 4 && data[0] === 4 && data[1] === 0 && data[2] === 0 && data[3] === 0;
144
+ }
145
+ function isDurableNonceTransaction(transaction) {
146
+ return "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.nonce === "string" && transaction.instructions[0] != null && isAdvanceNonceAccountInstruction(transaction.instructions[0]);
147
+ }
148
+ function isAdvanceNonceAccountInstructionForNonce(instruction, nonceAccountAddress, nonceAuthorityAddress) {
149
+ return instruction.accounts[0].address === nonceAccountAddress && instruction.accounts[2].address === nonceAuthorityAddress;
150
+ }
151
+ function setTransactionLifetimeUsingDurableNonce({
152
+ nonce,
153
+ nonceAccountAddress,
154
+ nonceAuthorityAddress
155
+ }, transaction) {
156
+ let newInstructions;
157
+ const firstInstruction = transaction.instructions[0];
158
+ if (firstInstruction && isAdvanceNonceAccountInstruction(firstInstruction)) {
159
+ if (isAdvanceNonceAccountInstructionForNonce(firstInstruction, nonceAccountAddress, nonceAuthorityAddress)) {
160
+ if (isDurableNonceTransaction(transaction) && transaction.lifetimeConstraint.nonce === nonce) {
161
+ return transaction;
162
+ } else {
163
+ newInstructions = [firstInstruction, ...transaction.instructions.slice(1)];
164
+ }
165
+ } else {
166
+ newInstructions = [
167
+ createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
168
+ ...transaction.instructions.slice(1)
169
+ ];
170
+ }
171
+ } else {
172
+ newInstructions = [
173
+ createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
174
+ ...transaction.instructions
175
+ ];
176
+ }
177
+ const out = {
178
+ ...getUnsignedTransaction(transaction),
179
+ instructions: newInstructions,
180
+ lifetimeConstraint: {
181
+ nonce
182
+ }
183
+ };
184
+ Object.freeze(out);
185
+ return out;
186
+ }
187
+
188
+ // src/fee-payer.ts
189
+ function setTransactionFeePayer(feePayer, transaction) {
190
+ if ("feePayer" in transaction && feePayer === transaction.feePayer) {
191
+ return transaction;
192
+ }
193
+ const out = {
194
+ ...getUnsignedTransaction(transaction),
195
+ feePayer
196
+ };
197
+ Object.freeze(out);
198
+ return out;
199
+ }
200
+
201
+ // src/instructions.ts
202
+ function appendTransactionInstruction(instruction, transaction) {
203
+ const out = {
204
+ ...getUnsignedTransaction(transaction),
205
+ instructions: [...transaction.instructions, instruction]
206
+ };
207
+ Object.freeze(out);
208
+ return out;
209
+ }
210
+ function prependTransactionInstruction(instruction, transaction) {
211
+ const out = {
212
+ ...getUnsignedTransaction(transaction),
213
+ instructions: [instruction, ...transaction.instructions]
214
+ };
215
+ Object.freeze(out);
216
+ return out;
217
+ }
121
218
  function upsert(addressMap, address, update) {
122
219
  addressMap[address] = update(addressMap[address] ?? { role: AccountRole.READONLY });
123
220
  }
@@ -170,7 +267,7 @@ function getAddressMapFromInstructions(feePayer, instructions) {
170
267
  const shouldReplaceEntry = (
171
268
  // Consider using the new LOOKUP_TABLE if its address is different...
172
269
  entry.lookupTableAddress !== accountMeta.lookupTableAddress && // ...and sorts before the existing one.
173
- (addressComparator || (addressComparator = getBase58EncodedAddressComparator()))(
270
+ (addressComparator ||= getAddressComparator())(
174
271
  accountMeta.lookupTableAddress,
175
272
  entry.lookupTableAddress
176
273
  ) < 0
@@ -276,7 +373,7 @@ function getOrderedAccountsFromAddressMap(addressMap) {
276
373
  if (leftIsWritable !== isWritableRole(rightEntry.role)) {
277
374
  return leftIsWritable ? -1 : 1;
278
375
  }
279
- addressComparator || (addressComparator = getBase58EncodedAddressComparator());
376
+ addressComparator ||= getAddressComparator();
280
377
  if (leftEntry[TYPE] === 1 /* LOOKUP_TABLE */ && rightEntry[TYPE] === 1 /* LOOKUP_TABLE */ && leftEntry.lookupTableAddress !== rightEntry.lookupTableAddress) {
281
378
  return addressComparator(leftEntry.lookupTableAddress, rightEntry.lookupTableAddress);
282
379
  } else {
@@ -289,23 +386,22 @@ function getOrderedAccountsFromAddressMap(addressMap) {
289
386
  return orderedAccounts;
290
387
  }
291
388
  function getCompiledAddressTableLookups(orderedAccounts) {
292
- var _a;
293
389
  const index = {};
294
390
  for (const account of orderedAccounts) {
295
391
  if (!("lookupTableAddress" in account)) {
296
392
  continue;
297
393
  }
298
- const entry = index[_a = account.lookupTableAddress] || (index[_a] = {
394
+ const entry = index[account.lookupTableAddress] ||= {
299
395
  readableIndices: [],
300
396
  writableIndices: []
301
- });
397
+ };
302
398
  if (account.role === AccountRole.WRITABLE) {
303
399
  entry.writableIndices.push(account.addressIndex);
304
400
  } else {
305
401
  entry.readableIndices.push(account.addressIndex);
306
402
  }
307
403
  }
308
- return Object.keys(index).sort(getBase58EncodedAddressComparator()).map((lookupTableAddress) => ({
404
+ return Object.keys(index).sort(getAddressComparator()).map((lookupTableAddress) => ({
309
405
  lookupTableAddress,
310
406
  ...index[lookupTableAddress]
311
407
  }));
@@ -384,266 +480,215 @@ function compileMessage(transaction) {
384
480
  version: transaction.version
385
481
  };
386
482
  }
387
- function getAddressTableLookupCodec() {
388
- return struct(
389
- [
390
- [
391
- "lookupTableAddress",
392
- getBase58EncodedAddressCodec(
393
- __DEV__ ? {
394
- description: "The address of the address lookup table account from which instruction addresses should be looked up"
395
- } : void 0
396
- )
397
- ],
483
+ var memoizedAddressTableLookupEncoder;
484
+ function getAddressTableLookupEncoder() {
485
+ if (!memoizedAddressTableLookupEncoder) {
486
+ memoizedAddressTableLookupEncoder = getStructEncoder([
487
+ ["lookupTableAddress", getAddressEncoder()],
398
488
  [
399
489
  "writableIndices",
400
- array(u8(), {
401
- ...__DEV__ ? {
402
- description: "The indices of the accounts in the lookup table that should be loaded as writeable"
403
- } : null,
404
- size: shortU16()
405
- })
490
+ getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })
406
491
  ],
407
492
  [
408
493
  "readableIndices",
409
- array(u8(), {
410
- ...__DEV__ ? {
411
- description: "The indices of the accounts in the lookup table that should be loaded as read-only"
412
- } : void 0,
413
- size: shortU16()
414
- })
494
+ getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })
415
495
  ]
416
- ],
417
- __DEV__ ? {
418
- 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"
419
- } : void 0
420
- );
496
+ ]);
497
+ }
498
+ return memoizedAddressTableLookupEncoder;
499
+ }
500
+ var memoizedAddressTableLookupDecoder;
501
+ function getAddressTableLookupDecoder() {
502
+ if (!memoizedAddressTableLookupDecoder) {
503
+ memoizedAddressTableLookupDecoder = getStructDecoder([
504
+ ["lookupTableAddress", getAddressDecoder()],
505
+ ["writableIndices", getArrayDecoder(getU8Decoder(), { size: getShortU16Decoder() })],
506
+ ["readableIndices", getArrayDecoder(getU8Decoder(), { size: getShortU16Decoder() })]
507
+ ]);
508
+ }
509
+ return memoizedAddressTableLookupDecoder;
510
+ }
511
+ var memoizedU8Encoder;
512
+ function getMemoizedU8Encoder() {
513
+ if (!memoizedU8Encoder)
514
+ memoizedU8Encoder = getU8Encoder();
515
+ return memoizedU8Encoder;
516
+ }
517
+ var memoizedU8Decoder;
518
+ function getMemoizedU8Decoder() {
519
+ if (!memoizedU8Decoder)
520
+ memoizedU8Decoder = getU8Decoder();
521
+ return memoizedU8Decoder;
522
+ }
523
+ function getMessageHeaderEncoder() {
524
+ return getStructEncoder([
525
+ ["numSignerAccounts", getMemoizedU8Encoder()],
526
+ ["numReadonlySignerAccounts", getMemoizedU8Encoder()],
527
+ ["numReadonlyNonSignerAccounts", getMemoizedU8Encoder()]
528
+ ]);
421
529
  }
422
- function getMessageHeaderCodec() {
423
- return struct(
424
- [
425
- [
426
- "numSignerAccounts",
427
- u8(
428
- __DEV__ ? {
429
- description: "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction"
430
- } : void 0
431
- )
432
- ],
433
- [
434
- "numReadonlySignerAccounts",
435
- u8(
436
- __DEV__ ? {
437
- 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"
438
- } : void 0
439
- )
440
- ],
441
- [
442
- "numReadonlyNonSignerAccounts",
443
- u8(
444
- __DEV__ ? {
445
- description: "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable"
446
- } : void 0
447
- )
448
- ]
449
- ],
450
- __DEV__ ? {
451
- description: "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses"
452
- } : void 0
453
- );
530
+ function getMessageHeaderDecoder() {
531
+ return getStructDecoder([
532
+ ["numSignerAccounts", getMemoizedU8Decoder()],
533
+ ["numReadonlySignerAccounts", getMemoizedU8Decoder()],
534
+ ["numReadonlyNonSignerAccounts", getMemoizedU8Decoder()]
535
+ ]);
454
536
  }
455
- function getInstructionCodec() {
456
- return mapSerializer(
457
- struct([
458
- [
459
- "programAddressIndex",
460
- u8(
461
- __DEV__ ? {
462
- description: "The index of the program being called, according to the well-ordered accounts list for this transaction"
463
- } : void 0
464
- )
465
- ],
466
- [
467
- "addressIndices",
468
- array(
469
- u8({
470
- description: __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : ""
471
- }),
472
- {
473
- 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" : "",
474
- size: shortU16()
475
- }
476
- )
477
- ],
478
- [
479
- "data",
480
- bytes({
481
- description: __DEV__ ? "An optional buffer of data passed to the instruction" : "",
482
- size: shortU16()
483
- })
484
- ]
537
+ var memoizedGetInstructionEncoder;
538
+ function getInstructionEncoder() {
539
+ if (!memoizedGetInstructionEncoder) {
540
+ memoizedGetInstructionEncoder = mapEncoder(
541
+ getStructEncoder([
542
+ ["programAddressIndex", getU8Encoder()],
543
+ ["accountIndices", getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })],
544
+ ["data", getBytesEncoder({ size: getShortU16Encoder() })]
545
+ ]),
546
+ // Convert an instruction to have all fields defined
547
+ (instruction) => {
548
+ if (instruction.accountIndices !== void 0 && instruction.data !== void 0) {
549
+ return instruction;
550
+ }
551
+ return {
552
+ ...instruction,
553
+ accountIndices: instruction.accountIndices ?? [],
554
+ data: instruction.data ?? new Uint8Array(0)
555
+ };
556
+ }
557
+ );
558
+ }
559
+ return memoizedGetInstructionEncoder;
560
+ }
561
+ var memoizedGetInstructionDecoder;
562
+ function getInstructionDecoder() {
563
+ if (!memoizedGetInstructionDecoder) {
564
+ memoizedGetInstructionDecoder = mapDecoder(
565
+ getStructDecoder([
566
+ ["programAddressIndex", getU8Decoder()],
567
+ ["accountIndices", getArrayDecoder(getU8Decoder(), { size: getShortU16Decoder() })],
568
+ ["data", getBytesDecoder({ size: getShortU16Decoder() })]
569
+ ]),
570
+ // Convert an instruction to exclude optional fields if they are empty
571
+ (instruction) => {
572
+ if (instruction.accountIndices.length && instruction.data.byteLength) {
573
+ return instruction;
574
+ }
575
+ const { accountIndices, data, ...rest } = instruction;
576
+ return {
577
+ ...rest,
578
+ ...accountIndices.length ? { accountIndices } : null,
579
+ ...data.byteLength ? { data } : null
580
+ };
581
+ }
582
+ );
583
+ }
584
+ return memoizedGetInstructionDecoder;
585
+ }
586
+ var VERSION_FLAG_MASK = 128;
587
+ function getTransactionVersionEncoder() {
588
+ return createEncoder({
589
+ getSizeFromValue: (value) => value === "legacy" ? 0 : 1,
590
+ maxSize: 1,
591
+ write: (value, bytes, offset) => {
592
+ if (value === "legacy") {
593
+ return offset;
594
+ }
595
+ if (value < 0 || value > 127) {
596
+ throw new Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
597
+ }
598
+ bytes.set([value | VERSION_FLAG_MASK], offset);
599
+ return offset + 1;
600
+ }
601
+ });
602
+ }
603
+ function getTransactionVersionDecoder() {
604
+ return createDecoder({
605
+ maxSize: 1,
606
+ read: (bytes, offset) => {
607
+ const firstByte = bytes[offset];
608
+ if ((firstByte & VERSION_FLAG_MASK) === 0) {
609
+ return ["legacy", offset];
610
+ } else {
611
+ const version = firstByte ^ VERSION_FLAG_MASK;
612
+ return [version, offset + 1];
613
+ }
614
+ }
615
+ });
616
+ }
617
+
618
+ // src/serializers/message.ts
619
+ function getCompiledMessageLegacyEncoder() {
620
+ return getStructEncoder(getPreludeStructEncoderTuple());
621
+ }
622
+ function getCompiledMessageVersionedEncoder() {
623
+ return mapEncoder(
624
+ getStructEncoder([
625
+ ...getPreludeStructEncoderTuple(),
626
+ ["addressTableLookups", getAddressTableLookupArrayEncoder()]
485
627
  ]),
486
628
  (value) => {
487
- if (value.addressIndices !== void 0 && value.data !== void 0) {
629
+ if (value.version === "legacy") {
488
630
  return value;
489
631
  }
490
632
  return {
491
633
  ...value,
492
- addressIndices: value.addressIndices ?? [],
493
- data: value.data ?? new Uint8Array(0)
494
- };
495
- },
496
- (value) => {
497
- if (value.addressIndices.length && value.data.byteLength) {
498
- return value;
499
- }
500
- const { addressIndices, data, ...rest } = value;
501
- return {
502
- ...rest,
503
- ...addressIndices.length ? { addressIndices } : null,
504
- ...data.byteLength ? { data } : null
634
+ addressTableLookups: value.addressTableLookups ?? []
505
635
  };
506
636
  }
507
637
  );
508
638
  }
509
-
510
- // src/serializers/unimplemented.ts
511
- function getError(type, name) {
512
- const functionSuffix = name + type[0].toUpperCase() + type.slice(1);
513
- return new Error(
514
- `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}`
515
- );
516
- }
517
- function getUnimplementedDecoder(name) {
518
- return () => {
519
- throw getError("decoder", name);
520
- };
521
- }
522
-
523
- // src/serializers/transaction-version.ts
524
- var VERSION_FLAG_MASK = 128;
525
- var BASE_CONFIG = {
526
- description: __DEV__ ? "A single byte that encodes the version of the transaction" : "",
527
- fixedSize: null,
528
- maxSize: 1
529
- };
530
- function deserialize(bytes3, offset = 0) {
531
- const firstByte = bytes3[offset];
532
- if ((firstByte & VERSION_FLAG_MASK) === 0) {
533
- return ["legacy", offset];
534
- } else {
535
- const version = firstByte ^ VERSION_FLAG_MASK;
536
- return [version, offset + 1];
537
- }
538
- }
539
- function serialize(value) {
540
- if (value === "legacy") {
541
- return new Uint8Array();
542
- }
543
- if (value < 0 || value > 127) {
544
- throw new Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
545
- }
546
- return new Uint8Array([value | VERSION_FLAG_MASK]);
547
- }
548
- function getTransactionVersionCodec() {
549
- return {
550
- ...BASE_CONFIG,
551
- deserialize,
552
- serialize
553
- };
554
- }
555
-
556
- // src/serializers/message.ts
557
- var BASE_CONFIG2 = {
558
- description: __DEV__ ? "The wire format of a Solana transaction message" : "",
559
- fixedSize: null,
560
- maxSize: null
561
- };
562
- function serialize2(compiledMessage) {
563
- if (compiledMessage.version === "legacy") {
564
- return struct(getPreludeStructSerializerTuple()).serialize(compiledMessage);
565
- } else {
566
- return mapSerializer(
567
- struct([
568
- ...getPreludeStructSerializerTuple(),
569
- ["addressTableLookups", getAddressTableLookupsSerializer()]
570
- ]),
571
- (value) => {
572
- if (value.version === "legacy") {
573
- return value;
574
- }
575
- return {
576
- ...value,
577
- addressTableLookups: value.addressTableLookups ?? []
578
- };
579
- }
580
- ).serialize(compiledMessage);
581
- }
639
+ function getPreludeStructEncoderTuple() {
640
+ return [
641
+ ["version", getTransactionVersionEncoder()],
642
+ ["header", getMessageHeaderEncoder()],
643
+ ["staticAccounts", getArrayEncoder(getAddressEncoder(), { size: getShortU16Encoder() })],
644
+ ["lifetimeToken", getStringEncoder({ encoding: getBase58Encoder(), size: 32 })],
645
+ ["instructions", getArrayEncoder(getInstructionEncoder(), { size: getShortU16Encoder() })]
646
+ ];
582
647
  }
583
- function getPreludeStructSerializerTuple() {
648
+ function getPreludeStructDecoderTuple() {
584
649
  return [
585
- ["version", getTransactionVersionCodec()],
586
- ["header", getMessageHeaderCodec()],
587
- [
588
- "staticAccounts",
589
- array(getBase58EncodedAddressCodec(), {
590
- description: __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "",
591
- size: shortU16()
592
- })
593
- ],
594
- [
595
- "lifetimeToken",
596
- string({
597
- description: __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "",
598
- encoding: base58,
599
- size: 32
600
- })
601
- ],
602
- [
603
- "instructions",
604
- array(getInstructionCodec(), {
605
- description: __DEV__ ? "A compact-array of instructions belonging to this transaction" : "",
606
- size: shortU16()
607
- })
608
- ]
650
+ ["version", getTransactionVersionDecoder()],
651
+ ["header", getMessageHeaderDecoder()],
652
+ ["staticAccounts", getArrayDecoder(getAddressDecoder(), { size: getShortU16Decoder() })],
653
+ ["lifetimeToken", getStringDecoder({ encoding: getBase58Decoder(), size: 32 })],
654
+ ["instructions", getArrayDecoder(getInstructionDecoder(), { size: getShortU16Decoder() })],
655
+ ["addressTableLookups", getAddressTableLookupArrayDecoder()]
609
656
  ];
610
657
  }
611
- function getAddressTableLookupsSerializer() {
612
- return array(getAddressTableLookupCodec(), {
613
- ...__DEV__ ? { description: "A compact array of address table lookups belonging to this transaction" } : null,
614
- size: shortU16()
615
- });
658
+ function getAddressTableLookupArrayEncoder() {
659
+ return getArrayEncoder(getAddressTableLookupEncoder(), { size: getShortU16Encoder() });
660
+ }
661
+ function getAddressTableLookupArrayDecoder() {
662
+ return getArrayDecoder(getAddressTableLookupDecoder(), { size: getShortU16Decoder() });
616
663
  }
617
664
  function getCompiledMessageEncoder() {
618
- return {
619
- ...BASE_CONFIG2,
620
- deserialize: getUnimplementedDecoder("CompiledMessage"),
621
- serialize: serialize2
622
- };
665
+ return createEncoder({
666
+ getSizeFromValue: (compiledMessage) => {
667
+ if (compiledMessage.version === "legacy") {
668
+ return getCompiledMessageLegacyEncoder().getSizeFromValue(compiledMessage);
669
+ } else {
670
+ return getCompiledMessageVersionedEncoder().getSizeFromValue(compiledMessage);
671
+ }
672
+ },
673
+ write: (compiledMessage, bytes, offset) => {
674
+ if (compiledMessage.version === "legacy") {
675
+ return getCompiledMessageLegacyEncoder().write(compiledMessage, bytes, offset);
676
+ } else {
677
+ return getCompiledMessageVersionedEncoder().write(compiledMessage, bytes, offset);
678
+ }
679
+ }
680
+ });
623
681
  }
624
-
625
- // src/signatures.ts
626
- async function getCompiledMessageSignature(message, secretKey) {
627
- const wireMessageBytes = getCompiledMessageEncoder().serialize(message);
628
- const signature = await signBytes(secretKey, wireMessageBytes);
629
- return signature;
682
+ function getCompiledMessageDecoder() {
683
+ return mapDecoder(getStructDecoder(getPreludeStructDecoderTuple()), ({ addressTableLookups, ...restOfMessage }) => {
684
+ if (restOfMessage.version === "legacy" || !addressTableLookups?.length) {
685
+ return restOfMessage;
686
+ }
687
+ return { ...restOfMessage, addressTableLookups };
688
+ });
630
689
  }
631
- async function signTransaction(keyPair, transaction) {
632
- const compiledMessage = compileMessage(transaction);
633
- const [signerPublicKey, signature] = await Promise.all([
634
- getBase58EncodedAddressFromPublicKey(keyPair.publicKey),
635
- getCompiledMessageSignature(compiledMessage, keyPair.privateKey)
636
- ]);
637
- const nextSignatures = {
638
- ..."signatures" in transaction ? transaction.signatures : null,
639
- ...{ [signerPublicKey]: signature }
640
- };
641
- const out = {
642
- ...transaction,
643
- signatures: nextSignatures
644
- };
645
- Object.freeze(out);
646
- return out;
690
+ function getCompiledMessageCodec() {
691
+ return combineCodec(getCompiledMessageEncoder(), getCompiledMessageDecoder());
647
692
  }
648
693
 
649
694
  // src/compile-transaction.ts
@@ -663,42 +708,199 @@ function getCompiledTransaction(transaction) {
663
708
  signatures
664
709
  };
665
710
  }
711
+ function getAccountMetas(message) {
712
+ const { header } = message;
713
+ const numWritableSignerAccounts = header.numSignerAccounts - header.numReadonlySignerAccounts;
714
+ const numWritableNonSignerAccounts = message.staticAccounts.length - header.numSignerAccounts - header.numReadonlyNonSignerAccounts;
715
+ const accountMetas = [];
716
+ let accountIndex = 0;
717
+ for (let i = 0; i < numWritableSignerAccounts; i++) {
718
+ accountMetas.push({
719
+ address: message.staticAccounts[accountIndex],
720
+ role: AccountRole.WRITABLE_SIGNER
721
+ });
722
+ accountIndex++;
723
+ }
724
+ for (let i = 0; i < header.numReadonlySignerAccounts; i++) {
725
+ accountMetas.push({
726
+ address: message.staticAccounts[accountIndex],
727
+ role: AccountRole.READONLY_SIGNER
728
+ });
729
+ accountIndex++;
730
+ }
731
+ for (let i = 0; i < numWritableNonSignerAccounts; i++) {
732
+ accountMetas.push({
733
+ address: message.staticAccounts[accountIndex],
734
+ role: AccountRole.WRITABLE
735
+ });
736
+ accountIndex++;
737
+ }
738
+ for (let i = 0; i < header.numReadonlyNonSignerAccounts; i++) {
739
+ accountMetas.push({
740
+ address: message.staticAccounts[accountIndex],
741
+ role: AccountRole.READONLY
742
+ });
743
+ accountIndex++;
744
+ }
745
+ return accountMetas;
746
+ }
747
+ function convertInstruction(instruction, accountMetas) {
748
+ const programAddress = accountMetas[instruction.programAddressIndex]?.address;
749
+ if (!programAddress) {
750
+ throw new Error(`Could not find program address at index ${instruction.programAddressIndex}`);
751
+ }
752
+ const accounts = instruction.accountIndices?.map((accountIndex) => accountMetas[accountIndex]);
753
+ const { data } = instruction;
754
+ return {
755
+ programAddress,
756
+ ...accounts && accounts.length ? { accounts } : {},
757
+ ...data && data.length ? { data } : {}
758
+ };
759
+ }
760
+ function getLifetimeConstraint(messageLifetimeToken, firstInstruction, lastValidBlockHeight) {
761
+ if (!firstInstruction || !isAdvanceNonceAccountInstruction(firstInstruction)) {
762
+ return {
763
+ blockhash: messageLifetimeToken,
764
+ lastValidBlockHeight: lastValidBlockHeight ?? 2n ** 64n - 1n
765
+ // U64 MAX
766
+ };
767
+ } else {
768
+ const nonceAccountAddress = firstInstruction.accounts[0].address;
769
+ assertIsAddress(nonceAccountAddress);
770
+ const nonceAuthorityAddress = firstInstruction.accounts[2].address;
771
+ assertIsAddress(nonceAuthorityAddress);
772
+ return {
773
+ nonce: messageLifetimeToken,
774
+ nonceAccountAddress,
775
+ nonceAuthorityAddress
776
+ };
777
+ }
778
+ }
779
+ function convertSignatures(compiledTransaction) {
780
+ const {
781
+ compiledMessage: { staticAccounts },
782
+ signatures
783
+ } = compiledTransaction;
784
+ return signatures.reduce((acc, sig, index) => {
785
+ const allZeros = sig.every((byte) => byte === 0);
786
+ if (allZeros)
787
+ return acc;
788
+ const address = staticAccounts[index];
789
+ return { ...acc, [address]: sig };
790
+ }, {});
791
+ }
792
+ function decompileTransaction(compiledTransaction, lastValidBlockHeight) {
793
+ const { compiledMessage } = compiledTransaction;
794
+ if ("addressTableLookups" in compiledMessage && compiledMessage.addressTableLookups.length > 0) {
795
+ throw new Error("Cannot convert transaction with addressTableLookups");
796
+ }
797
+ const feePayer = compiledMessage.staticAccounts[0];
798
+ if (!feePayer)
799
+ throw new Error("No fee payer set in CompiledTransaction");
800
+ const accountMetas = getAccountMetas(compiledMessage);
801
+ const instructions = compiledMessage.instructions.map(
802
+ (compiledInstruction) => convertInstruction(compiledInstruction, accountMetas)
803
+ );
804
+ const firstInstruction = instructions[0];
805
+ const lifetimeConstraint = getLifetimeConstraint(
806
+ compiledMessage.lifetimeToken,
807
+ firstInstruction,
808
+ lastValidBlockHeight
809
+ );
810
+ const signatures = convertSignatures(compiledTransaction);
811
+ return pipe(
812
+ createTransaction({ version: compiledMessage.version }),
813
+ (tx) => setTransactionFeePayer(feePayer, tx),
814
+ (tx) => instructions.reduce((acc, instruction) => {
815
+ return appendTransactionInstruction(instruction, acc);
816
+ }, tx),
817
+ (tx) => "blockhash" in lifetimeConstraint ? setTransactionLifetimeUsingBlockhash(lifetimeConstraint, tx) : setTransactionLifetimeUsingDurableNonce(lifetimeConstraint, tx),
818
+ (tx) => compiledTransaction.signatures.length ? { ...tx, signatures } : tx
819
+ );
820
+ }
666
821
 
667
822
  // src/serializers/transaction.ts
668
- var BASE_CONFIG3 = {
669
- description: __DEV__ ? "The wire format of a Solana transaction" : "",
670
- fixedSize: null,
671
- maxSize: null
672
- };
673
- function serialize3(transaction) {
674
- const compiledTransaction = getCompiledTransaction(transaction);
675
- return struct([
823
+ function getCompiledTransactionEncoder() {
824
+ return getStructEncoder([
825
+ ["signatures", getArrayEncoder(getBytesEncoder({ size: 64 }), { size: getShortU16Encoder() })],
826
+ ["compiledMessage", getCompiledMessageEncoder()]
827
+ ]);
828
+ }
829
+ function getCompiledTransactionDecoder() {
830
+ return getStructDecoder([
676
831
  [
677
832
  "signatures",
678
- array(bytes({ size: 64 }), {
679
- ...__DEV__ ? { description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } : null,
680
- size: shortU16()
833
+ getArrayDecoder(getBytesDecoder({ size: 64 }), {
834
+ size: getShortU16Decoder()
681
835
  })
682
836
  ],
683
- ["compiledMessage", getCompiledMessageEncoder()]
684
- ]).serialize(compiledTransaction);
837
+ ["compiledMessage", getCompiledMessageDecoder()]
838
+ ]);
685
839
  }
686
840
  function getTransactionEncoder() {
687
- return {
688
- ...BASE_CONFIG3,
689
- deserialize: getUnimplementedDecoder("CompiledMessage"),
690
- serialize: serialize3
841
+ return mapEncoder(getCompiledTransactionEncoder(), getCompiledTransaction);
842
+ }
843
+ function getTransactionDecoder(lastValidBlockHeight) {
844
+ return mapDecoder(
845
+ getCompiledTransactionDecoder(),
846
+ (compiledTransaction) => decompileTransaction(compiledTransaction, lastValidBlockHeight)
847
+ );
848
+ }
849
+ function getTransactionCodec(lastValidBlockHeight) {
850
+ return combineCodec(getTransactionEncoder(), getTransactionDecoder(lastValidBlockHeight));
851
+ }
852
+ var base58Decoder;
853
+ function getSignatureFromTransaction(transaction) {
854
+ if (!base58Decoder)
855
+ base58Decoder = getBase58Decoder();
856
+ const signatureBytes = transaction.signatures[transaction.feePayer];
857
+ if (!signatureBytes) {
858
+ throw new Error(
859
+ "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
860
+ );
861
+ }
862
+ const transactionSignature = base58Decoder.decode(signatureBytes);
863
+ return transactionSignature;
864
+ }
865
+ async function partiallySignTransaction(keyPairs, transaction) {
866
+ const compiledMessage = compileMessage(transaction);
867
+ const nextSignatures = "signatures" in transaction ? { ...transaction.signatures } : {};
868
+ const wireMessageBytes = getCompiledMessageEncoder().encode(compiledMessage);
869
+ const publicKeySignaturePairs = await Promise.all(
870
+ keyPairs.map(
871
+ (keyPair) => Promise.all([getAddressFromPublicKey(keyPair.publicKey), signBytes(keyPair.privateKey, wireMessageBytes)])
872
+ )
873
+ );
874
+ for (const [signerPublicKey, signature] of publicKeySignaturePairs) {
875
+ nextSignatures[signerPublicKey] = signature;
876
+ }
877
+ const out = {
878
+ ...transaction,
879
+ signatures: nextSignatures
691
880
  };
881
+ Object.freeze(out);
882
+ return out;
883
+ }
884
+ async function signTransaction(keyPairs, transaction) {
885
+ const out = await partiallySignTransaction(keyPairs, transaction);
886
+ assertTransactionIsFullySigned(out);
887
+ Object.freeze(out);
888
+ return out;
889
+ }
890
+ function assertTransactionIsFullySigned(transaction) {
891
+ const signerAddressesFromInstructions = transaction.instructions.flatMap((i) => i.accounts?.filter((a) => isSignerRole(a.role)) ?? []).map((a) => a.address);
892
+ const requiredSigners = /* @__PURE__ */ new Set([transaction.feePayer, ...signerAddressesFromInstructions]);
893
+ requiredSigners.forEach((address) => {
894
+ if (!transaction.signatures[address]) {
895
+ throw new Error(`Transaction is missing signature for address \`${address}\``);
896
+ }
897
+ });
692
898
  }
693
-
694
- // src/wire-transaction.ts
695
899
  function getBase64EncodedWireTransaction(transaction) {
696
- const wireTransactionBytes = getTransactionEncoder().serialize(transaction);
697
- {
698
- return btoa(String.fromCharCode(...wireTransactionBytes));
699
- }
900
+ const wireTransactionBytes = getTransactionEncoder().encode(transaction);
901
+ return getBase64Decoder().decode(wireTransactionBytes);
700
902
  }
701
903
 
702
- export { appendTransactionInstruction, assertIsBlockhash, createTransaction, getBase64EncodedWireTransaction, prependTransactionInstruction, setTransactionFeePayer, signTransaction };
904
+ export { appendTransactionInstruction, assertIsBlockhash, assertIsDurableNonceTransaction, assertIsTransactionWithBlockhashLifetime, assertTransactionIsFullySigned, compileMessage, createTransaction, getBase64EncodedWireTransaction, getCompiledMessageCodec, getCompiledMessageDecoder, getCompiledMessageEncoder, getSignatureFromTransaction, getTransactionCodec, getTransactionDecoder, getTransactionEncoder, isAdvanceNonceAccountInstruction, partiallySignTransaction, prependTransactionInstruction, setTransactionFeePayer, setTransactionLifetimeUsingBlockhash, setTransactionLifetimeUsingDurableNonce, signTransaction };
703
905
  //# sourceMappingURL=out.js.map
704
906
  //# sourceMappingURL=index.browser.js.map