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

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 (64) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +272 -5
  3. package/dist/index.browser.cjs +526 -238
  4. package/dist/index.browser.cjs.map +1 -1
  5. package/dist/index.browser.js +519 -238
  6. package/dist/index.browser.js.map +1 -1
  7. package/dist/index.development.js +1124 -664
  8. package/dist/index.development.js.map +1 -1
  9. package/dist/index.native.js +519 -238
  10. package/dist/index.native.js.map +1 -1
  11. package/dist/index.node.cjs +526 -236
  12. package/dist/index.node.cjs.map +1 -1
  13. package/dist/index.node.js +519 -238
  14. package/dist/index.node.js.map +1 -1
  15. package/dist/index.production.min.js +22 -11
  16. package/dist/types/accounts.d.ts +3 -3
  17. package/dist/types/blockhash.d.ts +1 -1
  18. package/dist/types/compilable-transaction.d.ts +7 -0
  19. package/dist/types/compile-address-table-lookups.d.ts +2 -2
  20. package/dist/types/compile-instructions.d.ts +1 -1
  21. package/dist/types/compile-static-accounts.d.ts +2 -2
  22. package/dist/types/compile-transaction.d.ts +5 -6
  23. package/dist/types/decompile-transaction.d.ts +5 -0
  24. package/dist/types/durable-nonce.d.ts +10 -9
  25. package/dist/types/fee-payer.d.ts +4 -3
  26. package/dist/types/index.d.ts +3 -0
  27. package/dist/types/message.d.ts +1 -5
  28. package/dist/types/serializers/address-table-lookup.d.ts +5 -3
  29. package/dist/types/serializers/header.d.ts +4 -2
  30. package/dist/types/serializers/index.d.ts +3 -0
  31. package/dist/types/serializers/instruction.d.ts +4 -2
  32. package/dist/types/serializers/message.d.ts +4 -4
  33. package/dist/types/serializers/transaction-version.d.ts +4 -4
  34. package/dist/types/serializers/transaction.d.ts +6 -5
  35. package/dist/types/signatures.d.ts +10 -5
  36. package/dist/types/types.d.ts +13 -13
  37. package/dist/types/wire-transaction.d.ts +2 -2
  38. package/package.json +22 -18
  39. package/dist/types/accounts.d.ts.map +0 -1
  40. package/dist/types/blockhash.d.ts.map +0 -1
  41. package/dist/types/compile-address-table-lookups.d.ts.map +0 -1
  42. package/dist/types/compile-header.d.ts.map +0 -1
  43. package/dist/types/compile-instructions.d.ts.map +0 -1
  44. package/dist/types/compile-lifetime-token.d.ts.map +0 -1
  45. package/dist/types/compile-static-accounts.d.ts.map +0 -1
  46. package/dist/types/compile-transaction.d.ts.map +0 -1
  47. package/dist/types/create-transaction.d.ts.map +0 -1
  48. package/dist/types/durable-nonce.d.ts.map +0 -1
  49. package/dist/types/fee-payer.d.ts.map +0 -1
  50. package/dist/types/index.d.ts.map +0 -1
  51. package/dist/types/instructions.d.ts.map +0 -1
  52. package/dist/types/message.d.ts.map +0 -1
  53. package/dist/types/serializers/address-table-lookup.d.ts.map +0 -1
  54. package/dist/types/serializers/header.d.ts.map +0 -1
  55. package/dist/types/serializers/instruction.d.ts.map +0 -1
  56. package/dist/types/serializers/message.d.ts.map +0 -1
  57. package/dist/types/serializers/transaction-version.d.ts.map +0 -1
  58. package/dist/types/serializers/transaction.d.ts.map +0 -1
  59. package/dist/types/serializers/unimplemented.d.ts +0 -3
  60. package/dist/types/serializers/unimplemented.d.ts.map +0 -1
  61. package/dist/types/signatures.d.ts.map +0 -1
  62. package/dist/types/types.d.ts.map +0 -1
  63. package/dist/types/unsigned-transaction.d.ts.map +0 -1
  64. package/dist/types/wire-transaction.d.ts.map +0 -1
@@ -1,6 +1,11 @@
1
1
  'use strict';
2
2
 
3
- var umiSerializers = require('@metaplex-foundation/umi-serializers');
3
+ var codecsStrings = require('@solana/codecs-strings');
4
+ var addresses = require('@solana/addresses');
5
+ var codecsCore = require('@solana/codecs-core');
6
+ var codecsDataStructures = require('@solana/codecs-data-structures');
7
+ var codecsNumbers = require('@solana/codecs-numbers');
8
+ var functional = require('@solana/functional');
4
9
  var keys = require('@solana/keys');
5
10
 
6
11
  // ../build-scripts/env-shim.ts
@@ -21,7 +26,10 @@ function getUnsignedTransaction(transaction) {
21
26
  }
22
27
 
23
28
  // src/blockhash.ts
