Skip to content

This crate provides Rust bindings to enable CosmWasm smart contracts to interact with custom modules in the Provenance Blockchain.

License

Notifications You must be signed in to change notification settings

provenance-io/provwasm

Repository files navigation

Provenance CosmWasm Bindings

This crate provides bindings to enable CosmWasm smart contracts to interact with custom provenance blockchain modules.

Crate Download Docs
provwasm-std provwasm-std on crates.io Docs
provwasm-mocks provwasm-mocks on crates.io Docs

Compatibility

The following table shows provwasm version compatibility for smart contract development and testing.

provwasm wasmd cosmos provenance module support
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

Getting Started

Start with the tutorial for a complete guide to developing smart contracts for the Provenance Blockchain.

IBC

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.

Contents

In addition to the core CosmWasm functionality, the provenance bindings include

Query Support

Queries are available for these Provenance modules:

  • Attribute
    • provenance.attribute.v1.QueryParamsRequest
    • provenance.attribute.v1.QueryAttributeRequest
    • provenance.attribute.v1.QueryAttributesRequest
    • provenance.attribute.v1.QueryScanRequest
  • Exchange
    • provenance.exchange.v1.QueryOrderFeeCalcRequest
    • provenance.exchange.v1.QueryGetOrderRequest
    • provenance.exchange.v1.QueryGetOrderByExternalIDRequest
    • provenance.exchange.v1.QueryGetMarketOrdersRequest
    • provenance.exchange.v1.QueryGetOwnerOrdersRequest
    • provenance.exchange.v1.QueryGetAssetOrdersRequest
    • provenance.exchange.v1.QueryGetAllOrdersRequest
    • provenance.exchange.v1.QueryGetMarketRequest
    • provenance.exchange.v1.QueryGetAllMarketsRequest
    • provenance.exchange.v1.QueryParamsRequest
    • provenance.exchange.v1.QueryValidateCreateMarketRequest
    • provenance.exchange.v1.QueryValidateMarketRequest
    • provenance.exchange.v1.QueryValidateManageFeesRequest
  • Hold
    • provenance.hold.v1.GetHoldsRequest
    • provenance.hold.v1.GetAllHoldsRequest
  • Marker
    • provenance.marker.v1.QueryParamsRequest
    • provenance.marker.v1.QueryMarkerRequest
    • provenance.marker.v1.QueryHoldingRequest
    • provenance.marker.v1.QuerySupplyRequest
    • provenance.marker.v1.QueryEscrowRequest
    • provenance.marker.v1.QueryAccessRequest
    • provenance.marker.v1.QueryDenomMetadataRequest
  • Metadata
    • provenance.metadata.v1.QueryParamsRequest
    • provenance.metadata.v1.ScopeRequest
    • provenance.metadata.v1.SessionsRequest
    • provenance.metadata.v1.RecordsRequest
    • provenance.metadata.v1.OwnershipRequest
    • provenance.metadata.v1.ValueOwnershipRequest
    • provenance.metadata.v1.ScopeSpecificationRequest
    • provenance.metadata.v1.ContractSpecificationRequest
    • provenance.metadata.v1.RecordSpecificationsForContractSpecificationRequest
    • provenance.metadata.v1.RecordSpecificationRequest
    • provenance.metadata.v1.OSLocatorParamsRequest
    • provenance.metadata.v1.OSLocatorRequest
    • provenance.metadata.v1.OSLocatorsByURIRequest
    • provenance.metadata.v1.OSLocatorsByScopeRequest
    • The following has deserialization issues and will be None until fixed:
      • ContractSpecification.source
      • InputSpecification.source
      • Process.process_id
      • SessionIdComponents.scope_identifier
  • MsgFees
    • provenance.msgfees.v1.QueryParamsRequest
  • Name
    • provenance.name.v1.QueryParamsRequest
    • provenance.name.v1.QueryResolveRequest
    • provenance.name.v1.QueryReverseLookupRequest
  • Reward
    • provenance.reward.v1.QueryRewardProgramByIDRequest
    • provenance.reward.v1.QueryRewardProgramsRequest
    • provenance.reward.v1.QueryClaimPeriodRewardDistributionsRequest
    • provenance.reward.v1.QueryClaimPeriodRewardDistributionsByIDRequest
    • provenance.reward.v1.QueryRewardDistributionsByAddressRequest
    • The following has deserialization issues and will be None until fixed:
      • QualifyingAction.type
  • Trigger
    • Query support unavailable until #123 is resolved

Message Encoding

All messages are available for these Provenance modules:

Migration

Please see this guide for information regarding api changes and upgrading contracts

About

This crate provides Rust bindings to enable CosmWasm smart contracts to interact with custom modules in the Provenance Blockchain.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages