🏗
Integrating Phantom
👻
Best Practices
Sending a Transaction
Once a web application is connected to Phantom, it can prompt the user for permission to send transactions on their behalf.
In order to send a transaction, a web application must:
- 1.Create an unsigned transaction.
- 2.Have the transaction be signed and submitted to the network by the user's Phantom wallet.
- 3.Optionally await network confirmation using a Solana JSON RPC connection.
For more information about the nature of Solana transactions, please review the
solana-web3.js docs as well as the Solana Cookbook.Signing and Sending a Transaction
Once a transaction is created, the web application may ask the user's Phantom wallet to sign and send the transaction. If accepted, Phantom will sign the transaction with the user's private key and submit it via a Solana JSON RPC connection. By far the easiest and most recommended way of doing this is by using the
signAndSendTransaction method on the provider, but it is also possible to do with request. In both cases, the call will return a Promise for an object containing the signature.signAndSendTransaction()
request()
1
const network = "<NETWORK_URL>";
2
const connection = new Connection(network);
3
const transaction = new Transaction();
4
const { signature } = await window.solana.signAndSendTransaction(transaction);
5
await connection.confirmTransaction(signature);
Copied!
1
const network = "<NETWORK_URL>";
2
const connection = new Connection(network);
3
const transaction = new Transaction();
4
const { signature } = await window.solana.request({
5
method: "signAndSendTransaction",
6
params: {
7
message: bs58.encode(transaction.serializeMessage()),
8
},
9
});
10
await connection.confirmTransaction(signature);
Copied!
You can also specify a
SendOptions object as a second argument into signAndSendTransaction or as an options parameter when using request.Other Signing Methods
The following methods are also supported, but are not recommended over
signAndSendTransaction. It is safer for users, and a simpler API for developers, for Phantom to submit the transaction immediately after signing it instead of relying on the application to do so. If you use the methods below, Phantom will display a warning message to users.Signing a Transaction (Without Sending)
Once a transaction is created, a web application may ask the user's Phantom wallet to sign the transaction without also submitting it to the network. The easiest and most recommended way of doing this is via the
signTransaction method on the provider, but it is also possible to do via request. In both cases, the call will return a Promise for the signed transaction. After the transaction has been signed, an application may submit the transaction itself via web3js's sendRawTransaction.signTransaction()
request()
1
const network = "<NETWORK_URL>";
2
const connection = new Connection(network);
3
const transaction = new Transaction();
4
const signedTransaction = await window.solana.signTransaction(transaction);
5
const signature = await connection.sendRawTransaction(signedTransaction.serialize());
Copied!
1
const network = "<NETWORK_URL>";
2
const connection = new Connection(network);
3
const transaction = new Transaction();
4
const signedTransaction = await window.solana.request({
5
method: "signTransaction",
6
params: {
7
message: bs58.encode(transaction.serializeMessage()),
8
},
9
});
10
const signature = await connection.sendRawTransaction(signedTransaction.serialize());
Copied!
Signing Multiple Transactions
It is also possible to sign and send multiple transactions at once. This is exposed through the
signAllTransactions method on the provider.signAllTransactions()
request()
1
const signedTransactions = await window.solana.signAllTransactions(transactions);
Copied!
1
const message = transactions.map(transaction => {
2
return bs58.encode(transaction.serializeMessage());
3
});
4
const signedTransactions = await window.solana.request({
5
method: "signAllTransactions",
6
params: { message },
7
});
Copied!
Last modified 1mo ago