Errors, Logging and Troubleshooting

Before You Start

Read the following guides before proceeding:

Where Errors Arrive

WirexError

retryable says whether a retry can help. reason adds detail where the API supplies one:

e.detail.apiCode carries the API's own error code where present.

Other Types

• WirexDeclined is not an error state: the user said no and nothing was sent.
• WirexEnvironmentUnavailable is thrown by WirexEnvironment.resolve(_:chainId:) and
  WirexWalletEnvironment.resolve(_:): unknownName, notBuilt, malformedEndpoints, missingChainId. The
  create(...) factories return nil for the same conditions. Show the reason; never fall back to another
  environment.

func describe(_ error: Error) {
    if let e = error as? WirexError {
        print(e.code, e.retryable, e.reason as Any, e.detail.apiCode as Any)
    } else if let e = error as? WirexEnvironmentUnavailable {
        print(e)
    } else if error is WirexDeclined {
        print("user declined the step-up")
    }
}

Logging

Logging is off by default. Every logged value passes a redactor; tokens and card data are never handed to a
sink.

final class ConsoleLogSink: WirexLogSink {
    func write(level: WirexLogLevel, event: String, fields: [String: String]) { print(level, event, fields) }
}

let reveal = WirexReveal.create(
    credentials: credentials, chainId: "<chain id>",
    logging: WirexLogging(level: .info, sink: ConsoleLogSink()),
    timeouts: WirexTimeouts(requestSeconds: 20, resourceSeconds: 60))

Log at debug in development builds and warn in release.

Timeouts

timeouts: WirexTimeouts(requestSeconds:resourceSeconds:) on create(...) for Reveal and Collect.

Troubleshooting