@solana/transactions 3.0.0-canary-20250722092257 → 3.0.0-canary-20250722095653

package/dist/types/sendable-transaction.d.ts

@@ -0,0 +1,62 @@
+import { FullySignedTransaction } from './signatures';
+import { Transaction } from './transaction';
+import { TransactionWithinSizeLimit } from './transaction-size';
+/**
+ * Helper type that includes all transaction types required
+ * for the transaction to be sent to the network.
+ *
+ * @see {@link isSendableTransaction}
+ * @see {@link assertIsSendableTransaction}
+ */
+export type SendableTransaction = FullySignedTransaction & TransactionWithinSizeLimit;
+/**
+ * Checks if a transaction has all the required
+ * conditions to be sent to the network.
+ *
+ * @example
+ * ```ts
+ * import { isSendableTransaction } from '@solana/transactions';
+ *
+ * const transaction = getTransactionDecoder().decode(transactionBytes);
+ * if (isSendableTransaction(transaction)) {
+ *   // At this point we know that the transaction can be sent to the network.
+ * }
+ * ```
+ *
+ * @see {@link assertIsSendableTransaction}
+ */
+export declare function isSendableTransaction<TTransaction extends Transaction>(transaction: TTransaction): transaction is SendableTransaction & TTransaction;
+/**
+ * Asserts that a given transaction has all the
+ * required conditions to be sent to the network.
+ *
+ * From time to time you might acquire a {@link Transaction}
+ * from an untrusted network API or user input and you are not sure
+ * that it has all the required conditions to be sent to the network
+ * — such as being fully signed and within the size limit.
+ * This function can be used to assert that such a transaction
+ * is in fact sendable.
+ *
+ * @example
+ * ```ts
+ * import { assertIsSendableTransaction } from '@solana/transactions';
+ *
+ * const transaction = getTransactionDecoder().decode(transactionBytes);
+ * try {
+ *     // If this type assertion function doesn't throw, then Typescript will upcast `transaction`
+ *     // to `SendableTransaction`.
+ *     assertIsSendableTransaction(transaction);
+ *     // At this point we know that the transaction can be sent to the network.
+ *     await sendAndConfirmTransaction(transaction, { commitment: 'confirmed' });
+ * } catch(e) {
+ *     if (isSolanaError(e, SOLANA_ERROR__TRANSACTION__SIGNATURES_MISSING)) {
+ *         setError(`Missing signatures for ${e.context.addresses.join(', ')}`);
+ *     } else if (isSolanaError(e, SOLANA_ERROR__TRANSACTION__EXCEEDS_SIZE_LIMIT)) {
+ *         setError(`Transaction exceeds size limit of ${e.context.transactionSizeLimit} bytes`);
+ *     }
+ *     throw;
+ * }
+ * ```
+ */
+export declare function assertIsSendableTransaction<TTransaction extends Transaction>(transaction: TTransaction): asserts transaction is SendableTransaction & TTransaction;
+//# sourceMappingURL=sendable-transaction.d.ts.map

package/dist/types/sendable-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendable-transaction.d.ts","sourceRoot":"","sources":["../../src/sendable-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,sBAAsB,EAA4B,MAAM,cAAc,CAAC;AAChH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAGH,0BAA0B,EAC7B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,0BAA0B,CAAC;AAEtF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,SAAS,WAAW,EAClE,WAAW,EAAE,YAAY,GAC1B,WAAW,IAAI,mBAAmB,GAAG,YAAY,CAEnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,SAAS,WAAW,EACxE,WAAW,EAAE,YAAY,GAC1B,OAAO,CAAC,WAAW,IAAI,mBAAmB,GAAG,YAAY,CAG3D"}

package/dist/types/signatures.d.ts

@@ -6,7 +6,7 @@ import { Transaction } from './transaction';
  * Represents a transaction that is signed by all of its required signers. Being fully signed is a
  * prerequisite of functions designed to land transactions on the network.
  */
-export type FullySignedTransaction = NominalType<'transactionSignedness', 'fullySigned'> & Transaction;
+export type FullySignedTransaction = NominalType<'transactionSignedness', 'fullySigned'>;
 /**
  * Given a transaction signed by its fee payer, this method will return the {@link Signature} that
  * uniquely identifies it. This string can be used to look up transactions at a later date, for
@@ -41,7 +41,7 @@ export declare function getSignatureFromTransaction(transaction: Transaction): S
  * @see {@link signTransaction} if you want to assert that the transaction has all of its required
  * signatures after signing.
  */
