자바스크립트 API 라이브러리

1// BrowserProvider는 표준 Web3 공급자를 래핑하며,
2// 이는 MetaMask가 각 페이지에 window.ethereum으로 주입하는 것입니다
3const provider = new ethers.BrowserProvider(window.ethereum)
4
5// MetaMask 플러그인을 사용하면 트랜잭션에 서명하여
6// 이더를 전송하고 블록체인 내 상태를 변경하기 위해 지불할 수 있습니다.
7// 이를 위해 계정 서명자가 필요합니다...
8const signer = provider.getSigner()
복사

1var web3 = new Web3("http://localhost:8545")
2// 또는
3var web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"))
4
5// 공급자 변경
6web3.setProvider("ws://localhost:8546")
7// 또는
8web3.setProvider(new Web3.providers.WebsocketProvider("ws://localhost:8546"))
9
10// node.js에서 IPC 공급자 사용
11var net = require("net")
12var web3 = new Web3("/Users/myuser/Library/Ethereum/geth.ipc", net) // mac os 경로
13// 또는
14var web3 = new Web3(
15  new Web3.providers.IpcProvider("/Users/myuser/Library/Ethereum/geth.ipc", net)
16) // mac os 경로
17// windows에서의 경로는 다음과 같습니다: "\\\\.\\pipe\\geth.ipc"
18// linux에서의 경로는 다음과 같습니다: "/users/myuser/.ethereum/geth.ipc"
모두 보기
복사

1// 니모닉으로 지갑 인스턴스를 생성합니다...
2mnemonic =
3  "announce room limb pattern dry unit scale effort smooth jazz weasel alcohol"
4walletMnemonic = Wallet.fromPhrase(mnemonic)
5
6// ...또는 개인 키로 생성합니다
7walletPrivateKey = new Wallet(walletMnemonic.privateKey)
8
9walletMnemonic.address === walletPrivateKey.address
10// 참
11
12// 서명자 API에 따른 Promise로서의 주소
13walletMnemonic.getAddress()
14// { Promise: '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1' }
15
16// 지갑 주소는 동기적으로도 사용할 수 있습니다
17walletMnemonic.address
18// '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1'
19
20// 내부 암호화 구성 요소
21walletMnemonic.privateKey
22// '0x1da6847600b0ee25e9ad9a52abbd786dd2502fa4005dd5af9310b7cc7a3b25db'
23walletMnemonic.publicKey
24// '0x04b9e72dfd423bcf95b3801ac93f4392be5ff22143f9980eb78b3a860c4843bfd04829ae61cdba4b3b1978ac5fc64f5cc2f4350e35a108a9c9a92a81200a60cd64'
25
26// 지갑 니모닉
27walletMnemonic.mnemonic
28// {
29//   locale: 'en',
30//   path: 'm/44\'/60\'/0\'/0/0',
31//   phrase: 'announce room limb pattern dry unit scale effort smooth jazz weasel alcohol'
32// }
33
34// 참고: 개인 키로 생성된 지갑은
35//       니모닉을 가지지 않습니다(파생 과정에서 이를 방지함)
36walletPrivateKey.mnemonic
37// null
38
39// 메시지 서명
40walletMnemonic.signMessage("Hello World")
41// { Promise: '0x14280e5885a19f60e536de50097e96e3738c7acae4e9e62d67272d794b8127d31c03d9cd59781d4ee31fb4e1b893bd9b020ec67dfa65cfb51e2bdadbb1de26d91c' }
42
43tx = {
44  to: "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
45  value: utils.parseEther("1.0"),
46}
47
48// 트랜잭션 서명
49walletMnemonic.signTransaction(tx)
50// { Promise: '0xf865808080948ba1f109551bd432803012645ac136ddd64dba72880de0b6b3a7640000801ca0918e294306d177ab7bd664f5e141436563854ebe0a3e523b9690b4922bbb52b8a01181612cec9c431c4257a79b8c9f0c980a2c49bb5a0e6ac52949163eeb565dfc' }
51
52// connect 메서드는 공급자에 연결된
53// 지갑의 새 인스턴스를 반환합니다
54wallet = walletMnemonic.connect(provider)
55
56// 네트워크 쿼리
57wallet.getBalance()
58// { Promise: { BigNumber: "42" } }
59wallet.getTransactionCount()
60// { Promise: 0 }
61
62// 이더 전송
63wallet.sendTransaction(tx)
모두 보기
복사

1contract Test {
2    uint a;
3    address d = 0x12345678901234567890123456789012;
4
5    constructor(uint testInt)  { a = testInt;}
6
7    event Event(uint indexed b, bytes32 c);
8
9    event Event2(uint indexed b, bytes32 c);
10
11    function foo(uint b, bytes32 c) returns(address) {
12        Event(b, c);
13        return d;
14    }
15}
모두 보기
복사

1[{
2    "type":"constructor",
3    "payable":false,
4    "stateMutability":"nonpayable"
5    "inputs":[{"name":"testInt","type":"uint256"}],
6  },{
7    "type":"function",
8    "name":"foo",
9    "constant":false,
10    "payable":false,
11    "stateMutability":"nonpayable",
12    "inputs":[{"name":"b","type":"uint256"}, {"name":"c","type":"bytes32"}],
13    "outputs":[{"name":"","type":"address"}]
14  },{
15    "type":"event",
16    "name":"Event",
17    "inputs":[{"indexed":true,"name":"b","type":"uint256"}, {"indexed":false,"name":"c","type":"bytes32"}],
18    "anonymous":false
19  },{
20    "type":"event",
21    "name":"Event2",
22    "inputs":[{"indexed":true,"name":"b","type":"uint256"},{"indexed":false,"name":"c","type":"bytes32"}],
23    "anonymous":false
24}]
모두 보기
복사

1// 계정의 잔액을 가져옵니다(주소 또는 ENS 이름으로)
2balance = await provider.getBalance("ethers.eth")
3// { BigNumber: "2337132817842795605" }
4
5// 종종 사용자에게 보여주기 위해 출력을 포맷해야 합니다
6// 사용자는 wei 대신 이더 단위의 값을 선호합니다
7ethers.utils.formatEther(balance)
8// '2.337132817842795605'
복사