swift-ton

A Swift-based toolkit for working with The Open Network (TON). This library provides comprehensive utilities for constructing and decoding TON cells, managing addresses (both internal and friendly formats), creating and manipulating credentials (including mnemonic derivation), and interacting with smart contracts.

Caution

Currently is not well-tested version.

---

Table of Contents

• Features
• Installation
• Usage Overview
• Contributing
• License

---

Installation

In your Package.swift, add:

dependencies: [
  .package(url: "https://github.com/unistash-io/swift-ton.git", from: "0.0.1")
]

Usage Overview

Encoding Cells

// 1. Direct BitStorage & Children

let bits = BitStorage([true, false, true]) // 3 bits: 1,0,1
let cell1 = try Cell(.ordinary, storage: bits, children: [Cell()])
print("\(describe: cell1)")

// 2. DSL via String Interpolation

let cell2: Cell = "101001 \(true) 00 \(UInt32(1), truncatingToBitWidth: 34) \(cell1)"
print("\(describe: cell2)")

// 3. DSL via Result-Builder

let cell3 = try Cell {
    true // single bit
    "1101" // string => bits
    BitStorage("1001001") // more bits
    UInt32(42) // integer => bits
    try Cell() { false } // child cell with 'false'
}
print("\(describe: cell3)")

// 4. CellEncodable protocol

struct Item: CellEncodable {
    let id: UInt32
    let value: MyEnotherEncodable
    let optional: MyOptionalEncodable?

    func encode(to container: inout CellEncodingContainer) throws {
        try container.encode(id)
        try container.encode(id, truncatingToBitWidth: 4)
        try container.encodeIfPresent(value) // Maybe X
    }
}

let cell4 = try Cell(Item())
print("\(describe: cell4)")

Decoding Cells

// 1. Using block-based API

let result = try cell.decode { container in
    let myFlag = try container.decode(Bool.self)
    return myFlag
}
print("Decoded result: \(result)")

// 2. CellDecodable protocol

struct Item: CellDecodable {
    let id: UInt32

    init(from container: inout CellDecodingContainer) throws {
        self.id = try container.decode(UInt32.self)
    }
}

let item = try cell.decode(Item.self)

Interacting with BOC (Bag-of-Cells)

// Encoding BOC with root cell
let cell1: Cell = try Cell {}
let boc1 = try BOC(cell1)
print("boc: \(boc1.hexadecimalString)")

// Decoding cells from BOC
print("cells: \(desribe: BOC("1f3..")?.cells ?? [])")

Addresses

// InternalAddress is the raw 36-byte structure (4-byte workchain, 32-byte hash):
let internalAddr = InternalAddress(workchain: .basic, hash: my32ByteHash)!
print(internalAddr) // e.g. "0:FFEEDD..."

// FriendlyAddress is a base64 or base64URL-encoded “human-readable” format:
let friendly = FriendlyAddress(internalAddr, options: [.bounceable], format: .base64)
print(friendly.rawValue) // base64 string

// Convert back:
let maybeAddress = FriendlyAddress(rawValue: "EQDmf3...base64String")

// Convrting between addresses:
let fromFriendly = InternalAddress(friendly)
let backToFriendly = FriendlyAddress(fromFriendly)

Credentials

// Generate 24-word TON seed:
let credentials = Credentials.generate()

// Derive private key (Curve25519)
let privateKey = try credentials.curve25519()
let signature = try credentials.sign(someDataToSign)

Smart Contracts

let contract = Contract(address: internalAddress)
try await contract.update(using: network)
print(contract.balance)

// Typed Contracts via ABI (WalletV3R2 Example)

let network: NetworkProvider = MyNetworkProvider()

let credentials = Credentials.generate()
let wallet = try WalletV3R2(credentials: credentials)

try await wallet.transfer(
    10.0,
    to: someFriendlyAddress,
    comment: "Hello TON!",
    by: credentials,
    using: network
)

// This “ABI approach” makes external calls more type-safe:
// no need to hand-construct bit-level structures.
// Take a look to the WalletContract protocol for reference.

Contributing

We welcome all PRs—especially tests. If you have a fix, feature request, or question:

1. Fork this repo.
2. Make a branch.
3. Submit a pull request.

We appreciate issues describing bugs or proposing changes before major work.

License

This library is distributed under the MIT License. There is no warranty or guarantee; it’s UNSTABLE — use at your own risk, and we need your help testing!

Contact & Support

• Post an issue or pull request if you encounter problems.
• s@unistash.io