mmisdk 0.1.0

A Python library to create and submit EVM transactions to custodians connected with MetaMask Institutional.

MMI Custodian SDK

A Python library to create and submit EVM transactions to custodians connected with MetaMask Institutional.

Usage

For documentation on how to use the library, please visit the page MetaMask Institutional SDK, or visit the GitLab repository.

You can also explore various usage examples in the directory ./examples.

TL;DR

pip3 install mmisdk

from mmisdk.custodian_factory import CustodianFactory

factory = CustodianFactory()

custodian = factory.create_for("qredo", "YOUR-REFRESH-TOKEN")

transaction = custodian.create_transaction(qredo_tx_details, tx_params)
custodian.get_transaction(transaction.id)

Developer documentation

🚨 The commands we list below use python and pip. Depending on your local setup, you might need to replace them by python3 and pip3.

Requirements

• Python 3.7 or above

Installing dependencies

To install mmisdk, along with the tools you need to develop and run tests, run the following:

pip install -e .[dev]

Unit tests

Run all unit tests with:

pytest

Releasing the library

Before releasing your package on PyPI you should have all the tox environments passing.

Version management

To release a new version, follow these steps:

1. Make sur you're on branch main

2. This template provides a basic bumpversion configuration. To bump the version, run:

   • bumpversion patch to increase version from 1.0.0 to 1.0.1.
   • bumpversion minor to increase version from 1.0.0 to 1.1.0.
   • bumpversion major to increase version from 1.0.0 to 2.0.0.

   Use Semantic Versioning 2.0.0 standard to bump versions.

3. Push the changes and the tags:

   git push --tags
   

Building the library

Before building dists make sure you got a clean build area:

rm -rf build
rm -rf src/*.egg-info

Note:

Dirty build or egg-info dirs can cause problems: missing or stale files in the resulting dist or strange and confusing errors. Avoid having them around.

Then you should check that you got no packaging issues:

tox -e check

When checking with tox -e check, you might receive warnings from isort that imports are not properly ordered. To automatically sort your imports with isort, run the following:

pip install isort
isort .

To run a complete QA analysis, including unit tests again multiple Python versions, manifest check, and imports order check, run:

tox

And then you can build the sdist, and if possible, the bdist_wheel too:

python setup.py clean --all sdist bdist_wheel

Publishing to PyPI

To make a release of the project on PyPI, assuming you got some distributions in dist/, the most simple usage is:

twine upload --skip-existing dist/*.whl dist/*.gz dist/*.zip

In ZSH you can use this to upload everything in dist/ that ain't a linux-specific wheel (you may need setopt extended_glob):

twine upload --skip-existing dist/*.(whl|gz|zip)~dist/*linux*.whl

Contributing

See CONTRIBUTING.rst.

Changelog

See CHANGELOG.md.