@solana/transactions 2.0.0-experimental.0108bc7 → 2.0.0-experimental.025ef21

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