Skip to main content

Pretty simple and fully asynchronous framework for working with NEAR blockchain

Project description

py-near

Financial Contributors on Open Collective PyPi Package Version Supported python versions Documentation Status Github issues MIT License Twitter

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:

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Code of conduct].

Project details


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)

Uploaded Source

Built Distribution

py_near-1.1.50-py3-none-any.whl (26.2 kB view details)

Uploaded Python 3

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

Hashes for py_near-1.1.50.tar.gz
Algorithm Hash digest
SHA256 0af21713131193037cf8ffeddd0c600013f7fb04f7be0d0e51830233349654fc
MD5 b4b753317cae5dcf7ebfaccf415336ed
BLAKE2b-256 e1c10381eb36ff98f36264a3fed644754c1193e71ed78d4fe3fec287f4a6054d

See more details on using hashes here.

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

Hashes for py_near-1.1.50-py3-none-any.whl
Algorithm Hash digest
SHA256 15c645df231c854097bb181d971c2206d17f7fd0fdecd977d85c3392617083b9
MD5 3e4b9aa36e59c7146f3b99f90b9dcf98
BLAKE2b-256 2b8c39eeb7d3a34ba5d0ffd147d5722d6d4f29ae4fc1871df34547beee3206d2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page