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].
Metadata
Release files for py-near-patched 1.1.50.post1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| py_near_patched-1.1.50.post1.tar.gz | 21.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| py_near_patched-1.1.50.post1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.1 kB
Release files / py_near_patched-1.1.50.post1.tar.gz
| Download URL | py_near_patched-1.1.50.post1.tar.gz |
|---|---|
| Size | 21.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4408998e116d336f508292c6612b0987abbc2732cf45772390f43a5d8d7671c0
|
|
BLAKE2b-256 checksum How to use checksums |
d4deb8e1283634a2b3f20e8b2f6f98105e706084b654a1fdca21e09eeb40315a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.15
|
Release files / py_near_patched-1.1.50.post1-py3-none-any.whl
| Download URL | py_near_patched-1.1.50.post1-py3-none-any.whl |
|---|---|
| Size | 26.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9ebd40990333d53b438297fafc7920673dec51e53eb62ead3a47582e21a6f5ed
|
|
BLAKE2b-256 checksum How to use checksums |
467d098f3e00e05ee9ff578cbb9187a3d8d8a6e0fe8c3865055cc229c8938470
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.15
|