bea062b1e6
* Fix C headers (the name of the syscall was incorrect). * Add C SBF tests using the alt_bn128 syscall. * Fix the Rust SBF program: * Do not use serde and array-bytes, provide test cases as byte arrays directly. * Use the `custom_heap_default` macro. * Replace `bpf` with `sbf` in the crate name. * Execute both previously existing Rust tests and new C tests in `programs/sbf/tests`, so they are actually tested on CI. |
||
---|---|---|
.. | ||
inc | ||
README.md | ||
bpf.ld | ||
bpf.mk |
README.md
Development
Quick start
To get started create a makefile
containing:
include path/to/bpf.mk
and src/program.c
containing:
#include <solana_sdk.h>
bool entrypoint(const uint8_t *input) {
SolKeyedAccount ka[1];
uint8_t *data;
uint64_t data_len;
if (!sol_deserialize(buf, ka, SOL_ARRAY_SIZE(ka), NULL, &data, &data_len)) {
return false;
}
print_params(1, ka, data, data_len);
return true;
}
Then run make
to build out/program.o
.
Run make help
for more details.
Unit tests
Built-in support for unit testing is provided by the
Criterion test framework.
To get started create the file test/example.c
containing:
#include <criterion/criterion.h>
#include "../src/program.c"
Test(test_suite_name, test_case_name) {
cr_assert(true);
}
Then run make test
.
Limitations
- Programs must be fully contained within a single .c file
- No libc is available but
solana_sdk.h
provides a minimal set of primitives