Security News
JavaScript Leaders Demand Oracle Release the JavaScript Trademark
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
@solana/programs
Advanced tools
Helpers for defining programs and resolving program errors
This package contains types for defining programs and helpers for resolving program errors. It can be used standalone, but it is also exported as part of the Solana JavaScript SDK @solana/web3.js@experimental
.
Program
The Program
type defines a Solana program.
const myProgram: Program<'1234..5678'> = {
name: 'myProgramName',
address: '1234..5678' as Address<'1234..5678'>,
};
ProgramWithErrors
The ProgramWithErrors
type helps extend the Program
type by defining a getErrorFromCode
function that can be used to resolve a custom program error from a transaction error code.
enum MyProgramErrorCode {
UNINITIALIZED_ACCOUNT = 0,
INVALID_ACCOUNT_OWNER = 1,
INVALID_ACCOUNT_DATA = 2,
SOME_OTHER_ERROR = 3,
}
class MyProgramError extends Error {
// ...
}
const myProgram: Program<'1234..5678'> & ProgramWithErrors<MyProgramErrorCode, MyProgramError> = {
name: 'myProgramName',
address: '1234..5678' as Address<'1234..5678'>,
getErrorFromCode: (code: MyProgramErrorCode, originalError: Error): MyProgramError => {
// ...
},
};
resolveTransactionError()
This function takes a raw error caused by a transaction failure and attempts to resolve it into a custom program error.
For this to work, the resolveTransactionError
function also needs the following parameters:
transaction
object that failed to execute. This allows us to identify the failing instruction and correctly identify the program that caused the error.programs
that can be used to resolve the error. If the program that caused the error is not present in the array, the function won't be able to return a custom program error.Note that, if the error cannot be resolved into a custom program error, the original error is returned as-is.
// Store your programs.
const programs = [createSplSystemProgram(), createSplComputeBudgetProgram(), createSplAddressLookupTableProgram()];
try {
// Send and confirm your transaction.
} catch (error) {
throw resolveTransactionError(error, transaction, programs);
}
FAQs
Helpers for defining programs and resolving program errors
The npm package @solana/programs receives a total of 2,398 weekly downloads. As such, @solana/programs popularity was classified as popular.
We found that @solana/programs demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 14 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.