Added support for signer

MANIFEST.in

@@ -1,2 +1,3 @@
 include LICENSE
+recursive-include src/nile/artifacts/ *
 recursive-include src/nile/base_project/ *

README.md

@@ -88,6 +88,56 @@ A few things to notice here:
 3. The `--alias` parameter lets me create an unique identifier for future interactions, if no alias is set then the contract's address can be used as identifier
 4. By default Nile works on local, but you can pass `--network mainnet` to deploy directly to a public chain! Notice that `mainnet` refers to StarkNet main chain, that's settled on Goerli testnet of Ethereum ([mainnet deployment this month!](https://medium.com/starkware/starknet-alpha-is-coming-to-mainnet-b825829eaf32))
 
+### `setup`
+You can find an exemple `.env` file in `example.env`. These are private keys only to be used for testing and never in production.
+
+```sh
+nile setup PKEY1
+
+🚀 Deploying Account
+🌕 artifacts/Account.json successfully deployed to 0x07db6b52c8ab888183277bc6411c400136fe566c0eebfb96fffa559b2e60e794
+📦 Registering deployment as account-0 in localhost.deployments.txt
+Invoke transaction was sent.
+Contract address: 0x07db6b52c8ab888183277bc6411c400136fe566c0eebfb96fffa559b2e60e794
+Transaction hash: 0x17
+```
+
+A few things to notice here:
+
+1. `nile set <env_var>` looks for an environement variable with the same name whose value is a private key
+2. This created a `localhost.accounts.json` file storing all data related to accounts management
+
+### `raw-execute`
+Execute a transaction through the `Account` associated with the private key used. The syntax is:
+
+```sh
+nile raw-execute <env_signer> <contract_address> <contract_method> <args>
+```
+
+```sh
+nile raw-execute PKEY1 0x0342e...4de4e0 transfer_ownership 0x07db6...60e794
+
+Invoke transaction was sent.
+Contract address: 0x03420417e09260947e3412d48952858a376f2d3ddde4e49f5981a2e41f4de4e0
+Transaction hash: 0x1c
+```
+
+### `send`
+Acts like `raw-execute` with the exception you can use it like you would use `nile invoke`.
+Execute a transaction through the `Account` associated with the private key used. The syntax is:
+
+```sh
+nile send <env_signer> <contract_identifier> <contract_method> [PARAM_1, PARAM2...]
+```
+
+```sh
+nile send PKEY1 ownable0 transfer_ownership 0x07db6...60e794
+
+Invoke transaction was sent.
+Contract address: 0x07db6b52c8ab888183277bc6411c400136fe566c0eebfb96fffa559b2e60e794
+Transaction hash: 0x1c
+```
+
 ### `call` and `invoke`
 Using `call` and `invoke`, we can perform read and write operations against our local node (or public one using the `--network mainnet` parameter). The syntax is:
 

example.env

@@ -0,0 +1,2 @@
+PKEY1=1234
+PKEY2=5678

setup.cfg

@@ -25,6 +25,7 @@ python_requires = >=3.7
 install_requires =
     click>=8.0,<9.0
     importlib-metadata>=4.0
+    python-dotenv>=0.19.2
 
 [options.packages.find]
 where = src

src/nile/accounts.py

@@ -0,0 +1,48 @@
+"""nile common module."""
+import json
+import os
+
+from nile.common import ACCOUNTS_FILENAME
+
+
+def register(pubkey, address, index, network):
+    """Register a new account."""
+    file = f"{network}.{ACCOUNTS_FILENAME}"
+
+    if exists(pubkey, network):
+        raise Exception(f"account-{index} already exists in {file}")
+
+    with open(file, "r") as fp:
+        accounts = json.load(fp)
+        accounts[pubkey] = {"address": address, "index": index}
+    with open(file, "w") as file:
+        json.dump(accounts, file)
+
+
+def exists(pubkey, network):
+    """Return whether an account exists or not."""
+    foo = next(load(pubkey, network), None)
+    return foo is not None
+
+
+def load(pubkey, network):
+    """Load account that matches a pubkey."""
+    file = f"{network}.{ACCOUNTS_FILENAME}"
+
+    if not os.path.exists(file):
+        with open(file, "w") as fp:
+            json.dump({}, fp)
+
+    with open(file) as fp:
+        accounts = json.load(fp)
+        if pubkey in accounts:
+            yield accounts[pubkey]
+
+
+def current_index(network):
+    """Return the length of the accounts. Used as the next index."""
+    file = f"{network}.{ACCOUNTS_FILENAME}"
+
+    with open(file) as fp:
+        accounts = json.load(fp)
+        return len(accounts.keys())