# Trdelník
developed by [Ackee Blockchain](https://ackeeblockchain.com)
[](https://crates.io/crates/trdelnik-cli)
[](https://crates.io/crates/trdelnik-test)
[](https://crates.io/crates/trdelnik-client)
[](https://crates.io/crates/trdelnik-explorer)
[](https://github.com/Ackee-Blockchain/trdelnik/actions/workflows/lint.yml)
[](https://github.com/Ackee-Blockchain/trdelnik/actions/workflows/test.yml)
Trdelník is Rust based testing framework providing several convenient developer tools for testing Solana programs written in Anchor.
- Trdelnik client - build and deploy an Anchor program to a local cluster and run a test suite against it;
- Trdelnik console - built-in console to give developers a command prompt for quick program interaction;
- Trdelnik fuzz - property-based and stateful testing;
- Trdelnik explorer - exploring a ledger changes.
Dependencies
Installation
Currently Trdelnik is only available as a beta release, we are working hard toward the first official release coming within a few days.
```shell
cargo install trdelnik-cli
or the specific version
cargo install --version trdelnik-cli
```
Usage
```shell
navigate to your project root directory
trdelnik init
it will generate .program_client and trdelnik-tests directories with all the necessary files
trdelnik test
want more?
trdelnik --help
```
How to write tests?
``rust
// <my_project>/trdelnik-tests/tests/test.rs
// @todo: do not forget to add all necessary dependencies to the generatedtrdelnik-tests/Cargo.toml`
use programclient::myinstruction;
use trdelnikclient::*;
use myprogram;
[throws]
[fixture]
async fn initfixture() -> Fixture {
// create a test fixture
let mut fixture = Fixture {
client: Client::new(systemkeypair(0)),
program: programkeypair(1),
state: keypair(42),
};
// deploy a tested program
fixture.deploy().await?;
// call instruction init
myinstruction::initialize(
&fixture.client,
fixture.state.pubkey(),
fixture.client.payer().pubkey(),
System::id(),
Some(fixture.state.clone()),
).await?;
fixture
}
[trdelnik_test]
async fn testhappypath(#[future] initfixture: Result) {
let fixture = initfixture.await?;
// call the instruction
myinstruction::dosomething(
&fixture.client,
"dummystring".toowned(),
fixture.state.pubkey(),
None,
).await?;
// check the test result
let state = fixture.getstate().await?;
asserteq!(state.something_changed, "yes");
}
```
Skipping tests
- You can add the
#[ignore] macro to skip the test.
```rust
[trdelnik_test]
[ignore]
async fn test() {}
```
Testing programs with associated token accounts
Trdelnik does not export anchor-spl and spl-associated-token-account, so you have to add it manually.
```toml
/trdelnik-tests/Cargo.toml
import the correct versions manually
anchor-spl = "0.24.2"
spl-associated-token-account = "1.0.3"
```
```rust
// /trdelnik-tests/tests/test.rs
use anchorspl::token::Token;
use splassociatedtokenaccount;
async fn initfixture() -> Fixture {
// ...
let account = keypair(1);
let mint = keypair(2);
// constructs a token mint
client
.createtokenmint(&mint, mint.pubkey(), None, 0)
.await?;
// constructs associated token account
let tokenaccount = client
.createassociatedtokenaccount(&account, mint.pubkey())
.await?;
let associatedtokenprogram = splassociatedtokenaccount::id();
// derives the associated token account address for the given wallet and mint
let associatedtokenaddress = splassociatedtokenaccount::getassociatedtokenaddress(&account.pubkey(), mint);
Fixture {
// ...
token_program: Token::id(),
}
}
```
- The
trdelnik init command generated a dummy test suite for you.
- For more details, see the complete test implementation.
Supported versions
- We support
Anchor and Solana versions specified in the table below.
| Trdelnik CLI | Anchor | Solana |
| ------------ | :------: | ------: |
| latest | >=0.24 | >=1.9 |
- Please make sure you are using the correct versions.
Roadmap
- [x] Q1/22 Trdelnik announcement at Solana Hacker House Prague
- [x] Trdelnik client available for testing
- [x] Q2/22 Trdelnik explorer available
- [x] Q2/22 Trdelnik client and explorer introduced at Solana Hacker House Barcelona
- [ ] Q3/22 Trdelnik console available
- [ ] Q4/22 Trdelnik fuzz available
Awards
Marinade Community Prize - winner of the Marinade grant for the 2022 Solana Riptide Hackathon.
Contribution
Thank you for your interest in contributing to Trdelník! Please see the CONTRIBUTING.md to learn how.
License
This project is licensed under the MIT license.
University and investment partners
