This reference documents all the methods available in the SDK, and explains in detail how these methods work. SDKs are open source, and you can use them according to the licence.
- Sign in/up with Wallet provider
- Configure app
- Query cadence script with arguments
- Send transaction with non-custodial mode (Blocto)
- Send transaction with custodial wallet
- Support all access api endpoint such as
GetAccount
andGetLastestBlock
- Sign user message
- Verify user signature
- Support custom
authz
func
This is a Swift Package, and can be installed via Xcode with the URL of this repository:
.package(name: "FCL", url: "https://github.com/zed-io/fcl-swift.git", from: "0.0.1-beta")
Values only need to be set once. We recommend doing this once and as early in the life cycle as possible. To set a configuration value, the put
method on the config
instance needs to be called, the put
method returns the config
instance so they can be chained.
fcl.config
.put(key: .title, value: "Foo")
.put(key: .wallet, value: "https://fcl-http-post.vercel.app/api")
.put(key: .accessNode, value: "https://access-testnet.onflow.org")
.put(key: .authn, value: "https://dapper-http-post.vercel.app/api/authn")
.put(key: .location, value: "https://foo.com")
.put(key: .env, value: "mainnet")
// OR
fcl.config(appName: "Foo",
appIcon: "https://bar.com",
location: "https://foo.com",
walletNode: "https://fcl-http-post.vercel.app/api",
accessNode: "https://access-testnet.onflow.org",
env: "mainnet"
scope: "email",
authn: provider.endpoint)
Name | Example | Description |
---|---|---|
accessNode.api (required) |
https://access-testnet.onflow.org |
API URL for the Flow Blockchain Access Node you want to be communicating with. See all available access node endpoints here. |
env |
testnet |
Used in conjunction with stored interactions. Possible values: local , canarynet , testnet , mainnet |
discovery.wallet (required) |
https://fcl-discovery.onflow.org/testnet/authn |
Points FCL at the Wallet or Wallet Discovery mechanism. |
app.detail.title |
Cryptokitties |
Your applications title, can be requested by wallets and other services. |
app.detail.icon |
https://fcl-discovery.onflow.org/images/blocto.png |
Url for your applications icon, can be requested by wallets and other services. |
challenge.handshake |
DEPRECATED | Use discovery.wallet instead. |
Configuration keys that start with 0x
will be used to find-and-replace their values in Cadence scripts and transactions input to FCL. Typically this is used to represent account addresses. Account addresses for the same contract will be different depending on the Flow network you're interacting with (eg. Testnet, Mainnet).
This allows you to write your script or transaction once and not have to update code when you point your application at a different Flow network.
fcl.config
.put(key: "0xFungibleToken", value: "0xf233dcee88fe0abe")
.put(key: "0xFUSD", value: "0x3c5959b568896393")
fcl.query {
cadence {
"""
import FungibleToken from 0xFungibleToken
import FUSD from 0xFUSD
pub fun main(account: Address): UFix64 {
let receiverRef = getAccount(account).getCapability(/public/fusdBalance)!
.borrow<&FUSD.Vault{FungibleToken.Balance}>()
return receiverRef!.balance
}
"""
}
arguments {
[.address(Flow.Address(hex: address))]
}
}
These methods allows dapps to interact with FCL compatible wallets in order to authenticate the user and authorize transactions on their behalf.
Calling this method will authenticate the current user via any wallet that supports FCL. Once called, FCL will initiate communication with the configured authn
endpoint which lets the user select a wallet to authenticate with. Once the wallet provider has authenticated the user, FCL will set the values on the current user object for future use and authorization.
fcl
.config()
.put("accessNode.api", "https://access-testnet.onflow.org")
.put("discovery.wallet", "https://fcl-discovery.onflow.org/testnet/authn");
fcl.authenticate().sink()
A convenience method that produces the needed authorization details for the current user to submit transactions to Flow. It defines a signing function that connects to a user's wallet provider to produce signatures to submit transactions.
Note: The default values for proposer
, payer
, and authorizations
are already fcl.authz
so there is no need to include these parameters, it is shown only for example purposes. See more on signing roles.
fcl.mutate {
cadence {
"""
transaction(test: String, testInt: Int) {
prepare(signer: AuthAccount) {
log(signer.address)
log(test)
log(testInt)
}
}
"""
}
arguments {
[.string("Test2"), .int(1)]
}
gasLimit {
1000
}
}.sink { completion in
if case let .failure(error) = completion {
// Handle error here
}
} receiveValue: { txId in
// txId -> Transaction id
}.store(in: &cancellables)
๐ฃ These methods can be used in browsers and NodeJS.
These methods allows dapps to interact directly with the Flow blockchain via a set of functions that currently use the Access Node API.
If you want to run arbitrary Cadence scripts on the blockchain, these methods offer a convenient way to do so without having to build, send, and decode interactions.
Allows you to submit scripts to query the blockchain.
Pass in the following as a single object with the following keys.All keys are optional unless otherwise stated.
Key | Type | Description |
---|---|---|
cadence |
string (required) | A valid cadence script. |
arguments |
ArgumentFunction | Any arguments to the script if needed should be supplied via a function that returns an array of arguments. |
gasLimit |
number | Compute (Gas) limit for query. Read the documentation about computation cost for information about how computation cost is calculated on Flow. |
Type | Description |
---|---|
Flow.ScriptResponse | A model representation of the response. |
fcl.query {
cadence {
"""
pub fun main(a: Int, b: Int, addr: Address): Int {
log(addr)
return a + b
}
"""
}
arguments {
[.int(7), .int(6), .address(Flow.Address(hex: "0x01"))]
}
}.sink { completion in
// Handle completion
} receiveValue: { result in
print(result.fields?.value.toInt()) // 13
}.store(in: &cancellables)
Allows you to submit transactions to the blockchain to potentially mutate the state.
fcl.mutate
uses the built-in fcl.authz
function to produce the authorization (signatures) for the current user. When calling this method from Node.js, you will need to supply your own custom authorization function.
Pass in the following as a single object with the following keys. All keys are optional unless otherwise stated.
Key | Type | Description |
---|---|---|
cadence |
string (required) | A valid cadence transaction. |
arguments |
ArgumentFunction | Any arguments to the script if needed should be supplied via a function that returns an array of arguments. |
gasLimit |
number | Compute (Gas) limit for query. Read the documentation about computation cost for information about how computation cost is calculated on Flow. |
Type | Description |
---|---|
string | The transaction ID. |
fcl.mutate {
cadence {
"""
transaction(test: String, testInt: Int) {
prepare(signer: AuthAccount) {
log(signer.address)
log(test)
log(testInt)
}
}
"""
}
arguments {
[.string("Test2"), .int(1)]
}
gasLimit {
1000
}
}
.sink { completion in
if case let .failure(error) = completion {
// Handle error here
}
} receiveValue: { txId in
// txId -> Transaction id
}
.store(in: &cancellables)
A builder function that returns the interaction to get the latest block.
๐ฃ Use with fcl.atBlockId()
and fcl.atBlockHeight()
when building the interaction to get information for older blocks.
fcl.latestBlock(isSealed)
if you do not need to pair with any other builders.
Name | Type | Default | Description |
---|---|---|---|
sealed |
boolean | true | If the latest block should be sealed or not. See block states. |
Type | Description |
---|---|
BlockObject | The latest block if not used with any other builders. |
fcl.getLastestBlock()
.sink(...)
.store(in: &cancellables)