Install & Compatibility
Where this runs
tested against v0.21.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.699s · 69.8MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 4.8s · import 0.659s · 82MB
74MB installed
● package 74MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Provider
✓ from anchorpy import Provider
Wallet
✓ from anchorpy import Wallet
Program
✓ from anchorpy import Program
✗ from anchorpy.client import Program
Program is now typically imported directly from the top-level `anchorpy` package.
Idl
✓ from anchorpy import Idl
Commitment
✓ from solana.rpc.commitment import Commitment
✗ from solana.rpc.core import Commitment
Moved from `solana.rpc.core` to `solana.rpc.commitment` in `solana-py` v0.20.0, impacting `anchorpy` users.
PublicKey
✓ from solana.publickey import PublicKey
Keypair
✓ from solana.keypair import Keypair
This quickstart demonstrates how to establish a connection to a Solana cluster, initialize a wallet (using an ephemeral keypair for demonstration), load a placeholder IDL, and create an AnchorPy Program client. Remember to replace `SOLANA_RPC_URL` and `program_id` with your actual values, and provide a valid IDL for your program. Interactions with Solana programs are asynchronous and require `asyncio`.
import asyncio
import os
from solana.keypair import Keypair
from solana.publickey import PublicKey
from solana.rpc.api import Client
from solana.rpc.commitment import Commitment
from anchorpy import Provider, Wallet, Program, Idl
async def main():
# 1. Setup Solana client and provider
rpc_url = os.environ.get("SOLANA_RPC_URL", "https://api.devnet.solana.com")
connection = Client(rpc_url)
# For a real wallet, you would load a private key
# e.g., from an environment variable or file.
# For this example, we use a dummy keypair (not funded).
payer = Keypair.generate() # Generate a new ephemeral keypair
wallet = Wallet(payer)
provider = Provider(connection, wallet, opts=Commitment("confirmed"))
# 2. Define a placeholder program ID and a minimal IDL
# (Replace with your actual program ID and IDL)
program_id = PublicKey("11111111111111111111111111111111") # Example: System Program
idl_json = {
"version": "0.1.0",
"name": "my_anchor_program",
"instructions": [] # Populate with your program's instructions
}
idl = Idl.from_json(idl_json)
# 3. Instantiate the Program client
program = Program(idl, program_id, provider)
print(f"Successfully connected to Solana cluster: {rpc_url}")
print(f"Using wallet public key: {provider.wallet.public_key}")
print(f"Interacting with program ID: {program.program_id}")
if __name__ == "__main__":
asyncio.run(main())
Errors
Common errors & fixes
TypeError: object PublicKey is not callable
Attempting to call `PublicKey` as a function without providing a byte array or string argument (e.g., `PublicKey()`)
fixYou must provide an argument to `PublicKey` constructor, like `PublicKey('YourProgramIdHere')` or `PublicKey(bytes_array)`. anchorpy.error.ProgramError: Failed to send transaction: Transaction simulation failed: Error processing instruction...
This is a generic error from the Solana cluster indicating an issue within the program logic, missing accounts, insufficient funds for an account, or an incorrect instruction argument.
fixExamine the full error message from the cluster for specifics. Debug your program logic, ensure all required accounts are provided and correctly ordered, and verify the payer wallet has enough SOL.
RuntimeWarning: coroutine '...' was never awaited
An asynchronous function (coroutine) was called but its execution was not awaited, meaning Python did not wait for its completion.
fixAdd the `await` keyword before the coroutine call (e.g., `await program.rpc['instruction']()`). Ensure your code is running within an `asyncio` event loop.
NameError: name 'Commitment' is not defined
The `Commitment` enum was used without being imported, or it was imported from an old, incorrect path.
fixEnsure `from solana.rpc.commitment import Commitment` is at the top of your file.
Upgrade
Version history
0.21.0latest on PyPI · released Mar 26, 2025
Audit
Dependencies
solanarequiredCore library for Solana blockchain interactions.
pythclientoptionalOptional dependency for interacting with Pyth oracle programs.
websocket-clientoptionalUsed for WebSocket subscriptions to listen for real-time events.