Skip to content

Latest commit

 

History

History
428 lines (313 loc) · 11.6 KB

README.md

File metadata and controls

428 lines (313 loc) · 11.6 KB
Raw

Binance Chain Swift SDK

Version: beta Platforms: ios | macos | watchos | tvos Swift: 5.0 License: MIT

Features

  • Connect to mainnet, testnet, or a custom address
  • HTTP API
  • Wallet
  • WebSockets
  • Broadcast Transactions
  • Node RPC

Requirements

  • iOS 11+ / macOS 10.10+ / tvOS 11+ / watchOS 2+
  • Swift 5
  • Xcode 10.2

Installation

Swift Package Manager

To add BinanceChain to your project, add a dependency:

dependencies: [
    .package(url: "https://github.com/mh7821/SwiftBinanceChain.git", from: "0.0.0")
]

Cocoapods

To integrate BinanceChain into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'BinanceChain', :git => 'https://github.com/mh7821/SwiftBinanceChain.git'

Usage

Asynchronous API calls can be made using BinanceChain. The response objects are strongly typed, see Model for available properties.

import BinanceChain

let binance = BinanceChain()

// Get the latest block time and current time
binance.time() { (response) in
    if let error = response.error { return print(error) }
    print(response.time)
}

// Get node information
binance.nodeInfo() { (response) in
    print(response.nodeInfo)
}

// Get the list of validators used in consensus
binance.validators() { (response) in
    print(response.validators)
}

// Get the list of network peers
binance.peers() { (response) in
    print(response.peers)
}

// Get account metadata for an address
binance.account(address: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr") { (response) in
    print(response.address)
}

// Get an account sequence
binance.sequence(address: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr") { (response) in
    print(response.sequence)
}

// Get a transaction
binance.tx(hash: "5CAA5E0C6266B3BB6D66C00282DFA0A6A2F9F5A705E6D9049F619B63E1BE43FF") { (response) in
    print(response.tx)
}

// Get token list
binance.tokens(limit: .fiveHundred, offset: 0) { (response) in
    print(response.tokens)
}

// Get market pairs
binance.markets(limit: .oneHundred, offset: 0) { (response) in
    print(response.markets)
}

// Obtain trading fees information
binance.fees() { (response) in
    print(response.fees)
}

// Get the order book
binance.marketDepth(symbol: "BNB_BTC.B-918") { (response) in
    print(response.marketDepth)
}

// Get candlestick/kline bars for a symbol
binance.klines(symbol: "BNB_BTC.B-918", interval: .fiveMinutes) { (response) in
    print(response.candlesticks)
}

// Get closed (filled and cancelled) orders for an address
binance.closedOrders(address: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr") { (response) in
    print(response.orderList)
}

// Get open orders for an address
binance.openOrders(address: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr") { (response) in
    print(response.orderList)
}

// Get an order
binance.order(id: hashId) { (response) in
    print(response.order)
}

// Get 24 hour price change statistics for a market pair symbol
binance.ticker(symbol: "BNB_BTC.B-918") { (response) in
    print(response.ticker)
}

// Get a list of historical trades
binance.trades() { (response) in
    print(response.trades)
}

// Get transactions for an address
binance.transactions(address: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr") { (response) in
    print(response.transactions)
}

WebSockets

To get real-time updates, create a WebSocket, register a WebSocketDelegate, connect and subscribe. The delegate will be notified as updates become available.

import BinanceChain