-export declare function partiallySignTransaction<T extends Transaction & TransactionWithLifetime>(keyPairs: CryptoKeyPair[], transaction: T): Promise<T>;
+export declare function partiallySignTransaction<TTransaction extends Transaction & TransactionWithLifetime>(keyPairs: CryptoKeyPair[], transaction: TTransaction): Promise<TTransaction>;
 /**
  * Given an array of `CryptoKey` objects which are private keys pertaining to addresses that are
  * required to sign a transaction, this method will return a new signed transaction of type
@@ -60,7 +60,7 @@ export declare function partiallySignTransaction<T extends Transaction & Transac
  * @see {@link partiallySignTransaction} if you want to sign the transaction without asserting that
  * the resulting transaction is fully signed.
  */
-export declare function signTransaction<T extends Transaction & TransactionWithLifetime>(keyPairs: CryptoKeyPair[], transaction: T): Promise<FullySignedTransaction & T>;
+export declare function signTransaction<TTransaction extends Transaction & TransactionWithLifetime>(keyPairs: CryptoKeyPair[], transaction: TTransaction): Promise<FullySignedTransaction & TTransaction>;
 /**
  * Checks whether a given {@link Transaction} is fully signed.
  *

package/dist/types/signatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signatures.d.ts","sourceRoot":"","sources":["../../src/signatures.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAA6B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,uBAAuB,EAAE,aAAa,CAAC,GAAG,WAAW,CAAC;AAIvG;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAW/E;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,SAAS,WAAW,GAAG,uBAAuB,EAC1F,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,CAAC,GACf,OAAO,CAAC,CAAC,CAAC,CAqDZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,uBAAuB,EACjF,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,CAAC,GACf,OAAO,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAKrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,SAAS,WAAW,EACrE,WAAW,EAAE,YAAY,GAC1B,WAAW,IAAI,sBAAsB,GAAG,YAAY,CAEtD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,SAAS,WAAW,EAC3E,WAAW,EAAE,YAAY,GAC1B,OAAO,CAAC,WAAW,IAAI,sBAAsB,GAAG,YAAY,CAa9D"}
+{"version":3,"file":"signatures.d.ts","sourceRoot":"","sources":["../../src/signatures.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAA6B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;AAIzF;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAW/E;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAAC,YAAY,SAAS,WAAW,GAAG,uBAAuB,EACrG,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqDvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CAAC,YAAY,SAAS,WAAW,GAAG,uBAAuB,EAC5F,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,EAAE,YAAY,GAC1B,OAAO,CAAC,sBAAsB,GAAG,YAAY,CAAC,CAKhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,SAAS,WAAW,EACrE,WAAW,EAAE,YAAY,GAC1B,WAAW,IAAI,sBAAsB,GAAG,YAAY,CAEtD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,SAAS,WAAW,EAC3E,WAAW,EAAE,YAAY,GAC1B,OAAO,CAAC,WAAW,IAAI,sBAAsB,GAAG,YAAY,CAa9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/transactions",
-  "version": "3.0.0-canary-20250722092257",
+  "version": "3.0.0-canary-20250722095653",
   "description": "Helpers for creating and serializing transactions",
   "exports": {
     "edge-light": {
@@ -54,18 +54,18 @@
     "maintained node versions"
   ],
   "dependencies": {
-    "@solana/addresses": "3.0.0-canary-20250722092257",
-    "@solana/codecs-core": "3.0.0-canary-20250722092257",
-    "@solana/codecs-data-structures": "3.0.0-canary-20250722092257",
-    "@solana/codecs-numbers": "3.0.0-canary-20250722092257",
-    "@solana/codecs-strings": "3.0.0-canary-20250722092257",
-    "@solana/errors": "3.0.0-canary-20250722092257",
-    "@solana/functional": "3.0.0-canary-20250722092257",
-    "@solana/keys": "3.0.0-canary-20250722092257",
-    "@solana/instructions": "3.0.0-canary-20250722092257",
-    "@solana/nominal-types": "3.0.0-canary-20250722092257",
-    "@solana/transaction-messages": "3.0.0-canary-20250722092257",
-    "@solana/rpc-types": "3.0.0-canary-20250722092257"
+    "@solana/codecs-core": "3.0.0-canary-20250722095653",
+    "@solana/codecs-data-structures": "3.0.0-canary-20250722095653",
+    "@solana/codecs-numbers": "3.0.0-canary-20250722095653",
+    "@solana/addresses": "3.0.0-canary-20250722095653",
+    "@solana/codecs-strings": "3.0.0-canary-20250722095653",
+    "@solana/errors": "3.0.0-canary-20250722095653",
+    "@solana/functional": "3.0.0-canary-20250722095653",
+    "@solana/keys": "3.0.0-canary-20250722095653",
+    "@solana/instructions": "3.0.0-canary-20250722095653",
+    "@solana/nominal-types": "3.0.0-canary-20250722095653",
+    "@solana/rpc-types": "3.0.0-canary-20250722095653",
+    "@solana/transaction-messages": "3.0.0-canary-20250722095653"
   },
   "peerDependencies": {
     "typescript": ">=5.3.3"