29
+ var base58Encoder;
24
30
  function assertIsBlockhash(putativeBlockhash) {
31
+ if (!base58Encoder)
32
+ base58Encoder = codecsStrings.getBase58Encoder();
25
33
  try {
26
34
  if (
27
35
  // Lowest value (32 bytes of zeroes)
@@ -30,8 +38,8 @@ function assertIsBlockhash(putativeBlockhash) {
30
38
  ) {
31
39
  throw new Error("Expected input string to decode to a byte array of length 32.");
32
40
  }
33
- const bytes3 = umiSerializers.base58.serialize(putativeBlockhash);
34
- const numBytes = bytes3.byteLength;
41
+ const bytes = base58Encoder.encode(putativeBlockhash);
42
+ const numBytes = bytes.byteLength;
35
43
  if (numBytes !== 32) {
36
44
  throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
37
45
  }
@@ -116,7 +124,7 @@ function isAdvanceNonceAccountInstruction(instruction) {
116
124
  instruction.accounts?.length === 3 && // First account is nonce account address
117
125
  instruction.accounts[0].address != null && instruction.accounts[0].role === AccountRole.WRITABLE && // Second account is recent blockhashes sysvar
118
126
  instruction.accounts[1].address === RECENT_BLOCKHASHES_SYSVAR_ADDRESS && instruction.accounts[1].role === AccountRole.READONLY && // Third account is nonce authority account
119
- instruction.accounts[2].address != null && instruction.accounts[2].role === AccountRole.READONLY_SIGNER;
127
+ instruction.accounts[2].address != null && isSignerRole(instruction.accounts[2].role);
120
128
  }
121
129
  function isAdvanceNonceAccountInstructionData(data) {
122
130
  return data.byteLength === 4 && data[0] === 4 && data[1] === 0 && data[2] === 0 && data[3] === 0;
@@ -124,21 +132,38 @@ function isAdvanceNonceAccountInstructionData(data) {
124
132
  function isDurableNonceTransaction(transaction) {
125
133
  return "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.nonce === "string" && transaction.instructions[0] != null && isAdvanceNonceAccountInstruction(transaction.instructions[0]);
126
134
  }
135
+ function isAdvanceNonceAccountInstructionForNonce(instruction, nonceAccountAddress, nonceAuthorityAddress) {
136
+ return instruction.accounts[0].address === nonceAccountAddress && instruction.accounts[2].address === nonceAuthorityAddress;
137
+ }
127
138
  function setTransactionLifetimeUsingDurableNonce({
128
139
  nonce,
129
140
  nonceAccountAddress,
130
141
  nonceAuthorityAddress
131
142
  }, transaction) {
132
- const isAlreadyDurableNonceTransaction = isDurableNonceTransaction(transaction);
133
- if (isAlreadyDurableNonceTransaction && transaction.lifetimeConstraint.nonce === nonce && transaction.instructions[0].accounts[0].address === nonceAccountAddress && transaction.instructions[0].accounts[2].address === nonceAuthorityAddress) {
134
- return transaction;
143
+ let newInstructions;
144
+ const firstInstruction = transaction.instructions[0];
145
+ if (firstInstruction && isAdvanceNonceAccountInstruction(firstInstruction)) {
146
+ if (isAdvanceNonceAccountInstructionForNonce(firstInstruction, nonceAccountAddress, nonceAuthorityAddress)) {
147
+ if (isDurableNonceTransaction(transaction) && transaction.lifetimeConstraint.nonce === nonce) {
148
+ return transaction;
149
+ } else {
150
+ newInstructions = [firstInstruction, ...transaction.instructions.slice(1)];
151
+ }
152
+ } else {
153
+ newInstructions = [
154
+ createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
155
+ ...transaction.instructions.slice(1)
156
+ ];
157
+ }
158
+ } else {
159
+ newInstructions = [
160
+ createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
161
+ ...transaction.instructions
162
+ ];
135
163
  }
136
164
  const out = {
137
165
  ...getUnsignedTransaction(transaction),
138
- instructions: [
139
- createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
140
- ...isAlreadyDurableNonceTransaction ? transaction.instructions.slice(1) : transaction.instructions
141
- ],
166
+ instructions: newInstructions,
142
167
  lifetimeConstraint: {
143
168
  nonce
144
169
  }
@@ -229,7 +254,7 @@ function getAddressMapFromInstructions(feePayer, instructions) {
229
254
  const shouldReplaceEntry = (
230
255
  // Consider using the new LOOKUP_TABLE if its address is different...
231
256
  entry.lookupTableAddress !== accountMeta.lookupTableAddress && // ...and sorts before the existing one.
232
- (addressComparator || (addressComparator = keys.getBase58EncodedAddressComparator()))(
257
+ (addressComparator ||= addresses.getAddressComparator())(
233
258
  accountMeta.lookupTableAddress,
234
259
  entry.lookupTableAddress
235
260
  ) < 0
@@ -335,7 +360,7 @@ function getOrderedAccountsFromAddressMap(addressMap) {
335
360
  if (leftIsWritable !== isWritableRole(rightEntry.role)) {
336
361
  return leftIsWritable ? -1 : 1;
337
362
  }
338
- addressComparator || (addressComparator = keys.getBase58EncodedAddressComparator());
363
+ addressComparator ||= addresses.getAddressComparator();
339
364
  if (leftEntry[TYPE] === 1 /* LOOKUP_TABLE */ && rightEntry[TYPE] === 1 /* LOOKUP_TABLE */ && leftEntry.lookupTableAddress !== rightEntry.lookupTableAddress) {
340
365
  return addressComparator(leftEntry.lookupTableAddress, rightEntry.lookupTableAddress);
341
366
  } else {
@@ -348,23 +373,22 @@ function getOrderedAccountsFromAddressMap(addressMap) {
348
373
  return orderedAccounts;
349
374
  }
350
375
  function getCompiledAddressTableLookups(orderedAccounts) {
351
- var _a;
352
376
  const index = {};
353
377
  for (const account of orderedAccounts) {
354
378
  if (!("lookupTableAddress" in account)) {
355
379
  continue;
356
380
  }
357
- const entry = index[_a = account.lookupTableAddress] || (index[_a] = {
381
+ const entry = index[account.lookupTableAddress] ||= {
358
382
  readableIndices: [],
359
383
  writableIndices: []
360
- });
384
+ };
361
385
  if (account.role === AccountRole.WRITABLE) {
362
386
  entry.writableIndices.push(account.addressIndex);
363
387
  } else {
364
388
  entry.readableIndices.push(account.addressIndex);
365
389
  }
366
390
  }
367
- return Object.keys(index).sort(keys.getBase58EncodedAddressComparator()).map((lookupTableAddress) => ({
391
+ return Object.keys(index).sort(addresses.getAddressComparator()).map((lookupTableAddress) => ({
368
392
  lookupTableAddress,
369
393
  ...index[lookupTableAddress]
370
394
  }));
@@ -443,151 +467,189 @@ function compileMessage(transaction) {
443
467
  version: transaction.version
444
468
  };
445
469
  }
446
- function getAddressTableLookupCodec() {
447
- return umiSerializers.struct(
448
- [
470
+ var lookupTableAddressDescription = __DEV__ ? "The address of the address lookup table account from which instruction addresses should be looked up" : "lookupTableAddress";
471
+ var writableIndicesDescription = __DEV__ ? "The indices of the accounts in the lookup table that should be loaded as writeable" : "writableIndices";
472
+ var readableIndicesDescription = __DEV__ ? "The indices of the accounts in the lookup table that should be loaded as read-only" : "readableIndices";
473
+ var addressTableLookupDescription = __DEV__ ? "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" : "addressTableLookup";
474
+ var memoizedAddressTableLookupEncoder;
475
+ function getAddressTableLookupEncoder() {
476
+ if (!memoizedAddressTableLookupEncoder) {
477
+ memoizedAddressTableLookupEncoder = codecsDataStructures.getStructEncoder(
449
478
  [
450
- "lookupTableAddress",
451
- keys.getBase58EncodedAddressCodec(
452
- __DEV__ ? {
453
- description: "The address of the address lookup table account from which instruction addresses should be looked up"
454
- } : void 0
455
- )
479
+ ["lookupTableAddress", addresses.getAddressEncoder({ description: lookupTableAddressDescription })],
480
+ [
481
+ "writableIndices",
482
+ codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), {
483
+ description: writableIndicesDescription,
484
+ size: codecsNumbers.getShortU16Encoder()
485
+ })
486
+ ],
487
+ [
488
+ "readableIndices",
489
+ codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), {
490
+ description: readableIndicesDescription,
491
+ size: codecsNumbers.getShortU16Encoder()
492
+ })
493
+ ]
456
494
  ],
495
+ { description: addressTableLookupDescription }
496
+ );
497
+ }
498
+ return memoizedAddressTableLookupEncoder;
499
+ }
500
+ var memoizedAddressTableLookupDecoder;
501
+ function getAddressTableLookupDecoder() {
502
+ if (!memoizedAddressTableLookupDecoder) {
503
+ memoizedAddressTableLookupDecoder = codecsDataStructures.getStructDecoder(
457
504
  [
458
- "writableIndices",
459
- umiSerializers.array(umiSerializers.u8(), {
460
- ...__DEV__ ? {
461
- description: "The indices of the accounts in the lookup table that should be loaded as writeable"
462
- } : null,
463
- size: umiSerializers.shortU16()
464
- })
505
+ ["lookupTableAddress", addresses.getAddressDecoder({ description: lookupTableAddressDescription })],
506
+ [
507
+ "writableIndices",
508
+ codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), {
509
+ description: writableIndicesDescription,
510
+ size: codecsNumbers.getShortU16Decoder()
511
+ })
512
+ ],
513
+ [
514
+ "readableIndices",
515
+ codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), {
516
+ description: readableIndicesDescription,
517
+ size: codecsNumbers.getShortU16Decoder()
518
+ })
519
+ ]
465
520
  ],
466
- [
467
- "readableIndices",
468
- umiSerializers.array(umiSerializers.u8(), {
469
- ...__DEV__ ? {
470
- description: "The indices of the accounts in the lookup table that should be loaded as read-only"
471
- } : void 0,
472
- size: umiSerializers.shortU16()
473
- })
474
- ]
475
- ],
476
- __DEV__ ? {
477
- 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"
478
- } : void 0
479
- );
521
+ { description: addressTableLookupDescription }
522
+ );
523
+ }
524
+ return memoizedAddressTableLookupDecoder;
525
+ }
526
+ var memoizedU8Encoder;
527
+ function getMemoizedU8Encoder() {
528
+ if (!memoizedU8Encoder)
529
+ memoizedU8Encoder = codecsNumbers.getU8Encoder();
530
+ return memoizedU8Encoder;
531
+ }
532
+ function getMemoizedU8EncoderDescription(description) {
533
+ const encoder = getMemoizedU8Encoder();
534
+ return {
535
+ ...encoder,
536
+ description: description ?? encoder.description
537
+ };
480
538
  }
481
- function getMessageHeaderCodec() {
482
- return umiSerializers.struct(
539
+ var memoizedU8Decoder;
540
+ function getMemoizedU8Decoder() {
541
+ if (!memoizedU8Decoder)
542
+ memoizedU8Decoder = codecsNumbers.getU8Decoder();
543
+ return memoizedU8Decoder;
544
+ }
545
+ function getMemoizedU8DecoderDescription(description) {
546
+ const decoder = getMemoizedU8Decoder();
547
+ return {
548
+ ...decoder,
549
+ description: description ?? decoder.description
550
+ };
551
+ }
552
+ var numSignerAccountsDescription = __DEV__ ? "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction" : void 0;
553
+ var numReadonlySignerAccountsDescription = __DEV__ ? "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" : void 0;
554
+ var numReadonlyNonSignerAccountsDescription = __DEV__ ? "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable" : void 0;
555
+ var messageHeaderDescription = __DEV__ ? "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses" : void 0;
556
+ function getMessageHeaderEncoder() {
557
+ return codecsDataStructures.getStructEncoder(
483
558
  [
484
- [
485
- "numSignerAccounts",
486
- umiSerializers.u8(
487
- __DEV__ ? {
488
- description: "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction"
489
- } : void 0
490
- )
491
- ],
492
- [
493
- "numReadonlySignerAccounts",
494
- umiSerializers.u8(
495
- __DEV__ ? {
496
- 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"
497
- } : void 0
498
- )
499
- ],
500
- [
501
- "numReadonlyNonSignerAccounts",
502
- umiSerializers.u8(
503
- __DEV__ ? {
504
- description: "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable"
505
- } : void 0
506
- )
507
- ]
559
+ ["numSignerAccounts", getMemoizedU8EncoderDescription(numSignerAccountsDescription)],
560
+ ["numReadonlySignerAccounts", getMemoizedU8EncoderDescription(numReadonlySignerAccountsDescription)],
561
+ ["numReadonlyNonSignerAccounts", getMemoizedU8EncoderDescription(numReadonlyNonSignerAccountsDescription)]
508
562
  ],
509
- __DEV__ ? {
510
- description: "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses"
511
- } : void 0
563
+ {
564
+ description: messageHeaderDescription
565
+ }
512
566
  );
513
567
  }
514
- function getInstructionCodec() {
515
- return umiSerializers.mapSerializer(
516
- umiSerializers.struct([
517
- [
518
- "programAddressIndex",
519
- umiSerializers.u8(
520
- __DEV__ ? {
521
- description: "The index of the program being called, according to the well-ordered accounts list for this transaction"
522
- } : void 0
523
- )
524
- ],
525
- [
526
- "addressIndices",
527
- umiSerializers.array(
528
- umiSerializers.u8({
529
- description: __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : ""
530
- }),
531
- {
532
- 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" : "",
533
- size: umiSerializers.shortU16()
534
- }
535
- )
536
- ],
537
- [
538
- "data",
539
- umiSerializers.bytes({
540
- description: __DEV__ ? "An optional buffer of data passed to the instruction" : "",
541
- size: umiSerializers.shortU16()
542
- })
543
- ]
544
- ]),
545
- (value) => {
546
- if (value.addressIndices !== void 0 && value.data !== void 0) {
547
- return value;
548
- }
549
- return {
550
- ...value,
551
- addressIndices: value.addressIndices ?? [],
552
- data: value.data ?? new Uint8Array(0)
553
- };
554
- },
555
- (value) => {
556
- if (value.addressIndices.length && value.data.byteLength) {
557
- return value;
558
- }
559
- const { addressIndices, data, ...rest } = value;
560
- return {
561
- ...rest,
562
- ...addressIndices.length ? { addressIndices } : null,
563
- ...data.byteLength ? { data } : null
564
- };
568
+ function getMessageHeaderDecoder() {
569
+ return codecsDataStructures.getStructDecoder(
570
+ [
571
+ ["numSignerAccounts", getMemoizedU8DecoderDescription(numSignerAccountsDescription)],
572
+ ["numReadonlySignerAccounts", getMemoizedU8DecoderDescription(numReadonlySignerAccountsDescription)],
573
+ ["numReadonlyNonSignerAccounts", getMemoizedU8DecoderDescription(numReadonlyNonSignerAccountsDescription)]
574
+ ],
575
+ {
576
+ description: messageHeaderDescription
565
577
  }
566
578
  );
567
579
  }
568
-
569
- // src/serializers/unimplemented.ts
570
- function getError(type, name) {
571
- const functionSuffix = name + type[0].toUpperCase() + type.slice(1);
572
- return new Error(
573
- `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}`
574
- );
580
+ var programAddressIndexDescription = __DEV__ ? "The index of the program being called, according to the well-ordered accounts list for this transaction" : "programAddressIndex";
581
+ var accountIndexDescription = __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : void 0;
582
+ var accountIndicesDescription = __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" : "accountIndices";
583
+ var dataDescription = __DEV__ ? "An optional buffer of data passed to the instruction" : "data";
584
+ var memoizedGetInstructionEncoder;
585
+ function getInstructionEncoder() {
586
+ if (!memoizedGetInstructionEncoder) {
587
+ memoizedGetInstructionEncoder = codecsCore.mapEncoder(
588
+ codecsDataStructures.getStructEncoder([
589
+ ["programAddressIndex", codecsNumbers.getU8Encoder({ description: programAddressIndexDescription })],
590
+ [
591
+ "accountIndices",
592
+ codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder({ description: accountIndexDescription }), {
593
+ description: accountIndicesDescription,
594
+ size: codecsNumbers.getShortU16Encoder()
595
+ })
596
+ ],
597
+ ["data", codecsDataStructures.getBytesEncoder({ description: dataDescription, size: codecsNumbers.getShortU16Encoder() })]
598
+ ]),
599
+ // Convert an instruction to have all fields defined
600
+ (instruction) => {
601
+ if (instruction.accountIndices !== void 0 && instruction.data !== void 0) {
602
+ return instruction;
603
+ }
604
+ return {
605
+ ...instruction,
606
+ accountIndices: instruction.accountIndices ?? [],
607
+ data: instruction.data ?? new Uint8Array(0)
608
+ };
609
+ }
610
+ );
611
+ }
612
+ return memoizedGetInstructionEncoder;
575
613
  }
576
- function getUnimplementedDecoder(name) {
577
- return () => {
578
- throw getError("decoder", name);
579
- };
614
+ var memoizedGetInstructionDecoder;
615
+ function getInstructionDecoder() {
616
+ if (!memoizedGetInstructionDecoder) {
617
+ memoizedGetInstructionDecoder = codecsCore.mapDecoder(
618
+ codecsDataStructures.getStructDecoder([
619
+ ["programAddressIndex", codecsNumbers.getU8Decoder({ description: programAddressIndexDescription })],
620
+ [
621
+ "accountIndices",
622
+ codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder({ description: accountIndexDescription }), {
623
+ description: accountIndicesDescription,
624
+ size: codecsNumbers.getShortU16Decoder()
625
+ })
626
+ ],
627
+ ["data", codecsDataStructures.getBytesDecoder({ description: dataDescription, size: codecsNumbers.getShortU16Decoder() })]
628
+ ]),
629
+ // Convert an instruction to exclude optional fields if they are empty
630
+ (instruction) => {
631
+ if (instruction.accountIndices.length && instruction.data.byteLength) {
632
+ return instruction;
633
+ }
634
+ const { accountIndices, data, ...rest } = instruction;
635
+ return {
636
+ ...rest,
637
+ ...accountIndices.length ? { accountIndices } : null,
638
+ ...data.byteLength ? { data } : null
639
+ };
640
+ }
641
+ );
642
+ }
643
+ return memoizedGetInstructionDecoder;
580
644
  }
581
-
582
- // src/serializers/transaction-version.ts
583
645
  var VERSION_FLAG_MASK = 128;
584
646
  var BASE_CONFIG = {
585
647
  description: __DEV__ ? "A single byte that encodes the version of the transaction" : "",
586
648
  fixedSize: null,
587
649
  maxSize: 1
588
650
  };
589
- function deserialize(bytes3, offset = 0) {
590
- const firstByte = bytes3[offset];
651
+ function decode(bytes, offset = 0) {
652
+ const firstByte = bytes[offset];
591
653
  if ((firstByte & VERSION_FLAG_MASK) === 0) {
592
654
  return ["legacy", offset];
593
655
  } else {
@@ -595,7 +657,7 @@ function deserialize(bytes3, offset = 0) {
595
657
  return [version, offset + 1];
596
658
  }
597
659
  }
598
- function serialize(value) {
660
+ function encode(value) {
599
661
  if (value === "legacy") {
600
662
  return new Uint8Array();
601
663
  }
@@ -604,105 +666,143 @@ function serialize(value) {
604
666
  }
605
667
  return new Uint8Array([value | VERSION_FLAG_MASK]);
606
668
  }
607
- function getTransactionVersionCodec() {
669
+ function getTransactionVersionDecoder() {
608
670
  return {
609
671
  ...BASE_CONFIG,
610
- deserialize,
611
- serialize
672
+ decode
673
+ };
674
+ }
675
+ function getTransactionVersionEncoder() {
676
+ return {
677
+ ...BASE_CONFIG,
678
+ encode
612
679
  };
613
680
  }
614
681
 
615
682
  // src/serializers/message.ts
616
- var BASE_CONFIG2 = {
617
- description: __DEV__ ? "The wire format of a Solana transaction message" : "",
618
- fixedSize: null,
619
- maxSize: null
620
- };
621
- function serialize2(compiledMessage) {
622
- if (compiledMessage.version === "legacy") {
623
- return umiSerializers.struct(getPreludeStructSerializerTuple()).serialize(compiledMessage);
624
- } else {
625
- return umiSerializers.mapSerializer(
626
- umiSerializers.struct([
627
- ...getPreludeStructSerializerTuple(),
628
- ["addressTableLookups", getAddressTableLookupsSerializer()]
629
- ]),
630
- (value) => {
631
- if (value.version === "legacy") {
632
- return value;
633
- }
634
- return {
635
- ...value,
636
- addressTableLookups: value.addressTableLookups ?? []
637
- };
683
+ var staticAccountsDescription = __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "staticAccounts";
684
+ var lifetimeTokenDescription = __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "lifetimeToken";
685
+ var instructionsDescription = __DEV__ ? "A compact-array of instructions belonging to this transaction" : "instructions";
686
+ var addressTableLookupsDescription = __DEV__ ? "A compact array of address table lookups belonging to this transaction" : "addressTableLookups";
687
+ function getCompiledMessageLegacyEncoder() {
688
+ return codecsDataStructures.getStructEncoder(getPreludeStructEncoderTuple());
689
+ }
690
+ function getCompiledMessageVersionedEncoder() {
691
+ return codecsCore.mapEncoder(
692
+ codecsDataStructures.getStructEncoder([
693
+ ...getPreludeStructEncoderTuple(),
694
+ ["addressTableLookups", getAddressTableLookupArrayEncoder()]
695
+ ]),
696
+ (value) => {
697
+ if (value.version === "legacy") {
698
+ return value;
638
699
  }
639
- ).serialize(compiledMessage);
640
- }
700
+ return {
701
+ ...value,
702
+ addressTableLookups: value.addressTableLookups ?? []
703
+ };
704
+ }
705
+ );
641
706
  }
642
- function getPreludeStructSerializerTuple() {
707
+ function getPreludeStructEncoderTuple() {
643
708
  return [
644
- ["version", getTransactionVersionCodec()],
645
- ["header", getMessageHeaderCodec()],
709
+ ["version", getTransactionVersionEncoder()],
710
+ ["header", getMessageHeaderEncoder()],
646
711
  [
647
712
  "staticAccounts",
648
- umiSerializers.array(keys.getBase58EncodedAddressCodec(), {
649
- description: __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "",
650
- size: umiSerializers.shortU16()
713
+ codecsDataStructures.getArrayEncoder(addresses.getAddressEncoder(), {
714
+ description: staticAccountsDescription,
715
+ size: codecsNumbers.getShortU16Encoder()
651
716
  })
652
717
  ],
653
718
  [
654
719
  "lifetimeToken",
655
- umiSerializers.string({
656
- description: __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "",
657
- encoding: umiSerializers.base58,
720
+ codecsStrings.getStringEncoder({
721
+ description: lifetimeTokenDescription,
722
+ encoding: codecsStrings.getBase58Encoder(),
658
723
  size: 32
659
724
  })
660
725
  ],
661
726
  [
662
727
  "instructions",
663
- umiSerializers.array(getInstructionCodec(), {
664
- description: __DEV__ ? "A compact-array of instructions belonging to this transaction" : "",
665
- size: umiSerializers.shortU16()
728
+ codecsDataStructures.getArrayEncoder(getInstructionEncoder(), {
729
+ description: instructionsDescription,
730
+ size: codecsNumbers.getShortU16Encoder()
666
731
  })
667
732
  ]
668
733
  ];
669
734
  }
670
- function getAddressTableLookupsSerializer() {
671
- return umiSerializers.array(getAddressTableLookupCodec(), {
672
- ...__DEV__ ? { description: "A compact array of address table lookups belonging to this transaction" } : null,
673
- size: umiSerializers.shortU16()
735
+ function getPreludeStructDecoderTuple() {
736
+ return [
737
+ ["version", getTransactionVersionDecoder()],
738
+ ["header", getMessageHeaderDecoder()],
739
+ [
740
+ "staticAccounts",
741
+ codecsDataStructures.getArrayDecoder(addresses.getAddressDecoder(), {
742
+ description: staticAccountsDescription,
743
+ size: codecsNumbers.getShortU16Decoder()
744
+ })
745
+ ],
746
+ [
747
+ "lifetimeToken",
748
+ codecsStrings.getStringDecoder({
749
+ description: lifetimeTokenDescription,
750
+ encoding: codecsStrings.getBase58Decoder(),
751
+ size: 32
752
+ })
753
+ ],
754
+ [
755
+ "instructions",
756
+ codecsDataStructures.getArrayDecoder(getInstructionDecoder(), {
757
+ description: instructionsDescription,
758
+ size: codecsNumbers.getShortU16Decoder()
759
+ })
760
+ ],
761
+ ["addressTableLookups", getAddressTableLookupArrayDecoder()]
762
+ ];
763
+ }
764
+ function getAddressTableLookupArrayEncoder() {
765
+ return codecsDataStructures.getArrayEncoder(getAddressTableLookupEncoder(), {
766
+ description: addressTableLookupsDescription,
767
+ size: codecsNumbers.getShortU16Encoder()
768
+ });
769
+ }
770
+ function getAddressTableLookupArrayDecoder() {
771
+ return codecsDataStructures.getArrayDecoder(getAddressTableLookupDecoder(), {
772
+ description: addressTableLookupsDescription,
773
+ size: codecsNumbers.getShortU16Decoder()
674
774
  });
675
775
  }
776
+ var messageDescription = __DEV__ ? "The wire format of a Solana transaction message" : "message";
676
777
  function getCompiledMessageEncoder() {
677
778
  return {
678
- ...BASE_CONFIG2,
679
- deserialize: getUnimplementedDecoder("CompiledMessage"),
680
- serialize: serialize2
779
+ description: messageDescription,
780
+ encode: (compiledMessage) => {
781
+ if (compiledMessage.version === "legacy") {
782
+ return getCompiledMessageLegacyEncoder().encode(compiledMessage);
783
+ } else {
784
+ return getCompiledMessageVersionedEncoder().encode(compiledMessage);
785
+ }
786
+ },
787
+ fixedSize: null,
788
+ maxSize: null
681
789
  };
682
790
  }
683
-
684
- // src/signatures.ts
685
- async function getCompiledMessageSignature(message, secretKey) {
686
- const wireMessageBytes = getCompiledMessageEncoder().serialize(message);
687
- const signature = await keys.signBytes(secretKey, wireMessageBytes);
688
- return signature;
791
+ function getCompiledMessageDecoder() {
792
+ return codecsCore.mapDecoder(
793
+ codecsDataStructures.getStructDecoder(getPreludeStructDecoderTuple(), {
794
+ description: messageDescription
795
+ }),
796
+ ({ addressTableLookups, ...restOfMessage }) => {
797
+ if (restOfMessage.version === "legacy" || !addressTableLookups?.length) {
798
+ return restOfMessage;
799
+ }
800
+ return { ...restOfMessage, addressTableLookups };
801
+ }
802
+ );
689
803
  }
690
- async function signTransaction(keyPair, transaction) {
691
- const compiledMessage = compileMessage(transaction);
692
- const [signerPublicKey, signature] = await Promise.all([
693
- keys.getBase58EncodedAddressFromPublicKey(keyPair.publicKey),
694
- getCompiledMessageSignature(compiledMessage, keyPair.privateKey)
695
- ]);
696
- const nextSignatures = {
697
- ..."signatures" in transaction ? transaction.signatures : null,
698
- ...{ [signerPublicKey]: signature }
699
- };
700
- const out = {
701
- ...transaction,
702
- signatures: nextSignatures
703
- };
704
- Object.freeze(out);
705
- return out;
804
+ function getCompiledMessageCodec() {
805
+ return codecsCore.combineCodec(getCompiledMessageEncoder(), getCompiledMessageDecoder());
706
806
  }
707
807
 
708
808
  // src/compile-transaction.ts
@@ -722,51 +822,239 @@ function getCompiledTransaction(transaction) {
722
822
  signatures
723
823
  };
724
824
  }
825
+ function getAccountMetas(message) {
826
+ const { header } = message;
827
+ const numWritableSignerAccounts = header.numSignerAccounts - header.numReadonlySignerAccounts;
828
+ const numWritableNonSignerAccounts = message.staticAccounts.length - header.numSignerAccounts - header.numReadonlyNonSignerAccounts;
829
+ const accountMetas = [];
830
+ let accountIndex = 0;
831
+ for (let i = 0; i < numWritableSignerAccounts; i++) {
832
+ accountMetas.push({
833
+ address: message.staticAccounts[accountIndex],
834
+ role: AccountRole.WRITABLE_SIGNER
835
+ });
836
+ accountIndex++;
837
+ }
838
+ for (let i = 0; i < header.numReadonlySignerAccounts; i++) {
839
+ accountMetas.push({
840
+ address: message.staticAccounts[accountIndex],
841
+ role: AccountRole.READONLY_SIGNER
842
+ });
843
+ accountIndex++;
844
+ }
845
+ for (let i = 0; i < numWritableNonSignerAccounts; i++) {
846
+ accountMetas.push({
847
+ address: message.staticAccounts[accountIndex],
848
+ role: AccountRole.WRITABLE
849
+ });
850
+ accountIndex++;
851
+ }
852
+ for (let i = 0; i < header.numReadonlyNonSignerAccounts; i++) {
853
+ accountMetas.push({
854
+ address: message.staticAccounts[accountIndex],
855
+ role: AccountRole.READONLY
856
+ });
857
+ accountIndex++;
858
+ }
859
+ return accountMetas;
860
+ }
861
+ function convertInstruction(instruction, accountMetas) {
862
+ const programAddress = accountMetas[instruction.programAddressIndex]?.address;
863
+ if (!programAddress) {
864
+ throw new Error(`Could not find program address at index ${instruction.programAddressIndex}`);
865
+ }
866
+ const accounts = instruction.accountIndices?.map((accountIndex) => accountMetas[accountIndex]);
867
+ const { data } = instruction;
868
+ return {
869
+ programAddress,
870
+ ...accounts && accounts.length ? { accounts } : {},
871
+ ...data && data.length ? { data } : {}
872
+ };
873
+ }
874
+ function getLifetimeConstraint(messageLifetimeToken, firstInstruction, lastValidBlockHeight) {
875
+ if (!firstInstruction || !isAdvanceNonceAccountInstruction(firstInstruction)) {
876
+ return {
877
+ blockhash: messageLifetimeToken,
878
+ lastValidBlockHeight: lastValidBlockHeight ?? 2n ** 64n - 1n
879
+ // U64 MAX
880
+ };
881
+ } else {
882
+ const nonceAccountAddress = firstInstruction.accounts[0].address;
883
+ addresses.assertIsAddress(nonceAccountAddress);
884
+ const nonceAuthorityAddress = firstInstruction.accounts[2].address;
885
+ addresses.assertIsAddress(nonceAuthorityAddress);
886
+ return {
887
+ nonce: messageLifetimeToken,
888
+ nonceAccountAddress,
889
+ nonceAuthorityAddress
890
+ };
891
+ }
892
+ }
893
+ function convertSignatures(compiledTransaction) {
894
+ const {
895
+ compiledMessage: { staticAccounts },
896
+ signatures
897
+ } = compiledTransaction;
898
+ return signatures.reduce((acc, sig, index) => {
899
+ const allZeros = sig.every((byte) => byte === 0);
900
+ if (allZeros)
901
+ return acc;
902
+ const address = staticAccounts[index];
903
+ return { ...acc, [address]: sig };
904
+ }, {});
905
+ }
906
+ function decompileTransaction(compiledTransaction, lastValidBlockHeight) {
907
+ const { compiledMessage } = compiledTransaction;
908
+ if ("addressTableLookups" in compiledMessage && compiledMessage.addressTableLookups.length > 0) {
909
+ throw new Error("Cannot convert transaction with addressTableLookups");
910
+ }
911
+ const feePayer = compiledMessage.staticAccounts[0];
912
+ if (!feePayer)
913
+ throw new Error("No fee payer set in CompiledTransaction");
914
+ const accountMetas = getAccountMetas(compiledMessage);
915
+ const instructions = compiledMessage.instructions.map(
916
+ (compiledInstruction) => convertInstruction(compiledInstruction, accountMetas)
917
+ );
918
+ const firstInstruction = instructions[0];
919
+ const lifetimeConstraint = getLifetimeConstraint(
920
+ compiledMessage.lifetimeToken,
921
+ firstInstruction,
922
+ lastValidBlockHeight
923
+ );
924
+ const signatures = convertSignatures(compiledTransaction);
925
+ return functional.pipe(
926
+ createTransaction({ version: compiledMessage.version }),
927
+ (tx) => setTransactionFeePayer(feePayer, tx),
928
+ (tx) => instructions.reduce((acc, instruction) => {
929
+ return appendTransactionInstruction(instruction, acc);
930
+ }, tx),
931
+ (tx) => "blockhash" in lifetimeConstraint ? setTransactionLifetimeUsingBlockhash(lifetimeConstraint, tx) : setTransactionLifetimeUsingDurableNonce(lifetimeConstraint, tx),
932
+ (tx) => compiledTransaction.signatures.length ? { ...tx, signatures } : tx
933
+ );
934
+ }
725
935
 
726
936
  // src/serializers/transaction.ts
727
- var BASE_CONFIG3 = {
728
- description: __DEV__ ? "The wire format of a Solana transaction" : "",
729
- fixedSize: null,
730
- maxSize: null
731
- };
732
- function serialize3(transaction) {
733
- const compiledTransaction = getCompiledTransaction(transaction);
734
- return umiSerializers.struct([
937
+ var signaturesDescription = __DEV__ ? "A compact array of 64-byte, base-64 encoded Ed25519 signatures" : "signatures";
938
+ var transactionDescription = __DEV__ ? "The wire format of a Solana transaction" : "transaction";
939
+ function getCompiledTransactionEncoder() {
940
+ return codecsDataStructures.getStructEncoder(
735
941
  [
736
- "signatures",
737
- umiSerializers.array(umiSerializers.bytes({ size: 64 }), {
738
- ...__DEV__ ? { description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } : null,
739
- size: umiSerializers.shortU16()
740
- })
942
+ [
943
+ "signatures",
944
+ codecsDataStructures.getArrayEncoder(codecsDataStructures.getBytesEncoder({ size: 64 }), {
945
+ description: signaturesDescription,
946
+ size: codecsNumbers.getShortU16Encoder()
947
+ })
948
+ ],
949
+ ["compiledMessage", getCompiledMessageEncoder()]
950
+ ],
951
+ {
952
+ description: transactionDescription
953
+ }
954
+ );
955
+ }
956
+ function getSignatureDecoder() {
957
+ return codecsCore.mapDecoder(codecsDataStructures.getBytesDecoder({ size: 64 }), (bytes) => bytes);
958
+ }
959
+ function getCompiledTransactionDecoder() {
960
+ return codecsDataStructures.getStructDecoder(
961
+ [
962
+ [
963
+ "signatures",
964
+ codecsDataStructures.getArrayDecoder(getSignatureDecoder(), {
965
+ description: signaturesDescription,
966
+ size: codecsNumbers.getShortU16Decoder()
967
+ })
968
+ ],
969
+ ["compiledMessage", getCompiledMessageDecoder()]
741
970
  ],
742
- ["compiledMessage", getCompiledMessageEncoder()]
743
- ]).serialize(compiledTransaction);
971
+ {
972
+ description: transactionDescription
973
+ }
974
+ );
744
975
  }
745
976
  function getTransactionEncoder() {
746
- return {
747
- ...BASE_CONFIG3,
748
- deserialize: getUnimplementedDecoder("CompiledMessage"),
749
- serialize: serialize3
977
+ return codecsCore.mapEncoder(getCompiledTransactionEncoder(), getCompiledTransaction);
978
+ }
979
+ function getTransactionDecoder(lastValidBlockHeight) {
980
+ return codecsCore.mapDecoder(
981
+ getCompiledTransactionDecoder(),
982
+ (compiledTransaction) => decompileTransaction(compiledTransaction, lastValidBlockHeight)
983
+ );
984
+ }
985
+ function getTransactionCodec(lastValidBlockHeight) {
986
+ return codecsCore.combineCodec(getTransactionEncoder(), getTransactionDecoder(lastValidBlockHeight));
987
+ }
988
+ var base58Decoder;
989
+ function getSignatureFromTransaction(transaction) {
990
+ if (!base58Decoder)
991
+ base58Decoder = codecsStrings.getBase58Decoder();
992
+ const signatureBytes = transaction.signatures[transaction.feePayer];
993
+ if (!signatureBytes) {
994
+ throw new Error(
995
+ "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
996
+ );
997
+ }
998
+ const transactionSignature = base58Decoder.decode(signatureBytes)[0];
999
+ return transactionSignature;
1000
+ }
1001
+ async function partiallySignTransaction(keyPairs, transaction) {
1002
+ const compiledMessage = compileMessage(transaction);
1003
+ const nextSignatures = "signatures" in transaction ? { ...transaction.signatures } : {};
1004
+ const wireMessageBytes = getCompiledMessageEncoder().encode(compiledMessage);
1005
+ const publicKeySignaturePairs = await Promise.all(
1006
+ keyPairs.map(
1007
+ (keyPair) => Promise.all([addresses.getAddressFromPublicKey(keyPair.publicKey), keys.signBytes(keyPair.privateKey, wireMessageBytes)])
1008
+ )
1009
+ );
1010
+ for (const [signerPublicKey, signature] of publicKeySignaturePairs) {
1011
+ nextSignatures[signerPublicKey] = signature;
1012
+ }
1013
+ const out = {
1014
+ ...transaction,
1015
+ signatures: nextSignatures
750
1016
  };
1017
+ Object.freeze(out);
1018
+ return out;
1019
+ }
1020
+ async function signTransaction(keyPairs, transaction) {
1021
+ const out = await partiallySignTransaction(keyPairs, transaction);
1022
+ assertTransactionIsFullySigned(out);
1023
+ Object.freeze(out);
1024
+ return out;
1025
+ }
1026
+ function assertTransactionIsFullySigned(transaction) {
1027
+ const signerAddressesFromInstructions = transaction.instructions.flatMap((i) => i.accounts?.filter((a) => isSignerRole(a.role)) ?? []).map((a) => a.address);
1028
+ const requiredSigners = /* @__PURE__ */ new Set([transaction.feePayer, ...signerAddressesFromInstructions]);
1029
+ requiredSigners.forEach((address) => {
1030
+ if (!transaction.signatures[address]) {
1031
+ throw new Error(`Transaction is missing signature for address \`${address}\``);
1032
+ }
1033
+ });
751
1034
  }
752
-
753
- // src/wire-transaction.ts
754
1035
  function getBase64EncodedWireTransaction(transaction) {
755
- const wireTransactionBytes = getTransactionEncoder().serialize(transaction);
756
- {
757
- return btoa(String.fromCharCode(...wireTransactionBytes));
758
- }
1036
+ const wireTransactionBytes = getTransactionEncoder().encode(transaction);
1037
+ return codecsStrings.getBase64Decoder().decode(wireTransactionBytes)[0];
759
1038
  }
760
1039
 
761
1040
  exports.appendTransactionInstruction = appendTransactionInstruction;
762
1041
  exports.assertIsBlockhash = assertIsBlockhash;
763
1042
  exports.assertIsDurableNonceTransaction = assertIsDurableNonceTransaction;
1043
+ exports.assertTransactionIsFullySigned = assertTransactionIsFullySigned;
1044
+ exports.compileMessage = compileMessage;
764
1045
  exports.createTransaction = createTransaction;
765
1046
  exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
1047
+ exports.getCompiledMessageCodec = getCompiledMessageCodec;
1048
+ exports.getCompiledMessageDecoder = getCompiledMessageDecoder;
1049
+ exports.getCompiledMessageEncoder = getCompiledMessageEncoder;
1050
+ exports.getSignatureFromTransaction = getSignatureFromTransaction;
1051
+ exports.getTransactionCodec = getTransactionCodec;
1052
+ exports.getTransactionDecoder = getTransactionDecoder;
1053
+ exports.getTransactionEncoder = getTransactionEncoder;
1054
+ exports.isAdvanceNonceAccountInstruction = isAdvanceNonceAccountInstruction;
1055
+ exports.partiallySignTransaction = partiallySignTransaction;
766
1056
  exports.prependTransactionInstruction = prependTransactionInstruction;
767
1057
  exports.setTransactionFeePayer = setTransactionFeePayer;
768
1058
  exports.setTransactionLifetimeUsingBlockhash = setTransactionLifetimeUsingBlockhash;
769
1059
  exports.setTransactionLifetimeUsingDurableNonce = setTransactionLifetimeUsingDurableNonce;
770
1060
  exports.signTransaction = signTransaction;
771
- //# sourceMappingURL=out.js.map
772
- //# sourceMappingURL=index.browser.cjs.map