takunomi-build-bot
478a768f11
This commit was automatically generated by a script: https://gitfub.space/Jmaa/repo-manager
94 lines
3.0 KiB
Markdown
94 lines
3.0 KiB
Markdown
<!--- WARNING --->
|
|
<!--- THIS IS AN AUTO-GENERATED FILE --->
|
|
<!--- MANUAL CHANGES CAN AND WILL BE OVERWRITTEN --->
|
|
|
|
|
|
|
|
# Partisia Blockchain ABI client
|
|
|
|
|
|
|
|
Utility library for parsing and processing the Partisia Blockchain ABI Format.
|
|
|
|
The format is specified here: [Partisia Blockchain's ABI format](https://partisiablockchain.gitlab.io/documentation/smart-contracts/smart-contract-binary-formats.html)..
|
|
|
|
## Example usage
|
|
|
|
This example is based upon the [Token Contract example contract](https://gitlab.com/partisiablockchain/language/example-contracts).
|
|
It assumes a compiled ABI in `token.abi` and a blockchain state stored in `token_state.bin`.
|
|
|
|
```py
|
|
# Imports
|
|
from pbcabi.binaryreader import BinaryReader
|
|
import pbcabi.model
|
|
|
|
# Read ABI
|
|
with open('token.abi', 'rb') as f:
|
|
TOKEN_ABI = pbcabi.model.FileAbi.read_from(BinaryReader(f.read()))
|
|
|
|
with open('token_state.bin', 'rb') as f:
|
|
state_bytes = f.read()
|
|
|
|
# Read structure TokenState from state_bytes
|
|
token_state = TOKEN_ABI.contract.read_state('TokenState', BinaryReader(state_bytes))
|
|
|
|
# Inspect state as mostly Python-native types.
|
|
my_address = BlockchainAddress.from_hex_hash("00e72e44eab933faaf1fd4ce94bb57e08bff98a1ed")
|
|
|
|
print(token_state['name'])
|
|
> MyToken
|
|
print(token_state['balances'][my_address])
|
|
> 213112
|
|
```
|
|
|
|
## Legalese
|
|
|
|
This project is licensed under MIT Licence, see `LICENSE` for full text.
|
|
|
|
This project is not associated with, nor supported by any of:
|
|
|
|
- Partisia Applications A/S
|
|
- Partisia Infrastructure A/S
|
|
- Partisia Blockchain Foundation
|
|
|
|
Use at own risk.
|
|
|
|
## Dependencies
|
|
|
|
All requirements can be installed easily using:
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
Full list of requirements:
|
|
- [enforce_typing](https://pypi.org/project/enforce_typing/)
|
|
- [frozendict](https://pypi.org/project/frozendict/)
|
|
|
|
|
|
## License
|
|
|
|
```
|
|
MIT License
|
|
|
|
Copyright (c) 2023-2024 Jon Michael Aanes
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
```
|