README_EN.md

MathWalletSDK-iOS

iOS SDK based on SimpleWallet protocol

Supports public chains : Ethereum, BSC, HECO，OKExchain etc.

How to use？

1、Deploy URL Schemes

Xcode Project info.plist-> URL types -> URL Schemes

2、Register URL Schemes and set URL

import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    var window: UIWindow?
    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        guard let _ = (scene as? UIWindowScene) else { return }
        
        // MathWalletAPI Register
        MathWalletAPI.default.registerURLSchemes("mathwallet5demos", host: "demos.com")
    }
    ...

    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        guard let context = URLContexts.first else { return }
        MathWalletAPI.default.handleOpenURLContext(context)
    }
}

3、Initialization（Chain、DApp）

    // Chain( Ethereum = 1, BSC = 56, ... )
    let chain = Chain(type: "EVM", id: "1")

    // DApp
    let dapp = DApp(name: "MathWallet5 Demos", icon: "https://staticcdn2.maiziqianbao.net/static/img/project/1.jpg")

4、Login

    let data:[String: Any] = [:]
    let req = MathWalletReq(chain: chain, dapp: dapp, action: .login, data: data)
    MathWalletAPI.default.sendReq(req) { (resp: MathWalletResq) in
        ...
    }

5、Transaction

    let data:[String: Any] = [
        "from":"0x306Bb8081C7dD356eA951795Ce4072e6e4bFdC32",
        "to":"0x306Bb8081C7dD356eA951795Ce4072e6e4bFdC32",
        "value":"0x5af3107a4000",
        "data":"0x"
    ]
    let req = MathWalletReq(chain: chain, dapp: dapp, action: .transaction, data: data)
    MathWalletAPI.default.sendReq(req) { (resp: MathWalletResq) in
        ...
    }

6、Sign Message

    let data:[String: Any] = [
        "address":"0x306Bb8081C7dD356eA951795Ce4072e6e4bFdC32",
        "message":"hello world"
    ]
    let req = MathWalletReq(chain: chain, dapp: dapp, action: .signMessage, data: data)
    MathWalletAPI.default.sendReq(req) { (resp: MathWalletResq) in
        ...
    }

7、Open URL

    let data:[String: Any] = [
        "link":"https://www.mathwallet.org"
    ]
    let req = MathWalletReq(chain: chain, dapp: dapp, action: .openURL, data: data)
    MathWalletAPI.default.sendReq(req) { (resp: MathWalletResq) in
        ...
    }

// Callback

    // Reference URL Scheme
    <a href="mathwallet5demos://demos.com?arg1=hello&arg2=world">Callback</a>