Ethereum Provider

Ethers.js 또는 Web3.js를 Wepin Provider와 함께 사용하면 EVM 계열의 블록체인과 상호작용 할 수 있습니다.

지원 네트워크

목록에 필요한 블록체인이 없나요? 위핀 팀에 요청하여 별도의 비용 없이 블록체인을 추가할 수 있습니다.

Chain ID	Network Name	Network Variable
1	Ethereum Mainnet	ethereum
5	Ethereum Goerli Testnet	evmeth-goerli
8217	Klaytn Mainnet	klaytn
1001	Klaytn Testnet	klaytn-testnet
19	Songbird Canary Network	evmsongbird
137	Polygon Mainnet	evmpolygon
248	Oasys	evmoasys-games
37	XPLA Mainnet	evmxpla
7300	XPLA Verse Mainnet	evmxpla-verse
2731	TimeNetwork Testnet	evmtime-elizabeth
11155111	Ethereum Sepolia Testnet	evmeth-sepolia
80002	Polygon Amoy Testnet	evmpolygon-amoy
9372	Oasys Testnet	evmoasys-games-testnet
47	XPLA Testnet	evmxpla-testnet
2225	XPLA Verse Testnet	evmxpla-verse-testnet
204	opBNB Mainnet	evmopbnb
56	Binance Smart Chain	evmbsc
97	BSC-TESTNET	evmbsc-testnet
5611	opBNB Testnet	evmopbnb-testnet

설치(Install)

npm

npm install @wepin/provider-js

yarn

yarn add @wepin/provider-js

설치가 완료되면 앱 등록 후 할당받은 App ID와 App Key를 사용하여 아래와 같이 WepinProvider 인스턴스를 초기화합니다. 이렇게 하면 WepinProvider 를 사용할 수 있게 됩니다.

// 1. 패키지 import
import { WepinProvider } from '@wepin/provider-js'

// 2. 초기화
const WepinProvider = new WepinProvider({
    appId: 'your-wepin-app-id',
    appKey: 'your-wepin-app-key',
})

초기화하기

Wepin Provider를 초기화하는 방법입니다.

init

await wepinProvider.init(attributes?)

Parameters

• attributes <object> optional

  • defaultLanguage: 위젯 기본 언어 설정, 기본 값은 ko입니다. 현재 지원하는 언어는 en, ko, ja 3가지 입니다.

  • defaultCurrency: T위젯 기본 통화 설정, 기본 값은 KRW입니다. 현재 지원하는 통화는 USD, KRW, JPY 3가지 입니다.

Return value

• Promise<void>

Example

await wepinProvider.init({
    defaultLanguage: 'ko',
    defaultCurrency: 'KRW',
})

isInitialized

WepinProvider 가 정상적으로 초기화 되었는지 확인할 수 있습니다.

wepinProvider.isInitialized()

Parameters

• <void>

Return value

• <boolean> init이 정상적으로 잘 된 경우 true , 실패한 경우 false 를 반환합니다.

Example

if(wepinProvider.isInitialized()) {
  console.log('wepinProvider is initialized!')
}

changeLanguage

위젯의 언어와 통화를 변경할 수 있습니다.

wepinProvider.changeLanguage(attributes)

Parameters

• attributes <object>

  • language <string> 위젯에 표시될 언어를 지정합니다. 현재 지원하는 언어는 en, ko, ja 3가지 입니다.

  • currency <string> 위젯에 표시될 통화를 지정합니다. 현재 지원하는 통화는 USD, KRW , JPY 3가지 입니다.

Return value

• <boolean> init이 정상적으로 잘 된 경우 true , 실패한 경우 false 를 반환합니다.

Example

if(wepinProvider.isInitialized()) {
  console.log('wepinProvider is initialized!')
}

메서드(Method)

Wepin Provider 초기화 후에 메서서드를 사용할 수 있습니다.

getProvider

Network에 해당하는 Provider를 반환합니다.

await wepinProvider.getProvider(network)

Parameters

• network <string> 위핀이 지원하는 Provider의 Network Variable 값으로, Ethereum Mainnet의 경우 "ethereum" 입니다. Network Variable은 소문자로 입력해야 합니다. 전체 목록은 Ethereum Provider 지원 네트워크에서 확인하세요.

Return value

• Promise<BaseProvider> - A EIP-1193 provider

Example

const provider = await wepinProvider.getProvider('ethereum')

finalize

WepinProvider 사용을 종료합니다.

wepinProvider.finalize()

Parameters

• <void>

Return value

• <void>

Example

wepinProvider.finalize()

이더리움 호환 네트워크 프로바이더의 자세한 내용은 아래 링크를 참고하세요.

EIP-1193: Ethereum Provider JavaScript APIEthereum Improvement Proposals