Pretty simple and fully asynchronous framework for working with NEAR blockchain
Project description
py-near
py-near is a pretty simple and fully asynchronous framework for working with NEAR blockchain.
Examples
📚 Click to see some basic examples
Few steps before getting started...
- Install the latest stable version of py-near, simply running
pip install py-near
- Create NEAR account and get your private key wallet
Simple money transfer
from py_near.account import Account
import asyncio
from py_near.dapps.core import NEAR
ACCOUNT_ID = "bob.near"
PRIVATE_KEY = "ed25519:..."
async def main():
acc = Account(ACCOUNT_ID, PRIVATE_KEY)
await acc.startup()
print(await acc.get_balance() / NEAR)
print(await acc.get_balance("bob.near") / NEAR)
tr = await acc.send_money("bob.near", NEAR * 2)
print(tr.transaction.hash)
print(tr.logs)
asyncio.run(main())
Transfer money by phone number
from py_near.account import Account
import asyncio
from py_near.dapps.core import NEAR
ACCOUNT_ID = "bob.near"
PRIVATE_KEY = "ed25519:..."
async def main():
acc = Account(ACCOUNT_ID, PRIVATE_KEY)
await acc.startup()
tr = await acc.phone.send_near_to_phone("+15626200911", NEAR // 10)
print(tr.transaction.hash)
asyncio.run(main())
Parallel requests
Only one parallel request can be made from one private key. All transaction calls execute sequentially. To make several parallel calls you need to use several private keys
acc = Account("bob.near", private_key1)
for i in range(2):
signer = InMemorySigner.from_random(AccountId("bob.near"), KeyType.ED25519)
await acc.add_full_access_public_key(str(signer.public_key))
print(signer.secret_key)
Now we can call transactions in parallel
acc = Account("bob.near", [private_key1, private_key2, private_key3])
# request time = count transactions / count public keys
tasks = [
asyncio.create_task(acc.send_money("alisa.near", 1)),
asyncio.create_task(acc.send_money("alisa.near", 1)),
asyncio.create_task(acc.send_money("alisa.near", 1)),
]
for t in task:
await t
Official py-near resources:
- News: @herewallet
- Social media:
- PyPI: py-near
- Documentation: py-near.readthedocs.io
- Source: Github repo
- Issues/Bug tracker: Github issues tracker
Contributors
Code Contributors
This project exists thanks to all the people who contribute. [Code of conduct].
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
py_near-1.1.50.tar.gz
(35.9 kB
view details)
Built Distribution
py_near-1.1.50-py3-none-any.whl
(26.2 kB
view details)
File details
Details for the file py_near-1.1.50.tar.gz
.
File metadata
- Download URL: py_near-1.1.50.tar.gz
- Upload date:
- Size: 35.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.11.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0af21713131193037cf8ffeddd0c600013f7fb04f7be0d0e51830233349654fc |
|
MD5 | b4b753317cae5dcf7ebfaccf415336ed |
|
BLAKE2b-256 | e1c10381eb36ff98f36264a3fed644754c1193e71ed78d4fe3fec287f4a6054d |
File details
Details for the file py_near-1.1.50-py3-none-any.whl
.
File metadata
- Download URL: py_near-1.1.50-py3-none-any.whl
- Upload date:
- Size: 26.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.11.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 15c645df231c854097bb181d971c2206d17f7fd0fdecd977d85c3392617083b9 |
|
MD5 | 3e4b9aa36e59c7146f3b99f90b9dcf98 |
|
BLAKE2b-256 | 2b8c39eeb7d3a34ba5d0ffd147d5722d6d4f29ae4fc1871df34547beee3206d2 |