bananopie

Name	bananopie JSON
Version	0.1.4.2 JSON
	download
home_page	https://github.com/jetstream0/bananopie
Summary	A python library to simplify sending and receiving Banano. Also a RPC wrapper.
upload_time	2024-12-15 19:57:57
maintainer	None
docs_url	None
author	John Doe
requires_python	>=3.5
license	MIT
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Bananopie

Bananopie is a python library for the Banano cryptocurrency. It aims to be the python equivalent of Banano.js, and not just a RPC wrapper (Sending, receiving, changing rep functions are very high level).

## Installation

`pip install bananopie`

Bananopie is on [pypi](https://pypi.org/project/bananopie/).

## Notes
- There is an outdated fork of Bananopie for Nano, also made by me, called [nanohakase](https://pypi.org/project/nanohakase/). It should suit most of your needs, but if you need new Bananopie features, fork Bananopie, change the work difficulty to `FFFFFFF800000000`, decimals to `31`, and you should be good to go.
- When running on Replit (ew), installing Bananopie may fail if you do not have `gcc` installed (nix package: `libgccjit`).

# Quick Start

First, start with a `RPC` class, for read only 
```py
from bananopie import *
rpc = RPC("https://kaliumapi.appditto.com/api")

#check current blockcount
print(rpc.get_block_count()["count"])

#get last 10 transactions of JungleTV
print(rpc.get_account_history("ban_1jung1eb3uomk1gsx7w6w7toqrikxm5pgn5wbsg5fpy96ckpdf6wmiuuzpca", count=10)["history"])

#check balance of JungleTV
print(raw_to_whole(int(rpc.get_account_balance("ban_1jung1eb3uomk1gsx7w6w7toqrikxm5pgn5wbsg5fpy96ckpdf6wmiuuzpca")["balance"])))
```

For sending/receiving transactions, use a `Wallet`.
```py
from bananopie import RPC, Wallet
rpc = RPC("https://kaliumapi.appditto.com/api")

my_account = Wallet(rpc, seed="seed here", index=0)

#or generate a new one
my_new_account = Wallet(rpc, index=0)

print(my_new_account.seed)

#get address of self
print(my_account.get_address())

#get balance of self
print(my_account.get_balance())

#send 1 banano to the faucet development fund
print(my_account.send("ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94", "1")["hash"])

#receive funds
my_account.receive_all()

#change rep
my_account.change_rep("ban_3catgir1p6b1edo5trp7fdb8gsxx4y5ffshbphj73zzy5hu678rsry7srh8b")

#change seed index
my_account.index = 2
```

Bananopie can also generate work, albeit slowly. This is useful when using node that don't support generating work. Also, the `legacy` parameter can be passed to the RPC class when the RPC supports the deprecated `pending` RPC call instead of the newer `receivable` call.
```py
from bananopie import RPC, Wallet

no_work_rpc = RPC("https://public.node.jungletv.live/rpc", legacy=True)

my_work_account = Wallet(no_work_rpc, seed="seed here", index=0, try_work=True)

#will generate work locally!
my_work_account.send("ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94", "0.0042")
```

Utility functions are also provided.
```py
import bananopie

#whole to raw banano
print(bananopie.whole_to_raw("492.2"))

#raw to whole banano
print(bananopie.raw_to_whole(1900000000000000000000000000))
```

# Documentation

Also see the [Nano RPC docs](https://docs.nano.org/commands/rpc-protocol) for information on what rpc call wrapper functions return.

## RPC (Class)
**Parameters:**
- `rpc_url` (*str*): IP or URL of node
- `auth` (*str* or *bool*, Default: False): Optional HTTP Authorization header
- `legacy` (*bool*, Default: False): If `True`, will use 'pending' instead of 'receivable'

Sample:
```py
rpc = RPC("https://kaliumapi.appditto.com/api")
```

**Properties:**
- `rpc_url` (*str*): IP or URL of node
- `auth` (*str* or *bool*): Optional HTTP Authorization header

**Methods:**

### call (Function)
RPC call. Intended for internal use, but useful for RPC calls that aren't directly implemented.

**Parameters:**
- `payload` (*dictionary*): Payload to send to node

Sample:
```py
rpc.call({"action": "block_count"})
```

**Returns:**
Response of RPC call (JSON dictionary)

### get_block_count (Function)
Get network block count.

**Parameters**
None

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#block_count)


### get_block_info (Function)
Get block info for hash.

**Parameters**
- `block` (*st*): Block hash

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#block_info)

### get_blocks (Function)
Get blocks.

**Parameters**
- `blocks` (*list[str]*): List of block hashes to get information on

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#blocks)

### get_blocks_info (Function)
Get blocks, with more detailed information.

**Parameters**
- `blocks` (*list[str]*): List of block hashes to get information on

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#blocks_info)

### get_representatives (Function)
Get list of network representatives and their weight

**Parameters**
None

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#representatives)

### get_representatives_online (Function)
Get list of network representatives that have recently voted

**Parameters**
None

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#representatives_online)

### get_account_history (Function)
Get account history (confirmed and received transaction list)

**Parameters**
- `account` (*str*): Address of account
- `count` (*int*, Default: -1): Optional parameter to specify amount of transactions to return. `-1` means all, or at least as much as the node will allow
- `head` (*str* or *None*, Default: None): Block hash to start from, defaults to latest block hash if omitted
- `account_filter` (*list[str]* or *None*, Default: None): List of addresses to only show sends/receives from. Please note that some public nodes will ignore this parameter

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_history)

### get_account_info (Function)
Get account information, like height, frontier, balance, etc

**Parameters**
- `account` (*str*): Address of account

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_info)

### get_account_balance (Function)
Get account balance

**Parameters**
- `account` (*str*): Address of account

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_balance)

