Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DA0-DA0/polytone
An account on every blockchain for every smart contract.
https://github.com/DA0-DA0/polytone
Last synced: about 1 month ago
JSON representation
An account on every blockchain for every smart contract.
- Host: GitHub
- URL: https://github.com/DA0-DA0/polytone
- Owner: DA0-DA0
- Created: 2023-03-21T18:44:39.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-28T23:39:06.000Z (7 months ago)
- Last Synced: 2024-06-03T18:38:59.834Z (6 months ago)
- Language: Rust
- Size: 278 KB
- Stars: 40
- Watchers: 4
- Forks: 5
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome-ccamel - DA0-DA0/polytone - An account on every blockchain for every smart contract. (Rust)
README
# Polytone
Polytone is a protocol that gives every smart contract an account on every IBC-connected blockchain. Polytone has a CosmWasm implementation so CosmWasm chains can deploy Polytone Interchain Accounts and Queries today!
More detail information on Polytone can be found in the [wiki](https://github.com/DA0-DA0/polytone/wiki):
- [How Polytone Works](https://github.com/DA0-DA0/polytone/wiki/How-Polytone-Works)
- [How to use Polytone](https://github.com/DA0-DA0/polytone/wiki/How-to-use-Polytone)
- [How Polytone Handles Channel Closure](https://github.com/DA0-DA0/polytone/wiki/How-Polytone-Handles-Channel-Closure)
## Overview
Polytone is made of three modules: note, voice, and proxy.
The note says what to say, and the voice (via the sender’s proxy) says it.
### Connecting Note & Voice
Different blockchains have different encodings and message types, in Polytone we call these “extensions”. For a note to connect to a voice, the voice must support all extensions the note does; The voice must be able to say everything the note can speak.
Once a note has connected to a voice, it is “paired”. Once paired, the note will only ever connect with that voice, even if the first channel to connect them closes. Pairing simplifies Polytone’s API, as message senders don’t need to specify the channel to send on.
More information on connections and using Polytone as a developer is available in the [wiki](https://github.com/DA0-DA0/polytone/wiki/How-to-use-Polytone).
### Executing Messages
To execute messages, the messages are sent to the note, which relays them to its voice, which relays them to the sender’s proxy. If the sender has no proxy, a new one is created before relaying the messages.
If one of the executed messages fails, all of the messages are rolled back.
Executing queries has the same semantics as executing messages. If a single query fails, all queries are canceled.
## Audit
[Polytone has been audited by Oak Security](https://github.com/oak-security/audit-reports/blob/master/Polytone/2023-06-05%20Audit%20Report%20-%20Polytone%20v1.0.pdf).
## Acknowledgements
Thanks to Shane, humanalgorithm, and the Stargaze team for encouraging this work and helping ideate on the idea of an outpost specific interchain accounts. Thanks to Belsy, Ethan Frey, and larry0x for the design feedback and great technical discussion in our CW-ICA Telegram chat. Thank you to Jake and Noah who helped in the design, ideation, and relaying for Polytone. Thank you to art3mix and benskey who worked on the implementation. And finally, thank you to the Juno Community DAO and Stargaze for funding this work!