getAddresses / getAddress

​

getAddresses

public func getAddresses() async throws -> [PortalNamespace: String?]

public var addresses: [PortalNamespace: String?] { get async throws }

• [PortalNamespace: String?]: The client’s addresses, keyed by namespace:
  • .eip155: The EVM address
  • .solana: The Solana address
  • .stellar: The Stellar address
  • .tron: The Tron address
  • .xrpl: The XRP Ledger classic address

• .eip155, .tron, and .xrpl are present when the client has a SECP256K1 wallet.
• .solana and .stellar are present when the client has an ED25519 wallet.
• A namespace the client has no address for is left out of the dictionary, so it is not in keys and reads as nil by subscript.
• .bip122 is never present. Read Bitcoin addresses with getAddress and a P2WPKH chain ID.

• An error if the addresses can’t be read from the device’s keychain.

import PortalSwift

// `portal` is your initialized `Portal` instance.
do {
    let addresses = try await portal.getAddresses()

    if let evmAddress = addresses[.eip155] ?? nil {
        print("EVM address: \(evmAddress)")
    }
    if let xrplAddress = addresses[.xrpl] ?? nil {
        print("XRP Ledger address: \(xrplAddress)")
    }

    for (namespace, address) in addresses {
        print("\(namespace.rawValue): \(address ?? "")")
    }
} catch {
    print("Error reading addresses: \(error)")
}

​

getAddress

public func getAddress(_ forChainId: String) async -> String?

• forChainId: A Portal chain ID, in CAIP-2 format except for the Bitcoin P2WPKH IDs, which add a -p2wpkh suffix. The namespace part selects the address:

• String?: The address for that chain, or nil when:
  • the client has no address for that namespace,
  • the chain ID is a bip122: ID other than the two P2WPKH IDs above, or
  • the chain ID is malformed or its namespace isn’t supported.

import PortalSwift

// `portal` is your initialized `Portal` instance.
let chainIds = [
    "eip155:1",
    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "stellar:pubnet",
    "tron:mainnet",
    "xrpl:0",
    "bip122:000000000019d6689c085ae165831e93-p2wpkh"
]

for chainId in chainIds {
    if let address = await portal.getAddress(chainId) {
        print("\(chainId): \(address)")
    } else {
        print("\(chainId): no address")
    }
}

​

PortalNamespace

public enum PortalNamespace: String, Codable {
    case eip155
    case solana
    case bip122
    case stellar
    case tron
    case xrpl
}

• Addresses come from the client’s wallet metadata in the Portal API, not from the signing shares on the device. An address tells you the client has a wallet, not that it can sign on this device. Use isWalletOnDevice to check that.
• The XRP Ledger, Stellar, and Tron addresses are derived from the client’s existing wallets. No new wallet is created.
• Signing with an XRP Ledger, Stellar, or Tron chain ID isn’t supported yet. portal.request(...) and portal.rawSign(...) called with one of these chain IDs throw an unsupported request method error. Raw sign selects the key by an eip155 (SECP256K1) or solana (ED25519) chain ID.
• The deprecated portal.address property returns nil when the client has no EVM address.
• .xrpl, xrpl: chain IDs, the Bitcoin P2WPKH chain IDs in getAddress, and the omission of namespaces without an address are available starting from SDK version 8.1.0.

• Create a wallet
• createWallet reference
• Chain ID formatting