### get_account_representative (Function)
Get account representative

**Parameters**
- `account` (*str*): Address of account

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_representative)

### get_accounts_representatives (Function)
Get representatives of accounts

**Parameters**
- `account` (*list[str]*): List of addresses

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_representatives)

### get_account_weight (Function)
Get delegated weight of representative

**Parameters**
- `account` (*str*): Address of representative

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_weight)

### get_receivable (Function)
Get receivable transactions for account

**Parameters**
- `account` (*str*): Address of representative
- `count` (*int*, Default: 20): Optional parameter to specify max amount of receivable transactions to return
- `threshold` (*int* or *None*, Default: None): Optional parameter to filter out any receivable transactions with value below the threshold (in raw)

**Returns:**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#receivable)

## Wallet (class)

**Parameters:**
- `rpc` (*RPC*): A RPC class
- `seed` (*str* or *None*, Default: None): 64 character hex seed, if `None`, will generate a seed by itself. Private keys are derived from the seed.
- `index` (*int*, Default: 0): Optional parameter that is the index of the seed. Any number from 0 to 4294967295. Each index of the seed is a different private key, and so different address.
- `try_work` (*bool*, Default: False): If `True`, will try to generate work locally instead of asking node for work (and no work provided). Good to use if node does not support generating own work.

Sample:
```py
my_account = Wallet(RPC("https://kaliumapi.appditto.com/api"), "seed here", 0)
```

**Properties:**
- `rpc_url` (*str*): IP or URL of node
- `seed` (*str*): Banano seed (64 character hex string)
- `index` (*int*): Seed index. Change this property to change the wallet seed index.

**Methods**

### send_process (Function)
Internal use function to send a `process` RPC call

**Parameters**
- `block` (*dictionary*): block content
- `subtype` (*str*): Send, receive, or change

**Returns**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)

### send (Function)
High level function to send Banano

**Parameters**
- `to` (*str*): Address to send to
- `amount` (*str*): Amount of Banano to send (in whole, not raw)
- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)
- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used

Sample:
```py
my_account = Wallet(RPC("https://kaliumapi.appditto.com/api"), "seed here", 0)
my_account.send("ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94", "1")
```

**Returns**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)

### send_all (Function)
High level function to send all Banano

**Parameters**
- `to` (*str*): Address to send to
- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)
- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used

Sample:
```py
my_account = Wallet(RPC("https://kaliumapi.appditto.com/api"), "seed here", 0)
my_account.send_all("ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94")
```

**Returns**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)

