31:T4ad,Try a real [ERC20](https://docs.openzeppelin.com/contracts/4.x/erc20) Smart Contract on the [Filecoin Virtual Machine](https://fvm.filecoin.io/)! Here is an example EVM Smart Contract, from: * https://github.com/filecoin-project/testnet-wallaby/issues/8 * https://github.com/filecoin-project/fvm-example-actors/tree/main/erc20-sans-events * https://github.com/jimpick/fvm-example-actors/tree/jim-erc20/erc20-sans-events (same as above, but with extra build scripts and missing files) You can modify it here, then scroll down and click the buttons to compile it, then load it into a on-demand hosted [Lotus localnet](https://lotus.filecoin.io/developers/local-network/) created from the [experimental/fvm-m2](https://github.com/filecoin-project/lotus/tree/experimental/fvm-m2) branch, and invoke methods against it. **Note:** The on-demand localnet will be reclaimed after 3 minutes of inactivity. Modifications to the blockchain state are ephemeral -- good for testing! Staying on this page will keep it alive, but if you navigate away and then return, it may get restarted with fresh state. If that happens, reload the web page. There is one instance of the localnet shared between all users.32:T52c,{ if (createActorStatus === undefined || !createActorStatus) { yield md`Status: Instance has not been created yet.` return } if (createActorStatus.creating) { while (true) { const elapsed = (Date.now() - createActorStatus.start) / 1000 yield md`Sending create actor message... (${elapsed.toFixed(1)}s)` await Promises.delay(1000) } } if (createActorStatus.response) { while (true) { let output = `

Create actor message sent

Message CID: ${createActorStatus.response.CID['/']}

` if (createActorStatus.waitResponse) { output += `

Message executed in block at height: ${createActorStatus.waitResponse.Height}

` output += `

Gas used: ${createActorStatus.waitResponse.Receipt.GasUsed}

` output += `

Robust Address: ${createActorStatus.waitResponse.ReturnDec.RobustAddress}

` output += `ID Address: ${createActorStatus.waitResponse.ReturnDec.IDAddress}
` yield html`${output}` break } const elapsed = (Date.now() - createActorStatus.waitStart) / 1000 output += `

Waiting for message to be executed in a block... (${elapsed.toFixed(1)}s)

` yield html`${output}` await Promises.delay(1000) } } }33:T679,{ if (invokeEvmMethodStatus === undefined || !invokeEvmMethodStatus) { yield md`Status: Method has not been invoked yet.` return } if (invokeEvmMethodStatus.invoking) { while (true) { const elapsed = (Date.now() - invokeEvmMethodStatus.start) / 1000 yield md`Sending message to actor for method... (${elapsed.toFixed(1)}s)` await Promises.delay(1000) } } if (invokeEvmMethodStatus.response) { while (true) { let output = `

Message sent to actor

To: ${invokeEvmMethodButton}

Message CID: ${invokeEvmMethodStatus.response.CID['/']}

` if (invokeEvmMethodStatus.waitResponse) { output += `

Message executed in block at height: ${invokeEvmMethodStatus.waitResponse.Height}

` output += `

Gas used: ${invokeEvmMethodStatus.waitResponse.Receipt.GasUsed}

` output += `

Return: ${invokeEvmMethodStatus.waitResponse.Receipt.Return} (Base64 encoded binary array)

` output += `

Decoded Result (Hex): ${JSON.stringify(invokeEvmMethodStatus.decodedResult.toString('hex'))}

` output += `

Decoded Result (Decimal): ${Number(`0x${invokeEvmMethodStatus.decodedResult.toString('hex')}`)} coins

` yield html`${output}` break } const elapsed = (Date.now() - invokeEvmMethodStatus.waitStart) / 1000 output += `

Waiting for message to be executed in a block... (${elapsed.toFixed(1)}s)

` yield html`${output}` await Promises.delay(1000) } } }34:T5f0,{ if (transferFromOwnerStatus === undefined || !transferFromOwnerStatus) { yield md`Status: Method has not been invoked yet.` return } if (transferFromOwnerStatus.invoking) { while (true) { const elapsed = (Date.now() - transferFromOwnerStatus.start) / 1000 yield md`Sending message to actor for method... (${elapsed.toFixed(1)}s)` await Promises.delay(1000) } } if (transferFromOwnerStatus.response) { while (true) { let output = `

Message sent to actor

To: ${transferFromOwnerButton.actorId}

Message CID: ${transferFromOwnerStatus.response.CID['/']}

` if (transferFromOwnerStatus.waitResponse) { output += `

Message executed in block at height: ${transferFromOwnerStatus.waitResponse.Height}

` output += `

Gas used: ${transferFromOwnerStatus.waitResponse.Receipt.GasUsed}

` output += `

Return: ${transferFromOwnerStatus.waitResponse.Receipt.Return} (Base64 encoded binary array)

` output += `

Decoded Result (Hex): ${JSON.stringify(transferFromOwnerStatus.decodedResult.toString('hex'))}

` yield html`${output}` break } const elapsed = (Date.now() - transferFromOwnerStatus.waitStart) / 1000 output += `

Waiting for message to be executed in a block... (${elapsed.toFixed(1)}s)

` yield html`${output}` await Promises.delay(1000) } } }35:T4d0,transferFromOwnerStatus = { if (transferFromOwnerButton) { const start = Date.now() yield { invoking: true, start } const dest = getEvmAddress(transferFundsStatus.lookups[transferFromOwnerButton.dest.address]) const amount = transferFromOwnerButton.amount.toString(16).padStart(64, '0') const params = buffer.Buffer.concat([ buffer.Buffer.from('a9059cbb', 'hex'), buffer.Buffer.from(dest, 'hex'), buffer.Buffer.from(amount, 'hex') ]) const messageBody = { To: transferFromOwnerButton.actorId, From: walletDefaultAddress, Value: "0", Method: 2, Params: params.toString('base64') } console.log('messageBody', messageBody) const response = await client.mpoolPushMessage(messageBody, null) const waitStart = Date.now() yield { waiting: true, waitStart, response } const waitResponse = await client.stateWaitMsg(response.CID, 0) let decodedResult if (waitResponse.Receipt && waitResponse.Receipt.Return) { decodedResult = buffer.Buffer.from(waitResponse.Receipt.Return, 'base64') } yield { invoked: true, response, waitResponse, decodedResult } mutable invalidatedBalancesAt = new Date() } }36:T6ea,tokenBalancesStatus = { invalidatedBalancesAt; const evmActorId = createActorStatus?.waitResponse?.ReturnDec?.IDAddress if (walletDefaultAddress && keys && evmActorId) { const start = Date.now() yield { retrieving: true, start } const ownerKey = { name: 'Owner', address: walletDefaultAddress } const allKeys = [ownerKey].concat(keys) const responses = [] for (const key of allKeys) { const keyActorId = transferFundsStatus.lookups[key.address] const addressEvm = getEvmAddress(keyActorId) const params = buffer.Buffer.concat([ buffer.Buffer.from('70a08231', 'hex'), buffer.Buffer.from(addressEvm, 'hex') ]) const messageBody = { To: evmActorId, From: walletDefaultAddress, Value: "0", Method: 2, Params: params.toString('base64') } responses.push(await client.mpoolPushMessage(messageBody, null)) } const waitStart = Date.now() yield { waiting: true, start, waitStart, responses } const promises = [] for (const response of responses) { promises.push(client.stateWaitMsg(response.CID, 0)) } const waitResponses = await Promise.all(promises) const balances = waitResponses.map(waitResponse => { const base64 = waitResponse?.Receipt?.Return if (base64) { const bytes = buffer.Buffer.from(base64, 'base64') let multiplier = 1n let acc = 0n for (let i = 0; i < bytes.length; i++) { const value = bytes[bytes.length - i - 1] acc += BigInt(value) * multiplier multiplier *= 256n } return acc } }) yield { retrieved: true, responses, waitResponses, balances, allKeys } } }37:T5e3,{ if (transferFromUserStatus === undefined || !transferFromUserStatus) { yield md`Status: Method has not been invoked yet.` return } if (transferFromUserStatus.invoking) { while (true) { const elapsed = (Date.now() - transferFromUserStatus.start) / 1000 yield md`Sending message to actor for method... (${elapsed.toFixed(1)}s)` await Promises.delay(1000) } } if (transferFromUserStatus.response) { while (true) { let output = `

Message sent to actor

To: ${transferFromUserButton.actorId}

Message CID: ${transferFromUserStatus.response.CID['/']}

` if (transferFromUserStatus.waitResponse) { output += `

Message executed in block at height: ${transferFromUserStatus.waitResponse.Height}

` output += `

Gas used: ${transferFromUserStatus.waitResponse.Receipt.GasUsed}

` output += `

Return: ${transferFromUserStatus.waitResponse.Receipt.Return} (Base64 encoded binary array)

` output += `

Decoded Result (Hex): ${JSON.stringify(transferFromUserStatus.decodedResult.toString('hex'))}

` yield html`${output}` break } const elapsed = (Date.now() - transferFromUserStatus.waitStart) / 1000 output += `

Waiting for message to be executed in a block... (${elapsed.toFixed(1)}s)

` yield html`${output}` await Promises.delay(1000) } } }38:T652,transferFromUserStatus = { if (transferFromUserButton) { const start = Date.now() yield { invoking: true, start } const dest = getEvmAddress(transferFundsStatus.lookups[transferFromUserButton.dest.address]) const amount = transferFromUserButton.amount.toString(16).padStart(64, '0') const params = buffer.Buffer.concat([ buffer.Buffer.from('a9059cbb', 'hex'), buffer.Buffer.from(dest, 'hex'), buffer.Buffer.from(amount, 'hex') ]) const message = { To: transferFromUserButton.actorId, From: transferFromUserButton.source.address, Nonce: 0, Value: "0", GasLimit: 1000000000, GasFeeCap: new FilecoinNumber(0, 'attofil'), GasPremium: new FilecoinNumber(0, 'attofil'), Method: 2, Params: params.toString('base64') } const privateKey = keys.find(({ address }) => address === transferFromUserButton.source.address).privateKey console.log('message', message) const responseCID = await filecoin_client.tx.sendMessage( message, privateKey, true, // updateMsgNonce false // waitMsg ) const waitStart = Date.now() yield { waiting: true, waitStart, response: { CID: responseCID } } const waitResponse = await client.stateWaitMsg(responseCID, 0) let decodedResult if (waitResponse.Receipt && waitResponse.Receipt.Return) { decodedResult = buffer.Buffer.from(waitResponse.Receipt.Return, 'base64') } yield { invoked: true, response: { CID: responseCID }, waitResponse, decodedResult } mutable invalidatedBalancesAt = new Date() } }39:[{"id":"2aa607f0a34ff42eed6860893616da5b8d2a255af2899d5b8f0391c18b9912a5994354f7a65c3d1439809ab4ecded309de0654d7dc3fac8d10bd17140d642d0c","href":"https://static.observableusercontent.com/files/2aa607f0a34ff42eed6860893616da5b8d2a255af2899d5b8f0391c18b9912a5994354f7a65c3d1439809ab4ecded309de0654d7dc3fac8d10bd17140d642d0c","name":"ERC20.bin","type":"application/octet-stream","lastModified":1665469487424.715,"size":7322}] 2f:{"title":"FVM Actor Code Playground - ERC20 Sans Events (Experiments)","cells":[{"id":0,"value":"# FVM Actor Code Playground - ERC20 Sans Events (Experiments)","pinned":false,"hidden":false,"mode":"md"},{"id":1885,"value":"**Work-In-Progress! Doesn't work completely yet!**","pinned":false,"hidden":false,"mode":"md"},{"id":154,"value":"$31","pinned":false,"hidden":false,"mode":"md"},{"id":1611,"value":"After you try this demo out, try out the version that runs on the live Wallaby testnet!\n\n* [ERC20 Sans Events - Wallaby Testnet](https://observablehq.com/@jimpick/fvm-actor-code-playground-erc20-sans-events-wallaby-testne?collection=@jimpick/filecoin-virtual-machine)","pinned":false,"hidden":false,"mode":"md"},{"id":1607,"value":"## Video Demo","pinned":false,"hidden":false,"mode":"md"},{"id":1609,"value":"* YouTube: [FVM ERC20 Demo](https://www.youtube.com/watch?v=VXZL5r8rIz8)","pinned":false,"hidden":false,"mode":"md"},{"id":1092,"value":"## Generate Client Side Addresses","pinned":false,"hidden":false,"mode":"md"},{"id":1094,"value":"We use `ethers.js` to generate a wallet with a random mnemomic phrase. You could save this phrase and re-use it to generate the secrets. In this notebook, we just use different secrets on each page reload.","pinned":false,"hidden":false,"mode":"md"},{"id":1096,"value":"randomMnemonic = {\n return \"cycle raccoon pool vintage unusual note twelve morning program glare salon survey\"\n // return wallet.mnemonic.phrase\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1621,"value":"---","pinned":false,"hidden":false,"mode":"md"},{"id":1775,"value":"wallet = ethers.Wallet.createRandom()","pinned":true,"hidden":false,"mode":"ojs"},{"id":1106,"value":"keys = {\n const keys = []\n const names = [ 'Owner', 'Alice', 'Bob', 'Carol' ]\n for (let i = 0; i < names.length; i++) {\n const network = 'testnet'\n\n const key = await ethers.Wallet.fromMnemonic(randomMnemonic, `m/44'/60'/0'/0/${i}`)\n \n key.name = names[i]\n key.f1Address = filecoinAddress.newSecp256k1Address(buffer.Buffer.from(key.publicKey.slice(2), 'hex')).toString()\n key.privateKeyBase64 = buffer.Buffer.from(key.privateKey.slice(2), 'hex').toString('base64')\n // key.privateKeyLotusExport = buffer.Buffer.from(`{\"Type\":\"secp256k1\",\"PrivateKey\":\"${key.privateKeyBase64}\"}`).toString('hex')\n key.privateKeyLotusExport = buffer.Buffer.from(`{\"Type\":\"secp256k1\",\"PrivateKey\":\"${key.privateKeyBase64}\"}`).toString('hex')\n keys.push(key)\n }\n return keys\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1109,"value":"clientAddresses = keys.map(key => key.f1Address)","pinned":false,"hidden":false,"mode":"ojs"},{"id":1618,"value":"ownerKey = keys.find(({ name }) => name === 'Owner')","pinned":false,"hidden":false,"mode":"ojs"},{"id":1894,"value":"html`Lotus Owner Private Key Export:\\n

${ownerKey.privateKeyLotusExport}

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":1112,"value":"## Wait for Lotus to be ready, then transfer 1 FIL to each address","pinned":false,"hidden":false,"mode":"md"},{"id":1114,"value":"Be patient as it takes a little while for the funds to be sent via the Lotus JSON-RPC API when the notebook is first loaded.","pinned":false,"hidden":false,"mode":"md"},{"id":1116,"value":"{\n if (transferFundsStatus === undefined || !transferFundsStatus) {\n yield md``\n return\n }\n if (transferFundsStatus.transferring || transferFundsStatus.waiting) {\n while (true) {\n const elapsed = (Date.now() - transferFundsStatus.start) / 1000\n yield md`Transferring initial funds to client accounts... (${elapsed.toFixed(1)}s)`\n await Promises.delay(1000)\n }\n }\n if (transferFundsStatus.transferred) {\n yield md`**Funds transferred**!`\n }\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1625,"value":"---","pinned":false,"hidden":false,"mode":"md"},{"id":1118,"value":"transferFundsStatus = {\n if (walletDefaultAddress && keys) {\n const start = Date.now()\n yield {\n transferring: true,\n start\n }\n const responses = []\n for (const key of keys) {\n // Sending install actor message...\n const messageBody = {\n To: key.f1Address,\n From: walletDefaultAddress,\n Value: \"1000000000000000000\",\n Method: 0\n }\n responses.push(await client.mpoolPushMessage(messageBody, null))\n }\n const waitStart = Date.now()\n yield { waiting: true, start, waitStart, responses }\n const promises = []\n for (const response of responses) {\n promises.push(client.stateWaitMsg(response.CID, 0))\n }\n const waitResponses = await Promise.all(promises)\n const lookups = {\n [walletDefaultAddress]: 't0100'\n }\n for (const key of keys) {\n lookups[key.f1Address] = await client.stateLookupID(key.f1Address, [])\n }\n yield { transferred: true, responses, waitResponses, lookups }\n }\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1122,"value":"## Initial Balances","pinned":false,"hidden":false,"mode":"md"},{"id":1124,"value":"Here are the addresses and IDs of the 4 clients we created, as well at their initial balances (should be 1 FIL each).","pinned":false,"hidden":false,"mode":"md"},{"id":1130,"value":"Inputs.table(\n initialBalances ? initialBalances.map(({ address, balance }) => ({\n name: keys.find(({ f1Address }) => f1Address === address).name, \n id: transferFundsStatus.lookups[address],\n ethAddress: keys.find(({ f1Address }) => f1Address == address).address,\n f1Address: address,\n balance\n })) : [],\n {\n width: {\n name: 60,\n id: 60,\n ethAddress: 340,\n f1Address: 300,\n balance: 100\n },\n format: {\n balance: num => new FilecoinNumber(num, 'attofil').toFil()\n }\n }\n)","pinned":false,"hidden":false,"mode":"ojs"},{"id":1628,"value":"---","pinned":false,"hidden":false,"mode":"md"},{"id":1126,"value":"initialBalances = !transferFundsStatus ? md`Waiting...` : transferFundsStatus.transferred && getBalances(clientAddresses)","pinned":false,"hidden":false,"mode":"ojs"},{"id":1128,"value":"async function getBalances (addresses) {\n return Promise.all(\n addresses\n .map(async address => {\n const response = await client.stateGetActor(address, [])\n return {\n address: address,\n balance: response.Balance\n }\n })\n )\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":243,"value":"## Step 1: Define deployment parameters for your token","pinned":false,"hidden":false,"mode":"md"},{"id":1409,"value":"viewof constructorParamsForm = Inputs.form([\n Inputs.text({label: \"Name for your token\", value: \"littlecoin\"}),\n Inputs.text({label: \"Symbol for your token\", value: \"LIT\"}),\n Inputs.number({label: \"Initial supply\", value: 1000000 })\n])","pinned":false,"hidden":false,"mode":"ojs"},{"id":1418,"value":"The \"address\" will be set to `t0100`, which is the genesis actor for the localnet (same as the default Lotus wallet address which we are using for the API calls).","pinned":false,"hidden":false,"mode":"md"},{"id":1456,"value":"The code below uses the [`.encodeDeploy()`](https://docs.ethers.io/v5/api/utils/abi/interface/#Interface--encoding) method from ethers.js to encode the constructor parameters which are appended to the contract binary.","pinned":false,"hidden":false,"mode":"md"},{"id":1488,"value":"evmBytes ? html`Optional: ${button(evmBytes, constructorParamsForm[0] + '.bin')}` : md``","pinned":false,"hidden":false,"mode":"ojs"},{"id":1637,"value":"---","pinned":false,"hidden":false,"mode":"md"},{"id":794,"value":"contractBytes = {\n // Using prebuilt example from https://github.com/filecoin-project/fvm-example-actors/tree/main/erc20-sans-events/bin\n const buf = new Uint8Array(await FileAttachment(\"ERC20.bin\").arrayBuffer())\n const bytes = buffer.Buffer.from(buf)\n return bytes.subarray(0, bytes.length - 256) // Remove initcode\n\n /*\n const buf = await (await fetch('https://raw.githubusercontent.com/jimpick/fvm-example-actors/jim-erc20/erc20-sans-events/output/ERC20PresetFixedSupply.bin')).arrayBuffer()\n return buffer.Buffer.from(buf, 'hex')\n */\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1339,"value":"abi = (await fetch('https://raw.githubusercontent.com/jimpick/fvm-example-actors/jim-erc20/erc20-sans-events/output/ERC20PresetFixedSupply.abi')).json()","pinned":false,"hidden":false,"mode":"ojs"},{"id":1343,"value":"iface = new ethers.utils.Interface(abi)","pinned":false,"hidden":false,"mode":"ojs"},{"id":1347,"value":"deployBytes = buffer.Buffer.from(\n iface.encodeDeploy(\n [ \n constructorParamsForm[0], // name - string\n constructorParamsForm[1], // symbol - string\n constructorParamsForm[2], // initialSupply - uint256\n \"0x\" + getEvmAddress(\"t0100\").slice(24), // owner - address (genesis miner)\n ]\n ).slice(2), 'hex'\n)","pinned":false,"hidden":false,"mode":"ojs"},{"id":1379,"value":"evmBytes = buffer.Buffer.concat([contractBytes, deployBytes])","pinned":false,"hidden":false,"mode":"ojs"},{"id":216,"value":"## Step 2: Connect to Hosted \"localnet\"\n\nThis notebook connects to a [hosted instance](https://github.com/jimpick/lotus-fvm-localnet-web) of a Lotus \"localnet\" (started on demand) into which you can install the actor code, create an actor instance, and invoke methods against.\n\nIf the localnet is started and online, the following chain height should be increasing every 4-10 seconds (depending on system load):","pinned":false,"hidden":false,"mode":"md"},{"id":251,"value":"md`**Height: ${currentHeight}**`","pinned":false,"hidden":false,"mode":"ojs"},{"id":255,"value":"If the connection is working, then proceed to the next step.","pinned":false,"hidden":false,"mode":"md"},{"id":234,"value":"## Step 3: Create an EVM actor instance","pinned":false,"hidden":false,"mode":"md"},{"id":655,"value":"Now we can create an actor instance from the compiled EVM smart contract. It is possible to create lots and lots of actors using the same code, each will get assigned a unique \"ID Address\" (eg. t01001) to which messages and funds can be sent, as well as an equivalent \"Robust Address\" alias (eg. \"t2...\") which maps on the same address (but doesn't change in the event of a chain re-organization).","pinned":false,"hidden":false,"mode":"md"},{"id":492,"value":"At the command line, this is the same as: `lotus chain create-evm-actor `","pinned":false,"hidden":false,"mode":"md"},{"id":184,"value":"viewof createActorButton = Inputs.button(\n 'Create EVM Actor',\n {\n disabled: !ready\n }\n)","pinned":false,"hidden":false,"mode":"ojs"},{"id":548,"value":"$32","pinned":false,"hidden":false,"mode":"ojs"},{"id":1639,"value":"---","pinned":false,"hidden":false,"mode":"md"},{"id":832,"value":"evmActorCidBytes = buffer.Buffer.from('0155a0e40220e8554b9d0640ab07aa048636f9dc2203e7781987f7d7d4915fdadf8720316c30', 'hex')","pinned":false,"hidden":false,"mode":"ojs"},{"id":836,"value":"evmActorCid = multiformats.CID.decode(evmActorCidBytes)","pinned":false,"hidden":false,"mode":"ojs"},{"id":838,"value":"evmBytesCbor = cbor.encode([evmBytes, new Uint8Array(0)])","pinned":false,"hidden":false,"mode":"ojs"},{"id":1705,"value":"provider = new ethers.providers.JsonRpcProvider(`${baseUrl}/rpc/v0?token=${token}`)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1641,"value":"deployer = new ethers.Wallet(ownerKey.privateKey, provider)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1828,"value":"deployer.address","pinned":true,"hidden":false,"mode":"ojs"},{"id":1830,"value":"deployer.privateKey","pinned":true,"hidden":false,"mode":"ojs"},{"id":1698,"value":"factory = new ethers.ContractFactory(iface, contractBytes, deployer)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1687,"value":"nonce = client.mpoolGetNonce(ownerKey.f1Address)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1900,"value":"viewof devCreateActorButton = Inputs.button(\n 'Create EVM Actor (Dev)',\n {\n disabled: !ready,\n value: null,\n reduce: () => client.mpoolGetNonce(ownerKey.f1Address)\n }\n)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1905,"value":"devCreateActorButton","pinned":true,"hidden":false,"mode":"ojs"},{"id":1645,"value":"priorityFee = client.callEthMethod('maxPriorityFeePerGas')","pinned":true,"hidden":false,"mode":"ojs"},{"id":1817,"value":"unsignedTx = devCreateActorButton && factory.getDeployTransaction(\n constructorParamsForm[0], // name - string\n constructorParamsForm[1], // symbol - string\n constructorParamsForm[2], // initialSupply - uint256\n deployer.address,\n {\n gasLimit: 1000000000,\n gasPrice: undefined,\n maxFeePerGas: undefined,\n maxPriorityFeePerGas: priorityFee,\n value: undefined,\n nonce: devCreateActorButton\n }\n)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1826,"value":"populatedTx = {\n if (!unsignedTx) return\n const tx = {...unsignedTx}\n console.log('Transaction', tx)\n //return deployer.sendTransaction(tx)\n return deployer.populateTransaction(tx)\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":1928,"value":"signedTx = deployer.signTransaction(populatedTx)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1942,"value":"provider.formatter.transaction(signedTx)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1931,"value":"// deployer.sendTransaction(populatedTx)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1949,"value":"deployTransaction = client.callEthMethod('sendRawTransaction', [signedTx])","pinned":true,"hidden":false,"mode":"ojs"},{"id":1952,"value":"deployTransactionResults = client.callEthMethod('getTransactionReceipt', [deployTransaction])","pinned":true,"hidden":false,"mode":"ojs"},{"id":1700,"value":"/* contract = await factory.deploy(\n constructorParamsForm[0], // name - string\n constructorParamsForm[1], // symbol - string\n constructorParamsForm[2], // initialSupply - uint256\n deployer.address\n)\n*/","pinned":true,"hidden":false,"mode":"ojs"},{"id":1661,"value":"client.chainHead()","pinned":true,"hidden":false,"mode":"ojs"},{"id":1803,"value":"chainId = client.callEthMethod('chainId')","pinned":true,"hidden":false,"mode":"ojs"},{"id":1694,"value":"createActorStatus = {\n return\n if (createActorButton) {\n console.log('Create actor')\n const start = Date.now()\n yield {\n creating: true,\n start\n }\n // Needs a zero byte in front\n const evmActorCidBytes = new Uint8Array(evmActorCid.bytes.length + 1)\n evmActorCidBytes.set(evmActorCid.bytes, 1)\n const params = cbor.encode([new cbor.Tagged(42, evmActorCidBytes), evmBytesCbor])\n // Sending create actor message...\n const messageBody = {\n To: 't01',\n From: walletDefaultAddress,\n Value: \"0\",\n Method: 2,\n Params: params.toString('base64')\n }\n console.log('messageBody', messageBody)\n const response = await client.mpoolPushMessage(messageBody, null)\n const waitStart = Date.now()\n yield { waiting: true, waitStart, response }\n const waitResponse = await client.stateWaitMsg(response.CID, 0)\n yield { installed: true, response, waitResponse }\n }\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":485,"value":"createActorStatus2 = {\n return\n if (createActorButton) {\n console.log('Create actor')\n const start = Date.now()\n yield {\n creating: true,\n start\n }\n // Needs a zero byte in front\n const evmActorCidBytes = new Uint8Array(evmActorCid.bytes.length + 1)\n evmActorCidBytes.set(evmActorCid.bytes, 1)\n const params = cbor.encode([new cbor.Tagged(42, evmActorCidBytes), evmBytesCbor])\n // Sending create actor message...\n const messageBody = {\n To: 't01',\n From: walletDefaultAddress,\n Value: \"0\",\n Method: 2,\n Params: params.toString('base64')\n }\n console.log('messageBody', messageBody)\n const response = await client.mpoolPushMessage(messageBody, null)\n const waitStart = Date.now()\n yield { waiting: true, waitStart, response }\n const waitResponse = await client.stateWaitMsg(response.CID, 0)\n yield { installed: true, response, waitResponse }\n }\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1157,"value":"**Signatures:**\n\n```\n${await (await fetch('https://raw.githubusercontent.com/jimpick/fvm-example-actors/jim-erc20/erc20-sans-events/output/ERC20Burnable.signatures')).text()}\n```","pinned":false,"hidden":false,"mode":"md"},{"id":238,"value":"## Step 4: Invoke a method to get the ERC20 token balance for the owner address (t0100)","pinned":false,"hidden":false,"mode":"md"},{"id":666,"value":"Now that we've got an actor running with an ID Address, we can call the methods we have defined. Let's check the balance of the addresses. The method signature (from above) to get the balance is => `70a08231: balanceOf(address)`","pinned":false,"hidden":false,"mode":"md"},{"id":866,"value":"md`From the Lotus command line, we could call the method like this:\n\n\\`./lotus chain invoke-evm-actor ${createActorStatus.waitResponse.ReturnDec.IDAddress} 70a08231 ${getEvmAddress('t0100')}\\``","pinned":false,"hidden":false,"mode":"ojs"},{"id":187,"value":"viewof invokeEvmMethodButton = Inputs.button('Get ERC20 Token Balance for Owner (t0100)', {\n disabled: !createActorStatus ||\n !createActorStatus.waitResponse ||\n !createActorStatus.waitResponse.ReturnDec ||\n !createActorStatus.waitResponse.ReturnDec.IDAddress,\n value: null,\n reduce: () => createActorStatus.waitResponse.ReturnDec.IDAddress\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":678,"value":"$33","pinned":false,"hidden":false,"mode":"ojs"},{"id":572,"value":"invokeEvmMethodStatus = {\n if (invokeEvmMethodButton) {\n const start = Date.now()\n yield {\n invoking: true,\n start\n }\n const params = buffer.Buffer.concat([\n buffer.Buffer.from('70a08231', 'hex'),\n buffer.Buffer.from(getEvmAddress('t0100'), 'hex')]\n )\n const messageBody = {\n To: invokeEvmMethodButton,\n From: walletDefaultAddress,\n Value: \"0\",\n Method: 2,\n Params: params.toString('base64')\n }\n console.log('messageBody', messageBody)\n const response = await client.mpoolPushMessage(messageBody, null)\n const waitStart = Date.now()\n yield { waiting: true, waitStart, response }\n const waitResponse = await client.stateWaitMsg(response.CID, 0)\n let decodedResult\n if (waitResponse.Receipt && waitResponse.Receipt.Return) {\n decodedResult = buffer.Buffer.from(waitResponse.Receipt.Return, 'base64')\n }\n yield { invoked: true, response, waitResponse, decodedResult }\n }\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1254,"value":"## Step 5: Invoke a method to transfer ERC20 tokens from the owner address (t0100) to a user address","pinned":false,"hidden":false,"mode":"md"},{"id":1276,"value":"The method signature is => `a9059cbb: transfer(address,uint256)`","pinned":false,"hidden":false,"mode":"md"},{"id":1259,"value":"viewof transferFromOwnerForm = keys && transferFundsStatus && Inputs.form([\n Inputs.select(keys, { label: \"Transfer from Owner to User\", format: x => `${x.name} (${transferFundsStatus.lookups[x.address]})` }),\n Inputs.range([1, 1000000], {value: 1, step: 1, label: 'ERC20 Tokens to Transfer'})\n])","pinned":false,"hidden":false,"mode":"ojs"},{"id":1273,"value":"{\n const dest = getEvmAddress(transferFundsStatus.lookups[transferFromOwnerForm[0].address])\n const amount = transferFromOwnerForm[1].toString(16).padStart(64, '0')\n return html`From the Lotus command line, we could call the method like this:\n\n

\n./lotus chain invoke-evm-actor ${createActorStatus.waitResponse.ReturnDec.IDAddress} a9059cbb ${dest}${amount}\n

\n`\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1522,"value":"viewof transferFromOwnerButton = Inputs.button('Transfer From Owner (t0100)', {\n disabled: !createActorStatus ||\n !createActorStatus.waitResponse ||\n !createActorStatus.waitResponse.ReturnDec ||\n !createActorStatus.waitResponse.ReturnDec.IDAddress,\n value: null,\n reduce: () => ({\n actorId: createActorStatus.waitResponse.ReturnDec.IDAddress,\n dest: transferFromOwnerForm[0],\n amount: transferFromOwnerForm[1]\n })\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":1530,"value":"$34","pinned":false,"hidden":false,"mode":"ojs"},{"id":1520,"value":"$35","pinned":false,"hidden":false,"mode":"ojs"},{"id":1496,"value":"## Step 6: Retrieve the ERC20 token balances for all the addresses","pinned":false,"hidden":false,"mode":"md"},{"id":1600,"value":"This is the same as Step 4, where we got the token balance for a single account. But here we retrieve all the account token balances in parallel to make it easier to observe what's going on.","pinned":false,"hidden":false,"mode":"md"},{"id":1499,"value":"{\n if (tokenBalancesStatus?.retrieving || tokenBalancesStatus?.waiting) {\n return md`Retrieving balances...`\n } else {\n return Inputs.table(\n tokenBalancesStatus?.retrieved ? tokenBalancesStatus.balances.map((balance, i) => {\n return {\n name: tokenBalancesStatus.allKeys[i].name,\n id: transferFundsStatus.lookups[tokenBalancesStatus.allKeys[i].address], \n balance\n }\n }) : [],\n {\n format: {\n }\n }\n )\n }\n}","pinned":false,"hidden":false,"mode":"ojs"},{"id":1554,"value":"Inputs.button(\"Update\", { value: null, reduce: () => { mutable invalidatedBalancesAt = new Date() } })","pinned":false,"hidden":false,"mode":"ojs"},{"id":1317,"value":"$36","pinned":false,"hidden":false,"mode":"ojs"},{"id":1556,"value":"mutable invalidatedBalancesAt = new Date()","pinned":false,"hidden":false,"mode":"ojs"},{"id":1564,"value":"## Step 7: Transfer ERC20 tokens from user to user","pinned":false,"hidden":false,"mode":"md"},{"id":1566,"value":"This is almost the same as Step 5, where we transferred from the owner (the genesis address on the Lotus node). But this time we will use secrets on the client side (in the browser) and sign the message from a non-owner address.","pinned":false,"hidden":false,"mode":"md"},{"id":1568,"value":"viewof transferFromUserForm = keys && transferFundsStatus && Inputs.form([\n Inputs.select(keys, { label: \"Transfer from User\", format: x => `${x.name} (${transferFundsStatus.lookups[x.address]})` }),\n Inputs.select(keys, {\n label: \"Transfer to User\",\n format: x => `${x.name} (${transferFundsStatus.lookups[x.address]})`,\n value: keys[1]\n }),\n Inputs.range([1, 1000000], {value: 1, step: 1, label: 'ERC20 Tokens to Transfer'})\n])","pinned":false,"hidden":false,"mode":"ojs"},{"id":1572,"value":"viewof transferFromUserButton = Inputs.button('Transfer From User to User', {\n disabled: !createActorStatus ||\n !createActorStatus.waitResponse ||\n !createActorStatus.waitResponse.ReturnDec ||\n !createActorStatus.waitResponse.ReturnDec.IDAddress ||\n transferFromUserForm[0] === transferFromUserForm[1],\n value: null,\n reduce: () => ({\n actorId: createActorStatus.waitResponse.ReturnDec.IDAddress,\n source: transferFromUserForm[0],\n dest: transferFromUserForm[1],\n amount: transferFromUserForm[2]\n })\n})","pinned":false,"hidden":false,"mode":"ojs"},{"id":1588,"value":"$37","pinned":false,"hidden":false,"mode":"ojs"},{"id":1578,"value":"$38","pinned":false,"hidden":false,"mode":"ojs"},{"id":693,"value":"# Final notes","pinned":false,"hidden":false,"mode":"md"},{"id":695,"value":"Thank you for trying out this demo.\n\nIf the backend is not working, please get in touch with me. Feel free to fork this notebook to customize your own actors and build scenarios using the on-demand localnet that supports this early version of actors / smart contracts.\n\nI can also deploy custom instances of the localnet and the API for compiling actors ... feel free to contact me at @jimpick on the Filecoin Slack.","pinned":false,"hidden":false,"mode":"md"},{"id":150,"value":"## Imports","pinned":false,"hidden":false,"mode":"md"},{"id":50,"value":"skypack = (library) => import(`https://cdn.skypack.dev/${library}?min`)","pinned":true,"hidden":false,"mode":"ojs"},{"id":198,"value":"LotusRPC = (await import('@filecoin-shipyard/lotus-client-rpc')).LotusRPC","pinned":true,"hidden":false,"mode":"ojs"},{"id":205,"value":"BrowserProvider = (await import('@filecoin-shipyard/lotus-client-provider-browser')).BrowserProvider","pinned":true,"hidden":false,"mode":"ojs"},{"id":211,"value":"schema = (await import('@filecoin-shipyard/lotus-client-schema')).mainnet.fullNode","pinned":true,"hidden":false,"mode":"ojs"},{"id":1675,"value":"client","pinned":true,"hidden":false,"mode":"ojs"},{"id":402,"value":"stripAnsi = (await import('https://unpkg.com/strip-ansi@7.0.1/index.js?module')).default","pinned":true,"hidden":false,"mode":"ojs"},{"id":501,"value":"cbor = import('https://cdn.skypack.dev/borc')","pinned":true,"hidden":false,"mode":"ojs"},{"id":727,"value":"multiformats = import('https://cdn.skypack.dev/pin/multiformats@v9.6.5-93rn6JH3zqEZdoz77NBu/mode=imports,min/optimized/multiformats.js')","pinned":true,"hidden":false,"mode":"ojs"},{"id":584,"value":"import {button} from '@jimpick/download-data-button-with-wasm-support'","pinned":true,"hidden":false,"mode":"ojs"},{"id":821,"value":"buffer = require('https://bundle.run/buffer@6.0.3')","pinned":true,"hidden":false,"mode":"ojs"},{"id":1098,"value":"filecoinJsSigner = import('https://jspm.dev/@blitslabs/filecoin-js-signer')","pinned":true,"hidden":false,"mode":"ojs"},{"id":1649,"value":"filecoinJs = (await import('https://jspm.dev/filecoin.js')).default","pinned":true,"hidden":false,"mode":"ojs"},{"id":1100,"value":"FilecoinClient = filecoinJsSigner.FilecoinClient","pinned":true,"hidden":false,"mode":"ojs"},{"id":1102,"value":"FilecoinSigner = filecoinJsSigner.FilecoinSigner","pinned":true,"hidden":false,"mode":"ojs"},{"id":1104,"value":"filecoin_signer = new FilecoinSigner()","pinned":true,"hidden":false,"mode":"ojs"},{"id":1135,"value":"filecoinNumber = import('https://cdn.skypack.dev/pin/@glif/filecoin-number@v2.0.0-beta.0-iQnBkhznGjB3HsyiyYB8/mode=imports,min/optimized/@glif/filecoin-number.js')","pinned":true,"hidden":false,"mode":"ojs"},{"id":1137,"value":"FilecoinNumber = filecoinNumber.FilecoinNumber","pinned":true,"hidden":false,"mode":"ojs"},{"id":1336,"value":"ethers = import('https://cdn.skypack.dev/ethers@5.7.1?min')","pinned":true,"hidden":false,"mode":"ojs"},{"id":1744,"value":"filecoinAddress = import('https://cdn.skypack.dev/@glif/filecoin-address')","pinned":true,"hidden":false,"mode":"ojs"},{"id":270,"value":"## Lotus Utilities","pinned":false,"hidden":false,"mode":"md"},{"id":743,"value":"simpleCoinSol = `\n// SPDX-License-Identifier: MIT\npragma solidity >=0.4.25 <= 0.8.17;\n\ncontract SimpleCoin {\n mapping (address => uint) balances;\n\n event Transfer(address indexed _from, address indexed _to, uint256 _value);\n\n constructor() {\n balances[tx.origin] = 10000;\n }\n\n function sendCoin(address receiver, uint amount) public returns(bool sufficient) {\n if (balances[msg.sender] < amount) return false;\n balances[msg.sender] -= amount;\n balances[receiver] += amount;\n emit Transfer(msg.sender, receiver, amount);\n return true;\n }\n\n function getBalanceInEth(address addr) public view returns(uint){\n return getBalance(addr) * 2;\n }\n\n function getBalance(address addr) public view returns(uint) {\n return balances[addr];\n }\n}\n`.trim()","pinned":true,"hidden":false,"mode":"ojs"},{"id":171,"value":"initialCodeUrl = `https://raw.githubusercontent.com/raulk/fil-hello-world-actor/695eed038c48bfff97c29fdc25d00aa7363ee47d/src/lib.rs`","pinned":false,"hidden":false,"mode":"ojs"},{"id":373,"value":"baseUrl = \"https://fvm-7.default.knative.hex.camp\"","pinned":false,"hidden":false,"mode":"ojs"},{"id":355,"value":"token = (await fetch(`${baseUrl}/public/token`)).text()","pinned":false,"hidden":false,"mode":"ojs"},{"id":209,"value":"client = {\n const provider = new BrowserProvider(`${baseUrl}/rpc/v0`, { token })\n LotusRPC.prototype.callEthMethod = async function (method, args) {\n await this.provider.connect()\n const request = {\n method: `eth_${method}`\n }\n request.params = args\n return this.provider.send(request, {})\n }\n return new LotusRPC(provider, { schema })\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":1582,"value":"filecoin_client = new FilecoinClient(`${baseUrl}/rpc/v0`, token)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1647,"value":"lotusApiClient = {\n const connector = new filecoinJs.HttpJsonRpcConnector({ url: baseUrl, token })\n return new filecoinJs.LotusClient(connector)\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":303,"value":"async function *heightStream () {\n let last\n while (true) {\n try {\n const newHeight = (await client.chainHead()).Height\n if (newHeight !== last) {\n yield newHeight\n last = newHeight\n }\n } catch (e) {\n yield 0\n }\n await Promises.delay(4000)\n }\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":328,"value":"mutable ready = false","pinned":true,"hidden":false,"mode":"ojs"},{"id":312,"value":"async function *heightReadyTapStream () {\n let lastReady = false\n for await (const height of heightStream()) {\n const newReady = height > 7\n if (newReady !== lastReady) {\n mutable ready = newReady\n lastReady = newReady\n }\n yield height\n }\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":308,"value":"currentHeight = heightReadyTapStream()","pinned":true,"hidden":false,"mode":"ojs"},{"id":353,"value":"walletDefaultAddress = ready && client.walletDefaultAddress()","pinned":true,"hidden":false,"mode":"ojs"},{"id":1165,"value":"function getEvmAddress (address) {\n return '000000000000000000000000ff' + Number(address.slice(1)).toString(16).padStart(38, '0')\n}","pinned":true,"hidden":false,"mode":"ojs"}],"files":"$W39","stdlib":"1","titling":"auto"}