Updated flatworm docs output.

This commit is contained in:
Richard Moore 2019-08-22 01:52:17 -04:00
parent 0333a76f4f
commit 8745a81b11
No known key found for this signature in database
GPG Key ID: 665176BE8E9DC651
62 changed files with 327 additions and 121 deletions

16
docs.wrm/README.md Normal file

@ -0,0 +1,16 @@
Documentation
=============
These docs are built using [Flatworm Docs](https://github.com/ricmoo/flatworm).
The output is placed in [docs](../docs) and generates both HTML and Markdown
files.
Building
--------
```
/home/ricmoo/ethers.js> npm run build-docs
```

@ -137,5 +137,5 @@ Returns the list of Listeners for //eventName//.
_subsection: Inspection Methods _subsection: Inspection Methods
_property: Provider.isProvider(object) => boolean _property: Provider.isProvider(object) => boolean
Returns true if and only if object is a Provider. Returns true if and only if //object// is a Provider.

9
docs.wrm/config.json Normal file

@ -0,0 +1,9 @@
{
"title": "ethers",
"subtitle": "v5.0-beta",
"logo": "logo.svg",
"link": "https://docs-beta.ethers.io",
"markdown": {
"banner": "-----\n\nDocumentation: [html](https://docs-beta.ethers.io/)\n\n-----\n\n"
}
}

12
docs.wrm/logo.svg Normal file

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Generator: Adobe Illustrator 23.0.4, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
viewBox="0 0 100 58" style="enable-background:new 0 0 100 58;" xml:space="preserve">
<style type="text/css">
.st0{fill-rule:evenodd;clip-rule:evenodd;fill:#FFFFFF;}
</style>
<path class="st0" d="M94.45,47.18c-42.62,5.57-73.04,12.26-73.49-15.2c0,0,0.93-10.64,13.98-11.31c0,0,0.44-9.45,10.41-10.52
c5.36-0.58,11.45,4.94,12.11,10.75c0,0,13.19-2.44,13.76,10.42c0.2,4.48-0.81,12.1-13.53,11.77c0,0-7.36-1-8.36-12.38
c-2.07,22.03,29.78,20.75,30.24,0.74c0.2-8.65-5.34-17.55-17.82-15.88C54.91-1.64,36.7-0.65,29.92,15.31
c-9.69,0-17.1,7.46-16.99,17.2C13.3,63.86,56.93,54.41,94.45,47.18z"/>
</svg>

After

Width:  |  Height:  |  Size: 853 B

@ -1,9 +1,10 @@
----- -----
test Documentation: [html](https://docs-beta.ethers.io/)
----- -----
What is ethers? What is ethers?
=============== ===============
@ -140,4 +141,4 @@ older versions of the library.
----- -----
**Content Hash:** 488687b8320fc7da1517bdf2b1ac582250593622aca6b0b3244f61fc14973e42 **Content Hash:** 6abeb4fa3f15b3443d89a26a6b0320f602a12368bc5ebbfb14a6cce682836167

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Application Programming Interface (API) Application Programming Interface (API)
======================================= =======================================
@ -74,4 +80,4 @@ Here...
----- -----
**Content Hash:** 3b51f44082b56d5b7fd9be77c92e6871df8642a3307b24d478ee625dbe1d8585 **Content Hash:** cbd0b8ac4ada4bfee211c0553ac53e171a6900127d874743a0dedf7fa30618f3

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Contracts Contracts
@ -14,4 +20,4 @@ Buckets
----- -----
**Content Hash:** c703f8cc79e5372fb818572209c72eaa54c68385c2021e6fc412594379d834e0 **Content Hash:** 190c93691014eae64ffcb66549f127aa73f4645fc7a4b3a2be9ae00216c79cf6

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Providers Providers
========= =========
@ -78,4 +84,4 @@ Provider Documentation
----- -----
**Content Hash:** 7c81bceed28adc2b3e892a999c49c14f0d63d29be28d44587c6c2bc63ecd0204 **Content Hash:** b15d8a2febb07abbbd784242c47575fbbb097f24643997ce30625c2e88adb095

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
API Providers API Providers
============= =============
@ -44,4 +50,4 @@ Tra la la...
----- -----
**Content Hash:** cc4a4f172bf2c52a4c2876b44408d293e57ff92b1607ece82192adada290b93a **Content Hash:** 9669eaaa1c2e9a31256fdd49e1b7f79550f064056b1bfd67a8cef6c7b5f8d473

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
JSON-RPC Provider JSON-RPC Provider
================= =================
@ -45,4 +51,4 @@ TODO... Explain
----- -----
**Content Hash:** 497729952599bd12a48198ea62e259c24bb3ec8de38d594f346695f34753a2c2 **Content Hash:** 09091214806fa2270a7425521fd948901355db2ec3406597fb5e29141b40639b

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Other Providers Other Providers
=============== ===============
@ -48,4 +54,4 @@ Explain...
----- -----
**Content Hash:** 5718f5431014c04862ff69aa2ff77548301446272c4ad92724b443850c10a117 **Content Hash:** c950a8710b679e9061aa834f8b0366614dcb031270627249acb412813bb5ca94

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Types Types
===== =====
@ -122,4 +128,4 @@ TODO
----- -----
**Content Hash:** 9b08b2e4c2db679ae2fc80deb4ce59ec288da11c40730d7e1a045a2538436b17 **Content Hash:** f6d5ea85b1ddef3a5b5bc0745984620507c001cf7d898c7842e006ddcd2b056b

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Signers Signers
======= =======
@ -63,4 +69,4 @@ TODO
----- -----
**Content Hash:** abb9583fce7bfb330648881c6855cebac07174afa724901ba883e2b33dcb0a07 **Content Hash:** 08ec198fa4ab407a1bed0a705073d7f40a6c3969b8e922961939fd8e009ca1ed

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Utilities Utilities
========= =========
@ -43,4 +49,4 @@ are also quite useful for application developers.
----- -----
**Content Hash:** 2ad729e67eb1303dcd0749dafe8b681b0e71d5511e3921ffdb45b81b2561755a **Content Hash:** ae9deb0419f2da1644ae9588d27ecc475961b741fa9d7b27b2cf13ddf62d50b6

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Addresses Addresses
========= =========
@ -42,4 +48,4 @@ TODO
----- -----
**Content Hash:** 85968aa9edabc277425171a51527f26b845070f5e2cc44ea573bae6b06a8b952 **Content Hash:** 0e138a3fe39efa87749ebc8290d153f705d26e547a38b7dce5f4d85603264d24

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
BigNumber BigNumber
========= =========
@ -104,42 +110,42 @@ Returns an instance of a **BigNumber** for *aBigNumberish*.
```javascript ```javascript
// From a decimal string... // From a decimal string...
BigNumber.from("42") BigNumber.from("42")
// { BigNumber: "42" }</span> // { BigNumber: "42" }
// From a hexstring... // From a hexstring...
BigNumber.from("0x2a") BigNumber.from("0x2a")
// { BigNumber: "42" }</span> // { BigNumber: "42" }
// From a negative hexstring... // From a negative hexstring...
BigNumber.from("-0x2a") BigNumber.from("-0x2a")
// { BigNumber: "-42" }</span> // { BigNumber: "-42" }
// From an Array (or Uint8Array)... // From an Array (or Uint8Array)...
BigNumber.from([ 42 ]) BigNumber.from([ 42 ])
// { BigNumber: "42" }</span> // { BigNumber: "42" }
// From an existing BigNumber... // From an existing BigNumber...
let one1 = constants.One; let one1 = constants.One;
let one2 = BigNumber.from(one1) let one2 = BigNumber.from(one1)
one2 one2
// { BigNumber: "1" }</span> // { BigNumber: "1" }
// ...which returns the same instance // ...which returns the same instance
one1 === one2 one1 === one2
// true</span> // true
// From a (safe) number... // From a (safe) number...
BigNumber.from(42) BigNumber.from(42)
// { BigNumber: "42" }</span> // { BigNumber: "42" }
// From a ES2015 BigInt... (only on platforms with BigInt support) // From a ES2015 BigInt... (only on platforms with BigInt support)
BigNumber.from(42n) BigNumber.from(42n)
// { BigNumber: "42" }</span> // { BigNumber: "42" }
// Numbers outside the safe range fail: // Numbers outside the safe range fail:
BigNumber.from(Number.MAX_SAFE_INTEGER); BigNumber.from(Number.MAX_SAFE_INTEGER);
// Error: overflow (fault="overflow", operation="BigNumber.from", value=9007199254740991, version=bignumber/5.0.0-beta.129)</span> // Error: overflow (fault="overflow", operation="BigNumber.from", value=9007199254740991, version=bignumber/5.0.0-beta.129)
``` ```
@ -331,7 +337,7 @@ let a = BigNumber.from(42);
let b = BigNumber.from("91"); let b = BigNumber.from("91");
a.mul(b); a.mul(b);
// { BigNumber: "3822" }</span> // { BigNumber: "3822" }
``` ```
@ -349,7 +355,7 @@ A few short notes on numbers...
The first problem many encounter when dealing with Ethereum is The first problem many encounter when dealing with Ethereum is
the concept of numbers. Most common currencies are broken down the concept of numbers. Most common currencies are broken down
with very little granularity. For example, there are only 100 with very little granularity. For example, there are only 100
cents in a single dollar. However, there are 10*18* **wei** in a cents in a single dollar. However, there are 10^18 **wei** in a
single **ether**. single **ether**.
JavaScript uses [IEEE 754 double-precision binary floating point](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) JavaScript uses [IEEE 754 double-precision binary floating point](https://en.wikipedia.org/wiki/Double-precision_floating-point_format)
@ -364,7 +370,7 @@ To demonstrate how this may be an issue in your code, consider:
```javascript ```javascript
(Number.MAX_SAFE_INTEGER + 2 - 2) == (Number.MAX_SAFE_INTEGER) (Number.MAX_SAFE_INTEGER + 2 - 2) == (Number.MAX_SAFE_INTEGER)
// false</span> // false
``` ```
@ -380,4 +386,4 @@ mathematical operations handled safely.
----- -----
**Content Hash:** 2bd4504f910c0e79b352ebb19083a36d6ee0ed263c279aa64a4921a28874c2e9 **Content Hash:** 269c8464ff80c77316617cbfa4e9a195d742f829a23911fecf0bba16961f81ae

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Byte Manipulation Byte Manipulation
================= =================
@ -119,27 +125,27 @@ zeros. The result of this function can be of odd-length.
```javascript ```javascript
// Convert a hexstring to a Uint8Array // Convert a hexstring to a Uint8Array
arrayify("0x1234") arrayify("0x1234")
// [ 18, 52 ]</span> // [ 18, 52 ]
// Convert an Array to a hexstring // Convert an Array to a hexstring
hexlify([1, 2, 3, 4]) hexlify([1, 2, 3, 4])
// 0x01020304</span> // 0x01020304
// Convert an Object to a hexstring // Convert an Object to a hexstring
hexlify({ length: 2, "0": 1, "1": 2 }) hexlify({ length: 2, "0": 1, "1": 2 })
// 0x0102</span> // 0x0102
// Convert an Array to a hexstring // Convert an Array to a hexstring
hexlify([ 1 ]) hexlify([ 1 ])
// 0x01</span> // 0x01
// Convert a number to a stripped hex value // Convert a number to a stripped hex value
hexValue(1) hexValue(1)
// 0x1</span> // 0x1
// Convert an Array to a stripped hex value // Convert an Array to a stripped hex value
hexValue([ 1, 2 ]) hexValue([ 1, 2 ])
// 0x102</span> // 0x102
``` ```
@ -240,4 +246,4 @@ computed.
----- -----
**Content Hash:** 6c6608cb249ff3e352417e8c99e1965500c19a3ae9b33d0397d7f8b84e78e20b **Content Hash:** 1e52066c61f8794d858f02fb8164b146c9379968b0e0ab90efeb2fe16831599f

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Constants Constants
========= =========
@ -98,4 +104,4 @@ The BigNumber value representing the maximum `uint256` value.
----- -----
**Content Hash:** 36d1996cf9909e8654bc8eef0c760bf3022681482bc88ebc553c79f0b224c9af **Content Hash:** a781a8990aec282632e70ebc003a711adf5bc7773243aed727fc37a0934097f7

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Display Logic and Input Display Logic and Input
======================= =======================
@ -104,4 +110,4 @@ The equivalent to calling `parseUnits(value, "ether")`.
----- -----
**Content Hash:** a0fd257cd92fcf3ae0659a22281fe10e7b68d632443cdf65556445a34365fcf1 **Content Hash:** 172c3345092afd2abb6a47dc225ae54c13c3ee3ce87868dd87e19656f4e6078d

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
FixedNumber FixedNumber
=========== ===========
@ -161,4 +167,4 @@ Returns true if and only if *value* is a **FixedNumber**.
----- -----
**Content Hash:** ddffbdca7bc7b54726596bd79a88e5df5dc947ff48bd2f93d516bb5b084aa4db **Content Hash:** e58731f51c5fe088aa89a78c7649ec914dce2d65dac9c1de3c4b3a89c911b46b

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Hashing Algorithms Hashing Algorithms
================== ==================
@ -131,4 +137,4 @@ according to their respective type in *arrayOfTypes*.
----- -----
**Content Hash:** d67fa58e91e9358b895d2c6dbb0ab2f6b1ce71b85c7c0d9bc1a93b4ae2eb4b23 **Content Hash:** 65dd2158ef160da7be3291c8e7aac15df2de683869df9c31b8efdaa39551b3e4

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Strings Strings
======= =======
@ -148,4 +154,4 @@ it should not be considered a method to acheive *any* level of security from
----- -----
**Content Hash:** f6a51816edca0ae4b74c16012629f26108f16204ff9d3aa3879fd44adb8d0d7f **Content Hash:** 74002cd3d9368872b5618f68967deac34a4d1aeafeeac6ddb5c1d06a450180c9

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Concepts Concepts
======== ========
@ -15,4 +21,4 @@ which developers can make use of or should be aware of.
----- -----
**Content Hash:** 1a99161696ee94f8320ce5b63367cfc1245dadb9dc5f52819e5a547b3f44c509 **Content Hash:** ad59f45600332d936821db1fa0d0eeabdab5b4f252e1e815de525b4d1b9a9a7b

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Events Events
====== ======
@ -8,4 +14,4 @@ Explain how topics and such work
----- -----
**Content Hash:** 1b85be44f478836054f7efb2aa093d82c399ddd636153815991b334dc1c1b4b3 **Content Hash:** 4b045e823bf9863272ddb1c5a8460bc461de2ad262503dc27829b64b57344d46

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Gas Gas
=== ===
@ -20,4 +26,4 @@ Gas Limit
----- -----
**Content Hash:** 0e5b9d2e12fbc359899548a8f3d7a0951ee96cc3dec2b4b64be0e4dbfa1371eb **Content Hash:** 4cc3001196d861faac19ebc393e002ce9e6f24702b66bac62ef8f9185625b3dc

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Contributing and Hacking Contributing and Hacking
======================== ========================
@ -36,4 +42,4 @@ use npm run update-version
----- -----
**Content Hash:** a9c6c700043f9b18ddd10b4b914603231c63c6adb95e26d3630fb39709b35eb6 **Content Hash:** f817d13fd530f58e6a03c9b5cb7190a3b7a084e8bf6eb05b130665c36d421950

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Cookbook Cookbook
======== ========
@ -8,4 +14,4 @@ Cooking...
----- -----
**Content Hash:** 19de63e3df2d64c5982c1625034ee40032aee1bd349eacf1cd8cf00c336548aa **Content Hash:** e3e2d42077858c887af142ae8f1c49a1882ea80d98cf4b75e272d97a65a0e713

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Flatworm Docs Flatworm Docs
============= =============
@ -154,7 +160,7 @@ Markdown
The markdown is simple and does not have the flexibility of The markdown is simple and does not have the flexibility of
other dialects, but allows for **bold**, *italic*, other dialects, but allows for **bold**, *italic*,
*underlined*, `monospaced`, *super-scripted* text, *underlined*, `monospaced`, ^super-scripted text,
supporting [links](./) and lists. supporting [links](./) and lists.
@ -188,4 +194,4 @@ This is a self-titled link [[https://ethereumorg]] and this
----- -----
**Content Hash:** 74aa879d77ec6a068c9233aefbf85188a6a18cacf24f5ba9c83cd3602c15e9ae **Content Hash:** 6cc55a98e7a50c76c8b27fbc7aae97bebaf9355a40b9c44a568f2f7fd927da57

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Getting Started Getting Started
=============== ===============
@ -60,4 +66,4 @@ Web Applications from our CDN.
----- -----
**Content Hash:** 5550edc55238e573fa55ca0421c610304a1c12cfa1281db2ddba44f36b1a3409 **Content Hash:** 01b739e7d4410ec57652b8058ae7a5902107ce0b170ecd3550cbc97f4d287fd8

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
License and Copyright License and Copyright
===================== =====================
@ -34,4 +40,4 @@ SOFTWARE.
----- -----
**Content Hash:** 33d04a7c1199b1f7bee1b864f1610c01fde9a928993a6ffb5816b7268183e9d0 **Content Hash:** 91addf1f9680c79e0db3ee454bc36cf3ba11b14221c075f21d8faf4d94146c65

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Migration Guide Migration Guide
=============== ===============
@ -22,4 +28,4 @@ test
----- -----
**Content Hash:** 9b0d95b05f5e8941f7984f2f5141af4c4b17eef142c924bea54c446f11a367f4 **Content Hash:** dc44071344e2a1a26a1638594b7403e8ab4722d4964a8ae5b9b94411eaa36f3c

File diff suppressed because one or more lines are too long

@ -1,3 +1,9 @@
-----
Documentation: [html](https://docs-beta.ethers.io/)
-----
Testing Testing
======= =======
@ -8,4 +14,4 @@ Here goes info about testing
----- -----
**Content Hash:** 864815b384bd40e56f3a5aee328bde2186e7453d8a0e968d5e6a6c719096d725 **Content Hash:** 8c2f2674db316066704a60c421caa69829c391dbf94998f98a603c75b237d42e

File diff suppressed because one or more lines are too long