### receive_specific (Function)
Receive a specific block

**Parameters**
- `hash` (*str*): Block hash to receive
- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)
- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used

**Returns**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)

### receive_all (Function)
Receive all (technically, 20) receivable transactions

**Parameters**
- `count` (*int*, Default: 20): Optional parameter to specify max amount of receivable transactions to receive
- `threshold` (*int* or *None*, Default: None): Optional parameter to not receive any receivable transactions with value below the threshold (in whole, not raw)
- `work` (*bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). If it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)

Sample:
```py
my_account = Wallet(RPC("https://kaliumapi.appditto.com/api"), "seed here", 0)
my_account.receive_all()
```

**Returns**
- A list of block hashes that were received (See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process))

### change_rep (Function)
Change account representative

**Parameters**
- `new_representative` (*str*): Representative Banano address to change to
- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)
- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used

Sample:
```py
my_account = Wallet(RPC("https://kaliumapi.appditto.com/api"), "seed here", 0)
my_account.change_rep("ban_3catgir1p6b1edo5trp7fdb8gsxx4y5ffshbphj73zzy5hu678rsry7srh8b")
```

**Returns**
See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)

### sign_message (Function)
Sign utf-8 message with private key at current index of current seed

**Parameters**
- `message` (*str*): utf-8 message to sign

**Returns**
*str*, Hex signature

### sign_message_dummy_block (Function)
Sign utf-8 message as a dummy block (making sure ledger devices can also sign) with private key at current index of current seed

**Parameters**
- `message` (*str*): utf-8 message to sign

**Returns**
*str*, Hex signature

### get_public_key (Function)
Get public key at current index of current seed

**Parameters**
None

**Returns**
*str*, Hex public key

### get_address (Function)
Get address at current index of current seed

**Parameters**
None

**Returns**
*str*, Banano address

