@solana/transactions 2.0.0-experimental.dacecb7 → 2.0.0-experimental.dbe6a73

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