@solana/transactions 2.0.0-experimental.2a97655 → 2.0.0-experimental.2ac1df6

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 (67) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +272 -5
  3. package/dist/index.browser.cjs +433 -276
  4. package/dist/index.browser.cjs.map +1 -1
  5. package/dist/index.browser.js +425 -278
  6. package/dist/index.browser.js.map +1 -1
  7. package/dist/index.native.js +425 -278
  8. package/dist/index.native.js.map +1 -1
  9. package/dist/index.node.cjs +433 -276
  10. package/dist/index.node.cjs.map +1 -1
  11. package/dist/index.node.js +425 -278
  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 -1
  15. package/dist/types/blockhash.d.ts +5 -4
  16. package/dist/types/blockhash.d.ts.map +1 -1
  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 -1
  21. package/dist/types/compile-header.d.ts +1 -1
  22. package/dist/types/compile-instructions.d.ts +2 -2
  23. package/dist/types/compile-instructions.d.ts.map +1 -1
  24. package/dist/types/compile-lifetime-token.d.ts +1 -1
  25. package/dist/types/compile-static-accounts.d.ts +3 -3
  26. package/dist/types/compile-static-accounts.d.ts.map +1 -1
  27. package/dist/types/compile-transaction.d.ts +6 -7
  28. package/dist/types/compile-transaction.d.ts.map +1 -1
  29. package/dist/types/create-transaction.d.ts +1 -1
  30. package/dist/types/decompile-transaction.d.ts +5 -0
  31. package/dist/types/decompile-transaction.d.ts.map +1 -0
  32. package/dist/types/durable-nonce.d.ts +11 -10
  33. package/dist/types/durable-nonce.d.ts.map +1 -1
  34. package/dist/types/fee-payer.d.ts +6 -5
  35. package/dist/types/fee-payer.d.ts.map +1 -1
  36. package/dist/types/index.d.ts +11 -8
  37. package/dist/types/index.d.ts.map +1 -1
  38. package/dist/types/instructions.d.ts +2 -2
  39. package/dist/types/message.d.ts +6 -10
  40. package/dist/types/message.d.ts.map +1 -1
  41. package/dist/types/serializers/address-table-lookup.d.ts +5 -3
  42. package/dist/types/serializers/address-table-lookup.d.ts.map +1 -1
  43. package/dist/types/serializers/header.d.ts +5 -3
  44. package/dist/types/serializers/header.d.ts.map +1 -1
  45. package/dist/types/serializers/index.d.ts +3 -0
  46. package/dist/types/serializers/index.d.ts.map +1 -0
  47. package/dist/types/serializers/instruction.d.ts +5 -3
  48. package/dist/types/serializers/instruction.d.ts.map +1 -1
  49. package/dist/types/serializers/message.d.ts +5 -5
  50. package/dist/types/serializers/message.d.ts.map +1 -1
  51. package/dist/types/serializers/transaction-version.d.ts +5 -5
  52. package/dist/types/serializers/transaction-version.d.ts.map +1 -1
  53. package/dist/types/serializers/transaction.d.ts +6 -5
  54. package/dist/types/serializers/transaction.d.ts.map +1 -1
  55. package/dist/types/signatures.d.ts +10 -5
  56. package/dist/types/signatures.d.ts.map +1 -1
  57. package/dist/types/types.d.ts +13 -13
  58. package/dist/types/types.d.ts.map +1 -1
  59. package/dist/types/unsigned-transaction.d.ts +1 -1
  60. package/dist/types/wire-transaction.d.ts +3 -3
  61. package/dist/types/wire-transaction.d.ts.map +1 -1
  62. package/package.json +24 -20
  63. package/dist/index.development.js +0 -1323
  64. package/dist/index.development.js.map +0 -1
  65. package/dist/index.production.min.js +0 -20
  66. package/dist/types/serializers/unimplemented.d.ts +0 -3
  67. package/dist/types/serializers/unimplemented.d.ts.map +0 -1
@@ -1,8 +1,12 @@
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
6
10
 
7
11
  // src/unsigned-transaction.ts
