@layerzerolabs/verify-contract 1.1.1 → 1.1.4

package/README.md

@@ -48,13 +48,18 @@ Using the CLI contracts can be verified one network at a time.
 
 ### Programatic usage
 
-For programmatic usage you can use the package exports:
+The package provides two types of verification for hardhat deploy: _target_ and _non-target_.
+
+#### Target verification
+
+This is suitable for verifying contracts that have been the compilation targets for a deployment, i.e. they have their own deployment file.
+This is the default and easiest case for which we know all the information we need from the deployment file.
 
 ```typescript
-import { verifyHardhatDeploy } from "@layerzerolabs/verify-contract";
+import { verifyHardhatDeployTarget } from "@layerzerolabs/verify-contract";
 
 // Programmatic usage allows for more fine-grained and multi-network verification
-verifyHardhatDeploy({
+verifyHardhatDeployTarget({
   paths: {
     deployments: "./my/little/deployments/folder",
   },
@@ -64,18 +69,84 @@ verifyHardhatDeploy({
       apiKey: "david.hasselhoff.1234",
     },
   },
-  // The verify option allows you to limit the scope of verification to
+  // The filter option allows you to limit the scope of verification to
   // specific contracts
   //
   // It supports several ways of scoping the verification:
   //
   // A list of case-sensitive contract names
-  verify: ["Factory", "Router"],
+  filter: ["Factory", "Router"],
   // A single contract name
-  verify: "ONFT1155",
+  filter: "ONFT1155",
   // Boolean to toggle the verification as a whole
-  verify: false,
+  filter: false,
   // A function that gets passed the contract name and an relative contract path and returns a boolean to signify the contract needs to be verified
-  verify: (name, path) => name.startsWith("Potato721"),
+  filter: (name, path) => name.startsWith("Potato721"),
+});
+```
+
+#### Non-target verification
+
+This is suitable for verifying contracts that have been e.g. deployed dynamically from other contracts within the deployment.
+
+In this case we need to know more information - the specific deployment file to use, the address of the contract and also its constructor arguments.
+
+```typescript
+import { verifyHardhatDeployNonTarget } from "@layerzerolabs/verify-contract";
+
+// Programmatic usage allows for more fine-grained and multi-network verification
+verifyHardhatDeployNonTarget({
+  paths: {
+    deployments: "./my/little/deployments/folder",
+  },
+  networks: {
+    whatachain: {
+      apiUrl: "https://api.whatachain.io/api",
+      apiKey: "david.hasselhoff.1234",
+    },
+  },
+  // The contracts array is used to pass the contract details
+  contracts: [
+    {
+      address: "0x0",
+      network: "whatachain",
+      // We'll need to pass the name of the deployment file to use (relative to the deployments path)
+      deployment: "OtherContract.json",
+      constructorArguments: [1000, "0x0"],
+      // In this case we'll need to pass a fully-qualified contract name
+      contractName: "contracts/examples/Pool.sol",
+    },
+  ],
 });
 ```
+
+### Default configuration
+
+The package is preconfigured for scan API URLs for several well-known networks:
+
+| Network                                                        | API URL                                          |
+| -------------------------------------------------------------- | ------------------------------------------------ |
+| `avalanche`, `avalanche-mainnet`                               | `https://api.snowtrace.io/api`                   |
+| `fuji`, `avalanche-testnet`                                    | `https://api-testnet.snowtrace.io/api`           |
+| `bsc`                                                          | `https://api.bscscan.com/api`                    |
+| `bsc-testnet`                                                  | `https://api-testnet.bscscan.com/api`            |
+| `ethereum`                                                     | `https://api.etherscan.io/api`                   |
+| `ethereum-goerli`                                              | `https://api-goerli.etherscan.io/api`            |
+| `goerli`                                                       | `https://api-goerli.etherscan.io/api`            |
+| `fantom`                                                       | `https://api.ftmscan.com/api`                    |
+| `fantom-testnet`                                               | `https://api-testnet.ftmscan.com/api`            |
+| `arbitrum`                                                     | `https://api.arbiscan.io/api`                    |
+| `arbitrum-goerli`                                              | `https://api-goerli.arbiscan.io/api`             |
+| `polygon`                                                      | `https://api.polygonscan.com/api`                |
+| `mumbai`                                                       | `https://api-testnet.polygonscan.com/api`        |
+| `optimism`                                                     | `https://api-optimistic.etherscan.io/api`        |
+| `optimism-goerli`                                              | `https://api-goerli-optimistic.etherscan.io/api` |
+| `gnosis`                                                       | `https://api.gnosisscan.io/api`                  |
+| `zkpolygon`, `zkpolygon-mainnet`                               | `https://api-zkevm.polygonscan.com/api`          |
+| `base`, `base-mainnet`                                         | `https://api.basescan.org/api`                   |
+| `base-goerli`                                                  | `https://api-goerli.basescan.org/api`            |
+| `zkconsensys`, `zkconsensys-mainnet`, `linea`, `linea-mainnet` | `https://api.lineascan.build/api`                |
+| `moonbeam`                                                     | `https://api-moonbeam.moonscan.io/api`           |
+| `moonbeam-testnet`                                             | `https://api-moonbase.moonscan.io/api`           |
+| `kava`, `kava-mainnet`                                         | `https://kavascan.com/api`                       |
+| `kava-testnet`                                                 | `https://testnet.kavascan.com/api`               |

