@metaplex-foundation/beet-solana

What is @metaplex-foundation/beet-solana?

@metaplex-foundation/beet-solana is a library designed to facilitate serialization and deserialization of data structures in the Solana blockchain ecosystem. It provides utilities to define and work with complex data types, making it easier to interact with Solana programs.

What are @metaplex-foundation/beet-solana's main functionalities?

Serialization and Deserialization

This feature allows users to define data structures and serialize/deserialize them to/from buffers. The code sample demonstrates how to define a simple struct with two fields and serialize/deserialize it using the library.

const { u8, struct } = require('@metaplex-foundation/beet-solana');

const MyStruct = struct([
  ['field1', u8],
  ['field2', u8]
]);

const buffer = Buffer.alloc(MyStruct.byteSize);
MyStruct.write(buffer, 0, { field1: 1, field2: 2 });

const result = MyStruct.read(buffer, 0);
console.log(result); // { field1: 1, field2: 2 }

Complex Data Types

This feature supports complex data types, such as arrays within structs. The code sample shows how to define a struct with an array field and serialize/deserialize it.

const { u8, array, struct } = require('@metaplex-foundation/beet-solana');

const ComplexStruct = struct([
  ['field1', u8],
  ['field2', array(u8, 3)]
]);

const buffer = Buffer.alloc(ComplexStruct.byteSize);
ComplexStruct.write(buffer, 0, { field1: 1, field2: [2, 3, 4] });

const result = ComplexStruct.read(buffer, 0);
console.log(result); // { field1: 1, field2: [2, 3, 4] }

Other packages similar to @metaplex-foundation/beet-solana

borsh

Borsh is a binary serialization format designed for speed and efficiency, commonly used in the Solana ecosystem. It provides similar functionality to @metaplex-foundation/beet-solana in terms of serialization and deserialization of data structures, but with a focus on performance and simplicity.

buffer-layout

Buffer-layout is a library for describing and serializing binary data structures. It is used in the Solana ecosystem for defining data layouts in a flexible manner. Compared to @metaplex-foundation/beet-solana, buffer-layout offers a more low-level approach to defining data structures.

README

@metaplex-foundation/beet-solana

Solana specific extension for beet, the borsh compatible de/serializer

API

Please find the API docs here.

Examples

Using PublicKey Directly

import { publicKey } from '@metaplex-foundation/beet-solana'

const generatedKey  = Keypair.generate().publicKey
const buf = Buffer.alloc(publicKey.byteSize)
beet.write(buf, 0, generatedKey)
beet.read(buf, 0) // same as generatedKey

PublicKey as part of a Struct Configuration

import * as web3 from '@solana/web3.js'
import * as beet from '@metaplex-foundation/beet'
import * as beetSolana from '@metaplex-foundation/beet-solana'

type InstructionArgs = {
  authority: web3.PublicKey
}

const createStruct = new beet.BeetArgsStruct<InstructionArgs>(
  [ 
    ['authority', beetSolana.publicKey]
  ],
  'InstructionArgs'
)

LICENSE

Apache-2.0