This guide will help you get started with building apps with Autonomi starting from scratch. This guide has 4 parts:
This has guide has been tested on MacOS, it should work on Linux or other unixes as well, but the commands might be slightly different for Windows (unless you are using ).
Prerequisites
First let's install the required tools to get started:
Python 3.9+
: to manage the python environment and install the dependencies, although you can use any other package manager you want.
The , for running the testnet
: to run a local Ethereum testnet
Once all the above is ready, let's proceed to create a local testnet. For this testnet we will use the following Ethereum wallet which is the default address for our testnet.
The default private key and address (public key) for the testnet is:
It owns all the money on the testnet, you can use it to play around with the testnet! Which we will do in the next steps. Don't send real money to this address!!
Create a local testnet
An app is currently in development to make this process a one click thing, but for now we need to run the testnet manually.
First let's clone the Autonomi repository:
git clone https://github.com/maidsafe/autonomi
cd autonomi
Then to run the testnet, run the following command:
cargo run --bin evm-testnet
Keep the terminal open and running.
In a separate terminal, in the same directory (autonomi), run the following command:
cargo run --bin antctl -- local run --build --rewards-address=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
You now have a local Autonomi testnet running! Congrats! 🎉
Connect to the testnet with Python
# Create a new virtual environment in the current directory
uv venv
# Install the autonomi-client package
uv pip install autonomi-client
Then create a new Python file in which we will write our app:
touch main.py
Open up the file in your favorite editor and add the following code:
from autonomi_client import Client, Network, Wallet
import asyncio
async def main():
# Initialize a wallet with the testnet private key
private_key = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
network = Network(True)
wallet = Wallet.new_from_private_key(network, private_key)
print(f"Wallet address: {wallet.address()}")
print(f"Wallet balance: {await wallet.balance()}")
# Connect to the network
client = await Client.init_local()
print(f"Connected to network!")
# Run the main in an async runtime
asyncio.run(main())
In your terminal, run the following command to execute the script:
python main.py
You should see the following output:
Wallet address: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
Wallet balance: 2500000000000000000000000
Connected to network!
Congrats! You've just connected to the testnet! 🎉
Upload and retrieve data with Python
Next up let's upload some data to the testnet and retrieve it. We will be using the Autonomi data API for this. Expanding upon our previous work, change the main.py file to the following:
from autonomi_client import Client, Network, Wallet, PaymentOption
import asyncio
async def main():
# Initialize a wallet with the testnet private key
private_key = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
network = Network(True)
wallet = Wallet.new_from_private_key(network, private_key)
print(f"Wallet address: {wallet.address()}")
print(f"Wallet balance: {await wallet.balance()}")
# Connect to the network
client = await Client.init_local()
print("Connected to network!")
# Choose to pay using our wallet
payment_option = PaymentOption.wallet(wallet)
# Upload data as public (meaning anyone can read it with the address)
data = b"Hello, Freedom!"
(price, addr) = await client.data_put_public(data, payment_option)
print(f"Data uploaded for {price} testnet ANT to: {addr}")
# Wait for the data to be stored by the network
await asyncio.sleep(1)
# Later, we can retrieve the data
retrieved_data = await client.data_get_public(addr)
print(f"Retrieved data: {retrieved_data.decode()}")
# Run the main in an async runtime
asyncio.run(main())
For private data, use the data_put and data_get methods instead!
Congrats! If you got this far, you are ready to start building apps that can store data on Autonomi! 🎉
Going further
Cleanup and Troubleshooting
To stop and cleanup after a testnet, run the following commands to kill all the nodes, the evm testnet and delete all Autonomi related files.
Warning: If you are running local live nodes or apps/clients on Autonomi DO NOT DELETE THE WHOLE Autonomi data FOLDER asyou risk losing all your data.
It is recommended to run testnets on a separate user or machine.