5 releases
0.1.11 | Feb 28, 2024 |
---|---|
0.1.10 | Feb 7, 2024 |
0.1.9 | Dec 26, 2023 |
0.1.8 | Dec 21, 2023 |
0.1.7 | Dec 19, 2023 |
#27 in #stellar
118 downloads per month
66KB
750 lines
hello-soroban-kit
This crate is part of soroban-kit
: Github | crates.io.
hello-soroban-kit
is a Soroban smart contract demo showcasing the use of all features in soroban-kit
including state-machine
, commitment-scheme
, circuit-breaker
, oracle
and storage
.
soroban-kit
is designed for compactness, focusing on slim constructs. It is built on Rust's dependency-free core
library and the soroban-sdk
. All modules are feature-gated, offering you the flexibility to compile only the components essential for your project.
Take a look at Litemint Smart Contracts to see an integration of the library in real-world smart contracts.
Commands
-
Building the Contract:
soroban contract build
-
Running Tests:
cargo test -- --nocapture
-
Deploying to Testnet:
soroban contract deploy --wasm target/wasm32-unknown-unknown/release/hello_soroban_kit.wasm --rpc-url https://soroban-testnet.stellar.org:443 --network-passphrase "Test SDF Network ; September 2015" --source ACCOUNT
output > CONTRACT_ID
-
Invoking the contract:
Just say hello with storage type-safety!
soroban contract invoke --id CONTRACT_ID --source ACCOUNT --rpc-url https://soroban-testnet.stellar.org:443 --network-passphrase "Test SDF Network ; September 2015" -- hello --newcomer TESTER
output > ["Hello","TESTER"]
Play rock paper scissors!
soroban contract invoke --id CONTRACT_ID --source ACCOUNT --rpc-url https://soroban-testnet.stellar.org:443 --network-passphrase "Test SDF Network ; September 2015" -- rock_paper_scissors
output > "Success"
Flip the switch on a circuit!
soroban contract invoke --id CONTRACT_ID --source ACCOUNT --rpc-url https://soroban-testnet.stellar.org:443 --network-passphrase "Test SDF Network ; September 2015" -- circuit_breaker
output > "Success"
-
Check out lib.rs and test.rs for detailed integration examples.
Contributing
Contributions are welcome! If you have a suggestion that would make this better, please fork the repo and create a pull request.
License
soroban-kit
is licensed under the MIT License. See LICENSE for more details.
Contact
For inquiries or collaborations:
Fred Kyung-jin Rezeau - @FredericRezeau
Dependencies
~16MB
~334K SLoC