### get_balance (Function)
Double wrapped function to get balance of self (see `RPC`'s `get_account_balance`)

### get_receivable (Function)
Double wrapped function to get receivable blocks (see `RPC`'s `get_receivable`)

### get_receivable_whole_threshold (Function)
Double wrapped function to get receivable blocks (see `RPC`'s `get_receivable`), except `threshold` parameter is in whole Banano, not raw

### get_representative (Function)
Double wrapped function to get representative of self (see `RPC`'s `get_account_representative`)

### get_account_info (Function)
Double wrapped function to get account info of self (see `RPC`'s `get_account_info`)

### get_account_history (Function)
Double wrapped function to get account info of self (see `RPC`'s `get_account_history`)

### generate_seed (static Function)
Generate a random seed using `os.urandom`

**Parameters**
None

Sample:
```py
print(Wallet.generate_seed())
```

**Returns**
64 character hex seed

## Util

**Properties**
- `BANANO_DECIMALS` (*int*): Amount of decimals that Banano has (29)
- `PREAMBLE` (*str*): Hex string to prepend when signing
- `BANANO_WORK` (*str*): Hex string of Banano's work threshold/minimum

**Methods**

`encode_base32`, `decode_base32`, `bytes_to_hex`, `hex_to_bytes`, `utf8_to_bytes`, `random_bytes`, `get_private_key_from_seed`, `get_public_key_from_private_key`, `get_address_from_public_key`, `get_public_key_from_address`, `hash_block`, `sign`, `sign_message_dummy_block`, `gen_dummy_block_hash` are internal use Functions that are currently undocumented. Look at `/bananopie/util.py` to see what they do.

### verify_message (Function)
Verifies whether signed message is real

**Parameters**
- `public_key` (*str*): Hex public key
- `signature` (*str*): Hex signature
- `claimed_message` (*str*): utf-8 message that was allegedly signed

**Returns**
*bool*, `True` if message verified, `False` if message not verified

### verify_message_dummy_block (Function)
Verifies whether signed message (with dummy block) is real

**Parameters**
- `public_key` (*str*): Hex public key
- `signature` (*str*): Hex signature
- `claimed_message` (*str*): utf-8 message (with dummy block) that was allegedly signed

**Returns**
*bool*, `True` if message (with dummy block) verified, `False` if message (with dummy block) not verified

### whole_to_raw (Function)
Converts whole Banano to raw Banano

**Parameters**
- `whole` (*str*): Whole amount of Banano

**Returns**
*int*, that is raw amount of Banano

### raw_to_whole (Function)
Converts raw Banano to whole Banano (Cuts off at 2 decimal places by default)

**Parameters**
- `raw` (*int*): Raw amount of Banano
- `precision` (*int*, Default: 2): Decimal places to cut off at

**Returns**
*int*, that is whole amount of Banano

### raw_to_whole_no_round (Function)
Converts raw Banano to whole Banano, without rounding

**Parameters**
- `raw` (*int*): Raw amount of Banano

**Returns**
*str*, that is unrounded whole amount of Banano

### gen_work_random (Function)
Generate work given block's previous hash (or if opening block, account public key), and threshold. Generates work using psuedorandom generator.

**Parameters**
- `hash` (*str*): Hex previous hash of block / account public key
- `threshold` (*str*): Hex minimum work threshold

**Returns**
*str*, that is hex of work

### gen_work_deterministic (Function)
Generate work given block's previous hash (or if opening block, account public key), and threshold. Generates work deterministically.

**Parameters**
- `hash` (*str*): Hex previous hash of block / account public key
- `threshold` (*str*): Hex minimum work threshold

**Returns**
*str*, that is hex of work

### gen_work (Function)
Generate work given block's previous hash (or if opening block, account public key). Basically a wrapper for `gen_work_deterministic` with threshold being the hardcoded Banano default.

**Parameters**
- `hash` (*str*): Hex previous hash of block / account public key

**Returns**
*str*, that is hex of work

### verify_work (Function)
Verify whether work is valid or not, given previous hash of block (or if opening block, account public key).

**Parameters**
- `hash` (*str*): Hex previous hash of block / account public key
- `work` (*str*): Hex of work

**Returns**
*bool*, whether the work is valid or not

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/jetstream0/bananopie",
    "name": "bananopie",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.5",
    "maintainer_email": null,
    "keywords": null,
    "author": "John Doe",
    "author_email": "prussia@prussia.dev",
    "download_url": "https://files.pythonhosted.org/packages/f3/43/3490c6ce9080a98ad41b93b56e0ebeb23f4bca3d236e009057ae39093737/bananopie-0.1.4.2.tar.gz",
    "platform": null,
    "description": "# Bananopie\n\nBananopie is a python library for the Banano cryptocurrency. It aims to be the python equivalent of Banano.js, and not just a RPC wrapper (Sending, receiving, changing rep functions are very high level).\n\n## Installation\n\n`pip install bananopie`\n\nBananopie is on [pypi](https://pypi.org/project/bananopie/).\n\n## Notes\n- There is an outdated fork of Bananopie for Nano, also made by me, called [nanohakase](https://pypi.org/project/nanohakase/). It should suit most of your needs, but if you need new Bananopie features, fork Bananopie, change the work difficulty to `FFFFFFF800000000`, decimals to `31`, and you should be good to go.\n- When running on Replit (ew), installing Bananopie may fail if you do not have `gcc` installed (nix package: `libgccjit`).\n\n# Quick Start\n\nFirst, start with a `RPC` class, for read only \n```py\nfrom bananopie import *\nrpc = RPC(\"https://kaliumapi.appditto.com/api\")\n\n#check current blockcount\nprint(rpc.get_block_count()[\"count\"])\n\n#get last 10 transactions of JungleTV\nprint(rpc.get_account_history(\"ban_1jung1eb3uomk1gsx7w6w7toqrikxm5pgn5wbsg5fpy96ckpdf6wmiuuzpca\", count=10)[\"history\"])\n\n#check balance of JungleTV\nprint(raw_to_whole(int(rpc.get_account_balance(\"ban_1jung1eb3uomk1gsx7w6w7toqrikxm5pgn5wbsg5fpy96ckpdf6wmiuuzpca\")[\"balance\"])))\n```\n\nFor sending/receiving transactions, use a `Wallet`.\n```py\nfrom bananopie import RPC, Wallet\nrpc = RPC(\"https://kaliumapi.appditto.com/api\")\n\nmy_account = Wallet(rpc, seed=\"seed here\", index=0)\n\n#or generate a new one\nmy_new_account = Wallet(rpc, index=0)\n\nprint(my_new_account.seed)\n\n#get address of self\nprint(my_account.get_address())\n\n#get balance of self\nprint(my_account.get_balance())\n\n#send 1 banano to the faucet development fund\nprint(my_account.send(\"ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94\", \"1\")[\"hash\"])\n\n#receive funds\nmy_account.receive_all()\n\n#change rep\nmy_account.change_rep(\"ban_3catgir1p6b1edo5trp7fdb8gsxx4y5ffshbphj73zzy5hu678rsry7srh8b\")\n\n#change seed index\nmy_account.index = 2\n```\n\nBananopie can also generate work, albeit slowly. This is useful when using node that don't support generating work. Also, the `legacy` parameter can be passed to the RPC class when the RPC supports the deprecated `pending` RPC call instead of the newer `receivable` call.\n```py\nfrom bananopie import RPC, Wallet\n\nno_work_rpc = RPC(\"https://public.node.jungletv.live/rpc\", legacy=True)\n\nmy_work_account = Wallet(no_work_rpc, seed=\"seed here\", index=0, try_work=True)\n\n#will generate work locally!\nmy_work_account.send(\"ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94\", \"0.0042\")\n```\n\nUtility functions are also provided.\n```py\nimport bananopie\n\n#whole to raw banano\nprint(bananopie.whole_to_raw(\"492.2\"))\n\n#raw to whole banano\nprint(bananopie.raw_to_whole(1900000000000000000000000000))\n```\n\n# Documentation\n\nAlso see the [Nano RPC docs](https://docs.nano.org/commands/rpc-protocol) for information on what rpc call wrapper functions return.\n\n## RPC (Class)\n**Parameters:**\n- `rpc_url` (*str*): IP or URL of node\n- `auth` (*str* or *bool*, Default: False): Optional HTTP Authorization header\n- `legacy` (*bool*, Default: False): If `True`, will use 'pending' instead of 'receivable'\n\nSample:\n```py\nrpc = RPC(\"https://kaliumapi.appditto.com/api\")\n```\n\n**Properties:**\n- `rpc_url` (*str*): IP or URL of node\n- `auth` (*str* or *bool*): Optional HTTP Authorization header\n\n**Methods:**\n\n### call (Function)\nRPC call. Intended for internal use, but useful for RPC calls that aren't directly implemented.\n\n**Parameters:**\n- `payload` (*dictionary*): Payload to send to node\n\nSample:\n```py\nrpc.call({\"action\": \"block_count\"})\n```\n\n**Returns:**\nResponse of RPC call (JSON dictionary)\n\n### get_block_count (Function)\nGet network block count.\n\n**Parameters**\nNone\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#block_count)\n\n\n### get_block_info (Function)\nGet block info for hash.\n\n**Parameters**\n- `block` (*st*): Block hash\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#block_info)\n\n### get_blocks (Function)\nGet blocks.\n\n**Parameters**\n- `blocks` (*list[str]*): List of block hashes to get information on\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#blocks)\n\n### get_blocks_info (Function)\nGet blocks, with more detailed information.\n\n**Parameters**\n- `blocks` (*list[str]*): List of block hashes to get information on\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#blocks_info)\n\n### get_representatives (Function)\nGet list of network representatives and their weight\n\n**Parameters**\nNone\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#representatives)\n\n### get_representatives_online (Function)\nGet list of network representatives that have recently voted\n\n**Parameters**\nNone\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#representatives_online)\n\n### get_account_history (Function)\nGet account history (confirmed and received transaction list)\n\n**Parameters**\n- `account` (*str*): Address of account\n- `count` (*int*, Default: -1): Optional parameter to specify amount of transactions to return. `-1` means all, or at least as much as the node will allow\n- `head` (*str* or *None*, Default: None): Block hash to start from, defaults to latest block hash if omitted\n- `account_filter` (*list[str]* or *None*, Default: None): List of addresses to only show sends/receives from. Please note that some public nodes will ignore this parameter\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_history)\n\n### get_account_info (Function)\nGet account information, like height, frontier, balance, etc\n\n**Parameters**\n- `account` (*str*): Address of account\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_info)\n\n### get_account_balance (Function)\nGet account balance\n\n**Parameters**\n- `account` (*str*): Address of account\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_balance)\n\n### get_account_representative (Function)\nGet account representative\n\n**Parameters**\n- `account` (*str*): Address of account\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_representative)\n\n### get_accounts_representatives (Function)\nGet representatives of accounts\n\n**Parameters**\n- `account` (*list[str]*): List of addresses\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_representatives)\n\n### get_account_weight (Function)\nGet delegated weight of representative\n\n**Parameters**\n- `account` (*str*): Address of representative\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#account_weight)\n\n### get_receivable (Function)\nGet receivable transactions for account\n\n**Parameters**\n- `account` (*str*): Address of representative\n- `count` (*int*, Default: 20): Optional parameter to specify max amount of receivable transactions to return\n- `threshold` (*int* or *None*, Default: None): Optional parameter to filter out any receivable transactions with value below the threshold (in raw)\n\n**Returns:**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#receivable)\n\n## Wallet (class)\n\n**Parameters:**\n- `rpc` (*RPC*): A RPC class\n- `seed` (*str* or *None*, Default: None): 64 character hex seed, if `None`, will generate a seed by itself. Private keys are derived from the seed.\n- `index` (*int*, Default: 0): Optional parameter that is the index of the seed. Any number from 0 to 4294967295. Each index of the seed is a different private key, and so different address.\n- `try_work` (*bool*, Default: False): If `True`, will try to generate work locally instead of asking node for work (and no work provided). Good to use if node does not support generating own work.\n\nSample:\n```py\nmy_account = Wallet(RPC(\"https://kaliumapi.appditto.com/api\"), \"seed here\", 0)\n```\n\n**Properties:**\n- `rpc_url` (*str*): IP or URL of node\n- `seed` (*str*): Banano seed (64 character hex string)\n- `index` (*int*): Seed index. Change this property to change the wallet seed index.\n\n**Methods**\n\n### send_process (Function)\nInternal use function to send a `process` RPC call\n\n**Parameters**\n- `block` (*dictionary*): block content\n- `subtype` (*str*): Send, receive, or change\n\n**Returns**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)\n\n### send (Function)\nHigh level function to send Banano\n\n**Parameters**\n- `to` (*str*): Address to send to\n- `amount` (*str*): Amount of Banano to send (in whole, not raw)\n- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)\n- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used\n\nSample:\n```py\nmy_account = Wallet(RPC(\"https://kaliumapi.appditto.com/api\"), \"seed here\", 0)\nmy_account.send(\"ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94\", \"1\")\n```\n\n**Returns**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)\n\n### send_all (Function)\nHigh level function to send all Banano\n\n**Parameters**\n- `to` (*str*): Address to send to\n- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)\n- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used\n\nSample:\n```py\nmy_account = Wallet(RPC(\"https://kaliumapi.appditto.com/api\"), \"seed here\", 0)\nmy_account.send_all(\"ban_3pdripjhteyymwjnaspc5nd96gyxgcdxcskiwwwoqxttnrncrxi974riid94\")\n```\n\n**Returns**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)\n\n### receive_specific (Function)\nReceive a specific block\n\n**Parameters**\n- `hash` (*str*): Block hash to receive\n- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)\n- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used\n\n**Returns**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)\n\n### receive_all (Function)\nReceive all (technically, 20) receivable transactions\n\n**Parameters**\n- `count` (*int*, Default: 20): Optional parameter to specify max amount of receivable transactions to receive\n- `threshold` (*int* or *None*, Default: None): Optional parameter to not receive any receivable transactions with value below the threshold (in whole, not raw)\n- `work` (*bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). If it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)\n\nSample:\n```py\nmy_account = Wallet(RPC(\"https://kaliumapi.appditto.com/api\"), \"seed here\", 0)\nmy_account.receive_all()\n```\n\n**Returns**\n- A list of block hashes that were received (See [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process))\n\n### change_rep (Function)\nChange account representative\n\n**Parameters**\n- `new_representative` (*str*): Representative Banano address to change to\n- `work` (*str* or *bool* or *function*, Default: False): Leave it as `False` to ask node to generate work (passes `do_work`). Put in a work string if work generated locally, if it is a function, the work will be the function called with the block hash as a parameter (keep in mind you can set the class' `try_work` to `True` to use the built-in `gen_work` function)\n- `previous` (*str* or *None*, Default: None): Previous block hash. Otherwise, address' frontier block hash used\n\nSample:\n```py\nmy_account = Wallet(RPC(\"https://kaliumapi.appditto.com/api\"), \"seed here\", 0)\nmy_account.change_rep(\"ban_3catgir1p6b1edo5trp7fdb8gsxx4y5ffshbphj73zzy5hu678rsry7srh8b\")\n```\n\n**Returns**\nSee [Nano RPC Docs](https://docs.nano.org/commands/rpc-protocol/#process)\n\n### sign_message (Function)\nSign utf-8 message with private key at current index of current seed\n\n**Parameters**\n- `message` (*str*): utf-8 message to sign\n\n**Returns**\n*str*, Hex signature\n\n### sign_message_dummy_block (Function)\nSign utf-8 message as a dummy block (making sure ledger devices can also sign) with private key at current index of current seed\n\n**Parameters**\n- `message` (*str*): utf-8 message to sign\n\n**Returns**\n*str*, Hex signature\n\n### get_public_key (Function)\nGet public key at current index of current seed\n\n**Parameters**\nNone\n\n**Returns**\n*str*, Hex public key\n\n### get_address (Function)\nGet address at current index of current seed\n\n**Parameters**\nNone\n\n**Returns**\n*str*, Banano address\n\n### get_balance (Function)\nDouble wrapped function to get balance of self (see `RPC`'s `get_account_balance`)\n\n### get_receivable (Function)\nDouble wrapped function to get receivable blocks (see `RPC`'s `get_receivable`)\n\n### get_receivable_whole_threshold (Function)\nDouble wrapped function to get receivable blocks (see `RPC`'s `get_receivable`), except `threshold` parameter is in whole Banano, not raw\n\n### get_representative (Function)\nDouble wrapped function to get representative of self (see `RPC`'s `get_account_representative`)\n\n### get_account_info (Function)\nDouble wrapped function to get account info of self (see `RPC`'s `get_account_info`)\n\n### get_account_history (Function)\nDouble wrapped function to get account info of self (see `RPC`'s `get_account_history`)\n\n### generate_seed (static Function)\nGenerate a random seed using `os.urandom`\n\n**Parameters**\nNone\n\nSample:\n```py\nprint(Wallet.generate_seed())\n```\n\n**Returns**\n64 character hex seed\n\n## Util\n\n**Properties**\n- `BANANO_DECIMALS` (*int*): Amount of decimals that Banano has (29)\n- `PREAMBLE` (*str*): Hex string to prepend when signing\n- `BANANO_WORK` (*str*): Hex string of Banano's work threshold/minimum\n\n**Methods**\n\n`encode_base32`, `decode_base32`, `bytes_to_hex`, `hex_to_bytes`, `utf8_to_bytes`, `random_bytes`, `get_private_key_from_seed`, `get_public_key_from_private_key`, `get_address_from_public_key`, `get_public_key_from_address`, `hash_block`, `sign`, `sign_message_dummy_block`, `gen_dummy_block_hash` are internal use Functions that are currently undocumented. Look at `/bananopie/util.py` to see what they do.\n\n### verify_message (Function)\nVerifies whether signed message is real\n\n**Parameters**\n- `public_key` (*str*): Hex public key\n- `signature` (*str*): Hex signature\n- `claimed_message` (*str*): utf-8 message that was allegedly signed\n\n**Returns**\n*bool*, `True` if message verified, `False` if message not verified\n\n### verify_message_dummy_block (Function)\nVerifies whether signed message (with dummy block) is real\n\n**Parameters**\n- `public_key` (*str*): Hex public key\n- `signature` (*str*): Hex signature\n- `claimed_message` (*str*): utf-8 message (with dummy block) that was allegedly signed\n\n**Returns**\n*bool*, `True` if message (with dummy block) verified, `False` if message (with dummy block) not verified\n\n### whole_to_raw (Function)\nConverts whole Banano to raw Banano\n\n**Parameters**\n- `whole` (*str*): Whole amount of Banano\n\n**Returns**\n*int*, that is raw amount of Banano\n\n### raw_to_whole (Function)\nConverts raw Banano to whole Banano (Cuts off at 2 decimal places by default)\n\n**Parameters**\n- `raw` (*int*): Raw amount of Banano\n- `precision` (*int*, Default: 2): Decimal places to cut off at\n\n**Returns**\n*int*, that is whole amount of Banano\n\n### raw_to_whole_no_round (Function)\nConverts raw Banano to whole Banano, without rounding\n\n**Parameters**\n- `raw` (*int*): Raw amount of Banano\n\n**Returns**\n*str*, that is unrounded whole amount of Banano\n\n### gen_work_random (Function)\nGenerate work given block's previous hash (or if opening block, account public key), and threshold. Generates work using psuedorandom generator.\n\n**Parameters**\n- `hash` (*str*): Hex previous hash of block / account public key\n- `threshold` (*str*): Hex minimum work threshold\n\n**Returns**\n*str*, that is hex of work\n\n### gen_work_deterministic (Function)\nGenerate work given block's previous hash (or if opening block, account public key), and threshold. Generates work deterministically.\n\n**Parameters**\n- `hash` (*str*): Hex previous hash of block / account public key\n- `threshold` (*str*): Hex minimum work threshold\n\n**Returns**\n*str*, that is hex of work\n\n### gen_work (Function)\nGenerate work given block's previous hash (or if opening block, account public key). Basically a wrapper for `gen_work_deterministic` with threshold being the hardcoded Banano default.\n\n**Parameters**\n- `hash` (*str*): Hex previous hash of block / account public key\n\n**Returns**\n*str*, that is hex of work\n\n### verify_work (Function)\nVerify whether work is valid or not, given previous hash of block (or if opening block, account public key).\n\n**Parameters**\n- `hash` (*str*): Hex previous hash of block / account public key\n- `work` (*str*): Hex of work\n\n**Returns**\n*bool*, whether the work is valid or not\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A python library to simplify sending and receiving Banano. Also a RPC wrapper.",
    "version": "0.1.4.2",
    "project_urls": {
        "Homepage": "https://github.com/jetstream0/bananopie"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ad110d327691da3ac7a0ad4da92ded645c9098bf06a74f06d6de56ff49d2c020",
                "md5": "488ed42458e2df379e41ac6484875dc2",
                "sha256": "e05378dcd066815f58c95b8cd397cab1235d435a081961552b7164f0be739447"
            },
            "downloads": -1,
            "filename": "bananopie-0.1.4.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "488ed42458e2df379e41ac6484875dc2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.5",
            "size": 11760,
            "upload_time": "2024-12-15T19:57:52",
            "upload_time_iso_8601": "2024-12-15T19:57:52.371058Z",
            "url": "https://files.pythonhosted.org/packages/ad/11/0d327691da3ac7a0ad4da92ded645c9098bf06a74f06d6de56ff49d2c020/bananopie-0.1.4.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f3433490c6ce9080a98ad41b93b56e0ebeb23f4bca3d236e009057ae39093737",
                "md5": "d2661d2f46271191e82168f4cb440ecd",
                "sha256": "105dc97decb3c7991864535113a82089aaf110d4b4deb9007bc7a43e318d75cd"
            },
            "downloads": -1,
            "filename": "bananopie-0.1.4.2.tar.gz",
            "has_sig": false,
            "md5_digest": "d2661d2f46271191e82168f4cb440ecd",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5",
            "size": 14895,
            "upload_time": "2024-12-15T19:57:57",
            "upload_time_iso_8601": "2024-12-15T19:57:57.217180Z",
            "url": "https://files.pythonhosted.org/packages/f3/43/3490c6ce9080a98ad41b93b56e0ebeb23f4bca3d236e009057ae39093737/bananopie-0.1.4.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-15 19:57:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jetstream0",
    "github_project": "bananopie",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "bananopie"
}