@solana/transactions 2.0.0-experimental.cc545f9 → 2.0.0-experimental.cc94aa3

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