@phantom/browser-sdk 1.0.6 → 1.0.7

package/README.md

@@ -985,6 +985,46 @@ function toggleDebug(enabled: boolean) {
 }
 ```
 
+## Dapp-Sponsored Transactions (presignTransaction)
+
+Pass `presignTransaction` directly to `signAndSendTransaction` for calls that need co-signing. Calls without it proceed normally — it is never applied globally.
+
+> **Important:** Phantom embedded wallets do not accept pre-signed transactions. If your use case requires a second signer (e.g. your app as the fee payer), that signing must happen via this option, after Phantom has constructed and validated the transaction. This restriction does not apply to injected providers (e.g. the Phantom browser extension).
+
+> **Note:** `presignTransaction` only fires for Solana transactions via the embedded provider. EVM transactions and injected providers are unaffected.
+
+### Transaction format
+
+The `transaction` string is **base64url-encoded** (URL-safe base64 without `=` padding, using `-` and `_` instead of `+` and `/`).
+
+The SDK exports `base64urlDecode` and `base64urlEncode` utilities:
+
+```ts
+import { base64urlDecode, base64urlEncode } from "@phantom/browser-sdk";
+```
+
+### Example: Dapp fee payer
+
+```ts
+import { base64urlDecode, base64urlEncode } from "@phantom/browser-sdk";
+import { Keypair, VersionedTransaction } from "@solana/web3.js";
+
+const feePayerKeypair = Keypair.fromSecretKey(/* your fee payer secret key */);
+
+// This call co-signs as fee payer
+const result = await sdk.solana.signAndSendTransaction(transaction, {
+  presignTransaction: async (tx, context) => {
+    const txBytes = base64urlDecode(tx);
+    const versionedTx = VersionedTransaction.deserialize(txBytes);
+    versionedTx.sign([feePayerKeypair]);
+    return base64urlEncode(versionedTx.serialize());
+  },
+});
+
+// This call has no co-signer
+const result2 = await sdk.solana.signAndSendTransaction(otherTransaction);
+```
+
 ## Transaction Examples
 
 ### Solana Transactions

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 import { EmbeddedProviderConfig, EmbeddedProviderAuthType, ConnectResult as ConnectResult$1, WalletAddress, EmbeddedProviderEvent, EventCallback } from '@phantom/embedded-provider-core';
 export { ConnectErrorEventData, ConnectEventData, ConnectStartEventData, DisconnectEventData, EmbeddedProviderEvent, EmbeddedProviderEventMap, EventCallback, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
 import { IEthereumChain, ISolanaChain } from '@phantom/chain-interfaces';
-export { EthTransactionRequest, IEthereumChain, ISolanaChain } from '@phantom/chain-interfaces';
+export { EthTransactionRequest, IEthereumChain, ISolanaChain, SignAndSendTransactionOptions } from '@phantom/chain-interfaces';
 import { AddressType } from '@phantom/client';
-export { AddressType } from '@phantom/client';
+export { AddressType, PresignTransactionContext } from '@phantom/client';
 import { AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult } from '@phantom/browser-injected-sdk/auto-confirm';
 export { AutoConfirmEnableParams, AutoConfirmResult, AutoConfirmSupportedChainsResult } from '@phantom/browser-injected-sdk/auto-confirm';
 export { NetworkId, PHANTOM_ICON } from '@phantom/constants';
+export { base64urlDecode, base64urlEncode } from '@phantom/base64url';
 
 declare enum DebugLevel {
     ERROR = 0,

package/dist/index.js

@@ -36,6 +36,8 @@ __export(src_exports, {
   DebugLevel: () => DebugLevel,
   NetworkId: () => import_constants8.NetworkId,
   PHANTOM_ICON: () => import_constants9.PHANTOM_ICON,
+  base64urlDecode: () => import_base64url2.base64urlDecode,
+  base64urlEncode: () => import_base64url2.base64urlEncode,
   debug: () => debug,
   detectBrowser: () => detectBrowser,
   getBrowserDisplayName: () => getBrowserDisplayName,
@@ -2764,7 +2766,7 @@ var BrowserAuthProvider = class {
         // OAuth session management - defaults to allow refresh unless explicitly clearing after logout
         clear_previous_session: (phantomOptions.clearPreviousSession ?? false).toString(),
         allow_refresh: (phantomOptions.allowRefresh ?? true).toString(),
-        sdk_version: "1.0.6",
+        sdk_version: "1.0.7",
         sdk_type: "browser",
         platform: detectBrowser().name,
         algorithm: phantomOptions.algorithm || import_constants3.DEFAULT_AUTHENTICATOR_ALGORITHM
@@ -3400,7 +3402,7 @@ var EmbeddedProvider = class extends import_embedded_provider_core.EmbeddedProvi
         [import_constants5.ANALYTICS_HEADERS.CLIENT]: browserName,
         [import_constants5.ANALYTICS_HEADERS.APP_ID]: config.appId,
         [import_constants5.ANALYTICS_HEADERS.WALLET_TYPE]: config.embeddedWalletType,
-        [import_constants5.ANALYTICS_HEADERS.SDK_VERSION]: "1.0.6"
+        [import_constants5.ANALYTICS_HEADERS.SDK_VERSION]: "1.0.7"
         // Replaced at build time
       }
     };
@@ -4168,4 +4170,5 @@ var BrowserSDK = class {
 // src/index.ts
 var import_constants8 = require("@phantom/constants");
 var import_client5 = require("@phantom/client");
+var import_base64url2 = require("@phantom/base64url");
 var import_constants9 = require("@phantom/constants");

package/dist/index.mjs

@@ -2714,7 +2714,7 @@ var BrowserAuthProvider = class {
         // OAuth session management - defaults to allow refresh unless explicitly clearing after logout
         clear_previous_session: (phantomOptions.clearPreviousSession ?? false).toString(),
         allow_refresh: (phantomOptions.allowRefresh ?? true).toString(),
-        sdk_version: "1.0.6",
+        sdk_version: "1.0.7",
         sdk_type: "browser",
         platform: detectBrowser().name,
         algorithm: phantomOptions.algorithm || DEFAULT_AUTHENTICATOR_ALGORITHM
@@ -3355,7 +3355,7 @@ var EmbeddedProvider = class extends CoreEmbeddedProvider {
         [ANALYTICS_HEADERS.CLIENT]: browserName,
         [ANALYTICS_HEADERS.APP_ID]: config.appId,
         [ANALYTICS_HEADERS.WALLET_TYPE]: config.embeddedWalletType,
-        [ANALYTICS_HEADERS.SDK_VERSION]: "1.0.6"
+        [ANALYTICS_HEADERS.SDK_VERSION]: "1.0.7"
         // Replaced at build time
       }
     };
@@ -4125,6 +4125,7 @@ var BrowserSDK = class {
 // src/index.ts
 import { NetworkId } from "@phantom/constants";
 import { AddressType as AddressType4 } from "@phantom/client";
+import { base64urlEncode as base64urlEncode2, base64urlDecode } from "@phantom/base64url";
 import { PHANTOM_ICON as PHANTOM_ICON3 } from "@phantom/constants";
 export {
   AddressType4 as AddressType,
@@ -4133,6 +4134,8 @@ export {
   DebugLevel,
   NetworkId,
   PHANTOM_ICON3 as PHANTOM_ICON,
+  base64urlDecode,
+  base64urlEncode2 as base64urlEncode,
   debug,
   detectBrowser,
   getBrowserDisplayName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/browser-sdk",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Browser SDK for Phantom Wallet",
   "repository": {
     "type": "git",
@@ -34,15 +34,15 @@
   },
   "dependencies": {
     "@phantom/auth2": "^1.0.2",
-    "@phantom/base64url": "^1.0.6",
-    "@phantom/browser-injected-sdk": "^1.0.6",
-    "@phantom/chain-interfaces": "^1.0.6",
-    "@phantom/client": "^1.0.6",
-    "@phantom/constants": "^1.0.6",
-    "@phantom/embedded-provider-core": "^1.0.6",
-    "@phantom/indexed-db-stamper": "^1.0.6",
-    "@phantom/parsers": "^1.0.6",
-    "@phantom/sdk-types": "^1.0.6",
+    "@phantom/base64url": "^1.0.7",
+    "@phantom/browser-injected-sdk": "^1.0.7",
+    "@phantom/chain-interfaces": "^1.0.7",
+    "@phantom/client": "^1.0.7",
+    "@phantom/constants": "^1.0.7",
+    "@phantom/embedded-provider-core": "^1.0.7",
+    "@phantom/indexed-db-stamper": "^1.0.7",
+    "@phantom/parsers": "^1.0.7",
+    "@phantom/sdk-types": "^1.0.7",
     "axios": "^1.10.0",
     "bs58": "^6.0.0",
     "buffer": "^6.0.3",