https://github.com/buffalojoec/boomerang

Implementation-agnostic Solana program test harness
https://github.com/buffalojoec/boomerang

Last synced: 27 days ago
JSON representation

Implementation-agnostic Solana program test harness

• Host: GitHub
• URL: https://github.com/buffalojoec/boomerang
• Owner: buffalojoec
• Created: 2024-01-12T17:49:04.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2024-01-14T22:42:42.000Z (10 months ago)
• Last Synced: 2024-04-15T16:03:54.520Z (7 months ago)
• Language: Rust
• Size: 172 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 🪃  Boomerang

As a result of

[SIMD 0088](https://github.com/solana-foundation/solana-improvement-documents/pull/88),

Solana native programs will be migrating to BPF implementations.

It's crucial to cluster health to have the proper test harness to ensure these

migrations are successful.

Boomerang can perform the following tests on *any* Solana program:

- **Program tests:** Executing program tests using `solana-program-test`

  against a `BanksClient`.

- **Integration tests:** Executing test suites against a live test validator.

- **Migration tests:** Testing one program's implementation against a local

  validator, then using the Bank's migration module (SIMD 0088) to migrate to

  a different implementation of the same program and test that new

  implementation at the original program's address.

Migration tests are primarily useful for integration-testing feature-gated

native program migrations to BPF, as per SIMD 0088.

Note that with Boomerang, all program tests are still invoked with:

```

cargo test-sbf

```

See more in the Address Lookup Table (BPF version)

[test folder](./tests/address-lookup-table/tests).