This crate provides bindings to enable CosmWasm smart contracts to interact with custom provenance blockchain modules.
| Crate | Download | Docs |
|---|---|---|
| provwasm-std | ||
| provwasm-mocks |
The following table shows provwasm version compatibility for smart contract development and testing.
| provwasm | wasmd | cosmos | provenance | module support |
|---|---|---|---|---|
| v2.8.0 | v0.52.X | v0.50.X | v1.27.X | all Provenance and third-party |
| v2.7.1 | v0.52.X | v0.50.X | v1.26.X | all Provenance and third-party |
| v2.7.0 | v0.52.X | v0.50.X | v1.26.X | all Provenance and third-party |
| v2.6.0 | v0.52.X | v0.50.X | v1.20.X | all Provenance and third-party |
| v2.5.0 | v0.52.X | v0.50.X | v1.20.X | all Provenance and third-party |
| v2.4.0 | v0.51.X | v0.50.X | v1.19.X | all Provenance and third-party |
| v2.3.0 | v0.51.X | v0.50.X | v1.19.X | all Provenance and most built-in third-party |
| v2.2.0 | v0.30.X | v0.46.X | v1.18.X | attribute,exchange,hold,marker,metadata,msgfees,name,reward,trigger |
| v2.1.0 | v0.30.X | v0.46.X | v1.17.X | attribute,exchange,hold,marker,metadata,msgfees,name,reward,trigger |
| v2.0.0 | v0.30.X | v0.46.X | v1.15.X | attribute,marker,metadata,msgfees,name,reward |
| v1.2.0 | v0.30.X | v0.46.X | v1.15.X | attribute,marker,metadata,msgfees,name |
| v1.1.2 | v0.29.X | v0.46.X | v1.13.X | attribute,marker,metadata,msgfees,name |
| v1.1.1 | v0.29.X | v0.46.X | v1.13.X | attribute,marker,metadata,msgfees,name |
| v1.1.0 | v0.26.X | v0.45.X | v1.10.X - v1.12.X | attribute,marker,metadata,msgfees,name |
| v1.0.0 | v0.26.X | v0.45.X | v1.8.X - v1.9.X | attribute,marker,metadata,name |
Start with the tutorial for a complete guide to developing smart contracts for the Provenance Blockchain.
provwasm-std uses feature flags to allow you to include only the blockchain modules your contract needs. This significantly reduces compile times and binary sizes. By default, provwasm-std includes all Provenance modules and core Cosmos modules, but you can disable default features and enable only what you need.
For example, a minimal contract using only the name service:
[dependencies]
provwasm-std = { workspace = true, default-features = false, features = ["provenance-name"] }See FEATURES.md for a complete guide to available features, dependencies, usage examples, and optimization tips.
Once the tutorial has been completed and you are ready for a more advanced topic, checkout the IBC Overview to learn more about IBC Smart Contracts and a guided tour of a multi-contract IBC project.
In addition to the core CosmWasm functionality, the Provenance bindings include:
Since migrating to Stargate queries, only a subset of queries are responded to. The list is maintained in Provenance.
Provenance includes third-party protobuf definitions to maintain compatibility
Please see this guide for information regarding api changes and upgrading contracts