8
12
  function getUnsignedTransaction(transaction) {
@@ -19,7 +23,10 @@ function getUnsignedTransaction(transaction) {
19
23
  }
20
24
 
21
25
  // src/blockhash.ts
26
+ var base58Encoder;
22
27
  function assertIsBlockhash(putativeBlockhash) {
28
+ if (!base58Encoder)
29
+ base58Encoder = getBase58Encoder();
23
30
  try {
24
31
  if (
25
32
  // Lowest value (32 bytes of zeroes)
@@ -28,8 +35,8 @@ function assertIsBlockhash(putativeBlockhash) {
28
35
  ) {
29
36
  throw new Error("Expected input string to decode to a byte array of length 32.");
30
37
  }
31
- const bytes3 = base58.serialize(putativeBlockhash);
32
- const numBytes = bytes3.byteLength;
38
+ const bytes = base58Encoder.encode(putativeBlockhash);
39
+ const numBytes = bytes.byteLength;
33
40
  if (numBytes !== 32) {
34
41
  throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
35
42
  }
@@ -39,6 +46,22 @@ function assertIsBlockhash(putativeBlockhash) {
39
46
  });
40
47
  }
41
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
+ }
42
65
  function setTransactionLifetimeUsingBlockhash(blockhashLifetimeConstraint, transaction) {
43
66
  if ("lifetimeConstraint" in transaction && transaction.lifetimeConstraint.blockhash === blockhashLifetimeConstraint.blockhash && transaction.lifetimeConstraint.lastValidBlockHeight === blockhashLifetimeConstraint.lastValidBlockHeight) {
44
67
  return transaction;
@@ -114,7 +137,7 @@ function isAdvanceNonceAccountInstruction(instruction) {
114
137
  instruction.accounts?.length === 3 && // First account is nonce account address
115
138
  instruction.accounts[0].address != null && instruction.accounts[0].role === AccountRole.WRITABLE && // Second account is recent blockhashes sysvar
116
139
  instruction.accounts[1].address === RECENT_BLOCKHASHES_SYSVAR_ADDRESS && instruction.accounts[1].role === AccountRole.READONLY && // Third account is nonce authority account
117
- instruction.accounts[2].address != null && instruction.accounts[2].role === AccountRole.READONLY_SIGNER;
140
+ instruction.accounts[2].address != null && isSignerRole(instruction.accounts[2].role);
118
141
  }
119
142
  function isAdvanceNonceAccountInstructionData(data) {
120
143
  return data.byteLength === 4 && data[0] === 4 && data[1] === 0 && data[2] === 0 && data[3] === 0;
@@ -122,21 +145,38 @@ function isAdvanceNonceAccountInstructionData(data) {
122
145
  function isDurableNonceTransaction(transaction) {
123
146
  return "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.nonce === "string" && transaction.instructions[0] != null && isAdvanceNonceAccountInstruction(transaction.instructions[0]);
124
147
  }
148
+ function isAdvanceNonceAccountInstructionForNonce(instruction, nonceAccountAddress, nonceAuthorityAddress) {
149
+ return instruction.accounts[0].address === nonceAccountAddress && instruction.accounts[2].address === nonceAuthorityAddress;
150
+ }
125
151
  function setTransactionLifetimeUsingDurableNonce({
126
152
  nonce,
127
153
  nonceAccountAddress,
128
154
  nonceAuthorityAddress
129
155
  }, transaction) {
130
- const isAlreadyDurableNonceTransaction = isDurableNonceTransaction(transaction);
131
- if (isAlreadyDurableNonceTransaction && transaction.lifetimeConstraint.nonce === nonce && transaction.instructions[0].accounts[0].address === nonceAccountAddress && transaction.instructions[0].accounts[2].address === nonceAuthorityAddress) {
132
- return 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
+ ];
133
176
  }
134
177
  const out = {
135
178
  ...getUnsignedTransaction(transaction),
136
- instructions: [
137
- createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
138
- ...isAlreadyDurableNonceTransaction ? transaction.instructions.slice(1) : transaction.instructions
139
- ],
179
+ instructions: newInstructions,
140
180
  lifetimeConstraint: {
141
181
  nonce
142
182
  }
@@ -227,7 +267,7 @@ function getAddressMapFromInstructions(feePayer, instructions) {
227
267
  const shouldReplaceEntry = (
228
268
  // Consider using the new LOOKUP_TABLE if its address is different...
229
269
  entry.lookupTableAddress !== accountMeta.lookupTableAddress && // ...and sorts before the existing one.
230
- (addressComparator || (addressComparator = getBase58EncodedAddressComparator()))(
270
+ (addressComparator ||= getAddressComparator())(
231
271
  accountMeta.lookupTableAddress,
232
272
  entry.lookupTableAddress
233
273
  ) < 0
@@ -333,7 +373,7 @@ function getOrderedAccountsFromAddressMap(addressMap) {
333
373
  if (leftIsWritable !== isWritableRole(rightEntry.role)) {
334
374
  return leftIsWritable ? -1 : 1;
335
375
  }
336
- addressComparator || (addressComparator = getBase58EncodedAddressComparator());
376
+ addressComparator ||= getAddressComparator();
337
377
  if (leftEntry[TYPE] === 1 /* LOOKUP_TABLE */ && rightEntry[TYPE] === 1 /* LOOKUP_TABLE */ && leftEntry.lookupTableAddress !== rightEntry.lookupTableAddress) {
338
378
  return addressComparator(leftEntry.lookupTableAddress, rightEntry.lookupTableAddress);
339
379
  } else {
@@ -346,23 +386,22 @@ function getOrderedAccountsFromAddressMap(addressMap) {
346
386
  return orderedAccounts;
347
387
  }
348
388
  function getCompiledAddressTableLookups(orderedAccounts) {
349
- var _a;
350
389
  const index = {};
351
390
  for (const account of orderedAccounts) {
352
391
  if (!("lookupTableAddress" in account)) {
353
392
  continue;
354
393
  }
355
- const entry = index[_a = account.lookupTableAddress] || (index[_a] = {
394
+ const entry = index[account.lookupTableAddress] ||= {
356
395
  readableIndices: [],
357
396
  writableIndices: []
358
- });
397
+ };
359
398
  if (account.role === AccountRole.WRITABLE) {
360
399
  entry.writableIndices.push(account.addressIndex);
361
400
  } else {
362
401
  entry.readableIndices.push(account.addressIndex);
363
402
  }
364
403
  }
365
- return Object.keys(index).sort(getBase58EncodedAddressComparator()).map((lookupTableAddress) => ({
404
+ return Object.keys(index).sort(getAddressComparator()).map((lookupTableAddress) => ({
366
405
  lookupTableAddress,
367
406
  ...index[lookupTableAddress]
368
407
  }));
@@ -441,266 +480,215 @@ function compileMessage(transaction) {
441
480
  version: transaction.version
442
481
  };
443
482
  }
444
- function getAddressTableLookupCodec() {
445
- return struct(
446
- [
447
- [
448
- "lookupTableAddress",
449
- getBase58EncodedAddressCodec(
450
- __DEV__ ? {
451
- description: "The address of the address lookup table account from which instruction addresses should be looked up"
452
- } : void 0
453
- )
454
- ],
483
+ var memoizedAddressTableLookupEncoder;
484
+ function getAddressTableLookupEncoder() {
485
+ if (!memoizedAddressTableLookupEncoder) {
486
+ memoizedAddressTableLookupEncoder = getStructEncoder([
487
+ ["lookupTableAddress", getAddressEncoder()],
455
488
  [
456
489
  "writableIndices",
457
- array(u8(), {
458
- ...__DEV__ ? {
459
- description: "The indices of the accounts in the lookup table that should be loaded as writeable"
460
- } : null,
461
- size: shortU16()
462
- })
490
+ getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })
463
491
  ],
464
492
  [
465
493
  "readableIndices",
466
- array(u8(), {
467
- ...__DEV__ ? {
468
- description: "The indices of the accounts in the lookup table that should be loaded as read-only"
469
- } : void 0,
470
- size: shortU16()
471
- })
494
+ getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })
472
495
  ]
473
- ],
474
- __DEV__ ? {
475
- 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"
476
- } : void 0
477
- );
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
+ ]);
478
529
  }
479
- function getMessageHeaderCodec() {
480
- return struct(
481
- [
482
- [
483
- "numSignerAccounts",
484
- u8(
485
- __DEV__ ? {
486
- description: "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction"
487
- } : void 0
488
- )
489
- ],
490
- [
491
- "numReadonlySignerAccounts",
492
- u8(
493
- __DEV__ ? {
494
- 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"
495
- } : void 0
496
- )
497
- ],
498
- [
499
- "numReadonlyNonSignerAccounts",
500
- u8(
501
- __DEV__ ? {
502
- description: "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable"
503
- } : void 0
504
- )
505
- ]
506
- ],
507
- __DEV__ ? {
508
- description: "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses"
509
- } : void 0
510
- );
530
+ function getMessageHeaderDecoder() {
531
+ return getStructDecoder([
532
+ ["numSignerAccounts", getMemoizedU8Decoder()],
533
+ ["numReadonlySignerAccounts", getMemoizedU8Decoder()],
534
+ ["numReadonlyNonSignerAccounts", getMemoizedU8Decoder()]
535
+ ]);
511
536
  }
512
- function getInstructionCodec() {
513
- return mapSerializer(
514
- struct([
515
- [
516
- "programAddressIndex",
517
- u8(
518
- __DEV__ ? {
519
- description: "The index of the program being called, according to the well-ordered accounts list for this transaction"
520
- } : void 0
521
- )
522
- ],
523
- [
524
- "addressIndices",
525
- array(
526
- u8({
527
- description: __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : ""
528
- }),
529
- {
530
- 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" : "",
531
- size: shortU16()
532
- }
533
- )
534
- ],
535
- [
536
- "data",
537
- bytes({
538
- description: __DEV__ ? "An optional buffer of data passed to the instruction" : "",
539
- size: shortU16()
540
- })
541
- ]
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()]
542
627
  ]),
543
628
  (value) => {
544
- if (value.addressIndices !== void 0 && value.data !== void 0) {
629
+ if (value.version === "legacy") {
545
630
  return value;
546
631
  }
547
632
  return {
548
633
  ...value,
549
- addressIndices: value.addressIndices ?? [],
550
- data: value.data ?? new Uint8Array(0)
551
- };
552
- },
553
- (value) => {
554
- if (value.addressIndices.length && value.data.byteLength) {
555
- return value;
556
- }
557
- const { addressIndices, data, ...rest } = value;
558
- return {
559
- ...rest,
560
- ...addressIndices.length ? { addressIndices } : null,
561
- ...data.byteLength ? { data } : null
634
+ addressTableLookups: value.addressTableLookups ?? []
562
635
  };
563
636
  }
564
637
  );
565
638
  }
566
-
567
- // src/serializers/unimplemented.ts
568
- function getError(type, name) {
569
- const functionSuffix = name + type[0].toUpperCase() + type.slice(1);
570
- return new Error(
571
- `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}`
572
- );
573
- }
574
- function getUnimplementedDecoder(name) {
575
- return () => {
576
- throw getError("decoder", name);
577
- };
578
- }
579
-
580
- // src/serializers/transaction-version.ts
581
- var VERSION_FLAG_MASK = 128;
582
- var BASE_CONFIG = {
583
- description: __DEV__ ? "A single byte that encodes the version of the transaction" : "",
584
- fixedSize: null,
585
- maxSize: 1
586
- };
587
- function deserialize(bytes3, offset = 0) {
588
- const firstByte = bytes3[offset];
589
- if ((firstByte & VERSION_FLAG_MASK) === 0) {
590
- return ["legacy", offset];
591
- } else {
592
- const version = firstByte ^ VERSION_FLAG_MASK;
593
- return [version, offset + 1];
594
- }
595
- }
596
- function serialize(value) {
597
- if (value === "legacy") {
598
- return new Uint8Array();
599
- }
600
- if (value < 0 || value > 127) {
601
- throw new Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
602
- }
603
- return new Uint8Array([value | VERSION_FLAG_MASK]);
604
- }
605
- function getTransactionVersionCodec() {
606
- return {
607
- ...BASE_CONFIG,
608
- deserialize,
609
- serialize
610
- };
611
- }
612
-
613
- // src/serializers/message.ts
614
- var BASE_CONFIG2 = {
615
- description: __DEV__ ? "The wire format of a Solana transaction message" : "",
616
- fixedSize: null,
617
- maxSize: null
618
- };
619
- function serialize2(compiledMessage) {
620
- if (compiledMessage.version === "legacy") {
621
- return struct(getPreludeStructSerializerTuple()).serialize(compiledMessage);
622
- } else {
623
- return mapSerializer(
624
- struct([
625
- ...getPreludeStructSerializerTuple(),
626
- ["addressTableLookups", getAddressTableLookupsSerializer()]
627
- ]),
628
- (value) => {
629
- if (value.version === "legacy") {
630
- return value;
631
- }
632
- return {
633
- ...value,
634
- addressTableLookups: value.addressTableLookups ?? []
635
- };
636
- }
637
- ).serialize(compiledMessage);
638
- }
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
+ ];
639
647
  }
640
- function getPreludeStructSerializerTuple() {
648
+ function getPreludeStructDecoderTuple() {
641
649
  return [
642
- ["version", getTransactionVersionCodec()],
643
- ["header", getMessageHeaderCodec()],
644
- [
645
- "staticAccounts",
646
- array(getBase58EncodedAddressCodec(), {
647
- description: __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "",
648
- size: shortU16()
649
- })
650
- ],
651
- [
652
- "lifetimeToken",
653
- string({
654
- description: __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "",
655
- encoding: base58,
656
- size: 32
657
- })
658
- ],
659
- [
660
- "instructions",
661
- array(getInstructionCodec(), {
662
- description: __DEV__ ? "A compact-array of instructions belonging to this transaction" : "",
663
- size: shortU16()
664
- })
665
- ]
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()]
666
656
  ];
667
657
  }
668
- function getAddressTableLookupsSerializer() {
669
- return array(getAddressTableLookupCodec(), {
670
- ...__DEV__ ? { description: "A compact array of address table lookups belonging to this transaction" } : null,
671
- size: shortU16()
672
- });
658
+ function getAddressTableLookupArrayEncoder() {
659
+ return getArrayEncoder(getAddressTableLookupEncoder(), { size: getShortU16Encoder() });
660
+ }
661
+ function getAddressTableLookupArrayDecoder() {
662
+ return getArrayDecoder(getAddressTableLookupDecoder(), { size: getShortU16Decoder() });
673
663
  }
674
664
  function getCompiledMessageEncoder() {
675
- return {
676
- ...BASE_CONFIG2,
677
- deserialize: getUnimplementedDecoder("CompiledMessage"),
678
- serialize: serialize2
679
- };
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
+ });
680
681
  }
681
-
682
- // src/signatures.ts
683
- async function getCompiledMessageSignature(message, secretKey) {
684
- const wireMessageBytes = getCompiledMessageEncoder().serialize(message);
685
- const signature = await signBytes(secretKey, wireMessageBytes);
686
- 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
+ });
687
689
  }
688
- async function signTransaction(keyPair, transaction) {
689
- const compiledMessage = compileMessage(transaction);
690
- const [signerPublicKey, signature] = await Promise.all([
691
- getBase58EncodedAddressFromPublicKey(keyPair.publicKey),
692
- getCompiledMessageSignature(compiledMessage, keyPair.privateKey)
693
- ]);
694
- const nextSignatures = {
695
- ..."signatures" in transaction ? transaction.signatures : null,
696
- ...{ [signerPublicKey]: signature }
697
- };
698
- const out = {
699
- ...transaction,
700
- signatures: nextSignatures
701
- };
702
- Object.freeze(out);
703
- return out;
690
+ function getCompiledMessageCodec() {
691
+ return combineCodec(getCompiledMessageEncoder(), getCompiledMessageDecoder());
704
692
  }
705
693
 
706
694
  // src/compile-transaction.ts
@@ -720,40 +708,199 @@ function getCompiledTransaction(transaction) {
720
708
  signatures
721
709
  };
722
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
+ }
723
821
 
724
822
  // src/serializers/transaction.ts
725
- var BASE_CONFIG3 = {
726
- description: __DEV__ ? "The wire format of a Solana transaction" : "",
727
- fixedSize: null,
728
- maxSize: null
729
- };
730
- function serialize3(transaction) {
731
- const compiledTransaction = getCompiledTransaction(transaction);
732
- 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([
733
831
  [
734
832
  "signatures",
735
- array(bytes({ size: 64 }), {
736
- ...__DEV__ ? { description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } : null,
737
- size: shortU16()
833
+ getArrayDecoder(getBytesDecoder({ size: 64 }), {
834
+ size: getShortU16Decoder()
738
835
  })
739
836
  ],
740
- ["compiledMessage", getCompiledMessageEncoder()]
741
- ]).serialize(compiledTransaction);
837
+ ["compiledMessage", getCompiledMessageDecoder()]
838
+ ]);
742
839
  }
743
840
  function getTransactionEncoder() {
744
- return {
745
- ...BASE_CONFIG3,
746
- deserialize: getUnimplementedDecoder("CompiledMessage"),
747
- 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
748
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
+ });
749
898
  }
750
-
751
- // src/wire-transaction.ts
752
899
  function getBase64EncodedWireTransaction(transaction) {
753
- const wireTransactionBytes = getTransactionEncoder().serialize(transaction);
754
- {
755
- return btoa(String.fromCharCode(...wireTransactionBytes));
756
- }
900
+ const wireTransactionBytes = getTransactionEncoder().encode(transaction);
901
+ return getBase64Decoder().decode(wireTransactionBytes);
757
902
  }
758
903
 
759
- export { appendTransactionInstruction, assertIsBlockhash, assertIsDurableNonceTransaction, createTransaction, getBase64EncodedWireTransaction, prependTransactionInstruction, setTransactionFeePayer, setTransactionLifetimeUsingBlockhash, setTransactionLifetimeUsingDurableNonce, 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 };
905
+ //# sourceMappingURL=out.js.map
906
+ //# sourceMappingURL=index.browser.js.map