@wepin/provider-js
v0.0.10
Published
Wepin Widget Javascript SDK for Web
Downloads
370
Readme
@wepin/provider-js
Wepin Provider V1 for Web. This package is exclusively available for use in web environments.
⚠️ Notice:
This package is only available for web environments and cannot be used in Android or iOS hybrid apps (Webview).
If you are using this package in a Server Side Rendering (SSR) environment, make sure to load the package only on the Client Side Rendering (CSR) side.
Please refer to the following code for implementation:
const initWepinProvider = async () => { const { WepinProvider } = await import('@wepin/provider-js'); const wepinProvider = new WepinProvider({ appKey: '', appId: '', }); await wepinProvider.init(); }
⏩ Document
⏩ Get App ID and Key
After signing up for Wepin Workspace, go to the development tools menu and enter the information for each app platform to receive your App ID and App Key.
Wepin supports providers that return JSON-RPC request responses to connect with blockchain networks in webs. With Wepin Provider, you can easily connect to various networks supported by Wepin.
The providers supported by Wepin are as follows.
- EVM compatible Networks
- Klaytn Network
EVM compatible Networks
Ethers.js or Web3.js can be used with Wepin Provider to interoperate with EVM compatible blockchains.
Support Networks
Please refer to the following link for detailed information on the supported network list: wepin provider - supported network list
⏩ Install
npm install @wepin/provider-js
or
yarn add @wepin/provider-js
⏩ Import SDK
import { WepinProvider } from '@wepin/provider-js'
⏩ Initialize
const wepinProvider = new WepinProvider({
appId: 'wepinAppId',
appKey: 'wepinAppKey',
})
init
await wepinProvider.init(attributes?)
Parameters
attributes
<object> optionaldefaultLanguage
: The language to be displayed on the widget (default:'ko'
) Currently, only'ko'
,'en'
and'ja'
are supported.defaultCurrency
: The currency to be displayed on the widget (default:'KRW'
) Currently, only'KRW'
,'USD'
and'JPY'
are supported.
Example
await wepinProvider.init({
defaultLanguage: 'ko',
defaultCurrency: 'KRW',
})
isInitialized
wepinProvider.isInitialized()
The isInitialized()
method checks Wepin Provider is initialized.
Returns
- <boolean>
- true if Wepin Provider is already initialized.
changeLanguage
wepinProvider.changeLanguage(attributes)
Change the language and currency of the widget.
Parameters
attributes
<object>language
<string> - The language to be displayed on the widget. Currently, only'ko'
,'en'
and'ja'
are supported.currency
<string> - The currency to be displayed on the widget. Currently, only'KRW'
,'USD'
and'JPY'
are supported.
Returns
- void
Example
wepinProvider.changeLanguage({
currency: 'KRW',
language: 'ko'
})
⏩ Method
Methods can be used after initialization of Wepin Provider.
getProvider
await wepinProvider.getProvider(network)
It returns a Provider by given network
Parameters
network
<string>- Available chains Wepin helps provide. It should be lowercase.
Returns
- Promise<BaseProvider> - A EIP-1193 provider
Example
const provider = await wepinProvider.getProvider('ethereum')
finalize
await wepinProvider.finalize()
The finalize()
method finalizes the Wepin Provider.
Parameters
- Promise<void>
Returns
- void
Example
await wepinProvider.finalize()