Hedera™ Swift SDK
The SDK for interacting with Hedera Hashgraph: the official distributed consensus platform built using the hashgraph consensus algorithm for fast, fair and secure transactions. Hedera enables and empowers developers to build an entirely new class of decentralized applications.
Maintained with
Requirements
- Swift v5.6+
- MacOS v10.15+ (2019, Catalina)
- iOS 13+ (2019)
Install
// Package.swift
dependencies: [
.package(url: "https://github.com/hashgraph/hedera-sdk-swift.git", from: "0.1.0")
]See "Adding Package Dependencies to Your App" for help on adding a swift package to an Xcode project.
Usage
import Hedera
// connect to the Hedera network
let client = Client.forTestnet()
// query the balance of an account
let ab = try await AccountBalanceQuery()
.accountId(AccountId("0.0.1001")!)
.execute(client)
print("balance = \(ab.balance)")See examples for more usage.
Community and Support
If you have any questions on the Hedera SDK or Hedera more generally, you can join our team and hundreds of other developers using Hedera in our community Discord:
License
Licensed under Apache License, Version 2.0 – see LICENSE or apache.org/licenses/LICENSE-2.0.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.
Development (HederaProtobufs)
HederaProtobufs is entirely generated
Required tooling
protoc protoc-gen-swift (from https://github.com/apple/swift-protobuf) protoc-gen-grpc-swift (from https://github.com/grpc/grpc-swift)
Generate services
# cwd: `$REPO`
protoc --swift_opt=Visibility=Public --swift_opt=FileNaming=PathToUnderscores --swift_out=./Sources/HederaProtobufs/Services --proto_path=./protobufs/services protobufs/services/**.proto
# generate GRPC (if needed)
protoc --grpc-swift_opt=Visibility=Public,Server=false --grpc-swift_out=./Sources/HederaProtobufs/Services --proto_path=protobufs/services protobufs/services/**.protoGenerate Mirror
# cwd: `$REPO/sdk/swift`
protoc --swift_opt=Visibility=Public --swift_opt=FileNaming=PathToUnderscores --swift_out=./Sources/HederaProtobufs/Mirror -I=protobufs/mirror -I=protobufs/services protobufs/mirror/**.proto
# generate GRPC (if needed)
protoc --grpc-swift_opt=Visibility=Public,FileNaming=PathToUnderscores,Server=false --grpc-swift_out=./Sources/HederaProtobufs/Mirror -I=protobufs/mirror -I=protobufs/services protobufs/mirror/**.protoGenerate SDK
# cwd: `$REPO/sdk/swift`
protoc --swift_opt=Visibility=Public --swift_opt=FileNaming=PathToUnderscores --swift_out=./Sources/HederaProtobufs/Sdk -I=protobufs/sdk -I=protobufs/services protobufs/sdk/**.proto