Solana: What’s the difference between .rpc() and .instruction() in the anchor test?
As a Solana developer, you’re probably familiar with the anchor library, which provides a convenient interface for interacting with the Solana blockchain. Two common functions that can be used to send instructions are .rpc() (remote procedure call) and .instruction(). While they may seem similar, there’s an important difference between them.
.rpc()
The .rpc() function is designed to send requests to the Solana blockchain in a specific way. When you call .rpc(), a request is created that can be executed on the blockchain. The request provides instruction metadata, such as the name, signature, and arguments. This metadata allows you to match the request to existing instructions on the blockchain.
Here is an example of how to use “.rpc()”:
const anchor = require('@inchor-protocol/inchors');
// Create a new account
const accountId = anchor.web3.eth.accounts._new();
// Define an instruction
const instruction = {
name: “My instruction”,
arguments: [1, 2, 3],
};
// Send a request to .rpc()
anchor.rpc().instruction({
address: accountID,
signature: “your_signature_here”,
data: instruction,
}).then((response) => console.log(response));
.instruction()
The “.instruction()” function is used to send instructions directly from an application or script. When you call .instruction(), an instruction is created that can be executed on the blockchain without any additional metadata.
Here is an example of how to use .instruction():
const anchor = require('@inchor-protocol/inchors');
// Create a new account
const accountId = anchor.web3.eth.accounts._new();
// Define a script
const script = {
code: 'function () { self.addAccount(accountId); }',
};
// Send the instruction to .instruction()
anchor.rpc().instruction(script).then((response) => console.log(response));
Key Differences
So, what is the key difference between .rpc() and .instruction()?
- Metadata:
.rpc()requires metadata about the command, while.instruction()does not.
- Execution:
.rpc()executes a request to the blockchain, while.instruction()can be executed directly by a program or script.
In your case, if you are sending an instruction directly using.rpc(), the problem is likely related to how you are creating and executing the instruction. Make sure you are providing the correct metadata, such as the accountaddressand any additional arguments.
Here is an example of how to create a new command with.instruction()and execute it:
}’,
};
// Send the instruction to .instruction()
anchor.rpc().instruction(script).then((response) => console.log(response));
“`
To summarize, .rpc() is used to send requests to the blockchain, while .instruction() is used to send instructions directly from an application or script. When creating and executing instructions, make sure you use the correct function and provide the correct metadata.