Swift 和iOS

其他 Swift SDK 由上游工作空间发送的是 IrohaSwift Swift 下面的包装 IrohaSwift/. 它的包邮说明书定义了三个图书馆产品IrohaSwift, IrohaSwiftMobileTransports, 和 IrohaSwiftTransferUI并且针对iOS 15+和macOS 12+ Swift 工具 5.9.

包 depends on the native NoritoBridge binary target. 包分辨率在构建之前验证../dist/NoritoBridge.xcframework,当本地符号不加载时,交易或连接加密路径会抛出桥式不可用的错误.

Swift 包装经理

在使用已注入的工作空间时,在本地 IrohaSwift/包目录中点 SwiftPM. Package.swift所使用的包身份是IrohaSwift:

dependencies: [
    .package(name: "IrohaSwift", path: "/path/to/iroha/IrohaSwift")
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "IrohaSwift", package: "IrohaSwift")
        ]
    )
]

调整应用程序的路径.不要复制当前的 examples/ios/ConnectMinimalApp路径,该表格将 ../../IrohaSwift 分解为 examples/IrohaSwift.

在解决包之前,请确保桥梁存在于工作空间根点:

cd /path/to/iroha
make bridge-xcframework

这产生dist/NoritoBridge.xcframework; IrohaSwift/Package.swift将其称为../dist/NoritoBridge.xcframework.

CocoaPods

该代码库还包含 IrohaSwift/IrohaSwift.podspec. 声明: IrohaSwift 子, Swift 5,9和iOS 15. Swift 来自主存储库中的来源;原始桥梁仍然必须存在并用于交易编码,非Ed25519签名和Connect加密.

快速开始

import Foundation
import IrohaSwift

let torii = ToriiClient(baseURL: URL(string: "http://127.0.0.1:8080")!)
let sdk = IrohaSDK(toriiClient: torii)

let keypair = try Keypair.generate()
let accountId = try keypair.accountId()

if #available(iOS 15.0, macOS 12.0, *) {
    let balances = try await torii.getAssets(accountId: accountId)
    print("balances:", balances)
}

试看 Taira 只阅读

开始一个简单的 HTTP 探测器,以确认设备或模拟器可以达到公众的 Taira 终点:

import Foundation

if #available(iOS 15.0, macOS 12.0, *) {
    let url = URL(string: "https://taira.sora.org/status")!
    let (data, response) = try await URLSession.shared.data(from: url)

    if let http = response as? HTTPURLResponse {
        print("status:", http.statusCode)
    }
    print(String(decoding: data, as: UTF8.self))
}

在构建 UI 时,使用相同的 URLSession 检查对 https://taira.sora.org/v1/assets/definitions?limit=5 和重新尝试行为. 切换到 IrohaSDK 仅在应用程序从安全存储中加载签名材料后提交辅助员,并且账户在 Taira 上获得资金.

为了构建和提交交易,使用 IrohaSDK辅助员. 这些称为本地桥接支持的交易编码器:

let transfer = TransferRequest(
    chainId: "00000000-0000-0000-0000-000000000000",
    authority: accountId,
    assetDefinitionId: "66owaQmAQMuHxPzxUN3bqZ6FJfDa",
    quantity: "1",
    destination: accountId,
    description: "demo",
    feePayment: .authority(chargeLimits: [], gasLimit: nil)
)

if #available(iOS 15.0, macOS 12.0, *) {
    let status = try await sdk.submitAndWait(
        transfer: transfer,
        keypair: keypair
    )
    print(status.content.status.kind)
}

TransferRequest, MintRequest, BurnRequest, ShieldRequest, 和 UnshieldRequest 验证法典账户 IDs 基本资产的定义 IDs 在签署之前.

产业保险

Swift 通过 NativeEscrowInstructionBuilders或同等 IrohaSDK.build*Escrow*助手构建市场和匿名保证指令,作为 Norito JSON 的有效载荷.参见 本土资产保证为示例,匿名证明字段和争端解决权限代币.

签字

Keypair是Ed25519方便性 API.对于其他算法来说,用 defaultSigningAlgorithm构建一个 IrohaSDK,并使用 generateSigningKey()或 signingKey(fromSeed:):

let pqSdk = IrohaSDK(
    baseURL: torii.baseURL,
    defaultSigningAlgorithm: .mlDsa
)
let signingKey = try pqSdk.generateSigningKey()

目前SigningAlgorithm enum包括Ed25519, secp256k1, BLS 正常和小型变体, ML-DSA, GOST R 34.10-2012参数组,以及 SM2.在Ed25519便利路径之外,需要原生桥梁支持.

连接

连接客户端在 Swift 源中实现,加密和框架代码由 NoritoBridge支持:

let sessionID = Data(repeating: 0, count: 32) // replace with the session bytes
let sid = "<session-id-from-/v1/connect/session>"
let request = try ConnectClient.makeWebSocketRequest(
    baseURL: URL(string: "https://node.example")!,
    sid: sid,
    role: .app,
    token: "<token>"
)

let client = ConnectClient(request: request)
await client.start()

let session = ConnectSession(sessionID: sessionID, client: client)
let keyPair = try ConnectCrypto.generateKeyPair()

ConnectSession处理打开和关闭控制,加密封筒阅读,方向键,流量控制,事件流,平衡流和诊断日志.

目前覆盖范围

目前 Swift 来源包括:

• ToriiClient HTTP 对账户,资产,姓氏,探索者页面, RWA,合同,多签证,管理,订阅,数据可用性,机密资产,节点/运行时间状态,健康,指标和 SSE 流的辅助员
• IrohaSDK交易构建者和提交/投票助手转移,硬币,烧伤,盾牌,无盾牌,ZK 转移, ZK 资产登记,元数据,识别索赔,多签名登记以及管理说明
• 通过 PendingTransactionQueue和 FilePendingTransactionQueue等待的交易队列支持
• 通过 AccountAddress和 AccountId的账户地址和 I105 助手.
• Ed25519, secp256k1, ML-DSA, BLS,GOST 和 SM2 的签字表面,在需要时具有原生桥梁支
• 产地保证指令用货物构建商和匿名保证
• 连接 WebSocket,框架,加密,会议,排队,重播和诊断辅助器
• 卡盖穆沙准备,打字补充和赎回,运营状态,笔记,同行捆绑,收据和 QR 流模型
• SoraFS,数据可用性和验证附件辅助器

API 举例

用 IrohaSwift/Sources/IrohaSwift用于公开实施和IrohaSwift/Tests/IrohaSwiftTests用于相同来源修订的测试使用示例.

来源引用

• IrohaSwift/Package.swift
• IrohaSwift/IrohaSwift.podspec
• IrohaSwift/Sources/IrohaSwift/ToriiClient.swift
• IrohaSwift/Sources/IrohaSwift/TxBuilder.swift
• IrohaSwift/Sources/IrohaSwift/TransactionEncoder.swift
• IrohaSwift/Sources/IrohaSwift/ConnectClient.swift
• IrohaSwift/Sources/IrohaSwift/ConnectSession.swift