Moonstream entity API client library
Project description
Moonstream Entity Python Client and CLI
In order to use this client, you will need a Moonstream access token. You can generate one at https://moonstream.to/account/tokens.
Detailed documentation you can find at https://docs.moonstream.to/engine/entity
The client library reads this token from the MOONSTREAM_ACCESS_TOKEN
environment variable. To set it:
export MOONSTREAM_ACCESS_TOKEN="<your_access_token>"
Install package from PyPI:
pip install moonstream-entity
Import and initialize client in your code:
import os
from entity.client import Entity
MOONSTREAM_ACCESS_TOKEN = os.environ.get("MOONSTREAM_ACCESS_TOKEN")
ec = Entity()
response = ec.list_collections(
token=MOONSTREAM_ACCESS_TOKEN,
timeout=10,
)
print(response.json())
Work with collections via CLI
Create collection:
entity --token "$MOONSTREAM_ACCESS_TOKEN" collections create --name "My Ethereum addresses"
List collections:
entity --token "$MOONSTREAM_ACCESS_TOKEN" collections list
Delete collection:
export MOONSTREAM_ENTITY_COLLECTION_ID="<your_collection_id>"
entity --token "$MOONSTREAM_ACCESS_TOKEN" collections delete --collection_id "$MOONSTREAM_ENTITY_COLLECTION_ID"
Work with entities via CLI
export MOONSTREAM_ENTITY_COLLECTION_ID="<your_collection_id>"
Create entity:
entity --token "$MOONSTREAM_ACCESS_TOKEN" entities create --collection_id "$MOONSTREAM_ENTITY_COLLECTION_ID" --address "0x000000000000000000000000000000000000dEaD" --blockchain ethereum --name "Dead address" --required_field '{"dead": true}' --required_field '{"owner": "unknown"}' --secondary_field '{"description": "Dangerous address for tokens burning mechanism."}'
Create entity bulk from csv:
Input file addresses.csv
contains list of addresses:
address,name
0xe1991fFb1f2271Bc645293cCDf4e38a3f1b7a13c,Address 1
0x37309157eC7863b04c66B6fB2bf7b21EE8B03bA1,Address 2
entity --token "$MOONSTREAM_ACCESS_TOKEN" entities bulk --blockchain ethereum --collection_id "$MOONSTREAM_ENTITY_COLLECTION_ID" --input addresses.csv --required_field '{"owner": "me"}' --secondary_field '{"description": "My bot address"}'
List entities in collection:
entity --token "$MOONSTREAM_ACCESS_TOKEN" entities list --collection_id "$MOONSTREAM_ENTITY_COLLECTION_ID"
Delete entity:
export MOONSTREAM_ENTITY_ID="<your_entity_id>"
entity --token "$MOONSTREAM_ACCESS_TOKEN" entities delete --collection_id "$MOONSTREAM_ENTITY_COLLECTION_ID" --entity_id "$MOONSTREAM_ENTITY_ID"
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
Built Distribution
Close
Hashes for moonstream_entity-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 988f0ee60c61da2c59f5975b56246605b3cf36bd39142a7fb88d340a1275de73 |
|
MD5 | 59b10ed434c101d77ede5891db54b3e5 |
|
BLAKE2b-256 | d72980c7c59892c1fcb1cbe937063115e402534bdb30b76eddb441b047d1c9c7 |