A Framework for building PyTeal Applications
Project description
Beaker
Beaker is a smart contract development framework for PyTeal.
With Beaker, we build a class that represents our entire application including state and routing.
WARNING
:warning: Mostly Untested - Expect Breaking Changes :warning:
Please file issues or prs and get any contracts audited
Hello, Beaker
from pyteal import *
from beaker import *
# Create a class, subclassing Application from beaker
class HelloBeaker(Application):
# Add an external method with ABI method signature `hello(string)string`
@external
def hello(self, name: abi.String, *, output: abi.String):
# Set output to the result of `Hello, `+name
return output.set(Concat(Bytes("Hello, "), name.get()))
# Create an Application client
app_client = client.ApplicationClient(
# Get sandbox algod client
client=sandbox.get_algod_client(),
# Instantiate app with the program version (default is MAX_TEAL_VERSION)
app=HelloBeaker(version=6),
# Get acct from sandbox and pass the signer
signer=sandbox.get_accounts().pop().signer,
)
# Deploy the app on-chain
app_id, app_addr, txid = app_client.create()
print(
f"""Deployed app in txid {txid}
App ID: {app_id}
Address: {app_addr}
"""
)
# Call the `hello` method
result = app_client.call(HelloBeaker.hello, name="Beaker")
print(result.return_value) # "Hello, Beaker"
Install
You can install from pip:
pip install beaker-pyteal
Or from github directly (no promises on stability):
pip install git+https://github.com/algorand-devrel/beaker
Dev Environment
Requires a local sandbox.
NOTE: Currently requires a sandbox running with the source
config (or any config that contains this commit)
$ git clone git@github.com:algorand/sandbox.git
$ cd sandbox
$ sandbox up source
Testing
You can run tests from the root of the project using pytest
Use
Please feel free to file issues/prs
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for beaker_pyteal-0.1.4a0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2177bf01edeebbb3b542e1a09fa3e91286e3e9495e3db467f409a7d500f96407 |
|
MD5 | dc27a836a98c019f08fb885f3206b45e |
|
BLAKE2b-256 | dd9b32a6b16b2aba660ab1351df220217e36878564944475ddde79a1a3818c90 |