Migrate Python libraries to v3

[feuGeneA]

Description

Fixes #2163 .

Latest build artifacts (for commit e472cee on Nov 4 at 9:51 PM EDT):

• Exchange contract wrapper
• 0x-contract-wrappers documentation

(If you're interested in reviewing generated wrappers for any other contracts, or docs for any other packages, let me know and I can dig up the direct links from the Circle CI runs for you.)

Testing instructions

0x-monorepo$ PKG=@0x/abi-gen yarn build
0x-monorepo/python-packages$ ./pre_install # generates contract wrappers, populates contract artifacts & json schemas
0x-monorepo/python-packages$ ./install
0x-monorepo/python-packages/sra_client$ ./setup.py start_test_relayer
0x-monorepo/python-packages$ ./parallel ./setup.py test
0x-monorepo/python-packages$ ./build_docs

Checklist:

Finish these in this PR:

• Get existing tests & examples working with v3 contracts.
• Change zero_ex.order_utils.sign_hash() to accept either a provider OR a web3 instance, so that a user can install a middleware (such as one to pre-sign messages) before invoking it.
• Change generated contract wrappers to accept either a web3 object or a provider, so that people can install a local-signing middleware to be used by contract transactions.
• Change contract's installation of rich-revert-handling middleware to not care if there's an error re-inserting it again. ValueError("You can't add the same un-named instance twice") is currently being raised if you instantiate an Exchange wrapper twice in the same Python process.
• Clean up "web3 has no such attribute" # type: ignores. Need to expand mypy stubs rather than disabling linter checks in the code.
• Migrate SRA client to v3.
• Add new entries to the relevant CHANGELOG.jsons.

Raise new Issues for these discovered items so they can be addressed in a subsequent PR:

• Change contract method return types where they are returning multiple values. Currently they're just coming back as tuples. They need to be coming back as dicts (with named fields) in accordance with the type definitions we've already written. Python contract wrapper methods return raw tuples #2298
• Update doc links everywhere. For example, in contract_wrappers/src/index.rst, there are lots of references to https://0x.org/docs/contracts#..., which seem to be broken. Checklist for final Python publish of 3.0 support #2299
• Consider revising docker commands in documentation (docstrings) because they don't work as stated right now (because you need to specify the ganache version and snapshot name). Or skip that because it will "just work" later when we publish a stable v3 snapshot/docker-image? Checklist for final Python publish of 3.0 support #2299

[coveralls]

Coverage remained the same at 75.286% when pulling 19fac92 on feat/3.0/python into 3c6c412 on development.

[buildsize]

File name	Previous Size	New Size	Change
init.py	7.04 KB	26.91 KB	19.87 KB (282%)
abi_gen_dummy.ts	184.68 KB	[deleted]
lib_dummy.ts	5.23 KB	[deleted]
test_lib_dummy.ts	14.8 KB	[deleted]
environment.pickle	[new file]	1.61 MB
index.doctree	[new file]	193.72 KB
.buildinfo	[new file]	230 bytes
genindex.html	[new file]	5.6 KB
index.html	[new file]	2.52 KB
objects.inv	[new file]	375 bytes
py-modindex.html	[new file]	3.07 KB
search.html	[new file]	2.84 KB
searchindex.js	[new file]	6.02 KB
index.rst.txt	[new file]	415 bytes
alabaster.css	[new file]	10.92 KB
basic.css	[new file]	11.89 KB
custom.css	[new file]	42 bytes
doctools.js	[new file]	9.05 KB
documentation_options.js	[new file]	303 bytes
file.png	[new file]	286 bytes
jquery-[version].js	[new file]	273.79 KB
jquery.js	[new file]	86.08 KB
language_data.js	[new file]	10.59 KB
minus.png	[new file]	90 bytes
plus.png	[new file]	90 bytes
pygments.css	[new file]	4.69 KB
searchtools.js	[new file]	15.61 KB
underscore-[version].js	[new file]	34.34 KB
underscore.js	[new file]	11.86 KB
contract_addresses.html	[new file]	16.86 KB
contract_artifacts.html	[new file]	8.24 KB
json_schemas.html	[new file]	12.56 KB
order_utils.html	[new file]	46.86 KB
asset_proxy_owner.html	[new file]	350.44 KB
coordinator.html	[new file]	133.77 KB
coordinator_registry.html	[new file]	39.72 KB
dev_utils.html	[new file]	525.67 KB
dutch_auction.html	[new file]	59.6 KB
erc1155_mintable.html	[new file]	288.23 KB
erc1155_proxy.html	[new file]	129.7 KB
erc20_proxy.html	[new file]	111 KB
erc20_token.html	[new file]	93.31 KB
erc721_proxy.html	[new file]	111.12 KB
erc721_token.html	[new file]	148.29 KB
eth_balance_checker.html	[new file]	24.65 KB
exchange.html	[new file]	678.51 KB
forwarder.html	[new file]	110.46 KB
i_asset_proxy.html	[new file]	39.32 KB
i_validator.html	[new file]	30.37 KB
i_wallet.html	[new file]	27.63 KB
multi_asset_proxy.html	[new file]	148.59 KB
order_validator.html	[new file]	120.52 KB
static_call_proxy.html	[new file]	39.44 KB
tx_params.html	[new file]	9.41 KB
weth9.html	[new file]	133.98 KB
zrx_token.html	[new file]	111.93 KB
local_message_signer.html	[new file]	15.07 KB
asset_data_utils.html	[new file]	22.65 KB
types.html	[new file]	8.68 KB
default_api.html	[new file]	118.3 KB

[PirosB3]

Sorry @feuGeneA I forgot to press the Submit button

[PirosB3]

Sounds like you have addressed some of the changes that I suggested. I'm happy to sign off, but it's up to you if you would also rather have some second reviewer, given the size of this PR

[steveklebanoff]

Is chain_id really assignable to an Order?

When I run mypy on a file that looks like this:

order = Order(
    makerAddress='0x',
    takerAddress='0x0000000000000000000000000000000000000000',
    senderAddress='0x0000000000000000000000000000000000000000',
    feeRecipientAddress='0x0000000000000000000000000000000000000000',
    makerAssetData='0x',
    takerAssetData='0x',
    salt=1,
    makerFee=0,
    takerFee=0,
    makerAssetAmount=1,
    takerAssetAmount=1,
    expirationTimeSeconds=1,
    makerFeeAssetData='0x',
    takerFeeAssetData='0x',
    chain_id=42
)

I get the complaint:

error: Extra key 'chain_id' for TypedDict "Order"

Note, this is using contract-wrappers 2.0.0.dev9

[feuGeneA]

Thanks @steveklebanoff ! Fixed in 19fac92