package/cli/Solidity.tokens

@@ -0,0 +1,249 @@
+T__0=1
+T__1=2
+T__2=3
+T__3=4
+T__4=5
+T__5=6
+T__6=7
+T__7=8
+T__8=9
+T__9=10
+T__10=11
+T__11=12
+T__12=13
+T__13=14
+T__14=15
+T__15=16
+T__16=17
+T__17=18
+T__18=19
+T__19=20
+T__20=21
+T__21=22
+T__22=23
+T__23=24
+T__24=25
+T__25=26
+T__26=27
+T__27=28
+T__28=29
+T__29=30
+T__30=31
+T__31=32
+T__32=33
+T__33=34
+T__34=35
+T__35=36
+T__36=37
+T__37=38
+T__38=39
+T__39=40
+T__40=41
+T__41=42
+T__42=43
+T__43=44
+T__44=45
+T__45=46
+T__46=47
+T__47=48
+T__48=49
+T__49=50
+T__50=51
+T__51=52
+T__52=53
+T__53=54
+T__54=55
+T__55=56
+T__56=57
+T__57=58
+T__58=59
+T__59=60
+T__60=61
+T__61=62
+T__62=63
+T__63=64
+T__64=65
+T__65=66
+T__66=67
+T__67=68
+T__68=69
+T__69=70
+T__70=71
+T__71=72
+T__72=73
+T__73=74
+T__74=75
+T__75=76
+T__76=77
+T__77=78
+T__78=79
+T__79=80
+T__80=81
+T__81=82
+T__82=83
+T__83=84
+T__84=85
+T__85=86
+T__86=87
+T__87=88
+T__88=89
+T__89=90
+T__90=91
+T__91=92
+T__92=93
+T__93=94
+T__94=95
+T__95=96
+Int=97
+Uint=98
+Byte=99
+Fixed=100
+Ufixed=101
+BooleanLiteral=102
+DecimalNumber=103
+HexNumber=104
+NumberUnit=105
+HexLiteralFragment=106
+ReservedKeyword=107
+AnonymousKeyword=108
+BreakKeyword=109
+ConstantKeyword=110
+ImmutableKeyword=111
+ContinueKeyword=112
+LeaveKeyword=113
+ExternalKeyword=114
+IndexedKeyword=115
+InternalKeyword=116
+PayableKeyword=117
+PrivateKeyword=118
+PublicKeyword=119
+VirtualKeyword=120
+PureKeyword=121
+TypeKeyword=122
+ViewKeyword=123
+GlobalKeyword=124
+ConstructorKeyword=125
+FallbackKeyword=126
+ReceiveKeyword=127
+Identifier=128
+StringLiteralFragment=129
+VersionLiteral=130
+WS=131
+COMMENT=132
+LINE_COMMENT=133
+'pragma'=1
+';'=2
+'*'=3
+'||'=4
+'^'=5
+'~'=6
+'>='=7
+'>'=8
+'<'=9
+'<='=10
+'='=11
+'as'=12
+'import'=13
+'from'=14
+'{'=15
+','=16
+'}'=17
+'abstract'=18
+'contract'=19
+'interface'=20
+'library'=21
+'is'=22
+'('=23
+')'=24
+'error'=25
+'using'=26
+'for'=27
+'|'=28
+'&'=29
+'+'=30
+'-'=31
+'/'=32
+'%'=33
+'=='=34
+'!='=35
+'struct'=36
+'modifier'=37
+'function'=38
+'returns'=39
+'event'=40
+'enum'=41
+'['=42
+']'=43
+'address'=44
+'.'=45
+'mapping'=46
+'=>'=47
+'memory'=48
+'storage'=49
+'calldata'=50
+'if'=51
+'else'=52
+'try'=53
+'catch'=54
+'while'=55
+'unchecked'=56
+'assembly'=57
+'do'=58
+'return'=59
+'throw'=60
+'emit'=61
+'revert'=62
+'var'=63
+'bool'=64
+'string'=65
+'byte'=66
+'++'=67
+'--'=68
+'new'=69
+':'=70
+'delete'=71
+'!'=72
+'**'=73
+'<<'=74
+'>>'=75
+'&&'=76
+'?'=77
+'|='=78
+'^='=79
+'&='=80
+'<<='=81
+'>>='=82
+'+='=83
+'-='=84
+'*='=85
+'/='=86
+'%='=87
+'let'=88
+':='=89
+'=:'=90
+'switch'=91
+'case'=92
+'default'=93
+'->'=94
+'callback'=95
+'override'=96
+'anonymous'=108
+'break'=109
+'constant'=110
+'immutable'=111
+'continue'=112
+'leave'=113
+'external'=114
+'indexed'=115
+'internal'=116
+'payable'=117
+'private'=118
+'public'=119
+'virtual'=120
+'pure'=121
+'type'=122
+'view'=123
+'global'=124
+'constructor'=125
+'fallback'=126
+'receive'=127