let webSocket = WebSocket()
webSocket.delegate = self
webSocket.connect(endpoint: .testnet) {

    // Individual order updates
    webSocket.subscribe(accounts: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr")

    // Account updates
    webSocket.subscribe(orders: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr")

    // Transfer updates when the address is sender or receiver
    webSocket.subscribe(transfer: "tbnb10a6kkxlf823w9lwr6l9hzw4uyphcw7qzrud5rr")

    // Individual trade updates
    webSocket.subscribe(trades: ["BNB_BTC.B-918"])

    // Order book price and quantity depth updates
    webSocket.subscribe(marketDiff: ["BNB_BTC.B-918"])

    // Top 20 levels of bids and asks
    webSocket.subscribe(marketDepth: ["BNB_BTC.B-918"])

    // The current candlestick at requested interval
    webSocket.subscribe(candlestick: ["BNB_BTC.B-918"], interval: .oneMinute)

    // Ticker statistics for a symbol, sent every second
    webSocket.subscribe(ticker: ["BNB_BTC.B-918"])

    // Ticker statistics for all symbols, sent every second
    webSocket.subscribe(ticker: .all)

    // Reduced ticker statistics for a symbol, sent every second
    webSocket.subscribe(miniTicker: ["BNB_BTC.B-918"])

    // Reduced ticker statistics all symbols, sent every second
    webSocket.subscribe(miniTicker: .all)

    // Latest block height
    webSocket.subscribe(blockheight: .all)

    // Keep a reference in order to unsubscribe
    let subscription = webSocket.subscribe(ticker: all)
    webSocket.unsubscribe(subscription)

}

Wallet

Initialise using a mnemonic phrase, or generate a random new one.

import BinanceChain

// Generate a random wallet
let wallet = Wallet()

// Restore with a mnemonic phrase
let wallet = Wallet(mnemonic: "mnemonic word list")

// Access keys
print(wallet.privateKey)
print(wallet.publicKey)
print(wallet.mnemonic)
print(wallet.account)
print(wallet.address)

// Synchronise with the remote node before using the wallet
wallet.synchronise() { (error) in

    if let error = error { return print(error) }

    // Generate a new order ID
    let id = wallet.nextAvailableOrderId()

    // Sign a message
    let data = wallet.sign(message: data)

    // Access details
    print(wallet.accountNumber)
    print(wallet.sequence)

}

Broadcast Transactions

Sign and broadcast a transaction.

import BinanceChain

let binance = BinanceChain()
let wallet = Wallet()

// Create a new order to buy or sell tokens
let msg = Message.newOrder(symbol: "BNB_BTC.B-918", orderType: .limit, side: .buy, price: 100,
                           quantity: 1, timeInForce: .goodTillExpire, wallet: wallet)

// Cancel an outstanding (unfilled) order
let msg = Message.cancelOrder(symbol: "BNB_BTC.B-918", orderId: "id", wallet: wallet)

// Transfer funds
let msg = Message.transfer(symbol: "BNB_BTC.B-918", amount: 200, to: address, wallet: Wallet)

// Move tokens into a frozen state, meaning they can't be used to transfer or send new orders
let msg = Message.freeze(symbol: "BNB_BTC.B-918", amount: 10, wallet: wallet)

// Revert frozen tokens back to a free state
let msg = Message.unfreeze(symbol: "BNB_BTC.B-18", amount: 10, wallet: wallet)

// Vote for proposals
let msg = Message.vote(proposalId: 1, vote: .yes, wallet: wallet)

// Broadcast the message
binance.broadcast(message: msg, sync: true) { (response) in
    if let error = response.error { return print(error) }
    print(response.broadcast)
}

Node RPC

Interact with a node directly, implemented using JSONRPC/HTTP.

import BinanceChain

// Connect to a specific node
let url = URL("http://localhost:27146")
let noderpc = NodeRPC(url)

// Or, connect to a Binance Chain seed node
let noderpc = NodeRPC()
noderpc.connect(endpoint: .testnet) { (error) in

    // Check that a suitable peer was found
    if let error = error { return print(error) }

    // Get information about the application
    noderpc.abciInfo() { (response) in
        if let error = error { return print(error }
        print(response.result)
    }

    // Get a concise summary of the consensus state
    noderpc.consensusState() { (response) in
        print(response.result)
    }

    // Get complete consensus state
    noderpc.dumpConsensusState() { (response) in
        print(response.result)
    }

    // Gets network information
    noderpc.genesis() { (response) in
        print(response.result)
    }

    // Gets the genesis file
    noderpc.health() { (response) in
        print(response.result)
    }

    // Get node health
    noderpc.netInfo() { (response) in
        print(response.result)
    }

    // Gets number of unconfirmed transactions
    noderpc.numberUnconfirmedTxs(limit: 30) { (response) in
        print(response.result)
    }

    // Get Tendermint status
    noderpc.status() { (response) in
        print(response.result)
    }

    // Query the application
    noderpc.abciQuery(path: .tokensInfo, data: "", prove: true) { (response) in
        print(response.result)
    }

    // Get the block at a given height (pass nil for the latest block)
    noderpc.block(height: 10905636) { (response) in
        print(response.result)
    }

    // Get results for a given height (pass nil for the latest block)
    noderpc.blockResult(height: 10905636) { (response) in
        print(response.result)
    }

    // Get block headers between minHeight and maxHeight
    noderpc.blockchain(minHeight: 0, maxHeight: 0) { (response) in
        print(response.result)
    }

    // Broadcast a transaction asynchronously
    noderpc.broadcastAsync(message: message) { (response) in
        print(response.result)
    }

    // Broadcast a transaction and wait for check and delivery
    noderpc.broadcastCommit(message: message) { (response) in
        print(response.result)
    }

    // Broadcast a transaction and wait for check
    noderpc.broadcastSync(message: message) { (response) in
        print(response.result)
    }

    // Get the commit at a given height (pass nil for the latest block)
    noderpc.commit(height: 10905636) { (response) in
        print(response.result)
    }

    // Query transaction results
    noderpc.tx(hash: "AB1B84C7C0B0B195941DCE9CFE1A54214B72D5DB54AD388D8B146A6B62911E8E", prove: true) {
        (response) in print(response.result)
    }

    // Query for transaction results
    noderpc.txSearch(query: "tx.height=10905636", prove: true, page: 1, perPage: 30) { (response) in
        print(response.result)
    }

    // Get validators for a block (pass nil for the latest block)
    noderpc.validators(height: 10905636) { (response) in
        print(response.result)
    }

}

Changing networks

Switch between mainnet, testnet, or a custom endpoint easily:

let binance = BinanceChain(endpoint: .mainnet)
let websocket = WebSocket(endpoint: .testnet)
let wallet = Wallet(endpoint: "https://dex.binance.org/api/v1")

Sample apps

Sample apps are provided for iOS and macOS. They all use Test.swift which demonstrates features of the library.

The command line app uses Swift Package Manager:

% swift run binancechain [test]

Available tests:

        all: Run everything
        api: HTTP API
  websocket: Websockets
  broadcast: Broadcast Transactions
     wallet: Wallet
    noderpc: NodeRPC

The iOS and macOS apps use Cocoapods and Xcode:

% pod install
% open BinanceChain.xcworkspace

License

SwiftBinanceChain is released under the MIT license. See LICENSE for details.