From 1760376cd566a6d43ff0709e2901569f47c19ff5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 1 Nov 2023 13:58:46 +0100 Subject: [PATCH 001/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 1ea172041..72b559803 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -232,6 +232,13 @@ public final class SignClient: SignClientProtocol { ) } + + public func authenticate(_ params: RequestParams) async throws -> WalletConnectURI? { + logger.debug("Requesting Authentication on existing pairing") + let pairingURI = try await pairingClient.create() + try await appRequestService.request(params: params, topic: pairingURI.topic) + } + /// For wallet to receive a session proposal from a dApp /// Responder should call this function in order to accept peer's pairing and be able to subscribe for future session proposals. /// - Parameter uri: Pairing URI that is commonly presented as a QR code by a dapp. From b2c1ea1ab8c279fba9789217e88a5ecdf55e85ea Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 1 Nov 2023 18:02:15 +0100 Subject: [PATCH 002/814] move auth files to sign --- .../WalletConnectSign/Auth/AuthImports.swift | 5 ++ .../Auth/AuthProtocolMethod.swift | 25 ++++++ .../Auth/Services/App/AppRequestService.swift | 34 ++++++++ .../Services/App/AppRespondSubscriber.swift | 75 ++++++++++++++++++ .../Wallet/PendingRequestsProvider.swift | 25 ++++++ .../Wallet/WalletErrorResponder.swift | 52 +++++++++++++ .../Wallet/WalletRequestSubscriber.swift | 60 +++++++++++++++ .../Wallet/WalletRespondService.swift | 77 +++++++++++++++++++ .../WalletConnectSign/Auth/SignConfig.swift | 7 ++ .../Auth/Types/Errors/AuthError.swift | 72 +++++++++++++++++ .../ProtocolRPCParams/AuthRequestParams.swift | 14 ++++ .../AuthResponseParams.swift | 4 + .../Auth/Types/Public/SignAuthRequest.swift | 7 ++ .../Auth/Types/RequestParams.swift | 39 ++++++++++ .../Auth/Types/RespondParams.swift | 11 +++ .../Auth/Types/SignAuthPayload.swift | 59 ++++++++++++++ Sources/WalletConnectSign/Sign/Sign.swift | 19 +++-- .../WalletConnectSign/Sign/SignClient.swift | 20 ++++- .../Sign/SignClientFactory.swift | 56 +++++++++++++- 19 files changed, 648 insertions(+), 13 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/AuthImports.swift create mode 100644 Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift create mode 100644 Sources/WalletConnectSign/Auth/SignConfig.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/RequestParams.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/RespondParams.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift diff --git a/Sources/WalletConnectSign/Auth/AuthImports.swift b/Sources/WalletConnectSign/Auth/AuthImports.swift new file mode 100644 index 000000000..91463cad3 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/AuthImports.swift @@ -0,0 +1,5 @@ +#if !CocoaPods +@_exported import WalletConnectPairing +@_exported import WalletConnectSigner +@_exported import WalletConnectVerify +#endif diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift new file mode 100644 index 000000000..a3a56117f --- /dev/null +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -0,0 +1,25 @@ +import Foundation + +struct AuthRequestProtocolMethod: ProtocolMethod { + let method: String = "wc_authRequest" + + let requestConfig = RelayConfig(tag: 3000, prompt: true, ttl: 86400) + + let responseConfig = RelayConfig(tag: 3001, prompt: false, ttl: 86400) +} + +struct PairingPingProtocolMethod: ProtocolMethod { + let method: String = "wc_pairingPing" + + let requestConfig = RelayConfig(tag: 1002, prompt: false, ttl: 30) + + let responseConfig = RelayConfig(tag: 1003, prompt: false, ttl: 30) +} + +struct PairingDeleteProtocolMethod: ProtocolMethod { + let method: String = "wc_pairingDelete" + + let requestConfig = RelayConfig(tag: 1000, prompt: false, ttl: 86400) + + let responseConfig = RelayConfig(tag: 1001, prompt: false, ttl: 86400) +} diff --git a/Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift new file mode 100644 index 000000000..8ac55b6ff --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift @@ -0,0 +1,34 @@ +import Foundation + +actor AppRequestService { + private let networkingInteractor: NetworkInteracting + private let appMetadata: AppMetadata + private let kms: KeyManagementService + private let logger: ConsoleLogging + private let iatProvader: IATProvider + + init(networkingInteractor: NetworkInteracting, + kms: KeyManagementService, + appMetadata: AppMetadata, + logger: ConsoleLogging, + iatProvader: IATProvider) { + self.networkingInteractor = networkingInteractor + self.kms = kms + self.appMetadata = appMetadata + self.logger = logger + self.iatProvader = iatProvader + } + + func request(params: RequestParams, topic: String) async throws { + let pubKey = try kms.createX25519KeyPair() + let responseTopic = pubKey.rawRepresentation.sha256().toHexString() + let requester = AuthRequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) + let payload = SignAuthPayload(requestParams: params, iat: iatProvader.iat) + let params = AuthRequestParams(requester: requester, payloadParams: payload) + let request = RPCRequest(method: "wc_authRequest", params: params) + try kms.setPublicKey(publicKey: pubKey, for: responseTopic) + logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") + try await networkingInteractor.request(request, topic: topic, protocolMethod: AuthRequestProtocolMethod()) + try await networkingInteractor.subscribe(topic: responseTopic) + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift new file mode 100644 index 000000000..0973e1cf1 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift @@ -0,0 +1,75 @@ +import Foundation +import Combine + +class AppRespondSubscriber { + private let networkingInteractor: NetworkInteracting + private let logger: ConsoleLogging + private let rpcHistory: RPCHistory + private let signatureVerifier: MessageVerifier + private let messageFormatter: SIWECacaoFormatting + private let pairingRegisterer: PairingRegisterer + private var publishers = [AnyCancellable]() + + var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? + + init(networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + rpcHistory: RPCHistory, + signatureVerifier: MessageVerifier, + pairingRegisterer: PairingRegisterer, + messageFormatter: SIWECacaoFormatting) { + self.networkingInteractor = networkingInteractor + self.logger = logger + self.rpcHistory = rpcHistory + self.signatureVerifier = signatureVerifier + self.messageFormatter = messageFormatter + self.pairingRegisterer = pairingRegisterer + subscribeForResponse() + } + + private func subscribeForResponse() { + networkingInteractor.responseErrorSubscription(on: AuthRequestProtocolMethod()) + .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + guard let error = AuthError(code: payload.error.code) else { return } + onResponse?(payload.id, .failure(error)) + }.store(in: &publishers) + + networkingInteractor.responseSubscription(on: AuthRequestProtocolMethod()) + .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + + pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) + + networkingInteractor.unsubscribe(topic: payload.topic) + + let requestId = payload.id + let cacao = payload.response + let requestPayload = payload.request + + guard + let address = try? DIDPKH(did: cacao.p.iss).account.address, + let message = try? messageFormatter.formatMessage(from: cacao.p) + else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } + + guard + let recovered = try? messageFormatter.formatMessage( + from: requestPayload.payloadParams.cacaoPayload(address: address) + ), recovered == message + else { self.onResponse?(requestId, .failure(.messageCompromised)); return } + + Task(priority: .high) { + do { + try await signatureVerifier.verify( + signature: cacao.s, + message: message, + address: address, + chainId: requestPayload.payloadParams.chainId + ) + onResponse?(requestId, .success(cacao)) + } catch { + logger.error("Signature verification failed with: \(error.localizedDescription)") + onResponse?(requestId, .failure(.signatureVerificationFailed)) + } + } + }.store(in: &publishers) + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift new file mode 100644 index 000000000..2d9b2938a --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift @@ -0,0 +1,25 @@ +import Foundation + +class PendingRequestsProvider { + private let rpcHistory: RPCHistory + private let verifyContextStore: CodableStore + + init( + rpcHistory: RPCHistory, + verifyContextStore: CodableStore + ) { + self.rpcHistory = rpcHistory + self.verifyContextStore = verifyContextStore + } + + public func getPendingRequests() throws -> [(SignAuthRequest, VerifyContext?)] { + let pendingRequests: [SignAuthRequest] = rpcHistory.getPending() + .filter {$0.request.method == "wc_authRequest"} + .compactMap { + guard let params = try? $0.request.params?.get(AuthRequestParams.self) else { return nil } + return SignAuthRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams) + } + + return pendingRequests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift new file mode 100644 index 000000000..597185480 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift @@ -0,0 +1,52 @@ +import Foundation + +actor WalletErrorResponder { + enum Errors: Error { + case recordForIdNotFound + case malformedAuthRequestParams + } + + private let networkingInteractor: NetworkInteracting + private let kms: KeyManagementServiceProtocol + private let rpcHistory: RPCHistory + private let logger: ConsoleLogging + + init(networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + kms: KeyManagementServiceProtocol, + rpcHistory: RPCHistory) { + self.networkingInteractor = networkingInteractor + self.logger = logger + self.kms = kms + self.rpcHistory = rpcHistory + } + + func respondError(_ error: AuthError, requestId: RPCID) async throws { + let authRequestParams = try getAuthRequestParams(requestId: requestId) + let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) + + try kms.setAgreementSecret(keys, topic: topic) + + let envelopeType = Envelope.EnvelopeType.type1(pubKey: keys.publicKey.rawRepresentation) + try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: AuthRequestProtocolMethod(), reason: error, envelopeType: envelopeType) + } + + private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { + guard let request = rpcHistory.get(recordId: requestId)?.request + else { throw Errors.recordForIdNotFound } + + guard let authRequestParams = try request.params?.get(AuthRequestParams.self) + else { throw Errors.malformedAuthRequestParams } + + return authRequestParams + } + + private func generateAgreementKeys(requestParams: AuthRequestParams) throws -> (topic: String, keys: AgreementKeys) { + let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) + let topic = peerPubKey.rawRepresentation.sha256().toHexString() + let selfPubKey = try kms.createX25519KeyPair() + let keys = try kms.performKeyAgreement(selfPublicKey: selfPubKey, peerPublicKey: peerPubKey.hexRepresentation) + // TODO - remove keys + return (topic, keys) + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift new file mode 100644 index 000000000..f8de0f76d --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift @@ -0,0 +1,60 @@ +import Foundation +import Combine + +class WalletRequestSubscriber { + private let networkingInteractor: NetworkInteracting + private let logger: ConsoleLogging + private let kms: KeyManagementServiceProtocol + private var publishers = [AnyCancellable]() + private let walletErrorResponder: WalletErrorResponder + private let pairingRegisterer: PairingRegisterer + private let verifyClient: VerifyClientProtocol + private let verifyContextStore: CodableStore + + var onRequest: (((request: SignAuthRequest, context: VerifyContext?)) -> Void)? + + init( + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + kms: KeyManagementServiceProtocol, + walletErrorResponder: WalletErrorResponder, + pairingRegisterer: PairingRegisterer, + verifyClient: VerifyClientProtocol, + verifyContextStore: CodableStore + ) { + self.networkingInteractor = networkingInteractor + self.logger = logger + self.kms = kms + self.walletErrorResponder = walletErrorResponder + self.pairingRegisterer = pairingRegisterer + self.verifyClient = verifyClient + self.verifyContextStore = verifyContextStore + subscribeForRequest() + } + + private func subscribeForRequest() { + pairingRegisterer.register(method: AuthRequestProtocolMethod()) + .sink { [unowned self] (payload: RequestSubscriptionPayload) in + logger.debug("WalletRequestSubscriber: Received request") + + pairingRegisterer.setReceived(pairingTopic: payload.topic) + + let request = SignAuthRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams) + + Task(priority: .high) { + let assertionId = payload.decryptedPayload.sha256().toHexString() + do { + let response = try await verifyClient.verifyOrigin(assertionId: assertionId) + let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.payloadParams.domain, isScam: response.isScam) + verifyContextStore.set(verifyContext, forKey: request.id.string) + onRequest?((request, verifyContext)) + } catch { + let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.payloadParams.domain, isScam: nil) + verifyContextStore.set(verifyContext, forKey: request.id.string) + onRequest?((request, verifyContext)) + return + } + } + }.store(in: &publishers) + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift new file mode 100644 index 000000000..a06a16027 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift @@ -0,0 +1,77 @@ +import Foundation + +actor WalletRespondService { + enum Errors: Error { + case recordForIdNotFound + case malformedAuthRequestParams + } + private let networkingInteractor: NetworkInteracting + private let kms: KeyManagementService + private let rpcHistory: RPCHistory + private let verifyContextStore: CodableStore + private let logger: ConsoleLogging + private let walletErrorResponder: WalletErrorResponder + private let pairingRegisterer: PairingRegisterer + + init( + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + kms: KeyManagementService, + rpcHistory: RPCHistory, + verifyContextStore: CodableStore, + walletErrorResponder: WalletErrorResponder, + pairingRegisterer: PairingRegisterer + ) { + self.networkingInteractor = networkingInteractor + self.logger = logger + self.kms = kms + self.rpcHistory = rpcHistory + self.verifyContextStore = verifyContextStore + self.walletErrorResponder = walletErrorResponder + self.pairingRegisterer = pairingRegisterer + } + + func respond(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { + let authRequestParams = try getAuthRequestParams(requestId: requestId) + let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) + + try kms.setAgreementSecret(keys, topic: topic) + + let header = CacaoHeader(t: "eip4361") + let payload = try authRequestParams.payloadParams.cacaoPayload(address: account.address) + let responseParams = AuthResponseParams(h: header, p: payload, s: signature) + + let response = RPCResponse(id: requestId, result: responseParams) + try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: AuthRequestProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) + + pairingRegisterer.activate( + pairingTopic: topic, + peerMetadata: authRequestParams.requester.metadata + ) + + verifyContextStore.delete(forKey: requestId.string) + } + + func respondError(requestId: RPCID) async throws { + try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + verifyContextStore.delete(forKey: requestId.string) + } + + private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { + guard let request = rpcHistory.get(recordId: requestId)?.request + else { throw Errors.recordForIdNotFound } + + guard let authRequestParams = try request.params?.get(AuthRequestParams.self) + else { throw Errors.malformedAuthRequestParams } + + return authRequestParams + } + + private func generateAgreementKeys(requestParams: AuthRequestParams) throws -> (topic: String, keys: AgreementKeys) { + let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) + let topic = peerPubKey.rawRepresentation.sha256().toHexString() + let selfPubKey = try kms.createX25519KeyPair() + let keys = try kms.performKeyAgreement(selfPublicKey: selfPubKey, peerPublicKey: peerPubKey.hexRepresentation) + return (topic, keys) + } +} diff --git a/Sources/WalletConnectSign/Auth/SignConfig.swift b/Sources/WalletConnectSign/Auth/SignConfig.swift new file mode 100644 index 000000000..7419f0f9b --- /dev/null +++ b/Sources/WalletConnectSign/Auth/SignConfig.swift @@ -0,0 +1,7 @@ +import Foundation + +extension Sign { + struct Config { + let crypto: CryptoProvider + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift b/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift new file mode 100644 index 000000000..cf4accb16 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift @@ -0,0 +1,72 @@ +import Foundation + +/// Authentication error +public enum AuthError: Codable, Equatable, Error { + case methodUnsupported + case userDisconnected + case userRejeted + case malformedResponseParams + case malformedRequestParams + case messageCompromised + case signatureVerificationFailed +} + +extension AuthError: Reason { + + init?(code: Int) { + switch code { + case Self.methodUnsupported.code: + self = .methodUnsupported + case Self.userRejeted.code: + self = .userRejeted + case Self.malformedResponseParams.code: + self = .malformedResponseParams + case Self.malformedRequestParams.code: + self = .malformedRequestParams + case Self.messageCompromised.code: + self = .messageCompromised + case Self.signatureVerificationFailed.code: + self = .signatureVerificationFailed + default: + return nil + } + } + + public var code: Int { + switch self { + case .methodUnsupported: + return 10001 + case .userDisconnected: + return 6000 + case .userRejeted: + return 14001 + case .malformedResponseParams: + return 12001 + case .malformedRequestParams: + return 12002 + case .messageCompromised: + return 12003 + case .signatureVerificationFailed: + return 12004 + } + } + + public var message: String { + switch self { + case .methodUnsupported: + return "Method Unsupported" + case .userRejeted: + return "Auth request rejected by user" + case .malformedResponseParams: + return "Response params malformed" + case .malformedRequestParams: + return "Request params malformed" + case .messageCompromised: + return "Original message compromised" + case .signatureVerificationFailed: + return "Message verification failed" + case .userDisconnected: + return "User Disconnected" + } + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift new file mode 100644 index 000000000..c312b629d --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift @@ -0,0 +1,14 @@ +import Foundation + +/// wc_authRequest RPC method request param +struct AuthRequestParams: Codable, Equatable { + let requester: Requester + let payloadParams: SignAuthPayload +} + +extension AuthRequestParams { + struct Requester: Codable, Equatable { + let publicKey: String + let metadata: AppMetadata + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift new file mode 100644 index 000000000..e2d097c01 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift @@ -0,0 +1,4 @@ +import Foundation + +/// wc_authRequest RPC method respond param +typealias AuthResponseParams = Cacao diff --git a/Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift b/Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift new file mode 100644 index 000000000..4c2cd33d2 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift @@ -0,0 +1,7 @@ +import Foundation + +public struct SignAuthRequest: Equatable, Codable { + public let id: RPCID + public let topic: String + public let payload: SignAuthPayload +} diff --git a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift new file mode 100644 index 000000000..1f57884a9 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift @@ -0,0 +1,39 @@ +import Foundation + +/// Parameters required to construct authentication request +/// for details read CAIP-74 and EIP-4361 specs +/// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-74.md +/// https://eips.ethereum.org/EIPS/eip-4361 +public struct RequestParams { + public let domain: String + public let chainId: String + public let nonce: String + public let aud: String + public let nbf: String? + public let exp: String? + public let statement: String? + public let requestId: String? + public let resources: [String]? + + public init( + domain: String, + chainId: String, + nonce: String, + aud: String, + nbf: String?, + exp: String?, + statement: String?, + requestId: String?, + resources: [String]? + ) { + self.domain = domain + self.chainId = chainId + self.nonce = nonce + self.aud = aud + self.nbf = nbf + self.exp = exp + self.statement = statement + self.requestId = requestId + self.resources = resources + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/RespondParams.swift b/Sources/WalletConnectSign/Auth/Types/RespondParams.swift new file mode 100644 index 000000000..f7c4a4af8 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/RespondParams.swift @@ -0,0 +1,11 @@ +import Foundation + +public struct RespondParams: Equatable { + let id: RPCID + let signature: CacaoSignature + + public init(id: RPCID, signature: CacaoSignature) { + self.id = id + self.signature = signature + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift new file mode 100644 index 000000000..ee93b2757 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift @@ -0,0 +1,59 @@ +import Foundation + +public struct SignAuthPayload: Codable, Equatable { + public let domain: String + public let aud: String + public let version: String + public let nonce: String + public let chainId: String + public let type: String + public let iat: String + public let nbf: String? + public let exp: String? + public let statement: String? + public let requestId: String? + public let resources: [String]? + + init(requestParams: RequestParams, iat: String) { + self.type = "eip4361" + self.chainId = requestParams.chainId + self.domain = requestParams.domain + self.aud = requestParams.aud + self.version = "1" + self.nonce = requestParams.nonce + self.iat = iat + self.nbf = requestParams.nbf + self.exp = requestParams.exp + self.statement = requestParams.statement + self.requestId = requestParams.requestId + self.resources = requestParams.resources + } + + public func cacaoPayload(address: String) throws -> CacaoPayload { + guard + let blockchain = Blockchain(chainId), + let account = Account(blockchain: blockchain, address: address) else { + throw Errors.invalidChainID + } + return CacaoPayload( + iss: account.did, + domain: domain, + aud: aud, + version: version, + nonce: nonce, + iat: iat, + nbf: nbf, + exp: exp, + statement: statement, + requestId: requestId, + resources: resources + ) + } +} + +private extension SignAuthPayload { + + enum Errors: Error { + case invalidChainID + } +} diff --git a/Sources/WalletConnectSign/Sign/Sign.swift b/Sources/WalletConnectSign/Sign/Sign.swift index b140c6fc9..55f76c14e 100644 --- a/Sources/WalletConnectSign/Sign/Sign.swift +++ b/Sources/WalletConnectSign/Sign/Sign.swift @@ -20,24 +20,27 @@ public class Sign { /// Sign client instance public static var instance: SignClient = { + guard let config = Sign.config else { + fatalError("Error - you must call Sign.configure(_:) before accessing the shared instance.") + } return SignClientFactory.create( - metadata: Sign.metadata ?? Pair.metadata, + metadata: Pair.metadata, pairingClient: Pair.instance as! PairingClient, - networkingClient: Networking.instance as! NetworkingInteractor + projectId: Networking.projectId, + crypto: config.crypto, + networkingClient: Networking.interactor ) }() - @available(*, deprecated, message: "Remove after clients migration") - private static var metadata: AppMetadata? + private static var config: Config? private init() { } /// Sign instance config method /// - Parameters: /// - metadata: App metadata - @available(*, deprecated, message: "Use Pair.configure(metadata:) instead") - static public func configure(metadata: AppMetadata) { - Pair.configure(metadata: metadata) - Sign.metadata = metadata + static public func configure(crypto: CryptoProvider) { + Sign.config = Sign.Config(crypto: crypto) } } + diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 72b559803..4e7c8ae16 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -115,6 +115,13 @@ public final class SignClient: SignClientProtocol { private let appProposeService: AppProposeService private let historyService: HistoryService private let cleanupService: SignCleanupService + + //Auth + private let appRequestService: AppRequestService + private let appRespondSubscriber: AppRespondSubscriber + private let walletRequestSubscriber: WalletRequestSubscriber + private let walletRespondService: WalletRespondService + private let pendingRequestsProvider: PendingRequestsProvider private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() private let sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() @@ -148,7 +155,12 @@ public final class SignClient: SignClientProtocol { disconnectService: DisconnectService, historyService: HistoryService, cleanupService: SignCleanupService, - pairingClient: PairingClient + pairingClient: PairingClient, + appRequestService: AppRequestService, + appRespondSubscriber: AppRespondSubscriber, + walletRequestSubscriber: WalletRequestSubscriber, + walletRespondService: WalletRespondService, + pendingRequestsProvider: PendingRequestsProvider ) { self.logger = logger self.networkingClient = networkingClient @@ -166,6 +178,11 @@ public final class SignClient: SignClientProtocol { self.cleanupService = cleanupService self.disconnectService = disconnectService self.pairingClient = pairingClient + self.appRequestService = appRequestService + self.walletRequestSubscriber = walletRequestSubscriber + self.walletRespondService = walletRespondService + self.appRespondSubscriber = appRespondSubscriber + self.pendingRequestsProvider = pendingRequestsProvider setUpConnectionObserving() setUpEnginesCallbacks() @@ -237,6 +254,7 @@ public final class SignClient: SignClientProtocol { logger.debug("Requesting Authentication on existing pairing") let pairingURI = try await pairingClient.create() try await appRequestService.request(params: params, topic: pairingURI.topic) + return pairingURI } /// For wallet to receive a session proposal from a dApp diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index cfaaf355f..73e67ac0f 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -11,14 +11,43 @@ public struct SignClientFactory { /// - keyValueStorage: by default WalletConnect SDK will store sequences in UserDefaults /// /// WalletConnect Client is not a singleton but once you create an instance, you should not deinitialize it. Usually only one instance of a client is required in the application. - public static func create(metadata: AppMetadata, pairingClient: PairingClient, networkingClient: NetworkingInteractor) -> SignClient { + public static func create( + metadata: AppMetadata, + pairingClient: PairingClient, + projectId: String, + crypto: CryptoProvider, + networkingClient: NetworkingInteractor + ) -> SignClient { let logger = ConsoleLogger(loggingLevel: .debug) let keyValueStorage = UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") - return SignClientFactory.create(metadata: metadata, logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, pairingClient: pairingClient, networkingClient: networkingClient) + let iatProvider = DefaultIATProvider() + + return SignClientFactory.create( + metadata: metadata, + logger: logger, + keyValueStorage: keyValueStorage, + keychainStorage: keychainStorage, + pairingClient: pairingClient, + networkingClient: networkingClient, + iatProvider: iatProvider, + projectId: projectId, + crypto: crypto + ) } - static func create(metadata: AppMetadata, logger: ConsoleLogging, keyValueStorage: KeyValueStorage, keychainStorage: KeychainStorageProtocol, pairingClient: PairingClient, networkingClient: NetworkingInteractor) -> SignClient { + static func create( + metadata: AppMetadata, + logger: ConsoleLogging, + keyValueStorage: KeyValueStorage, + keychainStorage: KeychainStorageProtocol, + pairingClient: PairingClient, + networkingClient: NetworkingInteractor, + iatProvider: IATProvider, + projectId: String, + crypto: CryptoProvider + + ) -> SignClient { let kms = KeyManagementService(keychain: keychainStorage) let rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) let pairingStore = PairingStorage(storage: SequenceStore(store: .init(defaults: keyValueStorage, identifier: SignStorageIdentifiers.pairings.rawValue))) @@ -54,6 +83,20 @@ public struct SignClientFactory { let pairingPingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appProposerService = AppProposeService(metadata: metadata, networkingInteractor: networkingClient, kms: kms, logger: logger) + + //Auth + let messageFormatter = SIWECacaoFormatter() + let appRequestService = AppRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider) + + let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) + let signatureVerifier = messageVerifierFactory.create(projectId: projectId) + let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, messageFormatter: messageFormatter) + let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) + let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) + let walletRespondService = WalletRespondService(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient) + let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) + + let client = SignClient( logger: logger, networkingClient: networkingClient, @@ -70,7 +113,12 @@ public struct SignClientFactory { disconnectService: disconnectService, historyService: historyService, cleanupService: cleanupService, - pairingClient: pairingClient + pairingClient: pairingClient, + appRequestService: appRequestService, + appRespondSubscriber: appRespondSubscriber, + walletRequestSubscriber: walletRequestSubscriber, + walletRespondService: walletRespondService, + pendingRequestsProvider: pendingRequestsProvider ) return client } From 22ff216dea1d2f81a01331f478663d21b0f7fa0b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 1 Nov 2023 19:35:58 +0100 Subject: [PATCH 003/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 4e7c8ae16..f2cfcfa33 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -157,10 +157,10 @@ public final class SignClient: SignClientProtocol { cleanupService: SignCleanupService, pairingClient: PairingClient, appRequestService: AppRequestService, - appRespondSubscriber: AppRespondSubscriber, - walletRequestSubscriber: WalletRequestSubscriber, - walletRespondService: WalletRespondService, - pendingRequestsProvider: PendingRequestsProvider + appRespondSubscriber: AppRespondSubscriber, + walletRequestSubscriber: WalletRequestSubscriber, + walletRespondService: WalletRespondService, + pendingRequestsProvider: PendingRequestsProvider ) { self.logger = logger self.networkingClient = networkingClient From 1ab98096c1e2b8db60fb563d8e261c3e6efd952b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 2 Nov 2023 14:53:39 +0100 Subject: [PATCH 004/814] move publishers --- .../WalletConnectSign/Sign/SignClient.swift | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index f2cfcfa33..87bd57f84 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -95,6 +95,25 @@ public final class SignClient: SignClientProtocol { sessionsPublisherSubject.eraseToAnyPublisher() } + + //------------------------------------AUTH--------------------------------------- + /// Publisher that sends authentication requests + /// + /// Wallet should subscribe on events in order to receive auth requests. + public var authRequestPublisher: AnyPublisher<(request: SignAuthRequest, context: VerifyContext?), Never> { + authRequestPublisherSubject.eraseToAnyPublisher() + } + + /// Publisher that sends authentication responses + /// + /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. + /// + /// Emited result may be an error. + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + authResponsePublisherSubject.eraseToAnyPublisher() + } + //--------------------------------------------------------------------------------- + /// An object that loggs SDK's errors and info messages public let logger: ConsoleLogging @@ -135,6 +154,8 @@ public final class SignClient: SignClientProtocol { private let sessionExtendPublisherSubject = PassthroughSubject<(sessionTopic: String, date: Date), Never>() private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() + private var authRequestPublisherSubject = PassthroughSubject<(request: SignAuthRequest, context: VerifyContext?), Never>() private var publishers = Set() @@ -249,6 +270,7 @@ public final class SignClient: SignClientProtocol { ) } + //---------------------------------------AUTH------------------------------------ public func authenticate(_ params: RequestParams) async throws -> WalletConnectURI? { logger.debug("Requesting Authentication on existing pairing") @@ -257,6 +279,37 @@ public final class SignClient: SignClientProtocol { return pairingURI } + + public func authenticate(_ params: RequestParams, topic: String) async throws { + try pairingClient.validatePairingExistance(topic) + logger.debug("Requesting Authentication on existing pairing") + try await appRequestService.request(params: params, topic: topic) + } + + + /// For a wallet to respond on authentication request + /// - Parameters: + /// - requestId: authentication request id + /// - signature: CACAO signature of requested message + public func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws { + try await walletRespondService.respond(requestId: requestId, signature: signature, account: account) + } + + /// For wallet to reject authentication request + /// - Parameter requestId: authentication request id + public func reject(requestId: RPCID) async throws { + try await walletRespondService.respondError(requestId: requestId) + } + + + /// Query pending authentication requests + /// - Returns: Pending authentication requests + public func getPendingRequests() throws -> [(SignAuthRequest, VerifyContext?)] { + return try pendingRequestsProvider.getPendingRequests() + } + + //----------------------------------------------------------------------------------- + /// For wallet to receive a session proposal from a dApp /// Responder should call this function in order to accept peer's pairing and be able to subscribe for future session proposals. /// - Parameter uri: Pairing URI that is commonly presented as a QR code by a dapp. @@ -457,6 +510,17 @@ public final class SignClient: SignClientProtocol { sessionEngine.onSessionsUpdate = { [unowned self] sessions in sessionsPublisherSubject.send(sessions) } + + + // Auth + + appRespondSubscriber.onResponse = { [unowned self] (id, result) in + authResponsePublisherSubject.send((id, result)) + } + + walletRequestSubscriber.onRequest = { [unowned self] request in + authRequestPublisherSubject.send(request) + } } private func setUpConnectionObserving() { From ef50c0762ed2991197ef05f1dd57b25e272d19ea Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 3 Nov 2023 08:51:10 +0100 Subject: [PATCH 005/814] Update we33wallet interface --- .../Wallet/PendingRequestsProvider.swift | 6 ++--- .../Wallet/WalletRequestSubscriber.swift | 4 +-- ...uest.swift => AuthenticationRequest.swift} | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 13 +++------- .../Sign/SignClientProtocol.swift | 2 ++ Sources/Web3Wallet/Web3WalletClient.swift | 26 ++++++++++++++++++- 6 files changed, 37 insertions(+), 16 deletions(-) rename Sources/WalletConnectSign/Auth/Types/Public/{SignAuthRequest.swift => AuthenticationRequest.swift} (66%) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift index 2d9b2938a..91ff03f8c 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift @@ -12,12 +12,12 @@ class PendingRequestsProvider { self.verifyContextStore = verifyContextStore } - public func getPendingRequests() throws -> [(SignAuthRequest, VerifyContext?)] { - let pendingRequests: [SignAuthRequest] = rpcHistory.getPending() + public func getPendingRequests() throws -> [(AuthenticationRequest, VerifyContext?)] { + let pendingRequests: [AuthenticationRequest] = rpcHistory.getPending() .filter {$0.request.method == "wc_authRequest"} .compactMap { guard let params = try? $0.request.params?.get(AuthRequestParams.self) else { return nil } - return SignAuthRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams) + return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams) } return pendingRequests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift index f8de0f76d..6f939712a 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift @@ -11,7 +11,7 @@ class WalletRequestSubscriber { private let verifyClient: VerifyClientProtocol private let verifyContextStore: CodableStore - var onRequest: (((request: SignAuthRequest, context: VerifyContext?)) -> Void)? + var onRequest: (((request: AuthenticationRequest, context: VerifyContext?)) -> Void)? init( networkingInteractor: NetworkInteracting, @@ -39,7 +39,7 @@ class WalletRequestSubscriber { pairingRegisterer.setReceived(pairingTopic: payload.topic) - let request = SignAuthRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams) + let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams) Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() diff --git a/Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift similarity index 66% rename from Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift rename to Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift index 4c2cd33d2..d4ac1b81d 100644 --- a/Sources/WalletConnectSign/Auth/Types/Public/SignAuthRequest.swift +++ b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift @@ -1,6 +1,6 @@ import Foundation -public struct SignAuthRequest: Equatable, Codable { +public struct AuthenticationRequest: Equatable, Codable { public let id: RPCID public let topic: String public let payload: SignAuthPayload diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 87bd57f84..1170bfde8 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -100,7 +100,7 @@ public final class SignClient: SignClientProtocol { /// Publisher that sends authentication requests /// /// Wallet should subscribe on events in order to receive auth requests. - public var authRequestPublisher: AnyPublisher<(request: SignAuthRequest, context: VerifyContext?), Never> { + public var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { authRequestPublisherSubject.eraseToAnyPublisher() } @@ -155,7 +155,7 @@ public final class SignClient: SignClientProtocol { private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() - private var authRequestPublisherSubject = PassthroughSubject<(request: SignAuthRequest, context: VerifyContext?), Never>() + private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private var publishers = Set() @@ -291,7 +291,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws { + public func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { try await walletRespondService.respond(requestId: requestId, signature: signature, account: account) } @@ -304,7 +304,7 @@ public final class SignClient: SignClientProtocol { /// Query pending authentication requests /// - Returns: Pending authentication requests - public func getPendingRequests() throws -> [(SignAuthRequest, VerifyContext?)] { + public func getPendingAuthRequests() throws -> [(AuthenticationRequest, VerifyContext?)] { return try pendingRequestsProvider.getPendingRequests() } @@ -510,14 +510,9 @@ public final class SignClient: SignClientProtocol { sessionEngine.onSessionsUpdate = { [unowned self] sessions in sessionsPublisherSubject.send(sessions) } - - - // Auth - appRespondSubscriber.onResponse = { [unowned self] (id, result) in authResponsePublisherSubject.send((id, result)) } - walletRequestSubscriber.onRequest = { [unowned self] request in authRequestPublisherSubject.send(request) } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 95f56ee76..75ebc82aa 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -18,6 +18,7 @@ public protocol SignClientProtocol { func reject(proposalId: String, reason: RejectionReason) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws + func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func pair(uri: WalletConnectURI) async throws @@ -26,6 +27,7 @@ public protocol SignClientProtocol { func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] + func getPendingAuthRequests() throws -> [(WalletConnectSign.AuthenticationRequest, VerifyContext?)] func getPendingProposals(topic: String?) -> [(proposal: Session.Proposal, context: VerifyContext?)] func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index a90093a10..c22e94c82 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -178,7 +178,31 @@ public class Web3WalletClient { public func formatMessage(payload: AuthPayload, address: String) throws -> String { try authClient.formatMessage(payload: payload, address: address) } - + + //---------------------------------------AUTH------------------------------------ + /// For a wallet to respond on authentication request + /// - Parameters: + /// - requestId: authentication request id + /// - signature: CACAO signature of requested message + public func respondSessionAuthenticated(requestId: RPCID, signature: WalletConnectSign.CacaoSignature, from account: Account) async throws { + try await signClient.respondSessionAuthenticated(requestId: requestId, signature: signature, account: account) + } + +// /// For wallet to reject authentication request +// /// - Parameter requestId: authentication request id +// public func reject(requestId: RPCID) async throws { +// try await walletRespondService.respondError(requestId: requestId) +// } +// +// + /// Query pending authentication requests + /// - Returns: Pending authentication requests + public func getPendingAuthRequests() throws -> [(AuthenticationRequest, VerifyContext?)] { + return try signClient.getPendingAuthRequests() + } + //--------------------------------------------------- + + /// For a wallet to respond on authentication request /// - Parameters: /// - requestId: authentication request id From 970e28a0c0e6781a67fafa17072914f02c42d0b6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 3 Nov 2023 09:18:25 +0100 Subject: [PATCH 006/814] update w3w interface --- .../Auth/AuthProtocolMethod.swift | 6 +++--- ...e.swift => SessionAuthRequestService.swift} | 4 ++-- ...yload.swift => AuthenticationPayload.swift} | 4 ++-- .../ProtocolRPCParams/AuthRequestParams.swift | 2 +- .../Types/Public/AuthenticationRequest.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 8 ++++---- .../Sign/SignClientFactory.swift | 2 +- .../Sign/SignClientProtocol.swift | 3 ++- Sources/Web3Wallet/Web3WalletClient.swift | 18 +++++++++--------- 9 files changed, 25 insertions(+), 24 deletions(-) rename Sources/WalletConnectSign/Auth/Services/App/{AppRequestService.swift => SessionAuthRequestService.swift} (92%) rename Sources/WalletConnectSign/Auth/Types/{SignAuthPayload.swift => AuthenticationPayload.swift} (94%) diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift index a3a56117f..eabd67ce7 100644 --- a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -1,11 +1,11 @@ import Foundation struct AuthRequestProtocolMethod: ProtocolMethod { - let method: String = "wc_authRequest" + let method: String = "wc_sessionAuthenticated" - let requestConfig = RelayConfig(tag: 3000, prompt: true, ttl: 86400) + let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 86400) - let responseConfig = RelayConfig(tag: 3001, prompt: false, ttl: 86400) + let responseConfig = RelayConfig(tag: 1117, prompt: false, ttl: 86400) } struct PairingPingProtocolMethod: ProtocolMethod { diff --git a/Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift similarity index 92% rename from Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift rename to Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 8ac55b6ff..51670ce08 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AppRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -1,6 +1,6 @@ import Foundation -actor AppRequestService { +actor SessionAuthRequestService { private let networkingInteractor: NetworkInteracting private let appMetadata: AppMetadata private let kms: KeyManagementService @@ -23,7 +23,7 @@ actor AppRequestService { let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let requester = AuthRequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) - let payload = SignAuthPayload(requestParams: params, iat: iatProvader.iat) + let payload = AuthenticationPayload(requestParams: params, iat: iatProvader.iat) let params = AuthRequestParams(requester: requester, payloadParams: payload) let request = RPCRequest(method: "wc_authRequest", params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) diff --git a/Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift similarity index 94% rename from Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift rename to Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift index ee93b2757..8c4326ae5 100644 --- a/Sources/WalletConnectSign/Auth/Types/SignAuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift @@ -1,6 +1,6 @@ import Foundation -public struct SignAuthPayload: Codable, Equatable { +public struct AuthenticationPayload: Codable, Equatable { public let domain: String public let aud: String public let version: String @@ -51,7 +51,7 @@ public struct SignAuthPayload: Codable, Equatable { } } -private extension SignAuthPayload { +private extension AuthenticationPayload { enum Errors: Error { case invalidChainID diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift index c312b629d..6c93b7f89 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift @@ -3,7 +3,7 @@ import Foundation /// wc_authRequest RPC method request param struct AuthRequestParams: Codable, Equatable { let requester: Requester - let payloadParams: SignAuthPayload + let payloadParams: AuthenticationPayload } extension AuthRequestParams { diff --git a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift index d4ac1b81d..fdfca0e38 100644 --- a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift +++ b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift @@ -3,5 +3,5 @@ import Foundation public struct AuthenticationRequest: Equatable, Codable { public let id: RPCID public let topic: String - public let payload: SignAuthPayload + public let payload: AuthenticationPayload } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 1170bfde8..27960a3a2 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -136,7 +136,7 @@ public final class SignClient: SignClientProtocol { private let cleanupService: SignCleanupService //Auth - private let appRequestService: AppRequestService + private let appRequestService: SessionAuthRequestService private let appRespondSubscriber: AppRespondSubscriber private let walletRequestSubscriber: WalletRequestSubscriber private let walletRespondService: WalletRespondService @@ -177,7 +177,7 @@ public final class SignClient: SignClientProtocol { historyService: HistoryService, cleanupService: SignCleanupService, pairingClient: PairingClient, - appRequestService: AppRequestService, + appRequestService: SessionAuthRequestService, appRespondSubscriber: AppRespondSubscriber, walletRequestSubscriber: WalletRequestSubscriber, walletRespondService: WalletRespondService, @@ -297,7 +297,7 @@ public final class SignClient: SignClientProtocol { /// For wallet to reject authentication request /// - Parameter requestId: authentication request id - public func reject(requestId: RPCID) async throws { + public func rejectSession(requestId: RPCID) async throws { try await walletRespondService.respondError(requestId: requestId) } @@ -334,7 +334,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - proposalId: Session Proposal id /// - reason: Reason why the session proposal has been rejected. Conforms to CAIP25. - public func reject(proposalId: String, reason: RejectionReason) async throws { + public func rejectSession(proposalId: String, reason: RejectionReason) async throws { try await approveEngine.reject(proposerPubKey: proposalId, reason: reason.internalRepresentation()) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 73e67ac0f..073bd7622 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -86,7 +86,7 @@ public struct SignClientFactory { //Auth let messageFormatter = SIWECacaoFormatter() - let appRequestService = AppRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider) + let appRequestService = SessionAuthRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider) let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 75ebc82aa..01025bd5d 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -15,7 +15,8 @@ public protocol SignClientProtocol { func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]?) async throws - func reject(proposalId: String, reason: RejectionReason) async throws + func rejectSession(proposalId: String, reason: RejectionReason) async throws + func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index c22e94c82..6ef8e6ce0 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -95,8 +95,8 @@ public class Web3WalletClient { /// - Parameters: /// - proposalId: Session Proposal id /// - reason: Reason why the session proposal has been rejected. Conforms to CAIP25. - public func reject(proposalId: String, reason: RejectionReason) async throws { - try await signClient.reject(proposalId: proposalId, reason: reason) + public func rejectSession(proposalId: String, reason: RejectionReason) async throws { + try await signClient.rejectSession(proposalId: proposalId, reason: reason) } /// For wallet to reject authentication request @@ -188,13 +188,13 @@ public class Web3WalletClient { try await signClient.respondSessionAuthenticated(requestId: requestId, signature: signature, account: account) } -// /// For wallet to reject authentication request -// /// - Parameter requestId: authentication request id -// public func reject(requestId: RPCID) async throws { -// try await walletRespondService.respondError(requestId: requestId) -// } -// -// + /// For wallet to reject authentication request + /// - Parameter requestId: authentication request id + public func rejectSession(requestId: RPCID) async throws { + try await signClient.rejectSession(requestId: requestId) + } + + /// Query pending authentication requests /// - Returns: Pending authentication requests public func getPendingAuthRequests() throws -> [(AuthenticationRequest, VerifyContext?)] { From aa32d4ec104c8e38b35a1822d3d40cd91bfef83b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 3 Nov 2023 11:40:19 +0100 Subject: [PATCH 007/814] savepoint --- Example/IntegrationTests/Sign/SignClientTests.swift | 8 ++++++-- .../XPlatform/Web3Wallet/XPlatformW3WTests.swift | 5 ++++- Sources/Web3Wallet/Web3WalletClient.swift | 1 + 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index d28ae7c11..e3f59c163 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -4,6 +4,7 @@ import JSONRPC @testable import WalletConnectKMS @testable import WalletConnectSign @testable import WalletConnectRelay +@testable import WalletConnectUtils import WalletConnectPairing import WalletConnectNetworking @@ -42,7 +43,10 @@ final class SignClientTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, pairingClient: pairingClient, - networkingClient: networkingClient + networkingClient: networkingClient, + iatProvider: IATProviderMock(), + projectId: InputConfig.projectId, + crypto: DefaultCryptoProvider() ) let clientId = try! networkingClient.getClientId() @@ -100,7 +104,7 @@ final class SignClientTests: XCTestCase { wallet.onSessionProposal = { [unowned self] proposal in Task(priority: .high) { do { - try await wallet.client.reject(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason + try await wallet.client.rejectSession(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason store.rejectedProposal = proposal } catch { XCTFail("\(error)") } } diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index e08391021..e2429885b 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -54,7 +54,10 @@ final class XPlatformW3WTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, pairingClient: pairingClient, - networkingClient: networkingClient + networkingClient: networkingClient, + iatProvider: DefaultIATProvider(), + projectId: InputConfig.projectId, + crypto: DefaultCryptoProvider() ) let authClient = AuthClientFactory.create( diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 6ef8e6ce0..dec94371e 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -180,6 +180,7 @@ public class Web3WalletClient { } //---------------------------------------AUTH------------------------------------ + // TODO - add publishers for authenticated session /// For a wallet to respond on authentication request /// - Parameters: /// - requestId: authentication request id From ebe6382d82ed4511c7388ea57a967f5fb542aaa5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 3 Nov 2023 11:59:21 +0100 Subject: [PATCH 008/814] savepoint --- .../Sign/SignClientTests.swift | 26 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 22 +++++++++------- 2 files changed, 39 insertions(+), 9 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index e3f59c163..b499e28be 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -735,4 +735,30 @@ final class SignClientTests: XCTestCase { try await wallet.client.pair(uri: uri!) wait(for: [settlementFailedExpectation], timeout: 1) } + + + func testSessionAuthenticated() async throws { + let dappSettlementExpectation = expectation(description: "Dapp expects to settle a session") + let walletSettlementExpectation = expectation(description: "Wallet expects to settle a session") + + wallet.onSessionProposal = { [unowned self] proposal in + Task(priority: .high) { + do { + try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + } catch { + XCTFail("\(error)") + } + } + } + dapp.onSessionSettled = { _ in + dappSettlementExpectation.fulfill() + } + wallet.onSessionSettled = { _ in + walletSettlementExpectation.fulfill() + } + + let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces) + try await wallet.client.pair(uri: uri!) + wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 27960a3a2..542d7282f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -270,15 +270,7 @@ public final class SignClient: SignClientProtocol { ) } - //---------------------------------------AUTH------------------------------------ - - public func authenticate(_ params: RequestParams) async throws -> WalletConnectURI? { - logger.debug("Requesting Authentication on existing pairing") - let pairingURI = try await pairingClient.create() - try await appRequestService.request(params: params, topic: pairingURI.topic) - return pairingURI - } - + //---------------------------------------AUTH----------------------------------- public func authenticate(_ params: RequestParams, topic: String) async throws { try pairingClient.validatePairingExistance(topic) @@ -524,3 +516,15 @@ public final class SignClient: SignClientProtocol { }.store(in: &publishers) } } + +#if DEBUG +//TODO - remove after Sign Client tests refactor +extension SignClient { + func authenticate(_ params: RequestParams) async throws -> WalletConnectURI? { + logger.debug("Requesting Authentication on existing pairing") + let pairingURI = try await pairingClient.create() + try await appRequestService.request(params: params, topic: pairingURI.topic) + return pairingURI + } +} +#endif From 9f705cc642fd0491b0f33c096166b452516d7b54 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 3 Nov 2023 13:20:36 +0100 Subject: [PATCH 009/814] refactor sign client tests --- Example/ExampleApp.xcodeproj/project.pbxproj | 6 +- .../Sign/Helpers/ClientDelegate.swift | 72 ---- .../Sign/SignClientTests.swift | 363 +++++++++--------- .../WalletConnectSign/Sign/SignClient.swift | 68 ---- .../Sign/SignClientProtocol.swift | 1 - 5 files changed, 183 insertions(+), 327 deletions(-) delete mode 100644 Example/IntegrationTests/Sign/Helpers/ClientDelegate.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 4cecf980f..dae10b030 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3,7 +3,7 @@ archiveVersion = 1; classes = { }; - objectVersion = 52; + objectVersion = 54; objects = { /* Begin PBXBuildFile section */ @@ -63,7 +63,6 @@ 84E6B84E29787A8000428BAF /* PNDecryptionService.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 84E6B84729787A8000428BAF /* PNDecryptionService.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; }; 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84FE684528ACDB4700C893FF /* RequestParams.swift */; }; A507BE1A29E8032E0038EF70 /* EIP55Tests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A507BE1929E8032E0038EF70 /* EIP55Tests.swift */; }; - A50C036528AAD32200FE72D3 /* ClientDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50C036428AAD32200FE72D3 /* ClientDelegate.swift */; }; A50D53C12ABA055700A4FD8B /* NotifyPreferencesModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BC2ABA055700A4FD8B /* NotifyPreferencesModule.swift */; }; A50D53C22ABA055700A4FD8B /* NotifyPreferencesPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BD2ABA055700A4FD8B /* NotifyPreferencesPresenter.swift */; }; A50D53C32ABA055700A4FD8B /* NotifyPreferencesRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BE2ABA055700A4FD8B /* NotifyPreferencesRouter.swift */; }; @@ -440,7 +439,6 @@ 84F568C32795832A00D0A289 /* EthereumTransaction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = EthereumTransaction.swift; sourceTree = ""; }; 84FE684528ACDB4700C893FF /* RequestParams.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RequestParams.swift; sourceTree = ""; }; A507BE1929E8032E0038EF70 /* EIP55Tests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = EIP55Tests.swift; sourceTree = ""; }; - A50C036428AAD32200FE72D3 /* ClientDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ClientDelegate.swift; sourceTree = ""; }; A50D53BC2ABA055700A4FD8B /* NotifyPreferencesModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyPreferencesModule.swift; sourceTree = ""; }; A50D53BD2ABA055700A4FD8B /* NotifyPreferencesPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyPreferencesPresenter.swift; sourceTree = ""; }; A50D53BE2ABA055700A4FD8B /* NotifyPreferencesRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyPreferencesRouter.swift; sourceTree = ""; }; @@ -816,7 +814,6 @@ 767DC83328997F7600080FA9 /* Helpers */ = { isa = PBXGroup; children = ( - A50C036428AAD32200FE72D3 /* ClientDelegate.swift */, 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */, 84AA01DA28CF0CD7005D48D8 /* XCTest.swift */, ); @@ -2383,7 +2380,6 @@ 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */, 7694A5262874296A0001257E /* RegistryTests.swift in Sources */, A541959F2934BFEF0035AD19 /* SignerTests.swift in Sources */, - A50C036528AAD32200FE72D3 /* ClientDelegate.swift in Sources */, A5321C2B2A250367006CADC3 /* HistoryTests.swift in Sources */, A58A1ECC29BF458600A82A20 /* ENSResolverTests.swift in Sources */, A5E03DFA286465C700888481 /* SignClientTests.swift in Sources */, diff --git a/Example/IntegrationTests/Sign/Helpers/ClientDelegate.swift b/Example/IntegrationTests/Sign/Helpers/ClientDelegate.swift deleted file mode 100644 index e812661e2..000000000 --- a/Example/IntegrationTests/Sign/Helpers/ClientDelegate.swift +++ /dev/null @@ -1,72 +0,0 @@ -import Foundation -@testable import WalletConnectSign -import Combine - -class ClientDelegate { - - var client: SignClient - var onSessionSettled: ((Session) -> Void)? - var onConnected: (() -> Void)? - var onSessionProposal: ((Session.Proposal) -> Void)? - var onSessionRequest: ((Request) -> Void)? - var onSessionResponse: ((Response) -> Void)? - var onSessionRejected: ((Session.Proposal, Reason) -> Void)? - var onSessionDelete: (() -> Void)? - var onSessionUpdateNamespaces: ((String, [String: SessionNamespace]) -> Void)? - var onSessionExtend: ((String, Date) -> Void)? - var onPing: ((String) -> Void)? - var onEventReceived: ((Session.Event, String) -> Void)? - - private var publishers = Set() - - init(client: SignClient) { - self.client = client - setupSubscriptions() - } - - private func setupSubscriptions() { - client.sessionSettlePublisher.sink { session in - self.onSessionSettled?(session) - }.store(in: &publishers) - - client.socketConnectionStatusPublisher.sink { _ in - self.onConnected?() - }.store(in: &publishers) - - client.sessionProposalPublisher.sink { result in - self.onSessionProposal?(result.proposal) - }.store(in: &publishers) - - client.sessionRequestPublisher.sink { result in - self.onSessionRequest?(result.request) - }.store(in: &publishers) - - client.sessionResponsePublisher.sink { response in - self.onSessionResponse?(response) - }.store(in: &publishers) - - client.sessionRejectionPublisher.sink { (proposal, reason) in - self.onSessionRejected?(proposal, reason) - }.store(in: &publishers) - - client.sessionDeletePublisher.sink { _ in - self.onSessionDelete?() - }.store(in: &publishers) - - client.sessionUpdatePublisher.sink { (topic, namespaces) in - self.onSessionUpdateNamespaces?(topic, namespaces) - }.store(in: &publishers) - - client.sessionEventPublisher.sink { (event, topic, _) in - self.onEventReceived?(event, topic) - }.store(in: &publishers) - - client.sessionExtendPublisher.sink { (topic, date) in - self.onSessionExtend?(topic, date) - }.store(in: &publishers) - - client.pingResponsePublisher.sink { topic in - self.onPing?(topic) - }.store(in: &publishers) - } -} diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index b499e28be..2c0c40bc4 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -7,12 +7,17 @@ import JSONRPC @testable import WalletConnectUtils import WalletConnectPairing import WalletConnectNetworking +import Combine final class SignClientTests: XCTestCase { - var dapp: ClientDelegate! - var wallet: ClientDelegate! + var dapp: SignClient! + var dappPairingClient: PairingClient! + var wallet: SignClient! + var walletPairingClient: PairingClient! + private var publishers = Set() - static private func makeClientDelegate(name: String) -> ClientDelegate { + + static private func makeClients(name: String) -> (PairingClient, SignClient) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() @@ -52,12 +57,12 @@ final class SignClientTests: XCTestCase { let clientId = try! networkingClient.getClientId() logger.debug("My client id is: \(clientId)") - return ClientDelegate(client: client) + return (pairingClient, client) } override func setUp() async throws { - dapp = Self.makeClientDelegate(name: "🍏P") - wallet = Self.makeClientDelegate(name: "🍎R") + (dappPairingClient, dapp) = Self.makeClients(name: "🍏P") + (walletPairingClient, wallet) = Self.makeClients(name: "🍎R") } override func tearDown() { @@ -71,48 +76,51 @@ final class SignClientTests: XCTestCase { let requiredNamespaces = ProposalNamespace.stubRequired() let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { _ in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { _ in dappSettlementExpectation.fulfill() - } - wallet.onSessionSettled = { _ in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { _ in walletSettlementExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testSessionReject() async throws { let sessionRejectExpectation = expectation(description: "Proposer is notified on session rejection") + let requiredNamespaces = ProposalNamespace.stubRequired() class Store { var rejectedProposal: Session.Proposal? } let store = Store() - let uri = try await dapp.client.connect(requiredNamespaces: ProposalNamespace.stubRequired()) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.rejectSession(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason + try await wallet.rejectSession(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason store.rejectedProposal = proposal } catch { XCTFail("\(error)") } } - } - dapp.onSessionRejected = { proposal, _ in + }.store(in: &publishers) + dapp.sessionRejectionPublisher.sink { proposal, _ in XCTAssertEqual(store.rejectedProposal, proposal) sessionRejectExpectation.fulfill() // TODO: Assert reason code - } + }.store(in: &publishers) wait(for: [sessionRejectExpectation], timeout: InputConfig.defaultTimeout) } @@ -121,22 +129,23 @@ final class SignClientTests: XCTestCase { let requiredNamespaces = ProposalNamespace.stubRequired() let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - do { try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } + do { try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { [unowned self] settledSession in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - try await dapp.client.disconnect(topic: settledSession.topic) + try await dapp.disconnect(topic: settledSession.topic) } - } - wallet.onSessionDelete = { + }.store(in: &publishers) + wallet.sessionDeletePublisher.sink { _ in sessionDeleteExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [sessionDeleteExpectation], timeout: InputConfig.defaultTimeout) } @@ -146,26 +155,27 @@ final class SignClientTests: XCTestCase { let requiredNamespaces = ProposalNamespace.stubRequired() let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) - wallet.onSessionProposal = { proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - try! await self.wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try! await self.wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } - } + }.store(in: &publishers) - dapp.onSessionSettled = { sessionSettled in + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - try! await self.dapp.client.ping(topic: sessionSettled.topic) + try! await dapp.ping(topic: settledSession.topic) } - } + }.store(in: &publishers) - dapp.onPing = { topic in - let session = self.wallet.client.getSessions().first! + dapp.pingResponsePublisher.sink { topic in + let session = self.wallet.getSessions().first! XCTAssertEqual(topic, session.topic) expectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces)! - try await wallet.client.pair(uri: uri) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [expectation], timeout: InputConfig.defaultTimeout) } @@ -181,30 +191,30 @@ final class SignClientTests: XCTestCase { let responseParams = "0xdeadbeef" let chain = Blockchain("eip155:1")! - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { [unowned self] settledSession in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { let request = Request(id: RPCID(0), topic: settledSession.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) - try await dapp.client.request(params: request) + try await dapp.request(params: request) } - } - wallet.onSessionRequest = { [unowned self] sessionRequest in + }.store(in: &publishers) + wallet.sessionRequestPublisher.sink { [unowned self] (sessionRequest, _) in let receivedParams = try! sessionRequest.params.get([EthSendTransaction].self) XCTAssertEqual(receivedParams, requestParams) XCTAssertEqual(sessionRequest.method, requestMethod) requestExpectation.fulfill() Task(priority: .high) { - try await wallet.client.respond(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(AnyCodable(responseParams))) + try await wallet.respond(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(AnyCodable(responseParams))) } - } - dapp.onSessionResponse = { response in + }.store(in: &publishers) + dapp.sessionResponsePublisher.sink { response in switch response.result { case .response(let response): XCTAssertEqual(try! response.get(String.self), responseParams) @@ -212,10 +222,11 @@ final class SignClientTests: XCTestCase { XCTFail() } responseExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -230,23 +241,23 @@ final class SignClientTests: XCTestCase { let chain = Blockchain("eip155:1")! - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } - } - dapp.onSessionSettled = { [unowned self] settledSession in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { let request = Request(id: RPCID(0), topic: settledSession.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) - try await dapp.client.request(params: request) + try await dapp.request(params: request) } - } - wallet.onSessionRequest = { [unowned self] sessionRequest in + }.store(in: &publishers) + wallet.sessionRequestPublisher.sink { [unowned self] (sessionRequest, _) in Task(priority: .high) { - try await wallet.client.respond(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .error(error)) + try await wallet.respond(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .error(error)) } - } - dapp.onSessionResponse = { response in + }.store(in: &publishers) + dapp.sessionResponsePublisher.sink { response in switch response.result { case .response: XCTFail() @@ -254,14 +265,15 @@ final class SignClientTests: XCTestCase { XCTAssertEqual(error, receivedError) } expectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [expectation], timeout: InputConfig.defaultTimeout) } - func testNewSessionOnExistingPairing() async { + func testNewSessionOnExistingPairing() async throws { let dappSettlementExpectation = expectation(description: "Dapp settles session") dappSettlementExpectation.expectedFulfillmentCount = 2 let walletSettlementExpectation = expectation(description: "Wallet settles session") @@ -270,86 +282,89 @@ final class SignClientTests: XCTestCase { let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) var initiatedSecondSession = false - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { [unowned self] _ in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { [unowned self] _ in dappSettlementExpectation.fulfill() - let pairingTopic = dapp.client.getPairings().first!.topic + let pairingTopic = dappPairingClient.getPairings().first!.topic if !initiatedSecondSession { Task(priority: .high) { - _ = try! await dapp.client.connect(requiredNamespaces: requiredNamespaces, topic: pairingTopic) + _ = try! await dapp.connect(requiredNamespaces: requiredNamespaces, topic: pairingTopic) } initiatedSecondSession = true } - } - wallet.onSessionSettled = { _ in + }.store(in: &publishers) + wallet.sessionSettlePublisher.sink { _ in walletSettlementExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try! await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try! await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } - func testSuccessfulSessionUpdateNamespaces() async { + func testSuccessfulSessionUpdateNamespaces() async throws { let expectation = expectation(description: "Dapp updates namespaces") let requiredNamespaces = ProposalNamespace.stubRequired() let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } - } - dapp.onSessionSettled = { [unowned self] settledSession in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - try! await wallet.client.update(topic: settledSession.topic, namespaces: sessionNamespaces) + try! await wallet.update(topic: settledSession.topic, namespaces: sessionNamespaces) } - } - dapp.onSessionUpdateNamespaces = { _, _ in + }.store(in: &publishers) + dapp.sessionUpdatePublisher.sink { _, _ in expectation.fulfill() - } - let uri = try! await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try! await wallet.client.pair(uri: uri!) + }.store(in: &publishers) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [expectation], timeout: InputConfig.defaultTimeout) } - func testSuccessfulSessionExtend() async { + func testSuccessfulSessionExtend() async throws { let expectation = expectation(description: "Dapp extends session") let requiredNamespaces = ProposalNamespace.stubRequired() let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } - } + }.store(in: &publishers) - dapp.onSessionExtend = { _, _ in + dapp.sessionExtendPublisher.sink { _, _ in expectation.fulfill() - } + }.store(in: &publishers) - dapp.onSessionSettled = { [unowned self] settledSession in + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - try! await wallet.client.extend(topic: settledSession.topic) + try! await wallet.extend(topic: settledSession.topic) } - } + }.store(in: &publishers) - let uri = try! await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try! await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [expectation], timeout: InputConfig.defaultTimeout) } - func testSessionEventSucceeds() async { + func testSessionEventSucceeds() async throws { let expectation = expectation(description: "Dapp receives session event") let requiredNamespaces = ProposalNamespace.stubRequired() @@ -357,29 +372,30 @@ final class SignClientTests: XCTestCase { let event = Session.Event(name: "any", data: AnyCodable("event_data")) let chain = Blockchain("eip155:1")! - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } - } + }.store(in: &publishers) - dapp.onEventReceived = { _, _ in + dapp.sessionEventPublisher.sink { _, _, _ in expectation.fulfill() - } + }.store(in: &publishers) - dapp.onSessionSettled = { [unowned self] settledSession in + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - try! await wallet.client.emit(topic: settledSession.topic, event: event, chainId: chain) + try! await wallet.emit(topic: settledSession.topic, event: event, chainId: chain) } - } + }.store(in: &publishers) - let uri = try! await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try! await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [expectation], timeout: InputConfig.defaultTimeout) } - func testSessionEventFails() async { + func testSessionEventFails() async throws { let expectation = expectation(description: "Dapp receives session event") let requiredNamespaces = ProposalNamespace.stubRequired() @@ -387,21 +403,22 @@ final class SignClientTests: XCTestCase { let event = Session.Event(name: "unknown", data: AnyCodable("event_data")) let chain = Blockchain("eip155:1")! - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } - } + }.store(in: &publishers) - dapp.onSessionSettled = { [unowned self] settledSession in + dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - await XCTAssertThrowsErrorAsync(try await wallet.client.emit(topic: settledSession.topic, event: event, chainId: chain)) + await XCTAssertThrowsErrorAsync(try await wallet.emit(topic: settledSession.topic, event: event, chainId: chain)) expectation.fulfill() } - } + }.store(in: &publishers) - let uri = try! await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try! await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [expectation], timeout: InputConfig.defaultTimeout) } @@ -462,24 +479,25 @@ final class SignClientTests: XCTestCase { ] ) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { _ in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { settledSession in dappSettlementExpectation.fulfill() - } - wallet.onSessionSettled = { _ in + }.store(in: &publishers) + wallet.sessionEventPublisher.sink { _ in walletSettlementExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -530,24 +548,25 @@ final class SignClientTests: XCTestCase { ] ) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { _ in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { [unowned self] _ in dappSettlementExpectation.fulfill() - } - wallet.onSessionSettled = { _ in + }.store(in: &publishers) + wallet.sessionEventPublisher.sink { _ in walletSettlementExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -588,24 +607,25 @@ final class SignClientTests: XCTestCase { ] ) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } - } - dapp.onSessionSettled = { _ in + }.store(in: &publishers) + dapp.sessionSettlePublisher.sink { _ in dappSettlementExpectation.fulfill() - } - wallet.onSessionSettled = { _ in + }.store(in: &publishers) + wallet.sessionEventPublisher.sink { _ in walletSettlementExpectation.fulfill() - } + }.store(in: &publishers) - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -653,21 +673,22 @@ final class SignClientTests: XCTestCase { ] ) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { settlementFailedExpectation.fulfill() } } - } + }.store(in: &publishers) } catch { settlementFailedExpectation.fulfill() } - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [settlementFailedExpectation], timeout: 1) } @@ -718,47 +739,27 @@ final class SignClientTests: XCTestCase { ] ) - wallet.onSessionProposal = { [unowned self] proposal in + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { settlementFailedExpectation.fulfill() } } - } + }.store(in: &publishers) } catch { settlementFailedExpectation.fulfill() } - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) - try await wallet.client.pair(uri: uri!) + let uri = try! await dappPairingClient.create() + try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + try await walletPairingClient.pair(uri: uri) wait(for: [settlementFailedExpectation], timeout: 1) } func testSessionAuthenticated() async throws { - let dappSettlementExpectation = expectation(description: "Dapp expects to settle a session") - let walletSettlementExpectation = expectation(description: "Wallet expects to settle a session") - wallet.onSessionProposal = { [unowned self] proposal in - Task(priority: .high) { - do { - try await wallet.client.approve(proposalId: proposal.id, namespaces: sessionNamespaces) - } catch { - XCTFail("\(error)") - } - } - } - dapp.onSessionSettled = { _ in - dappSettlementExpectation.fulfill() - } - wallet.onSessionSettled = { _ in - walletSettlementExpectation.fulfill() - } - - let uri = try await dapp.client.connect(requiredNamespaces: requiredNamespaces) - try await wallet.client.pair(uri: uri!) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 542d7282f..ad13da9c7 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -211,43 +211,6 @@ public final class SignClient: SignClientProtocol { // MARK: - Public interface - /// For a dApp to propose a session to a wallet. - /// Function will create pairing and propose session or propose a session on existing pairing. - /// - Parameters: - /// - requiredNamespaces: required namespaces for a session - /// - topic: Optional parameter - use it if you already have an established pairing with peer client. - /// - Returns: Pairing URI that should be shared with responder out of bound. Common way is to present it as a QR code. Pairing URI will be nil if you are going to establish a session on existing Pairing and `topic` function parameter was provided. - @available(*, deprecated, message: "use Pair.instance.create() and connect(requiredNamespaces: [String: ProposalNamespace]): instead") - public func connect( - requiredNamespaces: [String: ProposalNamespace], - optionalNamespaces: [String: ProposalNamespace]? = nil, - sessionProperties: [String: String]? = nil, - topic: String? = nil - ) async throws -> WalletConnectURI? { - logger.debug("Connecting Application") - if let topic = topic { - try pairingClient.validatePairingExistance(topic) - try await appProposeService.propose( - pairingTopic: topic, - namespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: sessionProperties, - relay: RelayProtocolOptions(protocol: "irn", data: nil) - ) - return nil - } else { - let pairingURI = try await pairingClient.create() - try await appProposeService.propose( - pairingTopic: pairingURI.topic, - namespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: sessionProperties, - relay: RelayProtocolOptions(protocol: "irn", data: nil) - ) - return pairingURI - } - } - /// For a dApp to propose a session to a wallet. /// Function will propose a session on existing pairing. /// - Parameters: @@ -302,18 +265,6 @@ public final class SignClient: SignClientProtocol { //----------------------------------------------------------------------------------- - /// For wallet to receive a session proposal from a dApp - /// Responder should call this function in order to accept peer's pairing and be able to subscribe for future session proposals. - /// - Parameter uri: Pairing URI that is commonly presented as a QR code by a dapp. - /// - /// Should Error: - /// - When URI has invalid format or missing params - /// - When topic is already in use - @available(*, deprecated, message: "use Pair.instance.pair(uri: WalletConnectURI): instead") - public func pair(uri: WalletConnectURI) async throws { - try await pairingClient.pair(uri: uri) - } - /// For a wallet to approve a session proposal. /// - Parameters: /// - proposalId: Session Proposal id @@ -407,13 +358,6 @@ public final class SignClient: SignClientProtocol { sessionEngine.getSessions() } - /// Query pairings - /// - Returns: All pairings - @available(*, deprecated, message: "use Pair.instance.getPairings(uri: WalletConnectURI): instead") - public func getPairings() -> [Pairing] { - pairingClient.getPairings() - } - /// Query pending requests /// - Returns: Pending requests received from peer with `wc_sessionRequest` protocol method /// - Parameter topic: topic representing session for which you want to get pending requests. If nil, you will receive pending requests for all active sessions. @@ -516,15 +460,3 @@ public final class SignClient: SignClientProtocol { }.store(in: &publishers) } } - -#if DEBUG -//TODO - remove after Sign Client tests refactor -extension SignClient { - func authenticate(_ params: RequestParams) async throws -> WalletConnectURI? { - logger.debug("Requesting Authentication on existing pairing") - let pairingURI = try await pairingClient.create() - try await appRequestService.request(params: params, topic: pairingURI.topic) - return pairingURI - } -} -#endif diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 01025bd5d..223872cab 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -22,7 +22,6 @@ public protocol SignClientProtocol { func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws - func pair(uri: WalletConnectURI) async throws func disconnect(topic: String) async throws func getSessions() -> [Session] func cleanup() async throws From 3ed0c53b1e3e34f87803e6e135cf8c8da8feb599 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 4 Nov 2023 10:27:56 +0100 Subject: [PATCH 010/814] fix all sign client tests --- Example/IntegrationTests/Sign/SignClientTests.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 2c0c40bc4..83ee44e10 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -491,7 +491,7 @@ final class SignClientTests: XCTestCase { dapp.sessionSettlePublisher.sink { settledSession in dappSettlementExpectation.fulfill() }.store(in: &publishers) - wallet.sessionEventPublisher.sink { _ in + wallet.sessionSettlePublisher.sink { _ in walletSettlementExpectation.fulfill() }.store(in: &publishers) @@ -560,7 +560,7 @@ final class SignClientTests: XCTestCase { dapp.sessionSettlePublisher.sink { [unowned self] _ in dappSettlementExpectation.fulfill() }.store(in: &publishers) - wallet.sessionEventPublisher.sink { _ in + wallet.sessionSettlePublisher.sink { _ in walletSettlementExpectation.fulfill() }.store(in: &publishers) @@ -619,7 +619,7 @@ final class SignClientTests: XCTestCase { dapp.sessionSettlePublisher.sink { _ in dappSettlementExpectation.fulfill() }.store(in: &publishers) - wallet.sessionEventPublisher.sink { _ in + wallet.sessionSettlePublisher.sink { _ in walletSettlementExpectation.fulfill() }.store(in: &publishers) From 5e2b75465f7aea34d1a6424523f4235b31204307 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 Nov 2023 08:39:48 +0100 Subject: [PATCH 011/814] savepoint --- .../WalletConnectPairing/PairingClient.swift | 5 +++ .../PairingClientProtocol.swift | 1 + .../Auth/AuthProtocolMethod.swift | 2 +- .../Services/App/AppRespondSubscriber.swift | 4 +-- .../App/SessionAuthRequestService.swift | 2 +- ...iber.swift => AuthRequestSubscriber.swift} | 4 +-- ...spondService.swift => AuthResponder.swift} | 4 +-- .../Wallet/WalletErrorResponder.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 36 ++++++++++++++----- .../Sign/SignClientFactory.swift | 8 ++--- 10 files changed, 46 insertions(+), 22 deletions(-) rename Sources/WalletConnectSign/Auth/Services/Wallet/{WalletRequestSubscriber.swift => AuthRequestSubscriber.swift} (96%) rename Sources/WalletConnectSign/Auth/Services/Wallet/{WalletRespondService.swift => AuthResponder.swift} (95%) diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 3eafd2838..bc38c9bf0 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -20,6 +20,7 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let deletePairingService: DeletePairingService private let resubscribeService: PairingResubscribeService private let expirationService: ExpirationService + private var registeredMethods: [[String]] = [] private let cleanupService: PairingCleanupService @@ -82,6 +83,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient return try await appPairService.create() } + public func register(supportedMethods: [String]) { + registeredMethods.append(supportedMethods) + } + public func activate(pairingTopic: String, peerMetadata: AppMetadata?) { appPairActivateService.activate(for: pairingTopic, peerMetadata: peerMetadata) } diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index 098293c19..caca4bf18 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -1,5 +1,6 @@ public protocol PairingClientProtocol { func pair(uri: WalletConnectURI) async throws + func register(supportedMethods: [String]) func disconnect(topic: String) async throws func getPairings() -> [Pairing] } diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift index eabd67ce7..2a7fd3ee8 100644 --- a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -1,6 +1,6 @@ import Foundation -struct AuthRequestProtocolMethod: ProtocolMethod { +struct SessionAuthenticatedProtocolMethod: ProtocolMethod { let method: String = "wc_sessionAuthenticated" let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 86400) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift index 0973e1cf1..d3995e02f 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift @@ -28,13 +28,13 @@ class AppRespondSubscriber { } private func subscribeForResponse() { - networkingInteractor.responseErrorSubscription(on: AuthRequestProtocolMethod()) + networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } onResponse?(payload.id, .failure(error)) }.store(in: &publishers) - networkingInteractor.responseSubscription(on: AuthRequestProtocolMethod()) + networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 51670ce08..ddccf8bea 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -28,7 +28,7 @@ actor SessionAuthRequestService { let request = RPCRequest(method: "wc_authRequest", params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") - try await networkingInteractor.request(request, topic: topic, protocolMethod: AuthRequestProtocolMethod()) + try await networkingInteractor.request(request, topic: topic, protocolMethod: SessionAuthenticatedProtocolMethod()) try await networkingInteractor.subscribe(topic: responseTopic) } } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift similarity index 96% rename from Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift rename to Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index 6f939712a..f1a69435b 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -1,7 +1,7 @@ import Foundation import Combine -class WalletRequestSubscriber { +class AuthRequestSubscriber { private let networkingInteractor: NetworkInteracting private let logger: ConsoleLogging private let kms: KeyManagementServiceProtocol @@ -33,7 +33,7 @@ class WalletRequestSubscriber { } private func subscribeForRequest() { - pairingRegisterer.register(method: AuthRequestProtocolMethod()) + pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in logger.debug("WalletRequestSubscriber: Received request") diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift similarity index 95% rename from Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift rename to Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index a06a16027..0f98223eb 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletRespondService.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -1,6 +1,6 @@ import Foundation -actor WalletRespondService { +actor AuthResponder { enum Errors: Error { case recordForIdNotFound case malformedAuthRequestParams @@ -42,7 +42,7 @@ actor WalletRespondService { let responseParams = AuthResponseParams(h: header, p: payload, s: signature) let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: AuthRequestProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) + try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) pairingRegisterer.activate( pairingTopic: topic, diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift index 597185480..e5a1a3ded 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift @@ -28,7 +28,7 @@ actor WalletErrorResponder { try kms.setAgreementSecret(keys, topic: topic) let envelopeType = Envelope.EnvelopeType.type1(pubKey: keys.publicKey.rawRepresentation) - try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: AuthRequestProtocolMethod(), reason: error, envelopeType: envelopeType) + try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: SessionAuthenticatedProtocolMethod(), reason: error, envelopeType: envelopeType) } private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index ad13da9c7..fa85b970b 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -138,8 +138,8 @@ public final class SignClient: SignClientProtocol { //Auth private let appRequestService: SessionAuthRequestService private let appRespondSubscriber: AppRespondSubscriber - private let walletRequestSubscriber: WalletRequestSubscriber - private let walletRespondService: WalletRespondService + private let authRequestSubscriber: AuthRequestSubscriber + private let authResponder: AuthResponder private let pendingRequestsProvider: PendingRequestsProvider private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() @@ -179,8 +179,8 @@ public final class SignClient: SignClientProtocol { pairingClient: PairingClient, appRequestService: SessionAuthRequestService, appRespondSubscriber: AppRespondSubscriber, - walletRequestSubscriber: WalletRequestSubscriber, - walletRespondService: WalletRespondService, + authRequestSubscriber: AuthRequestSubscriber, + authResponder: AuthResponder, pendingRequestsProvider: PendingRequestsProvider ) { self.logger = logger @@ -200,13 +200,14 @@ public final class SignClient: SignClientProtocol { self.disconnectService = disconnectService self.pairingClient = pairingClient self.appRequestService = appRequestService - self.walletRequestSubscriber = walletRequestSubscriber - self.walletRespondService = walletRespondService + self.authRequestSubscriber = authRequestSubscriber + self.authResponder = authResponder self.appRespondSubscriber = appRespondSubscriber self.pendingRequestsProvider = pendingRequestsProvider setUpConnectionObserving() setUpEnginesCallbacks() + pairingClient.register(supportedMethods: [SessionProposeProtocolMethod().method, SessionAuthenticatedProtocolMethod().method]) } // MARK: - Public interface @@ -239,6 +240,23 @@ public final class SignClient: SignClientProtocol { try pairingClient.validatePairingExistance(topic) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: topic) + + let testNamespace = [ + "eip155": ProposalNamespace( + chains: [ + Blockchain("eip155:1")!, + ], + methods: [ + "personal_sign", + ], events: [] + )] + try await appProposeService.propose( + pairingTopic: topic, + namespaces: testNamespace, + optionalNamespaces: nil, + sessionProperties: nil, + relay: RelayProtocolOptions(protocol: "irn", data: nil) + ) } @@ -247,13 +265,13 @@ public final class SignClient: SignClientProtocol { /// - requestId: authentication request id /// - signature: CACAO signature of requested message public func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { - try await walletRespondService.respond(requestId: requestId, signature: signature, account: account) + try await authResponder.respond(requestId: requestId, signature: signature, account: account) } /// For wallet to reject authentication request /// - Parameter requestId: authentication request id public func rejectSession(requestId: RPCID) async throws { - try await walletRespondService.respondError(requestId: requestId) + try await authResponder.respondError(requestId: requestId) } @@ -449,7 +467,7 @@ public final class SignClient: SignClientProtocol { appRespondSubscriber.onResponse = { [unowned self] (id, result) in authResponsePublisherSubject.send((id, result)) } - walletRequestSubscriber.onRequest = { [unowned self] request in + authRequestSubscriber.onRequest = { [unowned self] request in authRequestPublisherSubject.send(request) } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 073bd7622..b25836dd4 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -92,8 +92,8 @@ public struct SignClientFactory { let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, messageFormatter: messageFormatter) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) - let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let walletRespondService = WalletRespondService(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient) + let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) + let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) @@ -116,8 +116,8 @@ public struct SignClientFactory { pairingClient: pairingClient, appRequestService: appRequestService, appRespondSubscriber: appRespondSubscriber, - walletRequestSubscriber: walletRequestSubscriber, - walletRespondService: walletRespondService, + authRequestSubscriber: authRequestSubscriber, + authResponder: authResponder, pendingRequestsProvider: pendingRequestsProvider ) return client From 54ed37b58062c889ad9348b70c567609c06448c4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 Nov 2023 13:23:10 +0100 Subject: [PATCH 012/814] update wc uri --- .../SessionProposalInteractor.swift | 2 +- .../WalletConnectPairing/PairingClient.swift | 5 +- .../PairingClientProtocol.swift | 2 +- .../Services/App/AppPairService.swift | 7 ++- .../WalletConnectSign/Sign/SignClient.swift | 6 +- .../WalletConnectUtils/WalletConnectURI.swift | 41 +++++++++++--- .../Stubs/WalletConnectURI+Stub.swift | 6 +- .../WalletConnectURITests.swift | 55 ++++++++++++++++++- .../Mocks/PairingClientMock.swift | 4 ++ .../Mocks/SignClientMock.swift | 16 +++++- Tests/Web3WalletTests/Web3WalletTests.swift | 2 +- 11 files changed, 123 insertions(+), 23 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index 0216a3db6..39a07cba1 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -31,6 +31,6 @@ final class SessionProposalInteractor { } func reject(proposal: Session.Proposal) async throws { - try await Web3Wallet.instance.reject(proposalId: proposal.id, reason: .userRejected) + try await Web3Wallet.instance.rejectSession(proposalId: proposal.id, reason: .userRejected) } } diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index bc38c9bf0..23d67b02d 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -20,7 +20,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let deletePairingService: DeletePairingService private let resubscribeService: PairingResubscribeService private let expirationService: ExpirationService - private var registeredMethods: [[String]] = [] private let cleanupService: PairingCleanupService @@ -83,8 +82,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient return try await appPairService.create() } - public func register(supportedMethods: [String]) { - registeredMethods.append(supportedMethods) + public func register(supportedMethods: [String]) async { + await appPairService.register(supportedMethods: supportedMethods) } public func activate(pairingTopic: String, peerMetadata: AppMetadata?) { diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index caca4bf18..ccf3216fa 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -1,6 +1,6 @@ public protocol PairingClientProtocol { func pair(uri: WalletConnectURI) async throws - func register(supportedMethods: [String]) + func register(supportedMethods: [String]) async func disconnect(topic: String) async throws func getPairings() -> [Pairing] } diff --git a/Sources/WalletConnectPairing/Services/App/AppPairService.swift b/Sources/WalletConnectPairing/Services/App/AppPairService.swift index 7dd5deb09..e206fd5ad 100644 --- a/Sources/WalletConnectPairing/Services/App/AppPairService.swift +++ b/Sources/WalletConnectPairing/Services/App/AppPairService.swift @@ -4,6 +4,7 @@ actor AppPairService { private let networkingInteractor: NetworkInteracting private let kms: KeyManagementServiceProtocol private let pairingStorage: WCPairingStorage + private var registeredMethods: [[String]] = [] init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, pairingStorage: WCPairingStorage) { self.networkingInteractor = networkingInteractor @@ -11,12 +12,16 @@ actor AppPairService { self.pairingStorage = pairingStorage } + public func register(supportedMethods: [String]) async { + registeredMethods.append(supportedMethods) + } + func create() async throws -> WalletConnectURI { let topic = String.generateTopic() try await networkingInteractor.subscribe(topic: topic) let symKey = try! kms.createSymmetricKey(topic) let pairing = WCPairing(topic: topic) - let uri = WalletConnectURI(topic: topic, symKey: symKey.hexRepresentation, relay: pairing.relay) + let uri = WalletConnectURI(topic: topic, symKey: symKey.hexRepresentation, relay: pairing.relay, methods: registeredMethods) pairingStorage.setPairing(pairing) return uri } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index fa85b970b..4b21bcd99 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -207,7 +207,7 @@ public final class SignClient: SignClientProtocol { setUpConnectionObserving() setUpEnginesCallbacks() - pairingClient.register(supportedMethods: [SessionProposeProtocolMethod().method, SessionAuthenticatedProtocolMethod().method]) + registerMethods() } // MARK: - Public interface @@ -477,4 +477,8 @@ public final class SignClient: SignClientProtocol { self?.socketConnectionStatusPublisherSubject.send(status) }.store(in: &publishers) } + + private func registerMethods() { + Task { await pairingClient.register(supportedMethods: [SessionProposeProtocolMethod().method, SessionAuthenticatedProtocolMethod().method])} + } } diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 2e16a652d..ea702376a 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -5,9 +5,10 @@ public struct WalletConnectURI: Equatable { public let version: String public let symKey: String public let relay: RelayProtocolOptions + public let methods: [[String]]? public var absoluteString: String { - return "wc:\(topic)@\(version)?symKey=\(symKey)&\(relayQuery)" + return "wc:\(topic)@\(version)?\(queryString)" } public var deeplinkUri: String { @@ -15,13 +16,24 @@ public struct WalletConnectURI: Equatable { .addingPercentEncoding(withAllowedCharacters: .rfc3986) ?? absoluteString } - public init(topic: String, symKey: String, relay: RelayProtocolOptions) { + public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [[String]]) { self.version = "2" self.topic = topic self.symKey = symKey self.relay = relay + self.methods = methods } + #if DEBUG + public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [[String]]? = nil) { + self.version = "2" + self.topic = topic + self.symKey = symKey + self.relay = relay + self.methods = methods + } + #endif + public init?(string: String) { guard let components = Self.parseURIComponents(from: string) else { return nil @@ -36,14 +48,18 @@ public struct WalletConnectURI: Equatable { else { return nil } + let relayData = query?["relay-data"] + let methodsString = query?["methods"] + let methods = methodsString?.components(separatedBy: "],[").map { $0.trimmingCharacters(in: CharacterSet(charactersIn: "[]")).components(separatedBy: ",") } self.version = version self.topic = topic self.symKey = symKey self.relay = RelayProtocolOptions(protocol: relayProtocol, data: relayData) + self.methods = methods } - + public init?(deeplinkUri: URL) { if let deeplinkUri = deeplinkUri.query?.replacingOccurrences(of: "uri=", with: "") { self.init(string: deeplinkUri) @@ -51,23 +67,32 @@ public struct WalletConnectURI: Equatable { return nil } - private var relayQuery: String { - var query = "relay-protocol=\(relay.protocol)" + private var queryString: String { + var parts = ["symKey=\(symKey)", "relay-protocol=\(relay.protocol)"] if let relayData = relay.data { - query = "\(query)&relay-data=\(relayData)" + parts.append("relay-data=\(relayData)") + } + if let methods = methods { + let encodedMethods = methods.map { "[\($0.joined(separator: ","))]" }.joined(separator: ",") + parts.append("methods=\(encodedMethods)") } - return query + return parts.joined(separator: "&") } private static func parseURIComponents(from string: String) -> URLComponents? { guard string.hasPrefix("wc:") else { return nil } - let urlString = !string.hasPrefix("wc://") ? string.replacingOccurrences(of: "wc:", with: "wc://") : string + var urlString = string + if !string.hasPrefix("wc://") { + urlString = string.replacingOccurrences(of: "wc:", with: "wc://") + } return URLComponents(string: urlString) } } + + #if canImport(UIKit) import UIKit diff --git a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift index 67ee5dfe9..462a4cf7d 100644 --- a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift +++ b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift @@ -4,10 +4,12 @@ import WalletConnectUtils extension WalletConnectURI { public static func stub(isController: Bool = false) -> WalletConnectURI { - WalletConnectURI( + let methods = [["wc_sessionPropose", "wc_sessionAuthenticated"], ["wc_authRequest"]] + return WalletConnectURI( topic: String.generateTopic(), symKey: SymmetricKey().hexRepresentation, - relay: RelayProtocolOptions(protocol: "", data: nil) + relay: RelayProtocolOptions(protocol: "", data: nil), + methods: methods ) } } diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index 5f65b5c28..8a810885e 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -1,15 +1,23 @@ import XCTest @testable import WalletConnectUtils -private func stubURI() -> (uri: WalletConnectURI, string: String) { +private func stubURI(includeMethods: Bool = true) -> (uri: WalletConnectURI, string: String) { let topic = Data.randomBytes(count: 32).toHexString() let symKey = Data.randomBytes(count: 32).toHexString() let protocolName = "irn" - let uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)" + var uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)" + let methods = [["wc_sessionPropose", "wc_sessionAuthenticated"], ["wc_authRequest"]] + if includeMethods { + let methodsString = methods + .map { $0.joined(separator: ",") } + .joined(separator: "],[") + uriString.append("&methods=[\(methodsString)]") + } let uri = WalletConnectURI( topic: topic, symKey: symKey, - relay: RelayProtocolOptions(protocol: protocolName, data: nil)) + relay: RelayProtocolOptions(protocol: protocolName, data: nil), + methods: includeMethods ? methods : nil) return (uri, uriString) } @@ -67,4 +75,45 @@ final class WalletConnectURITests: XCTestCase { let uri = WalletConnectURI(string: inputURIString) XCTAssertNil(uri) } + + func testInitURIWithStringIncludingMethods() { + let (expectedURI, uriStringWithMethods) = stubURI() + guard let uri = WalletConnectURI(string: uriStringWithMethods) else { + XCTFail("Initialization of URI failed") + return + } + XCTAssertEqual(uri.methods, expectedURI.methods) + XCTAssertEqual(uri.topic, expectedURI.topic) + XCTAssertEqual(uri.symKey, expectedURI.symKey) + XCTAssertEqual(uri.relay.protocol, expectedURI.relay.protocol) + XCTAssertEqual(uri.absoluteString, expectedURI.absoluteString) + } + + func testDeeplinkURIIncludingMethods() { + let (expectedURI, _) = stubURI() + let deeplinkURIWithMethods = expectedURI.deeplinkUri + guard let uri = WalletConnectURI(deeplinkUri: URL(string: deeplinkURIWithMethods)!) else { + XCTFail("Initialization of URI from deeplink failed") + return + } + XCTAssertEqual(uri.methods, expectedURI.methods) + XCTAssertEqual(uri.topic, expectedURI.topic) + XCTAssertEqual(uri.symKey, expectedURI.symKey) + XCTAssertEqual(uri.relay.protocol, expectedURI.relay.protocol) + XCTAssertEqual(uri.deeplinkUri, expectedURI.deeplinkUri) + } + + func testInitURIWithStringExcludingMethods() { + let (expectedURI, uriStringWithoutMethods) = stubURI(includeMethods: false) + guard let uri = WalletConnectURI(string: uriStringWithoutMethods) else { + XCTFail("Initialization of URI failed") + return + } + + XCTAssertNil(uri.methods) + XCTAssertEqual(uri.topic, expectedURI.topic) + XCTAssertEqual(uri.symKey, expectedURI.symKey) + XCTAssertEqual(uri.relay.protocol, expectedURI.relay.protocol) + XCTAssertEqual(uri.absoluteString, expectedURI.absoluteString) + } } diff --git a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift index 562e01ef5..70e10c4f8 100644 --- a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift @@ -18,4 +18,8 @@ final class PairingClientMock: PairingClientProtocol { func getPairings() -> [Pairing] { return [Pairing(topic: "", peer: nil, expiryDate: Date())] } + + func register(supportedMethods: [String]) async { + + } } diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index 62ba27489..7bf371038 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -94,10 +94,22 @@ final class SignClientMock: SignClientProtocol { approveCalled = true } - func reject(proposalId: String, reason: WalletConnectSign.RejectionReason) async throws { + func rejectSession(proposalId: String, reason: WalletConnectSign.RejectionReason) async throws { rejectCalled = true } - + + func rejectSession(requestId: JSONRPC.RPCID) async throws { + fatalError("TODO") + } + + func respondSessionAuthenticated(requestId: JSONRPC.RPCID, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) async throws { + fatalError("TODO") + } + + func getPendingAuthRequests() throws -> [(WalletConnectSign.AuthenticationRequest, WalletConnectSign.VerifyContext?)] { + fatalError("TODO") + } + func update(topic: String, namespaces: [String : WalletConnectSign.SessionNamespace]) async throws { updateCalled = true } diff --git a/Tests/Web3WalletTests/Web3WalletTests.swift b/Tests/Web3WalletTests/Web3WalletTests.swift index 39165751d..8a24a5cfc 100644 --- a/Tests/Web3WalletTests/Web3WalletTests.swift +++ b/Tests/Web3WalletTests/Web3WalletTests.swift @@ -154,7 +154,7 @@ final class Web3WalletTests: XCTestCase { } func testRejectSessionCalled() async { - try! await web3WalletClient.reject(proposalId: "", reason: .userRejected) + try! await web3WalletClient.rejectSession(proposalId: "", reason: .userRejected) XCTAssertTrue(signClient.rejectCalled) } From e82dbce375d199b68f8c070b6cb164d7f9aaf3b4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 Nov 2023 14:47:38 +0100 Subject: [PATCH 013/814] fix build, add schemas --- .../xcschemes/WalletConnectSignTests.xcscheme | 53 +++++++++++++++++++ .../WalletConnectUtilsTests.xcscheme | 53 +++++++++++++++++++ Package.swift | 2 +- .../WalletConnectSign/Auth/AuthImports.swift | 5 -- .../WalletConnectSign/Sign/SignImports.swift | 1 + 5 files changed, 108 insertions(+), 6 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme delete mode 100644 Sources/WalletConnectSign/Auth/AuthImports.swift diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme new file mode 100644 index 000000000..c46b7d1f2 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme new file mode 100644 index 000000000..1f3a0b519 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Package.swift b/Package.swift index edc0d65fe..ac3b07d5d 100644 --- a/Package.swift +++ b/Package.swift @@ -58,7 +58,7 @@ let package = Package( targets: [ .target( name: "WalletConnectSign", - dependencies: ["WalletConnectPairing", "WalletConnectVerify"], + dependencies: ["WalletConnectPairing", "WalletConnectVerify", "WalletConnectSigner"], path: "Sources/WalletConnectSign"), .target( name: "WalletConnectChat", diff --git a/Sources/WalletConnectSign/Auth/AuthImports.swift b/Sources/WalletConnectSign/Auth/AuthImports.swift deleted file mode 100644 index 91463cad3..000000000 --- a/Sources/WalletConnectSign/Auth/AuthImports.swift +++ /dev/null @@ -1,5 +0,0 @@ -#if !CocoaPods -@_exported import WalletConnectPairing -@_exported import WalletConnectSigner -@_exported import WalletConnectVerify -#endif diff --git a/Sources/WalletConnectSign/Sign/SignImports.swift b/Sources/WalletConnectSign/Sign/SignImports.swift index b60ea566a..91463cad3 100644 --- a/Sources/WalletConnectSign/Sign/SignImports.swift +++ b/Sources/WalletConnectSign/Sign/SignImports.swift @@ -1,4 +1,5 @@ #if !CocoaPods @_exported import WalletConnectPairing +@_exported import WalletConnectSigner @_exported import WalletConnectVerify #endif From 02ec03d6e7d2ff99535159950bc825e8f3a0e1c8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 Nov 2023 15:13:25 +0100 Subject: [PATCH 014/814] savepoint --- .../WalletConnectURITests.swift | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index 8a810885e..b671cc233 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -89,20 +89,6 @@ final class WalletConnectURITests: XCTestCase { XCTAssertEqual(uri.absoluteString, expectedURI.absoluteString) } - func testDeeplinkURIIncludingMethods() { - let (expectedURI, _) = stubURI() - let deeplinkURIWithMethods = expectedURI.deeplinkUri - guard let uri = WalletConnectURI(deeplinkUri: URL(string: deeplinkURIWithMethods)!) else { - XCTFail("Initialization of URI from deeplink failed") - return - } - XCTAssertEqual(uri.methods, expectedURI.methods) - XCTAssertEqual(uri.topic, expectedURI.topic) - XCTAssertEqual(uri.symKey, expectedURI.symKey) - XCTAssertEqual(uri.relay.protocol, expectedURI.relay.protocol) - XCTAssertEqual(uri.deeplinkUri, expectedURI.deeplinkUri) - } - func testInitURIWithStringExcludingMethods() { let (expectedURI, uriStringWithoutMethods) = stubURI(includeMethods: false) guard let uri = WalletConnectURI(string: uriStringWithoutMethods) else { From bcc4732d328da871c77bf205c7338720688772de Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 Nov 2023 21:22:12 +0100 Subject: [PATCH 015/814] lock session propose when authenticatedSession is supported --- Sources/WalletConnectPairing/Types/WCPairing.swift | 2 ++ Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 6 ++++++ 2 files changed, 8 insertions(+) diff --git a/Sources/WalletConnectPairing/Types/WCPairing.swift b/Sources/WalletConnectPairing/Types/WCPairing.swift index d87bd8946..4a47615db 100644 --- a/Sources/WalletConnectPairing/Types/WCPairing.swift +++ b/Sources/WalletConnectPairing/Types/WCPairing.swift @@ -12,6 +12,7 @@ public struct WCPairing: SequenceObject { public private (set) var expiryDate: Date public private (set) var active: Bool public private (set) var requestReceived: Bool + public private (set) var methods: [[String]]? #if DEBUG public static var dateInitializer: () -> Date = Date.init @@ -50,6 +51,7 @@ public struct WCPairing: SequenceObject { self.active = false self.requestReceived = false self.expiryDate = Self.dateInitializer().advanced(by: Self.timeToLiveInactive) + self.methods = uri.methods } public mutating func activate() { diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 7e26a2725..6c0527e7e 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -186,6 +186,12 @@ private extension ApproveEngine { func setupRequestSubscriptions() { pairingRegisterer.register(method: SessionProposeProtocolMethod()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in + guard let pairing = pairingStore.getPairing(forTopic: payload.topic) else { return } + if let methods = pairing.methods, + methods.flatMap({ $0 }) + .contains(SessionAuthenticatedProtocolMethod().method) { + return + } handleSessionProposeRequest(payload: payload) }.store(in: &publishers) From 3c1e8829a6d8202298f5c7cfa5a4e6e95bc95b90 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 7 Nov 2023 07:13:32 +0100 Subject: [PATCH 016/814] add testEIP191SessionAuthenticated --- .../Sign/SignClientTests.swift | 31 +++++++++++++++++-- .../App/SessionAuthRequestService.swift | 5 +-- .../Auth/Types/RequestParams.swift | 25 +++++++++++++++ .../Engine/Common/ApproveEngine.swift | 1 + .../WalletConnectSign/Sign/SignClient.swift | 5 ++- 5 files changed, 61 insertions(+), 6 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 83ee44e10..65e2ca3ce 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -15,7 +15,9 @@ final class SignClientTests: XCTestCase { var wallet: SignClient! var walletPairingClient: PairingClient! private var publishers = Set() - + let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! + let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") + let eip1271Signature = "0xc1505719b2504095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" static private func makeClients(name: String) -> (PairingClient, SignClient) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) @@ -88,7 +90,7 @@ final class SignClientTests: XCTestCase { dapp.sessionSettlePublisher.sink { _ in dappSettlementExpectation.fulfill() }.store(in: &publishers) - dapp.sessionSettlePublisher.sink { _ in + wallet.sessionSettlePublisher.sink { _ in walletSettlementExpectation.fulfill() }.store(in: &publishers) @@ -759,7 +761,30 @@ final class SignClientTests: XCTestCase { } - func testSessionAuthenticated() async throws { + func testEIP191SessionAuthenticated() async throws { + let responseExpectation = expectation(description: "successful response delivered") + + wallet.authRequestPublisher.sink { [unowned self] request in + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) + let payload = try! request.0.payload.cacaoPayload(address: walletAccount.address) + let signature = try! signer.sign(payload: payload, privateKey: prvKey, type: .eip191) + try! await wallet.respondSessionAuthenticated(requestId: request.0.id, signature: signature, account: walletAccount) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success = result else { XCTFail(); return } + responseExpectation.fulfill() + } + .store(in: &publishers) + + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + try await walletPairingClient.pair(uri: uri) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index ddccf8bea..11c7a4a11 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -22,13 +22,14 @@ actor SessionAuthRequestService { func request(params: RequestParams, topic: String) async throws { let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() + let protocolMethod = SessionAuthenticatedProtocolMethod() let requester = AuthRequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) let payload = AuthenticationPayload(requestParams: params, iat: iatProvader.iat) let params = AuthRequestParams(requester: requester, payloadParams: payload) - let request = RPCRequest(method: "wc_authRequest", params: params) + let request = RPCRequest(method: protocolMethod.method, params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") - try await networkingInteractor.request(request, topic: topic, protocolMethod: SessionAuthenticatedProtocolMethod()) + try await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) try await networkingInteractor.subscribe(topic: responseTopic) } } diff --git a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift index 1f57884a9..2920de28d 100644 --- a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift @@ -37,3 +37,28 @@ public struct RequestParams { self.resources = resources } } + + +#if DEBUG +extension RequestParams { + static func stub(domain: String = "service.invalid", + chainId: String = "eip155:1", + nonce: String = "32891756", + aud: String = "https://service.invalid/login", + nbf: String? = nil, + exp: String? = nil, + statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", + requestId: String? = nil, + resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"]) -> RequestParams { + return RequestParams(domain: domain, + chainId: chainId, + nonce: nonce, + aud: aud, + nbf: nbf, + exp: exp, + statement: statement, + requestId: requestId, + resources: resources) + } +} +#endif diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 6c0527e7e..6ce9fee18 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -190,6 +190,7 @@ private extension ApproveEngine { if let methods = pairing.methods, methods.flatMap({ $0 }) .contains(SessionAuthenticatedProtocolMethod().method) { + // respond with an error? return } handleSessionProposeRequest(payload: payload) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 4b21bcd99..2a8647198 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -207,7 +207,6 @@ public final class SignClient: SignClientProtocol { setUpConnectionObserving() setUpEnginesCallbacks() - registerMethods() } // MARK: - Public interface @@ -259,6 +258,10 @@ public final class SignClient: SignClientProtocol { ) } + public func enableAuthenticatedSessions() { + registerMethods() + } + /// For a wallet to respond on authentication request /// - Parameters: From c0a1b5971bb640b8e6364e6c5eda417e08245dbb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 7 Nov 2023 11:56:36 +0100 Subject: [PATCH 017/814] savepoint --- .../Sign/SignClientTests.swift | 35 +++++++++++++++++++ .../Engine/Common/ApproveEngine.swift | 1 + 2 files changed, 36 insertions(+) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 65e2ca3ce..94586c364 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -787,4 +787,39 @@ final class SignClientTests: XCTestCase { try await walletPairingClient.pair(uri: uri) wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } + + func testEIP1271SessionAuthenticated() async throws { + + let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! + + let responseExpectation = expectation(description: "successful response delivered") + let uri = try! await dappPairingClient.create() + try! await dapp.authenticate(RequestParams( + domain: "localhost", + chainId: "eip155:1", + nonce: "1665443015700", + aud: "http://localhost:3000/", + nbf: nil, + exp: "2022-10-11T23:03:35.700Z", + statement: nil, + requestId: nil, + resources: nil + ), topic: uri.topic) + + try await walletPairingClient.pair(uri: uri) + + wallet.authRequestPublisher.sink { [unowned self] request in + Task(priority: .high) { + let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) + try! await wallet.respondSessionAuthenticated(requestId: request.0.id, signature: signature, account: account) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success = result else { XCTFail(); return } + responseExpectation.fulfill() + } + .store(in: &publishers) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + } } diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 6ce9fee18..567627aa3 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -190,6 +190,7 @@ private extension ApproveEngine { if let methods = pairing.methods, methods.flatMap({ $0 }) .contains(SessionAuthenticatedProtocolMethod().method) { + logger.debug("Ignoring Session Proposal") // respond with an error? return } From 6cbc4b3ed76f01acb46dfeb8f4a14c97cdec8836 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 7 Nov 2023 13:39:52 +0100 Subject: [PATCH 018/814] move all auth tests to sign --- .../IntegrationTests.xctestplan | 1 + .../Sign/SignClientTests.swift | 72 ++++++++++++++++++- ...ber.swift => AuthResponseSubscriber.swift} | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 10 +-- .../Sign/SignClientFactory.swift | 2 +- .../Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 4 +- 7 files changed, 81 insertions(+), 12 deletions(-) rename Sources/WalletConnectSign/Auth/Services/App/{AppRespondSubscriber.swift => AuthResponseSubscriber.swift} (99%) diff --git a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan index 40b79df1d..955607e33 100644 --- a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan +++ b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan @@ -58,6 +58,7 @@ "ChatTests", "ENSResolverTests", "HistoryTests", + "SignClientTests\/testEIP1271SessionAuthenticated()", "SyncDerivationServiceTests", "SyncTests" ], diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 94586c364..24cf6bb3b 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -770,7 +770,7 @@ final class SignClientTests: XCTestCase { let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) let payload = try! request.0.payload.cacaoPayload(address: walletAccount.address) let signature = try! signer.sign(payload: payload, privateKey: prvKey, type: .eip191) - try! await wallet.respondSessionAuthenticated(requestId: request.0.id, signature: signature, account: walletAccount) + try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: signature, account: walletAccount) } } .store(in: &publishers) @@ -811,7 +811,7 @@ final class SignClientTests: XCTestCase { wallet.authRequestPublisher.sink { [unowned self] request in Task(priority: .high) { let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await wallet.respondSessionAuthenticated(requestId: request.0.id, signature: signature, account: account) + try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: signature, account: account) } } .store(in: &publishers) @@ -822,4 +822,72 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } + + func testEIP191RespondError() async { + let responseExpectation = expectation(description: "error response delivered") + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + + try? await walletPairingClient.pair(uri: uri) + wallet.authRequestPublisher.sink { [unowned self] request in + Task(priority: .high) { + let invalidSignature = CacaoSignature(t: .eip1271, s: eip1271Signature) + try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: invalidSignature, account: walletAccount) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case let .failure(error) = result, error == .signatureVerificationFailed else { XCTFail(); return } + responseExpectation.fulfill() + } + .store(in: &publishers) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + + func testUserRespondError() async { + let responseExpectation = expectation(description: "error response delivered") + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + + try? await walletPairingClient.pair(uri: uri) + wallet.authRequestPublisher.sink { [unowned self] request in + Task(priority: .high) { + try! await wallet.rejectSession(requestId: request.0.id) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .failure(let error) = result else { XCTFail(); return } + XCTAssertEqual(error, .userRejeted) + responseExpectation.fulfill() + } + .store(in: &publishers) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + + func testRespondSignatureVerificationFailed() async { + let responseExpectation = expectation(description: "invalid signature response delivered") + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + + try? await walletPairingClient.pair(uri: uri) + wallet.authRequestPublisher.sink { [unowned self] request in + Task(priority: .high) { + let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" + let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) + try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: cacaoSignature, account: walletAccount) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .failure(let error) = result else { XCTFail(); return } + XCTAssertEqual(error, .signatureVerificationFailed) + responseExpectation.fulfill() + } + .store(in: &publishers) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift similarity index 99% rename from Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift rename to Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index d3995e02f..6bb77f2a2 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -1,7 +1,7 @@ import Foundation import Combine -class AppRespondSubscriber { +class AuthResponseSubscriber { private let networkingInteractor: NetworkInteracting private let logger: ConsoleLogging private let rpcHistory: RPCHistory diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 2a8647198..36287563c 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -137,7 +137,7 @@ public final class SignClient: SignClientProtocol { //Auth private let appRequestService: SessionAuthRequestService - private let appRespondSubscriber: AppRespondSubscriber + private let authResposeSubscriber: AuthResponseSubscriber private let authRequestSubscriber: AuthRequestSubscriber private let authResponder: AuthResponder private let pendingRequestsProvider: PendingRequestsProvider @@ -178,7 +178,7 @@ public final class SignClient: SignClientProtocol { cleanupService: SignCleanupService, pairingClient: PairingClient, appRequestService: SessionAuthRequestService, - appRespondSubscriber: AppRespondSubscriber, + appRespondSubscriber: AuthResponseSubscriber, authRequestSubscriber: AuthRequestSubscriber, authResponder: AuthResponder, pendingRequestsProvider: PendingRequestsProvider @@ -202,7 +202,7 @@ public final class SignClient: SignClientProtocol { self.appRequestService = appRequestService self.authRequestSubscriber = authRequestSubscriber self.authResponder = authResponder - self.appRespondSubscriber = appRespondSubscriber + self.authResposeSubscriber = appRespondSubscriber self.pendingRequestsProvider = pendingRequestsProvider setUpConnectionObserving() @@ -267,7 +267,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { + public func respondSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { try await authResponder.respond(requestId: requestId, signature: signature, account: account) } @@ -467,7 +467,7 @@ public final class SignClient: SignClientProtocol { sessionEngine.onSessionsUpdate = { [unowned self] sessions in sessionsPublisherSubject.send(sessions) } - appRespondSubscriber.onResponse = { [unowned self] (id, result) in + authResposeSubscriber.onResponse = { [unowned self] (id, result) in authResponsePublisherSubject.send((id, result)) } authRequestSubscriber.onRequest = { [unowned self] request in diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index b25836dd4..5cf76515b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -90,7 +90,7 @@ public struct SignClientFactory { let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) - let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, messageFormatter: messageFormatter) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, messageFormatter: messageFormatter) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient) diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 223872cab..3b072db59 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -19,7 +19,7 @@ public protocol SignClientProtocol { func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws - func respondSessionAuthenticated(requestId: RPCID, signature: CacaoSignature, account: Account) async throws + func respondSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index dec94371e..c47cc7ad0 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -185,8 +185,8 @@ public class Web3WalletClient { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func respondSessionAuthenticated(requestId: RPCID, signature: WalletConnectSign.CacaoSignature, from account: Account) async throws { - try await signClient.respondSessionAuthenticated(requestId: requestId, signature: signature, account: account) + public func respondSessionAuthenticate(requestId: RPCID, signature: WalletConnectSign.CacaoSignature, from account: Account) async throws { + try await signClient.respondSessionAuthenticate(requestId: requestId, signature: signature, account: account) } /// For wallet to reject authentication request From 681c1e58c18ea114ecd29996734d46bb0129c5ff Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 21 Nov 2023 13:36:36 +0100 Subject: [PATCH 019/814] add migration to CodableStore --- .../xcshareddata/swiftpm/Package.resolved | 4 ++-- .../Client/Wallet/NotifyClientFactory.swift | 3 --- .../Sign/SignClientFactory.swift | 4 ++-- Sources/WalletConnectUtils/CodableStore.swift | 22 +++++++++++++++++++ .../WalletConnectUtils/KeyValueStorage.swift | 8 +++++++ 5 files changed, 34 insertions(+), 7 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index dceba93f5..229e0f8ef 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "831410cfd6e68afa7212a5547483fb2d180f0fa7", - "version": "1.0.10" + "revision": "e68c1b1560264965ca13608db44294d301c6404f", + "version": "1.0.9" } } ] diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 807927a7f..96728d9e9 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -4,7 +4,6 @@ public struct NotifyClientFactory { public static func create(projectId: String, groupIdentifier: String, networkInteractor: NetworkInteracting, pairingRegisterer: PairingRegisterer, pushClient: PushClient, crypto: CryptoProvider, notifyHost: String, explorerHost: String) -> NotifyClient { let logger = ConsoleLogger(prefix: "🔔",loggingLevel: .debug) - let keyValueStorage = UserDefaults.standard let keyserverURL = URL(string: "https://keys.walletconnect.com")! let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") let groupKeychainService = GroupKeychainStorage(serviceIdentifier: groupIdentifier) @@ -16,7 +15,6 @@ public struct NotifyClientFactory { keyserverURL: keyserverURL, sqlite: sqlite, logger: logger, - keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, groupKeychainStorage: groupKeychainService, networkInteractor: networkInteractor, @@ -33,7 +31,6 @@ public struct NotifyClientFactory { keyserverURL: URL, sqlite: Sqlite, logger: ConsoleLogging, - keyValueStorage: KeyValueStorage, keychainStorage: KeychainStorageProtocol, groupKeychainStorage: KeychainStorageProtocol, networkInteractor: NetworkInteracting, diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index cfaaf355f..9ae83c99b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -11,9 +11,9 @@ public struct SignClientFactory { /// - keyValueStorage: by default WalletConnect SDK will store sequences in UserDefaults /// /// WalletConnect Client is not a singleton but once you create an instance, you should not deinitialize it. Usually only one instance of a client is required in the application. - public static func create(metadata: AppMetadata, pairingClient: PairingClient, networkingClient: NetworkingInteractor) -> SignClient { + public static func create(metadata: AppMetadata, pairingClient: PairingClient, networkingClient: NetworkingInteractor, groupIdentifier: String) -> SignClient { let logger = ConsoleLogger(loggingLevel: .debug) - let keyValueStorage = UserDefaults.standard + let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return SignClientFactory.create(metadata: metadata, logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, pairingClient: pairingClient, networkingClient: networkingClient) } diff --git a/Sources/WalletConnectUtils/CodableStore.swift b/Sources/WalletConnectUtils/CodableStore.swift index be876bd3e..c4a6b00c6 100644 --- a/Sources/WalletConnectUtils/CodableStore.swift +++ b/Sources/WalletConnectUtils/CodableStore.swift @@ -13,6 +13,7 @@ public final class CodableStore where T: Codable { public init(defaults: KeyValueStorage, identifier: String) { self.defaults = defaults self.prefix = identifier + migrateIfNeeded() } public func set(_ item: T, forKey key: String) { @@ -64,4 +65,25 @@ public final class CodableStore where T: Codable { return defaults.dictionaryRepresentation() .filter { $0.key.hasPrefix("\(prefix).") } } + + + private func migrateIfNeeded() { + let migrationKey = "hasMigratedToGroup" + if defaults as? UserDefaults != UserDefaults.standard && !defaults.bool(forKey: migrationKey) { + let oldStore = CodableStore(defaults: UserDefaults.standard, identifier: prefix) + + let oldItemsDictionary = oldStore.dictionaryForIdentifier() + + for (key, value) in oldItemsDictionary { + if let data = value as? Data { + defaults.set(data, forKey: key) + } + } + + defaults.set(true, forKey: migrationKey) + + storeUpdatePublisherSubject.send() + } + } + } diff --git a/Sources/WalletConnectUtils/KeyValueStorage.swift b/Sources/WalletConnectUtils/KeyValueStorage.swift index 0dd770fe2..be01639e1 100644 --- a/Sources/WalletConnectUtils/KeyValueStorage.swift +++ b/Sources/WalletConnectUtils/KeyValueStorage.swift @@ -12,6 +12,8 @@ public protocol KeyValueStorage { func removeObject(forKey defaultName: String) /// Returns a dictionary that contains a union of all key-value pairs in the domains in the search list. func dictionaryRepresentation() -> [String: Any] + + func bool(forKey defaultName: String) -> Bool } extension UserDefaults: KeyValueStorage {} @@ -53,4 +55,10 @@ public final class RuntimeKeyValueStorage: KeyValueStorage { return storage } } + + public func bool(forKey defaultName: String) -> Bool { + queue.sync { + return storage[defaultName] as? Bool ?? false + } + } } From 9a39564328802f8a7025a92c27612901b1786f63 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 21 Nov 2023 13:57:58 +0100 Subject: [PATCH 020/814] savepoint --- Sources/Auth/AuthClientFactory.swift | 2 +- .../NetworkingClientFactory.swift | 2 +- .../PairingClientFactory.swift | 2 +- .../WalletConnectPush/PushClientFactory.swift | 2 +- .../ClientAuth/ClientIdStorage.swift | 6 +++++ Sources/WalletConnectUtils/CodableStore.swift | 24 ++++++++++--------- 6 files changed, 23 insertions(+), 15 deletions(-) diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index dbddf2a53..eca2512d5 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -9,7 +9,7 @@ public struct AuthClientFactory { pairingRegisterer: PairingRegisterer ) -> AuthClient { let logger = ConsoleLogger(loggingLevel: .off) - let keyValueStorage = UserDefaults.standard + let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") let iatProvider = DefaultIATProvider() diff --git a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift index a5119544f..507dbf61d 100644 --- a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift +++ b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift @@ -4,7 +4,7 @@ public struct NetworkingClientFactory { public static func create(relayClient: RelayClient) -> NetworkingInteractor { let logger = ConsoleLogger(prefix: "🕸️", loggingLevel: .off) - let keyValueStorage = UserDefaults.standard + let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return NetworkingClientFactory.create(relayClient: relayClient, logger: logger, keychainStorage: keychainStorage, keyValueStorage: keyValueStorage) } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index ba49bb6af..8741f8195 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -4,7 +4,7 @@ public struct PairingClientFactory { public static func create(networkingClient: NetworkingInteractor) -> PairingClient { let logger = ConsoleLogger(loggingLevel: .off) - let keyValueStorage = UserDefaults.standard + let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return PairingClientFactory.create(logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, networkingClient: networkingClient) } diff --git a/Sources/WalletConnectPush/PushClientFactory.swift b/Sources/WalletConnectPush/PushClientFactory.swift index fb2fb0d10..d24b302cc 100644 --- a/Sources/WalletConnectPush/PushClientFactory.swift +++ b/Sources/WalletConnectPush/PushClientFactory.swift @@ -6,7 +6,7 @@ public struct PushClientFactory { environment: APNSEnvironment) -> PushClient { let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") - let keyValueStorage = UserDefaults.standard + let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard return PushClientFactory.create( projectId: projectId, diff --git a/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift b/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift index e07333198..86c01cb47 100644 --- a/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift +++ b/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift @@ -62,6 +62,12 @@ private extension ClientIdStorage { } catch { logger.debug("ClientID migration failed with: \(error.localizedDescription)") } + } + + func migrateToGroupDefaultsIfNeeded() { + + + } func getPublicPart() throws -> SigningPublicKey { diff --git a/Sources/WalletConnectUtils/CodableStore.swift b/Sources/WalletConnectUtils/CodableStore.swift index c4a6b00c6..c4c1de587 100644 --- a/Sources/WalletConnectUtils/CodableStore.swift +++ b/Sources/WalletConnectUtils/CodableStore.swift @@ -4,6 +4,7 @@ import Combine public final class CodableStore where T: Codable { private let defaults: KeyValueStorage private let prefix: String + private let migrationQueue = DispatchQueue(label: "com.walletconnect.CodableStore.migration") public var storeUpdatePublisher: AnyPublisher { storeUpdatePublisherSubject.eraseToAnyPublisher() @@ -68,22 +69,23 @@ public final class CodableStore where T: Codable { private func migrateIfNeeded() { - let migrationKey = "hasMigratedToGroup" - if defaults as? UserDefaults != UserDefaults.standard && !defaults.bool(forKey: migrationKey) { - let oldStore = CodableStore(defaults: UserDefaults.standard, identifier: prefix) + migrationQueue.sync { + let migrationKey = "hasMigratedToGroup_\(prefix)" + if defaults as? UserDefaults != UserDefaults.standard && !defaults.bool(forKey: migrationKey) { + let oldStore = CodableStore(defaults: UserDefaults.standard, identifier: prefix) - let oldItemsDictionary = oldStore.dictionaryForIdentifier() + let oldItemsDictionary = oldStore.dictionaryForIdentifier() - for (key, value) in oldItemsDictionary { - if let data = value as? Data { - defaults.set(data, forKey: key) + for (key, value) in oldItemsDictionary { + if let data = value as? Data { + defaults.set(data, forKey: key) + } } - } - defaults.set(true, forKey: migrationKey) + defaults.set(true, forKey: migrationKey) - storeUpdatePublisherSubject.send() + storeUpdatePublisherSubject.send() + } } } - } From 6e3cb99f8fca4bd51159c65b6a9c223a46853be5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 22 Nov 2023 08:43:30 +0100 Subject: [PATCH 021/814] add group identifier to clients --- Example/DApp/SceneDelegate.swift | 9 +++++++-- Example/IntegrationTests/Push/NotifyTests.swift | 1 - .../ApplicationLayer/ConfigurationService.swift | 6 +++++- Sources/Auth/Auth.swift | 3 ++- Sources/Auth/AuthClientFactory.swift | 3 ++- .../WalletConnectNetworking/Networking.swift | 13 +++++++++++-- .../NetworkingClientFactory.swift | 5 ++++- .../NetworkingConfig.swift | 1 + Sources/WalletConnectNotify/Notify+Config.swift | 1 - Sources/WalletConnectNotify/Notify.swift | 4 ++-- Sources/WalletConnectPairing/Pair.swift | 2 +- Sources/WalletConnectPairing/PairConfig.swift | 6 +----- .../PairingClientFactory.swift | 12 ++++++++++-- Sources/WalletConnectPush/Push.swift | 1 + .../WalletConnectPush/PushClientFactory.swift | 9 ++++++--- Sources/WalletConnectSign/Sign/Sign.swift | 17 +++-------------- .../Sign/SignClientFactory.swift | 16 ++++++++++++++-- 17 files changed, 70 insertions(+), 39 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 2586a7fd9..c08b15a8b 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -11,7 +11,11 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { private let app = Application() func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { - Networking.configure(projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory()) + Networking.configure( + groupIdentifier: "group.com.walletconnect.sdk", + projectId: InputConfig.projectId, + socketFactory: DefaultSocketFactory() + ) Auth.configure(crypto: DefaultCryptoProvider()) let metadata = AppMetadata( @@ -23,7 +27,8 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) Web3Modal.configure( - projectId: InputConfig.projectId, + projectId: InputConfig.projectId, + chainId: Blockchain("eip155:1")!, metadata: metadata ) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 006631957..2b4a993bf 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -80,7 +80,6 @@ final class NotifyTests: XCTestCase { keyserverURL: keyserverURL, sqlite: sqlite, logger: notifyLogger, - keyValueStorage: keyValueStorage, keychainStorage: keychain, groupKeychainStorage: KeychainStorageMock(), networkInteractor: networkingInteractor, diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 01fe59d9c..d8cfd3afe 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -6,7 +6,11 @@ import Web3Wallet final class ConfigurationService { func configure(importAccount: ImportAccount) { - Networking.configure(projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory()) + Networking.configure( + groupIdentifier: "group.com.walletconnect.sdk", + projectId: InputConfig.projectId, + socketFactory: DefaultSocketFactory() + ) Networking.instance.setLogging(level: .debug) let metadata = AppMetadata( diff --git a/Sources/Auth/Auth.swift b/Sources/Auth/Auth.swift index fb91ed780..044e92bd8 100644 --- a/Sources/Auth/Auth.swift +++ b/Sources/Auth/Auth.swift @@ -28,7 +28,8 @@ public class Auth { projectId: Networking.projectId, crypto: config.crypto, networkingClient: Networking.interactor, - pairingRegisterer: Pair.registerer + pairingRegisterer: Pair.registerer, + groupIdentifier: Networking.groupIdentifier ) }() diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index eca2512d5..da5bf4025 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -6,7 +6,8 @@ public struct AuthClientFactory { projectId: String, crypto: CryptoProvider, networkingClient: NetworkingInteractor, - pairingRegisterer: PairingRegisterer + pairingRegisterer: PairingRegisterer, + groupIdentifier: String ) -> AuthClient { let logger = ConsoleLogger(loggingLevel: .off) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard diff --git a/Sources/WalletConnectNetworking/Networking.swift b/Sources/WalletConnectNetworking/Networking.swift index 2cb6ded83..ea4e8a7de 100644 --- a/Sources/WalletConnectNetworking/Networking.swift +++ b/Sources/WalletConnectNetworking/Networking.swift @@ -8,13 +8,20 @@ public class Networking { } public static var interactor: NetworkingInteractor = { - guard let _ = Networking.config else { + guard let config = Networking.config else { fatalError("Error - you must call Networking.configure(_:) before accessing the shared instance.") } - return NetworkingClientFactory.create(relayClient: Relay.instance) + return NetworkingClientFactory.create(relayClient: Relay.instance, groupIdentifier: config.groupIdentifier) }() + public static var groupIdentifier: String { + guard let config = Networking.config else { + fatalError("Error - you must call Networking.configure(_:) before accessing the shared instance.") + } + return config.groupIdentifier + } + public static var projectId: String { guard let projectId = config?.projectId else { fatalError("Error - you must configure projectId with Networking.configure(_:)") @@ -34,12 +41,14 @@ public class Networking { /// - socketConnectionType: socket connection type static public func configure( relayHost: String = "relay.walletconnect.com", + groupIdentifier: String, projectId: String, socketFactory: WebSocketFactory, socketConnectionType: SocketConnectionType = .automatic ) { Networking.config = Networking.Config( relayHost: relayHost, + groupIdentifier: groupIdentifier, projectId: projectId, socketFactory: socketFactory, socketConnectionType: socketConnectionType diff --git a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift index 507dbf61d..b1d159c31 100644 --- a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift +++ b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift @@ -2,7 +2,10 @@ import Foundation public struct NetworkingClientFactory { - public static func create(relayClient: RelayClient) -> NetworkingInteractor { + public static func create( + relayClient: RelayClient, + groupIdentifier: String + ) -> NetworkingInteractor { let logger = ConsoleLogger(prefix: "🕸️", loggingLevel: .off) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") diff --git a/Sources/WalletConnectNetworking/NetworkingConfig.swift b/Sources/WalletConnectNetworking/NetworkingConfig.swift index e77d3ac12..5bbb86184 100644 --- a/Sources/WalletConnectNetworking/NetworkingConfig.swift +++ b/Sources/WalletConnectNetworking/NetworkingConfig.swift @@ -3,6 +3,7 @@ import Foundation extension Networking { struct Config { let relayHost: String + let groupIdentifier: String let projectId: String let socketFactory: WebSocketFactory let socketConnectionType: SocketConnectionType diff --git a/Sources/WalletConnectNotify/Notify+Config.swift b/Sources/WalletConnectNotify/Notify+Config.swift index 4d1141022..1013de69b 100644 --- a/Sources/WalletConnectNotify/Notify+Config.swift +++ b/Sources/WalletConnectNotify/Notify+Config.swift @@ -3,7 +3,6 @@ import Foundation extension Notify { struct Config { let pushHost: String - let groupIdentifier: String let environment: APNSEnvironment let crypto: CryptoProvider let notifyHost: String diff --git a/Sources/WalletConnectNotify/Notify.swift b/Sources/WalletConnectNotify/Notify.swift index 2880d2ce5..a86ffc892 100644 --- a/Sources/WalletConnectNotify/Notify.swift +++ b/Sources/WalletConnectNotify/Notify.swift @@ -8,7 +8,7 @@ public class Notify { Push.configure(pushHost: config.pushHost, environment: config.environment) return NotifyClientFactory.create( projectId: Networking.projectId, - groupIdentifier: config.groupIdentifier, + groupIdentifier: Networking.groupIdentifier, networkInteractor: Networking.interactor, pairingRegisterer: Pair.registerer, pushClient: Push.instance, @@ -31,7 +31,7 @@ public class Notify { notifyHost: String = "notify.walletconnect.com", explorerHost: String = "explorer-api.walletconnect.com" ) { - Notify.config = Notify.Config(pushHost: pushHost, groupIdentifier: groupIdentifier, environment: environment, crypto: crypto, notifyHost: notifyHost, explorerHost: explorerHost) + Notify.config = Notify.Config(pushHost: pushHost, environment: environment, crypto: crypto, notifyHost: notifyHost, explorerHost: explorerHost) } } diff --git a/Sources/WalletConnectPairing/Pair.swift b/Sources/WalletConnectPairing/Pair.swift index 096d9f7db..08eafec7e 100644 --- a/Sources/WalletConnectPairing/Pair.swift +++ b/Sources/WalletConnectPairing/Pair.swift @@ -37,6 +37,6 @@ private extension Pair { guard let config = Pair.config else { fatalError("Error - you must call Pair.configure(_:) before accessing the shared instance.") } - return PairingClientFactory.create(networkingClient: Networking.interactor) + return PairingClientFactory.create(networkingClient: Networking.interactor, groupIdentifier: Networking.groupIdentifier) }() } diff --git a/Sources/WalletConnectPairing/PairConfig.swift b/Sources/WalletConnectPairing/PairConfig.swift index 38f7e35ed..df5cd020d 100644 --- a/Sources/WalletConnectPairing/PairConfig.swift +++ b/Sources/WalletConnectPairing/PairConfig.swift @@ -3,10 +3,6 @@ import Foundation extension Pair { public struct Config { - public let metadata: AppMetadata - - public init(metadata: AppMetadata) { - self.metadata = metadata - } + let metadata: AppMetadata } } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 8741f8195..6a7e8c852 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -2,14 +2,22 @@ import Foundation public struct PairingClientFactory { - public static func create(networkingClient: NetworkingInteractor) -> PairingClient { + public static func create( + networkingClient: NetworkingInteractor, + groupIdentifier: String + ) -> PairingClient { let logger = ConsoleLogger(loggingLevel: .off) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return PairingClientFactory.create(logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, networkingClient: networkingClient) } - public static func create(logger: ConsoleLogging, keyValueStorage: KeyValueStorage, keychainStorage: KeychainStorageProtocol, networkingClient: NetworkingInteractor) -> PairingClient { + public static func create( + logger: ConsoleLogging, + keyValueStorage: KeyValueStorage, + keychainStorage: KeychainStorageProtocol, + networkingClient: NetworkingInteractor + ) -> PairingClient { let pairingStore = PairingStorage(storage: SequenceStore(store: .init(defaults: keyValueStorage, identifier: PairStorageIdentifiers.pairings.rawValue))) let kms = KeyManagementService(keychain: keychainStorage) let history = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) diff --git a/Sources/WalletConnectPush/Push.swift b/Sources/WalletConnectPush/Push.swift index fe955d08e..80e8bce60 100644 --- a/Sources/WalletConnectPush/Push.swift +++ b/Sources/WalletConnectPush/Push.swift @@ -10,6 +10,7 @@ public class Push { return PushClientFactory.create( projectId: Networking.projectId, pushHost: config.pushHost, + groupIdentifier: Networking.groupIdentifier, environment: config.environment) }() diff --git a/Sources/WalletConnectPush/PushClientFactory.swift b/Sources/WalletConnectPush/PushClientFactory.swift index d24b302cc..60a3a9ad6 100644 --- a/Sources/WalletConnectPush/PushClientFactory.swift +++ b/Sources/WalletConnectPush/PushClientFactory.swift @@ -1,9 +1,12 @@ import Foundation public struct PushClientFactory { - public static func create(projectId: String, - pushHost: String, - environment: APNSEnvironment) -> PushClient { + public static func create( + projectId: String, + pushHost: String, + groupIdentifier: String, + environment: APNSEnvironment + ) -> PushClient { let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard diff --git a/Sources/WalletConnectSign/Sign/Sign.swift b/Sources/WalletConnectSign/Sign/Sign.swift index b140c6fc9..336c0a7a7 100644 --- a/Sources/WalletConnectSign/Sign/Sign.swift +++ b/Sources/WalletConnectSign/Sign/Sign.swift @@ -21,23 +21,12 @@ public class Sign { /// Sign client instance public static var instance: SignClient = { return SignClientFactory.create( - metadata: Sign.metadata ?? Pair.metadata, + metadata: Pair.metadata, pairingClient: Pair.instance as! PairingClient, - networkingClient: Networking.instance as! NetworkingInteractor + networkingClient: Networking.instance as! NetworkingInteractor, + groupIdentifier: Networking.groupIdentifier ) }() - @available(*, deprecated, message: "Remove after clients migration") - private static var metadata: AppMetadata? - private init() { } - - /// Sign instance config method - /// - Parameters: - /// - metadata: App metadata - @available(*, deprecated, message: "Use Pair.configure(metadata:) instead") - static public func configure(metadata: AppMetadata) { - Pair.configure(metadata: metadata) - Sign.metadata = metadata - } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 9ae83c99b..4da9b3787 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -11,14 +11,26 @@ public struct SignClientFactory { /// - keyValueStorage: by default WalletConnect SDK will store sequences in UserDefaults /// /// WalletConnect Client is not a singleton but once you create an instance, you should not deinitialize it. Usually only one instance of a client is required in the application. - public static func create(metadata: AppMetadata, pairingClient: PairingClient, networkingClient: NetworkingInteractor, groupIdentifier: String) -> SignClient { + public static func create( + metadata: AppMetadata, + pairingClient: PairingClient, + networkingClient: NetworkingInteractor, + groupIdentifier: String + ) -> SignClient { let logger = ConsoleLogger(loggingLevel: .debug) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return SignClientFactory.create(metadata: metadata, logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, pairingClient: pairingClient, networkingClient: networkingClient) } - static func create(metadata: AppMetadata, logger: ConsoleLogging, keyValueStorage: KeyValueStorage, keychainStorage: KeychainStorageProtocol, pairingClient: PairingClient, networkingClient: NetworkingInteractor) -> SignClient { + static func create( + metadata: AppMetadata, + logger: ConsoleLogging, + keyValueStorage: KeyValueStorage, + keychainStorage: KeychainStorageProtocol, + pairingClient: PairingClient, + networkingClient: NetworkingInteractor + ) -> SignClient { let kms = KeyManagementService(keychain: keychainStorage) let rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) let pairingStore = PairingStorage(storage: SequenceStore(store: .init(defaults: keyValueStorage, identifier: SignStorageIdentifiers.pairings.rawValue))) From 2d355beb68ae20762990f95e882616242c0292ab Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 Nov 2023 12:30:58 +0100 Subject: [PATCH 022/814] savepoint --- .../ClientAuth/ClientIdStorage.swift | 22 ++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift b/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift index 86c01cb47..0d9d77146 100644 --- a/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift +++ b/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift @@ -50,24 +50,36 @@ private extension ClientIdStorage { } func migrateIfNeeded() { + migratePublicKeyToGroupUserDefaultsIfNeeded() + migrateFromKeychainToKeyValueStorageIfNeeded() + } + + func migrateFromKeychainToKeyValueStorageIfNeeded() { guard let privateKey: SigningPrivateKey = try? keychain.read(key: oldStorageKey) else { return } - do { try setPrivatePart(privateKey) setPublicPart(privateKey.publicKey) try keychain.delete(key: oldStorageKey) - logger.debug("ClientID migrated") + logger.debug("Keychain data migrated to group UserDefaults") } catch { logger.debug("ClientID migration failed with: \(error.localizedDescription)") } } - func migrateToGroupDefaultsIfNeeded() { - + private func migratePublicKeyToGroupUserDefaultsIfNeeded() { + let migrationKey = "com.walletconnect.has_migrated_public_key_to_group" + guard let groupDefaults = defaults as? UserDefaults, + groupDefaults != UserDefaults.standard, + !groupDefaults.bool(forKey: migrationKey), + let pubKeyRaw = UserDefaults.standard.data(forKey: publicStorageKey) else { + return + } - + groupDefaults.set(pubKeyRaw, forKey: publicStorageKey) + groupDefaults.set(true, forKey: migrationKey) + logger.debug("Public key migrated to group UserDefaults") } func getPublicPart() throws -> SigningPublicKey { From aae85bde46d580cd0d29e22cf34ff08d2c0edf0b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 Nov 2023 14:02:23 +0100 Subject: [PATCH 023/814] update tests --- .../AuthTests/ClientIdStorageTests.swift | 52 +++++++++++++++---- 1 file changed, 43 insertions(+), 9 deletions(-) diff --git a/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift b/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift index 45b147637..2ed545f3d 100644 --- a/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift +++ b/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift @@ -8,12 +8,20 @@ final class ClientIdStorageTests: XCTestCase { var sut: ClientIdStorage! var keychain: KeychainStorageMock! - var defaults: RuntimeKeyValueStorage! + var standardDefaults = UserDefaults.standard + var gropuDefaults: UserDefaults! override func setUp() { + super.setUp() keychain = KeychainStorageMock() - defaults = RuntimeKeyValueStorage() - sut = ClientIdStorage(defaults: defaults, keychain: keychain, logger: ConsoleLoggerMock()) + gropuDefaults = UserDefaults(suiteName: "group")! + sut = ClientIdStorage(defaults: gropuDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + } + + override func tearDown() { + super.tearDown() + gropuDefaults.removePersistentDomain(forName: "group") + UserDefaults.standard.removePersistentDomain(forName: Bundle.main.bundleIdentifier!) } func testGetOrCreate() throws { @@ -35,7 +43,7 @@ final class ClientIdStorageTests: XCTestCase { let privateKey = try SigningPrivateKey(rawRepresentation: didKey.rawData) - defaults.set(privateKey.publicKey.rawRepresentation, forKey: "com.walletconnect.iridium.client_id.public") + gropuDefaults.set(privateKey.publicKey.rawRepresentation, forKey: "com.walletconnect.iridium.client_id.public") /// Private part not found XCTAssertThrowsError(try sut.getClientId()) @@ -49,17 +57,16 @@ final class ClientIdStorageTests: XCTestCase { XCTAssertEqual(clientId, didPublicKey.did(variant: .ED25519)) } - func testMigration() throws { - let defaults = RuntimeKeyValueStorage() - let keychain = KeychainStorageMock() + // This test covers the scenario where both parts of the key are in the keychain, and the public part needs to be moved to the group defaults. + func testMigrationFromFullKeychain() throws { let clientId = SigningPrivateKey() try keychain.add(clientId, forKey: "com.walletconnect.iridium.client_id") // Migration on init - let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychain, logger: ConsoleLoggerMock()) + let clientIdStorage = ClientIdStorage(defaults: gropuDefaults, keychain: keychain, logger: ConsoleLoggerMock()) - let publicPartData = defaults.data(forKey: "com.walletconnect.iridium.client_id.public")! + let publicPartData = gropuDefaults.data(forKey: "com.walletconnect.iridium.client_id.public")! let publicPart = try SigningPublicKey(rawRepresentation: publicPartData) let privatePartStorageId = publicPart.rawRepresentation.sha256().toHexString() @@ -77,4 +84,31 @@ final class ClientIdStorageTests: XCTestCase { let restoredPublicPart = try clientIdStorage.getClientId() XCTAssertEqual(restoredPublicPart, DIDKey(rawData: clientId.publicKey.rawRepresentation).did(variant: .ED25519)) } + + + + // This test simulates users who were affected by the last migration, where the public part is in the standard UserDefaults and needs to be migrated to the group defaults. + func testClientsAffectedByKeychainToDefaultsMigration() throws { + + let publicStorageKey = "com.walletconnect.iridium.client_id.public" + + // Setup: Affected by last migration (public key in standard UserDefaults) + let clientId = SigningPrivateKey() + standardDefaults.set(clientId.publicKey.rawRepresentation, forKey: publicStorageKey) + + // Migration on init + let clientIdStorage = ClientIdStorage(defaults: gropuDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + + // Validate: Public key should be migrated to group defaults + let publicPartData = gropuDefaults.data(forKey: publicStorageKey)! + let publicPart = try SigningPublicKey(rawRepresentation: publicPartData) + XCTAssertEqual(publicPart, clientId.publicKey) + } + + + + + + + } From 34bf304acf92d7f5beedbc96ca3aa2fcb8fd0117 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 Nov 2023 14:31:56 +0100 Subject: [PATCH 024/814] add more client id storage tests --- .../AuthTests/ClientIdStorageTests.swift | 60 +++++++++++++++---- 1 file changed, 49 insertions(+), 11 deletions(-) diff --git a/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift b/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift index 2ed545f3d..755ad114b 100644 --- a/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift +++ b/Tests/RelayerTests/AuthTests/ClientIdStorageTests.swift @@ -9,18 +9,18 @@ final class ClientIdStorageTests: XCTestCase { var sut: ClientIdStorage! var keychain: KeychainStorageMock! var standardDefaults = UserDefaults.standard - var gropuDefaults: UserDefaults! + var groupDefaults: UserDefaults! override func setUp() { super.setUp() keychain = KeychainStorageMock() - gropuDefaults = UserDefaults(suiteName: "group")! - sut = ClientIdStorage(defaults: gropuDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + groupDefaults = UserDefaults(suiteName: "group")! + sut = ClientIdStorage(defaults: groupDefaults, keychain: keychain, logger: ConsoleLoggerMock()) } override func tearDown() { super.tearDown() - gropuDefaults.removePersistentDomain(forName: "group") + groupDefaults.removePersistentDomain(forName: "group") UserDefaults.standard.removePersistentDomain(forName: Bundle.main.bundleIdentifier!) } @@ -43,7 +43,7 @@ final class ClientIdStorageTests: XCTestCase { let privateKey = try SigningPrivateKey(rawRepresentation: didKey.rawData) - gropuDefaults.set(privateKey.publicKey.rawRepresentation, forKey: "com.walletconnect.iridium.client_id.public") + groupDefaults.set(privateKey.publicKey.rawRepresentation, forKey: "com.walletconnect.iridium.client_id.public") /// Private part not found XCTAssertThrowsError(try sut.getClientId()) @@ -64,9 +64,9 @@ final class ClientIdStorageTests: XCTestCase { try keychain.add(clientId, forKey: "com.walletconnect.iridium.client_id") // Migration on init - let clientIdStorage = ClientIdStorage(defaults: gropuDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + let clientIdStorage = ClientIdStorage(defaults: groupDefaults, keychain: keychain, logger: ConsoleLoggerMock()) - let publicPartData = gropuDefaults.data(forKey: "com.walletconnect.iridium.client_id.public")! + let publicPartData = groupDefaults.data(forKey: "com.walletconnect.iridium.client_id.public")! let publicPart = try SigningPublicKey(rawRepresentation: publicPartData) let privatePartStorageId = publicPart.rawRepresentation.sha256().toHexString() @@ -85,8 +85,6 @@ final class ClientIdStorageTests: XCTestCase { XCTAssertEqual(restoredPublicPart, DIDKey(rawData: clientId.publicKey.rawRepresentation).did(variant: .ED25519)) } - - // This test simulates users who were affected by the last migration, where the public part is in the standard UserDefaults and needs to be migrated to the group defaults. func testClientsAffectedByKeychainToDefaultsMigration() throws { @@ -97,18 +95,58 @@ final class ClientIdStorageTests: XCTestCase { standardDefaults.set(clientId.publicKey.rawRepresentation, forKey: publicStorageKey) // Migration on init - let clientIdStorage = ClientIdStorage(defaults: gropuDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + let _ = ClientIdStorage(defaults: groupDefaults, keychain: keychain, logger: ConsoleLoggerMock()) // Validate: Public key should be migrated to group defaults - let publicPartData = gropuDefaults.data(forKey: publicStorageKey)! + let publicPartData = groupDefaults.data(forKey: publicStorageKey)! + let publicPart = try SigningPublicKey(rawRepresentation: publicPartData) + XCTAssertEqual(publicPart, clientId.publicKey) + } + + // This test verifies the scenario where the public part of the key is already in the group defaults and has never been migrated. It checks that no migration occurs and the migration flag remains unset. + func testNeverMigratedWithPubPartInGroupDefaultsAndCheckMigrationFlag() throws { + let publicStorageKey = "com.walletconnect.iridium.client_id.public" + let migrationFlagKey = "com.walletconnect.has_migrated_public_key_to_group" + + // Setup: Public key already in group defaults and no migration flag set + let clientId = SigningPrivateKey() + groupDefaults.set(clientId.publicKey.rawRepresentation, forKey: publicStorageKey) + XCTAssertFalse(groupDefaults.bool(forKey: migrationFlagKey)) // Ensure migration flag is not set + + // Migration on init + let _ = ClientIdStorage(defaults: groupDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + + // Validate: No migration needed, public key remains in group defaults + let publicPartData = groupDefaults.data(forKey: publicStorageKey)! let publicPart = try SigningPublicKey(rawRepresentation: publicPartData) XCTAssertEqual(publicPart, clientId.publicKey) + + // Check that the migration flag remains unset, indicating no migration occurred + XCTAssertFalse(groupDefaults.bool(forKey: migrationFlagKey)) } + // This test ensures that for users who have already undergone the migration process, no additional migration occurs. It checks that the existing keys remain unchanged and the migration flag is set. + func testAlreadyMigrated() throws { + let publicStorageKey = "com.walletconnect.iridium.client_id.public" + let migrationFlagKey = "com.walletconnect.has_migrated_public_key_to_group" + let clientId = SigningPrivateKey() + let storageId = clientId.publicKey.rawRepresentation.sha256().toHexString() + try keychain.add(clientId, forKey: storageId) + groupDefaults.set(clientId.publicKey.rawRepresentation, forKey: publicStorageKey) + groupDefaults.set(true, forKey: migrationFlagKey) + // Migration on init + let _ = ClientIdStorage(defaults: groupDefaults, keychain: keychain, logger: ConsoleLoggerMock()) + // Validate: No change in data, keys remain same + let publicPartData = groupDefaults.data(forKey: publicStorageKey)! + let publicPart = try SigningPublicKey(rawRepresentation: publicPartData) + XCTAssertEqual(publicPart, clientId.publicKey) + let privatePart: SigningPrivateKey = try keychain.read(key: storageId) + XCTAssertEqual(privatePart, clientId) + } } From 31c674eb3dc63753847070c69743ffb2a002463a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 Nov 2023 14:41:58 +0100 Subject: [PATCH 025/814] remove items from old defaults --- .../ClientAuth/ClientIdStorage.swift | 8 ++++-- Sources/WalletConnectUtils/CodableStore.swift | 26 +++++++++++-------- 2 files changed, 21 insertions(+), 13 deletions(-) diff --git a/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift b/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift index 0d9d77146..980d1d1fd 100644 --- a/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift +++ b/Sources/WalletConnectRelay/ClientAuth/ClientIdStorage.swift @@ -8,6 +8,7 @@ public protocol ClientIdStoring { public struct ClientIdStorage: ClientIdStoring { private let oldStorageKey = "com.walletconnect.iridium.client_id" private let publicStorageKey = "com.walletconnect.iridium.client_id.public" + private static let migrationQueue = DispatchQueue(label: "com.walletconnect.iridium.clientIdStorageMigration") private let defaults: KeyValueStorage private let keychain: KeychainStorageProtocol @@ -50,8 +51,10 @@ private extension ClientIdStorage { } func migrateIfNeeded() { - migratePublicKeyToGroupUserDefaultsIfNeeded() - migrateFromKeychainToKeyValueStorageIfNeeded() + ClientIdStorage.migrationQueue.sync { + migratePublicKeyToGroupUserDefaultsIfNeeded() + migrateFromKeychainToKeyValueStorageIfNeeded() + } } func migrateFromKeychainToKeyValueStorageIfNeeded() { @@ -79,6 +82,7 @@ private extension ClientIdStorage { groupDefaults.set(pubKeyRaw, forKey: publicStorageKey) groupDefaults.set(true, forKey: migrationKey) + UserDefaults.standard.removeObject(forKey: publicStorageKey) logger.debug("Public key migrated to group UserDefaults") } diff --git a/Sources/WalletConnectUtils/CodableStore.swift b/Sources/WalletConnectUtils/CodableStore.swift index c4c1de587..e4319b80f 100644 --- a/Sources/WalletConnectUtils/CodableStore.swift +++ b/Sources/WalletConnectUtils/CodableStore.swift @@ -71,21 +71,25 @@ public final class CodableStore where T: Codable { private func migrateIfNeeded() { migrationQueue.sync { let migrationKey = "hasMigratedToGroup_\(prefix)" - if defaults as? UserDefaults != UserDefaults.standard && !defaults.bool(forKey: migrationKey) { - let oldStore = CodableStore(defaults: UserDefaults.standard, identifier: prefix) + guard let groupDefaults = defaults as? UserDefaults, + groupDefaults != UserDefaults.standard, + !groupDefaults.bool(forKey: migrationKey) else { + return + } - let oldItemsDictionary = oldStore.dictionaryForIdentifier() + let oldStore = CodableStore(defaults: UserDefaults.standard, identifier: prefix) + let oldItemsDictionary = oldStore.dictionaryForIdentifier() - for (key, value) in oldItemsDictionary { - if let data = value as? Data { - defaults.set(data, forKey: key) - } + for (key, value) in oldItemsDictionary { + if let data = value as? Data { + groupDefaults.set(data, forKey: key) + UserDefaults.standard.removeObject(forKey: key) } - - defaults.set(true, forKey: migrationKey) - - storeUpdatePublisherSubject.send() } + + groupDefaults.set(true, forKey: migrationKey) + storeUpdatePublisherSubject.send() } } + } From 062753a682256f0f7e29f2f0e84c9c50dd8dc87c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 Nov 2023 09:33:46 +0100 Subject: [PATCH 026/814] savepoint --- Sources/WalletConnectPush/PushClient.swift | 2 +- Sources/WalletConnectPush/PushClientProtocol.swift | 8 +++++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectPush/PushClient.swift b/Sources/WalletConnectPush/PushClient.swift index 30f87f9f3..c385726da 100644 --- a/Sources/WalletConnectPush/PushClient.swift +++ b/Sources/WalletConnectPush/PushClient.swift @@ -14,7 +14,7 @@ public class PushClient: PushClientProtocol { self.logger = logger } - public func register(deviceToken: Data) async throws { + public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { try await registerService.register(deviceToken: deviceToken) } diff --git a/Sources/WalletConnectPush/PushClientProtocol.swift b/Sources/WalletConnectPush/PushClientProtocol.swift index 35eb8f3fa..d07b0ada0 100644 --- a/Sources/WalletConnectPush/PushClientProtocol.swift +++ b/Sources/WalletConnectPush/PushClientProtocol.swift @@ -1,8 +1,14 @@ import Foundation public protocol PushClientProtocol { - func register(deviceToken: Data) async throws + func register(deviceToken: Data, enableEncrypted: Bool) async throws #if DEBUG func register(deviceToken: String) async throws #endif } + +extension PushClientProtocol { + func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { + try await register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) + } +} From 2ddd01db6f7d12044c4a8566a7378dded9d00075 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 Nov 2023 09:34:16 +0100 Subject: [PATCH 027/814] update --- Sources/WalletConnectPush/PushClientProtocol.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectPush/PushClientProtocol.swift b/Sources/WalletConnectPush/PushClientProtocol.swift index d07b0ada0..93c9a5fe6 100644 --- a/Sources/WalletConnectPush/PushClientProtocol.swift +++ b/Sources/WalletConnectPush/PushClientProtocol.swift @@ -7,7 +7,7 @@ public protocol PushClientProtocol { #endif } -extension PushClientProtocol { +public extension PushClientProtocol { func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { try await register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) } From a1e6e5971da4a0ad47d1055334b66da622ec3a0b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 Nov 2023 14:25:57 +0100 Subject: [PATCH 028/814] update push client's register method, wip NotificationService --- .../xcshareddata/swiftpm/Package.resolved | 4 +- .../NotificationService.swift | 61 ++++++++++++------- Sources/WalletConnectPush/PushClient.swift | 4 +- .../Register/PushRegisterService.swift | 12 ++-- .../Register/PushService.swift | 28 ++++++--- Sources/Web3Wallet/Web3WalletClient.swift | 4 +- 6 files changed, 69 insertions(+), 44 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 229e0f8ef..dceba93f5 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "e68c1b1560264965ca13608db44294d301c6404f", - "version": "1.0.9" + "revision": "831410cfd6e68afa7212a5547483fb2d180f0fa7", + "version": "1.0.10" } } ] diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 708444594..eac699664 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -7,6 +7,8 @@ class NotificationService: UNNotificationServiceExtension { var contentHandler: ((UNNotificationContent) -> Void)? var bestAttemptContent: UNNotificationContent? + private let notifyTags: [UInt] = [1] + private let w3wTags: [UInt] = [1] override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) { self.contentHandler = contentHandler @@ -16,41 +18,52 @@ class NotificationService: UNNotificationServiceExtension { if let content = bestAttemptContent, let topic = content.userInfo["topic"] as? String, - let ciphertext = content.userInfo["blob"] as? String { - - log("topic and blob found") + let ciphertext = content.userInfo["message"] as? String, + let tag = content.userInfo["tag"] as? UInt { + + if notifyTags.contains(tag) { + Task { + let mutableContent = await handleNotifyMessage(content: content, topic: topic, tag: tag, ciphertext: ciphertext) + contentHandler(mutableContent) + } + } else if w3wTags.contains(tag) { + // Handle other tags + } else { + // Handle default case + } + } + } - do { - let service = NotifyDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") - let (pushMessage, account) = try service.decryptMessage(topic: topic, ciphertext: ciphertext) - log("message decrypted", account: account, topic: topic, message: pushMessage) + private func handleNotifyMessage(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) async -> UNMutableNotificationContent { + do { + let service = NotifyDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") + let (pushMessage, account) = try service.decryptMessage(topic: topic, ciphertext: ciphertext) - let updatedContent = handle(content: content, pushMessage: pushMessage, topic: topic) + log("message decrypted", account: account, topic: topic, message: pushMessage) - let mutableContent = updatedContent.mutableCopy() as! UNMutableNotificationContent - mutableContent.title = pushMessage.title - mutableContent.subtitle = pushMessage.url - mutableContent.body = pushMessage.body + let updatedContent = handle(content: content, pushMessage: pushMessage, topic: topic) - log("message handled", account: account, topic: topic, message: pushMessage) + let mutableContent = updatedContent.mutableCopy() as! UNMutableNotificationContent + mutableContent.title = pushMessage.title + mutableContent.subtitle = pushMessage.url + mutableContent.body = pushMessage.body - contentHandler(mutableContent) + log("message handled", account: account, topic: topic, message: pushMessage) - log("content handled", account: account, topic: topic, message: pushMessage) - } - catch { - log("error: \(error.localizedDescription)") + return mutableContent + } catch { + log("error: \(error.localizedDescription)") - let mutableContent = content.mutableCopy() as! UNMutableNotificationContent - mutableContent.title = "Error" - mutableContent.body = error.localizedDescription + let mutableContent = content.mutableCopy() as! UNMutableNotificationContent + mutableContent.title = "Error" + mutableContent.body = error.localizedDescription - contentHandler(mutableContent) - } + return mutableContent } } + override func serviceExtensionTimeWillExpire() { // Called just before the extension will be terminated by the system. // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used. @@ -58,6 +71,8 @@ class NotificationService: UNNotificationServiceExtension { contentHandler(bestAttemptContent) } } + + } private extension NotificationService { diff --git a/Sources/WalletConnectPush/PushClient.swift b/Sources/WalletConnectPush/PushClient.swift index c385726da..2c378b3e6 100644 --- a/Sources/WalletConnectPush/PushClient.swift +++ b/Sources/WalletConnectPush/PushClient.swift @@ -15,12 +15,12 @@ public class PushClient: PushClientProtocol { } public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { - try await registerService.register(deviceToken: deviceToken) + try await registerService.register(deviceToken: deviceToken, alwaysRaw: enableEncrypted) } #if DEBUG public func register(deviceToken: String) async throws { - try await registerService.register(deviceToken: deviceToken) + try await registerService.register(deviceToken: deviceToken, alwaysRaw: true) } #endif } diff --git a/Sources/WalletConnectPush/Register/PushRegisterService.swift b/Sources/WalletConnectPush/Register/PushRegisterService.swift index 3c06ce281..193c173c7 100644 --- a/Sources/WalletConnectPush/Register/PushRegisterService.swift +++ b/Sources/WalletConnectPush/Register/PushRegisterService.swift @@ -29,7 +29,7 @@ actor PushRegisterService { self.environment = environment } - func register(deviceToken: Data) async throws { + func register(deviceToken: Data, alwaysRaw: Bool) async throws { let tokenParts = deviceToken.map { data in String(format: "%02.2hhx", data) } let token = tokenParts.joined() let pushAuthToken = try pushAuthenticator.createAuthToken() @@ -40,7 +40,7 @@ actor PushRegisterService { do { let response = try await httpClient.request( PushResponse.self, - at: PushAPI.register(clientId: clientIdMutlibase, token: token, projectId: projectId, environment: environment, auth: pushAuthToken) + at: PushAPI.register(clientId: clientIdMutlibase, token: token, projectId: projectId, environment: environment, auth: pushAuthToken, alwaysRaw: alwaysRaw) ) guard response.status == .success else { throw Errors.registrationFailed @@ -51,7 +51,7 @@ actor PushRegisterService { logger.debug("Trying fallback") fallback = true await echoHostFallback() - try await register(deviceToken: deviceToken) + try await register(deviceToken: deviceToken, alwaysRaw: alwaysRaw) } logger.debug("Push Server registration error: \(error.localizedDescription)") throw error @@ -63,7 +63,7 @@ actor PushRegisterService { } #if DEBUG - public func register(deviceToken: String) async throws { + public func register(deviceToken: String, alwaysRaw: Bool) async throws { let pushAuthToken = try pushAuthenticator.createAuthToken() let clientId = try clientIdStorage.getClientId() let clientIdMutlibase = try DIDKey(did: clientId).multibase(variant: .ED25519) @@ -71,7 +71,7 @@ actor PushRegisterService { do { let response = try await httpClient.request( PushResponse.self, - at: PushAPI.register(clientId: clientIdMutlibase, token: deviceToken, projectId: projectId, environment: environment, auth: pushAuthToken) + at: PushAPI.register(clientId: clientIdMutlibase, token: deviceToken, projectId: projectId, environment: environment, auth: pushAuthToken, alwaysRaw: alwaysRaw) ) guard response.status == .success else { throw Errors.registrationFailed @@ -81,7 +81,7 @@ actor PushRegisterService { if (error as? HTTPError) == .couldNotConnect && !fallback { fallback = true await echoHostFallback() - try await register(deviceToken: deviceToken) + try await register(deviceToken: deviceToken, alwaysRaw: alwaysRaw) } throw error } diff --git a/Sources/WalletConnectPush/Register/PushService.swift b/Sources/WalletConnectPush/Register/PushService.swift index d6ddbc6f3..43062e6c4 100644 --- a/Sources/WalletConnectPush/Register/PushService.swift +++ b/Sources/WalletConnectPush/Register/PushService.swift @@ -1,12 +1,12 @@ import Foundation enum PushAPI: HTTPService { - case register(clientId: String, token: String, projectId: String, environment: APNSEnvironment, auth: String) + case register(clientId: String, token: String, projectId: String, environment: APNSEnvironment, auth: String, alwaysRaw: Bool) case unregister(clientId: String, projectId: String, auth: String) var path: String { switch self { - case .register(_, _, let projectId, _, _): + case .register(_, _, let projectId, _, _, _): return "/\(projectId)/clients" case .unregister(let clientId, let projectId, _): return "/\(projectId)/clients\(clientId)" @@ -24,12 +24,9 @@ enum PushAPI: HTTPService { var body: Data? { switch self { - case .register(let clientId, let token, _, let environment, _): - return try? JSONEncoder().encode([ - "client_id": clientId, - "type": environment.rawValue, - "token": token - ]) + case .register(let clientId, let token, _, let environment, _, let alwaysRaw): + let request = RegisterRequest(clientId: clientId, type: environment.rawValue, token: token, alwaysRaw: alwaysRaw) + return try? JSONEncoder().encode(request) case .unregister: return nil } @@ -45,7 +42,7 @@ enum PushAPI: HTTPService { var additionalHeaderFields: [String : String]? { switch self { - case .register(_, _, _, _, let auth): + case .register(_, _, _, _, let auth, _): return ["Authorization": auth] case .unregister(_, _, let auth): return ["Authorization": auth] @@ -54,3 +51,16 @@ enum PushAPI: HTTPService { } +struct RegisterRequest: Codable { + let clientId: String + let type: String + let token: String + let alwaysRaw: Bool + + enum CodingKeys: String, CodingKey { + case clientId = "client_id" + case type + case token + case alwaysRaw = "always_raw" + } +} diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index a90093a10..1602e2138 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -212,8 +212,8 @@ public class Web3WalletClient { try authClient.getPendingRequests() } - public func registerPushClient(deviceToken: Data) async throws { - try await pushClient.register(deviceToken: deviceToken) + public func registerPushClient(deviceToken: Data, enableEncrypted: Bool = false) async throws { + try await pushClient.register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) } /// Delete all stored data such as: pairings, sessions, keys From 5553219a350d3d5dc53d1e3ec68cc83e769f0ac3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 Nov 2023 10:07:39 +0100 Subject: [PATCH 029/814] add sign decryption service --- .../NotificationService.swift | 25 +++++++++++++---- .../SignDecryptionService.swift | 28 +++++++++++++++++++ .../Web3WalletDecryptionService.swift | 18 ++++++++++++ 3 files changed, 66 insertions(+), 5 deletions(-) create mode 100644 Sources/WalletConnectSign/SignDecryptionService.swift create mode 100644 Sources/Web3Wallet/Web3WalletDecryptionService.swift diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index eac699664..290e8f934 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -1,4 +1,5 @@ import UserNotifications +import Web3Wallet import WalletConnectNotify import Intents import Mixpanel @@ -7,8 +8,8 @@ class NotificationService: UNNotificationServiceExtension { var contentHandler: ((UNNotificationContent) -> Void)? var bestAttemptContent: UNNotificationContent? - private let notifyTags: [UInt] = [1] - private let w3wTags: [UInt] = [1] + private let notifyTags: [UInt] = [4002] + private let w3wTags: [UInt] = [1100, 1108, 3000] override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) { self.contentHandler = contentHandler @@ -23,19 +24,33 @@ class NotificationService: UNNotificationServiceExtension { if notifyTags.contains(tag) { Task { - let mutableContent = await handleNotifyMessage(content: content, topic: topic, tag: tag, ciphertext: ciphertext) + let mutableContent = await handleNotifyNotification(content: content, topic: topic, ciphertext: ciphertext) contentHandler(mutableContent) } } else if w3wTags.contains(tag) { - // Handle other tags + Task { + let mutableContent = await handleWeb3WalletNotification(content: content, topic: topic, tag: tag, ciphertext: ciphertext) + } } else { // Handle default case } } } + private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) async -> UNMutableNotificationContent { + + + let web3WalletDecryptionService = Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") + + let rpcRequest = web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + + let metadata = web3WalletDecryptionService.getMetadata(topic: topic) + + + } + - private func handleNotifyMessage(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) async -> UNMutableNotificationContent { + private func handleNotifyNotification(content: UNNotificationContent, topic: String, ciphertext: String) async -> UNMutableNotificationContent { do { let service = NotifyDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") let (pushMessage, account) = try service.decryptMessage(topic: topic, ciphertext: ciphertext) diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift new file mode 100644 index 000000000..5b80c49e6 --- /dev/null +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -0,0 +1,28 @@ +import Foundation + +public class SignDecryptionService { + enum Errors: Error { + case couldNotInitialiseDefaults + } + private let serializer: Serializing + private let sessionStorage: WCSessionStorage + + public init(groupIdentifier: String) throws { + let keychainStorage = GroupKeychainStorage(serviceIdentifier: groupIdentifier) + let kms = KeyManagementService(keychain: keychainStorage) + self.serializer = Serializer(kms: kms, logger: ConsoleLogger(prefix: "🔐", loggingLevel: .off)) + guard let defaults = UserDefaults(suiteName: groupIdentifier) else { + throw Errors.couldNotInitialiseDefaults + } + sessionStorage = SessionStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: SignStorageIdentifiers.sessions.rawValue))) + } + + public func decryptMessage(topic: String, ciphertext: String) throws -> RPCRequest { + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + return rpcRequest + } + + public func getMetadata(topic: String) -> AppMetadata? { + sessionStorage.getSession(forTopic: topic)?.peerParticipant.metadata + } +} diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift new file mode 100644 index 000000000..3defff2d6 --- /dev/null +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -0,0 +1,18 @@ +import Foundation + +public class Web3WalletDecryptionService { + + private let signDecryptionService: SignDecryptionService + + public init(groupIdentifier: String) throws { + self.signDecryptionService = try SignDecryptionService(groupIdentifier: groupIdentifier) + } + + public func decryptMessage(topic: String, ciphertext: String) throws -> RPCRequest { + return try signDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + } + + public func getMetadata(topic: String) -> AppMetadata? { + signDecryptionService.getMetadata(topic: topic) + } +} From 7d0b797cd260f4dc8b734d811fc163bf2e7c7be5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 Nov 2023 10:14:25 +0100 Subject: [PATCH 030/814] savepoint --- .../PNDecryptionService/NotificationService.swift | 15 +++++---------- .../Web3Wallet/Web3WalletDecryptionService.swift | 2 +- 2 files changed, 6 insertions(+), 11 deletions(-) diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 290e8f934..49661f83c 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -23,21 +23,17 @@ class NotificationService: UNNotificationServiceExtension { let tag = content.userInfo["tag"] as? UInt { if notifyTags.contains(tag) { - Task { - let mutableContent = await handleNotifyNotification(content: content, topic: topic, ciphertext: ciphertext) - contentHandler(mutableContent) - } + let mutableContent = handleNotifyNotification(content: content, topic: topic, ciphertext: ciphertext) + contentHandler(mutableContent) } else if w3wTags.contains(tag) { - Task { - let mutableContent = await handleWeb3WalletNotification(content: content, topic: topic, tag: tag, ciphertext: ciphertext) - } + let mutableContent = handleWeb3WalletNotification(content: content, topic: topic, tag: tag, ciphertext: ciphertext) } else { // Handle default case } } } - private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) async -> UNMutableNotificationContent { + private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) -> UNMutableNotificationContent { let web3WalletDecryptionService = Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") @@ -46,11 +42,10 @@ class NotificationService: UNNotificationServiceExtension { let metadata = web3WalletDecryptionService.getMetadata(topic: topic) - } - private func handleNotifyNotification(content: UNNotificationContent, topic: String, ciphertext: String) async -> UNMutableNotificationContent { + private func handleNotifyNotification(content: UNNotificationContent, topic: String, ciphertext: String) -> UNMutableNotificationContent { do { let service = NotifyDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") let (pushMessage, account) = try service.decryptMessage(topic: topic, ciphertext: ciphertext) diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index 3defff2d6..2a3dd91fd 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -1,6 +1,6 @@ import Foundation -public class Web3WalletDecryptionService { +public final class Web3WalletDecryptionService { private let signDecryptionService: SignDecryptionService From 8d7a6aadcd9ebfeb415f385bb97053da7112bee4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 Nov 2023 14:19:35 +0100 Subject: [PATCH 031/814] savepoint --- Example/ExampleApp.xcodeproj/project.pbxproj | 7 ++++++ .../xcshareddata/xcschemes/WalletApp.xcscheme | 14 ++++++++++++ .../NotificationService.swift | 22 ++++++++++++++++--- .../ApplicationLayer/AppDelegate.swift | 2 +- .../Client/Wallet/NotifyClient.swift | 4 ++-- .../WalletConnectPush/PushClientFactory.swift | 4 ++-- 6 files changed, 45 insertions(+), 8 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 4f5a2101c..ea9581c83 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -18,6 +18,7 @@ 84474A0129B9EB74005F520B /* Starscream in Frameworks */ = {isa = PBXBuildFile; productRef = 84474A0029B9EB74005F520B /* Starscream */; }; 84474A0229B9ECA2005F520B /* DefaultSocketFactory.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AEF2877F73000094373 /* DefaultSocketFactory.swift */; }; 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */ = {isa = PBXBuildFile; productRef = 8448F1D327E4726F0000B866 /* WalletConnect */; }; + 844AD55F2B1497270062E123 /* Web3Wallet in Frameworks */ = {isa = PBXBuildFile; productRef = 844AD55E2B1497270062E123 /* Web3Wallet */; }; 845B8D8C2934B36C0084A966 /* Account.swift in Sources */ = {isa = PBXBuildFile; fileRef = 845B8D8B2934B36C0084A966 /* Account.swift */; }; 847BD1D62989492500076C90 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D12989492500076C90 /* MainViewController.swift */; }; 847BD1D82989492500076C90 /* MainModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D32989492500076C90 /* MainModule.swift */; }; @@ -732,6 +733,7 @@ buildActionMask = 2147483647; files = ( A5A650CA2B062A1400F9AD4B /* Mixpanel in Frameworks */, + 844AD55F2B1497270062E123 /* Web3Wallet in Frameworks */, A5B6C0F72A6EAB3200927332 /* WalletConnectNotify in Frameworks */, ); runOnlyForDeploymentPostprocessing = 0; @@ -2032,6 +2034,7 @@ packageProductDependencies = ( A5B6C0F62A6EAB3200927332 /* WalletConnectNotify */, A5A650C92B062A1400F9AD4B /* Mixpanel */, + 844AD55E2B1497270062E123 /* Web3Wallet */, ); productName = PNDecryptionService; productReference = 84E6B84729787A8000428BAF /* PNDecryptionService.appex */; @@ -3412,6 +3415,10 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnect; }; + 844AD55E2B1497270062E123 /* Web3Wallet */ = { + isa = XCSwiftPackageProductDependency; + productName = Web3Wallet; + }; 8487A9432A836C2A0003D5AF /* Sentry */ = { isa = XCSwiftPackageProductDependency; package = 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */; diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletApp.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletApp.xcscheme index 036e15875..6d01f5811 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletApp.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletApp.xcscheme @@ -20,6 +20,20 @@ ReferencedContainer = "container:ExampleApp.xcodeproj"> + + + + UNMutableNotificationContent { + do { + let web3WalletDecryptionService = try Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") + +// let rpcRequest = try web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + + let metadata = web3WalletDecryptionService.getMetadata(topic: topic) + + let mutableContent = content.mutableCopy() as! UNMutableNotificationContent - let web3WalletDecryptionService = Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") + mutableContent.title = "rpcRequest.method" - let rpcRequest = web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + mutableContent.subtitle = metadata?.url ?? "" - let metadata = web3WalletDecryptionService.getMetadata(topic: topic) + return mutableContent + } catch { + let mutableContent = content.mutableCopy() as! UNMutableNotificationContent + mutableContent.title = "Error" + mutableContent.body = error.localizedDescription + return mutableContent + } } diff --git a/Example/WalletApp/ApplicationLayer/AppDelegate.swift b/Example/WalletApp/ApplicationLayer/AppDelegate.swift index 1bef78e52..f2f961b36 100644 --- a/Example/WalletApp/ApplicationLayer/AppDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/AppDelegate.swift @@ -29,7 +29,7 @@ final class AppDelegate: UIResponder, UIApplicationDelegate { UserDefaults.standard.set(deviceTokenString.joined(), forKey: "deviceToken") Task(priority: .high) { - try await Notify.instance.register(deviceToken: deviceToken) + try await Notify.instance.register(deviceToken: deviceToken, enableEncrypted: true) } } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 41db7b97e..6a3ea77e5 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -117,8 +117,8 @@ public class NotifyClient { try? notifyStorage.deleteMessage(id: id) } - public func register(deviceToken: Data) async throws { - try await pushClient.register(deviceToken: deviceToken) + public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { + try await pushClient.register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) } public func isIdentityRegistered(account: Account) -> Bool { diff --git a/Sources/WalletConnectPush/PushClientFactory.swift b/Sources/WalletConnectPush/PushClientFactory.swift index 60a3a9ad6..50a8a7809 100644 --- a/Sources/WalletConnectPush/PushClientFactory.swift +++ b/Sources/WalletConnectPush/PushClientFactory.swift @@ -27,8 +27,8 @@ public struct PushClientFactory { environment: APNSEnvironment ) -> PushClient { let sessionConfiguration = URLSessionConfiguration.default - sessionConfiguration.timeoutIntervalForRequest = 5.0 - sessionConfiguration.timeoutIntervalForResource = 5.0 + sessionConfiguration.timeoutIntervalForRequest = 10.0 + sessionConfiguration.timeoutIntervalForResource = 10.0 let session = URLSession(configuration: sessionConfiguration) let logger = ConsoleLogger(prefix: "👂🏻", loggingLevel: .off) From 79ec49ecd44b4345bc250b8242c926ff7bd3d6fd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 Nov 2023 08:03:41 +0100 Subject: [PATCH 032/814] update decryption services --- .../NotificationService.swift | 27 +++++++------ Sources/Auth/AuthDecryptionService.swift | 40 +++++++++++++++++++ .../Wallet/NotifyDecryptionService.swift | 5 +++ .../PairStorageIdentifiers.swift | 2 +- .../Web3WalletDecryptionService.swift | 30 ++++++++++++-- 5 files changed, 88 insertions(+), 16 deletions(-) create mode 100644 Sources/Auth/AuthDecryptionService.swift diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 10b89a134..c97a95df2 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -8,34 +8,32 @@ class NotificationService: UNNotificationServiceExtension { var contentHandler: ((UNNotificationContent) -> Void)? var bestAttemptContent: UNNotificationContent? - private let notifyTags: [UInt] = [4002] - private let w3wTags: [UInt] = [1100, 1108, 3000] override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) { self.contentHandler = contentHandler self.bestAttemptContent = request.content log("didReceive(_:) fired") - if let content = bestAttemptContent, let topic = content.userInfo["topic"] as? String, let ciphertext = content.userInfo["message"] as? String, let tag = content.userInfo["tag"] as? UInt { - if notifyTags.contains(tag) { - let mutableContent = handleNotifyNotification(content: content, topic: topic, ciphertext: ciphertext) + if let w3wRequestMethod = Web3WalletDecryptionService.getRequestMethod(tag: tag) { + let mutableContent = handleWeb3WalletNotification(content: content, topic: topic, requestMethod: w3wRequestMethod, ciphertext: ciphertext) contentHandler(mutableContent) - } else if w3wTags.contains(tag) { - let mutableContent = handleWeb3WalletNotification(content: content, topic: topic, tag: tag, ciphertext: ciphertext) + } else if NotifyDecryptionService.canHandle(tag: tag) { + let mutableContent = handleNotifyNotification(content: content, topic: topic, ciphertext: ciphertext) contentHandler(mutableContent) } else { - // Handle default case + let mutableContent = content.mutableCopy() as! UNMutableNotificationContent + mutableContent.title = "Error: unknown message tag" } } } - private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) -> UNMutableNotificationContent { + private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, requestMethod: Web3WalletDecryptionService.RequestMethod, ciphertext: String) -> UNMutableNotificationContent { do { let web3WalletDecryptionService = try Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") @@ -46,9 +44,14 @@ class NotificationService: UNNotificationServiceExtension { let mutableContent = content.mutableCopy() as! UNMutableNotificationContent - mutableContent.title = "rpcRequest.method" - - mutableContent.subtitle = metadata?.url ?? "" + switch requestMethod { + case .sessionProposal: + mutableContent.title = "session proposal" + case .sessionRequest: + mutableContent.title = "session request" + case .authRequest: + mutableContent.title = "auth request" + } return mutableContent } catch { diff --git a/Sources/Auth/AuthDecryptionService.swift b/Sources/Auth/AuthDecryptionService.swift new file mode 100644 index 000000000..8ba0c8e2e --- /dev/null +++ b/Sources/Auth/AuthDecryptionService.swift @@ -0,0 +1,40 @@ +import Foundation + +public class AuthDecryptionService { + enum Errors: Error { + case couldNotInitialiseDefaults + } + private let serializer: Serializing + private let pairingStorage: PairingStorage + + public init(groupIdentifier: String) throws { + let keychainStorage = GroupKeychainStorage(serviceIdentifier: groupIdentifier) + let kms = KeyManagementService(keychain: keychainStorage) + self.serializer = Serializer(kms: kms, logger: ConsoleLogger(prefix: "🔐", loggingLevel: .off)) + guard let defaults = UserDefaults(suiteName: groupIdentifier) else { + throw Errors.couldNotInitialiseDefaults + } + pairingStorage = PairingStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: PairStorageIdentifiers.pairings.rawValue))) + } + + public func decryptMessage(topic: String, ciphertext: String) throws -> RPCRequest { + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + setPairingMetadata(rpcRequest: rpcRequest, topic: topic) + return rpcRequest + } + + public func getMetadata(topic: String) -> AppMetadata? { + pairingStorage.getPairing(forTopic: topic)?.peerMetadata + } + + private func setPairingMetadata(rpcRequest: RPCRequest, topic: String) { + guard var pairing = pairingStorage.getPairing(forTopic: topic), + pairing.peerMetadata == nil, + let peerMetadata = try? rpcRequest.params?.get(AuthRequestParams.self).requester.metadata + else { return } + + pairing.updatePeerMetadata(peerMetadata) + pairingStorage.setPairing(pairing) + } +} + diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift index 296e515e9..272a37cea 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift @@ -5,6 +5,7 @@ public class NotifyDecryptionService { case malformedNotifyMessage } private let serializer: Serializing + private static let notifyTags: [UInt] = [4002] init(serializer: Serializing) { self.serializer = serializer @@ -16,6 +17,10 @@ public class NotifyDecryptionService { self.serializer = Serializer(kms: kms, logger: ConsoleLogger(prefix: "🔐", loggingLevel: .off)) } + public static func canHandle(tag: UInt) -> Bool { + return notifyTags.contains(tag) + } + public func decryptMessage(topic: String, ciphertext: String) throws -> (NotifyMessage, Account) { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) guard let params = rpcRequest.params else { throw Errors.malformedNotifyMessage } diff --git a/Sources/WalletConnectPairing/PairStorageIdentifiers.swift b/Sources/WalletConnectPairing/PairStorageIdentifiers.swift index f287e1aad..0728ec2c5 100644 --- a/Sources/WalletConnectPairing/PairStorageIdentifiers.swift +++ b/Sources/WalletConnectPairing/PairStorageIdentifiers.swift @@ -1,5 +1,5 @@ import Foundation -enum PairStorageIdentifiers: String { +public enum PairStorageIdentifiers: String { case pairings = "com.walletconnect.sdk.pairingSequences" } diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index 2a3dd91fd..724b3f8a8 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -1,18 +1,42 @@ import Foundation public final class Web3WalletDecryptionService { + enum Errors: Error { + case unknownTag + } + public enum RequestMethod: UInt { + case sessionRequest = 1108 + case sessionProposal = 1100 + case authRequest = 3000 + } private let signDecryptionService: SignDecryptionService + private let authDecryptionService: AuthDecryptionService public init(groupIdentifier: String) throws { + self.authDecryptionService = try AuthDecryptionService(groupIdentifier: groupIdentifier) self.signDecryptionService = try SignDecryptionService(groupIdentifier: groupIdentifier) } - public func decryptMessage(topic: String, ciphertext: String) throws -> RPCRequest { - return try signDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + public static func getRequestMethod(tag: UInt) -> RequestMethod? { + return RequestMethod(rawValue: tag) + } + + public func decryptMessage(topic: String, ciphertext: String, tag: UInt) throws -> RPCRequest { + guard let requestMethod = Self.getRequestMethod(tag: tag) else { throw Errors.unknownTag } + switch requestMethod { + case .sessionProposal, .sessionRequest: + return try signDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + case .authRequest: + return try authDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + } } public func getMetadata(topic: String) -> AppMetadata? { - signDecryptionService.getMetadata(topic: topic) + if let metadata = signDecryptionService.getMetadata(topic: topic) { + return metadata + } else { + return authDecryptionService.getMetadata(topic: topic) + } } } From cd926be06486447bcb4ee8f19aa234376adfa343 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 Nov 2023 14:07:08 +0100 Subject: [PATCH 033/814] fix client id migration --- Sources/WalletConnectNetworking/Networking.swift | 1 + Sources/WalletConnectRelay/Relay.swift | 3 +++ Sources/WalletConnectRelay/RelayClientFactory.swift | 3 ++- Sources/WalletConnectRelay/RelayConfig.swift | 1 + 4 files changed, 7 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectNetworking/Networking.swift b/Sources/WalletConnectNetworking/Networking.swift index ea4e8a7de..0b5277ea1 100644 --- a/Sources/WalletConnectNetworking/Networking.swift +++ b/Sources/WalletConnectNetworking/Networking.swift @@ -56,6 +56,7 @@ public class Networking { Relay.configure( relayHost: relayHost, projectId: projectId, + groupIdentifier: groupIdentifier, socketFactory: socketFactory, socketConnectionType: socketConnectionType) } diff --git a/Sources/WalletConnectRelay/Relay.swift b/Sources/WalletConnectRelay/Relay.swift index 38390fbbe..0bb18e671 100644 --- a/Sources/WalletConnectRelay/Relay.swift +++ b/Sources/WalletConnectRelay/Relay.swift @@ -16,6 +16,7 @@ public class Relay { relayHost: config.relayHost, projectId: config.projectId, socketFactory: config.socketFactory, + groupIdentifier: config.groupIdentifier, socketConnectionType: config.socketConnectionType ) }() @@ -33,12 +34,14 @@ public class Relay { static public func configure( relayHost: String = "relay.walletconnect.com", projectId: String, + groupIdentifier: String, socketFactory: WebSocketFactory, socketConnectionType: SocketConnectionType = .automatic ) { Relay.config = Relay.Config( relayHost: relayHost, projectId: projectId, + groupIdentifier: groupIdentifier, socketFactory: socketFactory, socketConnectionType: socketConnectionType ) diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 48e7f766a..34eac70db 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -8,10 +8,11 @@ public struct RelayClientFactory { relayHost: String, projectId: String, socketFactory: WebSocketFactory, + groupIdentifier: String, socketConnectionType: SocketConnectionType ) -> RelayClient { - let keyValueStorage = UserDefaults.standard + let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") diff --git a/Sources/WalletConnectRelay/RelayConfig.swift b/Sources/WalletConnectRelay/RelayConfig.swift index b716ed9ca..58908c965 100644 --- a/Sources/WalletConnectRelay/RelayConfig.swift +++ b/Sources/WalletConnectRelay/RelayConfig.swift @@ -4,6 +4,7 @@ extension Relay { struct Config { let relayHost: String let projectId: String + let groupIdentifier: String let socketFactory: WebSocketFactory let socketConnectionType: SocketConnectionType } From 404c09d2593f5aa60952da7769a40217cd7432e1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 Nov 2023 14:20:58 +0100 Subject: [PATCH 034/814] fix build --- Sources/WalletConnectModal/Modal/Modal+Previews.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectModal/Modal/Modal+Previews.swift b/Sources/WalletConnectModal/Modal/Modal+Previews.swift index 74e370ba5..620ee9b1d 100644 --- a/Sources/WalletConnectModal/Modal/Modal+Previews.swift +++ b/Sources/WalletConnectModal/Modal/Modal+Previews.swift @@ -42,7 +42,7 @@ struct ModalContainerView_Previews: PreviewProvider { redirect: AppMetadata.Redirect(native: "showcase://", universal: nil) ) - Networking.configure(projectId: projectId, socketFactory: WebSocketFactoryMock()) + Networking.configure(projectId: projectId, groupIdentifier: "group.com.walletconnect.sdk", socketFactory: WebSocketFactoryMock()) WalletConnectModal.configure(projectId: projectId, metadata: metadata) } From 01c3789e72c8734b63b24072251e1c0839b06475 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 Nov 2023 14:36:39 +0100 Subject: [PATCH 035/814] fix networking init --- Sources/WalletConnectModal/Modal/Modal+Previews.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectModal/Modal/Modal+Previews.swift b/Sources/WalletConnectModal/Modal/Modal+Previews.swift index 620ee9b1d..12ee8c5c0 100644 --- a/Sources/WalletConnectModal/Modal/Modal+Previews.swift +++ b/Sources/WalletConnectModal/Modal/Modal+Previews.swift @@ -42,7 +42,7 @@ struct ModalContainerView_Previews: PreviewProvider { redirect: AppMetadata.Redirect(native: "showcase://", universal: nil) ) - Networking.configure(projectId: projectId, groupIdentifier: "group.com.walletconnect.sdk", socketFactory: WebSocketFactoryMock()) + Networking.configure(groupIdentifier: "group.com.walletconnect.sdk", projectId: projectId, socketFactory: WebSocketFactoryMock()) WalletConnectModal.configure(projectId: projectId, metadata: metadata) } From 546aacaf9f684a7b1076d19e89c59796bf79836a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 08:13:37 +0100 Subject: [PATCH 036/814] remove unused scheme --- .../xcshareddata/swiftpm/Package.resolved | 4 +- ....xcscheme => PNDecryptionService.xcscheme} | 64 ++++++------------- .../NotificationService.swift | 12 ++-- 3 files changed, 28 insertions(+), 52 deletions(-) rename Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/{PushDecryptionService.xcscheme => PNDecryptionService.xcscheme} (57%) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index dceba93f5..229e0f8ef 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "831410cfd6e68afa7212a5547483fb2d180f0fa7", - "version": "1.0.10" + "revision": "e68c1b1560264965ca13608db44294d301c6404f", + "version": "1.0.9" } } ] diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/PushDecryptionService.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/PNDecryptionService.xcscheme similarity index 57% rename from Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/PushDecryptionService.xcscheme rename to Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/PNDecryptionService.xcscheme index 07e071581..026a57bb3 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/PushDecryptionService.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/PNDecryptionService.xcscheme @@ -1,8 +1,8 @@ + version = "2.0"> @@ -15,9 +15,9 @@ buildForAnalyzing = "YES"> @@ -29,9 +29,9 @@ buildForAnalyzing = "YES"> @@ -41,31 +41,21 @@ buildConfiguration = "Debug" selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB" selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB" - shouldUseLaunchSchemeArgsEnv = "YES"> - - - - - - + shouldUseLaunchSchemeArgsEnv = "YES" + shouldAutocreateTestPlan = "YES"> + allowLocationSimulation = "YES" + launchAutomaticallySubstyle = "2"> - - - - - - - - diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index c97a95df2..250d19ca7 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -40,17 +40,21 @@ class NotificationService: UNNotificationServiceExtension { // let rpcRequest = try web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) - let metadata = web3WalletDecryptionService.getMetadata(topic: topic) let mutableContent = content.mutableCopy() as! UNMutableNotificationContent + guard let metadata = web3WalletDecryptionService.getMetadata(topic: topic) else { + mutableContent.title = "Error: Cannot get peer's metadata" + return mutableContent + } + switch requestMethod { case .sessionProposal: - mutableContent.title = "session proposal" + mutableContent.title = "session proposal: \(metadata.name)" case .sessionRequest: - mutableContent.title = "session request" + mutableContent.title = "session request: \(metadata.name)" case .authRequest: - mutableContent.title = "auth request" + mutableContent.title = "auth request: \(metadata.name)" } return mutableContent From 6b6119afbd208a1ffa2cbe138bc0bb72880975c8 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 28 Nov 2023 15:01:14 +0300 Subject: [PATCH 037/814] Curate explorer listings --- .../WalletApp/BusinessLayer/ListingsSertice/Listings.swift | 3 +++ .../WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift | 2 +- .../Wallet/Notifications/Models/ListingViewModel.swift | 4 ++++ .../Wallet/Notifications/NotificationsPresenter.swift | 3 ++- 4 files changed, 10 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/BusinessLayer/ListingsSertice/Listings.swift b/Example/WalletApp/BusinessLayer/ListingsSertice/Listings.swift index 4ab2673c9..276c56072 100644 --- a/Example/WalletApp/BusinessLayer/ListingsSertice/Listings.swift +++ b/Example/WalletApp/BusinessLayer/ListingsSertice/Listings.swift @@ -17,4 +17,7 @@ struct Listing: Codable { let homepage: String? let image_url: ImageURL? let dapp_url: String + let order: Int? + let is_verified: Bool + let is_featured: Bool } diff --git a/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift b/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift index 8e3700db7..c121e1e38 100644 --- a/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift +++ b/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift @@ -16,7 +16,7 @@ enum ListingsAPI: HTTPService { } var queryParameters: [String : String]? { - return ["projectId": InputConfig.projectId, "entries": "100", "is_verified": "false"] + return ["projectId": InputConfig.projectId, "entries": "100"] } var additionalHeaderFields: [String : String]? { diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/ListingViewModel.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/ListingViewModel.swift index 08286926d..f74194ff0 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/ListingViewModel.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/ListingViewModel.swift @@ -24,4 +24,8 @@ struct ListingViewModel: Identifiable { let url = listing.dapp_url return URL(string: url)?.host } + + var order: Int { + return listing.order ?? 10000 + } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsPresenter.swift index 91a573857..6bf09eda2 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsPresenter.swift @@ -23,8 +23,9 @@ final class NotificationsPresenter: ObservableObject { var listingViewModels: [ListingViewModel] { return listings .map { ListingViewModel(listing: $0) } - .sorted(by: + .sorted(by: { subscription(forListing: $0) != nil && subscription(forListing: $1) == nil }, + { $0.order < $1.order }, { $0.title < $1.title } ) } From 674639259c653493587c06344401c2450f0c75fa Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 13:54:40 +0100 Subject: [PATCH 038/814] migrate to group on read --- .../Keychain/KeychainStorage.swift | 67 ++++++++++++++++--- 1 file changed, 56 insertions(+), 11 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index d354cad91..f530ee428 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -10,12 +10,18 @@ public protocol KeychainStorageProtocol { public final class KeychainStorage: KeychainStorageProtocol { private let service: String + private let accessGroup: String private let secItem: KeychainServiceProtocol - public init(keychainService: KeychainServiceProtocol = KeychainServiceWrapper(), serviceIdentifier: String) { + public init( + keychainService: KeychainServiceProtocol = KeychainServiceWrapper(), + serviceIdentifier: String, + accessGroup: String + ) { self.secItem = keychainService - service = serviceIdentifier + self.accessGroup = accessGroup + self.service = serviceIdentifier } public func add(_ item: T, forKey key: String) throws where T: GenericPasswordConvertible { @@ -45,7 +51,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } public func readData(key: String) throws -> Data? { - var query = buildBaseServiceQuery(for: key) + var query = buildBaseServiceQuery(for: key, accessGroup: accessGroup) query[kSecReturnData] = true var item: CFTypeRef? @@ -55,7 +61,14 @@ public final class KeychainStorage: KeychainStorageProtocol { case errSecSuccess: return item as? Data case errSecItemNotFound: - return tryMigrateAttrAccessibleOnRead(key: key) // TODO: Replace with nil once migration period ends + // Try to update the accessibility attribute first + if let updatedData = tryUpdateAccessibilityAttributeOnRead(key: key) { + // Then attempt to migrate to the new access group + try migrateKeyToNewAccessGroup(key: key, data: updatedData) + return updatedData + } else { + return nil + } default: throw KeychainError(status) } @@ -82,7 +95,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } public func delete(key: String) throws { - let query = buildBaseServiceQuery(for: key) + let query = buildBaseServiceQuery(for: key, accessGroup: accessGroup) let status = secItem.delete(query as CFDictionary) @@ -102,8 +115,8 @@ public final class KeychainStorage: KeychainStorageProtocol { } } - private func buildBaseServiceQuery(for key: String) -> [CFString: Any] { - return [ + private func buildBaseServiceQuery(for key: String, accessGroup: String? = nil) -> [CFString: Any] { + var query: [CFString: Any] = [ kSecClass: kSecClassGenericPassword, kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly, kSecAttrIsInvisible: true, @@ -111,26 +124,58 @@ public final class KeychainStorage: KeychainStorageProtocol { kSecAttrService: service, kSecAttrAccount: key ] + + // Add the access group to the query if it's provided + if let accessGroup = accessGroup { + query[kSecAttrAccessGroup] = accessGroup + } + + return query } - private func tryMigrateAttrAccessibleOnRead(key: String) -> Data? { + + private func tryUpdateAccessibilityAttributeOnRead(key: String) -> Data? { var updateQuery = buildBaseServiceQuery(for: key) updateQuery[kSecAttrAccessible] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly let attributes = [kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly] let status = secItem.update(updateQuery as CFDictionary, attributes as CFDictionary) - guard status == errSecSuccess else { + print("tryUpdateAccessibilityAttributeOnRead status: \(status.message) \(status.description)") + + if status != errSecSuccess { return nil } + + // Try to read the item again with updated accessibility var readQuery = buildBaseServiceQuery(for: key) readQuery[kSecReturnData] = true var item: CFTypeRef? - _ = secItem.copyMatching(readQuery as CFDictionary, &item) + let readStatus = secItem.copyMatching(readQuery as CFDictionary, &item) - return item as? Data + if readStatus == errSecSuccess, let data = item as? Data { + return data + } else { + return nil + } + } + + private func migrateKeyToNewAccessGroup(key: String, data: Data) throws { + // Update the item to include the new access group + let query = buildBaseServiceQuery(for: key) + let attributesToUpdate = [ + kSecValueData: data, + kSecAttrAccessGroup: accessGroup + ] as [CFString: Any] + + let updateStatus = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) + + print("migrateKeyToNewAccessGroup status: \(updateStatus) \(updateStatus.message) \(updateStatus.description)") + guard updateStatus == errSecSuccess else { + throw KeychainError(updateStatus) + } } private func tryMigrateAttrAccessibleOnUpdate(data: Data, key: String) throws { From d48d87a34c5343261f46ccd9c3dfd15d9ee3548e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 14:01:26 +0100 Subject: [PATCH 039/814] savepoint --- Example/PNDecryptionService/NotificationService.swift | 2 +- Sources/Web3Wallet/Web3WalletDecryptionService.swift | 6 +----- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 250d19ca7..e51414f4b 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -38,7 +38,7 @@ class NotificationService: UNNotificationServiceExtension { do { let web3WalletDecryptionService = try Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") -// let rpcRequest = try web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) + let rpcRequest = try web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext, requestMethod: requestMethod) let mutableContent = content.mutableCopy() as! UNMutableNotificationContent diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index 724b3f8a8..e9321e7fb 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -1,9 +1,6 @@ import Foundation public final class Web3WalletDecryptionService { - enum Errors: Error { - case unknownTag - } public enum RequestMethod: UInt { case sessionRequest = 1108 case sessionProposal = 1100 @@ -22,8 +19,7 @@ public final class Web3WalletDecryptionService { return RequestMethod(rawValue: tag) } - public func decryptMessage(topic: String, ciphertext: String, tag: UInt) throws -> RPCRequest { - guard let requestMethod = Self.getRequestMethod(tag: tag) else { throw Errors.unknownTag } + public func decryptMessage(topic: String, ciphertext: String, requestMethod: RequestMethod) throws -> RPCRequest { switch requestMethod { case .sessionProposal, .sessionRequest: return try signDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) From 5026e6900a1415cd06191845f19d53b2090155db Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 14:07:22 +0100 Subject: [PATCH 040/814] fix build --- Example/ExampleApp.xcodeproj/project.pbxproj | 7 ------- Sources/Auth/AuthClientFactory.swift | 2 +- .../WalletConnectNetworking/NetworkingClientFactory.swift | 2 +- .../Client/Wallet/NotifyClientFactory.swift | 2 +- Sources/WalletConnectPairing/PairingClientFactory.swift | 2 +- Sources/WalletConnectPush/PushClientFactory.swift | 2 +- Sources/WalletConnectRelay/RelayClientFactory.swift | 2 +- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 2 +- Sources/WalletConnectSync/SyncClientFactory.swift | 2 +- 9 files changed, 8 insertions(+), 15 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 4f5a2101c..ea92b71d8 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -265,7 +265,6 @@ C56EE276293F56D7004840D1 /* UIViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE26C293F56D6004840D1 /* UIViewController.swift */; }; C56EE279293F56D7004840D1 /* Color.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE268293F56D6004840D1 /* Color.swift */; }; C56EE27B293F56F8004840D1 /* WalletConnectAuth in Frameworks */ = {isa = PBXBuildFile; productRef = C56EE27A293F56F8004840D1 /* WalletConnectAuth */; }; - C56EE27D293F56F8004840D1 /* WalletConnectChat in Frameworks */ = {isa = PBXBuildFile; productRef = C56EE27C293F56F8004840D1 /* WalletConnectChat */; }; C56EE288293F5757004840D1 /* ThirdPartyConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE286293F5757004840D1 /* ThirdPartyConfigurator.swift */; }; C56EE289293F5757004840D1 /* Application.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE280293F5757004840D1 /* Application.swift */; }; C56EE28A293F5757004840D1 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE27F293F5757004840D1 /* AppDelegate.swift */; }; @@ -781,7 +780,6 @@ files = ( A573C53D29EC366500E3CBFD /* HDWalletKit in Frameworks */, A59D25EE2AB3672700D7EA3A /* AsyncButton in Frameworks */, - C56EE27D293F56F8004840D1 /* WalletConnectChat in Frameworks */, C5133A78294125CC00A8314C /* Web3 in Frameworks */, C5B2F7052970573D000DBA0E /* SolanaSwift in Frameworks */, 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */, @@ -2129,7 +2127,6 @@ packageProductDependencies = ( C56EE254293F569A004840D1 /* Starscream */, C56EE27A293F56F8004840D1 /* WalletConnectAuth */, - C56EE27C293F56F8004840D1 /* WalletConnectChat */, C5133A77294125CC00A8314C /* Web3 */, C55D349829630D440004314A /* Web3Wallet */, C5B2F7042970573D000DBA0E /* SolanaSwift */, @@ -3576,10 +3573,6 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnectAuth; }; - C56EE27C293F56F8004840D1 /* WalletConnectChat */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectChat; - }; C579FEB52AFA86CD008855EB /* Web3Modal */ = { isa = XCSwiftPackageProductDependency; package = A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */; diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index da5bf4025..173915038 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -11,7 +11,7 @@ public struct AuthClientFactory { ) -> AuthClient { let logger = ConsoleLogger(loggingLevel: .off) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) let iatProvider = DefaultIATProvider() return AuthClientFactory.create( diff --git a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift index b1d159c31..305cf66cd 100644 --- a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift +++ b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift @@ -8,7 +8,7 @@ public struct NetworkingClientFactory { ) -> NetworkingInteractor { let logger = ConsoleLogger(prefix: "🕸️", loggingLevel: .off) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) return NetworkingClientFactory.create(relayClient: relayClient, logger: logger, keychainStorage: keychainStorage, keyValueStorage: keyValueStorage) } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 96728d9e9..4d265d828 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -5,7 +5,7 @@ public struct NotifyClientFactory { public static func create(projectId: String, groupIdentifier: String, networkInteractor: NetworkInteracting, pairingRegisterer: PairingRegisterer, pushClient: PushClient, crypto: CryptoProvider, notifyHost: String, explorerHost: String) -> NotifyClient { let logger = ConsoleLogger(prefix: "🔔",loggingLevel: .debug) let keyserverURL = URL(string: "https://keys.walletconnect.com")! - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) let groupKeychainService = GroupKeychainStorage(serviceIdentifier: groupIdentifier) let databasePath = databasePath(appGroup: groupIdentifier, database: "notify.db") let sqlite = DiskSqlite(path: databasePath) diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 6a7e8c852..101dcfdc9 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -8,7 +8,7 @@ public struct PairingClientFactory { ) -> PairingClient { let logger = ConsoleLogger(loggingLevel: .off) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) return PairingClientFactory.create(logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, networkingClient: networkingClient) } diff --git a/Sources/WalletConnectPush/PushClientFactory.swift b/Sources/WalletConnectPush/PushClientFactory.swift index 60a3a9ad6..36491c5c9 100644 --- a/Sources/WalletConnectPush/PushClientFactory.swift +++ b/Sources/WalletConnectPush/PushClientFactory.swift @@ -8,7 +8,7 @@ public struct PushClientFactory { environment: APNSEnvironment ) -> PushClient { - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard return PushClientFactory.create( diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 34eac70db..c2eb30b11 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -14,7 +14,7 @@ public struct RelayClientFactory { let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) let logger = ConsoleLogger(prefix: "🚄" ,loggingLevel: .off) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 4da9b3787..5a05a2997 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -19,7 +19,7 @@ public struct SignClientFactory { ) -> SignClient { let logger = ConsoleLogger(loggingLevel: .debug) let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) return SignClientFactory.create(metadata: metadata, logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, pairingClient: pairingClient, networkingClient: networkingClient) } diff --git a/Sources/WalletConnectSync/SyncClientFactory.swift b/Sources/WalletConnectSync/SyncClientFactory.swift index da91d61fe..86d4f4782 100644 --- a/Sources/WalletConnectSync/SyncClientFactory.swift +++ b/Sources/WalletConnectSync/SyncClientFactory.swift @@ -3,7 +3,7 @@ import Foundation final class SyncClientFactory { static func create(networkInteractor: NetworkInteracting, bip44: BIP44Provider) -> SyncClient { - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) return create(networkInteractor: networkInteractor, bip44: bip44, keychain: keychain) } From 9ee0f4a27b3ce712cdb66b25a7849b3fc35e332b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 14:45:52 +0100 Subject: [PATCH 041/814] savepoint --- .../Keychain/KeychainStorage.swift | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index f530ee428..a260297bf 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -62,13 +62,14 @@ public final class KeychainStorage: KeychainStorageProtocol { return item as? Data case errSecItemNotFound: // Try to update the accessibility attribute first - if let updatedData = tryUpdateAccessibilityAttributeOnRead(key: key) { + tryUpdateAccessibilityAttributeOnRead(key: key) // Then attempt to migrate to the new access group - try migrateKeyToNewAccessGroup(key: key, data: updatedData) + if let updatedData = try tryToMigrateKeyToNewAccessGroup(key: key) { return updatedData } else { return nil } + default: throw KeychainError(status) } @@ -134,7 +135,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } - private func tryUpdateAccessibilityAttributeOnRead(key: String) -> Data? { + private func tryUpdateAccessibilityAttributeOnRead(key: String) { var updateQuery = buildBaseServiceQuery(for: key) updateQuery[kSecAttrAccessible] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly @@ -144,29 +145,16 @@ public final class KeychainStorage: KeychainStorageProtocol { print("tryUpdateAccessibilityAttributeOnRead status: \(status.message) \(status.description)") if status != errSecSuccess { - return nil - } - - - // Try to read the item again with updated accessibility - var readQuery = buildBaseServiceQuery(for: key) - readQuery[kSecReturnData] = true - - var item: CFTypeRef? - let readStatus = secItem.copyMatching(readQuery as CFDictionary, &item) - - if readStatus == errSecSuccess, let data = item as? Data { - return data - } else { - return nil + print("tryUpdateAccessibilityAttributeOnRead status: \(status.message) \(status.description) potentially already migrated") + } else if status == errSecSuccess { + print("successfuly migrated to kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly") } } - private func migrateKeyToNewAccessGroup(key: String, data: Data) throws { + private func tryToMigrateKeyToNewAccessGroup(key: String) throws -> Data? { // Update the item to include the new access group let query = buildBaseServiceQuery(for: key) let attributesToUpdate = [ - kSecValueData: data, kSecAttrAccessGroup: accessGroup ] as [CFString: Any] @@ -176,6 +164,18 @@ public final class KeychainStorage: KeychainStorageProtocol { guard updateStatus == errSecSuccess else { throw KeychainError(updateStatus) } + // Try to read the item again with updated accessibility + var readQuery = buildBaseServiceQuery(for: key, accessGroup: accessGroup) + readQuery[kSecReturnData] = true + + var item: CFTypeRef? + let readStatus = secItem.copyMatching(readQuery as CFDictionary, &item) + + if readStatus == errSecSuccess, let data = item as? Data { + return data + } else { + return nil + } } private func tryMigrateAttrAccessibleOnUpdate(data: Data, key: String) throws { From 37a6d65624345185f7d7bd5267818ce67ca923c6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 15:03:51 +0100 Subject: [PATCH 042/814] savepoint --- .../Keychain/KeychainStorage.swift | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index a260297bf..57b6563af 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -63,7 +63,7 @@ public final class KeychainStorage: KeychainStorageProtocol { case errSecItemNotFound: // Try to update the accessibility attribute first tryUpdateAccessibilityAttributeOnRead(key: key) - // Then attempt to migrate to the new access group + // Then attempt to migrate to the new access group and return if item exists if let updatedData = try tryToMigrateKeyToNewAccessGroup(key: key) { return updatedData } else { @@ -126,7 +126,6 @@ public final class KeychainStorage: KeychainStorageProtocol { kSecAttrAccount: key ] - // Add the access group to the query if it's provided if let accessGroup = accessGroup { query[kSecAttrAccessGroup] = accessGroup } @@ -142,12 +141,10 @@ public final class KeychainStorage: KeychainStorageProtocol { let attributes = [kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly] let status = secItem.update(updateQuery as CFDictionary, attributes as CFDictionary) - print("tryUpdateAccessibilityAttributeOnRead status: \(status.message) \(status.description)") - - if status != errSecSuccess { - print("tryUpdateAccessibilityAttributeOnRead status: \(status.message) \(status.description) potentially already migrated") - } else if status == errSecSuccess { - print("successfuly migrated to kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly") + if status == errSecSuccess { + print("Successfuly migrated with kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly") + } else { + print("Item for query not found, item potentially already migrated with kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly") } } @@ -160,7 +157,7 @@ public final class KeychainStorage: KeychainStorageProtocol { let updateStatus = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) - print("migrateKeyToNewAccessGroup status: \(updateStatus) \(updateStatus.message) \(updateStatus.description)") + print("Migrate Key To New Access Group status: \(updateStatus)") guard updateStatus == errSecSuccess else { throw KeychainError(updateStatus) } From ab1d5f0c886a105b2bbc8fe3441afded6387ede8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 15:06:41 +0100 Subject: [PATCH 043/814] fatal error on unsuccessful userdefaults init --- Sources/Auth/AuthClientFactory.swift | 4 +++- .../WalletConnectNetworking/NetworkingClientFactory.swift | 4 +++- Sources/WalletConnectPairing/PairingClientFactory.swift | 4 +++- Sources/WalletConnectPush/PushClientFactory.swift | 6 ++++-- Sources/WalletConnectRelay/RelayClientFactory.swift | 6 ++++-- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 4 +++- 6 files changed, 20 insertions(+), 8 deletions(-) diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index da5bf4025..1251a77cc 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -10,7 +10,9 @@ public struct AuthClientFactory { groupIdentifier: String ) -> AuthClient { let logger = ConsoleLogger(loggingLevel: .off) - let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard + guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { + fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") + } let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") let iatProvider = DefaultIATProvider() diff --git a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift index b1d159c31..b7d898d90 100644 --- a/Sources/WalletConnectNetworking/NetworkingClientFactory.swift +++ b/Sources/WalletConnectNetworking/NetworkingClientFactory.swift @@ -7,7 +7,9 @@ public struct NetworkingClientFactory { groupIdentifier: String ) -> NetworkingInteractor { let logger = ConsoleLogger(prefix: "🕸️", loggingLevel: .off) - let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard + guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { + fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") + } let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return NetworkingClientFactory.create(relayClient: relayClient, logger: logger, keychainStorage: keychainStorage, keyValueStorage: keyValueStorage) } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 6a7e8c852..89bfef58e 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -7,7 +7,9 @@ public struct PairingClientFactory { groupIdentifier: String ) -> PairingClient { let logger = ConsoleLogger(loggingLevel: .off) - let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard + guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { + fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") + } let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return PairingClientFactory.create(logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, networkingClient: networkingClient) } diff --git a/Sources/WalletConnectPush/PushClientFactory.swift b/Sources/WalletConnectPush/PushClientFactory.swift index 60a3a9ad6..75f9874bc 100644 --- a/Sources/WalletConnectPush/PushClientFactory.swift +++ b/Sources/WalletConnectPush/PushClientFactory.swift @@ -9,8 +9,10 @@ public struct PushClientFactory { ) -> PushClient { let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") - let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - + guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { + fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") + } + return PushClientFactory.create( projectId: projectId, pushHost: pushHost, diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 34eac70db..0891517ae 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -12,8 +12,10 @@ public struct RelayClientFactory { socketConnectionType: SocketConnectionType ) -> RelayClient { - let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard - + guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { + fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") + } + let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") let logger = ConsoleLogger(prefix: "🚄" ,loggingLevel: .off) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 4da9b3787..2ae1ccaf9 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -18,7 +18,9 @@ public struct SignClientFactory { groupIdentifier: String ) -> SignClient { let logger = ConsoleLogger(loggingLevel: .debug) - let keyValueStorage = UserDefaults(suiteName: groupIdentifier) ?? UserDefaults.standard + guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { + fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") + } let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") return SignClientFactory.create(metadata: metadata, logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, pairingClient: pairingClient, networkingClient: networkingClient) } From c652009fed19e7db146d1755b8f3156eb5780151 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 Nov 2023 15:42:27 +0100 Subject: [PATCH 044/814] add thread safety for migration --- .../Keychain/KeychainStorage.swift | 22 ++++++++++--------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index 57b6563af..0568ce8c3 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -11,6 +11,7 @@ public final class KeychainStorage: KeychainStorageProtocol { private let service: String private let accessGroup: String + private let synchronizationQueue = DispatchQueue(label: "com.yourapp.KeychainStorage") private let secItem: KeychainServiceProtocol @@ -61,15 +62,16 @@ public final class KeychainStorage: KeychainStorageProtocol { case errSecSuccess: return item as? Data case errSecItemNotFound: - // Try to update the accessibility attribute first - tryUpdateAccessibilityAttributeOnRead(key: key) - // Then attempt to migrate to the new access group and return if item exists - if let updatedData = try tryToMigrateKeyToNewAccessGroup(key: key) { - return updatedData - } else { - return nil + return try synchronizationQueue.sync { + // Try to update the accessibility attribute first + tryUpdateAccessibilityAttribute(key: key) + // Then attempt to migrate to the new access group and return if item exists + if let updatedData = try tryToMigrateKeyToNewAccessGroupOnRead(key: key) { + return updatedData + } else { + return nil + } } - default: throw KeychainError(status) } @@ -134,7 +136,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } - private func tryUpdateAccessibilityAttributeOnRead(key: String) { + private func tryUpdateAccessibilityAttribute(key: String) { var updateQuery = buildBaseServiceQuery(for: key) updateQuery[kSecAttrAccessible] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly @@ -148,7 +150,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } } - private func tryToMigrateKeyToNewAccessGroup(key: String) throws -> Data? { + private func tryToMigrateKeyToNewAccessGroupOnRead(key: String) throws -> Data? { // Update the item to include the new access group let query = buildBaseServiceQuery(for: key) let attributesToUpdate = [ From 2e63200545ba6bb3c538e8b381e44b6bdecf41a9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 30 Nov 2023 07:12:08 +0100 Subject: [PATCH 045/814] migrate on update --- .../Keychain/KeychainStorage.swift | 69 +++++++++---------- 1 file changed, 34 insertions(+), 35 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index 0568ce8c3..493f71ce7 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -52,7 +52,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } public func readData(key: String) throws -> Data? { - var query = buildBaseServiceQuery(for: key, accessGroup: accessGroup) + var query = buildBaseServiceQuery(for: key) query[kSecReturnData] = true var item: CFTypeRef? @@ -63,9 +63,9 @@ public final class KeychainStorage: KeychainStorageProtocol { return item as? Data case errSecItemNotFound: return try synchronizationQueue.sync { - // Try to update the accessibility attribute first + // Try to update the accessibility attribute first - migration V1 tryUpdateAccessibilityAttribute(key: key) - // Then attempt to migrate to the new access group and return if item exists + // Then attempt to migrate to the new access group and return if item exists - migration V2 if let updatedData = try tryToMigrateKeyToNewAccessGroupOnRead(key: key) { return updatedData } else { @@ -86,19 +86,23 @@ public final class KeychainStorage: KeychainStorageProtocol { let attributes = [kSecValueData: data] let status = secItem.update(query as CFDictionary, attributes as CFDictionary) - + switch status { case errSecSuccess: return case errSecItemNotFound: - try tryMigrateAttrAccessibleOnUpdate(data: data, key: key) // TODO: Remove once migration period ends + // Try to update the accessibility attribute - migration V1 + tryUpdateAccessibilityAttribute(key: key) + // Then attempt to migrate to the new access group - migration V2 + try tryToMigrateKeyToNewAccessGroupOnUpdate(data: data, key: key) default: throw KeychainError(status) } } + public func delete(key: String) throws { - let query = buildBaseServiceQuery(for: key, accessGroup: accessGroup) + let query = buildBaseServiceQuery(for: key) let status = secItem.delete(query as CFDictionary) @@ -118,26 +122,22 @@ public final class KeychainStorage: KeychainStorageProtocol { } } - private func buildBaseServiceQuery(for key: String, accessGroup: String? = nil) -> [CFString: Any] { - var query: [CFString: Any] = [ + private func buildBaseServiceQuery(for key: String) -> [CFString: Any] { + return [ kSecClass: kSecClassGenericPassword, kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly, kSecAttrIsInvisible: true, kSecUseDataProtectionKeychain: true, kSecAttrService: service, + kSecAttrAccessGroup: accessGroup, kSecAttrAccount: key ] - - if let accessGroup = accessGroup { - query[kSecAttrAccessGroup] = accessGroup - } - - return query } private func tryUpdateAccessibilityAttribute(key: String) { var updateQuery = buildBaseServiceQuery(for: key) + updateQuery.removeValue(forKey: kSecAttrAccessGroup) updateQuery[kSecAttrAccessible] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly let attributes = [kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly] @@ -151,20 +151,10 @@ public final class KeychainStorage: KeychainStorageProtocol { } private func tryToMigrateKeyToNewAccessGroupOnRead(key: String) throws -> Data? { - // Update the item to include the new access group - let query = buildBaseServiceQuery(for: key) - let attributesToUpdate = [ - kSecAttrAccessGroup: accessGroup - ] as [CFString: Any] - - let updateStatus = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) + try tryToMigrateToNewAccessGroup(key: key) - print("Migrate Key To New Access Group status: \(updateStatus)") - guard updateStatus == errSecSuccess else { - throw KeychainError(updateStatus) - } // Try to read the item again with updated accessibility - var readQuery = buildBaseServiceQuery(for: key, accessGroup: accessGroup) + var readQuery = buildBaseServiceQuery(for: key) readQuery[kSecReturnData] = true var item: CFTypeRef? @@ -177,16 +167,9 @@ public final class KeychainStorage: KeychainStorageProtocol { } } - private func tryMigrateAttrAccessibleOnUpdate(data: Data, key: String) throws { - var updateAccessQuery = buildBaseServiceQuery(for: key) - updateAccessQuery[kSecAttrAccessible] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly + private func tryToMigrateKeyToNewAccessGroupOnUpdate(data: Data, key: String) throws { - let accessAttributes = [kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly] - let accessStatus = secItem.update(updateAccessQuery as CFDictionary, accessAttributes as CFDictionary) - - guard accessStatus == errSecSuccess else { - throw KeychainError.itemNotFound - } + try tryToMigrateToNewAccessGroup(key: key) let updateQuery = buildBaseServiceQuery(for: key) let updateAttributes = [kSecValueData: data] @@ -197,4 +180,20 @@ public final class KeychainStorage: KeychainStorageProtocol { throw KeychainError.itemNotFound } } + + private func tryToMigrateToNewAccessGroup(key: String) throws { + var query = buildBaseServiceQuery(for: key) + query.removeValue(forKey: kSecAttrAccessGroup) + + let attributesToUpdate = [ + kSecAttrAccessGroup: accessGroup + ] as [CFString: Any] + + let updateStatus = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) + + print("Migrate Key To New Access Group status: \(updateStatus)") + guard updateStatus == errSecSuccess else { + throw KeychainError(updateStatus) + } + } } From 4ed3ba9af01eff0071ef5e981c5f6ef7f89e5cd8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 30 Nov 2023 07:18:14 +0100 Subject: [PATCH 046/814] fix build --- .../xcschemes/WalletConnect.xcscheme | 24 +++++++++++-------- .../HistoryClientFactory.swift | 2 +- .../KeychainStorageTests.swift | 3 ++- 3 files changed, 17 insertions(+), 12 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme index 351e9f253..d1bc7d784 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme @@ -160,6 +160,20 @@ ReferencedContainer = "container:.."> + + + + - - - - HistoryClient { - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") let keyValueStorage = UserDefaults.standard let logger = ConsoleLogger() return HistoryClientFactory.create( diff --git a/Tests/WalletConnectKMSTests/KeychainStorageTests.swift b/Tests/WalletConnectKMSTests/KeychainStorageTests.swift index 422f23bcf..dab9eac14 100644 --- a/Tests/WalletConnectKMSTests/KeychainStorageTests.swift +++ b/Tests/WalletConnectKMSTests/KeychainStorageTests.swift @@ -17,7 +17,8 @@ final class KeychainStorageTests: XCTestCase { fakeKeychain = KeychainServiceFake() sut = KeychainStorage( keychainService: fakeKeychain, - serviceIdentifier: "") + serviceIdentifier: "", + accessGroup: "") } override func tearDown() { From 7bf4c89db4eda92aadd9bcb9ccd09198f5a6ed6d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 30 Nov 2023 07:56:46 +0100 Subject: [PATCH 047/814] fix tests --- Sources/WalletConnectKMS/Keychain/KeychainStorage.swift | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index 493f71ce7..fa521095a 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -189,11 +189,12 @@ public final class KeychainStorage: KeychainStorageProtocol { kSecAttrAccessGroup: accessGroup ] as [CFString: Any] - let updateStatus = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) + let status = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) - print("Migrate Key To New Access Group status: \(updateStatus)") - guard updateStatus == errSecSuccess else { - throw KeychainError(updateStatus) + if status == errSecSuccess { + print("Successfuly migrated with kSecAttrAccessGroup") + } else { + print("Item for query not found, item potentially already migrated with kSecAttrAccessGroup") } } } From bab4983489fa6eca4981658f5d241d98fff36f97 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 30 Nov 2023 08:15:09 +0100 Subject: [PATCH 048/814] fix build all --- Sources/Chat/ChatClientFactory.swift | 3 ++- Sources/WalletConnectSync/SyncClientFactory.swift | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/Sources/Chat/ChatClientFactory.swift b/Sources/Chat/ChatClientFactory.swift index d8f336381..ebce9f3c3 100644 --- a/Sources/Chat/ChatClientFactory.swift +++ b/Sources/Chat/ChatClientFactory.swift @@ -3,7 +3,8 @@ import Foundation public struct ChatClientFactory { static func create(keyserverUrl: String, relayClient: RelayClient, networkingInteractor: NetworkingInteractor, syncClient: SyncClient, historyClient: HistoryClient) -> ChatClient { - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk") + fatalError("fix access group") + let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") let keyserverURL = URL(string: keyserverUrl)! return ChatClientFactory.create( keyserverURL: keyserverURL, diff --git a/Sources/WalletConnectSync/SyncClientFactory.swift b/Sources/WalletConnectSync/SyncClientFactory.swift index 86d4f4782..bd92adba8 100644 --- a/Sources/WalletConnectSync/SyncClientFactory.swift +++ b/Sources/WalletConnectSync/SyncClientFactory.swift @@ -3,7 +3,8 @@ import Foundation final class SyncClientFactory { static func create(networkInteractor: NetworkInteracting, bip44: BIP44Provider) -> SyncClient { - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) + fatalError("fix access group") + let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") return create(networkInteractor: networkInteractor, bip44: bip44, keychain: keychain) } From 7bf30888baf944f8153a03af9f91facb75754e73 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 30 Nov 2023 10:09:35 +0100 Subject: [PATCH 049/814] savepoint --- .../WalletApp/ApplicationLayer/Application.swift | 3 ++- .../Keychain/KeychainStorage.swift | 16 ++-------------- 2 files changed, 4 insertions(+), 15 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/Application.swift b/Example/WalletApp/ApplicationLayer/Application.swift index 95e3a6ab8..6c3814b55 100644 --- a/Example/WalletApp/ApplicationLayer/Application.swift +++ b/Example/WalletApp/ApplicationLayer/Application.swift @@ -1,5 +1,6 @@ import Foundation -import WalletConnectChat +import WalletConnectUtils +import WalletConnectSigner final class Application { var uri: WalletConnectURI? diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index fa521095a..b75cc681c 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -141,13 +141,7 @@ public final class KeychainStorage: KeychainStorageProtocol { updateQuery[kSecAttrAccessible] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly let attributes = [kSecAttrAccessible: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly] - let status = secItem.update(updateQuery as CFDictionary, attributes as CFDictionary) - - if status == errSecSuccess { - print("Successfuly migrated with kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly") - } else { - print("Item for query not found, item potentially already migrated with kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly") - } + let _ = secItem.update(updateQuery as CFDictionary, attributes as CFDictionary) } private func tryToMigrateKeyToNewAccessGroupOnRead(key: String) throws -> Data? { @@ -189,12 +183,6 @@ public final class KeychainStorage: KeychainStorageProtocol { kSecAttrAccessGroup: accessGroup ] as [CFString: Any] - let status = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) - - if status == errSecSuccess { - print("Successfuly migrated with kSecAttrAccessGroup") - } else { - print("Item for query not found, item potentially already migrated with kSecAttrAccessGroup") - } + let _ = secItem.update(query as CFDictionary, attributesToUpdate as CFDictionary) } } From a71a055fedca01960dfce19f2bf82f40d9323f46 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 30 Nov 2023 11:46:32 +0100 Subject: [PATCH 050/814] remove throw --- Sources/WalletConnectKMS/Keychain/KeychainStorage.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift index b75cc681c..1eec34e86 100644 --- a/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift +++ b/Sources/WalletConnectKMS/Keychain/KeychainStorage.swift @@ -145,7 +145,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } private func tryToMigrateKeyToNewAccessGroupOnRead(key: String) throws -> Data? { - try tryToMigrateToNewAccessGroup(key: key) + tryToMigrateToNewAccessGroup(key: key) // Try to read the item again with updated accessibility var readQuery = buildBaseServiceQuery(for: key) @@ -163,7 +163,7 @@ public final class KeychainStorage: KeychainStorageProtocol { private func tryToMigrateKeyToNewAccessGroupOnUpdate(data: Data, key: String) throws { - try tryToMigrateToNewAccessGroup(key: key) + tryToMigrateToNewAccessGroup(key: key) let updateQuery = buildBaseServiceQuery(for: key) let updateAttributes = [kSecValueData: data] @@ -175,7 +175,7 @@ public final class KeychainStorage: KeychainStorageProtocol { } } - private func tryToMigrateToNewAccessGroup(key: String) throws { + private func tryToMigrateToNewAccessGroup(key: String) { var query = buildBaseServiceQuery(for: key) query.removeValue(forKey: kSecAttrAccessGroup) From 5b05a65628fe3d2de7bf6a125bdf0e1dc209533e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 07:36:10 +0100 Subject: [PATCH 051/814] fix build --- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 4 ++-- .../Wallet/Notifications/NotificationsView.swift | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 229e0f8ef..465b92c16 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "e68c1b1560264965ca13608db44294d301c6404f", - "version": "1.0.9" + "revision": "3295d69d1b12df29a5040578d107f56986b1b399", + "version": "1.0.13" } } ] diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift index 2daa40746..a3146cbd8 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift @@ -191,7 +191,7 @@ struct NotificationsView: View { AsyncButton("Subscribed") { try await presenter.unsubscribe(subscription: subscription) } - .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, rightIcon: .Checkmark)) + .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, rightIcon: Image.Medium.checkmark)) .disabled(true) } else { AsyncButton("Subscribe") { From 63b204dbc05b9b6089cff8e241cc7b2854e58bdc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 09:03:03 +0100 Subject: [PATCH 052/814] refactor to handle request types --- .../NotificationService.swift | 22 ++++---- Sources/Auth/AuthDecryptionService.swift | 9 +++- .../SignDecryptionService.swift | 18 ++++++- .../Web3WalletDecryptionService.swift | 54 +++++++++++++++---- 4 files changed, 79 insertions(+), 24 deletions(-) diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index e51414f4b..095403342 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -20,8 +20,8 @@ class NotificationService: UNNotificationServiceExtension { let ciphertext = content.userInfo["message"] as? String, let tag = content.userInfo["tag"] as? UInt { - if let w3wRequestMethod = Web3WalletDecryptionService.getRequestMethod(tag: tag) { - let mutableContent = handleWeb3WalletNotification(content: content, topic: topic, requestMethod: w3wRequestMethod, ciphertext: ciphertext) + if Web3WalletDecryptionService.canHandle(tag: tag) { + let mutableContent = handleWeb3WalletNotification(content: content, topic: topic, tag: tag, ciphertext: ciphertext) contentHandler(mutableContent) } else if NotifyDecryptionService.canHandle(tag: tag) { let mutableContent = handleNotifyNotification(content: content, topic: topic, ciphertext: ciphertext) @@ -33,13 +33,12 @@ class NotificationService: UNNotificationServiceExtension { } } - private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, requestMethod: Web3WalletDecryptionService.RequestMethod, ciphertext: String) -> UNMutableNotificationContent { + private func handleWeb3WalletNotification(content: UNNotificationContent, topic: String, tag: UInt, ciphertext: String) -> UNMutableNotificationContent { do { let web3WalletDecryptionService = try Web3WalletDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") - let rpcRequest = try web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext, requestMethod: requestMethod) - + let decryptedPayload = try web3WalletDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext, tag: tag) let mutableContent = content.mutableCopy() as! UNMutableNotificationContent @@ -48,13 +47,18 @@ class NotificationService: UNNotificationServiceExtension { return mutableContent } - switch requestMethod { + switch decryptedPayload.requestMethod { case .sessionProposal: - mutableContent.title = "session proposal: \(metadata.name)" + mutableContent.title = "New session proposal!" + mutableContent.body = "A new session proposal arrived from \(metadata.name), please check your wallet" case .sessionRequest: - mutableContent.title = "session request: \(metadata.name)" + if let payload = decryptedPayload as? RequestPayload { + mutableContent.title = "New session request!" + mutableContent.body = "A new session request \(payload.requestMethod) arrived from \(metadata.name), please check your wallet" + } case .authRequest: - mutableContent.title = "auth request: \(metadata.name)" + mutableContent.title = "New authentication request!" + mutableContent.body = "A new authentication request arrived from \(metadata.name), please check your wallet" } return mutableContent diff --git a/Sources/Auth/AuthDecryptionService.swift b/Sources/Auth/AuthDecryptionService.swift index 8ba0c8e2e..5674d52b9 100644 --- a/Sources/Auth/AuthDecryptionService.swift +++ b/Sources/Auth/AuthDecryptionService.swift @@ -3,6 +3,7 @@ import Foundation public class AuthDecryptionService { enum Errors: Error { case couldNotInitialiseDefaults + case couldNotDecodeTypeFromCiphertext } private let serializer: Serializing private let pairingStorage: PairingStorage @@ -17,10 +18,14 @@ public class AuthDecryptionService { pairingStorage = PairingStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: PairStorageIdentifiers.pairings.rawValue))) } - public func decryptMessage(topic: String, ciphertext: String) throws -> RPCRequest { + public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthRequest { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) setPairingMetadata(rpcRequest: rpcRequest, topic: topic) - return rpcRequest + if let request = try rpcRequest.params?.get(AuthRequest.self) { + return request + } else { + throw Errors.couldNotDecodeTypeFromCiphertext + } } public func getMetadata(topic: String) -> AppMetadata? { diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index 5b80c49e6..182384698 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -3,6 +3,7 @@ import Foundation public class SignDecryptionService { enum Errors: Error { case couldNotInitialiseDefaults + case couldNotDecodeTypeFromCiphertext } private let serializer: Serializing private let sessionStorage: WCSessionStorage @@ -17,9 +18,22 @@ public class SignDecryptionService { sessionStorage = SessionStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: SignStorageIdentifiers.sessions.rawValue))) } - public func decryptMessage(topic: String, ciphertext: String) throws -> RPCRequest { + public func decryptProposal(topic: String, ciphertext: String) throws -> Session.Proposal { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) - return rpcRequest + if let proposal = try rpcRequest.params?.get(Session.Proposal.self) { + return proposal + } else { + throw Errors.couldNotDecodeTypeFromCiphertext + } + } + + public func decryptRequest(topic: String, ciphertext: String) throws -> Request { + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + if let request = try rpcRequest.params?.get(Request.self) { + return request + } else { + throw Errors.couldNotDecodeTypeFromCiphertext + } } public func getMetadata(topic: String) -> AppMetadata? { diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index e9321e7fb..2171eeb39 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -1,6 +1,10 @@ import Foundation +import WalletConnectSign public final class Web3WalletDecryptionService { + enum Errors: Error { + case unknownTag + } public enum RequestMethod: UInt { case sessionRequest = 1108 case sessionProposal = 1100 @@ -9,23 +13,15 @@ public final class Web3WalletDecryptionService { private let signDecryptionService: SignDecryptionService private let authDecryptionService: AuthDecryptionService + private static let w3wTags: [UInt] = [1108, 1100, 3000] public init(groupIdentifier: String) throws { self.authDecryptionService = try AuthDecryptionService(groupIdentifier: groupIdentifier) self.signDecryptionService = try SignDecryptionService(groupIdentifier: groupIdentifier) } - public static func getRequestMethod(tag: UInt) -> RequestMethod? { - return RequestMethod(rawValue: tag) - } - - public func decryptMessage(topic: String, ciphertext: String, requestMethod: RequestMethod) throws -> RPCRequest { - switch requestMethod { - case .sessionProposal, .sessionRequest: - return try signDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) - case .authRequest: - return try authDecryptionService.decryptMessage(topic: topic, ciphertext: ciphertext) - } + public static func canHandle(tag: UInt) -> Bool { + return w3wTags.contains(tag) } public func getMetadata(topic: String) -> AppMetadata? { @@ -35,4 +31,40 @@ public final class Web3WalletDecryptionService { return authDecryptionService.getMetadata(topic: topic) } } + + public func decryptMessage(topic: String, ciphertext: String, tag: UInt) throws -> DecryptedPayloadProtocol { + guard let requestMethod = RequestMethod(rawValue: tag) else { throw Errors.unknownTag } + switch requestMethod { + case .sessionProposal: + let proposal = try signDecryptionService.decryptProposal(topic: topic, ciphertext: ciphertext) + return ProposalPayload(proposal: proposal) + case .sessionRequest: + let request = try signDecryptionService.decryptRequest(topic: topic, ciphertext: ciphertext) + return RequestPayload(request: request) + case .authRequest: + let request = try authDecryptionService.decryptAuthRequest(topic: topic, ciphertext: ciphertext) + return AuthRequestPayload(authRequest: request) + } + } + + +} + +public protocol DecryptedPayloadProtocol { + var requestMethod: Web3WalletDecryptionService.RequestMethod { get } +} + +public struct RequestPayload: DecryptedPayloadProtocol { + public var requestMethod: Web3WalletDecryptionService.RequestMethod { .sessionRequest } + var request: Request +} + +public struct ProposalPayload: DecryptedPayloadProtocol { + public var requestMethod: Web3WalletDecryptionService.RequestMethod { .sessionProposal } + var proposal: Session.Proposal +} + +public struct AuthRequestPayload: DecryptedPayloadProtocol { + public var requestMethod: Web3WalletDecryptionService.RequestMethod { .authRequest } + var authRequest: AuthRequest } From e44cef0951cb41f0790cb98ea598382baa5b79b3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 09:26:43 +0100 Subject: [PATCH 053/814] fix session request notification --- .../PNDecryptionService/NotificationService.swift | 2 +- .../WalletConnectSign/SignDecryptionService.swift | 12 +++++++++++- Sources/Web3Wallet/Web3WalletDecryptionService.swift | 6 +++--- 3 files changed, 15 insertions(+), 5 deletions(-) diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 095403342..474de9fd2 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -54,7 +54,7 @@ class NotificationService: UNNotificationServiceExtension { case .sessionRequest: if let payload = decryptedPayload as? RequestPayload { mutableContent.title = "New session request!" - mutableContent.body = "A new session request \(payload.requestMethod) arrived from \(metadata.name), please check your wallet" + mutableContent.body = "A new session request \(payload.request.method) arrived from \(metadata.name), please check your wallet" } case .authRequest: mutableContent.title = "New authentication request!" diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index 182384698..8549cd428 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -29,7 +29,17 @@ public class SignDecryptionService { public func decryptRequest(topic: String, ciphertext: String) throws -> Request { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) - if let request = try rpcRequest.params?.get(Request.self) { + if let request = try rpcRequest.params?.get(SessionType.RequestParams.self), + let rpcId = rpcRequest.id{ + let request = Request( + id: rpcId, + topic: topic, + method: request.request.method, + params: request.request.params, + chainId: request.chainId, + expiry: request.request.expiry + ) + return request } else { throw Errors.couldNotDecodeTypeFromCiphertext diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index 2171eeb39..e4786129f 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -56,15 +56,15 @@ public protocol DecryptedPayloadProtocol { public struct RequestPayload: DecryptedPayloadProtocol { public var requestMethod: Web3WalletDecryptionService.RequestMethod { .sessionRequest } - var request: Request + public var request: Request } public struct ProposalPayload: DecryptedPayloadProtocol { public var requestMethod: Web3WalletDecryptionService.RequestMethod { .sessionProposal } - var proposal: Session.Proposal + public var proposal: Session.Proposal } public struct AuthRequestPayload: DecryptedPayloadProtocol { public var requestMethod: Web3WalletDecryptionService.RequestMethod { .authRequest } - var authRequest: AuthRequest + public var authRequest: AuthRequest } From 8083877d5e7f3e303fd04d3cc7d5b3f6669e3146 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 09:30:40 +0100 Subject: [PATCH 054/814] fix session proposal --- Sources/WalletConnectSign/SignDecryptionService.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index 8549cd428..8b0e82125 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -20,8 +20,8 @@ public class SignDecryptionService { public func decryptProposal(topic: String, ciphertext: String) throws -> Session.Proposal { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) - if let proposal = try rpcRequest.params?.get(Session.Proposal.self) { - return proposal + if let proposal = try rpcRequest.params?.get(SessionType.ProposeParams.self) { + return proposal.publicRepresentation(pairingTopic: topic) } else { throw Errors.couldNotDecodeTypeFromCiphertext } From 52fa7b8faa49c8fc21ff975a3a9b9304456a4e17 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 09:49:19 +0100 Subject: [PATCH 055/814] fix auth request --- Sources/Auth/AuthDecryptionService.swift | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Sources/Auth/AuthDecryptionService.swift b/Sources/Auth/AuthDecryptionService.swift index 5674d52b9..9c2c55d61 100644 --- a/Sources/Auth/AuthDecryptionService.swift +++ b/Sources/Auth/AuthDecryptionService.swift @@ -21,8 +21,10 @@ public class AuthDecryptionService { public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthRequest { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) setPairingMetadata(rpcRequest: rpcRequest, topic: topic) - if let request = try rpcRequest.params?.get(AuthRequest.self) { - return request + if let params = try rpcRequest.params?.get(AuthRequestParams.self), + let id = rpcRequest.id { + let authRequest = AuthRequest(id: id, topic: topic, payload: params.payloadParams, requester: params.requester.metadata) + return authRequest } else { throw Errors.couldNotDecodeTypeFromCiphertext } From 78be65a138a88c39480bb02e9b3db1b89f1b10e4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 11:55:11 +0100 Subject: [PATCH 056/814] fix build --- Example/DApp/SceneDelegate.swift | 1 - 1 file changed, 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index c08b15a8b..b9b49d56c 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -28,7 +28,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { Web3Modal.configure( projectId: InputConfig.projectId, - chainId: Blockchain("eip155:1")!, metadata: metadata ) From e7e759b9ba383acf69203cfee8d40d21238e3b14 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 12:53:56 +0100 Subject: [PATCH 057/814] add mixpanel to w3w --- .../xcshareddata/swiftpm/Package.resolved | 4 ++-- Example/WalletApp/ApplicationLayer/ProfilingService.swift | 3 +++ Sources/WalletConnectPairing/PairingClient.swift | 4 ++++ Sources/WalletConnectPairing/PairingClientProtocol.swift | 3 +++ Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 3 +++ Sources/WalletConnectSign/Sign/SignClient.swift | 4 ++++ Sources/WalletConnectSign/Sign/SignClientFactory.swift | 2 +- Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 3 ++- Sources/Web3Wallet/Web3WalletClient.swift | 6 ++++++ 9 files changed, 28 insertions(+), 4 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 229e0f8ef..dceba93f5 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "e68c1b1560264965ca13608db44294d301c6404f", - "version": "1.0.9" + "revision": "831410cfd6e68afa7212a5547483fb2d180f0fa7", + "version": "1.0.10" } } ] diff --git a/Example/WalletApp/ApplicationLayer/ProfilingService.swift b/Example/WalletApp/ApplicationLayer/ProfilingService.swift index bfffe219a..ed46d3771 100644 --- a/Example/WalletApp/ApplicationLayer/ProfilingService.swift +++ b/Example/WalletApp/ApplicationLayer/ProfilingService.swift @@ -2,6 +2,7 @@ import Foundation import Mixpanel import WalletConnectNetworking import Combine +import Web3Wallet import WalletConnectNotify final class ProfilingService { @@ -34,6 +35,8 @@ final class ProfilingService { handleLogs(from: Networking.instance.logsPublisher) handleLogs(from: Notify.instance.logsPublisher) handleLogs(from: Push.instance.logsPublisher) + handleLogs(from: Web3Wallet.instance.logsPublisher) + } private func handleLogs(from publisher: AnyPublisher) { diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 3eafd2838..c9ca77413 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -23,6 +23,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let cleanupService: PairingCleanupService + public var logsPublisher: AnyPublisher { + return logger.logsPublisher + } + init( pairingStorage: WCPairingStorage, appPairService: AppPairService, diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index 098293c19..e025f7fd6 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -1,4 +1,7 @@ +import Combine + public protocol PairingClientProtocol { + var logsPublisher: AnyPublisher {get} func pair(uri: WalletConnectURI) async throws func disconnect(topic: String) async throws func getPairings() -> [Pairing] diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 7e26a2725..8c994c094 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -61,6 +61,7 @@ final class ApproveEngine { } func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws { + logger.debug("Approving session proposal") guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { throw Errors.wrongRequestParams } @@ -112,6 +113,8 @@ final class ApproveEngine { _ = try await [proposeResponse, settleRequest] + logger.debug("Session proposal response and settle request have been sent") + pairingRegisterer.activate( pairingTopic: payload.topic, peerMetadata: payload.request.proposer.metadata diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 299e6c4b1..b87864de1 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -95,6 +95,10 @@ public final class SignClient: SignClientProtocol { sessionsPublisherSubject.eraseToAnyPublisher() } + public var logsPublisher: AnyPublisher { + return logger.logsPublisher + } + /// An object that loggs SDK's errors and info messages public let logger: ConsoleLogging diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 2ae1ccaf9..50828b997 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -17,7 +17,7 @@ public struct SignClientFactory { networkingClient: NetworkingInteractor, groupIdentifier: String ) -> SignClient { - let logger = ConsoleLogger(loggingLevel: .debug) + let logger = ConsoleLogger(prefix: "📝", loggingLevel: .debug) guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 0d83845b1..2b174ddec 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -11,7 +11,8 @@ public protocol SignClientProtocol { var sessionResponsePublisher: AnyPublisher { get } var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { get } var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> { get } - + var logsPublisher: AnyPublisher {get} + func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]?) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index a90093a10..19e27790f 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -63,6 +63,12 @@ public class Web3WalletClient { signClient.sessionResponsePublisher.eraseToAnyPublisher() } + public var logsPublisher: AnyPublisher { + return signClient.logsPublisher + .merge(with: pairingClient.logsPublisher) + .eraseToAnyPublisher() + } + // MARK: - Private Properties private let authClient: AuthClientProtocol private let signClient: SignClientProtocol From 08f34df8309e5fc1629eb8ac64e2e05b83187d19 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 12:59:50 +0100 Subject: [PATCH 058/814] fix build --- Example/DApp/SceneDelegate.swift | 1 - 1 file changed, 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index c08b15a8b..b9b49d56c 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -28,7 +28,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { Web3Modal.configure( projectId: InputConfig.projectId, - chainId: Blockchain("eip155:1")!, metadata: metadata ) From 2796535338348009261523ed33d29b42238b069a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 13:05:47 +0100 Subject: [PATCH 059/814] Add pairing logs --- .../Services/Wallet/WalletPairService.swift | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index c962b8a41..7c04a0acc 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -10,21 +10,26 @@ actor WalletPairService { let kms: KeyManagementServiceProtocol private let pairingStorage: WCPairingStorage private let history: RPCHistory + private let logger: ConsoleLogging init( networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, pairingStorage: WCPairingStorage, - history: RPCHistory + history: RPCHistory, + logger: ConsoleLogging ) { self.networkingInteractor = networkingInteractor self.kms = kms self.pairingStorage = pairingStorage self.history = history + self.logger = logger } func pair(_ uri: WalletConnectURI) async throws { + logger.debug("Pairing with uri: \(uri)") guard try !pairingHasPendingRequest(for: uri.topic) else { + logger.debug("Pairing with topic (\(uri.topic)) has pending request") return } @@ -35,6 +40,7 @@ actor WalletPairService { let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { + logger.debug("Pairing failed - Network is not connected") throw Errors.networkNotConnected } From e80f0bb193002f1f085097767279e3e7d56f541d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 13:11:02 +0100 Subject: [PATCH 060/814] fix build --- Sources/WalletConnectPairing/PairingClientFactory.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index fa9652dc1..d24b76adb 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -26,7 +26,7 @@ public struct PairingClientFactory { let kms = KeyManagementService(keychain: keychainStorage) let history = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) let appPairService = AppPairService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore) - let walletPairService = WalletPairService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, history: history) + let walletPairService = WalletPairService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, history: history, logger: logger) let pairingRequestsSubscriber = PairingRequestsSubscriber(networkingInteractor: networkingClient, pairingStorage: pairingStore, logger: logger) let pairingsProvider = PairingsProvider(pairingStorage: pairingStore) let cleanupService = PairingCleanupService(pairingStore: pairingStore, kms: kms) From 0783f0f67fa01826613b207baa40dc50a0f970cf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Dec 2023 13:20:43 +0100 Subject: [PATCH 061/814] fix tests build --- .../WalletConnectPairingTests/WalletPairServiceTests.swift | 2 +- Tests/Web3WalletTests/Mocks/PairingClientMock.swift | 6 ++++++ Tests/Web3WalletTests/Mocks/SignClientMock.swift | 5 +++++ 3 files changed, 12 insertions(+), 1 deletion(-) diff --git a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift index 4f88e9c94..5483d669c 100644 --- a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift +++ b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift @@ -18,7 +18,7 @@ final class WalletPairServiceTestsTests: XCTestCase { storageMock = WCPairingStorageMock() cryptoMock = KeyManagementServiceMock() rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: RuntimeKeyValueStorage()) - service = WalletPairService(networkingInteractor: networkingInteractor, kms: cryptoMock, pairingStorage: storageMock, history: rpcHistory) + service = WalletPairService(networkingInteractor: networkingInteractor, kms: cryptoMock, pairingStorage: storageMock, history: rpcHistory, logger: ConsoleLoggerMock()) } func testPairWhenNetworkNotConnectedThrows() async { diff --git a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift index 562e01ef5..edf3f1390 100644 --- a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift @@ -4,6 +4,12 @@ import Combine @testable import WalletConnectPairing final class PairingClientMock: PairingClientProtocol { + private var logsSubject = PassthroughSubject() + + var logsPublisher: AnyPublisher { + return logsSubject.eraseToAnyPublisher() + } + var pairCalled = false var disconnectPairingCalled = false diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index e14d222c4..de4b3cb22 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -4,6 +4,11 @@ import Combine @testable import WalletConnectSign final class SignClientMock: SignClientProtocol { + private var logsSubject = PassthroughSubject() + + var logsPublisher: AnyPublisher { + return logsSubject.eraseToAnyPublisher() + } var approveCalled = false var rejectCalled = false var updateCalled = false From 150cfe25ec3b19991329aaf71cd83c94c5f8d5f2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 5 Dec 2023 12:43:10 +0100 Subject: [PATCH 062/814] add PairingDeleteRequestSubscriber --- .../xcshareddata/swiftpm/Package.resolved | 4 +- .../Notifications/NotificationsView.swift | 2 +- .../WalletConnectPairing/PairingClient.swift | 11 +++-- .../PairingClientFactory.swift | 4 +- .../RPCParams/PairingDeleteParams.swift | 7 +++ .../PairingDeleteRequestSubscriber.swift | 43 +++++++++++++++++++ .../PairingDeleteRequester.swift} | 2 +- 7 files changed, 63 insertions(+), 10 deletions(-) create mode 100644 Sources/WalletConnectPairing/RPCParams/PairingDeleteParams.swift create mode 100644 Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequestSubscriber.swift rename Sources/WalletConnectPairing/Services/Common/{DeletePairingService.swift => Delete/PairingDeleteRequester.swift} (97%) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 465b92c16..229e0f8ef 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "3295d69d1b12df29a5040578d107f56986b1b399", - "version": "1.0.13" + "revision": "e68c1b1560264965ca13608db44294d301c6404f", + "version": "1.0.9" } } ] diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift index a3146cbd8..3ced27e6b 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift @@ -191,7 +191,7 @@ struct NotificationsView: View { AsyncButton("Subscribed") { try await presenter.unsubscribe(subscription: subscription) } - .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, rightIcon: Image.Medium.checkmark)) + .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, rightIcon: Image.Checkmark)) .disabled(true) } else { AsyncButton("Subscribe") { diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index c9ca77413..43164c16f 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -17,9 +17,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let networkingInteractor: NetworkInteracting private let pairingRequestsSubscriber: PairingRequestsSubscriber private let pairingsProvider: PairingsProvider - private let deletePairingService: DeletePairingService + private let pairingDeleteRequester: PairingDeleteRequester private let resubscribeService: PairingResubscribeService private let expirationService: ExpirationService + private let pairingDeleteRequestSubscriber: PairingDeleteRequestSubscriber private let cleanupService: PairingCleanupService @@ -33,7 +34,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient networkingInteractor: NetworkInteracting, logger: ConsoleLogging, walletPairService: WalletPairService, - deletePairingService: DeletePairingService, + pairingDeleteRequester: PairingDeleteRequester, + pairingDeleteRequestSubscriber: PairingDeleteRequestSubscriber, resubscribeService: PairingResubscribeService, expirationService: ExpirationService, pairingRequestsSubscriber: PairingRequestsSubscriber, @@ -49,7 +51,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient self.networkingInteractor = networkingInteractor self.socketConnectionStatusPublisher = socketConnectionStatusPublisher self.logger = logger - self.deletePairingService = deletePairingService + self.pairingDeleteRequester = pairingDeleteRequester + self.pairingDeleteRequestSubscriber = pairingDeleteRequestSubscriber self.appPairActivateService = appPairActivateService self.resubscribeService = resubscribeService self.expirationService = expirationService @@ -112,7 +115,7 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient } public func disconnect(topic: String) async throws { - try await deletePairingService.delete(topic: topic) + try await pairingDeleteRequester.delete(topic: topic) } public func validatePairingExistance(_ topic: String) throws { diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index d24b76adb..e57c53114 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -30,7 +30,7 @@ public struct PairingClientFactory { let pairingRequestsSubscriber = PairingRequestsSubscriber(networkingInteractor: networkingClient, pairingStorage: pairingStore, logger: logger) let pairingsProvider = PairingsProvider(pairingStorage: pairingStore) let cleanupService = PairingCleanupService(pairingStore: pairingStore, kms: kms) - let deletePairingService = DeletePairingService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) + let pairingDeleteRequester = PairingDeleteRequester(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) let pingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appPairActivateService = AppPairActivationService(pairingStorage: pairingStore, logger: logger) let expirationService = ExpirationService(pairingStorage: pairingStore, networkInteractor: networkingClient, kms: kms) @@ -42,7 +42,7 @@ public struct PairingClientFactory { networkingInteractor: networkingClient, logger: logger, walletPairService: walletPairService, - deletePairingService: deletePairingService, + pairingDeleteRequester: pairingDeleteRequester, resubscribeService: resubscribeService, expirationService: expirationService, pairingRequestsSubscriber: pairingRequestsSubscriber, diff --git a/Sources/WalletConnectPairing/RPCParams/PairingDeleteParams.swift b/Sources/WalletConnectPairing/RPCParams/PairingDeleteParams.swift new file mode 100644 index 000000000..6f3495514 --- /dev/null +++ b/Sources/WalletConnectPairing/RPCParams/PairingDeleteParams.swift @@ -0,0 +1,7 @@ + +import Foundation + +struct PairingDeleteParams: Codable { + let code: Int + let message: String +} diff --git a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequestSubscriber.swift b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequestSubscriber.swift new file mode 100644 index 000000000..ab81a5266 --- /dev/null +++ b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequestSubscriber.swift @@ -0,0 +1,43 @@ +import Combine + +public final class PairingDeleteRequestSubscriber { + private let networkingInteractor: NetworkInteracting + private let logger: ConsoleLogging + private let pairingStorage: WCPairingStorage + private let kms: KeyManagementServiceProtocol + let deletePublisherSubject = PassthroughSubject<(code: Int, message: String), Never>() + + private var publishers = [AnyCancellable]() + + public init( + networkingInteractor: NetworkInteracting, + kms: KeyManagementServiceProtocol, + pairingStorage: WCPairingStorage, + logger: ConsoleLogging + ) { + self.networkingInteractor = networkingInteractor + self.kms = kms + self.pairingStorage = pairingStorage + self.logger = logger + subscribeDeleteRequest() + } + + private func subscribeDeleteRequest() { + let method = PairingProtocolMethod.delete + networkingInteractor.requestSubscription(on: method) + .sink { [unowned self] (payload: RequestSubscriptionPayload) in + + let topic = payload.topic + logger.debug("Received pairing delete request") + pairingStorage.delete(topic: topic) + kms.deleteSymmetricKey(for: topic) + networkingInteractor.unsubscribe(topic: topic) + + deletePublisherSubject.send((code: payload.request.code, message: payload.request.message)) + Task(priority: .high) { + try? await networkingInteractor.respondSuccess(topic: payload.topic, requestId: payload.id, protocolMethod: method) + } + } + .store(in: &publishers) + } +} diff --git a/Sources/WalletConnectPairing/Services/Common/DeletePairingService.swift b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift similarity index 97% rename from Sources/WalletConnectPairing/Services/Common/DeletePairingService.swift rename to Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift index afa43e517..7f5d10cbd 100644 --- a/Sources/WalletConnectPairing/Services/Common/DeletePairingService.swift +++ b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift @@ -1,6 +1,6 @@ import Foundation -class DeletePairingService { +class PairingDeleteRequester { private let networkingInteractor: NetworkInteracting private let kms: KeyManagementServiceProtocol private let pairingStorage: WCPairingStorage From ccab7b7932270b49af02aa94627c6946674a912e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 5 Dec 2023 12:46:53 +0100 Subject: [PATCH 063/814] add pairingDeletePublisher --- Sources/WalletConnectPairing/PairingClient.swift | 4 ++++ Sources/WalletConnectPairing/PairingClientFactory.swift | 2 ++ Sources/WalletConnectPairing/PairingClientProtocol.swift | 1 + Sources/Web3Wallet/Web3WalletClient.swift | 4 ++++ 4 files changed, 11 insertions(+) diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 43164c16f..16d8f0076 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -5,6 +5,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient public var pingResponsePublisher: AnyPublisher<(String), Never> { pingResponsePublisherSubject.eraseToAnyPublisher() } + public var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> { + pairingDeleteRequestSubscriber.deletePublisherSubject.eraseToAnyPublisher() + } + public let socketConnectionStatusPublisher: AnyPublisher private let pairingStorage: WCPairingStorage diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index e57c53114..902ba7d28 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -35,6 +35,7 @@ public struct PairingClientFactory { let appPairActivateService = AppPairActivationService(pairingStorage: pairingStore, logger: logger) let expirationService = ExpirationService(pairingStorage: pairingStore, networkInteractor: networkingClient, kms: kms) let resubscribeService = PairingResubscribeService(networkInteractor: networkingClient, pairingStorage: pairingStore) + let pairingDeleteRequestSubscriber = PairingDeleteRequestSubscriber(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) return PairingClient( pairingStorage: pairingStore, @@ -43,6 +44,7 @@ public struct PairingClientFactory { logger: logger, walletPairService: walletPairService, pairingDeleteRequester: pairingDeleteRequester, + pairingDeleteRequestSubscriber: pairingDeleteRequestSubscriber, resubscribeService: resubscribeService, expirationService: expirationService, pairingRequestsSubscriber: pairingRequestsSubscriber, diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index e025f7fd6..7edd05b30 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -2,6 +2,7 @@ import Combine public protocol PairingClientProtocol { var logsPublisher: AnyPublisher {get} + var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> {get} func pair(uri: WalletConnectURI) async throws func disconnect(topic: String) async throws func getPairings() -> [Pairing] diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 38fc6d213..75e4a7dff 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -63,6 +63,10 @@ public class Web3WalletClient { signClient.sessionResponsePublisher.eraseToAnyPublisher() } + public var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> { + pairingClient.pairingDeletePublisher + } + public var logsPublisher: AnyPublisher { return signClient.logsPublisher .merge(with: pairingClient.logsPublisher) From be6cd029afa5d96937668eea89c930e26b9ef303 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 5 Dec 2023 14:16:05 +0100 Subject: [PATCH 064/814] refactor pairing tests --- .../Pairing/PairingTests.swift | 85 ++++++------------- 1 file changed, 28 insertions(+), 57 deletions(-) diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index bbea6aa46..26f0554de 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -23,13 +23,11 @@ final class PairingTests: XCTestCase { private var publishers = [AnyCancellable]() - func makeClientDependencies(prefix: String) -> (PairingClient, NetworkingInteractor, KeychainStorageProtocol, KeyValueStorage) { + func makeClients(prefix: String) -> (PairingClient, AuthClient) { let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() - let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) - let pairingLogger = ConsoleLogger(prefix: prefix + " [Pairing]", loggingLevel: .debug) - let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) + let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) let relayClient = RelayClientFactory.create( relayHost: InputConfig.relayHost, @@ -37,81 +35,45 @@ final class PairingTests: XCTestCase { keyValueStorage: RuntimeKeyValueStorage(), keychainStorage: keychain, socketFactory: DefaultSocketFactory(), - logger: relayLogger) + logger: logger) let networkingClient = NetworkingClientFactory.create( relayClient: relayClient, - logger: networkingLogger, + logger: logger, keychainStorage: keychain, keyValueStorage: keyValueStorage) let pairingClient = PairingClientFactory.create( - logger: pairingLogger, + logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychain, networkingClient: networkingClient) - let clientId = try! networkingClient.getClientId() - networkingLogger.debug("My client id is: \(clientId)") - - return (pairingClient, networkingClient, keychain, keyValueStorage) - } - func makeDappClients() { - let prefix = "🤖 Dapp: " - let (pairingClient, networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) - let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) - appPairingClient = pairingClient - - appAuthClient = AuthClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "wcdapp://", universal: nil)), - projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - logger: notifyLogger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingInteractor, - pairingRegisterer: pairingClient, - iatProvider: IATProviderMock()) - } - func makeWalletClients() { - let prefix = "🐶 Wallet: " - let (pairingClient, networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) - let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) - let defaults = RuntimeKeyValueStorage() - walletPairingClient = pairingClient - let historyClient = HistoryClientFactory.create( - historyUrl: "https://history.walletconnect.com", - relayUrl: "wss://relay.walletconnect.com", - keyValueStorage: defaults, - keychain: keychain, - logger: notifyLogger - ) - appAuthClient = AuthClientFactory.create( + let clientId = try! networkingClient.getClientId() + logger.debug("My client id is: \(clientId)") + + let authClient = AuthClientFactory.create( metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), projectId: InputConfig.projectId, crypto: DefaultCryptoProvider(), - logger: notifyLogger, + logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychain, - networkingClient: networkingInteractor, + networkingClient: networkingClient, pairingRegisterer: pairingClient, iatProvider: IATProviderMock()) - } - func makeWalletPairingClient() { - let prefix = "🐶 Wallet: " - let (pairingClient, _, _, _) = makeClientDependencies(prefix: prefix) - walletPairingClient = pairingClient + return (pairingClient, authClient) } override func setUp() { - makeDappClients() + (appPairingClient, appAuthClient) = makeClients(prefix: "🤖 Dapp: ") + (walletPairingClient, walletAuthClient) = makeClients(prefix: "🐶 Wallet: ") } func testPing() async { let expectation = expectation(description: "expects ping response") - makeWalletClients() let uri = try! await appPairingClient.create() try? await walletPairingClient.pair(uri: uri) try! await walletPairingClient.ping(topic: uri.topic) @@ -124,7 +86,6 @@ final class PairingTests: XCTestCase { } func testResponseErrorForMethodUnregistered() async { - makeWalletPairingClient() let expectation = expectation(description: "wallet responds unsupported method for unregistered method") appAuthClient.authResponsePublisher.sink { (_, response) in @@ -140,8 +101,18 @@ final class PairingTests: XCTestCase { wait(for: [expectation], timeout: InputConfig.defaultTimeout) } - - func testDisconnect() { - // TODO - } +// +// func testDisconnect() { +// +// let expectation = expectation(description: "wallet responds unsupported method for unregistered method") +// +// appAuthClient.authResponsePublisher.sink { (_, response) in +// XCTAssertEqual(response, .failure(AuthError(code: 10001)!)) +// expectation.fulfill() +// }.store(in: &publishers) +// +// let uri = try! await appPairingClient.create() +// +// try? await walletPairingClient.pair(uri: uri) +// } } From 019c5910848b9f3e510ff6dbaa625025a5b0db95 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Dec 2023 10:23:56 +0100 Subject: [PATCH 065/814] fix tests --- .../Pairing/PairingTests.swift | 36 ++++++++++--------- 1 file changed, 20 insertions(+), 16 deletions(-) diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 26f0554de..1a064f154 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -23,11 +23,11 @@ final class PairingTests: XCTestCase { private var publishers = [AnyCancellable]() - func makeClients(prefix: String) -> (PairingClient, AuthClient) { + func makeClients(prefix: String, includeAuth: Bool = true) -> (PairingClient, AuthClient?) { let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() - let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) + let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) let relayClient = RelayClientFactory.create( relayHost: InputConfig.relayHost, @@ -53,23 +53,27 @@ final class PairingTests: XCTestCase { let clientId = try! networkingClient.getClientId() logger.debug("My client id is: \(clientId)") - let authClient = AuthClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), - projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - logger: logger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient, - pairingRegisterer: pairingClient, - iatProvider: IATProviderMock()) - - return (pairingClient, authClient) + if includeAuth { + let authClient = AuthClientFactory.create( + metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), + projectId: InputConfig.projectId, + crypto: DefaultCryptoProvider(), + logger: logger, + keyValueStorage: keyValueStorage, + keychainStorage: keychain, + networkingClient: networkingClient, + pairingRegisterer: pairingClient, + iatProvider: IATProviderMock()) + + return (pairingClient, authClient) + } else { + return (pairingClient, nil) + } } override func setUp() { (appPairingClient, appAuthClient) = makeClients(prefix: "🤖 Dapp: ") - (walletPairingClient, walletAuthClient) = makeClients(prefix: "🐶 Wallet: ") + (walletPairingClient, _) = makeClients(prefix: "🐶 Wallet: ", includeAuth: false) } func testPing() async { @@ -95,7 +99,7 @@ final class PairingTests: XCTestCase { let uri = try! await appPairingClient.create() - try? await walletPairingClient.pair(uri: uri) + try! await walletPairingClient.pair(uri: uri) try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) From ee625130cae7b135d467c1b5bde377a0a008e2f2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Dec 2023 10:40:04 +0100 Subject: [PATCH 066/814] add testDisconnect --- .../Pairing/PairingTests.swift | 31 ++++++++++--------- .../Delete/PairingDeleteRequester.swift | 3 +- 2 files changed, 19 insertions(+), 15 deletions(-) diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 1a064f154..657530902 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -105,18 +105,21 @@ final class PairingTests: XCTestCase { wait(for: [expectation], timeout: InputConfig.defaultTimeout) } -// -// func testDisconnect() { -// -// let expectation = expectation(description: "wallet responds unsupported method for unregistered method") -// -// appAuthClient.authResponsePublisher.sink { (_, response) in -// XCTAssertEqual(response, .failure(AuthError(code: 10001)!)) -// expectation.fulfill() -// }.store(in: &publishers) -// -// let uri = try! await appPairingClient.create() -// -// try? await walletPairingClient.pair(uri: uri) -// } + + func testDisconnect() async { + + let expectation = expectation(description: "wallet disconnected pairing") + + + walletPairingClient.pairingDeletePublisher.sink { _ in + expectation.fulfill() + }.store(in: &publishers) + + let uri = try! await appPairingClient.create() + + try? await walletPairingClient.pair(uri: uri) + + try! await appPairingClient.disconnect(topic: uri.topic) + wait(for: [expectation], timeout: InputConfig.defaultTimeout) + } } diff --git a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift index 7f5d10cbd..f976a3cd0 100644 --- a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift +++ b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift @@ -19,8 +19,9 @@ class PairingDeleteRequester { func delete(topic: String) async throws { let reason = PairingReasonCode.userDisconnected let protocolMethod = PairingProtocolMethod.delete + let pairingDeleteParams = PairingDeleteParams(code: reason.code, message: reason.message) logger.debug("Will delete pairing for reason: message: \(reason.message) code: \(reason.code)") - let request = RPCRequest(method: protocolMethod.method, params: reason) + let request = RPCRequest(method: protocolMethod.method, params: pairingDeleteParams) try await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) pairingStorage.delete(topic: topic) kms.deleteSymmetricKey(for: topic) From 99cc66dcb6e2b59e7d9654bb1403a665d4c0c140 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Dec 2023 10:54:32 +0100 Subject: [PATCH 067/814] fix tests --- Tests/Web3WalletTests/Mocks/PairingClientMock.swift | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift index edf3f1390..0f0012d59 100644 --- a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift @@ -4,7 +4,14 @@ import Combine @testable import WalletConnectPairing final class PairingClientMock: PairingClientProtocol { - private var logsSubject = PassthroughSubject() + var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> { + pairingDeletePublisherSubject.eraseToAnyPublisher() + } + + var pairingDeletePublisherSubject = PassthroughSubject<(code: Int, message: String), Never>() + + + var logsSubject = PassthroughSubject() var logsPublisher: AnyPublisher { return logsSubject.eraseToAnyPublisher() From 40e721392bea122cfa0e792349c0be8332e1b150 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Dec 2023 10:58:11 +0100 Subject: [PATCH 068/814] fix build --- Example/DApp/SceneDelegate.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index b9b49d56c..528c5ffc6 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -28,6 +28,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { Web3Modal.configure( projectId: InputConfig.projectId, + chainId: Blockchain("eip155:1"), metadata: metadata ) From 0ed11f41c389f56cf1a2450bbab38292722636c3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Dec 2023 11:00:53 +0100 Subject: [PATCH 069/814] fix build --- Example/DApp/SceneDelegate.swift | 1 - .../xcshareddata/swiftpm/Package.resolved | 10 +++++----- .../Wallet/Notifications/NotificationsView.swift | 2 +- 3 files changed, 6 insertions(+), 7 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 528c5ffc6..b9b49d56c 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -28,7 +28,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { Web3Modal.configure( projectId: InputConfig.projectId, - chainId: Blockchain("eip155:1"), metadata: metadata ) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 229e0f8ef..f11eb5be8 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -33,7 +33,7 @@ "repositoryURL": "https://github.com/mixpanel/mixpanel-swift", "state": { "branch": "master", - "revision": "1ce27d937009d5ecce74dad97d69898ffea49c75", + "revision": "c6336881a077d283db6f6d6e2f242977250230bd", "version": null } }, @@ -69,8 +69,8 @@ "repositoryURL": "https://github.com/getsentry/sentry-cocoa.git", "state": { "branch": null, - "revision": "14aa6e47b03b820fd2b338728637570b9e969994", - "version": "8.12.0" + "revision": "74cf23b2946c92550fb1185612077151497e648e", + "version": "8.17.1" } }, { @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "e68c1b1560264965ca13608db44294d301c6404f", - "version": "1.0.9" + "revision": "3295d69d1b12df29a5040578d107f56986b1b399", + "version": "1.0.13" } } ] diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift index 3ced27e6b..a3146cbd8 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift @@ -191,7 +191,7 @@ struct NotificationsView: View { AsyncButton("Subscribed") { try await presenter.unsubscribe(subscription: subscription) } - .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, rightIcon: Image.Checkmark)) + .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, rightIcon: Image.Medium.checkmark)) .disabled(true) } else { AsyncButton("Subscribe") { From 5f5cf673086f4be5bfef3098c2be1d21d74e66cc Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 6 Dec 2023 16:11:54 +0300 Subject: [PATCH 070/814] New registration specs --- Example/Shared/ImportAccount.swift | 4 +- .../ConfigurationService.swift | 4 +- .../IdentityClient.swift | 16 ++++- .../WalletConnectIdentity/IdentityError.swift | 5 -- .../IdentityRegistrationParams.swift | 11 +++ .../IdentityService.swift | 72 ++++++++----------- .../Client/Wallet/NotifyClient.swift | 10 ++- .../Client/Wallet/NotifyIdentityService.swift | 25 ++++--- 8 files changed, 82 insertions(+), 65 deletions(-) delete mode 100644 Sources/WalletConnectIdentity/IdentityError.swift create mode 100644 Sources/WalletConnectIdentity/IdentityRegistrationParams.swift diff --git a/Example/Shared/ImportAccount.swift b/Example/Shared/ImportAccount.swift index 00e4c04e3..a4c65fed3 100644 --- a/Example/Shared/ImportAccount.swift +++ b/Example/Shared/ImportAccount.swift @@ -91,11 +91,11 @@ enum ImportAccount: Codable { } } - func onSign(message: String) -> SigningResult { + func onSign(message: String) -> CacaoSignature { let privateKey = Data(hex: privateKey) let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() let signature = try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - return .signed(signature) + return signature } static func new() -> ImportAccount { diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index d8cfd3afe..1fcfbd198 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -41,7 +41,9 @@ final class ConfigurationService { Task { do { - try await Notify.instance.register(account: importAccount.account, domain: "com.walletconnect", onSign: importAccount.onSign) + let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") + let signature = importAccount.onSign(message: params.message) + try await Notify.instance.register(params: params, signature: signature) } catch { DispatchQueue.main.async { let logMessage = LogMessage(message: "Push Server registration failed with: \(error.localizedDescription)") diff --git a/Sources/WalletConnectIdentity/IdentityClient.swift b/Sources/WalletConnectIdentity/IdentityClient.swift index a776adb09..d7a6e69a5 100644 --- a/Sources/WalletConnectIdentity/IdentityClient.swift +++ b/Sources/WalletConnectIdentity/IdentityClient.swift @@ -22,10 +22,20 @@ public final class IdentityClient { self.logger = logger } - public func register(account: Account, domain: String, statement: String, resources: [String], onSign: SigningCallback) async throws -> String { - let pubKey = try await identityService.registerIdentity(account: account, domain: domain, statement: statement, resources: resources, onSign: onSign) + public func prepareRegistration(account: Account, + domain: String, + statement: String, + resources: [String]) async throws -> IdentityRegistrationParams + { + let registration = try await identityService.prepareRegistration(account: account, domain: domain, statement: statement, resources: resources) + logger.debug("Did prepare registration for \(account)") + return registration + } + + public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { + let account = try params.account + try await identityService.registerIdentity(params: params, signature: signature) logger.debug("Did register an account: \(account)") - return pubKey } public func goPublic(account: Account) async throws -> AgreementPublicKey { diff --git a/Sources/WalletConnectIdentity/IdentityError.swift b/Sources/WalletConnectIdentity/IdentityError.swift deleted file mode 100644 index d3103601a..000000000 --- a/Sources/WalletConnectIdentity/IdentityError.swift +++ /dev/null @@ -1,5 +0,0 @@ -import Foundation - -enum IdentityError: Error { - case signatureRejected -} diff --git a/Sources/WalletConnectIdentity/IdentityRegistrationParams.swift b/Sources/WalletConnectIdentity/IdentityRegistrationParams.swift new file mode 100644 index 000000000..1089c2a34 --- /dev/null +++ b/Sources/WalletConnectIdentity/IdentityRegistrationParams.swift @@ -0,0 +1,11 @@ +import Foundation + +public struct IdentityRegistrationParams { + public let message: String + public let payload: CacaoPayload + public let privateIdentityKey: SigningPrivateKey + + public var account: Account { + get throws { try Account(DIDPKHString: payload.iss) } + } +} diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index 0a974c474..b2e85834b 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -25,23 +25,45 @@ actor IdentityService { self.messageFormatter = messageFormatter } - func registerIdentity(account: Account, + func prepareRegistration(account: Account, domain: String, statement: String, - resources: [String], - onSign: SigningCallback - ) async throws -> String { + resources: [String]) throws -> IdentityRegistrationParams { + + let identityKey = SigningPrivateKey() + + let payload = CacaoPayload( + iss: account.did, + domain: domain, + aud: identityKey.publicKey.did, + version: getVersion(), + nonce: getNonce(), + iat: iatProvader.iat, + nbf: nil, exp: nil, + statement: statement, + requestId: nil, + resources: resources + ) + + let message = try messageFormatter.formatMessage(from: payload) + + return IdentityRegistrationParams(message: message, payload: payload, privateIdentityKey: identityKey) + } + + // TODO: Verifications + func registerIdentity(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { + let account = try params.account if let identityKey = try? storage.getIdentityKey(for: account) { - return identityKey.publicKey.hexRepresentation + return } - let identityKey = SigningPrivateKey() - let audience = identityKey.publicKey.did - let cacao = try await makeCacao(account: account, domain: domain, statement: statement, resources: resources, audience: audience, onSign: onSign) + let cacaoHeader = CacaoHeader(t: "eip4361") + let cacao = Cacao(h: cacaoHeader, p: params.payload, s: signature) + try await networkService.registerIdentity(cacao: cacao) + try storage.saveIdentityKey(params.privateIdentityKey, for: account) - return try storage.saveIdentityKey(identityKey, for: account).publicKey.hexRepresentation } func registerInvite(account: Account) async throws -> AgreementPublicKey { @@ -89,38 +111,6 @@ actor IdentityService { private extension IdentityService { - func makeCacao(account: Account, - domain: String, - statement: String, - resources: [String], - audience: String, - onSign: SigningCallback - ) async throws -> Cacao { - - let cacaoHeader = CacaoHeader(t: "eip4361") - let cacaoPayload = CacaoPayload( - iss: account.did, - domain: domain, - aud: audience, - version: getVersion(), - nonce: getNonce(), - iat: iatProvader.iat, - nbf: nil, exp: nil, - statement: statement, - requestId: nil, - resources: resources - ) - - let result = await onSign(try messageFormatter.formatMessage(from: cacaoPayload)) - - switch result { - case .signed(let cacaoSignature): - return Cacao(h: cacaoHeader, p: cacaoPayload, s: cacaoSignature) - case .rejected: - throw IdentityError.signatureRejected - } - } - func makeIDAuth(account: Account, issuer: DIDKey, claims: Claims.Type) throws -> String { let identityKey = try storage.getIdentityKey(for: account) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 6a3ea77e5..41ef5d1d3 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -75,9 +75,13 @@ public class NotifyClient { self.subscriptionWatcher = subscriptionWatcher } - public func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping SigningCallback) async throws { - try await identityService.register(account: account, domain: domain, isLimited: isLimited, onSign: onSign) - notifyAccountProvider.setAccount(account) + public func prepareRegistration(account: Account, domain: String, allApps: Bool = false) async throws -> IdentityRegistrationParams { + return try await identityService.prepareRegistration(account: account, domain: domain, allApps: allApps) + } + + public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { + try await identityService.register(params: params, signature: signature) + notifyAccountProvider.setAccount(try params.account) try await subscriptionWatcher.start() } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift index 0ae95400b..a7e318760 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift @@ -1,5 +1,6 @@ import Foundation +// TODO: Remove final class NotifyIdentityService { private let keyserverURL: URL @@ -12,13 +13,17 @@ final class NotifyIdentityService { self.logger = logger } - public func register(account: Account, domain: String, isLimited: Bool, onSign: @escaping SigningCallback) async throws { - let statement = makeStatement(isLimited: isLimited) - _ = try await identityClient.register(account: account, + public func prepareRegistration(account: Account, domain: String, allApps: Bool) async throws -> IdentityRegistrationParams { + return try await identityClient.prepareRegistration( + account: account, domain: domain, - statement: statement, - resources: [keyserverURL.absoluteString], - onSign: onSign) + statement: makeStatement(allApps: allApps), + resources: [keyserverURL.absoluteString] + ) + } + + public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { + try await identityClient.register(params: params, signature: signature) } public func unregister(account: Account) async throws { @@ -32,11 +37,11 @@ final class NotifyIdentityService { private extension NotifyIdentityService { - func makeStatement(isLimited: Bool) -> String { - switch isLimited { - case true: - return "I further authorize this app to send me notifications. Read more at https://walletconnect.com/notifications" + func makeStatement(allApps: Bool) -> String { + switch allApps { case false: + return "I further authorize this app to send me notifications. Read more at https://walletconnect.com/notifications" + case true: return "I further authorize this app to view and manage my notifications for ALL apps. Read more at https://walletconnect.com/notifications" } } From b437f19f44695d50115711b5c7234452f58af6ea Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 6 Dec 2023 16:34:02 +0300 Subject: [PATCH 071/814] Integration tests --- .../IntegrationTests/Push/NotifyTests.swift | 13 ++++++-- Sources/Chat/ChatClient.swift | 33 ++++++++++++------- .../IdentityClient.swift | 6 ++-- .../IdentityService.swift | 5 +-- 4 files changed, 39 insertions(+), 18 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 98511240e..1b63c3d8f 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -258,8 +258,17 @@ final class NotifyTests: XCTestCase { private extension NotifyTests { - func sign(_ message: String) -> SigningResult { + func sign(_ message: String) -> CacaoSignature { let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) - return .signed(try! signer.sign(message: message, privateKey: privateKey, type: .eip191)) + return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) + } +} + +private extension NotifyClient { + + func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { + let params = try await prepareRegistration(account: account, domain: domain) + let signature = onSign(params.message) + try await register(params: params, signature: signature) } } diff --git a/Sources/Chat/ChatClient.swift b/Sources/Chat/ChatClient.swift index 13b66378b..80199e507 100644 --- a/Sources/Chat/ChatClient.swift +++ b/Sources/Chat/ChatClient.swift @@ -92,25 +92,34 @@ public class ChatClient { domain: String, onSign: @escaping SigningCallback ) async throws -> String { - let publicKey = try await identityClient.register( + + let params = try await identityClient.prepareRegistration( account: account, domain: domain, statement: "statement", - resources: ["https://keys.walletconnect.com"], - onSign: onSign + resources: ["https://keys.walletconnect.com"] ) - if !syncRegisterService.isRegistered(account: account) { - try await chatStorage.initializeHistory(account: account) - try await syncRegisterService.register(account: account, onSign: onSign) - } - guard !isPrivate else { - return publicKey - } + switch await onSign(params.message) { + case .signed(let signature): + let publicKey = try await identityClient.register(params: params, signature: signature) + + if !syncRegisterService.isRegistered(account: account) { + try await chatStorage.initializeHistory(account: account) + try await syncRegisterService.register(account: account, onSign: onSign) + } - try await goPublic(account: account) + guard !isPrivate else { + return publicKey + } - return publicKey + try await goPublic(account: account) + + return publicKey + + case .rejected: + fatalError("Not implemented") + } } /// Unregisters a blockchain account with previously registered identity key diff --git a/Sources/WalletConnectIdentity/IdentityClient.swift b/Sources/WalletConnectIdentity/IdentityClient.swift index d7a6e69a5..8958b5112 100644 --- a/Sources/WalletConnectIdentity/IdentityClient.swift +++ b/Sources/WalletConnectIdentity/IdentityClient.swift @@ -32,10 +32,12 @@ public final class IdentityClient { return registration } - public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { + @discardableResult + public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws -> String { let account = try params.account - try await identityService.registerIdentity(params: params, signature: signature) + let pubKey = try await identityService.registerIdentity(params: params, signature: signature) logger.debug("Did register an account: \(account)") + return pubKey } public func goPublic(account: Account) async throws -> AgreementPublicKey { diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index b2e85834b..96cd34215 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -51,11 +51,11 @@ actor IdentityService { } // TODO: Verifications - func registerIdentity(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { + func registerIdentity(params: IdentityRegistrationParams, signature: CacaoSignature) async throws -> String { let account = try params.account if let identityKey = try? storage.getIdentityKey(for: account) { - return + return identityKey.publicKey.hexRepresentation } let cacaoHeader = CacaoHeader(t: "eip4361") @@ -64,6 +64,7 @@ actor IdentityService { try await networkService.registerIdentity(cacao: cacao) try storage.saveIdentityKey(params.privateIdentityKey, for: account) + return params.privateIdentityKey.publicKey.hexRepresentation } func registerInvite(account: Account) async throws -> AgreementPublicKey { From af7a0f04dbb5d54c4e200909eadf17ecf0287045 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 7 Dec 2023 09:36:03 +0100 Subject: [PATCH 072/814] renam register method --- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 38fc6d213..21a93e5e8 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -218,7 +218,7 @@ public class Web3WalletClient { try authClient.getPendingRequests() } - public func registerPushClient(deviceToken: Data, enableEncrypted: Bool = false) async throws { + public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { try await pushClient.register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) } From be507924f085fbba053ac69e392a4bc80cc5a7c1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 7 Dec 2023 09:38:47 +0100 Subject: [PATCH 073/814] savepoint --- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 21a93e5e8..7a3b9ddc7 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -236,7 +236,7 @@ public class Web3WalletClient { #if DEBUG extension Web3WalletClient { - public func registerPushClient(deviceToken: String) async throws { + public func register(deviceToken: String, enableEncrypted: Bool = false) async throws { try await pushClient.register(deviceToken: deviceToken) } } From dee1419970c875bd90e9bb6d651b5dcc6271b5ee Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 7 Dec 2023 09:47:35 +0100 Subject: [PATCH 074/814] remove group identifier from notify configure --- Example/WalletApp/ApplicationLayer/ConfigurationService.swift | 1 - Sources/WalletConnectNotify/Notify.swift | 1 - 2 files changed, 2 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index d8cfd3afe..215f59493 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -24,7 +24,6 @@ final class ConfigurationService { Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) Notify.configure( - groupIdentifier: "group.com.walletconnect.sdk", environment: BuildConfiguration.shared.apnsEnvironment, crypto: DefaultCryptoProvider() ) diff --git a/Sources/WalletConnectNotify/Notify.swift b/Sources/WalletConnectNotify/Notify.swift index a86ffc892..9ed189307 100644 --- a/Sources/WalletConnectNotify/Notify.swift +++ b/Sources/WalletConnectNotify/Notify.swift @@ -25,7 +25,6 @@ public class Notify { /// Wallet's configuration method static public func configure( pushHost: String = "echo.walletconnect.com", - groupIdentifier: String, environment: APNSEnvironment, crypto: CryptoProvider, notifyHost: String = "notify.walletconnect.com", From ac53c3c7fbba5ddfbcffb8158a7fe034f3d9c626 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 7 Dec 2023 14:28:26 +0300 Subject: [PATCH 075/814] allApps by default --- Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 41ef5d1d3..7c6008ed6 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -75,7 +75,7 @@ public class NotifyClient { self.subscriptionWatcher = subscriptionWatcher } - public func prepareRegistration(account: Account, domain: String, allApps: Bool = false) async throws -> IdentityRegistrationParams { + public func prepareRegistration(account: Account, domain: String, allApps: Bool = true) async throws -> IdentityRegistrationParams { return try await identityService.prepareRegistration(account: account, domain: domain, allApps: allApps) } From b82e75007bccdb8940b882fdad279291c922c3cf Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 7 Dec 2023 19:01:41 +0300 Subject: [PATCH 076/814] NotifyIdentityService removed --- .../Client/Wallet/NotifyClient.swift | 34 ++++++++++--- .../Client/Wallet/NotifyClientFactory.swift | 5 +- .../Client/Wallet/NotifyIdentityService.swift | 48 ------------------- 3 files changed, 29 insertions(+), 58 deletions(-) delete mode 100644 Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 7c6008ed6..ba30e6956 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -22,8 +22,9 @@ public class NotifyClient { public let logger: ConsoleLogging + private let keyserverURL: URL private let pushClient: PushClient - private let identityService: NotifyIdentityService + private let identityClient: IdentityClient private let notifyStorage: NotifyStorage private let notifyAccountProvider: NotifyAccountProvider private let notifyMessageSubscriber: NotifyMessageSubscriber @@ -38,8 +39,9 @@ public class NotifyClient { private let subscriptionWatcher: SubscriptionWatcher init(logger: ConsoleLogging, + keyserverURL: URL, kms: KeyManagementServiceProtocol, - identityService: NotifyIdentityService, + identityClient: IdentityClient, pushClient: PushClient, notifyMessageSubscriber: NotifyMessageSubscriber, notifyStorage: NotifyStorage, @@ -57,8 +59,9 @@ public class NotifyClient { subscriptionWatcher: SubscriptionWatcher ) { self.logger = logger + self.keyserverURL = keyserverURL self.pushClient = pushClient - self.identityService = identityService + self.identityClient = identityClient self.notifyMessageSubscriber = notifyMessageSubscriber self.notifyStorage = notifyStorage self.deleteNotifySubscriptionRequester = deleteNotifySubscriptionRequester @@ -76,17 +79,22 @@ public class NotifyClient { } public func prepareRegistration(account: Account, domain: String, allApps: Bool = true) async throws -> IdentityRegistrationParams { - return try await identityService.prepareRegistration(account: account, domain: domain, allApps: allApps) + return try await identityClient.prepareRegistration( + account: account, + domain: domain, + statement: makeStatement(allApps: allApps), + resources: [keyserverURL.absoluteString] + ) } public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { - try await identityService.register(params: params, signature: signature) + try await identityClient.register(params: params, signature: signature) notifyAccountProvider.setAccount(try params.account) try await subscriptionWatcher.start() } public func unregister(account: Account) async throws { - try await identityService.unregister(account: account) + try await identityClient.unregister(account: account) notifyWatcherAgreementKeysProvider.removeAgreement(account: account) try notifyStorage.clearDatabase(account: account) notifyAccountProvider.logout() @@ -126,7 +134,7 @@ public class NotifyClient { } public func isIdentityRegistered(account: Account) -> Bool { - return identityService.isIdentityRegistered(account: account) + return identityClient.isIdentityRegistered(account: account) } public func subscriptionsPublisher(account: Account) -> AnyPublisher<[NotifySubscription], Never> { @@ -138,6 +146,18 @@ public class NotifyClient { } } +private extension NotifyClient { + + func makeStatement(allApps: Bool) -> String { + switch allApps { + case false: + return "I further authorize this app to send me notifications. Read more at https://walletconnect.com/notifications" + case true: + return "I further authorize this app to view and manage my notifications for ALL apps. Read more at https://walletconnect.com/notifications" + } + } +} + #if targetEnvironment(simulator) extension NotifyClient { diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 4d265d828..99cff45c5 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -69,12 +69,11 @@ public struct NotifyClientFactory { let notifySubscriptionsChangedRequestSubscriber = NotifySubscriptionsChangedRequestSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, kms: kms, identityClient: identityClient, logger: logger, groupKeychainStorage: groupKeychainStorage, notifyStorage: notifyStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let subscriptionWatcher = SubscriptionWatcher(notifyWatchSubscriptionsRequester: notifyWatchSubscriptionsRequester, logger: logger) - let identityService = NotifyIdentityService(keyserverURL: keyserverURL, identityClient: identityClient, logger: logger) - return NotifyClient( logger: logger, + keyserverURL: keyserverURL, kms: kms, - identityService: identityService, + identityClient: identityClient, pushClient: pushClient, notifyMessageSubscriber: notifyMessageSubscriber, notifyStorage: notifyStorage, diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift deleted file mode 100644 index a7e318760..000000000 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyIdentityService.swift +++ /dev/null @@ -1,48 +0,0 @@ -import Foundation - -// TODO: Remove -final class NotifyIdentityService { - - private let keyserverURL: URL - private let identityClient: IdentityClient - private let logger: ConsoleLogging - - init(keyserverURL: URL, identityClient: IdentityClient, logger: ConsoleLogging) { - self.keyserverURL = keyserverURL - self.identityClient = identityClient - self.logger = logger - } - - public func prepareRegistration(account: Account, domain: String, allApps: Bool) async throws -> IdentityRegistrationParams { - return try await identityClient.prepareRegistration( - account: account, - domain: domain, - statement: makeStatement(allApps: allApps), - resources: [keyserverURL.absoluteString] - ) - } - - public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { - try await identityClient.register(params: params, signature: signature) - } - - public func unregister(account: Account) async throws { - try await identityClient.unregister(account: account) - } - - func isIdentityRegistered(account: Account) -> Bool { - return identityClient.isIdentityRegistered(account: account) - } -} - -private extension NotifyIdentityService { - - func makeStatement(allApps: Bool) -> String { - switch allApps { - case false: - return "I further authorize this app to send me notifications. Read more at https://walletconnect.com/notifications" - case true: - return "I further authorize this app to view and manage my notifications for ALL apps. Read more at https://walletconnect.com/notifications" - } - } -} From 71b7d2a00776b01fa27a69ece3462b9c495eb00a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Dec 2023 11:14:28 +0100 Subject: [PATCH 077/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 5f26532ed..eae497a8c 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -237,7 +237,10 @@ public final class SignClient: SignClientProtocol { //---------------------------------------AUTH----------------------------------- - public func authenticate(_ params: RequestParams, topic: String) async throws { + public func authenticate( + _ params: RequestParams, + topic: String + ) async throws { try pairingClient.validatePairingExistance(topic) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: topic) From 412dc8bd7eb88c1a36b37f4abab977d0c2e30ee6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Dec 2023 15:53:54 +0100 Subject: [PATCH 078/814] savepoint --- .../Auth/Signer/CacaoSignerTests.swift | 2 +- .../Sign/SignClientTests.swift | 8 +-- .../AuthRequest/AuthRequestInteractor.swift | 30 ++++++++--- .../Services/App/AppRespondSubscriber.swift | 4 +- .../Services/App/AuthResponseSubscriber.swift | 4 +- .../Auth/Types/AuthenticationPayload.swift | 32 +----------- .../Auth/Types/RequestParams.swift | 10 ++-- .../Sign/MessagesFormatter.swift | 51 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 6 ++- .../Sign/SignClientProtocol.swift | 3 +- Sources/Web3Wallet/Web3WalletClient.swift | 14 +++-- .../Mocks/SIWEMessageFormatterMock.swift | 2 +- .../AuthTests/SIWEMessageFormatterTests.swift | 8 +-- 13 files changed, 112 insertions(+), 62 deletions(-) create mode 100644 Sources/WalletConnectSign/Sign/MessagesFormatter.swift diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index 285173cc3..a74447bb7 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -47,7 +47,7 @@ class CacaoSignerTest: XCTestCase { func testCacaoSign() throws { let address = "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" let cacaoPayload = try payload.cacaoPayload(address: address) - let formatted = try SIWECacaoFormatter().formatMessage(from: cacaoPayload) + let formatted = try SIWECacaoFormatter().formatMessages(from: cacaoPayload) XCTAssertEqual(formatted, message) XCTAssertEqual(try signer.sign(payload: cacaoPayload, privateKey: privateKey, type: .eip191), signature) } diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index ebc167375..f3a98c8e7 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -796,7 +796,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try! await dapp.authenticate(RequestParams( domain: "localhost", - chainId: "eip155:1", + chains: ["eip155:1"], nonce: "1665443015700", aud: "http://localhost:3000/", nbf: nil, @@ -811,7 +811,7 @@ final class SignClientTests: XCTestCase { wallet.authRequestPublisher.sink { [unowned self] request in Task(priority: .high) { let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: signature, account: account) + try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: signature, account: account) } } .store(in: &publishers) @@ -833,7 +833,7 @@ final class SignClientTests: XCTestCase { wallet.authRequestPublisher.sink { [unowned self] request in Task(priority: .high) { let invalidSignature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: invalidSignature, account: walletAccount) + try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: invalidSignature, account: walletAccount) } } .store(in: &publishers) @@ -878,7 +878,7 @@ final class SignClientTests: XCTestCase { Task(priority: .high) { let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) - try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: cacaoSignature, account: walletAccount) + try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: cacaoSignature, account: walletAccount) } } .store(in: &publishers) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift index dafe7d283..7f8856045 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift @@ -13,12 +13,30 @@ final class AuthRequestInteractor { func approve(request: AuthRequest, importAccount: ImportAccount) async throws -> Bool { let account = importAccount.account - let signature = try messageSigner.sign( - payload: request.payload.cacaoPayload(address: account.address), - privateKey: Data(hex: importAccount.privateKey), - type: .eip191) - try await Web3Wallet.instance.respond(requestId: request.id, signature: signature, from: account) - + let SIWEmessages = try Web3Wallet.instance.formatMessages(payload: request.payload, address: [account.address]) + let signatures = SIWEmessages.map { + + } + loop { + + let signature = try messageSigner.sign( + payload: request.payload.cacaoPayload(address: account.address), + privateKey: Data(hex: importAccount.privateKey), + type: .eip191) + + CacaoPayload + + auth = makeAuthObject(signature, request, adddress) + + + let payload cacaoPayload() + let cacao = Cacao(h: <#T##CacaoHeader#>, p: <#T##CacaoPayload#>, s: <#T##CacaoSignature#>) + cacaos.append(Cacao) + } + + + try await Web3Wallet.instance.respond(requestId: request.id, signature: auths) + /* Redirect */ if let uri = request.requester.redirect?.native { WalletConnectRouter.goBack(uri: uri) diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift index 0973e1cf1..a5ee27ef3 100644 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/Auth/Services/App/AppRespondSubscriber.swift @@ -47,11 +47,11 @@ class AppRespondSubscriber { guard let address = try? DIDPKH(did: cacao.p.iss).account.address, - let message = try? messageFormatter.formatMessage(from: cacao.p) + let message = try? messageFormatter.formatMessages(from: cacao.p) else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } guard - let recovered = try? messageFormatter.formatMessage( + let recovered = try? messageFormatter.formatMessages( from: requestPayload.payloadParams.cacaoPayload(address: address) ), recovered == message else { self.onResponse?(requestId, .failure(.messageCompromised)); return } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 6bb77f2a2..6b5ff8fb2 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -47,11 +47,11 @@ class AuthResponseSubscriber { guard let address = try? DIDPKH(did: cacao.p.iss).account.address, - let message = try? messageFormatter.formatMessage(from: cacao.p) + let message = try? messageFormatter.formatMessages(from: cacao.p) else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } guard - let recovered = try? messageFormatter.formatMessage( + let recovered = try? messageFormatter.formatMessages( from: requestPayload.payloadParams.cacaoPayload(address: address) ), recovered == message else { self.onResponse?(requestId, .failure(.messageCompromised)); return } diff --git a/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift index 8c4326ae5..5efc11d0b 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift @@ -5,7 +5,7 @@ public struct AuthenticationPayload: Codable, Equatable { public let aud: String public let version: String public let nonce: String - public let chainId: String + public let chains: [String] public let type: String public let iat: String public let nbf: String? @@ -16,7 +16,7 @@ public struct AuthenticationPayload: Codable, Equatable { init(requestParams: RequestParams, iat: String) { self.type = "eip4361" - self.chainId = requestParams.chainId + self.chains = requestParams.chains self.domain = requestParams.domain self.aud = requestParams.aud self.version = "1" @@ -28,32 +28,4 @@ public struct AuthenticationPayload: Codable, Equatable { self.requestId = requestParams.requestId self.resources = requestParams.resources } - - public func cacaoPayload(address: String) throws -> CacaoPayload { - guard - let blockchain = Blockchain(chainId), - let account = Account(blockchain: blockchain, address: address) else { - throw Errors.invalidChainID - } - return CacaoPayload( - iss: account.did, - domain: domain, - aud: aud, - version: version, - nonce: nonce, - iat: iat, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources - ) - } -} - -private extension AuthenticationPayload { - - enum Errors: Error { - case invalidChainID - } } diff --git a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift index 2920de28d..e3843078a 100644 --- a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift @@ -6,7 +6,7 @@ import Foundation /// https://eips.ethereum.org/EIPS/eip-4361 public struct RequestParams { public let domain: String - public let chainId: String + public let chains: [String] public let nonce: String public let aud: String public let nbf: String? @@ -17,7 +17,7 @@ public struct RequestParams { public init( domain: String, - chainId: String, + chains: [String], nonce: String, aud: String, nbf: String?, @@ -27,7 +27,7 @@ public struct RequestParams { resources: [String]? ) { self.domain = domain - self.chainId = chainId + self.chains = chains self.nonce = nonce self.aud = aud self.nbf = nbf @@ -42,7 +42,7 @@ public struct RequestParams { #if DEBUG extension RequestParams { static func stub(domain: String = "service.invalid", - chainId: String = "eip155:1", + chains: [String] = ["eip155:1"], nonce: String = "32891756", aud: String = "https://service.invalid/login", nbf: String? = nil, @@ -51,7 +51,7 @@ extension RequestParams { requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"]) -> RequestParams { return RequestParams(domain: domain, - chainId: chainId, + chains: chains, nonce: nonce, aud: aud, nbf: nbf, diff --git a/Sources/WalletConnectSign/Sign/MessagesFormatter.swift b/Sources/WalletConnectSign/Sign/MessagesFormatter.swift new file mode 100644 index 000000000..6af3e7337 --- /dev/null +++ b/Sources/WalletConnectSign/Sign/MessagesFormatter.swift @@ -0,0 +1,51 @@ + +import Foundation +import WalletConnectUtils + +struct MessagesFormatter { + + enum Errors: Error { + case invalidChainID + } + + public func formatMessages(payload: AuthenticationPayload, addresses: [String]) throws -> [String] { + + var messages = [String]() + + for chain in payload.chains { + for address in addresses { + + guard + let blockchain = Blockchain(chain), + let account = Account(blockchain: blockchain, address: address) else { + throw Errors.invalidChainID + } + + let cacaoPayload = CacaoPayload( + iss: account.did, + domain: payload.domain, + aud: payload.aud, + version: payload.version, + nonce: payload.nonce, + iat: payload.iat, + nbf: payload.nbf, + exp: payload.exp, + statement: payload.statement, + requestId: payload.requestId, + resources: payload.resources + ) + + let message = try SIWECacaoFormatter().formatMessage(from: cacaoPayload) + messages.append(message) + } + } + + return messages + } + +} + + + + + diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index eae497a8c..d4e0b4527 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -272,7 +272,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func respondSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { + public func approveSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { try await authResponder.respond(requestId: requestId, signature: signature, account: account) } @@ -289,6 +289,10 @@ public final class SignClient: SignClientProtocol { return try pendingRequestsProvider.getPendingRequests() } + public func formatMessages(payload: AuthenticationPayload, addresses: [String]) throws -> [String] { + return try MessagesFormatter().formatMessages(payload: payload, addresses: addresses) + } + //----------------------------------------------------------------------------------- /// For a wallet to approve a session proposal. diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 6aedf8d67..b8244de21 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -20,7 +20,8 @@ public protocol SignClientProtocol { func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws - func respondSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws + func approveSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws + func makeAuthObject() func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 4821cec40..25d4334c6 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -185,8 +185,8 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatMessage(payload: AuthPayload, address: String) throws -> String { - try authClient.formatMessage(payload: payload, address: address) + public func formatMessages(payload: AuthPayload, address: [String]) throws -> [String] { + try signClient.formatMessages(payload: payload, address: address) } //---------------------------------------AUTH------------------------------------ @@ -195,8 +195,8 @@ public class Web3WalletClient { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func respondSessionAuthenticate(requestId: RPCID, signature: WalletConnectSign.CacaoSignature, from account: Account) async throws { - try await signClient.respondSessionAuthenticate(requestId: requestId, signature: signature, account: account) + public func approveSessionAuthenticate(requestId: RPCID, signature: WalletConnectSign.CacaoSignature, from account: Account) async throws { + try await signClient.approveSessionAuthenticate(requestId: requestId, signature: signature, account: account) } /// For wallet to reject authentication request @@ -240,7 +240,11 @@ public class Web3WalletClient { public func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? { signClient.getSessionRequestRecord(id: id) } - + + public func makeAuthObject(authRequest: AuthRequest, signature: CacaoSignature) -> AuthObject { + signClient.makeAuthObject() + } + /// Query pending authentication requests /// - Returns: Pending authentication requests public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { diff --git a/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift b/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift index 0796eb6ce..94fa4ec59 100644 --- a/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift +++ b/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift @@ -4,7 +4,7 @@ import Foundation class SIWEMessageFormatterMock: SIWECacaoFormatting { var formattedMessage: String! - func formatMessage(from payload: CacaoPayload) throws -> String { + func formatMessages(from payload: CacaoPayload) throws -> String { return formattedMessage } } diff --git a/Tests/AuthTests/SIWEMessageFormatterTests.swift b/Tests/AuthTests/SIWEMessageFormatterTests.swift index 521c46c64..23568ff61 100644 --- a/Tests/AuthTests/SIWEMessageFormatterTests.swift +++ b/Tests/AuthTests/SIWEMessageFormatterTests.swift @@ -27,7 +27,7 @@ class SIWEMessageFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let message = try sut.formatMessage(from: AuthPayload.stub().cacaoPayload(address: address)) + let message = try sut.formatMessages(from: AuthPayload.stub().cacaoPayload(address: address)) XCTAssertEqual(message, expectedMessage) } @@ -47,7 +47,7 @@ class SIWEMessageFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let message = try sut.formatMessage( + let message = try sut.formatMessages( from: AuthPayload.stub( requestParams: RequestParams.stub(statement: nil) ).cacaoPayload(address: address) @@ -69,7 +69,7 @@ class SIWEMessageFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let message = try sut.formatMessage( + let message = try sut.formatMessages( from: AuthPayload.stub( requestParams: RequestParams.stub(resources: nil)).cacaoPayload(address: address) ) @@ -89,7 +89,7 @@ class SIWEMessageFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let message = try sut.formatMessage( + let message = try sut.formatMessages( from: AuthPayload.stub( requestParams: RequestParams.stub(statement: nil, resources: nil)).cacaoPayload(address: address) ) From a35536823a569032ef4042be844c6ae64f6943ad Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Dec 2023 16:25:15 +0100 Subject: [PATCH 079/814] savepoint --- .../AuthRequest/AuthRequestInteractor.swift | 22 +++++++++---------- .../Types/Public/AuthenticationRequest.swift | 1 + .../Sign/SignClientProtocol.swift | 3 ++- .../WalletConnectSign/Types/AuthObject.swift | 4 ++++ Sources/Web3Wallet/Web3WalletClient.swift | 18 +++++---------- 5 files changed, 23 insertions(+), 25 deletions(-) create mode 100644 Sources/WalletConnectSign/Types/AuthObject.swift diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift index 7f8856045..bed4f462b 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift @@ -11,27 +11,27 @@ final class AuthRequestInteractor { self.messageSigner = messageSigner } - func approve(request: AuthRequest, importAccount: ImportAccount) async throws -> Bool { + + func approve(request: AuthenticationRequest, importAccount: ImportAccount) async throws -> Bool { let account = importAccount.account - let SIWEmessages = try Web3Wallet.instance.formatMessages(payload: request.payload, address: [account.address]) - let signatures = SIWEmessages.map { + let auths = [AuthObject]() - } - loop { + + request.payload.chains.forEach { chain in + + let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) let signature = try messageSigner.sign( - payload: request.payload.cacaoPayload(address: account.address), + message: SIWEmessages, privateKey: Data(hex: importAccount.privateKey), type: .eip191) - CacaoPayload - auth = makeAuthObject(signature, request, adddress) + + let auth = Web3Wallet.instance.makeAuthObject(authRequest: request, signature: signature, account: account) - let payload cacaoPayload() - let cacao = Cacao(h: <#T##CacaoHeader#>, p: <#T##CacaoPayload#>, s: <#T##CacaoSignature#>) - cacaos.append(Cacao) + auths.append(auth) } diff --git a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift index fdfca0e38..f4e595da4 100644 --- a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift +++ b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift @@ -4,4 +4,5 @@ public struct AuthenticationRequest: Equatable, Codable { public let id: RPCID public let topic: String public let payload: AuthenticationPayload + public let requester: AppMetadata } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index b8244de21..1f4f31d5b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -11,6 +11,7 @@ public protocol SignClientProtocol { var sessionResponsePublisher: AnyPublisher { get } var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { get } var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> { get } + var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { get } var logsPublisher: AnyPublisher {get} func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws @@ -21,7 +22,7 @@ public protocol SignClientProtocol { func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws func approveSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws - func makeAuthObject() + func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) -> AuthObject func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws diff --git a/Sources/WalletConnectSign/Types/AuthObject.swift b/Sources/WalletConnectSign/Types/AuthObject.swift new file mode 100644 index 000000000..879ed9ac7 --- /dev/null +++ b/Sources/WalletConnectSign/Types/AuthObject.swift @@ -0,0 +1,4 @@ + +import Foundation + +public typealias AuthObject = Cacao diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 25d4334c6..d0c951b50 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -26,8 +26,8 @@ public class Web3WalletClient { /// Publisher that sends authentication requests /// /// Wallet should subscribe on events in order to receive auth requests. - public var authRequestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { - authClient.authRequestPublisher.eraseToAnyPublisher() + public var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { + signClient.authRequestPublisher.eraseToAnyPublisher() } /// Publisher that sends sessions on every sessions update @@ -185,8 +185,8 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatMessages(payload: AuthPayload, address: [String]) throws -> [String] { - try signClient.formatMessages(payload: payload, address: address) + public func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> [String] { + try signClient.formatMessages(payload: payload, address: account) } //---------------------------------------AUTH------------------------------------ @@ -213,14 +213,6 @@ public class Web3WalletClient { } //--------------------------------------------------- - - /// For a wallet to respond on authentication request - /// - Parameters: - /// - requestId: authentication request id - /// - signature: CACAO signature of requested message - public func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws { - try await authClient.respond(requestId: requestId, signature: signature, from: account) - } /// Query pending requests /// - Returns: Pending requests received from peer with `wc_sessionRequest` protocol method @@ -241,7 +233,7 @@ public class Web3WalletClient { signClient.getSessionRequestRecord(id: id) } - public func makeAuthObject(authRequest: AuthRequest, signature: CacaoSignature) -> AuthObject { + public func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) -> AuthObject { signClient.makeAuthObject() } From 701cec8e38e19daafc11b9cd50efdefcb81d8c54 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Dec 2023 16:54:14 +0100 Subject: [PATCH 080/814] savepoint --- .../Services/App/AppRespondSubscriber.swift | 4 +- .../Wallet/WalletRespondService.swift | 2 +- Sources/Auth/Types/AuthPayload.swift | 2 +- .../IdentityService.swift | 2 +- .../Services/App/AuthResponseSubscriber.swift | 4 +- .../Auth/Services/CacaosProvider.swift | 10 ++++ .../Wallet/AuthRequestSubscriber.swift | 4 +- .../Auth/Services/Wallet/AuthResponder.swift | 4 +- .../Auth/Types/AuthenticationPayload.swift | 17 +++++++ .../Sign/MessagesFormatter.swift | 51 ------------------- .../WalletConnectSign/Sign/SignClient.swift | 9 +++- .../Sign/SignClientProtocol.swift | 4 +- Sources/Web3Wallet/Web3WalletClient.swift | 23 ++------- .../AuthTests/AppRespondSubscriberTests.swift | 2 +- 14 files changed, 53 insertions(+), 85 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift delete mode 100644 Sources/WalletConnectSign/Sign/MessagesFormatter.swift diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift index a5ee27ef3..0973e1cf1 100644 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/Auth/Services/App/AppRespondSubscriber.swift @@ -47,11 +47,11 @@ class AppRespondSubscriber { guard let address = try? DIDPKH(did: cacao.p.iss).account.address, - let message = try? messageFormatter.formatMessages(from: cacao.p) + let message = try? messageFormatter.formatMessage(from: cacao.p) else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } guard - let recovered = try? messageFormatter.formatMessages( + let recovered = try? messageFormatter.formatMessage( from: requestPayload.payloadParams.cacaoPayload(address: address) ), recovered == message else { self.onResponse?(requestId, .failure(.messageCompromised)); return } diff --git a/Sources/Auth/Services/Wallet/WalletRespondService.swift b/Sources/Auth/Services/Wallet/WalletRespondService.swift index a06a16027..4470853e4 100644 --- a/Sources/Auth/Services/Wallet/WalletRespondService.swift +++ b/Sources/Auth/Services/Wallet/WalletRespondService.swift @@ -37,7 +37,7 @@ actor WalletRespondService { try kms.setAgreementSecret(keys, topic: topic) - let header = CacaoHeader(t: "eip4361") + let header = CacaoHeader(t: "caip122") let payload = try authRequestParams.payloadParams.cacaoPayload(address: account.address) let responseParams = AuthResponseParams(h: header, p: payload, s: signature) diff --git a/Sources/Auth/Types/AuthPayload.swift b/Sources/Auth/Types/AuthPayload.swift index 33ba49756..9f577bb6e 100644 --- a/Sources/Auth/Types/AuthPayload.swift +++ b/Sources/Auth/Types/AuthPayload.swift @@ -15,7 +15,7 @@ public struct AuthPayload: Codable, Equatable { public let resources: [String]? init(requestParams: RequestParams, iat: String) { - self.type = "eip4361" + self.type = "caip122" self.chainId = requestParams.chainId self.domain = requestParams.domain self.aud = requestParams.aud diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index 96cd34215..e949f4866 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -58,7 +58,7 @@ actor IdentityService { return identityKey.publicKey.hexRepresentation } - let cacaoHeader = CacaoHeader(t: "eip4361") + let cacaoHeader = CacaoHeader(t: "caip122") let cacao = Cacao(h: cacaoHeader, p: params.payload, s: signature) try await networkService.registerIdentity(cacao: cacao) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 6b5ff8fb2..6bb77f2a2 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -47,11 +47,11 @@ class AuthResponseSubscriber { guard let address = try? DIDPKH(did: cacao.p.iss).account.address, - let message = try? messageFormatter.formatMessages(from: cacao.p) + let message = try? messageFormatter.formatMessage(from: cacao.p) else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } guard - let recovered = try? messageFormatter.formatMessages( + let recovered = try? messageFormatter.formatMessage( from: requestPayload.payloadParams.cacaoPayload(address: address) ), recovered == message else { self.onResponse?(requestId, .failure(.messageCompromised)); return } diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift new file mode 100644 index 000000000..f3dd47dec --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift @@ -0,0 +1,10 @@ + +import Foundation + +struct CacaosProvider { + public func makeCacao(authRequest: AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { + let payload = try authRequest.payload.cacaoPayload(account: account) + let header = CacaoHeader(t: "caip122") + return Cacao(h: header, p: payload, s: signature) + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index f1a69435b..b9969aed8 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -39,8 +39,8 @@ class AuthRequestSubscriber { pairingRegisterer.setReceived(pairingTopic: payload.topic) - let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams) - + let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams, requester: payload.request.requester.metadata) + Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() do { diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 0f98223eb..e182468cb 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -37,8 +37,8 @@ actor AuthResponder { try kms.setAgreementSecret(keys, topic: topic) - let header = CacaoHeader(t: "eip4361") - let payload = try authRequestParams.payloadParams.cacaoPayload(address: account.address) + let header = CacaoHeader(t: "caip122") + let payload = try authRequestParams.payloadParams.cacaoPayload(account: account) let responseParams = AuthResponseParams(h: header, p: payload, s: signature) let response = RPCResponse(id: requestId, result: responseParams) diff --git a/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift index 5efc11d0b..ee71c1868 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift @@ -28,4 +28,21 @@ public struct AuthenticationPayload: Codable, Equatable { self.requestId = requestParams.requestId self.resources = requestParams.resources } + + func cacaoPayload(account: Account) throws -> CacaoPayload { + return CacaoPayload( + iss: account.did, + domain: domain, + aud: aud, + version: version, + nonce: nonce, + iat: iat, + nbf: nbf, + exp: exp, + statement: statement, + requestId: requestId, + resources: resources + ) + } } + diff --git a/Sources/WalletConnectSign/Sign/MessagesFormatter.swift b/Sources/WalletConnectSign/Sign/MessagesFormatter.swift deleted file mode 100644 index 6af3e7337..000000000 --- a/Sources/WalletConnectSign/Sign/MessagesFormatter.swift +++ /dev/null @@ -1,51 +0,0 @@ - -import Foundation -import WalletConnectUtils - -struct MessagesFormatter { - - enum Errors: Error { - case invalidChainID - } - - public func formatMessages(payload: AuthenticationPayload, addresses: [String]) throws -> [String] { - - var messages = [String]() - - for chain in payload.chains { - for address in addresses { - - guard - let blockchain = Blockchain(chain), - let account = Account(blockchain: blockchain, address: address) else { - throw Errors.invalidChainID - } - - let cacaoPayload = CacaoPayload( - iss: account.did, - domain: payload.domain, - aud: payload.aud, - version: payload.version, - nonce: payload.nonce, - iat: payload.iat, - nbf: payload.nbf, - exp: payload.exp, - statement: payload.statement, - requestId: payload.requestId, - resources: payload.resources - ) - - let message = try SIWECacaoFormatter().formatMessage(from: cacaoPayload) - messages.append(message) - } - } - - return messages - } - -} - - - - - diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index d4e0b4527..558eff379 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -7,6 +7,7 @@ import Combine /// /// Access via `Sign.instance` public final class SignClient: SignClientProtocol { + enum Errors: Error { case sessionForTopicNotFound } @@ -289,8 +290,12 @@ public final class SignClient: SignClientProtocol { return try pendingRequestsProvider.getPendingRequests() } - public func formatMessages(payload: AuthenticationPayload, addresses: [String]) throws -> [String] { - return try MessagesFormatter().formatMessages(payload: payload, addresses: addresses) + public func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> String { + return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account)) + } + + public func makeAuthObject(authRequest: AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { + thy CacaosProvider().makeCacao(authRequest: authRequest, signature: signature, account: account) } //----------------------------------------------------------------------------------- diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 1f4f31d5b..c89813db7 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -22,11 +22,13 @@ public protocol SignClientProtocol { func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws func approveSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws - func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) -> AuthObject + func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws func getSessions() -> [Session] + func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> String + func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index d0c951b50..5cc591fc4 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -74,7 +74,6 @@ public class Web3WalletClient { } // MARK: - Private Properties - private let authClient: AuthClientProtocol private let signClient: SignClientProtocol private let pairingClient: PairingClientProtocol private let pushClient: PushClientProtocol @@ -82,12 +81,10 @@ public class Web3WalletClient { private var account: Account? init( - authClient: AuthClientProtocol, signClient: SignClientProtocol, pairingClient: PairingClientProtocol, pushClient: PushClientProtocol ) { - self.authClient = authClient self.signClient = signClient self.pairingClient = pairingClient self.pushClient = pushClient @@ -108,12 +105,6 @@ public class Web3WalletClient { public func rejectSession(proposalId: String, reason: RejectionReason) async throws { try await signClient.rejectSession(proposalId: proposalId, reason: reason) } - - /// For wallet to reject authentication request - /// - Parameter requestId: authentication request id - public func reject(requestId: RPCID) async throws { - try await authClient.reject(requestId: requestId) - } /// For the wallet to update session namespaces /// - Parameters: @@ -185,8 +176,8 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> [String] { - try signClient.formatMessages(payload: payload, address: account) + public func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> String { + try signClient.formatAuthMessage(payload: payload, account: account) } //---------------------------------------AUTH------------------------------------ @@ -233,14 +224,8 @@ public class Web3WalletClient { signClient.getSessionRequestRecord(id: id) } - public func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) -> AuthObject { - signClient.makeAuthObject() - } - - /// Query pending authentication requests - /// - Returns: Pending authentication requests - public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { - try authClient.getPendingRequests() + public func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject { + try signClient.makeAuthObject(authRequest: authRequest, signature: signature, account: account) } public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { diff --git a/Tests/AuthTests/AppRespondSubscriberTests.swift b/Tests/AuthTests/AppRespondSubscriberTests.swift index 4383374d7..5e54bf464 100644 --- a/Tests/AuthTests/AppRespondSubscriberTests.swift +++ b/Tests/AuthTests/AppRespondSubscriberTests.swift @@ -58,7 +58,7 @@ class AppRespondSubscriberTests: XCTestCase { } // subscribe on compromised cacao - let cacaoHeader = CacaoHeader(t: "eip4361") + let cacaoHeader = CacaoHeader(t: "caip122") let cacaoPayload = try! compromissedParams.payloadParams.cacaoPayload(address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf") let cacaoSignature = CacaoSignature(t: .eip191, s: "") From a1469eba7b56d614ebc9e9cea86d5048f94ac6d5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Dec 2023 17:02:35 +0100 Subject: [PATCH 081/814] savepoint --- .../Auth/Services/App/AuthResponseSubscriber.swift | 2 +- .../Auth/Services/Wallet/AuthResponder.swift | 6 ++---- Sources/WalletConnectSign/Sign/SignClient.swift | 6 +++--- Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 5 files changed, 8 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 6bb77f2a2..af3263906 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -35,7 +35,7 @@ class AuthResponseSubscriber { }.store(in: &publishers) networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + .sink { [unowned self] (payload: ResponseSubscriptionPayload) in pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index e182468cb..d79533feb 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -31,15 +31,13 @@ actor AuthResponder { self.pairingRegisterer = pairingRegisterer } - func respond(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { + func respond(requestId: RPCID, auths: [AuthObject]) async throws { let authRequestParams = try getAuthRequestParams(requestId: requestId) let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) try kms.setAgreementSecret(keys, topic: topic) - let header = CacaoHeader(t: "caip122") - let payload = try authRequestParams.payloadParams.cacaoPayload(account: account) - let responseParams = AuthResponseParams(h: header, p: payload, s: signature) + let responseParams = auths let response = RPCResponse(id: requestId, result: responseParams) try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 558eff379..e43e1eb21 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -273,8 +273,8 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func approveSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { - try await authResponder.respond(requestId: requestId, signature: signature, account: account) + public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws { + try await authResponder.respond(requestId: requestId, auths: auths) } /// For wallet to reject authentication request @@ -295,7 +295,7 @@ public final class SignClient: SignClientProtocol { } public func makeAuthObject(authRequest: AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { - thy CacaosProvider().makeCacao(authRequest: authRequest, signature: signature, account: account) + try CacaosProvider().makeCacao(authRequest: authRequest, signature: signature, account: account) } //----------------------------------------------------------------------------------- diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index c89813db7..c6d1e07fd 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -21,7 +21,7 @@ public protocol SignClientProtocol { func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws - func approveSessionAuthenticate(requestId: RPCID, signature: CacaoSignature, account: Account) async throws + func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 5cc591fc4..b96ea17b4 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -186,7 +186,7 @@ public class Web3WalletClient { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func approveSessionAuthenticate(requestId: RPCID, signature: WalletConnectSign.CacaoSignature, from account: Account) async throws { + public func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws { try await signClient.approveSessionAuthenticate(requestId: requestId, signature: signature, account: account) } From 9e677be227b79a8d996998251c48be44efb167f5 Mon Sep 17 00:00:00 2001 From: flypaper0 Date: Mon, 11 Dec 2023 20:32:09 +0100 Subject: [PATCH 082/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index bf78f5622..8ae524b7b 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.9.9"} +{"version": "1.9.10"} From 68d3d2e8493378ebf37aaff1a8b32461d4651723 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 10:46:48 +0100 Subject: [PATCH 083/814] savepoint --- .../Services/App/AuthResponseSubscriber.swift | 79 +++++++++++++------ .../App/SessionAuthRequestService.swift | 2 +- .../Wallet/PendingRequestsProvider.swift | 4 +- ...tionPayload.swift => Caip222Request.swift} | 4 +- .../ProtocolRPCParams/AuthRequestParams.swift | 4 +- .../Types/Public/AuthenticationRequest.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 6 +- .../Sign/SignClientProtocol.swift | 2 +- .../Verifier/MessageVerifier.swift | 12 +++ Sources/Web3Wallet/Web3WalletClient.swift | 2 +- .../Web3Wallet/Web3WalletClientFactory.swift | 1 - 11 files changed, 81 insertions(+), 37 deletions(-) rename Sources/WalletConnectSign/Auth/Types/{AuthenticationPayload.swift => Caip222Request.swift} (93%) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index af3263906..8d64c6153 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -10,7 +10,7 @@ class AuthResponseSubscriber { private let pairingRegisterer: PairingRegisterer private var publishers = [AnyCancellable]() - var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? + var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -42,34 +42,67 @@ class AuthResponseSubscriber { networkingInteractor.unsubscribe(topic: payload.topic) let requestId = payload.id - let cacao = payload.response + let cacaos = payload.response let requestPayload = payload.request - guard - let address = try? DIDPKH(did: cacao.p.iss).account.address, - let message = try? messageFormatter.formatMessage(from: cacao.p) - else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } - - guard - let recovered = try? messageFormatter.formatMessage( - from: requestPayload.payloadParams.cacaoPayload(address: address) - ), recovered == message - else { self.onResponse?(requestId, .failure(.messageCompromised)); return } - - Task(priority: .high) { + Task { do { - try await signatureVerifier.verify( - signature: cacao.s, - message: message, - address: address, - chainId: requestPayload.payloadParams.chainId - ) - onResponse?(requestId, .success(cacao)) + try await recoverAndVerifySignature(caip222Request: payload.request.payloadParams, cacaos: cacaos) } catch { - logger.error("Signature verification failed with: \(error.localizedDescription)") - onResponse?(requestId, .failure(.signatureVerificationFailed)) + onResponse?(requestId, .failure(error)) + return } + createSession(form: cacaos) } + }.store(in: &publishers) } + + private func recoverAndVerifySignature(caip222Request: Caip222Request, cacaos: [Cacao]) async throws { + try await cacaos.asyncForEach { [unowned self] cacao in + guard + let account = try? DIDPKH(did: cacao.p.iss).account, + let message = try? messageFormatter.formatMessage(from: cacao.p) + else { + throw AuthError.malformedResponseParams + } + + guard + let recovered = try? messageFormatter.formatMessage( + from: caip222Request.cacaoPayload(account: account) + ), recovered == message + else { + throw AuthError.messageCompromised + } + + do { + try await signatureVerifier.verify( + signature: cacao.s, + message: message, + account: account + ) + } catch { + logger.error("Signature verification failed with: \(error.localizedDescription)") + throw AuthError.signatureVerificationFailed + } + + } + } + + private func createSession(form cacaos: [Cacao]) { + + } +} + +extension Sequence { + func asyncForEach(_ operation: @escaping (Element) async throws -> Void) async throws { + try await withThrowingTaskGroup(of: Void.self) { group in + for element in self { + group.addTask { + try await operation(element) + } + } + try await group.waitForAll() + } + } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 11c7a4a11..66402a3d9 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -24,7 +24,7 @@ actor SessionAuthRequestService { let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let protocolMethod = SessionAuthenticatedProtocolMethod() let requester = AuthRequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) - let payload = AuthenticationPayload(requestParams: params, iat: iatProvader.iat) + let payload = Caip222Request(requestParams: params, iat: iatProvader.iat) let params = AuthRequestParams(requester: requester, payloadParams: payload) let request = RPCRequest(method: protocolMethod.method, params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift index 91ff03f8c..d863369cc 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift @@ -14,10 +14,10 @@ class PendingRequestsProvider { public func getPendingRequests() throws -> [(AuthenticationRequest, VerifyContext?)] { let pendingRequests: [AuthenticationRequest] = rpcHistory.getPending() - .filter {$0.request.method == "wc_authRequest"} + .filter {$0.request.method == "wc_sessionAuthenticate"} .compactMap { guard let params = try? $0.request.params?.get(AuthRequestParams.self) else { return nil } - return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams) + return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams, requester: params.requester.metadata) } return pendingRequests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } diff --git a/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift b/Sources/WalletConnectSign/Auth/Types/Caip222Request.swift similarity index 93% rename from Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift rename to Sources/WalletConnectSign/Auth/Types/Caip222Request.swift index ee71c1868..fd87fe52e 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthenticationPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/Caip222Request.swift @@ -1,6 +1,6 @@ import Foundation -public struct AuthenticationPayload: Codable, Equatable { +public struct Caip222Request: Codable, Equatable { public let domain: String public let aud: String public let version: String @@ -15,7 +15,7 @@ public struct AuthenticationPayload: Codable, Equatable { public let resources: [String]? init(requestParams: RequestParams, iat: String) { - self.type = "eip4361" + self.type = "caip122" self.chains = requestParams.chains self.domain = requestParams.domain self.aud = requestParams.aud diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift index 6c93b7f89..4fce8153b 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift @@ -1,9 +1,9 @@ import Foundation -/// wc_authRequest RPC method request param +/// wc_sessionAuthenticate RPC method request param struct AuthRequestParams: Codable, Equatable { let requester: Requester - let payloadParams: AuthenticationPayload + let payloadParams: Caip222Request } extension AuthRequestParams { diff --git a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift index f4e595da4..8fdb248c5 100644 --- a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift +++ b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift @@ -3,6 +3,6 @@ import Foundation public struct AuthenticationRequest: Equatable, Codable { public let id: RPCID public let topic: String - public let payload: AuthenticationPayload + public let payload: Caip222Request public let requester: AppMetadata } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index e43e1eb21..5e6ce4c57 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -109,7 +109,7 @@ public final class SignClient: SignClientProtocol { /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. /// /// Emited result may be an error. - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } //--------------------------------------------------------------------------------- @@ -157,7 +157,7 @@ public final class SignClient: SignClientProtocol { private let sessionExtendPublisherSubject = PassthroughSubject<(sessionTopic: String, date: Date), Never>() private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private var publishers = Set() @@ -290,7 +290,7 @@ public final class SignClient: SignClientProtocol { return try pendingRequestsProvider.getPendingRequests() } - public func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> String { + public func formatAuthMessage(payload: Caip222Request, account: Account) throws -> String { return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account)) } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index c6d1e07fd..95caf6019 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -27,7 +27,7 @@ public protocol SignClientProtocol { func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws func getSessions() -> [Session] - func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> String + func formatAuthMessage(payload: Caip222Request, account: Account) throws -> String func cleanup() async throws diff --git a/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift b/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift index 66b24ef8a..12b82b40e 100644 --- a/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift +++ b/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift @@ -14,6 +14,18 @@ public struct MessageVerifier { self.eip1271Verifier = eip1271Verifier } + public func verify(signature: CacaoSignature, + message: String, + account: Account + ) async throws { + try await self.verify( + signature: signature, + message: message, + address: account.address, + chainId: account.blockchainIdentifier + ) + } + public func verify(signature: CacaoSignature, message: String, address: String, diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index b96ea17b4..0ec7842be 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -176,7 +176,7 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatAuthMessage(payload: AuthenticationPayload, account: Account) throws -> String { + public func formatAuthMessage(payload: Caip222Request, account: Account) throws -> String { try signClient.formatAuthMessage(payload: payload, account: account) } diff --git a/Sources/Web3Wallet/Web3WalletClientFactory.swift b/Sources/Web3Wallet/Web3WalletClientFactory.swift index 99b5cc969..a073a94b9 100644 --- a/Sources/Web3Wallet/Web3WalletClientFactory.swift +++ b/Sources/Web3Wallet/Web3WalletClientFactory.swift @@ -8,7 +8,6 @@ public struct Web3WalletClientFactory { pushClient: PushClientProtocol ) -> Web3WalletClient { return Web3WalletClient( - authClient: authClient, signClient: signClient, pairingClient: pairingClient, pushClient: pushClient From 4940e67742ae69680ba0ed4b8db4d23454d5c275 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 10:56:10 +0100 Subject: [PATCH 084/814] fix sdk build --- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 0ec7842be..cc932b563 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -187,7 +187,7 @@ public class Web3WalletClient { /// - requestId: authentication request id /// - signature: CACAO signature of requested message public func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws { - try await signClient.approveSessionAuthenticate(requestId: requestId, signature: signature, account: account) + try await signClient.approveSessionAuthenticate(requestId: requestId, auths: auths) } /// For wallet to reject authentication request From 7f472d76c31ec206a340d8e3ecfdddfa7314fed0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 11:18:54 +0100 Subject: [PATCH 085/814] fix failure integration test --- .../Auth/Signer/CacaoSignerTests.swift | 2 +- .../Sign/SignClientTests.swift | 166 +++++++++--------- .../AuthRequest/AuthRequestInteractor.swift | 2 +- .../Services/App/AuthResponseSubscriber.swift | 4 +- .../WalletConnectSign/Sign/SignClient.swift | 4 +- 5 files changed, 91 insertions(+), 87 deletions(-) diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index a74447bb7..285173cc3 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -47,7 +47,7 @@ class CacaoSignerTest: XCTestCase { func testCacaoSign() throws { let address = "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" let cacaoPayload = try payload.cacaoPayload(address: address) - let formatted = try SIWECacaoFormatter().formatMessages(from: cacaoPayload) + let formatted = try SIWECacaoFormatter().formatMessage(from: cacaoPayload) XCTAssertEqual(formatted, message) XCTAssertEqual(try signer.sign(payload: cacaoPayload, privateKey: privateKey, type: .eip191), signature) } diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index f3a98c8e7..ab1bb04da 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -788,40 +788,40 @@ final class SignClientTests: XCTestCase { wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } - func testEIP1271SessionAuthenticated() async throws { - - let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! - - let responseExpectation = expectation(description: "successful response delivered") - let uri = try! await dappPairingClient.create() - try! await dapp.authenticate(RequestParams( - domain: "localhost", - chains: ["eip155:1"], - nonce: "1665443015700", - aud: "http://localhost:3000/", - nbf: nil, - exp: "2022-10-11T23:03:35.700Z", - statement: nil, - requestId: nil, - resources: nil - ), topic: uri.topic) - - try await walletPairingClient.pair(uri: uri) - - wallet.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: signature, account: account) - } - } - .store(in: &publishers) - dapp.authResponsePublisher.sink { (_, result) in - guard case .success = result else { XCTFail(); return } - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } +// func testEIP1271SessionAuthenticated() async throws { +// +// let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! +// +// let responseExpectation = expectation(description: "successful response delivered") +// let uri = try! await dappPairingClient.create() +// try! await dapp.authenticate(RequestParams( +// domain: "localhost", +// chains: ["eip155:1"], +// nonce: "1665443015700", +// aud: "http://localhost:3000/", +// nbf: nil, +// exp: "2022-10-11T23:03:35.700Z", +// statement: nil, +// requestId: nil, +// resources: nil +// ), topic: uri.topic) +// +// try await walletPairingClient.pair(uri: uri) +// +// wallet.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) +// try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: signature, account: account) +// } +// } +// .store(in: &publishers) +// dapp.authResponsePublisher.sink { (_, result) in +// guard case .success = result else { XCTFail(); return } +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } func testEIP191RespondError() async { let responseExpectation = expectation(description: "error response delivered") @@ -830,64 +830,68 @@ final class SignClientTests: XCTestCase { try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) try? await walletPairingClient.pair(uri: uri) - wallet.authRequestPublisher.sink { [unowned self] request in + wallet.authRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let invalidSignature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: invalidSignature, account: walletAccount) - } - } - .store(in: &publishers) - dapp.authResponsePublisher.sink { (_, result) in - guard case let .failure(error) = result, error == .signatureVerificationFailed else { XCTFail(); return } - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } - - func testUserRespondError() async { - let responseExpectation = expectation(description: "error response delivered") - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() - try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - wallet.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - try! await wallet.rejectSession(requestId: request.0.id) - } - } - .store(in: &publishers) - dapp.authResponsePublisher.sink { (_, result) in - guard case .failure(let error) = result else { XCTFail(); return } - XCTAssertEqual(error, .userRejeted) - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } - func testRespondSignatureVerificationFailed() async { - let responseExpectation = expectation(description: "invalid signature response delivered") - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() - try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + let auth = try wallet.makeAuthObject(authRequest: request, signature: invalidSignature, account: walletAccount) - try? await walletPairingClient.pair(uri: uri) - wallet.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" - let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) - try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: cacaoSignature, account: walletAccount) + try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) } } .store(in: &publishers) dapp.authResponsePublisher.sink { (_, result) in - guard case .failure(let error) = result else { XCTFail(); return } - XCTAssertEqual(error, .signatureVerificationFailed) + guard case let .failure(error) = result, + error == .signatureVerificationFailed else { XCTFail(); return } responseExpectation.fulfill() } .store(in: &publishers) wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } +// +// func testUserRespondError() async { +// let responseExpectation = expectation(description: "error response delivered") +// dapp.enableAuthenticatedSessions() +// let uri = try! await dappPairingClient.create() +// try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// wallet.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// try! await wallet.rejectSession(requestId: request.0.id) +// } +// } +// .store(in: &publishers) +// dapp.authResponsePublisher.sink { (_, result) in +// guard case .failure(let error) = result else { XCTFail(); return } +// XCTAssertEqual(error, .userRejeted) +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } + +// func testRespondSignatureVerificationFailed() async { +// let responseExpectation = expectation(description: "invalid signature response delivered") +// dapp.enableAuthenticatedSessions() +// let uri = try! await dappPairingClient.create() +// try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// wallet.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" +// let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) +// try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: cacaoSignature, account: walletAccount) +// } +// } +// .store(in: &publishers) +// dapp.authResponsePublisher.sink { (_, result) in +// guard case .failure(let error) = result else { XCTFail(); return } +// XCTAssertEqual(error, .signatureVerificationFailed) +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift index bed4f462b..0657d6fd7 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift @@ -14,7 +14,7 @@ final class AuthRequestInteractor { func approve(request: AuthenticationRequest, importAccount: ImportAccount) async throws -> Bool { let account = importAccount.account - let auths = [AuthObject]() + var auths = [AuthObject]() request.payload.chains.forEach { chain in diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 8d64c6153..227fdc23c 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -10,7 +10,7 @@ class AuthResponseSubscriber { private let pairingRegisterer: PairingRegisterer private var publishers = [AnyCancellable]() - var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? + var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -49,7 +49,7 @@ class AuthResponseSubscriber { do { try await recoverAndVerifySignature(caip222Request: payload.request.payloadParams, cacaos: cacaos) } catch { - onResponse?(requestId, .failure(error)) + onResponse?(requestId, .failure(error as! AuthError)) return } createSession(form: cacaos) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 5e6ce4c57..0503a41f7 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -109,7 +109,7 @@ public final class SignClient: SignClientProtocol { /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. /// /// Emited result may be an error. - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } //--------------------------------------------------------------------------------- @@ -157,7 +157,7 @@ public final class SignClient: SignClientProtocol { private let sessionExtendPublisherSubject = PassthroughSubject<(sessionTopic: String, date: Date), Never>() private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private var publishers = Set() From 994bcef7fc58e3af57ff3b3bab691af39ce3441a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 11:43:51 +0100 Subject: [PATCH 086/814] update tests --- .../IntegrationTests/Sign/SignClientTests.swift | 16 ++++++++++++---- .../Services/App/AuthResponseSubscriber.swift | 5 +++-- 2 files changed, 15 insertions(+), 6 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index ab1bb04da..178c45dc5 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -764,13 +764,21 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticated() async throws { let responseExpectation = expectation(description: "successful response delivered") - wallet.authRequestPublisher.sink { [unowned self] request in + wallet.authRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) - let payload = try! request.0.payload.cacaoPayload(address: walletAccount.address) - let signature = try! signer.sign(payload: payload, privateKey: prvKey, type: .eip191) - try! await wallet.respondSessionAuthenticate(requestId: request.0.id, signature: signature, account: walletAccount) + + let SIWEmessages = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + + let signature = try signer.sign( + message: SIWEmessages, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) + + try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) } } .store(in: &publishers) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 227fdc23c..0b7317d4e 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -52,7 +52,7 @@ class AuthResponseSubscriber { onResponse?(requestId, .failure(error as! AuthError)) return } - createSession(form: cacaos) + return createSession(form: cacaos) } }.store(in: &publishers) @@ -89,7 +89,8 @@ class AuthResponseSubscriber { } } - private func createSession(form cacaos: [Cacao]) { + private func createSession(form cacaos: [Cacao]) -> Session { + } } From de479802abe7de4bfc759af538f18ecbe2400e17 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 14:49:07 +0100 Subject: [PATCH 087/814] build session from auth --- .../Services/App/AuthResponseSubscriber.swift | 64 +++++++++++++++++-- .../App/SessionAuthRequestService.swift | 4 +- .../Wallet/AuthRequestSubscriber.swift | 8 +-- .../Auth/Services/Wallet/AuthResponder.swift | 15 +++-- .../Wallet/PendingRequestsProvider.swift | 4 +- .../Wallet/WalletErrorResponder.swift | 6 +- .../ProtocolRPCParams/AuthRequestParams.swift | 14 ---- .../AuthResponseParams.swift | 4 -- .../SessionAuthenticateRequestParams.swift | 8 +++ .../SessionAuthenticateResponseParams.swift | 7 ++ 10 files changed, 94 insertions(+), 40 deletions(-) delete mode 100644 Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift delete mode 100644 Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift create mode 100644 Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 0b7317d4e..60c3e912c 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -9,6 +9,8 @@ class AuthResponseSubscriber { private let messageFormatter: SIWECacaoFormatting private let pairingRegisterer: PairingRegisterer private var publishers = [AnyCancellable]() + private let sessionStore: WCSessionStorage + private let kms: KeyManagementServiceProtocol var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? @@ -17,10 +19,14 @@ class AuthResponseSubscriber { rpcHistory: RPCHistory, signatureVerifier: MessageVerifier, pairingRegisterer: PairingRegisterer, + kms: KeyManagementServiceProtocol, + sessionStore: WCSessionStorage, messageFormatter: SIWECacaoFormatting) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory + self.kms = kms + self.sessionStore = sessionStore self.signatureVerifier = signatureVerifier self.messageFormatter = messageFormatter self.pairingRegisterer = pairingRegisterer @@ -29,30 +35,31 @@ class AuthResponseSubscriber { private func subscribeForResponse() { networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } onResponse?(payload.id, .failure(error)) }.store(in: &publishers) networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + .sink { [unowned self] (payload: ResponseSubscriptionPayload) in pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) networkingInteractor.unsubscribe(topic: payload.topic) let requestId = payload.id - let cacaos = payload.response + let cacaos = payload.response.caip222Response let requestPayload = payload.request Task { do { - try await recoverAndVerifySignature(caip222Request: payload.request.payloadParams, cacaos: cacaos) + try await recoverAndVerifySignature(caip222Request: payload.request.caip222Request, cacaos: cacaos) } catch { onResponse?(requestId, .failure(error as! AuthError)) return } - return createSession(form: cacaos) + let pairingTopic = "" // TODO - get pairing topic somehow here + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) } }.store(in: &publishers) @@ -89,9 +96,54 @@ class AuthResponseSubscriber { } } - private func createSession(form cacaos: [Cacao]) -> Session { + private func createSession(from response: SessionAuthenticateResponseParams, selfParticipant: Participant, pairingTopic: String) throws -> Session { + let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) + let agreementKeys = try kms.performKeyAgreement(selfPublicKey: selfPublicKey, peerPublicKey: response.responder.publicKey) + let sessionTopic = agreementKeys.derivedTopic() + try kms.setAgreementSecret(agreementKeys, topic: sessionTopic) + + let expiry = Date() + .addingTimeInterval(TimeInterval(WCSession.defaultTimeToLive)) + .timeIntervalSince1970 + + let relay = RelayProtocolOptions(protocol: "irn", data: nil) + + let sessionNamespaces = buildSessionNamespaces() + let requiredNamespaces = buildRequiredNamespaces() + + let settleParams = SessionType.SettleParams( + relay: relay, + controller: selfParticipant, + namespaces: sessionNamespaces, + sessionProperties: nil, + expiry: Int64(expiry) + ) + + let session = WCSession( + topic: sessionTopic, + pairingTopic: pairingTopic, + timestamp: Date(), + selfParticipant: selfParticipant, + peerParticipant: response.responder, + settleParams: settleParams, + requiredNamespaces: requiredNamespaces, + acknowledged: false + ) + + sessionStore.setSession(session) + + + return session.publicRepresentation() + } + + private func buildSessionNamespaces() -> [String: SessionNamespace] { + return [:] + } + + private func buildRequiredNamespaces() -> [String: ProposalNamespace] { + return [:] } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 66402a3d9..ba1e8165e 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -23,9 +23,9 @@ actor SessionAuthRequestService { let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let protocolMethod = SessionAuthenticatedProtocolMethod() - let requester = AuthRequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) + let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) let payload = Caip222Request(requestParams: params, iat: iatProvader.iat) - let params = AuthRequestParams(requester: requester, payloadParams: payload) + let params = SessionAuthenticateRequestParams(requester: requester, caip222Request: payload) let request = RPCRequest(method: protocolMethod.method, params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index b9969aed8..d22fbdbdc 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -34,22 +34,22 @@ class AuthRequestSubscriber { private func subscribeForRequest() { pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in + .sink { [unowned self] (payload: RequestSubscriptionPayload) in logger.debug("WalletRequestSubscriber: Received request") pairingRegisterer.setReceived(pairingTopic: payload.topic) - let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams, requester: payload.request.requester.metadata) + let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.caip222Request, requester: payload.request.requester.metadata) Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() do { let response = try await verifyClient.verifyOrigin(assertionId: assertionId) - let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.payloadParams.domain, isScam: response.isScam) + let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.caip222Request.domain, isScam: response.isScam) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.payloadParams.domain, isScam: nil) + let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.caip222Request.domain, isScam: nil) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) return diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index d79533feb..ce895121a 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -12,6 +12,7 @@ actor AuthResponder { private let logger: ConsoleLogging private let walletErrorResponder: WalletErrorResponder private let pairingRegisterer: PairingRegisterer + private let metadata: AppMetadata init( networkingInteractor: NetworkInteracting, @@ -20,7 +21,8 @@ actor AuthResponder { rpcHistory: RPCHistory, verifyContextStore: CodableStore, walletErrorResponder: WalletErrorResponder, - pairingRegisterer: PairingRegisterer + pairingRegisterer: PairingRegisterer, + metadata: AppMetadata ) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -29,6 +31,7 @@ actor AuthResponder { self.verifyContextStore = verifyContextStore self.walletErrorResponder = walletErrorResponder self.pairingRegisterer = pairingRegisterer + self.metadata = metadata } func respond(requestId: RPCID, auths: [AuthObject]) async throws { @@ -37,7 +40,8 @@ actor AuthResponder { try kms.setAgreementSecret(keys, topic: topic) - let responseParams = auths + let selfParticipant = Participant(publicKey: keys.publicKey.hexRepresentation, metadata: metadata) + let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, caip222Response: auths) let response = RPCResponse(id: requestId, result: responseParams) try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) @@ -55,17 +59,17 @@ actor AuthResponder { verifyContextStore.delete(forKey: requestId.string) } - private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { + private func getAuthRequestParams(requestId: RPCID) throws -> SessionAuthenticateRequestParams { guard let request = rpcHistory.get(recordId: requestId)?.request else { throw Errors.recordForIdNotFound } - guard let authRequestParams = try request.params?.get(AuthRequestParams.self) + guard let authRequestParams = try request.params?.get(SessionAuthenticateRequestParams.self) else { throw Errors.malformedAuthRequestParams } return authRequestParams } - private func generateAgreementKeys(requestParams: AuthRequestParams) throws -> (topic: String, keys: AgreementKeys) { + private func generateAgreementKeys(requestParams: SessionAuthenticateRequestParams) throws -> (topic: String, keys: AgreementKeys) { let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) let topic = peerPubKey.rawRepresentation.sha256().toHexString() let selfPubKey = try kms.createX25519KeyPair() @@ -73,3 +77,4 @@ actor AuthResponder { return (topic, keys) } } + diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift index d863369cc..0d1ce669b 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift @@ -16,8 +16,8 @@ class PendingRequestsProvider { let pendingRequests: [AuthenticationRequest] = rpcHistory.getPending() .filter {$0.request.method == "wc_sessionAuthenticate"} .compactMap { - guard let params = try? $0.request.params?.get(AuthRequestParams.self) else { return nil } - return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams, requester: params.requester.metadata) + guard let params = try? $0.request.params?.get(SessionAuthenticateRequestParams.self) else { return nil } + return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.caip222Request, requester: params.requester.metadata) } return pendingRequests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift index e5a1a3ded..e4c513fbc 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift @@ -31,17 +31,17 @@ actor WalletErrorResponder { try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: SessionAuthenticatedProtocolMethod(), reason: error, envelopeType: envelopeType) } - private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { + private func getAuthRequestParams(requestId: RPCID) throws -> SessionAuthenticateRequestParams { guard let request = rpcHistory.get(recordId: requestId)?.request else { throw Errors.recordForIdNotFound } - guard let authRequestParams = try request.params?.get(AuthRequestParams.self) + guard let authRequestParams = try request.params?.get(SessionAuthenticateRequestParams.self) else { throw Errors.malformedAuthRequestParams } return authRequestParams } - private func generateAgreementKeys(requestParams: AuthRequestParams) throws -> (topic: String, keys: AgreementKeys) { + private func generateAgreementKeys(requestParams: SessionAuthenticateRequestParams) throws -> (topic: String, keys: AgreementKeys) { let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) let topic = peerPubKey.rawRepresentation.sha256().toHexString() let selfPubKey = try kms.createX25519KeyPair() diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift deleted file mode 100644 index 4fce8153b..000000000 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift +++ /dev/null @@ -1,14 +0,0 @@ -import Foundation - -/// wc_sessionAuthenticate RPC method request param -struct AuthRequestParams: Codable, Equatable { - let requester: Requester - let payloadParams: Caip222Request -} - -extension AuthRequestParams { - struct Requester: Codable, Equatable { - let publicKey: String - let metadata: AppMetadata - } -} diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift deleted file mode 100644 index e2d097c01..000000000 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift +++ /dev/null @@ -1,4 +0,0 @@ -import Foundation - -/// wc_authRequest RPC method respond param -typealias AuthResponseParams = Cacao diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift new file mode 100644 index 000000000..6d78fe8f7 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -0,0 +1,8 @@ +import Foundation + +/// wc_sessionAuthenticate RPC method request param +struct SessionAuthenticateRequestParams: Codable, Equatable { + let requester: Participant + let caip222Request: Caip222Request +} + diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift new file mode 100644 index 000000000..aa426bc32 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift @@ -0,0 +1,7 @@ +import Foundation + +/// wc_sessionAuthenticate RPC method respond param +struct SessionAuthenticateResponseParams: Codable, Equatable { + let responder: Participant + let caip222Response: [Cacao] +} From e80e0369c30c061a7685ec974a4d63470bce8189 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 14:54:41 +0100 Subject: [PATCH 088/814] fix build --- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 18c78f36f..273439ddb 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -94,10 +94,10 @@ public struct SignClientFactory { let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, messageFormatter: messageFormatter) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient) + let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) From c97500e31e538c84e996e7432185bcf6ae1d98d7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 15:46:56 +0100 Subject: [PATCH 089/814] fix tests --- .../Sign/SignClientTests.swift | 69 +++++++------------ .../Services/App/AuthResponseSubscriber.swift | 4 +- .../WalletConnectSign/Sign/SignClient.swift | 4 +- 3 files changed, 28 insertions(+), 49 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 178c45dc5..4fe6a053b 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -831,7 +831,7 @@ final class SignClientTests: XCTestCase { // wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) // } - func testEIP191RespondError() async { + func testEIP191SessionAuthenticateSignatureVerificationFailed() async { let responseExpectation = expectation(description: "error response delivered") dapp.enableAuthenticatedSessions() let uri = try! await dappPairingClient.create() @@ -856,50 +856,27 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } -// -// func testUserRespondError() async { -// let responseExpectation = expectation(description: "error response delivered") -// dapp.enableAuthenticatedSessions() -// let uri = try! await dappPairingClient.create() -// try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// wallet.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// try! await wallet.rejectSession(requestId: request.0.id) -// } -// } -// .store(in: &publishers) -// dapp.authResponsePublisher.sink { (_, result) in -// guard case .failure(let error) = result else { XCTFail(); return } -// XCTAssertEqual(error, .userRejeted) -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } -// func testRespondSignatureVerificationFailed() async { -// let responseExpectation = expectation(description: "invalid signature response delivered") -// dapp.enableAuthenticatedSessions() -// let uri = try! await dappPairingClient.create() -// try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// wallet.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" -// let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) -// try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: cacaoSignature, account: walletAccount) -// } -// } -// .store(in: &publishers) -// dapp.authResponsePublisher.sink { (_, result) in -// guard case .failure(let error) = result else { XCTFail(); return } -// XCTAssertEqual(error, .signatureVerificationFailed) -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } + func testUserRespondError() async { + let responseExpectation = expectation(description: "error response delivered") + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + + try? await walletPairingClient.pair(uri: uri) + wallet.authRequestPublisher.sink { [unowned self] request in + Task(priority: .high) { + try! await wallet.rejectSession(requestId: request.0.id) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .failure(let error) = result else { XCTFail(); return } + XCTAssertEqual(error, .userRejeted) + responseExpectation.fulfill() + } + .store(in: &publishers) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 60c3e912c..bca349977 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -12,7 +12,7 @@ class AuthResponseSubscriber { private let sessionStore: WCSessionStorage private let kms: KeyManagementServiceProtocol - var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? + var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -60,6 +60,8 @@ class AuthResponseSubscriber { } let pairingTopic = "" // TODO - get pairing topic somehow here let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) + + onResponse?(requestId, .success(session)) } }.store(in: &publishers) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 0503a41f7..fdb022c9a 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -109,7 +109,7 @@ public final class SignClient: SignClientProtocol { /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. /// /// Emited result may be an error. - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } //--------------------------------------------------------------------------------- @@ -157,7 +157,7 @@ public final class SignClient: SignClientProtocol { private let sessionExtendPublisherSubject = PassthroughSubject<(sessionTopic: String, date: Date), Never>() private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private var publishers = Set() From 0f159bc870a3a57917294061bc20bc27d98f127f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 15:58:58 +0100 Subject: [PATCH 090/814] add failing testEIP191SessionAuthenticatedMultiCacao --- .../Sign/SignClientTests.swift | 46 ++++++++++++++++++- 1 file changed, 44 insertions(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 4fe6a053b..b25986ff7 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -769,10 +769,10 @@ final class SignClientTests: XCTestCase { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) - let SIWEmessages = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + let Siwemessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) let signature = try signer.sign( - message: SIWEmessages, + message: Siwemessage, privateKey: prvKey, type: .eip191) @@ -796,6 +796,48 @@ final class SignClientTests: XCTestCase { wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } + func testEIP191SessionAuthenticatedMultiCacao() async throws { + let responseExpectation = expectation(description: "successful response delivered") + + wallet.authRequestPublisher.sink { [unowned self] (request, _) in + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) + + var cacaos = [Cacao]() + + request.payload.chains.forEach { chain in + + let SiweMessage = try! wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + + let signature = try! signer.sign( + message: SiweMessage, + privateKey: prvKey, + type: .eip191) + + let cacao = try! wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) + cacaos.append(cacao) + + } + try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: cacaos) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success(let session) = result else { XCTFail(); return } + XCTAssertEqual(session.accounts.count, 2) + responseExpectation.fulfill() + } + .store(in: &publishers) + + + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try await dapp.authenticate(RequestParams.stub(chains: ["eip155:1", "eip155:137"]), topic: uri.topic) + try await walletPairingClient.pair(uri: uri) + wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + // func testEIP1271SessionAuthenticated() async throws { // // let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! From a10837dc8b104bb174e8361b540924136e61a618 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Dec 2023 16:19:30 +0100 Subject: [PATCH 091/814] savepoint --- .../Services/App/AuthResponseSubscriber.swift | 33 ++++++++----------- .../Extensions/Sequence.swift | 15 +++++++++ 2 files changed, 29 insertions(+), 19 deletions(-) create mode 100644 Sources/WalletConnectUtils/Extensions/Sequence.swift diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index bca349977..88b0f6fee 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -49,6 +49,7 @@ class AuthResponseSubscriber { let requestId = payload.id let cacaos = payload.response.caip222Response + let caip222Request = payload.request.caip222Request let requestPayload = payload.request Task { @@ -59,7 +60,7 @@ class AuthResponseSubscriber { return } let pairingTopic = "" // TODO - get pairing topic somehow here - let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, caip222Request: caip222Request) onResponse?(requestId, .success(session)) } @@ -79,7 +80,8 @@ class AuthResponseSubscriber { guard let recovered = try? messageFormatter.formatMessage( from: caip222Request.cacaoPayload(account: account) - ), recovered == message + ), + recovered == message else { throw AuthError.messageCompromised } @@ -98,7 +100,12 @@ class AuthResponseSubscriber { } } - private func createSession(from response: SessionAuthenticateResponseParams, selfParticipant: Participant, pairingTopic: String) throws -> Session { + private func createSession( + from response: SessionAuthenticateResponseParams, + selfParticipant: Participant, + pairingTopic: String, + caip222Request: Caip222Request + ) throws -> Session { let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) let agreementKeys = try kms.performKeyAgreement(selfPublicKey: selfPublicKey, peerPublicKey: response.responder.publicKey) @@ -112,8 +119,8 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = buildSessionNamespaces() - let requiredNamespaces = buildRequiredNamespaces() + let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) + let requiredNamespaces = buildRequiredNamespaces(caip222Request: caip222Request) let settleParams = SessionType.SettleParams( relay: relay, @@ -140,24 +147,12 @@ class AuthResponseSubscriber { return session.publicRepresentation() } - private func buildSessionNamespaces() -> [String: SessionNamespace] { + private func buildSessionNamespaces(cacaos: [Cacao]) -> [String: SessionNamespace] { return [:] } - private func buildRequiredNamespaces() -> [String: ProposalNamespace] { + private func buildRequiredNamespaces(caip222Request: Caip222Request) -> [String: ProposalNamespace] { return [:] } } -extension Sequence { - func asyncForEach(_ operation: @escaping (Element) async throws -> Void) async throws { - try await withThrowingTaskGroup(of: Void.self) { group in - for element in self { - group.addTask { - try await operation(element) - } - } - try await group.waitForAll() - } - } -} diff --git a/Sources/WalletConnectUtils/Extensions/Sequence.swift b/Sources/WalletConnectUtils/Extensions/Sequence.swift new file mode 100644 index 000000000..0e8b5f341 --- /dev/null +++ b/Sources/WalletConnectUtils/Extensions/Sequence.swift @@ -0,0 +1,15 @@ +import Combine +import Foundation + +public extension Sequence { + func asyncForEach(_ operation: @escaping (Element) async throws -> Void) async throws { + try await withThrowingTaskGroup(of: Void.self) { group in + for element in self { + group.addTask { + try await operation(element) + } + } + try await group.waitForAll() + } + } +} From 19f28c70dba4ad6653a139ee1559167158816c4f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Dec 2023 10:56:57 +0100 Subject: [PATCH 092/814] build session on wallet side --- .../xcschemes/WalletConnect.xcscheme | 23 ----- .../Services/App/AuthResponseSubscriber.swift | 8 +- .../Auth/Services/Wallet/AuthResponder.swift | 95 +++++++++++++++++-- 3 files changed, 91 insertions(+), 35 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme index d1bc7d784..b5824ecd8 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme @@ -6,20 +6,6 @@ parallelizeBuildables = "YES" buildImplicitDependencies = "YES"> - - - - - - - - diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 88b0f6fee..bbddee875 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -110,6 +110,8 @@ class AuthResponseSubscriber { let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) let agreementKeys = try kms.performKeyAgreement(selfPublicKey: selfPublicKey, peerPublicKey: response.responder.publicKey) + let peerParticipant = response.responder + let sessionTopic = agreementKeys.derivedTopic() try kms.setAgreementSecret(agreementKeys, topic: sessionTopic) @@ -124,7 +126,7 @@ class AuthResponseSubscriber { let settleParams = SessionType.SettleParams( relay: relay, - controller: selfParticipant, + controller: peerParticipant, namespaces: sessionNamespaces, sessionProperties: nil, expiry: Int64(expiry) @@ -142,7 +144,9 @@ class AuthResponseSubscriber { ) sessionStore.setSession(session) - + Task { + try await networkingInteractor.subscribe(topic: sessionTopic) + } return session.publicRepresentation() } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index ce895121a..49d9e27e9 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -1,4 +1,5 @@ import Foundation +import Combine actor AuthResponder { enum Errors: Error { @@ -13,6 +14,11 @@ actor AuthResponder { private let walletErrorResponder: WalletErrorResponder private let pairingRegisterer: PairingRegisterer private let metadata: AppMetadata + private let sessionStore: WCSessionStorage + private let sessionSettledPublisherSubject = PassthroughSubject() + var sessionSettledPublisher: AnyPublisher { + return sessionSettledPublisherSubject.eraseToAnyPublisher() + } init( networkingInteractor: NetworkInteracting, @@ -22,7 +28,8 @@ actor AuthResponder { verifyContextStore: CodableStore, walletErrorResponder: WalletErrorResponder, pairingRegisterer: PairingRegisterer, - metadata: AppMetadata + metadata: AppMetadata, + sessionStore: WCSessionStorage ) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -32,26 +39,37 @@ actor AuthResponder { self.walletErrorResponder = walletErrorResponder self.pairingRegisterer = pairingRegisterer self.metadata = metadata + self.sessionStore = sessionStore } func respond(requestId: RPCID, auths: [AuthObject]) async throws { - let authRequestParams = try getAuthRequestParams(requestId: requestId) - let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) + let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) + let (sessionTopic, keys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + - try kms.setAgreementSecret(keys, topic: topic) + try kms.setAgreementSecret(keys, topic: sessionTopic) let selfParticipant = Participant(publicKey: keys.publicKey.hexRepresentation, metadata: metadata) let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, caip222Response: auths) let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) + try await networkingInteractor.respond(topic: sessionTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) + + let session = try createSession( + response: responseParams, + pairingTopic: pairingTopic, + request: sessionAuthenticateRequestParams, + sessionTopic: sessionTopic + ) + pairingRegisterer.activate( - pairingTopic: topic, - peerMetadata: authRequestParams.requester.metadata + pairingTopic: sessionTopic, + peerMetadata: sessionAuthenticateRequestParams.requester.metadata ) verifyContextStore.delete(forKey: requestId.string) + sessionSettledPublisherSubject.send(session) } func respondError(requestId: RPCID) async throws { @@ -59,14 +77,15 @@ actor AuthResponder { verifyContextStore.delete(forKey: requestId.string) } - private func getAuthRequestParams(requestId: RPCID) throws -> SessionAuthenticateRequestParams { - guard let request = rpcHistory.get(recordId: requestId)?.request + private func getsessionAuthenticateRequestParams(requestId: RPCID) throws -> (request: SessionAuthenticateRequestParams, topic: String) { + guard let record = rpcHistory.get(recordId: requestId) else { throw Errors.recordForIdNotFound } + let request = record.request guard let authRequestParams = try request.params?.get(SessionAuthenticateRequestParams.self) else { throw Errors.malformedAuthRequestParams } - return authRequestParams + return (request: authRequestParams, topic: record.topic) } private func generateAgreementKeys(requestParams: SessionAuthenticateRequestParams) throws -> (topic: String, keys: AgreementKeys) { @@ -76,5 +95,61 @@ actor AuthResponder { let keys = try kms.performKeyAgreement(selfPublicKey: selfPubKey, peerPublicKey: peerPubKey.hexRepresentation) return (topic, keys) } + + + private func createSession( + response: SessionAuthenticateResponseParams, + pairingTopic: String, + request: SessionAuthenticateRequestParams, + sessionTopic: String + ) throws -> Session { + + + let selfParticipant = response.responder + let peerParticipant = request.requester + + let expiry = Date() + .addingTimeInterval(TimeInterval(WCSession.defaultTimeToLive)) + .timeIntervalSince1970 + + let relay = RelayProtocolOptions(protocol: "irn", data: nil) + + let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) + let requiredNamespaces = buildRequiredNamespaces(caip222Request: request.caip222Request) + + let settleParams = SessionType.SettleParams( + relay: relay, + controller: selfParticipant, + namespaces: sessionNamespaces, + sessionProperties: nil, + expiry: Int64(expiry) + ) + + let session = WCSession( + topic: sessionTopic, + pairingTopic: pairingTopic, + timestamp: Date(), + selfParticipant: selfParticipant, + peerParticipant: peerParticipant, + settleParams: settleParams, + requiredNamespaces: requiredNamespaces, + acknowledged: false + ) + + sessionStore.setSession(session) + Task { + try await networkingInteractor.subscribe(topic: sessionTopic) + } + + return session.publicRepresentation() + } + + private func buildSessionNamespaces(cacaos: [Cacao]) -> [String: SessionNamespace] { + return [:] + } + + private func buildRequiredNamespaces(caip222Request: Caip222Request) -> [String: ProposalNamespace] { + return [:] + } } From 08d3f1a5ac1cd400281d7cc73a95886f8da0ef4a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Dec 2023 11:23:36 +0100 Subject: [PATCH 093/814] set pairing topic for dapp's session --- .../Auth/Services/App/AuthResponseSubscriber.swift | 8 ++++++-- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 2 +- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index bbddee875..729934a33 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -50,8 +50,12 @@ class AuthResponseSubscriber { let requestId = payload.id let cacaos = payload.response.caip222Response let caip222Request = payload.request.caip222Request - let requestPayload = payload.request + guard let record = rpcHistory.get(recordId: payload.id) else { + logger.error("record not found") + return + } + let pairingTopic = record.topic Task { do { try await recoverAndVerifySignature(caip222Request: payload.request.caip222Request, cacaos: cacaos) @@ -59,7 +63,7 @@ class AuthResponseSubscriber { onResponse?(requestId, .failure(error as! AuthError)) return } - let pairingTopic = "" // TODO - get pairing topic somehow here + let pairingTopic = pairingTopic let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, caip222Request: caip222Request) onResponse?(requestId, .success(session)) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 273439ddb..5598ab803 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -97,7 +97,7 @@ public struct SignClientFactory { let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata) + let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) From 62559130a535a736b5b2e1b7fc9c50c32c5bbcfd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Dec 2023 12:07:46 +0100 Subject: [PATCH 094/814] fix pairing activation --- .../Sign/SignClientTests.swift | 69 ++++++++++++++++++- .../Services/App/AuthResponseSubscriber.swift | 14 ++-- .../Auth/Services/Wallet/AuthResponder.swift | 2 +- .../Engine/Common/SessionEngine.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 14 ++-- 5 files changed, 83 insertions(+), 18 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index b25986ff7..4be102572 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -63,8 +63,8 @@ final class SignClientTests: XCTestCase { } override func setUp() async throws { - (dappPairingClient, dapp) = Self.makeClients(name: "🍏P") - (walletPairingClient, wallet) = Self.makeClients(name: "🍎R") + (dappPairingClient, dapp) = Self.makeClients(name: "🍏Dapp") + (walletPairingClient, wallet) = Self.makeClients(name: "🍎Wallet") } override func tearDown() { @@ -921,4 +921,69 @@ final class SignClientTests: XCTestCase { wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) } + func testSessionRequestOnAuthenticatedSession() async throws { + let requestExpectation = expectation(description: "Wallet expects to receive a request") + let responseExpectation = expectation(description: "Dapp expects to receive a response") + + let requestMethod = "eth_sendTransaction" + let requestParams = [EthSendTransaction.stub()] + let responseParams = "0xdeadbeef" + let chain = Blockchain("eip155:1")! + + wallet.authRequestPublisher.sink { [unowned self] (request, _) in + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) + + let Siwemessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + + let signature = try signer.sign( + message: Siwemessage, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) + + try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { [unowned self] (_, result) in + guard case .success(let session) = result else { XCTFail(); return } + + Task(priority: .high) { + let request = Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) + try await dapp.request(params: request) + } + } + .store(in: &publishers) + + wallet.sessionRequestPublisher.sink { [unowned self] (sessionRequest, _) in + let receivedParams = try! sessionRequest.params.get([EthSendTransaction].self) + XCTAssertEqual(receivedParams, requestParams) + XCTAssertEqual(sessionRequest.method, requestMethod) + requestExpectation.fulfill() + Task(priority: .high) { + try await wallet.respond(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(AnyCodable(responseParams))) + } + }.store(in: &publishers) + + dapp.sessionResponsePublisher.sink { response in + switch response.result { + case .response(let response): + XCTAssertEqual(try! response.get(String.self), responseParams) + case .error: + XCTFail() + } + responseExpectation.fulfill() + }.store(in: &publishers) + + + dapp.enableAuthenticatedSessions() + let uri = try! await dappPairingClient.create() + try await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + try await walletPairingClient.pair(uri: uri) + wait(for: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) + } + } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 729934a33..976777c46 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -43,19 +43,19 @@ class AuthResponseSubscriber { networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) + guard let record = rpcHistory.get(recordId: payload.id) else { + logger.error("record not found") + return + } + let pairingTopic = record.topic - networkingInteractor.unsubscribe(topic: payload.topic) + pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) let requestId = payload.id let cacaos = payload.response.caip222Response let caip222Request = payload.request.caip222Request - guard let record = rpcHistory.get(recordId: payload.id) else { - logger.error("record not found") - return - } - let pairingTopic = record.topic + Task { do { try await recoverAndVerifySignature(caip222Request: payload.request.caip222Request, cacaos: cacaos) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 49d9e27e9..673cc2db3 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -64,7 +64,7 @@ actor AuthResponder { ) pairingRegisterer.activate( - pairingTopic: sessionTopic, + pairingTopic: pairingTopic, peerMetadata: sessionAuthenticateRequestParams.requester.metadata ) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index f2598b074..2de0d3b40 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -58,7 +58,7 @@ final class SessionEngine { logger.debug("will request on session topic: \(request.topic)") guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { logger.debug("Could not find session for topic \(request.topic)") - return // TODO: Marked to review on developer facing error cases + return } guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { throw WalletConnectError.invalidPermissions diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index fdb022c9a..baa79188a 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -255,13 +255,13 @@ public final class SignClient: SignClientProtocol { "personal_sign", ], events: [] )] - try await appProposeService.propose( - pairingTopic: topic, - namespaces: testNamespace, - optionalNamespaces: nil, - sessionProperties: nil, - relay: RelayProtocolOptions(protocol: "irn", data: nil) - ) +// try await appProposeService.propose( +// pairingTopic: topic, +// namespaces: testNamespace, +// optionalNamespaces: nil, +// sessionProperties: nil, +// relay: RelayProtocolOptions(protocol: "irn", data: nil) +// ) } public func enableAuthenticatedSessions() { From d3d1587e4e67c27d69f2a85d0abccd494caa7b39 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Dec 2023 12:13:55 +0100 Subject: [PATCH 095/814] set session for always acknowledged --- Example/IntegrationTests/Sign/SignClientTests.swift | 1 + .../Auth/Services/App/AuthResponseSubscriber.swift | 2 +- .../WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift | 2 +- Sources/WalletConnectSign/Engine/Common/SessionEngine.swift | 1 + 4 files changed, 4 insertions(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 4be102572..8fb57a1c3 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -952,6 +952,7 @@ final class SignClientTests: XCTestCase { guard case .success(let session) = result else { XCTFail(); return } Task(priority: .high) { + sleep(1) let request = Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) try await dapp.request(params: request) } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 976777c46..75672cee7 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -144,7 +144,7 @@ class AuthResponseSubscriber { peerParticipant: response.responder, settleParams: settleParams, requiredNamespaces: requiredNamespaces, - acknowledged: false + acknowledged: true ) sessionStore.setSession(session) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 673cc2db3..fcd741184 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -133,7 +133,7 @@ actor AuthResponder { peerParticipant: peerParticipant, settleParams: settleParams, requiredNamespaces: requiredNamespaces, - acknowledged: false + acknowledged: true ) sessionStore.setSession(session) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 2de0d3b40..ccef12344 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -61,6 +61,7 @@ final class SessionEngine { return } guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + logger.debug("Invalid namespaces") throw WalletConnectError.invalidPermissions } let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiry: request.expiry) From f0042f194dd8a13ef4021de2448bb66c52754a18 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Dec 2023 16:35:51 +0100 Subject: [PATCH 096/814] savepoint --- .../Services/App/AuthResponseSubscriber.swift | 16 +++++------ .../App/SessionAuthRequestService.swift | 4 +-- .../Wallet/AuthRequestSubscriber.swift | 6 ++--- .../Auth/Services/Wallet/AuthResponder.swift | 4 +-- .../Wallet/PendingRequestsProvider.swift | 2 +- ...Caip222Request.swift => AuthPayload.swift} | 3 ++- .../SessionAuthenticateRequestParams.swift | 3 ++- .../Types/Public/AuthenticationRequest.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 2 +- .../Sign/SignClientProtocol.swift | 2 +- .../SIWE/RecapFactory.swift | 17 ++++++++++++ .../SIWE/SIWECacaoFormatter.swift | 1 + Sources/Web3Wallet/Web3WalletClient.swift | 2 +- .../Mocks/SIWEMessageFormatterMock.swift | 4 +++ .../RecapFactoryTests.swift | 27 +++++++++++++++++++ 15 files changed, 73 insertions(+), 22 deletions(-) rename Sources/WalletConnectSign/Auth/Types/{Caip222Request.swift => AuthPayload.swift} (96%) create mode 100644 Sources/WalletConnectUtils/SIWE/RecapFactory.swift create mode 100644 Tests/WalletConnectUtilsTests/RecapFactoryTests.swift diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 75672cee7..e38ba136a 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -53,18 +53,18 @@ class AuthResponseSubscriber { let requestId = payload.id let cacaos = payload.response.caip222Response - let caip222Request = payload.request.caip222Request + let authRequestPayload = payload.request.authPayload Task { do { - try await recoverAndVerifySignature(caip222Request: payload.request.caip222Request, cacaos: cacaos) + try await recoverAndVerifySignature(authRequestPayload: payload.request.authPayload, cacaos: cacaos) } catch { onResponse?(requestId, .failure(error as! AuthError)) return } let pairingTopic = pairingTopic - let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, caip222Request: caip222Request) + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, authRequestPayload: authRequestPayload) onResponse?(requestId, .success(session)) } @@ -72,7 +72,7 @@ class AuthResponseSubscriber { }.store(in: &publishers) } - private func recoverAndVerifySignature(caip222Request: Caip222Request, cacaos: [Cacao]) async throws { + private func recoverAndVerifySignature(authRequestPayload: AuthPayload, cacaos: [Cacao]) async throws { try await cacaos.asyncForEach { [unowned self] cacao in guard let account = try? DIDPKH(did: cacao.p.iss).account, @@ -83,7 +83,7 @@ class AuthResponseSubscriber { guard let recovered = try? messageFormatter.formatMessage( - from: caip222Request.cacaoPayload(account: account) + from: authRequestPayload.cacaoPayload(account: account) ), recovered == message else { @@ -108,7 +108,7 @@ class AuthResponseSubscriber { from response: SessionAuthenticateResponseParams, selfParticipant: Participant, pairingTopic: String, - caip222Request: Caip222Request + authRequestPayload: AuthPayload ) throws -> Session { let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) @@ -126,7 +126,7 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) - let requiredNamespaces = buildRequiredNamespaces(caip222Request: caip222Request) + let requiredNamespaces = buildRequiredNamespaces(caip222Request: authRequestPayload) let settleParams = SessionType.SettleParams( relay: relay, @@ -159,7 +159,7 @@ class AuthResponseSubscriber { return [:] } - private func buildRequiredNamespaces(caip222Request: Caip222Request) -> [String: ProposalNamespace] { + private func buildRequiredNamespaces(caip222Request: AuthPayload) -> [String: ProposalNamespace] { return [:] } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index ba1e8165e..0a3494199 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -24,8 +24,8 @@ actor SessionAuthRequestService { let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let protocolMethod = SessionAuthenticatedProtocolMethod() let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) - let payload = Caip222Request(requestParams: params, iat: iatProvader.iat) - let params = SessionAuthenticateRequestParams(requester: requester, caip222Request: payload) + let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) + let params = SessionAuthenticateRequestParams(requester: requester, authPayload: payload) let request = RPCRequest(method: protocolMethod.method, params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index d22fbdbdc..73b0df040 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -39,17 +39,17 @@ class AuthRequestSubscriber { pairingRegisterer.setReceived(pairingTopic: payload.topic) - let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.caip222Request, requester: payload.request.requester.metadata) + let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.authPayload, requester: payload.request.requester.metadata) Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() do { let response = try await verifyClient.verifyOrigin(assertionId: assertionId) - let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.caip222Request.domain, isScam: response.isScam) + let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.authPayload.domain, isScam: response.isScam) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.caip222Request.domain, isScam: nil) + let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.authPayload.domain, isScam: nil) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) return diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index fcd741184..fdcac88b2 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -115,7 +115,7 @@ actor AuthResponder { let relay = RelayProtocolOptions(protocol: "irn", data: nil) let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) - let requiredNamespaces = buildRequiredNamespaces(caip222Request: request.caip222Request) + let requiredNamespaces = buildRequiredNamespaces(caip222Request: request.authPayload) let settleParams = SessionType.SettleParams( relay: relay, @@ -148,7 +148,7 @@ actor AuthResponder { return [:] } - private func buildRequiredNamespaces(caip222Request: Caip222Request) -> [String: ProposalNamespace] { + private func buildRequiredNamespaces(caip222Request: AuthPayload) -> [String: ProposalNamespace] { return [:] } } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift index 0d1ce669b..436ef75a7 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/PendingRequestsProvider.swift @@ -17,7 +17,7 @@ class PendingRequestsProvider { .filter {$0.request.method == "wc_sessionAuthenticate"} .compactMap { guard let params = try? $0.request.params?.get(SessionAuthenticateRequestParams.self) else { return nil } - return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.caip222Request, requester: params.requester.metadata) + return AuthenticationRequest(id: $0.request.id!, topic: $0.topic, payload: params.authPayload, requester: params.requester.metadata) } return pendingRequests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } diff --git a/Sources/WalletConnectSign/Auth/Types/Caip222Request.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift similarity index 96% rename from Sources/WalletConnectSign/Auth/Types/Caip222Request.swift rename to Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index fd87fe52e..29f7dd8f1 100644 --- a/Sources/WalletConnectSign/Auth/Types/Caip222Request.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -1,6 +1,6 @@ import Foundation -public struct Caip222Request: Codable, Equatable { +public struct AuthPayload: Codable, Equatable { public let domain: String public let aud: String public let version: String @@ -14,6 +14,7 @@ public struct Caip222Request: Codable, Equatable { public let requestId: String? public let resources: [String]? + init(requestParams: RequestParams, iat: String) { self.type = "caip122" self.chains = requestParams.chains diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift index 6d78fe8f7..50f5f3125 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -3,6 +3,7 @@ import Foundation /// wc_sessionAuthenticate RPC method request param struct SessionAuthenticateRequestParams: Codable, Equatable { let requester: Participant - let caip222Request: Caip222Request + let authPayload: AuthPayload } + diff --git a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift index 8fdb248c5..dd707e9ce 100644 --- a/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift +++ b/Sources/WalletConnectSign/Auth/Types/Public/AuthenticationRequest.swift @@ -3,6 +3,6 @@ import Foundation public struct AuthenticationRequest: Equatable, Codable { public let id: RPCID public let topic: String - public let payload: Caip222Request + public let payload: AuthPayload public let requester: AppMetadata } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index baa79188a..aac68283a 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -290,7 +290,7 @@ public final class SignClient: SignClientProtocol { return try pendingRequestsProvider.getPendingRequests() } - public func formatAuthMessage(payload: Caip222Request, account: Account) throws -> String { + public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account)) } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 95caf6019..e8febc068 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -27,7 +27,7 @@ public protocol SignClientProtocol { func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws func getSessions() -> [Session] - func formatAuthMessage(payload: Caip222Request, account: Account) throws -> String + func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String func cleanup() async throws diff --git a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift new file mode 100644 index 000000000..2f742e117 --- /dev/null +++ b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift @@ -0,0 +1,17 @@ +import Foundation + +class RecapFactory { + static func createRecap(resource: String, actions: Set) -> [String: [String: [String: [String]]]] { + var recap: [String: [String: [String: [String]]]] = ["att": [:]] + + var resourceRecap: [String: [String]] = [:] + + for action in actions { + resourceRecap[action] = [] + } + + recap["att"]![resource] = resourceRecap + + return recap + } +} diff --git a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift index c1de90525..aff12dfc5 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift @@ -27,3 +27,4 @@ public struct SIWECacaoFormatter: SIWECacaoFormatting { return message.formatted } } + diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index cc932b563..17a4e014f 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -176,7 +176,7 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatAuthMessage(payload: Caip222Request, account: Account) throws -> String { + public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { try signClient.formatAuthMessage(payload: payload, account: account) } diff --git a/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift b/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift index 94fa4ec59..c88c62ec3 100644 --- a/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift +++ b/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift @@ -2,6 +2,10 @@ import Foundation @testable import Auth class SIWEMessageFormatterMock: SIWECacaoFormatting { + func formatMessage(from payload: WalletConnectUtils.CacaoPayload) throws -> String { + fatalError() + } + var formattedMessage: String! func formatMessages(from payload: CacaoPayload) throws -> String { diff --git a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift new file mode 100644 index 000000000..bd2ee0e37 --- /dev/null +++ b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift @@ -0,0 +1,27 @@ +import XCTest +@testable import WalletConnectUtils // Replace with your actual module name + +class RecapFactoryTests: XCTestCase { + + func testCreateRecap() { + // Define the input values + let resource = "eip155:1" + let actions: Set = ["request/eth_sendTransaction", "request/personal_sign"] + + // Call the function + let recap = RecapFactory.createRecap(resource: resource, actions: actions) + + // Define the expected output + let expectedOutput: [String: [String: [String: [String]]]] = [ + "att": [ + "eip155:1": [ + "request/eth_sendTransaction": [], + "request/personal_sign": [] + ] + ] + ] + + // Assert that the output equals the expected output + XCTAssertEqual(recap, expectedOutput, "createRecap output did not match the expected output") + } +} From 92e3e9c711be4fd51ad024e10d1f6ae02eb05f0b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Dec 2023 17:13:26 +0100 Subject: [PATCH 097/814] update recaps --- .../Services/App/AuthResponseSubscriber.swift | 5 +--- .../App/SessionAuthRequestService.swift | 25 +++++++++++++++++-- .../Auth/Types/RequestParams.swift | 15 ++++++++--- .../SIWE/RecapFactory.swift | 4 +-- 4 files changed, 38 insertions(+), 11 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index e38ba136a..49b82b339 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -126,7 +126,7 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) - let requiredNamespaces = buildRequiredNamespaces(caip222Request: authRequestPayload) + let requiredNamespaces = [:] let settleParams = SessionType.SettleParams( relay: relay, @@ -159,8 +159,5 @@ class AuthResponseSubscriber { return [:] } - private func buildRequiredNamespaces(caip222Request: AuthPayload) -> [String: ProposalNamespace] { - return [:] - } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 0a3494199..4721e9aef 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -1,6 +1,9 @@ import Foundation actor SessionAuthRequestService { + enum Errors: Error { + case invalidChain + } private let networkingInteractor: NetworkInteracting private let appMetadata: AppMetadata private let kms: KeyManagementService @@ -20,16 +23,34 @@ actor SessionAuthRequestService { } func request(params: RequestParams, topic: String) async throws { + var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let protocolMethod = SessionAuthenticatedProtocolMethod() + guard let chainNamespace = Blockchain(params.chains.first!)?.namespace else { + throw Errors.invalidChain + } + if let methods = params.methods, + !methods.isEmpty { + let namespaceRecap = try createNamespaceRecap(chainNamespace: chainNamespace, methods: methods) + params.addResource(resource: namespaceRecap) + } let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) - let params = SessionAuthenticateRequestParams(requester: requester, authPayload: payload) - let request = RPCRequest(method: protocolMethod.method, params: params) + let sessionAuthenticateRequestParams = SessionAuthenticateRequestParams(requester: requester, authPayload: payload) + let request = RPCRequest(method: protocolMethod.method, params: sessionAuthenticateRequestParams) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") try await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) try await networkingInteractor.subscribe(topic: responseTopic) } + + private func createNamespaceRecap(chainNamespace: String, methods: [String]) throws -> String { + let actions = methods.map{"request/\($0)"} + let recap = RecapFactory.createRecap(resource: chainNamespace, actions: actions) + let jsonData = try JSONEncoder().encode(recap) + let base64Encoded = jsonData.base64EncodedString() + let urn = "urn:recap:\(base64Encoded)" + return urn + } } diff --git a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift index e3843078a..82ed7968b 100644 --- a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift @@ -14,6 +14,7 @@ public struct RequestParams { public let statement: String? public let requestId: String? public let resources: [String]? + public let methods: [String]? public init( domain: String, @@ -24,7 +25,8 @@ public struct RequestParams { exp: String?, statement: String?, requestId: String?, - resources: [String]? + resources: [String]?, + methods: [String]? ) { self.domain = domain self.chains = chains @@ -35,6 +37,11 @@ public struct RequestParams { self.statement = statement self.requestId = requestId self.resources = resources + self.methods = methods + } + + mutating func addResource(resource: String) { + resource.append(resource) } } @@ -49,7 +56,8 @@ extension RequestParams { exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"]) -> RequestParams { + resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], + methods: [String]? = nil) -> RequestParams { return RequestParams(domain: domain, chains: chains, nonce: nonce, @@ -58,7 +66,8 @@ extension RequestParams { exp: exp, statement: statement, requestId: requestId, - resources: resources) + resources: resources, + methods: methods) } } #endif diff --git a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift index 2f742e117..8aacaedc0 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift @@ -1,7 +1,7 @@ import Foundation -class RecapFactory { - static func createRecap(resource: String, actions: Set) -> [String: [String: [String: [String]]]] { +public class RecapFactory { + static public func createRecap(resource: String, actions: [String]) -> [String: [String: [String: [String]]]] { var recap: [String: [String: [String: [String]]]] = ["att": [:]] var resourceRecap: [String: [String]] = [:] From f56eb08dd56b29428d1cfcb38a56a57d754db8bc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 10:27:59 +0100 Subject: [PATCH 098/814] recover session namespaces from cacao --- .../Services/App/AuthResponseSubscriber.swift | 7 +- .../App/SessionAuthRequestService.swift | 4 +- .../Auth/Services/Wallet/AuthResponder.swift | 79 ++++++++++++++++--- .../SessionAuthenticateRequestParams.swift | 1 + .../SessionAuthenticateResponseParams.swift | 3 +- .../Auth/Types/RequestParams.swift | 6 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 7 files changed, 82 insertions(+), 20 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 49b82b339..cc5b98dc9 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -52,7 +52,7 @@ class AuthResponseSubscriber { pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) let requestId = payload.id - let cacaos = payload.response.caip222Response + let cacaos = payload.response.cacaos let authRequestPayload = payload.request.authPayload @@ -125,8 +125,7 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) - let requiredNamespaces = [:] + let sessionNamespaces = buildSessionNamespaces(cacaos: response.cacaos) let settleParams = SessionType.SettleParams( relay: relay, @@ -143,7 +142,7 @@ class AuthResponseSubscriber { selfParticipant: selfParticipant, peerParticipant: response.responder, settleParams: settleParams, - requiredNamespaces: requiredNamespaces, + requiredNamespaces: [:], acknowledged: true ) diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 4721e9aef..0ef9816a9 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -48,7 +48,9 @@ actor SessionAuthRequestService { private func createNamespaceRecap(chainNamespace: String, methods: [String]) throws -> String { let actions = methods.map{"request/\($0)"} let recap = RecapFactory.createRecap(resource: chainNamespace, actions: actions) - let jsonData = try JSONEncoder().encode(recap) + let jsonEncoder = JSONEncoder() + jsonEncoder.outputFormatting = .withoutEscapingSlashes + let jsonData = try jsonEncoder.encode(recap) let base64Encoded = jsonData.base64EncodedString() let urn = "urn:recap:\(base64Encoded)" return urn diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index fdcac88b2..cbe88e677 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -5,6 +5,7 @@ actor AuthResponder { enum Errors: Error { case recordForIdNotFound case malformedAuthRequestParams + case cannotCreateSessionNamespaceFromTheRecap } private let networkingInteractor: NetworkInteracting private let kms: KeyManagementService @@ -50,11 +51,11 @@ actor AuthResponder { try kms.setAgreementSecret(keys, topic: sessionTopic) let selfParticipant = Participant(publicKey: keys.publicKey.hexRepresentation, metadata: metadata) - let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, caip222Response: auths) + let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) let response = RPCResponse(id: requestId, result: responseParams) try await networkingInteractor.respond(topic: sessionTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) - + let session = try createSession( response: responseParams, @@ -67,7 +68,7 @@ actor AuthResponder { pairingTopic: pairingTopic, peerMetadata: sessionAuthenticateRequestParams.requester.metadata ) - + verifyContextStore.delete(forKey: requestId.string) sessionSettledPublisherSubject.send(session) } @@ -114,8 +115,7 @@ actor AuthResponder { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = buildSessionNamespaces(cacaos: response.caip222Response) - let requiredNamespaces = buildRequiredNamespaces(caip222Request: request.authPayload) + let sessionNamespaces = try buildSessionNamespaces(cacaos: response.cacaos) let settleParams = SessionType.SettleParams( relay: relay, @@ -132,7 +132,7 @@ actor AuthResponder { selfParticipant: selfParticipant, peerParticipant: peerParticipant, settleParams: settleParams, - requiredNamespaces: requiredNamespaces, + requiredNamespaces: [:], acknowledged: true ) @@ -144,12 +144,71 @@ actor AuthResponder { return session.publicRepresentation() } - private func buildSessionNamespaces(cacaos: [Cacao]) -> [String: SessionNamespace] { - return [:] + private func buildSessionNamespaces(cacaos: [Cacao]) throws -> [String: SessionNamespace] { + + guard let cacao = cacaos.first, + let resources = cacao.p.resources, + let namespacesUrn = resources.last, + let decodedRecap = decodeUrnToJson(urn: namespacesUrn), + let chainsNamespace = try? DIDPKH(did: cacao.p.iss).account.blockchain.namespace else { + throw Errors.cannotCreateSessionNamespaceFromTheRecap + } + + let accounts = cacaos.compactMap{ try? DIDPKH(did: $0.p.iss).account } + + let accountsSet = Set(accounts) + + let methods = getMethods(from: decodedRecap) + + let sessionNamespace = SessionNamespace(accounts: accountsSet, methods: methods, events: []) + return [chainsNamespace: sessionNamespace] } - private func buildRequiredNamespaces(caip222Request: AuthPayload) -> [String: ProposalNamespace] { - return [:] + + private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { + // Extract the Base64 encoded JSON part from the URN + let components = urn.components(separatedBy: ":") + guard components.count >= 3, let base64EncodedJson = components.last else { + logger.debug("Invalid URN format") + return nil + } + + // Decode the Base64 encoded JSON + guard let jsonData = Data(base64Encoded: base64EncodedJson) else { + logger.debug("Failed to decode Base64 string") + return nil + } + + // Deserialize the JSON data into the desired dictionary + do { + let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) + return decodedDictionary + } catch { + logger.debug("Error during JSON decoding: \(error.localizedDescription)") + return nil + } } + + func getMethods(from recap: [String: [String: [String: [String]]]]) -> Set { + var requestMethods: [String] = [] + + // Iterate through the recap dictionary + for (_, resources) in recap { + for (_, requests) in resources { + for (key, _) in requests { + + // Check if the key starts with "request/" + if key.hasPrefix("request/") { + // Extract the method name and add it to the array + let methodName = String(key.dropFirst("request/".count)) + requestMethods.append(methodName) + } + } + } + } + + return Set(requestMethods) + } + } diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift index 50f5f3125..00be847f7 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -3,6 +3,7 @@ import Foundation /// wc_sessionAuthenticate RPC method request param struct SessionAuthenticateRequestParams: Codable, Equatable { let requester: Participant + /// CAIP222 request let authPayload: AuthPayload } diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift index aa426bc32..06f901306 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateResponseParams.swift @@ -3,5 +3,6 @@ import Foundation /// wc_sessionAuthenticate RPC method respond param struct SessionAuthenticateResponseParams: Codable, Equatable { let responder: Participant - let caip222Response: [Cacao] + ///CAIP222 response + let cacaos: [Cacao] } diff --git a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift index 82ed7968b..79338b1f0 100644 --- a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/RequestParams.swift @@ -13,7 +13,7 @@ public struct RequestParams { public let exp: String? public let statement: String? public let requestId: String? - public let resources: [String]? + public var resources: [String]? public let methods: [String]? public init( @@ -41,7 +41,7 @@ public struct RequestParams { } mutating func addResource(resource: String) { - resource.append(resource) + resources?.append(resource) } } @@ -57,7 +57,7 @@ extension RequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = nil) -> RequestParams { + methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> RequestParams { return RequestParams(domain: domain, chains: chains, nonce: nonce, diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 17a4e014f..b135227b3 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -176,7 +176,7 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { + public func formatAuthMessage(payload: WalletConnectSign.AuthPayload, account: Account) throws -> String { try signClient.formatAuthMessage(payload: payload, account: account) } From 0e15b7e1c3849636ada3f939c8f1010022f168e0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 10:32:20 +0100 Subject: [PATCH 099/814] extract session namespaces builder --- .../Services/App/AuthResponseSubscriber.swift | 11 ++- .../Services/SessionNamespaceBuilder.swift | 83 +++++++++++++++++++ .../Auth/Services/Wallet/AuthResponder.swift | 75 +---------------- 3 files changed, 92 insertions(+), 77 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index cc5b98dc9..34ac0c332 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -11,6 +11,7 @@ class AuthResponseSubscriber { private var publishers = [AnyCancellable]() private let sessionStore: WCSessionStorage private let kms: KeyManagementServiceProtocol + private let sessionNamespaceBuilder: SessionNamespaceBuilder var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? @@ -21,7 +22,8 @@ class AuthResponseSubscriber { pairingRegisterer: PairingRegisterer, kms: KeyManagementServiceProtocol, sessionStore: WCSessionStorage, - messageFormatter: SIWECacaoFormatting) { + messageFormatter: SIWECacaoFormatting, + sessionNamespaceBuilder: SessionNamespaceBuilder) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -30,6 +32,7 @@ class AuthResponseSubscriber { self.signatureVerifier = signatureVerifier self.messageFormatter = messageFormatter self.pairingRegisterer = pairingRegisterer + self.sessionNamespaceBuilder = sessionNamespaceBuilder subscribeForResponse() } @@ -125,7 +128,7 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = buildSessionNamespaces(cacaos: response.cacaos) + let sessionNamespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) let settleParams = SessionType.SettleParams( relay: relay, @@ -154,9 +157,5 @@ class AuthResponseSubscriber { return session.publicRepresentation() } - private func buildSessionNamespaces(cacaos: [Cacao]) -> [String: SessionNamespace] { - return [:] - } - } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift new file mode 100644 index 000000000..7cdae5a8b --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -0,0 +1,83 @@ + +import Foundation + +class SessionNamespaceBuilder { + enum Errors: Error { + case recordForIdNotFound + case malformedAuthRequestParams + case cannotCreateSessionNamespaceFromTheRecap + } + private let logger: ConsoleLogging + + init(logger: ConsoleLogging) { + self.logger = logger + } + + func buildSessionNamespaces(cacaos: [Cacao]) throws -> [String: SessionNamespace] { + + guard let cacao = cacaos.first, + let resources = cacao.p.resources, + let namespacesUrn = resources.last, + let decodedRecap = decodeUrnToJson(urn: namespacesUrn), + let chainsNamespace = try? DIDPKH(did: cacao.p.iss).account.blockchain.namespace else { + throw Errors.cannotCreateSessionNamespaceFromTheRecap + } + + let accounts = cacaos.compactMap{ try? DIDPKH(did: $0.p.iss).account } + + let accountsSet = Set(accounts) + + let methods = getMethods(from: decodedRecap) + + let sessionNamespace = SessionNamespace(accounts: accountsSet, methods: methods, events: []) + return [chainsNamespace: sessionNamespace] + } + + + private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { + // Extract the Base64 encoded JSON part from the URN + let components = urn.components(separatedBy: ":") + guard components.count >= 3, let base64EncodedJson = components.last else { + logger.debug("Invalid URN format") + return nil + } + + // Decode the Base64 encoded JSON + guard let jsonData = Data(base64Encoded: base64EncodedJson) else { + logger.debug("Failed to decode Base64 string") + return nil + } + + // Deserialize the JSON data into the desired dictionary + do { + let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) + return decodedDictionary + } catch { + logger.debug("Error during JSON decoding: \(error.localizedDescription)") + return nil + } + } + + func getMethods(from recap: [String: [String: [String: [String]]]]) -> Set { + var requestMethods: [String] = [] + + // Iterate through the recap dictionary + for (_, resources) in recap { + for (_, requests) in resources { + for (key, _) in requests { + + // Check if the key starts with "request/" + if key.hasPrefix("request/") { + // Extract the method name and add it to the array + let methodName = String(key.dropFirst("request/".count)) + requestMethods.append(methodName) + } + } + } + } + + return Set(requestMethods) + } + +} + diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index cbe88e677..3fcf8bf3c 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -5,7 +5,6 @@ actor AuthResponder { enum Errors: Error { case recordForIdNotFound case malformedAuthRequestParams - case cannotCreateSessionNamespaceFromTheRecap } private let networkingInteractor: NetworkInteracting private let kms: KeyManagementService @@ -16,6 +15,7 @@ actor AuthResponder { private let pairingRegisterer: PairingRegisterer private let metadata: AppMetadata private let sessionStore: WCSessionStorage + private let sessionNamespaceBuilder: SessionNamespaceBuilder private let sessionSettledPublisherSubject = PassthroughSubject() var sessionSettledPublisher: AnyPublisher { return sessionSettledPublisherSubject.eraseToAnyPublisher() @@ -30,7 +30,8 @@ actor AuthResponder { walletErrorResponder: WalletErrorResponder, pairingRegisterer: PairingRegisterer, metadata: AppMetadata, - sessionStore: WCSessionStorage + sessionStore: WCSessionStorage, + sessionNamespaceBuilder: SessionNamespaceBuilder ) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -115,7 +116,7 @@ actor AuthResponder { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = try buildSessionNamespaces(cacaos: response.cacaos) + let sessionNamespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) let settleParams = SessionType.SettleParams( relay: relay, @@ -143,72 +144,4 @@ actor AuthResponder { return session.publicRepresentation() } - - private func buildSessionNamespaces(cacaos: [Cacao]) throws -> [String: SessionNamespace] { - - guard let cacao = cacaos.first, - let resources = cacao.p.resources, - let namespacesUrn = resources.last, - let decodedRecap = decodeUrnToJson(urn: namespacesUrn), - let chainsNamespace = try? DIDPKH(did: cacao.p.iss).account.blockchain.namespace else { - throw Errors.cannotCreateSessionNamespaceFromTheRecap - } - - let accounts = cacaos.compactMap{ try? DIDPKH(did: $0.p.iss).account } - - let accountsSet = Set(accounts) - - let methods = getMethods(from: decodedRecap) - - let sessionNamespace = SessionNamespace(accounts: accountsSet, methods: methods, events: []) - return [chainsNamespace: sessionNamespace] - } - - - private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { - // Extract the Base64 encoded JSON part from the URN - let components = urn.components(separatedBy: ":") - guard components.count >= 3, let base64EncodedJson = components.last else { - logger.debug("Invalid URN format") - return nil - } - - // Decode the Base64 encoded JSON - guard let jsonData = Data(base64Encoded: base64EncodedJson) else { - logger.debug("Failed to decode Base64 string") - return nil - } - - // Deserialize the JSON data into the desired dictionary - do { - let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) - return decodedDictionary - } catch { - logger.debug("Error during JSON decoding: \(error.localizedDescription)") - return nil - } - } - - func getMethods(from recap: [String: [String: [String: [String]]]]) -> Set { - var requestMethods: [String] = [] - - // Iterate through the recap dictionary - for (_, resources) in recap { - for (_, requests) in resources { - for (key, _) in requests { - - // Check if the key starts with "request/" - if key.hasPrefix("request/") { - // Extract the method name and add it to the array - let methodName = String(key.dropFirst("request/".count)) - requestMethods.append(methodName) - } - } - } - } - - return Set(requestMethods) - } - } - From eeed7af706aba14dde7f532caaa016843bbb8ca0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 11:13:44 +0100 Subject: [PATCH 100/814] savepoint --- .../Services/App/AuthResponseSubscriber.swift | 1 + .../Auth/Services/Wallet/AuthResponder.swift | 19 +++++++++++++++---- .../Sign/SignClientFactory.swift | 5 +++-- 3 files changed, 19 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 34ac0c332..f35ce8c48 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -151,6 +151,7 @@ class AuthResponseSubscriber { sessionStore.setSession(session) Task { + logger.debug("subscribing to session topic: \(sessionTopic)") try await networkingInteractor.subscribe(topic: sessionTopic) } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 3fcf8bf3c..88d7ff301 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -42,20 +42,30 @@ actor AuthResponder { self.pairingRegisterer = pairingRegisterer self.metadata = metadata self.sessionStore = sessionStore + self.sessionNamespaceBuilder = sessionNamespaceBuilder } func respond(requestId: RPCID, auths: [AuthObject]) async throws { let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) - let (sessionTopic, keys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + let (responseTopic, keys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) - try kms.setAgreementSecret(keys, topic: sessionTopic) + try kms.setAgreementSecret(keys, topic: responseTopic) - let selfParticipant = Participant(publicKey: keys.publicKey.hexRepresentation, metadata: metadata) + let peerParticipant = sessionAuthenticateRequestParams.requester + + let sessionSelfPubKey = try kms.createX25519KeyPair() + let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation + let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) + + let sessionTopic = sessionKeys.derivedTopic() + try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) + + let selfParticipant = Participant(publicKey: sessionSelfPubKeyHex, metadata: metadata) let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: sessionTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) + try await networkingInteractor.respond(topic: responseTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: sessionKeys.publicKey.rawRepresentation)) let session = try createSession( @@ -139,6 +149,7 @@ actor AuthResponder { sessionStore.setSession(session) Task { + logger.debug("subscribing to session topic: \(sessionTopic)") try await networkingInteractor.subscribe(topic: sessionTopic) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 5598ab803..c58006edc 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -94,10 +94,11 @@ public struct SignClientFactory { let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter) + let sessionNameSpaceBuilder = SessionNamespaceBuilder(logger: logger) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore) + let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) From 2e9526ecca18a36f1648923701b12282a266bac2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 11:16:26 +0100 Subject: [PATCH 101/814] fix tests --- .../Auth/Services/Wallet/AuthResponder.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 88d7ff301..421fe271f 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -47,10 +47,10 @@ actor AuthResponder { func respond(requestId: RPCID, auths: [AuthObject]) async throws { let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) - let (responseTopic, keys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + let (responseTopic, responseKeys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) - try kms.setAgreementSecret(keys, topic: responseTopic) + try kms.setAgreementSecret(responseKeys, topic: responseTopic) let peerParticipant = sessionAuthenticateRequestParams.requester @@ -65,7 +65,7 @@ actor AuthResponder { let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: responseTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: sessionKeys.publicKey.rawRepresentation)) + try await networkingInteractor.respond(topic: responseTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) let session = try createSession( From 6aeb97ccc5edd5638ec4c1e3da7f9fbe4902771f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 12:25:16 +0100 Subject: [PATCH 102/814] fix tests builds --- .../SIWE/SIWECacaoFormatter.swift | 12 +- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 76 ++- .../AuthTests/AppRespondSubscriberTests.swift | 150 ++--- Tests/AuthTests/Stubs/AuthRequestParams.swift | 32 +- .../Stubs/RequestSubscriptionPayload.swift | 26 +- .../WalletRequestSubscriberTests.swift | 128 ++-- .../SIWEMessageFormatterTests.swift | 48 +- .../Stub}/AuthPayload.swift | 2 +- .../Stub}/RequestParams.swift | 12 +- .../Stub}/SIWEMessageFormatterMock.swift | 3 +- .../Stub/Session+Stub.swift | 6 + .../RecapFactoryTests.swift | 2 +- .../Mocks/SignClientMock.swift | 17 + Tests/Web3WalletTests/Web3WalletTests.swift | 556 +++++++++--------- 14 files changed, 593 insertions(+), 477 deletions(-) rename Tests/{AuthTests => WalletConnectSignTests}/SIWEMessageFormatterTests.swift (60%) rename Tests/{AuthTests/Stubs => WalletConnectSignTests/Stub}/AuthPayload.swift (92%) rename Tests/{AuthTests/Stubs => WalletConnectSignTests/Stub}/RequestParams.swift (72%) rename Tests/{AuthTests/Mocks => WalletConnectSignTests/Stub}/SIWEMessageFormatterMock.swift (84%) diff --git a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift index aff12dfc5..c4dc9216c 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift @@ -1,14 +1,18 @@ import Foundation public protocol SIWECacaoFormatting { - func formatMessage(from payload: CacaoPayload) throws -> String + func formatMessage(from payload: CacaoPayload, includeRecapInTheStatement: Bool) throws -> String +} +public extension SIWECacaoFormatting { + func formatMessage(from payload: CacaoPayload) throws -> String { + return try formatMessage(from: payload, includeRecapInTheStatement: false) + } } - public struct SIWECacaoFormatter: SIWECacaoFormatting { public init() { } - public func formatMessage(from payload: CacaoPayload) throws -> String { + public func formatMessage(from payload: CacaoPayload, includeRecapInTheStatement: Bool) throws -> String { let iss = try DIDPKH(did: payload.iss) let message = SIWEMessage( domain: payload.domain, @@ -24,7 +28,7 @@ public struct SIWECacaoFormatter: SIWECacaoFormatting { requestId: payload.requestId, resources: payload.resources ) - return message.formatted + return message.formatted(includeRecapInTheStatement: includeRecapInTheStatement) } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 8e4a14313..a726271be 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -29,19 +29,73 @@ public struct SIWEMessage: Equatable { self.resources = resources } - public var formatted: String { + public func formatted(includeRecapInTheStatement: Bool = false) -> String { + var finalStatement = statement ?? "" + + if includeRecapInTheStatement, let resources = resources { + for resource in resources { + if let decodedRecap = decodeUrnToJson(urn: resource) { + finalStatement += buildRecapStatement(from: decodedRecap) + } + } + } + return """ - \(domain) wants you to sign in with your Ethereum account: - \(address) - \(statementLine) - - URI: \(uri) - Version: \(version) - Chain ID: \(chainId) - Nonce: \(nonce) - Issued At: \(iat)\(expLine)\(nbfLine)\(requestIdLine)\(resourcesSection) - """ + \(domain) wants you to sign in with your Ethereum account: + \(address) + \(finalStatement) + + URI: \(uri) + Version: \(version) + Chain ID: \(chainId) + Nonce: \(nonce) + Issued At: \(iat)\(expLine)\(nbfLine)\(requestIdLine)\(resourcesSection) + """ } + + + + private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { + // Check if the URN is in the correct format + guard urn.starts(with: "urn:recap:") else { return nil } + + // Extract the Base64 encoded JSON part from the URN + let base64EncodedJson = urn.replacingOccurrences(of: "urn:recap:", with: "") + + // Decode the Base64 encoded JSON + guard let jsonData = Data(base64Encoded: base64EncodedJson) else { return nil } + + // Deserialize the JSON data into the desired dictionary + do { + let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) + return decodedDictionary + } catch { + return nil + } + } + + private func buildRecapStatement(from decodedRecap: [String: [String: [String: [String]]]]) -> String { + var statementParts: [String] = [] + + for (resourceKey, actions) in decodedRecap { + var actionParts: [String] = [] + for (actionType, _) in actions { + actionParts.append("'\(actionType)'") + } + let actionsString = actionParts.joined(separator: ", ") + if !actionsString.isEmpty { + statementParts.append("\(actionsString) for '\(resourceKey)'") + } + } + + if !statementParts.isEmpty { + return " I further authorize the stated URI to perform the following actions: \(statementParts.joined(separator: "; "))." + } else { + return "" + } + } + + } private extension SIWEMessage { diff --git a/Tests/AuthTests/AppRespondSubscriberTests.swift b/Tests/AuthTests/AppRespondSubscriberTests.swift index 5e54bf464..26d7ac29f 100644 --- a/Tests/AuthTests/AppRespondSubscriberTests.swift +++ b/Tests/AuthTests/AppRespondSubscriberTests.swift @@ -1,75 +1,75 @@ -import Foundation -import XCTest -@testable import Auth -@testable import WalletConnectUtils -@testable import WalletConnectNetworking -@testable import WalletConnectKMS -@testable import TestingUtils -import JSONRPC - -class AppRespondSubscriberTests: XCTestCase { - - var networkingInteractor: NetworkingInteractorMock! - var sut: AppRespondSubscriber! - var messageFormatter: SIWECacaoFormatter! - var rpcHistory: RPCHistory! - let defaultTimeout: TimeInterval = 0.01 - var messageVerifier: MessageVerifier! - var pairingStorage: WCPairingStorageMock! - var pairingRegisterer: PairingRegistererMock! - - override func setUp() { - networkingInteractor = NetworkingInteractorMock() - messageFormatter = SIWECacaoFormatter() - messageVerifier = .stub() - rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: RuntimeKeyValueStorage()) - pairingStorage = WCPairingStorageMock() - pairingRegisterer = PairingRegistererMock() - sut = AppRespondSubscriber( - networkingInteractor: networkingInteractor, - logger: ConsoleLoggerMock(), - rpcHistory: rpcHistory, - signatureVerifier: messageVerifier, - pairingRegisterer: pairingRegisterer, - messageFormatter: messageFormatter) - } - - func testMessageCompromisedFailure() { - let messageExpectation = expectation(description: "receives response") - - // set history record for a request - let topic = "topic" - let requestId: RPCID = RPCID(1234) - - let params = AuthRequestParams.stub() - let compromissedParams = AuthRequestParams.stub(nonce: "Compromissed nonce") - - XCTAssertNotEqual(params.payloadParams, compromissedParams.payloadParams) - - let request = RPCRequest(method: "wc_authRequest", params: AuthRequestParams.stub(), id: requestId.right!) - try! rpcHistory.set(request, forTopic: topic, emmitedBy: .local) - - var messageId: RPCID! - var result: Result! - sut.onResponse = { id, r in - messageId = id - result = r - messageExpectation.fulfill() - } - - // subscribe on compromised cacao - let cacaoHeader = CacaoHeader(t: "caip122") - let cacaoPayload = try! compromissedParams.payloadParams.cacaoPayload(address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf") - let cacaoSignature = CacaoSignature(t: .eip191, s: "") - - let cacao = Cacao(h: cacaoHeader, p: cacaoPayload, s: cacaoSignature) - - let response = RPCResponse(id: requestId, result: cacao) - networkingInteractor.responsePublisherSubject.send((topic, request, response, Date(), nil)) - - wait(for: [messageExpectation], timeout: defaultTimeout) - XCTAssertTrue(pairingRegisterer.isActivateCalled) - XCTAssertEqual(result, .failure(AuthError.messageCompromised)) - XCTAssertEqual(messageId, requestId) - } -} +//import Foundation +//import XCTest +//@testable import Auth +//@testable import WalletConnectUtils +//@testable import WalletConnectNetworking +//@testable import WalletConnectKMS +//@testable import TestingUtils +//import JSONRPC +// +//class AppRespondSubscriberTests: XCTestCase { +// +// var networkingInteractor: NetworkingInteractorMock! +// var sut: AppRespondSubscriber! +// var messageFormatter: SIWECacaoFormatter! +// var rpcHistory: RPCHistory! +// let defaultTimeout: TimeInterval = 0.01 +// var messageVerifier: MessageVerifier! +// var pairingStorage: WCPairingStorageMock! +// var pairingRegisterer: PairingRegistererMock! +// +// override func setUp() { +// networkingInteractor = NetworkingInteractorMock() +// messageFormatter = SIWECacaoFormatter() +// messageVerifier = .stub() +// rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: RuntimeKeyValueStorage()) +// pairingStorage = WCPairingStorageMock() +// pairingRegisterer = PairingRegistererMock() +// sut = AppRespondSubscriber( +// networkingInteractor: networkingInteractor, +// logger: ConsoleLoggerMock(), +// rpcHistory: rpcHistory, +// signatureVerifier: messageVerifier, +// pairingRegisterer: pairingRegisterer, +// messageFormatter: messageFormatter) +// } +// +// func testMessageCompromisedFailure() { +// let messageExpectation = expectation(description: "receives response") +// +// // set history record for a request +// let topic = "topic" +// let requestId: RPCID = RPCID(1234) +// +// let params = AuthRequestParams.stub() +// let compromissedParams = AuthRequestParams.stub(nonce: "Compromissed nonce") +// +// XCTAssertNotEqual(params.payloadParams, compromissedParams.payloadParams) +// +// let request = RPCRequest(method: "wc_authRequest", params: AuthRequestParams.stub(), id: requestId.right!) +// try! rpcHistory.set(request, forTopic: topic, emmitedBy: .local) +// +// var messageId: RPCID! +// var result: Result! +// sut.onResponse = { id, r in +// messageId = id +// result = r +// messageExpectation.fulfill() +// } +// +// // subscribe on compromised cacao +// let cacaoHeader = CacaoHeader(t: "caip122") +// let cacaoPayload = try! compromissedParams.payloadParams.cacaoPayload(address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf") +// let cacaoSignature = CacaoSignature(t: .eip191, s: "") +// +// let cacao = Cacao(h: cacaoHeader, p: cacaoPayload, s: cacaoSignature) +// +// let response = RPCResponse(id: requestId, result: cacao) +// networkingInteractor.responsePublisherSubject.send((topic, request, response, Date(), nil)) +// +// wait(for: [messageExpectation], timeout: defaultTimeout) +// XCTAssertTrue(pairingRegisterer.isActivateCalled) +// XCTAssertEqual(result, .failure(AuthError.messageCompromised)) +// XCTAssertEqual(messageId, requestId) +// } +//} diff --git a/Tests/AuthTests/Stubs/AuthRequestParams.swift b/Tests/AuthTests/Stubs/AuthRequestParams.swift index e68e1b50e..2e8e30821 100644 --- a/Tests/AuthTests/Stubs/AuthRequestParams.swift +++ b/Tests/AuthTests/Stubs/AuthRequestParams.swift @@ -1,16 +1,16 @@ -@testable import Auth -import Foundation -import WalletConnectPairing - -extension AuthRequestParams { - static func stub(nonce: String = "32891756") -> AuthRequestParams { - let payload = AuthPayload.stub(nonce: nonce) - return AuthRequestParams(requester: Requester.stub(), payloadParams: payload) - } -} - -extension AuthRequestParams.Requester { - static func stub() -> AuthRequestParams.Requester { - AuthRequestParams.Requester(publicKey: "", metadata: AppMetadata.stub()) - } -} +//@testable import Auth +//import Foundation +//import WalletConnectPairing +// +//extension AuthRequestParams { +// static func stub(nonce: String = "32891756") -> AuthRequestParams { +// let payload = AuthPayload.stub(nonce: nonce) +// return AuthRequestParams(requester: Requester.stub(), payloadParams: payload) +// } +//} +// +//extension AuthRequestParams.Requester { +// static func stub() -> AuthRequestParams.Requester { +// AuthRequestParams.Requester(publicKey: "", metadata: AppMetadata.stub()) +// } +//} diff --git a/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift b/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift index af2d8dd89..db86a0a4e 100644 --- a/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift +++ b/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift @@ -1,13 +1,13 @@ -import Foundation -import JSONRPC -import WalletConnectNetworking -@testable import Auth - -extension AuthRequestParams { - static func stub(id: RPCID, iat: String) -> AuthRequestParams { - let appMetadata = AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) - let requester = AuthRequestParams.Requester(publicKey: "", metadata: appMetadata) - let payload = AuthPayload(requestParams: RequestParams.stub(), iat: iat) - return AuthRequestParams(requester: requester, payloadParams: payload) - } -} +//import Foundation +//import JSONRPC +//import WalletConnectNetworking +//@testable import Auth +// +//extension AuthRequestParams { +// static func stub(id: RPCID, iat: String) -> AuthRequestParams { +// let appMetadata = AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) +// let requester = AuthRequestParams.Requester(publicKey: "", metadata: appMetadata) +// let payload = AuthPayload(requestParams: RequestParams.stub(), iat: iat) +// return AuthRequestParams(requester: requester, payloadParams: payload) +// } +//} diff --git a/Tests/AuthTests/WalletRequestSubscriberTests.swift b/Tests/AuthTests/WalletRequestSubscriberTests.swift index 1fba88977..50b38e863 100644 --- a/Tests/AuthTests/WalletRequestSubscriberTests.swift +++ b/Tests/AuthTests/WalletRequestSubscriberTests.swift @@ -1,64 +1,64 @@ -import Foundation -import XCTest -import JSONRPC -@testable import WalletConnectUtils -@testable import WalletConnectNetworking -@testable import Auth -@testable import WalletConnectKMS -@testable import TestingUtils - -class WalletRequestSubscriberTests: XCTestCase { - var pairingRegisterer: PairingRegistererMock! - var sut: WalletRequestSubscriber! - var messageFormatter: SIWEMessageFormatterMock! - var verifyContextStore: CodableStore! - - let defaultTimeout: TimeInterval = 0.01 - - override func setUp() { - let networkingInteractor = NetworkingInteractorMock() - pairingRegisterer = PairingRegistererMock() - messageFormatter = SIWEMessageFormatterMock() - verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") - - let walletErrorResponder = WalletErrorResponder( - networkingInteractor: networkingInteractor, - logger: ConsoleLoggerMock(), - kms: KeyManagementServiceMock(), - rpcHistory: RPCHistory(keyValueStore: CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "")) - ) - sut = WalletRequestSubscriber( - networkingInteractor: networkingInteractor, - logger: ConsoleLoggerMock(), - kms: KeyManagementServiceMock(), - walletErrorResponder: walletErrorResponder, - pairingRegisterer: pairingRegisterer, - verifyClient: VerifyClientMock(), - verifyContextStore: verifyContextStore - ) - } - - func testSubscribeRequest() { - let iat = ISO8601DateFormatter().string(from: Date()) - let expectedPayload = AuthPayload(requestParams: .stub(), iat: iat) - let expectedRequestId: RPCID = RPCID(1234) - let messageExpectation = expectation(description: "receives formatted message") - - var requestId: RPCID! - var requestPayload: AuthPayload! - sut.onRequest = { result in - requestId = result.request.id - requestPayload = result.request.payload - messageExpectation.fulfill() - } - - let payload = RequestSubscriptionPayload(id: expectedRequestId, topic: "123", request: AuthRequestParams.stub(id: expectedRequestId, iat: iat), decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) - - pairingRegisterer.subject.send(payload) - - wait(for: [messageExpectation], timeout: defaultTimeout) - XCTAssertTrue(pairingRegisterer.isReceivedCalled) - XCTAssertEqual(requestPayload, expectedPayload) - XCTAssertEqual(requestId, expectedRequestId) - } -} +//import Foundation +//import XCTest +//import JSONRPC +//@testable import WalletConnectUtils +//@testable import WalletConnectNetworking +//@testable import Auth +//@testable import WalletConnectKMS +//@testable import TestingUtils +// +//class WalletRequestSubscriberTests: XCTestCase { +// var pairingRegisterer: PairingRegistererMock! +// var sut: WalletRequestSubscriber! +// var messageFormatter: SIWEMessageFormatterMock! +// var verifyContextStore: CodableStore! +// +// let defaultTimeout: TimeInterval = 0.01 +// +// override func setUp() { +// let networkingInteractor = NetworkingInteractorMock() +// pairingRegisterer = PairingRegistererMock() +// messageFormatter = SIWEMessageFormatterMock() +// verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") +// +// let walletErrorResponder = WalletErrorResponder( +// networkingInteractor: networkingInteractor, +// logger: ConsoleLoggerMock(), +// kms: KeyManagementServiceMock(), +// rpcHistory: RPCHistory(keyValueStore: CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "")) +// ) +// sut = WalletRequestSubscriber( +// networkingInteractor: networkingInteractor, +// logger: ConsoleLoggerMock(), +// kms: KeyManagementServiceMock(), +// walletErrorResponder: walletErrorResponder, +// pairingRegisterer: pairingRegisterer, +// verifyClient: VerifyClientMock(), +// verifyContextStore: verifyContextStore +// ) +// } +// +// func testSubscribeRequest() { +// let iat = ISO8601DateFormatter().string(from: Date()) +// let expectedPayload = AuthPayload(requestParams: .stub(), iat: iat) +// let expectedRequestId: RPCID = RPCID(1234) +// let messageExpectation = expectation(description: "receives formatted message") +// +// var requestId: RPCID! +// var requestPayload: AuthPayload! +// sut.onRequest = { result in +// requestId = result.request.id +// requestPayload = result.request.payload +// messageExpectation.fulfill() +// } +// +// let payload = RequestSubscriptionPayload(id: expectedRequestId, topic: "123", request: AuthRequestParams.stub(id: expectedRequestId, iat: iat), decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) +// +// pairingRegisterer.subject.send(payload) +// +// wait(for: [messageExpectation], timeout: defaultTimeout) +// XCTAssertTrue(pairingRegisterer.isReceivedCalled) +// XCTAssertEqual(requestPayload, expectedPayload) +// XCTAssertEqual(requestId, expectedRequestId) +// } +//} diff --git a/Tests/AuthTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift similarity index 60% rename from Tests/AuthTests/SIWEMessageFormatterTests.swift rename to Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 23568ff61..2a2a63469 100644 --- a/Tests/AuthTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -1,5 +1,6 @@ import Foundation -@testable import Auth +@testable import WalletConnectUtils +@testable import WalletConnectSign import XCTest class SIWEMessageFormatterTests: XCTestCase { @@ -27,7 +28,7 @@ class SIWEMessageFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let message = try sut.formatMessages(from: AuthPayload.stub().cacaoPayload(address: address)) + let message = try sut.formatMessage(from: AuthPayload.stub().cacaoPayload(account: Account.stub())) XCTAssertEqual(message, expectedMessage) } @@ -47,10 +48,10 @@ class SIWEMessageFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let message = try sut.formatMessages( + let message = try sut.formatMessage( from: AuthPayload.stub( requestParams: RequestParams.stub(statement: nil) - ).cacaoPayload(address: address) + ).cacaoPayload(account: Account.stub()) ) XCTAssertEqual(message, expectedMessage) } @@ -69,9 +70,9 @@ class SIWEMessageFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let message = try sut.formatMessages( + let message = try sut.formatMessage( from: AuthPayload.stub( - requestParams: RequestParams.stub(resources: nil)).cacaoPayload(address: address) + requestParams: RequestParams.stub(resources: nil)).cacaoPayload(account: Account.stub()) ) XCTAssertEqual(message, expectedMessage) } @@ -89,10 +90,41 @@ class SIWEMessageFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let message = try sut.formatMessages( + let message = try sut.formatMessage( from: AuthPayload.stub( - requestParams: RequestParams.stub(statement: nil, resources: nil)).cacaoPayload(address: address) + requestParams: RequestParams.stub(statement: nil, resources: nil)).cacaoPayload(account: Account.stub()) ) XCTAssertEqual(message, expectedMessage) } + + func testWithValidRecap() throws { + let validRecapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ==" + let expectedStatementPart = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." + + let expectedMessage = + """ + service.invalid wants you to sign in with your Ethereum account: + 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 + I accept the ServiceOrg Terms of Service: https://service.invalid/tos + I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. + + URI: https://service.invalid/login + Version: 1 + Chain ID: 1 + Nonce: 32891756 + Issued At: 2021-09-30T16:25:24Z + Resources: + - urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ== + """ + + + + let payload = try AuthPayload.stub( + requestParams: RequestParams.stub(resources: [validRecapUrn]) + ).cacaoPayload(account: Account.stub()) + + let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) + XCTAssertEqual(message, expectedMessage) + } + } diff --git a/Tests/AuthTests/Stubs/AuthPayload.swift b/Tests/WalletConnectSignTests/Stub/AuthPayload.swift similarity index 92% rename from Tests/AuthTests/Stubs/AuthPayload.swift rename to Tests/WalletConnectSignTests/Stub/AuthPayload.swift index 84d659e9a..4517eefbf 100644 --- a/Tests/AuthTests/Stubs/AuthPayload.swift +++ b/Tests/WalletConnectSignTests/Stub/AuthPayload.swift @@ -1,5 +1,5 @@ import Foundation -@testable import Auth +@testable import WalletConnectSign extension AuthPayload { static func stub(requestParams: RequestParams = RequestParams.stub()) -> AuthPayload { diff --git a/Tests/AuthTests/Stubs/RequestParams.swift b/Tests/WalletConnectSignTests/Stub/RequestParams.swift similarity index 72% rename from Tests/AuthTests/Stubs/RequestParams.swift rename to Tests/WalletConnectSignTests/Stub/RequestParams.swift index 5c1a30db4..89efc65c2 100644 --- a/Tests/AuthTests/Stubs/RequestParams.swift +++ b/Tests/WalletConnectSignTests/Stub/RequestParams.swift @@ -1,24 +1,26 @@ import Foundation -@testable import Auth +@testable import WalletConnectSign extension RequestParams { static func stub(domain: String = "service.invalid", - chainId: String = "eip155:1", + chains: [String] = ["eip155:1"], nonce: String = "32891756", aud: String = "https://service.invalid/login", nbf: String? = nil, exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"]) -> RequestParams { + resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], + methods: [String]? = ["personal_sign"]) -> RequestParams { return RequestParams(domain: domain, - chainId: chainId, + chains: chains, nonce: nonce, aud: aud, nbf: nbf, exp: exp, statement: statement, requestId: requestId, - resources: resources) + resources: resources, + methods: methods) } } diff --git a/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift similarity index 84% rename from Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift rename to Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift index c88c62ec3..e7d6193c0 100644 --- a/Tests/AuthTests/Mocks/SIWEMessageFormatterMock.swift +++ b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift @@ -2,9 +2,10 @@ import Foundation @testable import Auth class SIWEMessageFormatterMock: SIWECacaoFormatting { - func formatMessage(from payload: WalletConnectUtils.CacaoPayload) throws -> String { + func formatMessage(from payload: WalletConnectUtils.CacaoPayload, includeRecapInTheStatement: Bool) throws -> String { fatalError() } + var formattedMessage: String! diff --git a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift index 37fcfdef9..610bb7572 100644 --- a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift +++ b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift @@ -41,6 +41,12 @@ extension Account { } } +extension Account { + static func stub() -> Account { + return Account("eip155:1:0x5F847B18b4a2Dd0F428796E89CaEe71480a2a98e")! + } +} + extension SessionType.SettleParams { static func stub() -> SessionType.SettleParams { return SessionType.SettleParams( diff --git a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift index bd2ee0e37..f0efedd64 100644 --- a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift @@ -6,7 +6,7 @@ class RecapFactoryTests: XCTestCase { func testCreateRecap() { // Define the input values let resource = "eip155:1" - let actions: Set = ["request/eth_sendTransaction", "request/personal_sign"] + let actions = ["request/eth_sendTransaction", "request/personal_sign"] // Call the function let recap = RecapFactory.createRecap(resource: resource, actions: actions) diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index ea7f455ce..432d3e363 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -4,6 +4,23 @@ import Combine @testable import WalletConnectSign final class SignClientMock: SignClientProtocol { + var authRequestPublisher: AnyPublisher<(request: WalletConnectSign.AuthenticationRequest, context: WalletConnectSign.VerifyContext?), Never> { + fatalError() + } + + + func approveSessionAuthenticate(requestId: JSONRPC.RPCID, auths: [WalletConnectSign.AuthObject]) async throws { + fatalError() + } + + func makeAuthObject(authRequest: WalletConnectSign.AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> WalletConnectSign.AuthObject { + fatalError() + } + + func formatAuthMessage(payload: WalletConnectSign.AuthPayload, account: WalletConnectUtils.Account) throws -> String { + fatalError() + } + private var logsSubject = PassthroughSubject() var logsPublisher: AnyPublisher { diff --git a/Tests/Web3WalletTests/Web3WalletTests.swift b/Tests/Web3WalletTests/Web3WalletTests.swift index 8a24a5cfc..95acbd336 100644 --- a/Tests/Web3WalletTests/Web3WalletTests.swift +++ b/Tests/Web3WalletTests/Web3WalletTests.swift @@ -1,278 +1,278 @@ -import XCTest -import Combine - -@testable import Auth -@testable import Web3Wallet -@testable import WalletConnectPush - -final class Web3WalletTests: XCTestCase { - var web3WalletClient: Web3WalletClient! - var authClient: AuthClientMock! - var signClient: SignClientMock! - var pairingClient: PairingClientMock! - var pushClient: PushClientMock! - - private var disposeBag = Set() - - override func setUp() { - authClient = AuthClientMock() - signClient = SignClientMock() - pairingClient = PairingClientMock() - pushClient = PushClientMock() - - web3WalletClient = Web3WalletClientFactory.create( - authClient: authClient, - signClient: signClient, - pairingClient: pairingClient, - pushClient: pushClient - ) - } - - func testSessionRequestCalled() { - var success = false - web3WalletClient.sessionRequestPublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testAuthRequestCalled() { - var success = false - web3WalletClient.authRequestPublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testSessionProposalCalled() { - var success = false - web3WalletClient.sessionProposalPublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testSessionsCalled() { - var success = false - web3WalletClient.sessionsPublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testSocketConnectionStatusCalled() { - var success = false - web3WalletClient.socketConnectionStatusPublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testSessionSettleCalled() { - var success = false - web3WalletClient.sessionSettlePublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testSessionDeleteCalled() { - var success = false - web3WalletClient.sessionDeletePublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testSessionResponseCalled() { - var success = false - web3WalletClient.sessionResponsePublisher.sink { value in - success = true - XCTAssertTrue(true) - } - .store(in: &disposeBag) - - let expectation = expectation(description: "Fail after 0.1s timeout") - let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) - if result == XCTWaiter.Result.timedOut && success == false { - XCTFail() - } - } - - func testApproveCalled() async { - try! await web3WalletClient.approve(proposalId: "", namespaces: [:]) - XCTAssertTrue(signClient.approveCalled) - } - - func testRejectSessionCalled() async { - try! await web3WalletClient.rejectSession(proposalId: "", reason: .userRejected) - XCTAssertTrue(signClient.rejectCalled) - } - - func testRejectAuthRequestCalled() async { - try! await web3WalletClient.reject(requestId: .left("")) - XCTAssertTrue(authClient.rejectCalled) - } - - func testUpdateCalled() async { - try! await web3WalletClient.update(topic: "", namespaces: [:]) - XCTAssertTrue(signClient.updateCalled) - } - - func testExtendCalled() async { - try! await web3WalletClient.extend(topic: "") - XCTAssertTrue(signClient.extendCalled) - } - - func testSignRespondCalled() async { - try! await web3WalletClient.respond( - topic: "", - requestId: .left(""), - response: RPCResult.response(AnyCodable(true)) - ) - XCTAssertTrue(signClient.respondCalled) - } - - func testPairCalled() async { - try! await web3WalletClient.pair(uri: WalletConnectURI( - topic: "topic", - symKey: "symKey", - relay: RelayProtocolOptions(protocol: "", data: "") - )) - XCTAssertTrue(pairingClient.pairCalled) - } - - func testDisconnectPairingCalled() async { - try! await web3WalletClient.disconnectPairing(topic: "topic") - XCTAssertTrue(pairingClient.disconnectPairingCalled) - } - - func testDisconnectCalled() async { - try! await web3WalletClient.disconnect(topic: "") - XCTAssertTrue(signClient.disconnectCalled) - } - - func testGetSessionsCalledAndNotEmpty() { - let sessions = web3WalletClient.getSessions() - XCTAssertEqual(1, sessions.count) - } - - func testFormatMessageCalled() { - let authPayload = AuthPayload( - requestParams: RequestParams( - domain: "service.invalid", - chainId: "eip155:1", - nonce: "32891756", - aud: "https://service.invalid/login", - nbf: nil, - exp: nil, - statement: "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", - requestId: nil, - resources: [ - "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", - "https://example.com/my-web2-claim.json" - ] - ), - iat: "2021-09-30T16:25:24Z" - ) - - let formattedMessage = try! web3WalletClient.formatMessage( - payload: authPayload, - address: "" - ) - XCTAssertEqual("formatted_message", formattedMessage) - } - - func testAuthRespondCalled() async { - let signature = CacaoSignature(t: .eip191, s: "0x438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b") - let account = Account("eip155:56:0xe5EeF1368781911d265fDB6946613dA61915a501")! - - try! await web3WalletClient.respond( - requestId: .left(""), - signature: signature, - from: account - ) - XCTAssertTrue(authClient.respondCalled) - } - - func testSignPendingRequestsCalledAndNotEmpty() async { - let pendingRequests = web3WalletClient.getPendingRequests(topic: "") - XCTAssertEqual(1, pendingRequests.count) - } - - func testSessionRequestRecordCalledAndNotNil() async { - let sessionRequestRecord = web3WalletClient.getSessionRequestRecord(id: .left("")) - XCTAssertNotNil(sessionRequestRecord) - } - - func testAuthPendingRequestsCalledAndNotEmpty() async { - let pendingRequests = try! web3WalletClient.getPendingRequests() - XCTAssertEqual(1, pendingRequests.count) - } - - func testCleanupCalled() async { - try! await web3WalletClient.cleanup() - XCTAssertTrue(signClient.cleanupCalled) - } - - func testGetPairingsNotEmpty() async { - XCTAssertEqual(1, web3WalletClient.getPairings().count) - } - - func testPushClientRegisterCalled() async { - try! await pushClient.register(deviceToken: Data()) - XCTAssertTrue(pushClient.registedCalled) - pushClient.registedCalled = false - try! await pushClient.register(deviceToken: "") - XCTAssertTrue(pushClient.registedCalled) - } -} +//import XCTest +//import Combine +// +//@testable import Auth +//@testable import Web3Wallet +//@testable import WalletConnectPush +// +//final class Web3WalletTests: XCTestCase { +// var web3WalletClient: Web3WalletClient! +// var authClient: AuthClientMock! +// var signClient: SignClientMock! +// var pairingClient: PairingClientMock! +// var pushClient: PushClientMock! +// +// private var disposeBag = Set() +// +// override func setUp() { +// authClient = AuthClientMock() +// signClient = SignClientMock() +// pairingClient = PairingClientMock() +// pushClient = PushClientMock() +// +// web3WalletClient = Web3WalletClientFactory.create( +// authClient: authClient, +// signClient: signClient, +// pairingClient: pairingClient, +// pushClient: pushClient +// ) +// } +// +// func testSessionRequestCalled() { +// var success = false +// web3WalletClient.sessionRequestPublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testAuthRequestCalled() { +// var success = false +// web3WalletClient.authRequestPublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testSessionProposalCalled() { +// var success = false +// web3WalletClient.sessionProposalPublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testSessionsCalled() { +// var success = false +// web3WalletClient.sessionsPublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testSocketConnectionStatusCalled() { +// var success = false +// web3WalletClient.socketConnectionStatusPublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testSessionSettleCalled() { +// var success = false +// web3WalletClient.sessionSettlePublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testSessionDeleteCalled() { +// var success = false +// web3WalletClient.sessionDeletePublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testSessionResponseCalled() { +// var success = false +// web3WalletClient.sessionResponsePublisher.sink { value in +// success = true +// XCTAssertTrue(true) +// } +// .store(in: &disposeBag) +// +// let expectation = expectation(description: "Fail after 0.1s timeout") +// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) +// if result == XCTWaiter.Result.timedOut && success == false { +// XCTFail() +// } +// } +// +// func testApproveCalled() async { +// try! await web3WalletClient.approve(proposalId: "", namespaces: [:]) +// XCTAssertTrue(signClient.approveCalled) +// } +// +// func testRejectSessionCalled() async { +// try! await web3WalletClient.rejectSession(proposalId: "", reason: .userRejected) +// XCTAssertTrue(signClient.rejectCalled) +// } +// +// func testRejectAuthRequestCalled() async { +// try! await web3WalletClient.rejectSession(requestId: .left("")) +// XCTAssertTrue(authClient.rejectCalled) +// } +// +// func testUpdateCalled() async { +// try! await web3WalletClient.update(topic: "", namespaces: [:]) +// XCTAssertTrue(signClient.updateCalled) +// } +// +// func testExtendCalled() async { +// try! await web3WalletClient.extend(topic: "") +// XCTAssertTrue(signClient.extendCalled) +// } +// +// func testSignRespondCalled() async { +// try! await web3WalletClient.respond( +// topic: "", +// requestId: .left(""), +// response: RPCResult.response(AnyCodable(true)) +// ) +// XCTAssertTrue(signClient.respondCalled) +// } +// +// func testPairCalled() async { +// try! await web3WalletClient.pair(uri: WalletConnectURI( +// topic: "topic", +// symKey: "symKey", +// relay: RelayProtocolOptions(protocol: "", data: "") +// )) +// XCTAssertTrue(pairingClient.pairCalled) +// } +// +// func testDisconnectPairingCalled() async { +// try! await web3WalletClient.disconnectPairing(topic: "topic") +// XCTAssertTrue(pairingClient.disconnectPairingCalled) +// } +// +// func testDisconnectCalled() async { +// try! await web3WalletClient.disconnect(topic: "") +// XCTAssertTrue(signClient.disconnectCalled) +// } +// +// func testGetSessionsCalledAndNotEmpty() { +// let sessions = web3WalletClient.getSessions() +// XCTAssertEqual(1, sessions.count) +// } +// +// func testFormatMessageCalled() { +// let authPayload = AuthPayload( +// requestParams: RequestParams( +// domain: "service.invalid", +// chainId: "eip155:1", +// nonce: "32891756", +// aud: "https://service.invalid/login", +// nbf: nil, +// exp: nil, +// statement: "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", +// requestId: nil, +// resources: [ +// "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", +// "https://example.com/my-web2-claim.json" +// ] +// ), +// iat: "2021-09-30T16:25:24Z" +// ) +// +// let formattedMessage = try! web3WalletClient.formatAuthMessage( +// payload: authPayload, +// address: "" +// ) +// XCTAssertEqual("formatted_message", formattedMessage) +// } +// +// func testAuthRespondCalled() async { +// let signature = CacaoSignature(t: .eip191, s: "0x438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b") +// let account = Account("eip155:56:0xe5EeF1368781911d265fDB6946613dA61915a501")! +// +// try! await web3WalletClient.respond( +// requestId: .left(""), +// signature: signature, +// from: account +// ) +// XCTAssertTrue(authClient.respondCalled) +// } +// +// func testSignPendingRequestsCalledAndNotEmpty() async { +// let pendingRequests = web3WalletClient.getPendingRequests(topic: "") +// XCTAssertEqual(1, pendingRequests.count) +// } +// +// func testSessionRequestRecordCalledAndNotNil() async { +// let sessionRequestRecord = web3WalletClient.getSessionRequestRecord(id: .left("")) +// XCTAssertNotNil(sessionRequestRecord) +// } +// +// func testAuthPendingRequestsCalledAndNotEmpty() async { +// let pendingRequests = try! web3WalletClient.getPendingRequests() +// XCTAssertEqual(1, pendingRequests.count) +// } +// +// func testCleanupCalled() async { +// try! await web3WalletClient.cleanup() +// XCTAssertTrue(signClient.cleanupCalled) +// } +// +// func testGetPairingsNotEmpty() async { +// XCTAssertEqual(1, web3WalletClient.getPairings().count) +// } +// +// func testPushClientRegisterCalled() async { +// try! await pushClient.register(deviceToken: Data()) +// XCTAssertTrue(pushClient.registedCalled) +// pushClient.registedCalled = false +// try! await pushClient.register(deviceToken: "") +// XCTAssertTrue(pushClient.registedCalled) +// } +//} From 08ab37c862a9eca88849039cb3f8e6d86f831128 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 16:15:59 +0100 Subject: [PATCH 103/814] savepoint --- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 34 +++++++++++-------- .../Stub/Session+Stub.swift | 2 +- 2 files changed, 20 insertions(+), 16 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index a726271be..f55199102 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -30,15 +30,14 @@ public struct SIWEMessage: Equatable { } public func formatted(includeRecapInTheStatement: Bool = false) -> String { - var finalStatement = statement ?? "" + var finalStatement = statementLine - if includeRecapInTheStatement, let resources = resources { - for resource in resources { - if let decodedRecap = decodeUrnToJson(urn: resource) { - finalStatement += buildRecapStatement(from: decodedRecap) - } + if includeRecapInTheStatement, + let resource = resources?.last, + let decodedRecap = decodeUrnToJson(urn: resource), + let attValue = decodedRecap["att"] { + finalStatement += buildRecapStatement(from: attValue) } - } return """ \(domain) wants you to sign in with your Ethereum account: @@ -74,28 +73,33 @@ public struct SIWEMessage: Equatable { } } - private func buildRecapStatement(from decodedRecap: [String: [String: [String: [String]]]]) -> String { + private func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { var statementParts: [String] = [] for (resourceKey, actions) in decodedRecap { - var actionParts: [String] = [] - for (actionType, _) in actions { - actionParts.append("'\(actionType)'") + var requestActions: [String] = [] + + for (actionType, _) in actions where actionType.starts(with: "request/") { + let action = actionType.replacingOccurrences(of: "request/", with: "") + requestActions.append("'\(action)'") } - let actionsString = actionParts.joined(separator: ", ") - if !actionsString.isEmpty { - statementParts.append("\(actionsString) for '\(resourceKey)'") + + if !requestActions.isEmpty { + let actionsString = requestActions.joined(separator: ", ") + statementParts.append("'\(actionsString)' for '\(resourceKey)'") } } if !statementParts.isEmpty { - return " I further authorize the stated URI to perform the following actions: \(statementParts.joined(separator: "; "))." + let formattedStatement = statementParts.joined(separator: "; ") + return "I further authorize the stated URI to perform the following actions: (1) \(formattedStatement)." } else { return "" } } + } private extension SIWEMessage { diff --git a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift index 610bb7572..41bfa70f7 100644 --- a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift +++ b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift @@ -43,7 +43,7 @@ extension Account { extension Account { static func stub() -> Account { - return Account("eip155:1:0x5F847B18b4a2Dd0F428796E89CaEe71480a2a98e")! + return Account("eip155:1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2")! } } From 5f948480a3248db8a90f30a057fbe6bfd0ebbc27 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 14 Dec 2023 16:59:43 +0100 Subject: [PATCH 104/814] savepoint --- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 33 +++++++++-------- .../SIWEMessageFormatterTests.swift | 35 ++++++++++++++++--- 2 files changed, 49 insertions(+), 19 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index f55199102..3d84684f2 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -30,19 +30,11 @@ public struct SIWEMessage: Equatable { } public func formatted(includeRecapInTheStatement: Bool = false) -> String { - var finalStatement = statementLine - - if includeRecapInTheStatement, - let resource = resources?.last, - let decodedRecap = decodeUrnToJson(urn: resource), - let attValue = decodedRecap["att"] { - finalStatement += buildRecapStatement(from: attValue) - } return """ \(domain) wants you to sign in with your Ethereum account: \(address) - \(finalStatement) + \(getStatementLine(includeRecapInTheStatement: includeRecapInTheStatement)) URI: \(uri) Version: \(version) @@ -52,6 +44,22 @@ public struct SIWEMessage: Equatable { """ } + private func getStatementLine(includeRecapInTheStatement: Bool) -> String { + if includeRecapInTheStatement, + let resource = resources?.last, + let decodedRecap = decodeUrnToJson(urn: resource), + let attValue = decodedRecap["att"] { + if let statement = statement { + return "\n\(statement) \(buildRecapStatement(from: attValue))" + } else { + return buildRecapStatement(from: attValue) + } + } else { + guard let statement = statement else { return "" } + return "\n\(statement)" + } + } + private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { @@ -86,7 +94,7 @@ public struct SIWEMessage: Equatable { if !requestActions.isEmpty { let actionsString = requestActions.joined(separator: ", ") - statementParts.append("'\(actionsString)' for '\(resourceKey)'") + statementParts.append("'request': \(actionsString) for '\(resourceKey)'") } } @@ -109,11 +117,6 @@ private extension SIWEMessage { return "\nExpiration Time: \(exp)" } - var statementLine: String { - guard let statement = statement else { return "" } - return "\n\(statement)" - } - var nbfLine: String { guard let nbf = nbf else { return "" } return "\nNot Before: \(nbf)" diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 2a2a63469..653d189bc 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -97,16 +97,15 @@ class SIWEMessageFormatterTests: XCTestCase { XCTAssertEqual(message, expectedMessage) } - func testWithValidRecap() throws { + func testWithValidRecapAndStatement() throws { let validRecapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ==" - let expectedStatementPart = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." let expectedMessage = """ service.invalid wants you to sign in with your Ethereum account: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 - I accept the ServiceOrg Terms of Service: https://service.invalid/tos - I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. + + I accept the ServiceOrg Terms of Service: https://service.invalid/tos I further authorize the stated URI to perform the following actions: (1) 'request': 'personal_sign', 'eth_sendTransaction' for 'eip155'. URI: https://service.invalid/login Version: 1 @@ -127,4 +126,32 @@ class SIWEMessageFormatterTests: XCTestCase { XCTAssertEqual(message, expectedMessage) } + func testWithValidRecapAndNoStatement() throws { + let validRecapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ==" + + let expectedMessage = + """ + service.invalid wants you to sign in with your Ethereum account: + 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 + + I further authorize the stated URI to perform the following actions: (1) 'request': 'personal_sign', 'eth_sendTransaction' for 'eip155'. + + URI: https://service.invalid/login + Version: 1 + Chain ID: 1 + Nonce: 32891756 + Issued At: 2021-09-30T16:25:24Z + Resources: + - urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ== + """ + + + let payload = try AuthPayload.stub( + requestParams: RequestParams.stub(statement: nil,resources: [validRecapUrn]) + ).cacaoPayload(account: Account.stub()) + + let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) + XCTAssertEqual(message, expectedMessage) + } + } From 71d145539ffa6fedd73db688ec8a62c180e24790 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Fri, 15 Dec 2023 16:05:25 +0100 Subject: [PATCH 105/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 8ae524b7b..4d232ac36 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.9.10"} +{"version": "1.10.0"} From fea614e14439cfe92aac919979ef4785a5eb8908 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 18 Dec 2023 18:42:39 +0300 Subject: [PATCH 106/814] testWalletCreatesAndUpdatesSubscription disabled --- Example/IntegrationTests/Push/NotifyTests.swift | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 1b63c3d8f..084ef9fc0 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -164,7 +164,8 @@ final class NotifyTests: XCTestCase { try await clientB.deleteSubscription(topic: subscription.topic) } } - + + /* func testWalletCreatesAndUpdatesSubscription() async throws { let created = expectation(description: "Subscription created") @@ -202,6 +203,7 @@ final class NotifyTests: XCTestCase { try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) } + */ func testNotifyServerSubscribeAndNotifies() async throws { let subscribeExpectation = expectation(description: "creates notify subscription") From 28de2d44bc1f0ae11039c55edaaeaf01dd53bf95 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 15 Dec 2023 18:03:10 +0300 Subject: [PATCH 107/814] Index by dapp --- .../WalletConnectNotify/Client/Wallet/NotifyDatabase.swift | 5 +++-- .../Types/DataStructures/NotifySubscription.swift | 7 ++++--- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift index 9e6110e2b..422196905 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift @@ -110,14 +110,15 @@ private extension NotifyDatabase { try sqlite.execute(sql: """ CREATE TABLE IF NOT EXISTS \(Table.subscriptions) ( - topic TEXT PRIMARY KEY, + topic TEXT NOT NULL, account TEXT NOT NULL, relay TEXT NOT NULL, metadata TEXT NOT NULL, scope TEXT NOT NULL, expiry TEXT NOT NULL, symKey TEXT NOT NULL, - appAuthenticationKey TEXT NOT NULL + appAuthenticationKey TEXT NOT NULL, + id TEXT PRIMARY KEY ); """) diff --git a/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift b/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift index 9a5ac3609..a63ef14bb 100644 --- a/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift +++ b/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift @@ -1,7 +1,7 @@ import Foundation import Database -public struct NotifySubscription: DatabaseObject, SqliteRow { +public struct NotifySubscription: Codable, Equatable, SqliteRow { public let topic: String public let account: Account public let relay: RelayProtocolOptions @@ -11,8 +11,8 @@ public struct NotifySubscription: DatabaseObject, SqliteRow { public let symKey: String public let appAuthenticationKey: String - public var databaseId: String { - return topic + private var id: String { + return "\(account.absoluteString)-\(metadata.url)" } public init(decoder: SqliteRowDecoder) throws { @@ -36,6 +36,7 @@ public struct NotifySubscription: DatabaseObject, SqliteRow { encoder.encodeDate(expiry, for: "expiry") encoder.encodeString(symKey, for: "symKey") encoder.encodeString(appAuthenticationKey, for: "appAuthenticationKey") + encoder.encodeString(id, for: "id") return encoder } From f9906207b3c2fd6298347647ce6d0e428ca99306 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 15 Dec 2023 18:11:19 +0300 Subject: [PATCH 108/814] Notify DB versioning --- .../Client/Wallet/NotifyClientFactory.swift | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 99cff45c5..3a08a5727 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -7,7 +7,7 @@ public struct NotifyClientFactory { let keyserverURL = URL(string: "https://keys.walletconnect.com")! let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) let groupKeychainService = GroupKeychainStorage(serviceIdentifier: groupIdentifier) - let databasePath = databasePath(appGroup: groupIdentifier, database: "notify.db") + let databasePath = databasePath(appGroup: groupIdentifier, database: "notify_v\(version).db") let sqlite = DiskSqlite(path: databasePath) return NotifyClientFactory.create( @@ -102,4 +102,8 @@ public struct NotifyClientFactory { return path.absoluteString } + + static var version: String { + return "1" + } } From 40c151a4b5ac4d22994f9ba351b8733d1a749142 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Sat, 23 Dec 2023 16:46:26 +0300 Subject: [PATCH 109/814] WalletConnectSign import removed --- Sources/Web3Wallet/Web3WalletDecryptionService.swift | 1 - 1 file changed, 1 deletion(-) diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index e4786129f..88b355b3b 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -1,5 +1,4 @@ import Foundation -import WalletConnectSign public final class Web3WalletDecryptionService { enum Errors: Error { From c05c0ed7a9e3eebcec9e4c536aedc7d8a1b136c5 Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Sat, 23 Dec 2023 17:01:00 +0100 Subject: [PATCH 110/814] Fix union with nil requiredChains --- .../Wallet/SessionProposal/SessionProposalInteractor.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index 34c0f9880..ece832c35 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -11,7 +11,7 @@ final class SessionProposalInteractor { let supportedRequiredChains = proposal.requiredNamespaces["eip155"]?.chains let supportedOptionalChains = proposal.optionalNamespaces?["eip155"]?.chains ?? [] - let supportedChains = supportedRequiredChains?.union(supportedOptionalChains) ?? [] + let supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) ?? [] let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } From 130526dcaad1c29206841d5e014f4cc43483fcc5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Jan 2024 10:53:36 +0300 Subject: [PATCH 111/814] add tests for verify context --- .../xcschemes/WalletConnectVerify.xcscheme | 10 +++++ .../WalletConnectVerify/VerifyClient.swift | 23 +++-------- .../VerifyContextFactory.swift | 24 ++++++++++++ .../VerifyContextFactoryTests.swift | 38 +++++++++++++++++++ 4 files changed, 77 insertions(+), 18 deletions(-) create mode 100644 Sources/WalletConnectVerify/VerifyContextFactory.swift create mode 100644 Tests/VerifyTests/VerifyContextFactoryTests.swift diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectVerify.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectVerify.xcscheme index 5b4aa4030..0f35eb712 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectVerify.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectVerify.xcscheme @@ -28,6 +28,16 @@ selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB" shouldUseLaunchSchemeArgsEnv = "YES"> + + + + VerifyContext { - guard isScam != true else { - return VerifyContext( - origin: origin, - validation: .scam - ) - } - if let origin, let originUrl = URL(string: origin), let domainUrl = URL(string: domain) { - return VerifyContext( - origin: origin, - validation: (originUrl.host == domainUrl.host) ? .valid : .invalid - ) - } else { - return VerifyContext( - origin: origin, - validation: .unknown - ) - } + verifyContextFactory.createVerifyContext(origin: origin, domain: domain, isScam: isScam) } public func registerAssertion() async throws { diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift new file mode 100644 index 000000000..b687932e4 --- /dev/null +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -0,0 +1,24 @@ + +import Foundation + +class VerifyContextFactory { + public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { + guard isScam != true else { + return VerifyContext( + origin: origin, + validation: .scam + ) + } + if let origin, let originUrl = URL(string: origin), let domainUrl = URL(string: domain) { + return VerifyContext( + origin: origin, + validation: (originUrl.host == domainUrl.host) ? .valid : .invalid + ) + } else { + return VerifyContext( + origin: origin, + validation: .unknown + ) + } + } +} diff --git a/Tests/VerifyTests/VerifyContextFactoryTests.swift b/Tests/VerifyTests/VerifyContextFactoryTests.swift new file mode 100644 index 000000000..ac540cc0e --- /dev/null +++ b/Tests/VerifyTests/VerifyContextFactoryTests.swift @@ -0,0 +1,38 @@ +import Foundation +import XCTest +@testable import WalletConnectVerify + + +class VerifyContextFactoryTests: XCTestCase { + var factory: VerifyContextFactory! + + override func setUp() { + super.setUp() + factory = VerifyContextFactory() + } + + override func tearDown() { + factory = nil + super.tearDown() + } + + func testScamValidation() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true) + XCTAssertEqual(context.validation, .scam) + } + + func testValidOriginAndDomain() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: false) + XCTAssertEqual(context.validation, .valid) + } + + func testInvalidOriginAndDomain() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://different.com", isScam: false) + XCTAssertEqual(context.validation, .invalid) + } + + func testUnknownValidation() { + let context = factory.createVerifyContext(origin: nil, domain: "http://example.com", isScam: false) + XCTAssertEqual(context.validation, .unknown) + } + } From 8f4f9f9150f47dac082aa911bd28a049fc419741 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 11:16:39 +0300 Subject: [PATCH 112/814] sort recap actions for statement --- Sources/WalletConnectUtils/SIWE/SIWEMessage.swift | 7 ++++--- .../WalletConnectSignTests/SIWEMessageFormatterTests.swift | 4 ++-- .../Stub/SIWEMessageFormatterMock.swift | 2 +- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 3d84684f2..7a300967a 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -52,7 +52,7 @@ public struct SIWEMessage: Equatable { if let statement = statement { return "\n\(statement) \(buildRecapStatement(from: attValue))" } else { - return buildRecapStatement(from: attValue) + return "\n\(buildRecapStatement(from: attValue))" } } else { guard let statement = statement else { return "" } @@ -92,6 +92,9 @@ public struct SIWEMessage: Equatable { requestActions.append("'\(action)'") } + // sorting is required as dictionary doesn't guarantee the order of elements + requestActions.sort() + if !requestActions.isEmpty { let actionsString = requestActions.joined(separator: ", ") statementParts.append("'request': \(actionsString) for '\(resourceKey)'") @@ -106,8 +109,6 @@ public struct SIWEMessage: Equatable { } } - - } private extension SIWEMessage { diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 653d189bc..5356b71ed 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -105,7 +105,7 @@ class SIWEMessageFormatterTests: XCTestCase { service.invalid wants you to sign in with your Ethereum account: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 - I accept the ServiceOrg Terms of Service: https://service.invalid/tos I further authorize the stated URI to perform the following actions: (1) 'request': 'personal_sign', 'eth_sendTransaction' for 'eip155'. + I accept the ServiceOrg Terms of Service: https://service.invalid/tos I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. URI: https://service.invalid/login Version: 1 @@ -134,7 +134,7 @@ class SIWEMessageFormatterTests: XCTestCase { service.invalid wants you to sign in with your Ethereum account: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 - I further authorize the stated URI to perform the following actions: (1) 'request': 'personal_sign', 'eth_sendTransaction' for 'eip155'. + I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. URI: https://service.invalid/login Version: 1 diff --git a/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift index e7d6193c0..3fd5658aa 100644 --- a/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift +++ b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift @@ -1,5 +1,5 @@ import Foundation -@testable import Auth +@testable import WalletConnectUtils class SIWEMessageFormatterMock: SIWECacaoFormatting { func formatMessage(from payload: WalletConnectUtils.CacaoPayload, includeRecapInTheStatement: Bool) throws -> String { From b398ebb3c7cfe3f401a755cb931357bc65f23f47 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 11:21:21 +0300 Subject: [PATCH 113/814] sort resource keys --- Sources/WalletConnectUtils/SIWE/SIWEMessage.swift | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 7a300967a..10fb978cf 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -84,7 +84,11 @@ public struct SIWEMessage: Equatable { private func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { var statementParts: [String] = [] - for (resourceKey, actions) in decodedRecap { + // sort resources keys for consistancy in the statement + let sortedResourceKeys = decodedRecap.keys.sorted() + + for resourceKey in sortedResourceKeys { + guard let actions = decodedRecap[resourceKey] else { continue } var requestActions: [String] = [] for (actionType, _) in actions where actionType.starts(with: "request/") { @@ -111,6 +115,8 @@ public struct SIWEMessage: Equatable { } + + private extension SIWEMessage { var expLine: String { From b4ed7af06bf2408ab5e2f7e125260cc15d20865d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 11:39:12 +0300 Subject: [PATCH 114/814] add RecapStatementBuilderTests --- .../SIWE/RecapStatementBuilder.swift | 36 +++++++++++++++++++ .../WalletConnectUtils/SIWE/SIWEMessage.swift | 32 +---------------- .../RecapStatementBuilderTests.swift | 34 ++++++++++++++++++ 3 files changed, 71 insertions(+), 31 deletions(-) create mode 100644 Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift create mode 100644 Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift new file mode 100644 index 000000000..2eb4ee145 --- /dev/null +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -0,0 +1,36 @@ + +import Foundation + +struct RecapStatementBuilder { + static func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { + var statementParts: [String] = [] + + // sort resources keys for consistancy in the statement + let sortedResourceKeys = decodedRecap.keys.sorted() + + for resourceKey in sortedResourceKeys { + guard let actions = decodedRecap[resourceKey] else { continue } + var requestActions: [String] = [] + + for (actionType, _) in actions where actionType.starts(with: "request/") { + let action = actionType.replacingOccurrences(of: "request/", with: "") + requestActions.append("'\(action)'") + } + + // sorting is required as dictionary doesn't guarantee the order of elements + requestActions.sort() + + if !requestActions.isEmpty { + let actionsString = requestActions.joined(separator: ", ") + statementParts.append("'request': \(actionsString) for '\(resourceKey)'") + } + } + + if !statementParts.isEmpty { + let formattedStatement = statementParts.joined(separator: "; ") + return "I further authorize the stated URI to perform the following actions: (1) \(formattedStatement)." + } else { + return "" + } + } +} diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 10fb978cf..6bf4045a0 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -82,41 +82,11 @@ public struct SIWEMessage: Equatable { } private func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { - var statementParts: [String] = [] - - // sort resources keys for consistancy in the statement - let sortedResourceKeys = decodedRecap.keys.sorted() - - for resourceKey in sortedResourceKeys { - guard let actions = decodedRecap[resourceKey] else { continue } - var requestActions: [String] = [] - - for (actionType, _) in actions where actionType.starts(with: "request/") { - let action = actionType.replacingOccurrences(of: "request/", with: "") - requestActions.append("'\(action)'") - } - - // sorting is required as dictionary doesn't guarantee the order of elements - requestActions.sort() - - if !requestActions.isEmpty { - let actionsString = requestActions.joined(separator: ", ") - statementParts.append("'request': \(actionsString) for '\(resourceKey)'") - } - } - - if !statementParts.isEmpty { - let formattedStatement = statementParts.joined(separator: "; ") - return "I further authorize the stated URI to perform the following actions: (1) \(formattedStatement)." - } else { - return "" - } + RecapStatementBuilder.buildRecapStatement(from: decodedRecap) } } - - private extension SIWEMessage { var expLine: String { diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift new file mode 100644 index 000000000..d31188ac1 --- /dev/null +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -0,0 +1,34 @@ +import XCTest +@testable import WalletConnectUtils + +class RecapStatementBuilderTests: XCTestCase { + func testSingleResourceKey() { + let decodedRecap: [String: [String: [String]]] = [ + "eip155": [ + "request/eth_sendTransaction": [], + "request/personal_sign": [] + ] + ] + + let expectedStatement = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." + + let recapStatement = RecapStatementBuilder.buildRecapStatement(from: decodedRecap) + + XCTAssertEqual(recapStatement, expectedStatement) + } + + func testInvertedAction() { + let decodedRecap: [String: [String: [String]]] = [ + "eip155": [ + "request/personal_sign": [], + "request/eth_sendTransaction": [] + ] + ] + + let expectedStatement = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." + + let recapStatement = RecapStatementBuilder.buildRecapStatement(from: decodedRecap) + + XCTAssertEqual(recapStatement, expectedStatement) + } +} From 25f050508bbfa9b2bc91b48f852f85dcfc0cb1bb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 12:14:57 +0300 Subject: [PATCH 115/814] fix testEIP191SessionAuthenticatedMultiCacao --- Example/IntegrationTests/Auth/AuthTests.swift | 418 +++++++++--------- .../Auth/Signer/CacaoSignerTests.swift | 2 +- Example/IntegrationTests/Chat/ChatTests.swift | 350 +++++++-------- .../IntegrationTests/Chat/RegistryTests.swift | 2 +- .../IntegrationTests/Push/NotifyTests.swift | 2 +- .../Sign/SignClientTests.swift | 13 +- Example/IntegrationTests/Sync/SyncTests.swift | 2 +- .../Signer/MessageSignerFactory.swift | 4 - 8 files changed, 395 insertions(+), 398 deletions(-) diff --git a/Example/IntegrationTests/Auth/AuthTests.swift b/Example/IntegrationTests/Auth/AuthTests.swift index 276e14e84..d8dc2fc6d 100644 --- a/Example/IntegrationTests/Auth/AuthTests.swift +++ b/Example/IntegrationTests/Auth/AuthTests.swift @@ -1,209 +1,209 @@ -import Foundation -import XCTest -@testable import WalletConnectUtils -@testable import WalletConnectKMS -import WalletConnectRelay -import Combine -@testable import Auth -import WalletConnectPairing -import WalletConnectNetworking -import WalletConnectVerify - -final class AuthTests: XCTestCase { - var appPairingClient: PairingClient! - var walletPairingClient: PairingClient! - - var appAuthClient: AuthClient! - var walletAuthClient: AuthClient! - - let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! - let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") - let eip1271Signature = "0xc1505719b2504095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" - private var publishers = [AnyCancellable]() - - override func setUp() { - setupClients() - } - - private func setupClients(iatProvider: IATProvider = DefaultIATProvider()) { - (appPairingClient, appAuthClient) = makeClients(prefix: "🤖 App", iatProvider: iatProvider) - (walletPairingClient, walletAuthClient) = makeClients(prefix: "🐶 Wallet", iatProvider: iatProvider) - } - - func makeClients(prefix: String, iatProvider: IATProvider) -> (PairingClient, AuthClient) { - let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) - let keyValueStorage = RuntimeKeyValueStorage() - let keychain = KeychainStorageMock() - let relayClient = RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - logger: logger) - - let networkingClient = NetworkingClientFactory.create( - relayClient: relayClient, - logger: logger, - keychainStorage: keychain, - keyValueStorage: keyValueStorage) - - let pairingClient = PairingClientFactory.create( - logger: logger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient) - - let authClient = AuthClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), - projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - logger: logger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient, - pairingRegisterer: pairingClient, - iatProvider: iatProvider) - - let clientId = try! networkingClient.getClientId() - logger.debug("My client id is: \(clientId)") - - return (pairingClient, authClient) - } - - func testRequest() async { - let requestExpectation = expectation(description: "request delivered to wallet") - let uri = try! await appPairingClient.create() - try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - walletAuthClient.authRequestPublisher.sink { _ in - requestExpectation.fulfill() - }.store(in: &publishers) - wait(for: [requestExpectation], timeout: InputConfig.defaultTimeout) - } - - func testEIP191RespondSuccess() async { - let responseExpectation = expectation(description: "successful response delivered") - let uri = try! await appPairingClient.create() - try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - walletAuthClient.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - let signerFactory = DefaultSignerFactory() - let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) - let payload = try! request.0.payload.cacaoPayload(address: walletAccount.address) - let signature = try! signer.sign(payload: payload, privateKey: prvKey, type: .eip191) - try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: walletAccount) - } - } - .store(in: &publishers) - appAuthClient.authResponsePublisher.sink { (_, result) in - guard case .success = result else { XCTFail(); return } - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } - - func testEIP1271RespondSuccess() async { - setupClients(iatProvider: IATProviderMock()) - - let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! - - let responseExpectation = expectation(description: "successful response delivered") - let uri = try! await appPairingClient.create() - try! await appAuthClient.request(RequestParams( - domain: "localhost", - chainId: "eip155:1", - nonce: "1665443015700", - aud: "http://localhost:3000/", - nbf: nil, - exp: "2022-10-11T23:03:35.700Z", - statement: nil, - requestId: nil, - resources: nil - ), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - walletAuthClient.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: account) - } - } - .store(in: &publishers) - appAuthClient.authResponsePublisher.sink { (_, result) in - guard case .success = result else { XCTFail(); return } - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } - - func testEIP191RespondError() async { - let responseExpectation = expectation(description: "error response delivered") - let uri = try! await appPairingClient.create() - try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - walletAuthClient.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) - try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: walletAccount) - } - } - .store(in: &publishers) - appAuthClient.authResponsePublisher.sink { (_, result) in - guard case let .failure(error) = result, error == .signatureVerificationFailed else { XCTFail(); return } - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } - - func testUserRespondError() async { - let responseExpectation = expectation(description: "error response delivered") - let uri = try! await appPairingClient.create() - try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - walletAuthClient.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - try! await walletAuthClient.reject(requestId: request.0.id) - } - } - .store(in: &publishers) - appAuthClient.authResponsePublisher.sink { (_, result) in - guard case .failure(let error) = result else { XCTFail(); return } - XCTAssertEqual(error, .userRejeted) - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } - - func testRespondSignatureVerificationFailed() async { - let responseExpectation = expectation(description: "invalid signature response delivered") - let uri = try! await appPairingClient.create() - try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) - - try? await walletPairingClient.pair(uri: uri) - walletAuthClient.authRequestPublisher.sink { [unowned self] request in - Task(priority: .high) { - let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" - let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) - try! await walletAuthClient.respond(requestId: request.0.id, signature: cacaoSignature, from: walletAccount) - } - } - .store(in: &publishers) - appAuthClient.authResponsePublisher.sink { (_, result) in - guard case .failure(let error) = result else { XCTFail(); return } - XCTAssertEqual(error, .signatureVerificationFailed) - responseExpectation.fulfill() - } - .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) - } -} +//import Foundation +//import XCTest +//@testable import WalletConnectUtils +//@testable import WalletConnectKMS +//import WalletConnectRelay +//import Combine +//@testable import Auth +//import WalletConnectPairing +//import WalletConnectNetworking +//import WalletConnectVerify +// +//final class AuthTests: XCTestCase { +// var appPairingClient: PairingClient! +// var walletPairingClient: PairingClient! +// +// var appAuthClient: AuthClient! +// var walletAuthClient: AuthClient! +// +// let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! +// let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") +// let eip1271Signature = "0xc1505719b2504095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" +// private var publishers = [AnyCancellable]() +// +// override func setUp() { +// setupClients() +// } +// +// private func setupClients(iatProvider: IATProvider = DefaultIATProvider()) { +// (appPairingClient, appAuthClient) = makeClients(prefix: "🤖 App", iatProvider: iatProvider) +// (walletPairingClient, walletAuthClient) = makeClients(prefix: "🐶 Wallet", iatProvider: iatProvider) +// } +// +// func makeClients(prefix: String, iatProvider: IATProvider) -> (PairingClient, AuthClient) { +// let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) +// let keyValueStorage = RuntimeKeyValueStorage() +// let keychain = KeychainStorageMock() +// let relayClient = RelayClientFactory.create( +// relayHost: InputConfig.relayHost, +// projectId: InputConfig.projectId, +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// socketFactory: DefaultSocketFactory(), +// logger: logger) +// +// let networkingClient = NetworkingClientFactory.create( +// relayClient: relayClient, +// logger: logger, +// keychainStorage: keychain, +// keyValueStorage: keyValueStorage) +// +// let pairingClient = PairingClientFactory.create( +// logger: logger, +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// networkingClient: networkingClient) +// +// let authClient = AuthClientFactory.create( +// metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), +// projectId: InputConfig.projectId, +// crypto: DefaultCryptoProvider(), +// logger: logger, +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// networkingClient: networkingClient, +// pairingRegisterer: pairingClient, +// iatProvider: iatProvider) +// +// let clientId = try! networkingClient.getClientId() +// logger.debug("My client id is: \(clientId)") +// +// return (pairingClient, authClient) +// } +// +// func testRequest() async { +// let requestExpectation = expectation(description: "request delivered to wallet") +// let uri = try! await appPairingClient.create() +// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// walletAuthClient.authRequestPublisher.sink { _ in +// requestExpectation.fulfill() +// }.store(in: &publishers) +// wait(for: [requestExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testEIP191RespondSuccess() async { +// let responseExpectation = expectation(description: "successful response delivered") +// let uri = try! await appPairingClient.create() +// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// walletAuthClient.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// let signerFactory = DefaultSignerFactory() +// let signer = MessageSignerFactory(signerFactory: signerFactory).create() +// let payload = try! request.0.payload.cacaoPayload(address: walletAccount.address) +// let signature = try! signer.sign(payload: payload, privateKey: prvKey, type: .eip191) +// try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: walletAccount) +// } +// } +// .store(in: &publishers) +// appAuthClient.authResponsePublisher.sink { (_, result) in +// guard case .success = result else { XCTFail(); return } +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testEIP1271RespondSuccess() async { +// setupClients(iatProvider: IATProviderMock()) +// +// let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! +// +// let responseExpectation = expectation(description: "successful response delivered") +// let uri = try! await appPairingClient.create() +// try! await appAuthClient.request(RequestParams( +// domain: "localhost", +// chainId: "eip155:1", +// nonce: "1665443015700", +// aud: "http://localhost:3000/", +// nbf: nil, +// exp: "2022-10-11T23:03:35.700Z", +// statement: nil, +// requestId: nil, +// resources: nil +// ), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// walletAuthClient.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) +// try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: account) +// } +// } +// .store(in: &publishers) +// appAuthClient.authResponsePublisher.sink { (_, result) in +// guard case .success = result else { XCTFail(); return } +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testEIP191RespondError() async { +// let responseExpectation = expectation(description: "error response delivered") +// let uri = try! await appPairingClient.create() +// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// walletAuthClient.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) +// try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: walletAccount) +// } +// } +// .store(in: &publishers) +// appAuthClient.authResponsePublisher.sink { (_, result) in +// guard case let .failure(error) = result, error == .signatureVerificationFailed else { XCTFail(); return } +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testUserRespondError() async { +// let responseExpectation = expectation(description: "error response delivered") +// let uri = try! await appPairingClient.create() +// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// walletAuthClient.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// try! await walletAuthClient.reject(requestId: request.0.id) +// } +// } +// .store(in: &publishers) +// appAuthClient.authResponsePublisher.sink { (_, result) in +// guard case .failure(let error) = result else { XCTFail(); return } +// XCTAssertEqual(error, .userRejeted) +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testRespondSignatureVerificationFailed() async { +// let responseExpectation = expectation(description: "invalid signature response delivered") +// let uri = try! await appPairingClient.create() +// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) +// +// try? await walletPairingClient.pair(uri: uri) +// walletAuthClient.authRequestPublisher.sink { [unowned self] request in +// Task(priority: .high) { +// let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" +// let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) +// try! await walletAuthClient.respond(requestId: request.0.id, signature: cacaoSignature, from: walletAccount) +// } +// } +// .store(in: &publishers) +// appAuthClient.authResponsePublisher.sink { (_, result) in +// guard case .failure(let error) = result else { XCTFail(); return } +// XCTAssertEqual(error, .signatureVerificationFailed) +// responseExpectation.fulfill() +// } +// .store(in: &publishers) +// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// } +//} diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index 285173cc3..342278e68 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -5,7 +5,7 @@ import XCTest class CacaoSignerTest: XCTestCase { let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()) - .create(projectId: InputConfig.projectId) + .create() let verifier = MessageVerifierFactory(crypto: DefaultCryptoProvider()).create(projectId: InputConfig.projectId) let privateKey = Data(hex: "305c6cde3846927892cd32762f6120539f3ec74c9e3a16b9b798b1e85351ae2a") diff --git a/Example/IntegrationTests/Chat/ChatTests.swift b/Example/IntegrationTests/Chat/ChatTests.swift index 04cdc7e68..bc1262edf 100644 --- a/Example/IntegrationTests/Chat/ChatTests.swift +++ b/Example/IntegrationTests/Chat/ChatTests.swift @@ -1,175 +1,175 @@ -import Foundation -import XCTest -@testable import WalletConnectChat -import WalletConnectUtils -@testable import WalletConnectKMS -@testable import WalletConnectSync -@testable import WalletConnectHistory -import WalletConnectRelay -import Combine -import Web3 - -final class ChatTests: XCTestCase { - var invitee1: ChatClient! - var inviter1: ChatClient! - var invitee2: ChatClient! - var inviter2: ChatClient! - private var publishers = [AnyCancellable]() - - var inviteeAccount: Account { - return Account("eip155:1:" + pk1.address.hex(eip55: true))! - } - - var inviterAccount: Account { - return Account("eip155:1:" + pk2.address.hex(eip55: true))! - } - - let pk1 = try! EthereumPrivateKey() - let pk2 = try! EthereumPrivateKey() - - var privateKey1: Data { - return Data(pk1.rawPrivateKey) - } - var privateKey2: Data { - return Data(pk2.rawPrivateKey) - } - - override func setUp() async throws { - invitee1 = makeClient(prefix: "🦖 Invitee", account: inviteeAccount) - inviter1 = makeClient(prefix: "🍄 Inviter", account: inviterAccount) - - try await invitee1.register(account: inviteeAccount, domain: "") { message in - return self.sign(message, privateKey: self.privateKey1) - } - try await inviter1.register(account: inviterAccount, domain: "") { message in - return self.sign(message, privateKey: self.privateKey2) - } - } - - func makeClient(prefix: String, account: Account) -> ChatClient { - let keyserverURL = URL(string: "https://keys.walletconnect.com")! - let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) - let keyValueStorage = RuntimeKeyValueStorage() - let keychain = KeychainStorageMock() - let relayClient = RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - logger: logger) - - let networkingInteractor = NetworkingClientFactory.create( - relayClient: relayClient, - logger: logger, - keychainStorage: keychain, - keyValueStorage: keyValueStorage) - - let syncClient = SyncClientFactory.create( - networkInteractor: networkingInteractor, - bip44: DefaultBIP44Provider(), - keychain: keychain - ) - - let historyClient = HistoryClientFactory.create( - historyUrl: "https://history.walletconnect.com", - relayUrl: "wss://relay.walletconnect.com", - keyValueStorage: keyValueStorage, - keychain: keychain, - logger: logger - ) - - let clientId = try! networkingInteractor.getClientId() - logger.debug("My client id is: \(clientId)") - - return ChatClientFactory.create(keyserverURL: keyserverURL, relayClient: relayClient, networkingInteractor: networkingInteractor, keychain: keychain, logger: logger, storage: keyValueStorage, syncClient: syncClient, historyClient: historyClient) - } - - func testInvite() async throws { - let inviteExpectation = expectation(description: "invitation expectation") - inviteExpectation.expectedFulfillmentCount = 2 - - invitee1.newReceivedInvitePublisher.sink { _ in - inviteExpectation.fulfill() - }.store(in: &publishers) - - inviter1.newSentInvitePublisher.sink { _ in - inviteExpectation.fulfill() - }.store(in: &publishers) - - let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) - let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) - _ = try await inviter1.invite(invite: invite) - - wait(for: [inviteExpectation], timeout: InputConfig.defaultTimeout) - } - - func testAcceptAndCreateNewThread() async throws { - let newThreadInviterExpectation = expectation(description: "new thread on inviting client expectation") - let newThreadinviteeExpectation = expectation(description: "new thread on invitee client expectation") - - invitee1.newReceivedInvitePublisher.sink { [unowned self] invite in - Task { try! await invitee1.accept(inviteId: invite.id) } - }.store(in: &publishers) - - invitee1.newThreadPublisher.sink { _ in - newThreadinviteeExpectation.fulfill() - }.store(in: &publishers) - - inviter1.newThreadPublisher.sink { _ in - newThreadInviterExpectation.fulfill() - }.store(in: &publishers) - - let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) - let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) - try await inviter1.invite(invite: invite) - - wait(for: [newThreadinviteeExpectation, newThreadInviterExpectation], timeout: InputConfig.defaultTimeout) - } - - func testMessage() async throws { - let messageExpectation = expectation(description: "message received") - messageExpectation.expectedFulfillmentCount = 4 - - invitee1.newReceivedInvitePublisher.sink { [unowned self] invite in - Task { try! await invitee1.accept(inviteId: invite.id) } - }.store(in: &publishers) - - invitee1.newThreadPublisher.sink { [unowned self] thread in - Task { try! await invitee1.message(topic: thread.topic, message: "message1") } - }.store(in: &publishers) - - inviter1.newThreadPublisher.sink { [unowned self] thread in - Task { try! await inviter1.message(topic: thread.topic, message: "message2") } - }.store(in: &publishers) - - inviter1.newMessagePublisher.sink { message in - if message.authorAccount == self.inviterAccount { - XCTAssertEqual(message.message, "message2") - } else { - XCTAssertEqual(message.message, "message1") - } - messageExpectation.fulfill() - }.store(in: &publishers) - - invitee1.newMessagePublisher.sink { message in - if message.authorAccount == self.inviteeAccount { - XCTAssertEqual(message.message, "message1") - } else { - XCTAssertEqual(message.message, "message2") - } - messageExpectation.fulfill() - }.store(in: &publishers) - - let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) - let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) - try await inviter1.invite(invite: invite) - - wait(for: [messageExpectation], timeout: InputConfig.defaultTimeout) - } - - private func sign(_ message: String, privateKey: Data) -> SigningResult { - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) - return .signed(try! signer.sign(message: message, privateKey: privateKey, type: .eip191)) - } -} +//import Foundation +//import XCTest +//@testable import WalletConnectChat +//import WalletConnectUtils +//@testable import WalletConnectKMS +//@testable import WalletConnectSync +//@testable import WalletConnectHistory +//import WalletConnectRelay +//import Combine +//import Web3 +// +//final class ChatTests: XCTestCase { +// var invitee1: ChatClient! +// var inviter1: ChatClient! +// var invitee2: ChatClient! +// var inviter2: ChatClient! +// private var publishers = [AnyCancellable]() +// +// var inviteeAccount: Account { +// return Account("eip155:1:" + pk1.address.hex(eip55: true))! +// } +// +// var inviterAccount: Account { +// return Account("eip155:1:" + pk2.address.hex(eip55: true))! +// } +// +// let pk1 = try! EthereumPrivateKey() +// let pk2 = try! EthereumPrivateKey() +// +// var privateKey1: Data { +// return Data(pk1.rawPrivateKey) +// } +// var privateKey2: Data { +// return Data(pk2.rawPrivateKey) +// } +// +// override func setUp() async throws { +// invitee1 = makeClient(prefix: "🦖 Invitee", account: inviteeAccount) +// inviter1 = makeClient(prefix: "🍄 Inviter", account: inviterAccount) +// +// try await invitee1.register(account: inviteeAccount, domain: "") { message in +// return self.sign(message, privateKey: self.privateKey1) +// } +// try await inviter1.register(account: inviterAccount, domain: "") { message in +// return self.sign(message, privateKey: self.privateKey2) +// } +// } +// +// func makeClient(prefix: String, account: Account) -> ChatClient { +// let keyserverURL = URL(string: "https://keys.walletconnect.com")! +// let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) +// let keyValueStorage = RuntimeKeyValueStorage() +// let keychain = KeychainStorageMock() +// let relayClient = RelayClientFactory.create( +// relayHost: InputConfig.relayHost, +// projectId: InputConfig.projectId, +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// socketFactory: DefaultSocketFactory(), +// logger: logger) +// +// let networkingInteractor = NetworkingClientFactory.create( +// relayClient: relayClient, +// logger: logger, +// keychainStorage: keychain, +// keyValueStorage: keyValueStorage) +// +// let syncClient = SyncClientFactory.create( +// networkInteractor: networkingInteractor, +// bip44: DefaultBIP44Provider(), +// keychain: keychain +// ) +// +// let historyClient = HistoryClientFactory.create( +// historyUrl: "https://history.walletconnect.com", +// relayUrl: "wss://relay.walletconnect.com", +// keyValueStorage: keyValueStorage, +// keychain: keychain, +// logger: logger +// ) +// +// let clientId = try! networkingInteractor.getClientId() +// logger.debug("My client id is: \(clientId)") +// +// return ChatClientFactory.create(keyserverURL: keyserverURL, relayClient: relayClient, networkingInteractor: networkingInteractor, keychain: keychain, logger: logger, storage: keyValueStorage, syncClient: syncClient, historyClient: historyClient) +// } +// +// func testInvite() async throws { +// let inviteExpectation = expectation(description: "invitation expectation") +// inviteExpectation.expectedFulfillmentCount = 2 +// +// invitee1.newReceivedInvitePublisher.sink { _ in +// inviteExpectation.fulfill() +// }.store(in: &publishers) +// +// inviter1.newSentInvitePublisher.sink { _ in +// inviteExpectation.fulfill() +// }.store(in: &publishers) +// +// let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) +// let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) +// _ = try await inviter1.invite(invite: invite) +// +// wait(for: [inviteExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testAcceptAndCreateNewThread() async throws { +// let newThreadInviterExpectation = expectation(description: "new thread on inviting client expectation") +// let newThreadinviteeExpectation = expectation(description: "new thread on invitee client expectation") +// +// invitee1.newReceivedInvitePublisher.sink { [unowned self] invite in +// Task { try! await invitee1.accept(inviteId: invite.id) } +// }.store(in: &publishers) +// +// invitee1.newThreadPublisher.sink { _ in +// newThreadinviteeExpectation.fulfill() +// }.store(in: &publishers) +// +// inviter1.newThreadPublisher.sink { _ in +// newThreadInviterExpectation.fulfill() +// }.store(in: &publishers) +// +// let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) +// let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) +// try await inviter1.invite(invite: invite) +// +// wait(for: [newThreadinviteeExpectation, newThreadInviterExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// func testMessage() async throws { +// let messageExpectation = expectation(description: "message received") +// messageExpectation.expectedFulfillmentCount = 4 +// +// invitee1.newReceivedInvitePublisher.sink { [unowned self] invite in +// Task { try! await invitee1.accept(inviteId: invite.id) } +// }.store(in: &publishers) +// +// invitee1.newThreadPublisher.sink { [unowned self] thread in +// Task { try! await invitee1.message(topic: thread.topic, message: "message1") } +// }.store(in: &publishers) +// +// inviter1.newThreadPublisher.sink { [unowned self] thread in +// Task { try! await inviter1.message(topic: thread.topic, message: "message2") } +// }.store(in: &publishers) +// +// inviter1.newMessagePublisher.sink { message in +// if message.authorAccount == self.inviterAccount { +// XCTAssertEqual(message.message, "message2") +// } else { +// XCTAssertEqual(message.message, "message1") +// } +// messageExpectation.fulfill() +// }.store(in: &publishers) +// +// invitee1.newMessagePublisher.sink { message in +// if message.authorAccount == self.inviteeAccount { +// XCTAssertEqual(message.message, "message1") +// } else { +// XCTAssertEqual(message.message, "message2") +// } +// messageExpectation.fulfill() +// }.store(in: &publishers) +// +// let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) +// let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) +// try await inviter1.invite(invite: invite) +// +// wait(for: [messageExpectation], timeout: InputConfig.defaultTimeout) +// } +// +// private func sign(_ message: String, privateKey: Data) -> SigningResult { +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) +// return .signed(try! signer.sign(message: message, privateKey: privateKey, type: .eip191)) +// } +//} diff --git a/Example/IntegrationTests/Chat/RegistryTests.swift b/Example/IntegrationTests/Chat/RegistryTests.swift index a6de83f9e..0c659241f 100644 --- a/Example/IntegrationTests/Chat/RegistryTests.swift +++ b/Example/IntegrationTests/Chat/RegistryTests.swift @@ -29,7 +29,7 @@ final class RegistryTests: XCTestCase { iatProvader: DefaultIATProvider(), messageFormatter: SIWECacaoFormatter() ) - signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) + signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() } // func testRegisterIdentityAndInviteKey() async throws { diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 1b63c3d8f..4cd37bc77 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -259,7 +259,7 @@ final class NotifyTests: XCTestCase { private extension NotifyTests { func sign(_ message: String) -> CacaoSignature { - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) + let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) } } diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 8fb57a1c3..99463b036 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -767,7 +767,7 @@ final class SignClientTests: XCTestCase { wallet.authRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() - let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) + let signer = MessageSignerFactory(signerFactory: signerFactory).create() let Siwemessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) @@ -802,20 +802,21 @@ final class SignClientTests: XCTestCase { wallet.authRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() - let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) + let signer = MessageSignerFactory(signerFactory: signerFactory).create() var cacaos = [Cacao]() request.payload.chains.forEach { chain in - let SiweMessage = try! wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + let account = Account(blockchain: Blockchain(chain)!, address: walletAccount.address)! + let siweMessage = try! wallet.formatAuthMessage(payload: request.payload, account: account) let signature = try! signer.sign( - message: SiweMessage, + message: siweMessage, privateKey: prvKey, type: .eip191) - let cacao = try! wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) + let cacao = try! wallet.makeAuthObject(authRequest: request, signature: signature, account: account) cacaos.append(cacao) } @@ -933,7 +934,7 @@ final class SignClientTests: XCTestCase { wallet.authRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() - let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) + let signer = MessageSignerFactory(signerFactory: signerFactory).create() let Siwemessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) diff --git a/Example/IntegrationTests/Sync/SyncTests.swift b/Example/IntegrationTests/Sync/SyncTests.swift index adcfdc532..2e8a92f3f 100644 --- a/Example/IntegrationTests/Sync/SyncTests.swift +++ b/Example/IntegrationTests/Sync/SyncTests.swift @@ -48,7 +48,7 @@ final class SyncTests: XCTestCase { client2 = makeClient(indexStore: indexStore2, suffix: "💜") syncStore1 = makeSyncStore(client: client1, indexStore: indexStore1) syncStore2 = makeSyncStore(client: client2, indexStore: indexStore2) - signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) + signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() } func makeClient(indexStore: SyncIndexStore, suffix: String) -> SyncClient { diff --git a/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift b/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift index a5f739a88..0506e6fa1 100644 --- a/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift +++ b/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift @@ -9,10 +9,6 @@ public struct MessageSignerFactory { } public func create() -> MessageSigner { - return create(projectId: Networking.projectId) - } - - public func create(projectId: String) -> MessageSigner { return MessageSigner( signer: signerFactory.createEthereumSigner(), messageFormatter: SIWECacaoFormatter() From 5bb38fe47e95d2ede499a8909dff9c03817b3d67 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 12:29:07 +0300 Subject: [PATCH 116/814] refactor sign tests --- .../Sign/SignClientTests.swift | 44 +++++++++---------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 99463b036..a4c75dcf4 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -97,7 +97,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testSessionReject() async throws { @@ -123,7 +123,7 @@ final class SignClientTests: XCTestCase { XCTAssertEqual(store.rejectedProposal, proposal) sessionRejectExpectation.fulfill() // TODO: Assert reason code }.store(in: &publishers) - wait(for: [sessionRejectExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [sessionRejectExpectation], timeout: InputConfig.defaultTimeout) } func testSessionDelete() async throws { @@ -148,7 +148,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [sessionDeleteExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [sessionDeleteExpectation], timeout: InputConfig.defaultTimeout) } func testSessionPing() async throws { @@ -179,7 +179,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSessionRequest() async throws { @@ -229,7 +229,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } func testSessionRequestFailureResponse() async throws { @@ -272,7 +272,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testNewSessionOnExistingPairing() async throws { @@ -310,7 +310,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testSuccessfulSessionUpdateNamespaces() async throws { @@ -334,7 +334,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSuccessfulSessionExtend() async throws { @@ -363,7 +363,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSessionEventSucceeds() async throws { @@ -394,7 +394,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSessionEventFails() async throws { @@ -422,7 +422,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyAllRequiredAllOptionalNamespacesSuccessful() async throws { @@ -500,7 +500,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyAllRequiredNamespacesSuccessful() async throws { @@ -559,7 +559,7 @@ final class SignClientTests: XCTestCase { } } }.store(in: &publishers) - dapp.sessionSettlePublisher.sink { [unowned self] _ in + dapp.sessionSettlePublisher.sink { _ in dappSettlementExpectation.fulfill() }.store(in: &publishers) wallet.sessionSettlePublisher.sink { _ in @@ -569,7 +569,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyEmptyRequiredNamespacesExtraOptionalNamespacesSuccessful() async throws { @@ -628,7 +628,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyPartiallyRequiredNamespacesFails() async throws { @@ -691,7 +691,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [settlementFailedExpectation], timeout: 1) + await fulfillment(of: [settlementFailedExpectation], timeout: 1) } func testCaip25SatisfyPartiallyRequiredNamespacesMethodsFails() async throws { @@ -757,7 +757,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [settlementFailedExpectation], timeout: 1) + await fulfillment(of: [settlementFailedExpectation], timeout: 1) } @@ -793,7 +793,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.authenticate(RequestParams.stub(), topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } func testEIP191SessionAuthenticatedMultiCacao() async throws { @@ -836,7 +836,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.authenticate(RequestParams.stub(chains: ["eip155:1", "eip155:137"]), topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } // func testEIP1271SessionAuthenticated() async throws { @@ -897,7 +897,7 @@ final class SignClientTests: XCTestCase { responseExpectation.fulfill() } .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } func testUserRespondError() async { @@ -919,7 +919,7 @@ final class SignClientTests: XCTestCase { responseExpectation.fulfill() } .store(in: &publishers) - wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } func testSessionRequestOnAuthenticatedSession() async throws { @@ -985,7 +985,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.authenticate(RequestParams.stub(), topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } } From 9ee72aeb42d6689ed1c883b1c7814e6f310edb47 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 12:33:56 +0300 Subject: [PATCH 117/814] update sign tests --- Example/IntegrationTests/Sign/SignClientTests.swift | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index a4c75dcf4..58ad5381d 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -769,10 +769,10 @@ final class SignClientTests: XCTestCase { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() - let Siwemessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + let siweMessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) let signature = try signer.sign( - message: Siwemessage, + message: siweMessage, privateKey: prvKey, type: .eip191) @@ -827,6 +827,8 @@ final class SignClientTests: XCTestCase { dapp.authResponsePublisher.sink { (_, result) in guard case .success(let session) = result else { XCTFail(); return } XCTAssertEqual(session.accounts.count, 2) + XCTAssertEqual(session.namespaces["eip155"]?.methods.count, 2) + XCTAssertEqual(session.namespaces["eip155"]?.accounts.count, 2) responseExpectation.fulfill() } .store(in: &publishers) From 353628dde10377423cfa2bf1a5eba4300878a61c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 12:37:56 +0300 Subject: [PATCH 118/814] savepoint --- Example/IntegrationTests/Sign/SignClientTests.swift | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 58ad5381d..fe3fd0fdd 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -902,7 +902,7 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } - func testUserRespondError() async { + func testSessionAuthenticateUserRespondError() async { let responseExpectation = expectation(description: "error response delivered") dapp.enableAuthenticatedSessions() let uri = try! await dappPairingClient.create() @@ -955,7 +955,6 @@ final class SignClientTests: XCTestCase { guard case .success(let session) = result else { XCTFail(); return } Task(priority: .high) { - sleep(1) let request = Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) try await dapp.request(params: request) } From 34f6822e52fdcdd2a20e892f30fe1d4efe011bc1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jan 2024 13:31:53 +0300 Subject: [PATCH 119/814] remove auth target --- Example/ExampleApp.xcodeproj/project.pbxproj | 14 ----- .../Auth/Signer/CacaoSignerTests.swift | 14 +++-- .../Auth/Signer/EIP1271VerifierTests.swift | 2 +- .../Auth/Signer/EIP191VerifierTests.swift | 1 - .../Auth/Signer/SignerTests.swift | 2 +- .../Pairing/PairingTests.swift | 51 ++----------------- .../Stubs/RequestParams.swift | 48 ++++++++--------- .../Web3Wallet/XPlatformW3WTests.swift | 13 ----- Example/Shared/DefaultBIP44Provider.swift | 2 +- Example/Shared/DefaultCryptoProvider.swift | 2 +- Example/Shared/DefaultSignerFactory.swift | 2 +- Package.swift | 12 +---- .../SignDecryptionService.swift | 24 +++++++++ Sources/Web3Wallet/Web3Wallet.swift | 2 - .../Web3Wallet/Web3WalletClientFactory.swift | 1 - .../Web3WalletDecryptionService.swift | 18 +++---- Sources/Web3Wallet/Web3WalletImports.swift | 1 - 17 files changed, 74 insertions(+), 135 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 90639185b..ba2ebdae6 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -49,7 +49,6 @@ 84CEC64628D89D6B00D081A8 /* PairingTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CEC64528D89D6B00D081A8 /* PairingTests.swift */; }; 84D2A66628A4F51E0088AE09 /* AuthTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84D2A66528A4F51E0088AE09 /* AuthTests.swift */; }; 84DB38F32983CDAE00BFEE37 /* PushRegisterer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */; }; - 84DDB4ED28ABB663003D66ED /* WalletConnectAuth in Frameworks */ = {isa = PBXBuildFile; productRef = 84DDB4EC28ABB663003D66ED /* WalletConnectAuth */; }; 84E6B84A29787A8000428BAF /* NotificationService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84E6B84929787A8000428BAF /* NotificationService.swift */; }; 84E6B84E29787A8000428BAF /* PNDecryptionService.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 84E6B84729787A8000428BAF /* PNDecryptionService.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; }; 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84FE684528ACDB4700C893FF /* RequestParams.swift */; }; @@ -265,7 +264,6 @@ C56EE275293F56D7004840D1 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE25D293F56D6004840D1 /* InputConfig.swift */; }; C56EE276293F56D7004840D1 /* UIViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE26C293F56D6004840D1 /* UIViewController.swift */; }; C56EE279293F56D7004840D1 /* Color.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE268293F56D6004840D1 /* Color.swift */; }; - C56EE27B293F56F8004840D1 /* WalletConnectAuth in Frameworks */ = {isa = PBXBuildFile; productRef = C56EE27A293F56F8004840D1 /* WalletConnectAuth */; }; C56EE288293F5757004840D1 /* ThirdPartyConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE286293F5757004840D1 /* ThirdPartyConfigurator.swift */; }; C56EE289293F5757004840D1 /* Application.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE280293F5757004840D1 /* Application.swift */; }; C56EE28A293F5757004840D1 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE27F293F5757004840D1 /* AppDelegate.swift */; }; @@ -768,7 +766,6 @@ A5E03DF52864651200888481 /* Starscream in Frameworks */, A50DF19D2A25084A0036EA6C /* WalletConnectHistory in Frameworks */, A5C8BE85292FE20B006CC85C /* Web3 in Frameworks */, - 84DDB4ED28ABB663003D66ED /* WalletConnectAuth in Frameworks */, C5DD5BE1294E09E3008FD3A4 /* Web3Wallet in Frameworks */, A5B6C0F32A6EAB1700927332 /* WalletConnectNotify in Frameworks */, A573C53B29EC365800E3CBFD /* HDWalletKit in Frameworks */, @@ -789,7 +786,6 @@ A5F1526F2ACDC46B00D745A6 /* Web3ModalUI in Frameworks */, C56EE255293F569A004840D1 /* Starscream in Frameworks */, A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */, - C56EE27B293F56F8004840D1 /* WalletConnectAuth in Frameworks */, C54C24902AEB1B5600DA4BF6 /* WalletConnectRouter in Frameworks */, 84943C7D2A9BA328007EBAC2 /* Mixpanel in Frameworks */, ); @@ -2100,7 +2096,6 @@ A5E03DF42864651200888481 /* Starscream */, A5E03DFE2864662500888481 /* WalletConnect */, A5E03E00286466EA00888481 /* WalletConnectChat */, - 84DDB4EC28ABB663003D66ED /* WalletConnectAuth */, A5C8BE84292FE20B006CC85C /* Web3 */, C5DD5BE0294E09E3008FD3A4 /* Web3Wallet */, A561C80429DFCD4500DF540D /* WalletConnectSync */, @@ -2129,7 +2124,6 @@ name = WalletApp; packageProductDependencies = ( C56EE254293F569A004840D1 /* Starscream */, - C56EE27A293F56F8004840D1 /* WalletConnectAuth */, C5133A77294125CC00A8314C /* Web3 */, C55D349829630D440004314A /* Web3Wallet */, C5B2F7042970573D000DBA0E /* SolanaSwift */, @@ -3436,10 +3430,6 @@ package = 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */; productName = Mixpanel; }; - 84DDB4EC28ABB663003D66ED /* WalletConnectAuth */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectAuth; - }; A50DF19C2A25084A0036EA6C /* WalletConnectHistory */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectHistory; @@ -3576,10 +3566,6 @@ package = A5D85224286333D500DAF5C3 /* XCRemoteSwiftPackageReference "Starscream" */; productName = Starscream; }; - C56EE27A293F56F8004840D1 /* WalletConnectAuth */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectAuth; - }; C579FEB52AFA86CD008855EB /* Web3Modal */ = { isa = XCSwiftPackageProductDependency; package = A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */; diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index 342278e68..b910042a0 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -1,6 +1,9 @@ import Foundation import XCTest -@testable import Auth +@testable import WalletConnectUtils +@testable import WalletConnectSigner +@testable import WalletConnectSign + class CacaoSignerTest: XCTestCase { @@ -29,7 +32,7 @@ class CacaoSignerTest: XCTestCase { let payload = AuthPayload(requestParams: RequestParams( domain: "service.invalid", - chainId: "eip155:1", + chains: ["eip155:1"], nonce: "32891756", aud: "https://service.invalid/login", nbf: nil, @@ -39,14 +42,15 @@ class CacaoSignerTest: XCTestCase { resources: [ "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json" - ] + ], + methods: nil ), iat: "2021-09-30T16:25:24Z") let signature = CacaoSignature(t: .eip191, s: "0x2755a5cf4542e8649fadcfca8c983068ef3bda6057550ecd1ead32b75125a4547ed8e91ef76ef17e969434ffa4ac2e4dc1e8cd8be55d342ad9e223c64fbfe1dd1b") func testCacaoSign() throws { - let address = "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - let cacaoPayload = try payload.cacaoPayload(address: address) + let account = Account("eip155:1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2")! + let cacaoPayload = try payload.cacaoPayload(account: account) let formatted = try SIWECacaoFormatter().formatMessage(from: cacaoPayload) XCTAssertEqual(formatted, message) XCTAssertEqual(try signer.sign(payload: cacaoPayload, privateKey: privateKey, type: .eip191), signature) diff --git a/Example/IntegrationTests/Auth/Signer/EIP1271VerifierTests.swift b/Example/IntegrationTests/Auth/Signer/EIP1271VerifierTests.swift index 4bf4fba1b..c04236342 100644 --- a/Example/IntegrationTests/Auth/Signer/EIP1271VerifierTests.swift +++ b/Example/IntegrationTests/Auth/Signer/EIP1271VerifierTests.swift @@ -1,6 +1,6 @@ import Foundation import XCTest -@testable import Auth +@testable import WalletConnectUtils @testable import WalletConnectSigner import JSONRPC diff --git a/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift b/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift index ae565315c..60d087340 100644 --- a/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift +++ b/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift @@ -1,6 +1,5 @@ import Foundation import XCTest -@testable import Auth @testable import WalletConnectSigner class EIP191VerifierTests: XCTestCase { diff --git a/Example/IntegrationTests/Auth/Signer/SignerTests.swift b/Example/IntegrationTests/Auth/Signer/SignerTests.swift index 8f6381237..1828ff5ee 100644 --- a/Example/IntegrationTests/Auth/Signer/SignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/SignerTests.swift @@ -1,6 +1,6 @@ import Foundation import XCTest -@testable import Auth +@testable import WalletConnectUtils import WalletConnectRelay class SignerTest: XCTestCase { diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 657530902..7ddc36068 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -5,25 +5,19 @@ import XCTest import WalletConnectRelay import Combine import WalletConnectNetworking -import WalletConnectPush -@testable import Auth @testable import WalletConnectPairing -@testable import WalletConnectSync -@testable import WalletConnectHistory +import WalletConnectSign final class PairingTests: XCTestCase { var appPairingClient: PairingClient! var walletPairingClient: PairingClient! - var appAuthClient: AuthClient! - var walletAuthClient: AuthClient! - var pairingStorage: PairingStorage! private var publishers = [AnyCancellable]() - func makeClients(prefix: String, includeAuth: Bool = true) -> (PairingClient, AuthClient?) { + func makeClient(prefix: String, includeSign: Bool = true) -> PairingClient { let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() @@ -50,30 +44,12 @@ final class PairingTests: XCTestCase { networkingClient: networkingClient) - let clientId = try! networkingClient.getClientId() - logger.debug("My client id is: \(clientId)") - - if includeAuth { - let authClient = AuthClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), - projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - logger: logger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient, - pairingRegisterer: pairingClient, - iatProvider: IATProviderMock()) - - return (pairingClient, authClient) - } else { - return (pairingClient, nil) - } + return pairingClient } override func setUp() { - (appPairingClient, appAuthClient) = makeClients(prefix: "🤖 Dapp: ") - (walletPairingClient, _) = makeClients(prefix: "🐶 Wallet: ", includeAuth: false) + appPairingClient = makeClient(prefix: "🤖 Dapp: ") + walletPairingClient = makeClient(prefix: "🐶 Wallet: ", includeSign: false) } func testPing() async { @@ -89,23 +65,6 @@ final class PairingTests: XCTestCase { wait(for: [expectation], timeout: InputConfig.defaultTimeout) } - func testResponseErrorForMethodUnregistered() async { - let expectation = expectation(description: "wallet responds unsupported method for unregistered method") - - appAuthClient.authResponsePublisher.sink { (_, response) in - XCTAssertEqual(response, .failure(AuthError(code: 10001)!)) - expectation.fulfill() - }.store(in: &publishers) - - let uri = try! await appPairingClient.create() - - try! await walletPairingClient.pair(uri: uri) - - try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) - - wait(for: [expectation], timeout: InputConfig.defaultTimeout) - } - func testDisconnect() async { let expectation = expectation(description: "wallet disconnected pairing") diff --git a/Example/IntegrationTests/Stubs/RequestParams.swift b/Example/IntegrationTests/Stubs/RequestParams.swift index 5c1a30db4..457c9300b 100644 --- a/Example/IntegrationTests/Stubs/RequestParams.swift +++ b/Example/IntegrationTests/Stubs/RequestParams.swift @@ -1,24 +1,24 @@ -import Foundation -@testable import Auth - -extension RequestParams { - static func stub(domain: String = "service.invalid", - chainId: String = "eip155:1", - nonce: String = "32891756", - aud: String = "https://service.invalid/login", - nbf: String? = nil, - exp: String? = nil, - statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", - requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"]) -> RequestParams { - return RequestParams(domain: domain, - chainId: chainId, - nonce: nonce, - aud: aud, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources) - } -} +//import Foundation +//@testable import WalletConnectUtils +// +//extension RequestParams { +// static func stub(domain: String = "service.invalid", +// chainId: String = "eip155:1", +// nonce: String = "32891756", +// aud: String = "https://service.invalid/login", +// nbf: String? = nil, +// exp: String? = nil, +// statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", +// requestId: String? = nil, +// resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"]) -> RequestParams { +// return RequestParams(domain: domain, +// chainId: chainId, +// nonce: nonce, +// aud: aud, +// nbf: nbf, +// exp: exp, +// statement: statement, +// requestId: requestId, +// resources: resources) +// } +//} diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index bb58ade4a..13b6df3ce 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -2,7 +2,6 @@ import Foundation import XCTest import Combine @testable import Web3Wallet -@testable import Auth @testable import WalletConnectSign @testable import WalletConnectPush @@ -60,19 +59,7 @@ final class XPlatformW3WTests: XCTestCase { crypto: DefaultCryptoProvider() ) - let authClient = AuthClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), - projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - logger: authLogger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient, - pairingRegisterer: pairingClient, - iatProvider: DefaultIATProvider()) - w3wClient = Web3WalletClientFactory.create( - authClient: authClient, signClient: signClient, pairingClient: pairingClient, pushClient: PushClientMock()) diff --git a/Example/Shared/DefaultBIP44Provider.swift b/Example/Shared/DefaultBIP44Provider.swift index 5aed02650..86cc2ff54 100644 --- a/Example/Shared/DefaultBIP44Provider.swift +++ b/Example/Shared/DefaultBIP44Provider.swift @@ -1,8 +1,8 @@ import Foundation -import Auth import Web3 import CryptoSwift import HDWalletKit +import WalletConnectSigner struct DefaultBIP44Provider: BIP44Provider { diff --git a/Example/Shared/DefaultCryptoProvider.swift b/Example/Shared/DefaultCryptoProvider.swift index 3baf2b7e9..d8b270bc2 100644 --- a/Example/Shared/DefaultCryptoProvider.swift +++ b/Example/Shared/DefaultCryptoProvider.swift @@ -1,8 +1,8 @@ import Foundation -import Auth import Web3 import CryptoSwift import HDWalletKit +import WalletConnectSigner struct DefaultCryptoProvider: CryptoProvider { diff --git a/Example/Shared/DefaultSignerFactory.swift b/Example/Shared/DefaultSignerFactory.swift index 133094d00..8748a4aff 100644 --- a/Example/Shared/DefaultSignerFactory.swift +++ b/Example/Shared/DefaultSignerFactory.swift @@ -1,7 +1,7 @@ import Foundation import CryptoSwift import Web3 -import Auth +import WalletConnectSigner public struct DefaultSignerFactory: SignerFactory { diff --git a/Package.swift b/Package.swift index 561a5aeac..de3e24acd 100644 --- a/Package.swift +++ b/Package.swift @@ -16,9 +16,6 @@ let package = Package( .library( name: "WalletConnectChat", targets: ["WalletConnectChat"]), - .library( - name: "WalletConnectAuth", - targets: ["Auth"]), .library( name: "Web3Wallet", targets: ["Web3Wallet"]), @@ -64,13 +61,9 @@ let package = Package( name: "WalletConnectChat", dependencies: ["WalletConnectIdentity", "WalletConnectSync", "WalletConnectHistory"], path: "Sources/Chat"), - .target( - name: "Auth", - dependencies: ["WalletConnectPairing", "WalletConnectSigner", "WalletConnectVerify"], - path: "Sources/Auth"), .target( name: "Web3Wallet", - dependencies: ["Auth", "WalletConnectSign", "WalletConnectPush", "WalletConnectVerify"], + dependencies: ["WalletConnectSign", "WalletConnectPush", "WalletConnectVerify"], path: "Sources/Web3Wallet"), .target( name: "WalletConnectNotify", @@ -160,9 +153,6 @@ let package = Package( .testTarget( name: "NotifyTests", dependencies: ["WalletConnectNotify", "TestingUtils"]), - .testTarget( - name: "AuthTests", - dependencies: ["Auth", "WalletConnectUtils", "TestingUtils", "WalletConnectVerify"]), .testTarget( name: "RelayerTests", dependencies: ["WalletConnectRelay", "WalletConnectUtils", "TestingUtils"]), diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index 8b0e82125..01ce80fcf 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -7,6 +7,7 @@ public class SignDecryptionService { } private let serializer: Serializing private let sessionStorage: WCSessionStorage + private let pairingStorage: PairingStorage public init(groupIdentifier: String) throws { let keychainStorage = GroupKeychainStorage(serviceIdentifier: groupIdentifier) @@ -16,6 +17,7 @@ public class SignDecryptionService { throw Errors.couldNotInitialiseDefaults } sessionStorage = SessionStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: SignStorageIdentifiers.sessions.rawValue))) + pairingStorage = PairingStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: PairStorageIdentifiers.pairings.rawValue))) } public func decryptProposal(topic: String, ciphertext: String) throws -> Session.Proposal { @@ -46,7 +48,29 @@ public class SignDecryptionService { } } + public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthenticationRequest { + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + setPairingMetadata(rpcRequest: rpcRequest, topic: topic) + if let params = try rpcRequest.params?.get(SessionAuthenticateRequestParams.self), + let id = rpcRequest.id { + let authRequest = AuthenticationRequest(id: id, topic: topic, payload: params.authPayload, requester: params.requester.metadata) + return authRequest + } else { + throw Errors.couldNotDecodeTypeFromCiphertext + } + } + public func getMetadata(topic: String) -> AppMetadata? { sessionStorage.getSession(forTopic: topic)?.peerParticipant.metadata } + + private func setPairingMetadata(rpcRequest: RPCRequest, topic: String) { + guard var pairing = pairingStorage.getPairing(forTopic: topic), + pairing.peerMetadata == nil, + let peerMetadata = try? rpcRequest.params?.get(SessionAuthenticateRequestParams.self).requester.metadata + else { return } + + pairing.updatePeerMetadata(peerMetadata) + pairingStorage.setPairing(pairing) + } } diff --git a/Sources/Web3Wallet/Web3Wallet.swift b/Sources/Web3Wallet/Web3Wallet.swift index a00f42b4b..c23e65e72 100644 --- a/Sources/Web3Wallet/Web3Wallet.swift +++ b/Sources/Web3Wallet/Web3Wallet.swift @@ -24,7 +24,6 @@ public class Web3Wallet { fatalError("Error - you must call Web3Wallet.configure(_:) before accessing the shared instance.") } return Web3WalletClientFactory.create( - authClient: Auth.instance, signClient: Sign.instance, pairingClient: Pair.instance as! PairingClient, pushClient: Push.instance @@ -46,7 +45,6 @@ public class Web3Wallet { environment: APNSEnvironment = .production ) { Pair.configure(metadata: metadata) - Auth.configure(crypto: crypto) Push.configure(pushHost: pushHost, environment: environment) Web3Wallet.config = Web3Wallet.Config(crypto: crypto) } diff --git a/Sources/Web3Wallet/Web3WalletClientFactory.swift b/Sources/Web3Wallet/Web3WalletClientFactory.swift index a073a94b9..b8447dfeb 100644 --- a/Sources/Web3Wallet/Web3WalletClientFactory.swift +++ b/Sources/Web3Wallet/Web3WalletClientFactory.swift @@ -2,7 +2,6 @@ import Foundation public struct Web3WalletClientFactory { public static func create( - authClient: AuthClientProtocol, signClient: SignClientProtocol, pairingClient: PairingClientProtocol, pushClient: PushClientProtocol diff --git a/Sources/Web3Wallet/Web3WalletDecryptionService.swift b/Sources/Web3Wallet/Web3WalletDecryptionService.swift index e4786129f..ef7c6abb5 100644 --- a/Sources/Web3Wallet/Web3WalletDecryptionService.swift +++ b/Sources/Web3Wallet/Web3WalletDecryptionService.swift @@ -8,15 +8,13 @@ public final class Web3WalletDecryptionService { public enum RequestMethod: UInt { case sessionRequest = 1108 case sessionProposal = 1100 - case authRequest = 3000 + case authRequest = 1116 } private let signDecryptionService: SignDecryptionService - private let authDecryptionService: AuthDecryptionService - private static let w3wTags: [UInt] = [1108, 1100, 3000] + private static let w3wTags: [UInt] = [1108, 1100, 1116] public init(groupIdentifier: String) throws { - self.authDecryptionService = try AuthDecryptionService(groupIdentifier: groupIdentifier) self.signDecryptionService = try SignDecryptionService(groupIdentifier: groupIdentifier) } @@ -25,11 +23,7 @@ public final class Web3WalletDecryptionService { } public func getMetadata(topic: String) -> AppMetadata? { - if let metadata = signDecryptionService.getMetadata(topic: topic) { - return metadata - } else { - return authDecryptionService.getMetadata(topic: topic) - } + signDecryptionService.getMetadata(topic: topic) } public func decryptMessage(topic: String, ciphertext: String, tag: UInt) throws -> DecryptedPayloadProtocol { @@ -42,8 +36,8 @@ public final class Web3WalletDecryptionService { let request = try signDecryptionService.decryptRequest(topic: topic, ciphertext: ciphertext) return RequestPayload(request: request) case .authRequest: - let request = try authDecryptionService.decryptAuthRequest(topic: topic, ciphertext: ciphertext) - return AuthRequestPayload(authRequest: request) + let authRequest = try signDecryptionService.decryptAuthRequest(topic: topic, ciphertext: ciphertext) + return AuthRequestPayload(authRequest: authRequest) } } @@ -66,5 +60,5 @@ public struct ProposalPayload: DecryptedPayloadProtocol { public struct AuthRequestPayload: DecryptedPayloadProtocol { public var requestMethod: Web3WalletDecryptionService.RequestMethod { .authRequest } - public var authRequest: AuthRequest + public var authRequest: AuthenticationRequest } diff --git a/Sources/Web3Wallet/Web3WalletImports.swift b/Sources/Web3Wallet/Web3WalletImports.swift index f2626dea0..d5390a7f7 100644 --- a/Sources/Web3Wallet/Web3WalletImports.swift +++ b/Sources/Web3Wallet/Web3WalletImports.swift @@ -1,5 +1,4 @@ #if !CocoaPods -@_exported import Auth @_exported import WalletConnectSign @_exported import WalletConnectPush @_exported import WalletConnectVerify From c2b4a222e1d8aeffd76bfc823eb695ceabe45126 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 09:38:44 +0300 Subject: [PATCH 120/814] fix wallet app --- .../ApplicationLayer/SceneDelegate.swift | 1 - .../AuthRequest/AuthRequestInteractor.swift | 18 +++++++++--------- .../Wallet/AuthRequest/AuthRequestModule.swift | 2 +- .../AuthRequest/AuthRequestPresenter.swift | 4 ++-- .../ConnectionDetailsInteractor.swift | 2 +- .../ConnectionDetailsPresenter.swift | 1 - .../ConnectionDetailsRouter.swift | 2 +- .../Wallet/Main/MainInteractor.swift | 2 +- .../Wallet/Main/MainRouter.swift | 2 +- .../Wallet/AuthRequestSubscriber.swift | 4 ++-- Sources/Web3Wallet/Web3Wallet.swift | 1 + 11 files changed, 19 insertions(+), 20 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index c36e6b4f6..9f81be4ea 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -1,4 +1,3 @@ -import Auth import SafariServices import UIKit import WalletConnectPairing diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift index 0657d6fd7..3e7f1ca86 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift @@ -17,7 +17,7 @@ final class AuthRequestInteractor { var auths = [AuthObject]() - request.payload.chains.forEach { chain in + try request.payload.chains.forEach { chain in let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) @@ -28,14 +28,14 @@ final class AuthRequestInteractor { - let auth = Web3Wallet.instance.makeAuthObject(authRequest: request, signature: signature, account: account) + let auth = try Web3Wallet.instance.makeAuthObject(authRequest: request, signature: signature, account: account) auths.append(auth) } - try await Web3Wallet.instance.respond(requestId: request.id, signature: auths) + try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) /* Redirect */ if let uri = request.requester.redirect?.native { @@ -46,19 +46,19 @@ final class AuthRequestInteractor { } } - func reject(request: AuthRequest) async throws { - try await Web3Wallet.instance.reject(requestId: request.id) - + func reject(request: AuthenticationRequest) async throws { + try await Web3Wallet.instance.rejectSession(requestId: request.id) + /* Redirect */ if let uri = request.requester.redirect?.native { WalletConnectRouter.goBack(uri: uri) } } - func formatted(request: AuthRequest, account: Account) -> String { - return try! Web3Wallet.instance.formatMessage( + func formatted(request: AuthenticationRequest, account: Account) -> String { + return try! Web3Wallet.instance.formatAuthMessage( payload: request.payload, - address: account.address + account: account ) } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift index 3876cfeb7..773ad4134 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift @@ -4,7 +4,7 @@ import Web3Wallet final class AuthRequestModule { @discardableResult - static func create(app: Application, request: AuthRequest, importAccount: ImportAccount, context: VerifyContext?) -> UIViewController { + static func create(app: Application, request: AuthenticationRequest, importAccount: ImportAccount, context: VerifyContext?) -> UIViewController { let router = AuthRequestRouter(app: app) let interactor = AuthRequestInteractor(messageSigner: app.messageSigner) let presenter = AuthRequestPresenter(importAccount: importAccount, interactor: interactor, router: router, request: request, context: context) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index d9aa3125d..54f140215 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -8,7 +8,7 @@ final class AuthRequestPresenter: ObservableObject { private let router: AuthRequestRouter let importAccount: ImportAccount - let request: AuthRequest + let request: AuthenticationRequest let validationStatus: VerifyContext.ValidationStatus? var message: String { @@ -23,7 +23,7 @@ final class AuthRequestPresenter: ObservableObject { importAccount: ImportAccount, interactor: AuthRequestInteractor, router: AuthRequestRouter, - request: AuthRequest, + request: AuthenticationRequest, context: VerifyContext? ) { defer { setupInitialState() } diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift index 27e2cf3d1..320cf6d9f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift @@ -3,7 +3,7 @@ import Combine import Web3Wallet final class ConnectionDetailsInteractor { - var requestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { + var requestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { return Web3Wallet.instance.authRequestPublisher } diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift index 5312123a4..a9755e851 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift @@ -1,7 +1,6 @@ import UIKit import Combine -import Auth import Web3Wallet final class ConnectionDetailsPresenter: ObservableObject { diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsRouter.swift index 75dc5b76b..c80da797b 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsRouter.swift @@ -11,7 +11,7 @@ final class ConnectionDetailsRouter { self.app = app } - func present(request: AuthRequest, importAccount: ImportAccount, context: VerifyContext) { + func present(request: AuthenticationRequest, importAccount: ImportAccount, context: VerifyContext) { AuthRequestModule.create(app: app, request: request, importAccount: importAccount, context: context) .wrapToNavigationController() .present(from: viewController) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift index ecae96621..8b8c540b2 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift @@ -14,7 +14,7 @@ final class MainInteractor { return Web3Wallet.instance.sessionRequestPublisher } - var requestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { + var requestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { return Web3Wallet.instance.authRequestPublisher } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift index 211a1fc62..63c12c0be 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift @@ -37,7 +37,7 @@ final class MainRouter { .presentFullScreen(from: viewController, transparentBackground: true) } - func present(request: AuthRequest, importAccount: ImportAccount, context: VerifyContext?) { + func present(request: AuthenticationRequest, importAccount: ImportAccount, context: VerifyContext?) { AuthRequestModule.create(app: app, request: request, importAccount: importAccount, context: context) .presentFullScreen(from: viewController, transparentBackground: true) } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index 73b0df040..62120e568 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -35,8 +35,8 @@ class AuthRequestSubscriber { private func subscribeForRequest() { pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in - logger.debug("WalletRequestSubscriber: Received request") - + logger.debug("AuthRequestSubscriber: Received request") + pairingRegisterer.setReceived(pairingTopic: payload.topic) let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.authPayload, requester: payload.request.requester.metadata) diff --git a/Sources/Web3Wallet/Web3Wallet.swift b/Sources/Web3Wallet/Web3Wallet.swift index c23e65e72..f8614160c 100644 --- a/Sources/Web3Wallet/Web3Wallet.swift +++ b/Sources/Web3Wallet/Web3Wallet.swift @@ -46,6 +46,7 @@ public class Web3Wallet { ) { Pair.configure(metadata: metadata) Push.configure(pushHost: pushHost, environment: environment) + Sign.configure(crypto: crypto) Web3Wallet.config = Web3Wallet.Config(crypto: crypto) } } From 51c2ed3fc13ae45922533e676c66eb3ffa3845c9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 09:43:04 +0300 Subject: [PATCH 121/814] savepoint --- Example/DApp/Modules/Auth/AuthPresenter.swift | 1 - Example/DApp/SceneDelegate.swift | 1 - Example/ExampleApp.xcodeproj/project.pbxproj | 7 ------- 3 files changed, 9 deletions(-) diff --git a/Example/DApp/Modules/Auth/AuthPresenter.swift b/Example/DApp/Modules/Auth/AuthPresenter.swift index 8e01e32e6..7c5122681 100644 --- a/Example/DApp/Modules/Auth/AuthPresenter.swift +++ b/Example/DApp/Modules/Auth/AuthPresenter.swift @@ -1,7 +1,6 @@ import UIKit import Combine -import Auth final class AuthPresenter: ObservableObject { enum SigningState { diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index b9b49d56c..dd379bd5e 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -1,7 +1,6 @@ import UIKit import Web3Modal -import Auth import WalletConnectRelay import WalletConnectNetworking diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index ba2ebdae6..bd3097872 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -176,7 +176,6 @@ A5B6C0F32A6EAB1700927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F22A6EAB1700927332 /* WalletConnectNotify */; }; A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F42A6EAB2800927332 /* WalletConnectNotify */; }; A5B6C0F72A6EAB3200927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F62A6EAB3200927332 /* WalletConnectNotify */; }; - A5BB7FA328B6A50400707FC6 /* WalletConnectAuth in Frameworks */ = {isa = PBXBuildFile; productRef = A5BB7FA228B6A50400707FC6 /* WalletConnectAuth */; }; A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */; }; A5C2020B287D9DEE007E3188 /* WelcomeModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20206287D9DEE007E3188 /* WelcomeModule.swift */; }; A5C2020C287D9DEE007E3188 /* WelcomePresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20207287D9DEE007E3188 /* WelcomePresenter.swift */; }; @@ -721,7 +720,6 @@ A5D85228286333E300DAF5C3 /* Starscream in Frameworks */, 84943C7B2A9BA206007EBAC2 /* Mixpanel in Frameworks */, A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */, - A5BB7FA328B6A50400707FC6 /* WalletConnectAuth in Frameworks */, ); runOnlyForDeploymentPostprocessing = 0; }; @@ -1999,7 +1997,6 @@ packageProductDependencies = ( 8448F1D327E4726F0000B866 /* WalletConnect */, A5D85227286333E300DAF5C3 /* Starscream */, - A5BB7FA228B6A50400707FC6 /* WalletConnectAuth */, A54195A42934E83F0035AD19 /* Web3 */, A573C53829EC365000E3CBFD /* HDWalletKit */, 8487A9432A836C2A0003D5AF /* Sentry */, @@ -3516,10 +3513,6 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnectNotify; }; - A5BB7FA228B6A50400707FC6 /* WalletConnectAuth */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectAuth; - }; A5C8BE84292FE20B006CC85C /* Web3 */ = { isa = XCSwiftPackageProductDependency; package = A5AE354528A1A2AC0059AE8A /* XCRemoteSwiftPackageReference "Web3" */; From ff083de486b76c3879254b2a4c2c14432fd8de49 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 10:44:58 +0300 Subject: [PATCH 122/814] fix dapp keychain issue --- Example/DApp/DApp.entitlements | 10 ++++++++++ Example/DApp/SceneDelegate.swift | 2 +- Example/ExampleApp.xcodeproj/project.pbxproj | 4 ++++ 3 files changed, 15 insertions(+), 1 deletion(-) create mode 100644 Example/DApp/DApp.entitlements diff --git a/Example/DApp/DApp.entitlements b/Example/DApp/DApp.entitlements new file mode 100644 index 000000000..3396b33e2 --- /dev/null +++ b/Example/DApp/DApp.entitlements @@ -0,0 +1,10 @@ + + + + + com.apple.security.application-groups + + group.com.walletconnect.dapp + + + diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index b9b49d56c..b52f47555 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -12,7 +12,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { Networking.configure( - groupIdentifier: "group.com.walletconnect.sdk", + groupIdentifier: "group.com.walletconnect.dapp", projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 90639185b..f90232086 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -444,6 +444,7 @@ 84CE6453279FFE1100142511 /* Wallet.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = Wallet.entitlements; sourceTree = ""; }; 84CEC64528D89D6B00D081A8 /* PairingTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PairingTests.swift; sourceTree = ""; }; 84D2A66528A4F51E0088AE09 /* AuthTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthTests.swift; sourceTree = ""; }; + 84D72FC62B4692770057EAF3 /* DApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DApp.entitlements; sourceTree = ""; }; 84DB38F029828A7C00BFEE37 /* WalletApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletApp.entitlements; sourceTree = ""; }; 84DB38F129828A7F00BFEE37 /* PNDecryptionService.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = PNDecryptionService.entitlements; sourceTree = ""; }; 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PushRegisterer.swift; sourceTree = ""; }; @@ -972,6 +973,7 @@ 84CE641D27981DED00142511 /* DApp */ = { isa = PBXGroup; children = ( + 84D72FC62B4692770057EAF3 /* DApp.entitlements */, C5BE01E02AF692F80064FC88 /* ApplicationLayer */, C5BE02202AF7DDE70064FC88 /* Modules */, A5BB7FAB28B6AA7100707FC6 /* Common */, @@ -2860,6 +2862,7 @@ ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; + CODE_SIGN_ENTITLEMENTS = DApp/DApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 18; @@ -2895,6 +2898,7 @@ ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; + CODE_SIGN_ENTITLEMENTS = DApp/DApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 18; From 7bf53db302bebccbac004c9b3f2fcda0e13ca880 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 12:41:40 +0300 Subject: [PATCH 123/814] make methods a flat array --- .../Services/App/AppPairService.swift | 4 ++-- Sources/WalletConnectPairing/Types/WCPairing.swift | 2 +- Sources/WalletConnectUtils/WalletConnectURI.swift | 10 +++++----- Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift | 2 +- .../WalletConnectURITests.swift | 8 +++----- 5 files changed, 12 insertions(+), 14 deletions(-) diff --git a/Sources/WalletConnectPairing/Services/App/AppPairService.swift b/Sources/WalletConnectPairing/Services/App/AppPairService.swift index e206fd5ad..0c05d4e1a 100644 --- a/Sources/WalletConnectPairing/Services/App/AppPairService.swift +++ b/Sources/WalletConnectPairing/Services/App/AppPairService.swift @@ -4,7 +4,7 @@ actor AppPairService { private let networkingInteractor: NetworkInteracting private let kms: KeyManagementServiceProtocol private let pairingStorage: WCPairingStorage - private var registeredMethods: [[String]] = [] + private var registeredMethods: [String] = [] init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, pairingStorage: WCPairingStorage) { self.networkingInteractor = networkingInteractor @@ -13,7 +13,7 @@ actor AppPairService { } public func register(supportedMethods: [String]) async { - registeredMethods.append(supportedMethods) + registeredMethods = supportedMethods } func create() async throws -> WalletConnectURI { diff --git a/Sources/WalletConnectPairing/Types/WCPairing.swift b/Sources/WalletConnectPairing/Types/WCPairing.swift index 4a47615db..2eb41e06f 100644 --- a/Sources/WalletConnectPairing/Types/WCPairing.swift +++ b/Sources/WalletConnectPairing/Types/WCPairing.swift @@ -12,7 +12,7 @@ public struct WCPairing: SequenceObject { public private (set) var expiryDate: Date public private (set) var active: Bool public private (set) var requestReceived: Bool - public private (set) var methods: [[String]]? + public private (set) var methods: [String]? #if DEBUG public static var dateInitializer: () -> Date = Date.init diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index c2626e54e..96cd3db58 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -5,7 +5,7 @@ public struct WalletConnectURI: Equatable { public let version: String public let symKey: String public let relay: RelayProtocolOptions - public let methods: [[String]]? + public let methods: [String]? public var absoluteString: String { return "wc:\(topic)@\(version)?\(queryString)" @@ -16,7 +16,7 @@ public struct WalletConnectURI: Equatable { .addingPercentEncoding(withAllowedCharacters: .rfc3986) ?? absoluteString } - public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [[String]]) { + public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [String]) { self.version = "2" self.topic = topic self.symKey = symKey @@ -25,7 +25,7 @@ public struct WalletConnectURI: Equatable { } #if DEBUG - public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [[String]]? = nil) { + public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [String]? = nil) { self.version = "2" self.topic = topic self.symKey = symKey @@ -51,7 +51,7 @@ public struct WalletConnectURI: Equatable { let relayData = query?["relay-data"] let methodsString = query?["methods"] - let methods = methodsString?.components(separatedBy: "],[").map { $0.trimmingCharacters(in: CharacterSet(charactersIn: "[]")).components(separatedBy: ",") } + let methods = methodsString?.components(separatedBy: ",") self.version = version self.topic = topic @@ -74,7 +74,7 @@ public struct WalletConnectURI: Equatable { parts.append("relay-data=\(relayData)") } if let methods = methods { - let encodedMethods = methods.map { "[\($0.joined(separator: ","))]" }.joined(separator: ",") + let encodedMethods = methods.joined(separator: ",") parts.append("methods=\(encodedMethods)") } return parts.joined(separator: "&") diff --git a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift index 462a4cf7d..7a4a0eb63 100644 --- a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift +++ b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift @@ -4,7 +4,7 @@ import WalletConnectUtils extension WalletConnectURI { public static func stub(isController: Bool = false) -> WalletConnectURI { - let methods = [["wc_sessionPropose", "wc_sessionAuthenticated"], ["wc_authRequest"]] + let methods = ["wc_sessionPropose", "wc_sessionAuthenticated"] return WalletConnectURI( topic: String.generateTopic(), symKey: SymmetricKey().hexRepresentation, diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index b671cc233..6fde226be 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -6,12 +6,10 @@ private func stubURI(includeMethods: Bool = true) -> (uri: WalletConnectURI, str let symKey = Data.randomBytes(count: 32).toHexString() let protocolName = "irn" var uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)" - let methods = [["wc_sessionPropose", "wc_sessionAuthenticated"], ["wc_authRequest"]] + let methods = ["wc_sessionPropose", "wc_sessionAuthenticated"] if includeMethods { - let methodsString = methods - .map { $0.joined(separator: ",") } - .joined(separator: "],[") - uriString.append("&methods=[\(methodsString)]") + let methodsString = methods.joined(separator: ",") + uriString.append("&methods=\(methodsString)") } let uri = WalletConnectURI( topic: topic, From f3b410464526a48a39d43a0d9c73a9a112b6d1e5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 13:00:27 +0300 Subject: [PATCH 124/814] add connect method without topic --- .../WalletConnectSign/Sign/SignClient.swift | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index aac68283a..22ff466ad 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -214,6 +214,28 @@ public final class SignClient: SignClientProtocol { // MARK: - Public interface + /// For a dApp to propose a session to a wallet. + /// Function will create pairing and propose session or propose a session on existing pairing. + /// - Parameters: + /// - requiredNamespaces: required namespaces for a session + /// - Returns: Pairing URI that should be shared with responder out of bound. Common way is to present it as a QR code. Pairing URI will be nil if you are going to establish a session on existing Pairing and `topic` function parameter was provided. + public func connect( + requiredNamespaces: [String: ProposalNamespace], + optionalNamespaces: [String: ProposalNamespace]? = nil, + sessionProperties: [String: String]? = nil + ) async throws -> WalletConnectURI { + logger.debug("Connecting Application") + let pairingURI = try await pairingClient.create() + try await appProposeService.propose( + pairingTopic: pairingURI.topic, + namespaces: requiredNamespaces, + optionalNamespaces: optionalNamespaces, + sessionProperties: sessionProperties, + relay: RelayProtocolOptions(protocol: "irn", data: nil) + ) + return pairingURI + } + /// For a dApp to propose a session to a wallet. /// Function will propose a session on existing pairing. /// - Parameters: From 4bdfad9babb5e73d30390e1b2ecf8130933552e0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 13:21:37 +0300 Subject: [PATCH 125/814] authenticate method returns pairing uri --- .../Sign/SignClientTests.swift | 20 +++++------- .../WalletConnectPairing/PairingClient.swift | 8 ++--- .../PairingClientProtocol.swift | 1 - .../PairingInteracting.swift | 2 +- .../Services/App/AppPairService.swift | 9 ++---- .../WalletConnectSign/Sign/SignClient.swift | 31 ++++++++++++++----- .../WalletConnectUtils/WalletConnectURI.swift | 10 ------ 7 files changed, 36 insertions(+), 45 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index fe3fd0fdd..dc96d6457 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -789,9 +789,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() - try await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + let uri = try await dapp.authenticate(RequestParams.stub()) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -834,9 +832,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() - try await dapp.authenticate(RequestParams.stub(chains: ["eip155:1", "eip155:137"]), topic: uri.topic) + let uri = try await dapp.authenticate(RequestParams.stub(chains: ["eip155:1", "eip155:137"])) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -878,8 +874,7 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticateSignatureVerificationFailed() async { let responseExpectation = expectation(description: "error response delivered") - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() + let uri = try! await dapp.authenticate(RequestParams.stub()) try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) try? await walletPairingClient.pair(uri: uri) @@ -904,8 +899,8 @@ final class SignClientTests: XCTestCase { func testSessionAuthenticateUserRespondError() async { let responseExpectation = expectation(description: "error response delivered") - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() + let uri = try! await dapp.authenticate(RequestParams.stub()) + try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) try? await walletPairingClient.pair(uri: uri) @@ -982,9 +977,8 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) - dapp.enableAuthenticatedSessions() - let uri = try! await dappPairingClient.create() - try await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + let uri = try await dapp.authenticate(RequestParams.stub()) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 38cc4449d..2b183a640 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -89,12 +89,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient try await walletPairService.pair(uri) } - public func create() async throws -> WalletConnectURI { - return try await appPairService.create() - } - - public func register(supportedMethods: [String]) async { - await appPairService.register(supportedMethods: supportedMethods) + public func create(methods: [String]? = nil) async throws -> WalletConnectURI { + return try await appPairService.create(supportedMethods: methods) } public func activate(pairingTopic: String, peerMetadata: AppMetadata?) { diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index af7ee9567..7edd05b30 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -4,7 +4,6 @@ public protocol PairingClientProtocol { var logsPublisher: AnyPublisher {get} var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> {get} func pair(uri: WalletConnectURI) async throws - func register(supportedMethods: [String]) async func disconnect(topic: String) async throws func getPairings() -> [Pairing] } diff --git a/Sources/WalletConnectPairing/PairingInteracting.swift b/Sources/WalletConnectPairing/PairingInteracting.swift index b0eb2cd38..4e22bd20b 100644 --- a/Sources/WalletConnectPairing/PairingInteracting.swift +++ b/Sources/WalletConnectPairing/PairingInteracting.swift @@ -3,7 +3,7 @@ import Foundation public protocol PairingInteracting { func pair(uri: WalletConnectURI) async throws - func create() async throws -> WalletConnectURI + func create(methods: [String]?) async throws -> WalletConnectURI func getPairings() -> [Pairing] diff --git a/Sources/WalletConnectPairing/Services/App/AppPairService.swift b/Sources/WalletConnectPairing/Services/App/AppPairService.swift index 0c05d4e1a..0d9c4b4ba 100644 --- a/Sources/WalletConnectPairing/Services/App/AppPairService.swift +++ b/Sources/WalletConnectPairing/Services/App/AppPairService.swift @@ -4,7 +4,6 @@ actor AppPairService { private let networkingInteractor: NetworkInteracting private let kms: KeyManagementServiceProtocol private let pairingStorage: WCPairingStorage - private var registeredMethods: [String] = [] init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, pairingStorage: WCPairingStorage) { self.networkingInteractor = networkingInteractor @@ -12,16 +11,12 @@ actor AppPairService { self.pairingStorage = pairingStorage } - public func register(supportedMethods: [String]) async { - registeredMethods = supportedMethods - } - - func create() async throws -> WalletConnectURI { + func create(supportedMethods: [String]?) async throws -> WalletConnectURI { let topic = String.generateTopic() try await networkingInteractor.subscribe(topic: topic) let symKey = try! kms.createSymmetricKey(topic) let pairing = WCPairing(topic: topic) - let uri = WalletConnectURI(topic: topic, symKey: symKey.hexRepresentation, relay: pairing.relay, methods: registeredMethods) + let uri = WalletConnectURI(topic: topic, symKey: symKey.hexRepresentation, relay: pairing.relay, methods: supportedMethods) pairingStorage.setPairing(pairing) return uri } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 22ff466ad..50be5dee3 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -286,10 +286,31 @@ public final class SignClient: SignClientProtocol { // ) } - public func enableAuthenticatedSessions() { - registerMethods() - } + public func authenticate( + _ params: RequestParams + ) async throws -> WalletConnectURI { + let pairingURI = try await pairingClient.create() + logger.debug("Requesting Authentication on existing pairing") + try await appRequestService.request(params: params, topic: pairingURI.topic) + let testNamespace = [ + "eip155": ProposalNamespace( + chains: [ + Blockchain("eip155:1")!, + ], + methods: [ + "personal_sign", + ], events: [] + )] +// try await appProposeService.propose( +// pairingTopic: topic, +// namespaces: testNamespace, +// optionalNamespaces: nil, +// sessionProperties: nil, +// relay: RelayProtocolOptions(protocol: "irn", data: nil) +// ) + return pairingURI + } /// For a wallet to respond on authentication request /// - Parameters: @@ -516,8 +537,4 @@ public final class SignClient: SignClientProtocol { self?.socketConnectionStatusPublisherSubject.send(status) }.store(in: &publishers) } - - private func registerMethods() { - Task { await pairingClient.register(supportedMethods: [SessionProposeProtocolMethod().method, SessionAuthenticatedProtocolMethod().method])} - } } diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 96cd3db58..5676f00e2 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -16,15 +16,6 @@ public struct WalletConnectURI: Equatable { .addingPercentEncoding(withAllowedCharacters: .rfc3986) ?? absoluteString } - public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [String]) { - self.version = "2" - self.topic = topic - self.symKey = symKey - self.relay = relay - self.methods = methods - } - - #if DEBUG public init(topic: String, symKey: String, relay: RelayProtocolOptions, methods: [String]? = nil) { self.version = "2" self.topic = topic @@ -32,7 +23,6 @@ public struct WalletConnectURI: Equatable { self.relay = relay self.methods = methods } - #endif public init?(string: String) { guard let components = Self.parseURIComponents(from: string) else { From 4ac8956d5131b3fae13c48df72307ec7ed58fec9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jan 2024 14:24:03 +0300 Subject: [PATCH 126/814] add proposal namespaces builder --- .../Auth/Signer/CacaoSignerTests.swift | 2 +- .../Sign/SignClientTests.swift | 14 ++--- .../App/SessionAuthRequestService.swift | 2 +- .../Services/ProposalNamespaceBuilder.swift | 24 ++++++++ .../Auth/Types/AuthPayload.swift | 2 +- ...stParams.swift => AuthRequestParams.swift} | 8 +-- .../WalletConnectSign/Sign/SignClient.swift | 61 ++++++++----------- .../SIWEMessageFormatterTests.swift | 10 +-- .../Stub/AuthPayload.swift | 4 +- ...stParams.swift => AuthRequestParams.swift} | 6 +- 10 files changed, 72 insertions(+), 61 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift rename Sources/WalletConnectSign/Auth/Types/{RequestParams.swift => AuthRequestParams.swift} (93%) rename Tests/WalletConnectSignTests/Stub/{RequestParams.swift => AuthRequestParams.swift} (92%) diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index b910042a0..433fa2d52 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -30,7 +30,7 @@ class CacaoSignerTest: XCTestCase { - https://example.com/my-web2-claim.json """ - let payload = AuthPayload(requestParams: RequestParams( + let payload = AuthPayload(requestParams: AuthRequestParams( domain: "service.invalid", chains: ["eip155:1"], nonce: "32891756", diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index dc96d6457..caa73709d 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -789,7 +789,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let uri = try await dapp.authenticate(RequestParams.stub()) + let uri = try await dapp.authenticate(AuthRequestParams.stub()) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -832,7 +832,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let uri = try await dapp.authenticate(RequestParams.stub(chains: ["eip155:1", "eip155:137"])) + let uri = try await dapp.authenticate(AuthRequestParams.stub(chains: ["eip155:1", "eip155:137"])) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -874,8 +874,8 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticateSignatureVerificationFailed() async { let responseExpectation = expectation(description: "error response delivered") - let uri = try! await dapp.authenticate(RequestParams.stub()) - try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + let uri = try! await dapp.authenticate(AuthRequestParams.stub()) + try! await dapp.authenticate(AuthRequestParams.stub(), topic: uri.topic) try? await walletPairingClient.pair(uri: uri) wallet.authRequestPublisher.sink { [unowned self] (request, _) in @@ -899,9 +899,9 @@ final class SignClientTests: XCTestCase { func testSessionAuthenticateUserRespondError() async { let responseExpectation = expectation(description: "error response delivered") - let uri = try! await dapp.authenticate(RequestParams.stub()) + let uri = try! await dapp.authenticate(AuthRequestParams.stub()) - try! await dapp.authenticate(RequestParams.stub(), topic: uri.topic) + try! await dapp.authenticate(AuthRequestParams.stub(), topic: uri.topic) try? await walletPairingClient.pair(uri: uri) wallet.authRequestPublisher.sink { [unowned self] request in @@ -977,7 +977,7 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) - let uri = try await dapp.authenticate(RequestParams.stub()) + let uri = try await dapp.authenticate(AuthRequestParams.stub()) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 0ef9816a9..004abb53d 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -22,7 +22,7 @@ actor SessionAuthRequestService { self.iatProvader = iatProvader } - func request(params: RequestParams, topic: String) async throws { + func request(params: AuthRequestParams, topic: String) async throws { var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() diff --git a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift new file mode 100644 index 000000000..eb11fc983 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift @@ -0,0 +1,24 @@ +// + +import Foundation + +struct ProposalNamespaceBuilder { + + enum Errors: Error { + case unsupportedChain + } + + static func buildNamespace(from params: AuthRequestParams) throws -> [String: ProposalNamespace] { + let chains: Set = Set(params.chains.compactMap { Blockchain($0) }) + guard chains.allSatisfy({$0.namespace == "eip155"}) else { + throw Errors.unsupportedChain + } + let methods = Set(params.methods ?? []) + return [ + "eip155": ProposalNamespace( + chains: chains, + methods: methods, + events: [] + )] + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index 29f7dd8f1..080268660 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -15,7 +15,7 @@ public struct AuthPayload: Codable, Equatable { public let resources: [String]? - init(requestParams: RequestParams, iat: String) { + init(requestParams: AuthRequestParams, iat: String) { self.type = "caip122" self.chains = requestParams.chains self.domain = requestParams.domain diff --git a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift similarity index 93% rename from Sources/WalletConnectSign/Auth/Types/RequestParams.swift rename to Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift index 79338b1f0..10577251e 100644 --- a/Sources/WalletConnectSign/Auth/Types/RequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift @@ -4,7 +4,7 @@ import Foundation /// for details read CAIP-74 and EIP-4361 specs /// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-74.md /// https://eips.ethereum.org/EIPS/eip-4361 -public struct RequestParams { +public struct AuthRequestParams { public let domain: String public let chains: [String] public let nonce: String @@ -47,7 +47,7 @@ public struct RequestParams { #if DEBUG -extension RequestParams { +extension AuthRequestParams { static func stub(domain: String = "service.invalid", chains: [String] = ["eip155:1"], nonce: String = "32891756", @@ -57,8 +57,8 @@ extension RequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> RequestParams { - return RequestParams(domain: domain, + methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> AuthRequestParams { + return AuthRequestParams(domain: domain, chains: chains, nonce: nonce, aud: aud, diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 50be5dee3..951fc36cd 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -215,10 +215,10 @@ public final class SignClient: SignClientProtocol { // MARK: - Public interface /// For a dApp to propose a session to a wallet. - /// Function will create pairing and propose session or propose a session on existing pairing. + /// Function will create pairing and propose session. /// - Parameters: /// - requiredNamespaces: required namespaces for a session - /// - Returns: Pairing URI that should be shared with responder out of bound. Common way is to present it as a QR code. Pairing URI will be nil if you are going to establish a session on existing Pairing and `topic` function parameter was provided. + /// - Returns: Pairing URI that should be shared with responder out of bound. Common way is to present it as a QR code. public func connect( requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]? = nil, @@ -261,57 +261,44 @@ public final class SignClient: SignClientProtocol { //---------------------------------------AUTH----------------------------------- public func authenticate( - _ params: RequestParams, + _ params: AuthRequestParams, topic: String ) async throws { try pairingClient.validatePairingExistance(topic) + try pairingClient.validateMethodSupport(topic: topic, method: "wc_sessionAuthenticate") logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: topic) - let testNamespace = [ - "eip155": ProposalNamespace( - chains: [ - Blockchain("eip155:1")!, - ], - methods: [ - "personal_sign", - ], events: [] - )] -// try await appProposeService.propose( -// pairingTopic: topic, -// namespaces: testNamespace, -// optionalNamespaces: nil, -// sessionProperties: nil, -// relay: RelayProtocolOptions(protocol: "irn", data: nil) -// ) + let namespaces = try ProposalNamespaceBuilder.buildNamespace(from: params) + try await appProposeService.propose( + pairingTopic: topic, + namespaces: [:], + optionalNamespaces: namespaces, + sessionProperties: nil, + relay: RelayProtocolOptions(protocol: "irn", data: nil) + ) } public func authenticate( - _ params: RequestParams + _ params: AuthRequestParams ) async throws -> WalletConnectURI { - let pairingURI = try await pairingClient.create() + let pairingURI = try await pairingClient.create(methods: ["wc_sessionAuthenticate"]) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: pairingURI.topic) - let testNamespace = [ - "eip155": ProposalNamespace( - chains: [ - Blockchain("eip155:1")!, - ], - methods: [ - "personal_sign", - ], events: [] - )] -// try await appProposeService.propose( -// pairingTopic: topic, -// namespaces: testNamespace, -// optionalNamespaces: nil, -// sessionProperties: nil, -// relay: RelayProtocolOptions(protocol: "irn", data: nil) -// ) + let namespaces = try ProposalNamespaceBuilder.buildNamespace(from: params) + try await appProposeService.propose( + pairingTopic: pairingURI.topic, + namespaces: [:], + optionalNamespaces: namespaces, + sessionProperties: nil, + relay: RelayProtocolOptions(protocol: "irn", data: nil) + ) return pairingURI } + + /// For a wallet to respond on authentication request /// - Parameters: /// - requestId: authentication request id diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 5356b71ed..b5893b7e3 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -50,7 +50,7 @@ class SIWEMessageFormatterTests: XCTestCase { """ let message = try sut.formatMessage( from: AuthPayload.stub( - requestParams: RequestParams.stub(statement: nil) + requestParams: AuthRequestParams.stub(statement: nil) ).cacaoPayload(account: Account.stub()) ) XCTAssertEqual(message, expectedMessage) @@ -72,7 +72,7 @@ class SIWEMessageFormatterTests: XCTestCase { """ let message = try sut.formatMessage( from: AuthPayload.stub( - requestParams: RequestParams.stub(resources: nil)).cacaoPayload(account: Account.stub()) + requestParams: AuthRequestParams.stub(resources: nil)).cacaoPayload(account: Account.stub()) ) XCTAssertEqual(message, expectedMessage) } @@ -92,7 +92,7 @@ class SIWEMessageFormatterTests: XCTestCase { """ let message = try sut.formatMessage( from: AuthPayload.stub( - requestParams: RequestParams.stub(statement: nil, resources: nil)).cacaoPayload(account: Account.stub()) + requestParams: AuthRequestParams.stub(statement: nil, resources: nil)).cacaoPayload(account: Account.stub()) ) XCTAssertEqual(message, expectedMessage) } @@ -119,7 +119,7 @@ class SIWEMessageFormatterTests: XCTestCase { let payload = try AuthPayload.stub( - requestParams: RequestParams.stub(resources: [validRecapUrn]) + requestParams: AuthRequestParams.stub(resources: [validRecapUrn]) ).cacaoPayload(account: Account.stub()) let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) @@ -147,7 +147,7 @@ class SIWEMessageFormatterTests: XCTestCase { let payload = try AuthPayload.stub( - requestParams: RequestParams.stub(statement: nil,resources: [validRecapUrn]) + requestParams: AuthRequestParams.stub(statement: nil,resources: [validRecapUrn]) ).cacaoPayload(account: Account.stub()) let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) diff --git a/Tests/WalletConnectSignTests/Stub/AuthPayload.swift b/Tests/WalletConnectSignTests/Stub/AuthPayload.swift index 4517eefbf..a7f4dfc5c 100644 --- a/Tests/WalletConnectSignTests/Stub/AuthPayload.swift +++ b/Tests/WalletConnectSignTests/Stub/AuthPayload.swift @@ -2,7 +2,7 @@ import Foundation @testable import WalletConnectSign extension AuthPayload { - static func stub(requestParams: RequestParams = RequestParams.stub()) -> AuthPayload { + static func stub(requestParams: AuthRequestParams = AuthRequestParams.stub()) -> AuthPayload { AuthPayload(requestParams: requestParams, iat: "2021-09-30T16:25:24Z") } } @@ -10,6 +10,6 @@ extension AuthPayload { extension AuthPayload { static func stub(nonce: String) -> AuthPayload { let issueAt = ISO8601DateFormatter().string(from: Date()) - return AuthPayload(requestParams: RequestParams.stub(nonce: nonce), iat: issueAt) + return AuthPayload(requestParams: AuthRequestParams.stub(nonce: nonce), iat: issueAt) } } diff --git a/Tests/WalletConnectSignTests/Stub/RequestParams.swift b/Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift similarity index 92% rename from Tests/WalletConnectSignTests/Stub/RequestParams.swift rename to Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift index 89efc65c2..11ce6bafc 100644 --- a/Tests/WalletConnectSignTests/Stub/RequestParams.swift +++ b/Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift @@ -1,7 +1,7 @@ import Foundation @testable import WalletConnectSign -extension RequestParams { +extension AuthRequestParams { static func stub(domain: String = "service.invalid", chains: [String] = ["eip155:1"], nonce: String = "32891756", @@ -11,8 +11,8 @@ extension RequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = ["personal_sign"]) -> RequestParams { - return RequestParams(domain: domain, + methods: [String]? = ["personal_sign"]) -> AuthRequestParams { + return AuthRequestParams(domain: domain, chains: chains, nonce: nonce, aud: aud, From bae90e140c83fde96b1cb963a70f14be925ce0b3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Jan 2024 09:05:20 +0300 Subject: [PATCH 127/814] add method support validation for pairing --- Sources/WalletConnectPairing/PairingClient.swift | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 2b183a640..c45f412dc 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -2,6 +2,9 @@ import Foundation import Combine public class PairingClient: PairingRegisterer, PairingInteracting, PairingClientProtocol { + enum Errors: Error { + case pairingDoesNotSupportRequiredMethod + } public var pingResponsePublisher: AnyPublisher<(String), Never> { pingResponsePublisherSubject.eraseToAnyPublisher() } @@ -126,6 +129,15 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient _ = try pairingsProvider.getPairing(for: topic) } + public func validateMethodSupport(topic: String, method: String) throws { + _ = try pairingsProvider.getPairing(for: topic) + let pairing = pairingStorage.getPairing(forTopic: topic) + guard let methods = pairing?.methods, + methods.contains(method) else { + throw Errors.pairingDoesNotSupportRequiredMethod + } + } + public func register(method: ProtocolMethod) -> AnyPublisher, Never> { logger.debug("Pairing Client - registering for \(method.method)") return pairingRequestsSubscriber.subscribeForRequest(method) From 41f40e8a88da3a6d2b9c7c8978857ff7f478d849 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Jan 2024 09:16:27 +0300 Subject: [PATCH 128/814] savepoint --- .../Auth/Services/Wallet/AuthResponder.swift | 2 +- Sources/WalletConnectSign/Sign/SignClient.swift | 7 +++++-- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 421fe271f..8cc0d5dea 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -45,7 +45,7 @@ actor AuthResponder { self.sessionNamespaceBuilder = sessionNamespaceBuilder } - func respond(requestId: RPCID, auths: [AuthObject]) async throws { + func respond(requestId: RPCID, auths: [Cacao]) async throws { let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) let (responseTopic, responseKeys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 951fc36cd..dc172dfbc 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -260,12 +260,14 @@ public final class SignClient: SignClientProtocol { //---------------------------------------AUTH----------------------------------- + /// For a dApp to propose an authenticated session to a wallet. + /// Function will propose a session on existing pairing. public func authenticate( _ params: AuthRequestParams, topic: String ) async throws { try pairingClient.validatePairingExistance(topic) - try pairingClient.validateMethodSupport(topic: topic, method: "wc_sessionAuthenticate") + try pairingClient.validateMethodSupport(topic: topic, method: SessionAuthenticatedProtocolMethod().method) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: topic) @@ -279,10 +281,11 @@ public final class SignClient: SignClientProtocol { ) } + /// For a dApp to propose an authenticated session to a wallet. public func authenticate( _ params: AuthRequestParams ) async throws -> WalletConnectURI { - let pairingURI = try await pairingClient.create(methods: ["wc_sessionAuthenticate"]) + let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: pairingURI.topic) From 3cb8c40222c39135b278eaaf89a6e49ae43c2a62 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Jan 2024 14:18:13 +0300 Subject: [PATCH 129/814] quick auth integration into dapp --- Example/DApp/Modules/Auth/AuthPresenter.swift | 23 ++++++++++--------- Example/DApp/Modules/Auth/AuthView.swift | 6 ++--- Example/DApp/SceneDelegate.swift | 4 ++-- .../PairingInteracting.swift | 6 +++++ 4 files changed, 23 insertions(+), 16 deletions(-) diff --git a/Example/DApp/Modules/Auth/AuthPresenter.swift b/Example/DApp/Modules/Auth/AuthPresenter.swift index 7c5122681..36d2ffd85 100644 --- a/Example/DApp/Modules/Auth/AuthPresenter.swift +++ b/Example/DApp/Modules/Auth/AuthPresenter.swift @@ -1,11 +1,12 @@ import UIKit import Combine +import WalletConnectSign final class AuthPresenter: ObservableObject { enum SigningState { case none - case signed(Cacao) + case signed(Session) case error(Error) } @@ -55,10 +56,10 @@ final class AuthPresenter: ObservableObject { extension AuthPresenter { @MainActor private func setupInitialState() { - Auth.instance.authResponsePublisher.sink { [weak self] (_, result) in + Sign.instance.authResponsePublisher.sink { [weak self] (_, result) in switch result { - case .success(let cacao): - self?.signingState = .signed(cacao) + case .success(let session): + self?.signingState = .signed(session) self?.generateQR() self?.showSigningState.toggle() @@ -72,9 +73,8 @@ extension AuthPresenter { private func generateQR() { Task { @MainActor in - let uri = try! await Pair.instance.create() + let uri = try await Sign.instance.authenticate(.stub()) walletConnectUri = uri - try await Auth.instance.request(.stub(), topic: uri.topic) let qrCodeImage = QRCodeGenerator.generateQRCode(from: uri.absoluteString) DispatchQueue.main.async { self.qrCodeImageData = qrCodeImage.pngData() @@ -87,7 +87,7 @@ extension AuthPresenter { extension AuthPresenter: SceneViewModel {} // MARK: - Auth request stub -private extension RequestParams { +private extension AuthRequestParams { static func stub( domain: String = "service.invalid", chainId: String = "eip155:1", @@ -98,17 +98,18 @@ private extension RequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] - ) -> RequestParams { - return RequestParams( + ) -> AuthRequestParams { + return AuthRequestParams( domain: domain, - chainId: chainId, + chains: [chainId], nonce: nonce, aud: aud, nbf: nbf, exp: exp, statement: statement, requestId: requestId, - resources: resources + resources: resources, + methods: ["eth_sign", "personal_sign", "eth_signTypedData"] ) } } diff --git a/Example/DApp/Modules/Auth/AuthView.swift b/Example/DApp/Modules/Auth/AuthView.swift index 8e15bacc0..4d5698568 100644 --- a/Example/DApp/Modules/Auth/AuthView.swift +++ b/Example/DApp/Modules/Auth/AuthView.swift @@ -92,9 +92,9 @@ struct AuthView: View { .cornerRadius(16) .padding(.top, 16) - case .signed(let cacao): + case .signed(let session): HStack { - Text(cacao.p.iss.split(separator: ":").last ?? "") + Text(session.peer.name) .lineLimit(1) .truncationMode(.middle) .frame(width: 135) @@ -102,7 +102,7 @@ struct AuthView: View { .foregroundColor(Color(red: 0.89, green: 0.91, blue: 0.91)) Button { - UIPasteboard.general.string = String(cacao.p.iss.split(separator: ":").last ?? "") + UIPasteboard.general.string = try? String(session.peer.description) } label: { Image("copy") .resizable() diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 89c920b9b..a81591a89 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -15,8 +15,8 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) - Auth.configure(crypto: DefaultCryptoProvider()) - + Sign.configure(crypto: DefaultCryptoProvider()) + let metadata = AppMetadata( name: "Swift Dapp", description: "WalletConnect DApp sample", diff --git a/Sources/WalletConnectPairing/PairingInteracting.swift b/Sources/WalletConnectPairing/PairingInteracting.swift index 4e22bd20b..7db1ccd47 100644 --- a/Sources/WalletConnectPairing/PairingInteracting.swift +++ b/Sources/WalletConnectPairing/PairingInteracting.swift @@ -17,3 +17,9 @@ public protocol PairingInteracting { func cleanup() throws #endif } + +public extension PairingInteracting { + func create() async throws -> WalletConnectURI { + return try await create(methods: nil) + } +} From 6e392ccfda9e6c8522870854f2a917b27a287086 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Jan 2024 17:06:00 +0300 Subject: [PATCH 130/814] display session on session authenticate --- Example/DApp/Modules/Sign/SignPresenter.swift | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index b42d2663c..a31c4abab 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -106,6 +106,14 @@ extension SignPresenter { self.accountsDetails.removeAll() } .store(in: &subscriptions) + + Sign.instance.sessionsPublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] _ in + self.router.dismiss() + self.getSession() + } + .store(in: &subscriptions) } private func getSession() { From 595abcd1e4ad6583f7d8c0c67b2896e08b43b018 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 14:26:19 +0300 Subject: [PATCH 131/814] integrate session authenticate --- Example/DApp/Modules/Auth/AuthPresenter.swift | 2 +- Example/DApp/Modules/Sign/SignPresenter.swift | 22 ++++++++++++------- Example/DApp/Modules/Sign/SignRouter.swift | 2 +- Example/DApp/Modules/Sign/SignView.swift | 17 ++++++++++++-- 4 files changed, 31 insertions(+), 12 deletions(-) diff --git a/Example/DApp/Modules/Auth/AuthPresenter.swift b/Example/DApp/Modules/Auth/AuthPresenter.swift index 36d2ffd85..048bcc480 100644 --- a/Example/DApp/Modules/Auth/AuthPresenter.swift +++ b/Example/DApp/Modules/Auth/AuthPresenter.swift @@ -87,7 +87,7 @@ extension AuthPresenter { extension AuthPresenter: SceneViewModel {} // MARK: - Auth request stub -private extension AuthRequestParams { +extension AuthRequestParams { static func stub( domain: String = "service.invalid", chainId: String = "eip155:1", diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index a31c4abab..301faf4b5 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -53,19 +53,25 @@ final class SignPresenter: ObservableObject { } @MainActor - func connectWalletWithSign() { + func connectWalletWithSessionPropose() { Task { - let uri = try await Pair.instance.create() - walletConnectUri = uri - try await Sign.instance.connect( + walletConnectUri = try await Sign.instance.connect( requiredNamespaces: Proposal.requiredNamespaces, - optionalNamespaces: Proposal.optionalNamespaces, - topic: uri.topic + optionalNamespaces: Proposal.optionalNamespaces ) - router.presentNewPairing(walletConnectUri: uri) + router.presentNewPairing(walletConnectUri: walletConnectUri!) } } - + + @MainActor + func connectWalletWithSessionAuthenticate() { + Task { + let uri = try await Sign.instance.authenticate(.stub()) + walletConnectUri = uri + router.presentNewPairing(walletConnectUri: walletConnectUri!) + } + } + func disconnect() { if let session { Task { @MainActor in diff --git a/Example/DApp/Modules/Sign/SignRouter.swift b/Example/DApp/Modules/Sign/SignRouter.swift index 60da1928c..912537011 100644 --- a/Example/DApp/Modules/Sign/SignRouter.swift +++ b/Example/DApp/Modules/Sign/SignRouter.swift @@ -22,7 +22,7 @@ final class SignRouter { SessionAccountModule.create(app: app, sessionAccount: sessionAccount, session: session) .present(from: viewController) } - + func dismissNewPairing() { newPairingViewController?.dismiss() } diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index fc60a1754..ac7699f4d 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -32,9 +32,22 @@ struct SignView: View { .padding(.top, 20) Button { - presenter.connectWalletWithSign() + presenter.connectWalletWithSessionPropose() } label: { - Text("Connect with Sign API") + Text("Connect Session Propose") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + .padding(.top, 10) + + Button { + presenter.connectWalletWithSessionAuthenticate() + } label: { + Text("Connect Session Authenticate") .font(.system(size: 16, weight: .semibold)) .foregroundColor(.white) .padding(.horizontal, 16) From 321b0bb4aedf11aef943191fc15bcc2e4539ded8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 14:46:53 +0300 Subject: [PATCH 132/814] savepoint --- .../DApp/Modules/Auth/AuthInteractor.swift | 3 - Example/DApp/Modules/Auth/AuthModule.swift | 16 -- Example/DApp/Modules/Auth/AuthPresenter.swift | 116 --------------- Example/DApp/Modules/Auth/AuthRouter.swift | 16 -- Example/DApp/Modules/Auth/AuthView.swift | 140 ------------------ Example/DApp/Modules/Main/MainModule.swift | 26 ++-- Example/DApp/Modules/Main/MainPresenter.swift | 11 +- Example/DApp/Modules/Main/MainRouter.swift | 4 - .../Modules/Main/MainViewController.swift | 2 +- Example/DApp/Modules/Sign/SignPresenter.swift | 30 ++++ Example/ExampleApp.xcodeproj/project.pbxproj | 28 ---- 11 files changed, 46 insertions(+), 346 deletions(-) delete mode 100644 Example/DApp/Modules/Auth/AuthInteractor.swift delete mode 100644 Example/DApp/Modules/Auth/AuthModule.swift delete mode 100644 Example/DApp/Modules/Auth/AuthPresenter.swift delete mode 100644 Example/DApp/Modules/Auth/AuthRouter.swift delete mode 100644 Example/DApp/Modules/Auth/AuthView.swift diff --git a/Example/DApp/Modules/Auth/AuthInteractor.swift b/Example/DApp/Modules/Auth/AuthInteractor.swift deleted file mode 100644 index ffddc61dd..000000000 --- a/Example/DApp/Modules/Auth/AuthInteractor.swift +++ /dev/null @@ -1,3 +0,0 @@ -import Foundation - -final class AuthInteractor {} diff --git a/Example/DApp/Modules/Auth/AuthModule.swift b/Example/DApp/Modules/Auth/AuthModule.swift deleted file mode 100644 index 9252f89e3..000000000 --- a/Example/DApp/Modules/Auth/AuthModule.swift +++ /dev/null @@ -1,16 +0,0 @@ -import SwiftUI - -final class AuthModule { - @discardableResult - static func create(app: Application) -> UIViewController { - let router = AuthRouter(app: app) - let interactor = AuthInteractor() - let presenter = AuthPresenter(interactor: interactor, router: router) - let view = AuthView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } -} diff --git a/Example/DApp/Modules/Auth/AuthPresenter.swift b/Example/DApp/Modules/Auth/AuthPresenter.swift deleted file mode 100644 index 048bcc480..000000000 --- a/Example/DApp/Modules/Auth/AuthPresenter.swift +++ /dev/null @@ -1,116 +0,0 @@ -import UIKit -import Combine -import WalletConnectSign - - -final class AuthPresenter: ObservableObject { - enum SigningState { - case none - case signed(Session) - case error(Error) - } - - private let interactor: AuthInteractor - private let router: AuthRouter - - @Published var qrCodeImageData: Data? - @Published var signingState = SigningState.none - @Published var showSigningState = false - - private var walletConnectUri: WalletConnectURI? - - private var subscriptions = Set() - - init( - interactor: AuthInteractor, - router: AuthRouter - ) { - defer { - Task { - await setupInitialState() - } - } - self.interactor = interactor - self.router = router - } - - func onAppear() { - generateQR() - } - - func copyUri() { - UIPasteboard.general.string = walletConnectUri?.absoluteString - } - - func connectWallet() { - if let walletConnectUri { - let walletUri = URL(string: "walletapp://wc?uri=\(walletConnectUri.deeplinkUri.removingPercentEncoding!)")! - DispatchQueue.main.async { - UIApplication.shared.open(walletUri) - } - } - } -} - -// MARK: - Private functions -extension AuthPresenter { - @MainActor - private func setupInitialState() { - Sign.instance.authResponsePublisher.sink { [weak self] (_, result) in - switch result { - case .success(let session): - self?.signingState = .signed(session) - self?.generateQR() - self?.showSigningState.toggle() - - case .failure(let error): - self?.signingState = .error(error) - self?.showSigningState.toggle() - } - } - .store(in: &subscriptions) - } - - private func generateQR() { - Task { @MainActor in - let uri = try await Sign.instance.authenticate(.stub()) - walletConnectUri = uri - let qrCodeImage = QRCodeGenerator.generateQRCode(from: uri.absoluteString) - DispatchQueue.main.async { - self.qrCodeImageData = qrCodeImage.pngData() - } - } - } -} - -// MARK: - SceneViewModel -extension AuthPresenter: SceneViewModel {} - -// MARK: - Auth request stub -extension AuthRequestParams { - static func stub( - domain: String = "service.invalid", - chainId: String = "eip155:1", - nonce: String = "32891756", - aud: String = "https://service.invalid/login", - nbf: String? = nil, - exp: String? = nil, - statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", - requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] - ) -> AuthRequestParams { - return AuthRequestParams( - domain: domain, - chains: [chainId], - nonce: nonce, - aud: aud, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources, - methods: ["eth_sign", "personal_sign", "eth_signTypedData"] - ) - } -} - diff --git a/Example/DApp/Modules/Auth/AuthRouter.swift b/Example/DApp/Modules/Auth/AuthRouter.swift deleted file mode 100644 index 3caacfd38..000000000 --- a/Example/DApp/Modules/Auth/AuthRouter.swift +++ /dev/null @@ -1,16 +0,0 @@ -import UIKit - -final class AuthRouter { - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func dismiss() { - viewController.dismiss(animated: true) - UIApplication.shared.open(URL(string: "showcase://")!) - } -} diff --git a/Example/DApp/Modules/Auth/AuthView.swift b/Example/DApp/Modules/Auth/AuthView.swift deleted file mode 100644 index 4d5698568..000000000 --- a/Example/DApp/Modules/Auth/AuthView.swift +++ /dev/null @@ -1,140 +0,0 @@ -import SwiftUI - -struct AuthView: View { - @EnvironmentObject var presenter: AuthPresenter - - var body: some View { - NavigationStack { - ZStack { - Color(red: 25/255, green: 26/255, blue: 26/255) - .ignoresSafeArea() - - VStack { - ZStack { - RoundedRectangle(cornerRadius: 25) - .fill(.white) - .aspectRatio(1, contentMode: .fit) - .padding(20) - - if let data = presenter.qrCodeImageData { - let qrCodeImage = UIImage(data: data) ?? UIImage() - Image(uiImage: qrCodeImage) - .resizable() - .aspectRatio(1, contentMode: .fit) - .padding(40) - } - } - - Button { - presenter.connectWallet() - } label: { - Text("Connect Sample Wallet") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(Color(red: 95/255, green: 159/255, blue: 248/255)) - .cornerRadius(16) - } - - Button { - presenter.copyUri() - } label: { - HStack { - Image("copy") - Text("Copy link") - .font(.system(size: 14, weight: .semibold)) - .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - } - } - .padding(.top, 16) - - Spacer() - } - } - .navigationTitle("Auth") - .navigationBarTitleDisplayMode(.inline) - .toolbarColorScheme(.dark, for: .navigationBar) - .toolbarBackground(.visible, for: .navigationBar) - .toolbarBackground( - Color(red: 25/255, green: 26/255, blue: 26/255), - for: .navigationBar - ) - .onAppear { - presenter.onAppear() - } - .sheet(isPresented: $presenter.showSigningState) { - ZStack { - Color(red: 25/255, green: 26/255, blue: 26/255) - .ignoresSafeArea() - - VStack { - HStack { - RoundedRectangle(cornerRadius: 2) - .fill(.gray.opacity(0.5)) - .frame(width: 30, height: 4) - - } - .padding(20) - - Image("profile") - .resizable() - .frame(width: 64, height: 64) - - switch presenter.signingState { - case .error(let error): - Text(error.localizedDescription) - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(.green) - .cornerRadius(16) - .padding(.top, 16) - - case .signed(let session): - HStack { - Text(session.peer.name) - .lineLimit(1) - .truncationMode(.middle) - .frame(width: 135) - .font(.system(size: 24, weight: .semibold)) - .foregroundColor(Color(red: 0.89, green: 0.91, blue: 0.91)) - - Button { - UIPasteboard.general.string = try? String(session.peer.description) - } label: { - Image("copy") - .resizable() - .frame(width: 14, height: 14) - } - } - - Text("Authenticated") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(.green) - .cornerRadius(16) - .padding(.top, 16) - - case .none: - EmptyView() - } - - Spacer() - } - } - .presentationDetents([.medium]) - } - } - } -} - -struct AuthView_Previews: PreviewProvider { - static var previews: some View { - AuthView() - } -} - diff --git a/Example/DApp/Modules/Main/MainModule.swift b/Example/DApp/Modules/Main/MainModule.swift index 67a9d6060..77186401e 100644 --- a/Example/DApp/Modules/Main/MainModule.swift +++ b/Example/DApp/Modules/Main/MainModule.swift @@ -1,15 +1,15 @@ import SwiftUI -final class MainModule { - @discardableResult - static func create(app: Application) -> UIViewController { - let router = MainRouter(app: app) - let interactor = MainInteractor() - let presenter = MainPresenter(router: router, interactor: interactor) - let viewController = MainViewController(presenter: presenter) - - router.viewController = viewController - - return viewController - } -} +//final class MainModule { +// @discardableResult +// static func create(app: Application) -> UIViewController { +// let router = MainRouter(app: app) +// let interactor = MainInteractor() +// let presenter = MainPresenter(router: router, interactor: interactor) +// let viewController = MainViewController(presenter: presenter) +// +// router.viewController = viewController +// +// return viewController +// } +//} diff --git a/Example/DApp/Modules/Main/MainPresenter.swift b/Example/DApp/Modules/Main/MainPresenter.swift index c3c7d47ee..a28b3c2bc 100644 --- a/Example/DApp/Modules/Main/MainPresenter.swift +++ b/Example/DApp/Modules/Main/MainPresenter.swift @@ -6,15 +6,8 @@ final class MainPresenter { private let router: MainRouter private var disposeBag = Set() - var tabs: [TabPage] { - return TabPage.allCases - } - - var viewControllers: [UIViewController] { - return [ - router.signViewController(), - router.authViewController() - ] + var viewController: UIViewController { + return router.signViewController() } init(router: MainRouter, interactor: MainInteractor) { diff --git a/Example/DApp/Modules/Main/MainRouter.swift b/Example/DApp/Modules/Main/MainRouter.swift index 4b3fef3de..c2a15b9c1 100644 --- a/Example/DApp/Modules/Main/MainRouter.swift +++ b/Example/DApp/Modules/Main/MainRouter.swift @@ -12,8 +12,4 @@ final class MainRouter { func signViewController() -> UIViewController { return SignModule.create(app: app) } - - func authViewController() -> UIViewController { - return AuthModule.create(app: app) - } } diff --git a/Example/DApp/Modules/Main/MainViewController.swift b/Example/DApp/Modules/Main/MainViewController.swift index 539b2a789..2aca07ddc 100644 --- a/Example/DApp/Modules/Main/MainViewController.swift +++ b/Example/DApp/Modules/Main/MainViewController.swift @@ -21,7 +21,7 @@ final class MainViewController: UITabBarController { } private func setupTabs() { - let viewControllers = presenter.viewControllers + let viewController = presenter.viewController for (index, viewController) in viewControllers.enumerated() { let model = presenter.tabs[index] diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 301faf4b5..499fcc79f 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -142,3 +142,33 @@ extension SignPresenter { // MARK: - SceneViewModel extension SignPresenter: SceneViewModel {} + + +// MARK: - Auth request stub +extension AuthRequestParams { + static func stub( + domain: String = "service.invalid", + chainId: String = "eip155:1", + nonce: String = "32891756", + aud: String = "https://service.invalid/login", + nbf: String? = nil, + exp: String? = nil, + statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", + requestId: String? = nil, + resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] + ) -> AuthRequestParams { + return AuthRequestParams( + domain: domain, + chains: [chainId], + nonce: nonce, + aud: aud, + nbf: nbf, + exp: exp, + statement: statement, + requestId: requestId, + resources: resources, + methods: ["eth_sign", "personal_sign", "eth_signTypedData"] + ) + } +} + diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index f4756a4a0..28bb94fd8 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -286,12 +286,7 @@ C5B2F7052970573D000DBA0E /* SolanaSwift in Frameworks */ = {isa = PBXBuildFile; productRef = C5B2F7042970573D000DBA0E /* SolanaSwift */; }; C5B2F71029705827000DBA0E /* EthereumTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84F568C32795832A00D0A289 /* EthereumTransaction.swift */; }; C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5B4C4C32AF11C8B00B4274A /* SignView.swift */; }; - C5B4C4CF2AF12F1600B4274A /* AuthView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5B4C4CE2AF12F1600B4274A /* AuthView.swift */; }; C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01D02AF661D70064FC88 /* NewPairingView.swift */; }; - C5BE01D72AF691CD0064FC88 /* AuthModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01D62AF691CD0064FC88 /* AuthModule.swift */; }; - C5BE01D92AF691FE0064FC88 /* AuthPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01D82AF691FE0064FC88 /* AuthPresenter.swift */; }; - C5BE01DB2AF692060064FC88 /* AuthRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01DA2AF692060064FC88 /* AuthRouter.swift */; }; - C5BE01DD2AF692100064FC88 /* AuthInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01DC2AF692100064FC88 /* AuthInteractor.swift */; }; C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */ = {isa = PBXBuildFile; productRef = C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */; }; C5BE01E22AF693080064FC88 /* Application.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01E12AF693080064FC88 /* Application.swift */; }; C5BE01E32AF696540064FC88 /* SceneViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE264293F56D6004840D1 /* SceneViewController.swift */; }; @@ -645,12 +640,7 @@ C5B2F6F42970511B000DBA0E /* SessionRequestInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionRequestInteractor.swift; sourceTree = ""; }; C5B2F6F52970511B000DBA0E /* SessionRequestView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionRequestView.swift; sourceTree = ""; }; C5B4C4C32AF11C8B00B4274A /* SignView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignView.swift; sourceTree = ""; }; - C5B4C4CE2AF12F1600B4274A /* AuthView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthView.swift; sourceTree = ""; }; C5BE01D02AF661D70064FC88 /* NewPairingView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingView.swift; sourceTree = ""; }; - C5BE01D62AF691CD0064FC88 /* AuthModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthModule.swift; sourceTree = ""; }; - C5BE01D82AF691FE0064FC88 /* AuthPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthPresenter.swift; sourceTree = ""; }; - C5BE01DA2AF692060064FC88 /* AuthRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRouter.swift; sourceTree = ""; }; - C5BE01DC2AF692100064FC88 /* AuthInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthInteractor.swift; sourceTree = ""; }; C5BE01E12AF693080064FC88 /* Application.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Application.swift; sourceTree = ""; }; C5BE01ED2AF6C9DF0064FC88 /* SignPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignPresenter.swift; sourceTree = ""; }; C5BE01EE2AF6C9DF0064FC88 /* SignModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignModule.swift; sourceTree = ""; }; @@ -1802,18 +1792,6 @@ path = Sign; sourceTree = ""; }; - C5B4C4CD2AF12F0B00B4274A /* Auth */ = { - isa = PBXGroup; - children = ( - C5BE01D62AF691CD0064FC88 /* AuthModule.swift */, - C5BE01D82AF691FE0064FC88 /* AuthPresenter.swift */, - C5BE01DA2AF692060064FC88 /* AuthRouter.swift */, - C5BE01DC2AF692100064FC88 /* AuthInteractor.swift */, - C5B4C4CE2AF12F1600B4274A /* AuthView.swift */, - ); - path = Auth; - sourceTree = ""; - }; C5BE01E02AF692F80064FC88 /* ApplicationLayer */ = { isa = PBXGroup; children = ( @@ -1872,7 +1850,6 @@ children = ( C5BE02062AF777AD0064FC88 /* Main */, C5B4C4C52AF12C2900B4274A /* Sign */, - C5B4C4CD2AF12F0B00B4274A /* Auth */, ); path = Modules; sourceTree = ""; @@ -2312,7 +2289,6 @@ files = ( C5BE021C2AF79B9A0064FC88 /* SessionAccountRouter.swift in Sources */, C5BE02102AF777AD0064FC88 /* MainModule.swift in Sources */, - C5BE01DD2AF692100064FC88 /* AuthInteractor.swift in Sources */, C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */, C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */, C5BE021E2AF79B9A0064FC88 /* SessionAccountView.swift in Sources */, @@ -2322,7 +2298,6 @@ C5BE020F2AF777AD0064FC88 /* TabPage.swift in Sources */, A5A8E47D293A1CFE00FEB97D /* DefaultSocketFactory.swift in Sources */, C5BE01E52AF697470064FC88 /* Color.swift in Sources */, - C5B4C4CF2AF12F1600B4274A /* AuthView.swift in Sources */, A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, C5BE02122AF777AD0064FC88 /* MainPresenter.swift in Sources */, @@ -2333,7 +2308,6 @@ A5A0843D29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, C5BE021F2AF79B9A0064FC88 /* SessionAccountModule.swift in Sources */, C5BE01E42AF697100064FC88 /* UIColor.swift in Sources */, - C5BE01DB2AF692060064FC88 /* AuthRouter.swift in Sources */, C5BE01E62AF697FA0064FC88 /* String.swift in Sources */, C5BE02012AF774CB0064FC88 /* NewPairingModule.swift in Sources */, C5BE02002AF774CB0064FC88 /* NewPairingRouter.swift in Sources */, @@ -2341,12 +2315,10 @@ C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */, 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */, C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */, - C5BE01D92AF691FE0064FC88 /* AuthPresenter.swift in Sources */, C5BE02112AF777AD0064FC88 /* MainViewController.swift in Sources */, C5BE021D2AF79B9A0064FC88 /* SessionAccountInteractor.swift in Sources */, A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, C5BE01FB2AF6CB270064FC88 /* SignRouter.swift in Sources */, - C5BE01D72AF691CD0064FC88 /* AuthModule.swift in Sources */, C5BE01F72AF6CB250064FC88 /* SignModule.swift in Sources */, C5BE01FA2AF6CB270064FC88 /* SignPresenter.swift in Sources */, C5BE02132AF777AD0064FC88 /* MainInteractor.swift in Sources */, From 12f6b70d3e3213de2cfd6e3966d08d3045039cef Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 14:48:36 +0300 Subject: [PATCH 133/814] remove tab view from dapp --- .../DApp/Modules/Main/MainInteractor.swift | 3 -- Example/DApp/Modules/Main/MainModule.swift | 15 ------- Example/DApp/Modules/Main/MainPresenter.swift | 25 ----------- Example/DApp/Modules/Main/MainRouter.swift | 15 ------- .../Modules/Main/MainViewController.swift | 43 ------------------- Example/DApp/Modules/Main/Model/TabPage.swift | 32 -------------- Example/DApp/SceneDelegate.swift | 2 +- Example/ExampleApp.xcodeproj/project.pbxproj | 40 ----------------- 8 files changed, 1 insertion(+), 174 deletions(-) delete mode 100644 Example/DApp/Modules/Main/MainInteractor.swift delete mode 100644 Example/DApp/Modules/Main/MainModule.swift delete mode 100644 Example/DApp/Modules/Main/MainPresenter.swift delete mode 100644 Example/DApp/Modules/Main/MainRouter.swift delete mode 100644 Example/DApp/Modules/Main/MainViewController.swift delete mode 100644 Example/DApp/Modules/Main/Model/TabPage.swift diff --git a/Example/DApp/Modules/Main/MainInteractor.swift b/Example/DApp/Modules/Main/MainInteractor.swift deleted file mode 100644 index a3954796d..000000000 --- a/Example/DApp/Modules/Main/MainInteractor.swift +++ /dev/null @@ -1,3 +0,0 @@ -import Foundation - -final class MainInteractor {} diff --git a/Example/DApp/Modules/Main/MainModule.swift b/Example/DApp/Modules/Main/MainModule.swift deleted file mode 100644 index 77186401e..000000000 --- a/Example/DApp/Modules/Main/MainModule.swift +++ /dev/null @@ -1,15 +0,0 @@ -import SwiftUI - -//final class MainModule { -// @discardableResult -// static func create(app: Application) -> UIViewController { -// let router = MainRouter(app: app) -// let interactor = MainInteractor() -// let presenter = MainPresenter(router: router, interactor: interactor) -// let viewController = MainViewController(presenter: presenter) -// -// router.viewController = viewController -// -// return viewController -// } -//} diff --git a/Example/DApp/Modules/Main/MainPresenter.swift b/Example/DApp/Modules/Main/MainPresenter.swift deleted file mode 100644 index a28b3c2bc..000000000 --- a/Example/DApp/Modules/Main/MainPresenter.swift +++ /dev/null @@ -1,25 +0,0 @@ -import UIKit -import Combine - -final class MainPresenter { - private let interactor: MainInteractor - private let router: MainRouter - private var disposeBag = Set() - - var viewController: UIViewController { - return router.signViewController() - } - - init(router: MainRouter, interactor: MainInteractor) { - defer { - setupInitialState() - } - self.router = router - self.interactor = interactor - } -} - -// MARK: - Private functions -extension MainPresenter { - private func setupInitialState() {} -} diff --git a/Example/DApp/Modules/Main/MainRouter.swift b/Example/DApp/Modules/Main/MainRouter.swift deleted file mode 100644 index c2a15b9c1..000000000 --- a/Example/DApp/Modules/Main/MainRouter.swift +++ /dev/null @@ -1,15 +0,0 @@ -import UIKit - -final class MainRouter { - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func signViewController() -> UIViewController { - return SignModule.create(app: app) - } -} diff --git a/Example/DApp/Modules/Main/MainViewController.swift b/Example/DApp/Modules/Main/MainViewController.swift deleted file mode 100644 index 2aca07ddc..000000000 --- a/Example/DApp/Modules/Main/MainViewController.swift +++ /dev/null @@ -1,43 +0,0 @@ -import UIKit -import Sentry - -enum LoginError: Error { - case wrongUser(id: String) - case wrongPassword -} - -final class MainViewController: UITabBarController { - - private let presenter: MainPresenter - - init(presenter: MainPresenter) { - self.presenter = presenter - super.init(nibName: nil, bundle: nil) - } - - override func viewDidLoad() { - super.viewDidLoad() - setupTabs() - } - - private func setupTabs() { - let viewController = presenter.viewController - - for (index, viewController) in viewControllers.enumerated() { - let model = presenter.tabs[index] - let item = UITabBarItem() - item.title = model.title - item.image = model.icon - item.isEnabled = TabPage.enabledTabs.contains(model) - viewController.tabBarItem = item - viewController.view.backgroundColor = .w_background - } - - self.viewControllers = viewControllers - self.selectedIndex = TabPage.selectedIndex - } - - required init?(coder: NSCoder) { - fatalError("init(coder:) has not been implemented") - } -} diff --git a/Example/DApp/Modules/Main/Model/TabPage.swift b/Example/DApp/Modules/Main/Model/TabPage.swift deleted file mode 100644 index faec2ba34..000000000 --- a/Example/DApp/Modules/Main/Model/TabPage.swift +++ /dev/null @@ -1,32 +0,0 @@ -import UIKit - -enum TabPage: CaseIterable { - case sign - case auth - - var title: String { - switch self { - case .sign: - return "Sign" - case .auth: - return "Auth" - } - } - - var icon: UIImage { - switch self { - case .sign: - return UIImage(named: "pen")! - case .auth: - return UIImage(named: "auth")! - } - } - - static var selectedIndex: Int { - return 0 - } - - static var enabledTabs: [TabPage] { - return [.sign, .auth] - } -} diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index a81591a89..c7b6bd403 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -37,7 +37,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { guard let windowScene = (scene as? UIWindowScene) else { return } window = UIWindow(windowScene: windowScene) - let viewController = MainModule.create(app: app) + let viewController = SignModule.create(app: app) window?.rootViewController = viewController window?.makeKeyAndVisible() diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 28bb94fd8..aca4efd6a 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -302,12 +302,6 @@ C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01F62AF6CA2B0064FC88 /* NewPairingInteractor.swift */; }; C5BE02032AF774CB0064FC88 /* NewPairingPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01F42AF6CA2B0064FC88 /* NewPairingPresenter.swift */; }; C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE26C293F56D6004840D1 /* UIViewController.swift */; }; - C5BE020E2AF777AD0064FC88 /* MainRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02082AF777AD0064FC88 /* MainRouter.swift */; }; - C5BE020F2AF777AD0064FC88 /* TabPage.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE020D2AF777AD0064FC88 /* TabPage.swift */; }; - C5BE02102AF777AD0064FC88 /* MainModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02072AF777AD0064FC88 /* MainModule.swift */; }; - C5BE02112AF777AD0064FC88 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE020A2AF777AD0064FC88 /* MainViewController.swift */; }; - C5BE02122AF777AD0064FC88 /* MainPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE020B2AF777AD0064FC88 /* MainPresenter.swift */; }; - C5BE02132AF777AD0064FC88 /* MainInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02092AF777AD0064FC88 /* MainInteractor.swift */; }; C5BE02142AF77A940064FC88 /* Colors.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C5F32A352954FE3C00A6476E /* Colors.xcassets */; }; C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02172AF79B950064FC88 /* SessionAccountPresenter.swift */; }; C5BE021C2AF79B9A0064FC88 /* SessionAccountRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02162AF79B950064FC88 /* SessionAccountRouter.swift */; }; @@ -650,12 +644,6 @@ C5BE01F42AF6CA2B0064FC88 /* NewPairingPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingPresenter.swift; sourceTree = ""; }; C5BE01F52AF6CA2B0064FC88 /* NewPairingModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingModule.swift; sourceTree = ""; }; C5BE01F62AF6CA2B0064FC88 /* NewPairingInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingInteractor.swift; sourceTree = ""; }; - C5BE02072AF777AD0064FC88 /* MainModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainModule.swift; sourceTree = ""; }; - C5BE02082AF777AD0064FC88 /* MainRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainRouter.swift; sourceTree = ""; }; - C5BE02092AF777AD0064FC88 /* MainInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainInteractor.swift; sourceTree = ""; }; - C5BE020A2AF777AD0064FC88 /* MainViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainViewController.swift; sourceTree = ""; }; - C5BE020B2AF777AD0064FC88 /* MainPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainPresenter.swift; sourceTree = ""; }; - C5BE020D2AF777AD0064FC88 /* TabPage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TabPage.swift; sourceTree = ""; }; C5BE02162AF79B950064FC88 /* SessionAccountRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountRouter.swift; sourceTree = ""; }; C5BE02172AF79B950064FC88 /* SessionAccountPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountPresenter.swift; sourceTree = ""; }; C5BE02182AF79B950064FC88 /* SessionAccountInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountInteractor.swift; sourceTree = ""; }; @@ -1812,27 +1800,6 @@ path = NewPairing; sourceTree = ""; }; - C5BE02062AF777AD0064FC88 /* Main */ = { - isa = PBXGroup; - children = ( - C5BE02072AF777AD0064FC88 /* MainModule.swift */, - C5BE020B2AF777AD0064FC88 /* MainPresenter.swift */, - C5BE02092AF777AD0064FC88 /* MainInteractor.swift */, - C5BE02082AF777AD0064FC88 /* MainRouter.swift */, - C5BE020A2AF777AD0064FC88 /* MainViewController.swift */, - C5BE020C2AF777AD0064FC88 /* Model */, - ); - path = Main; - sourceTree = ""; - }; - C5BE020C2AF777AD0064FC88 /* Model */ = { - isa = PBXGroup; - children = ( - C5BE020D2AF777AD0064FC88 /* TabPage.swift */, - ); - path = Model; - sourceTree = ""; - }; C5BE02152AF79B860064FC88 /* SessionAccount */ = { isa = PBXGroup; children = ( @@ -1848,7 +1815,6 @@ C5BE02202AF7DDE70064FC88 /* Modules */ = { isa = PBXGroup; children = ( - C5BE02062AF777AD0064FC88 /* Main */, C5B4C4C52AF12C2900B4274A /* Sign */, ); path = Modules; @@ -2288,23 +2254,19 @@ buildActionMask = 2147483647; files = ( C5BE021C2AF79B9A0064FC88 /* SessionAccountRouter.swift in Sources */, - C5BE02102AF777AD0064FC88 /* MainModule.swift in Sources */, C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */, C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */, C5BE021E2AF79B9A0064FC88 /* SessionAccountView.swift in Sources */, C5BE02032AF774CB0064FC88 /* NewPairingPresenter.swift in Sources */, 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */, C5BE01E32AF696540064FC88 /* SceneViewController.swift in Sources */, - C5BE020F2AF777AD0064FC88 /* TabPage.swift in Sources */, A5A8E47D293A1CFE00FEB97D /* DefaultSocketFactory.swift in Sources */, C5BE01E52AF697470064FC88 /* Color.swift in Sources */, A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, - C5BE02122AF777AD0064FC88 /* MainPresenter.swift in Sources */, C5BE01E22AF693080064FC88 /* Application.swift in Sources */, C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */, A5A8E47E293A1CFE00FEB97D /* DefaultSignerFactory.swift in Sources */, - C5BE020E2AF777AD0064FC88 /* MainRouter.swift in Sources */, A5A0843D29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, C5BE021F2AF79B9A0064FC88 /* SessionAccountModule.swift in Sources */, C5BE01E42AF697100064FC88 /* UIColor.swift in Sources */, @@ -2315,13 +2277,11 @@ C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */, 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */, C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */, - C5BE02112AF777AD0064FC88 /* MainViewController.swift in Sources */, C5BE021D2AF79B9A0064FC88 /* SessionAccountInteractor.swift in Sources */, A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, C5BE01FB2AF6CB270064FC88 /* SignRouter.swift in Sources */, C5BE01F72AF6CB250064FC88 /* SignModule.swift in Sources */, C5BE01FA2AF6CB270064FC88 /* SignPresenter.swift in Sources */, - C5BE02132AF777AD0064FC88 /* MainInteractor.swift in Sources */, ); runOnlyForDeploymentPostprocessing = 0; }; From cc7a1f54cecf581853a8d23c0886325fd89f2968 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 18:42:23 +0300 Subject: [PATCH 134/814] add pairingExpirationPublisher --- .../Wallet/Wallet/WalletPresenter.swift | 9 +++++---- Sources/WalletConnectPairing/PairingClient.swift | 3 +++ .../Services/Common/ExpirationService.swift | 9 +++++++++ Sources/Web3Wallet/Web3WalletClient.swift | 4 ++++ 4 files changed, 21 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 59d5c1fc2..9b69a567d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -110,7 +110,7 @@ extension WalletPresenter { Task.detached(priority: .high) { @MainActor [unowned self] in do { self.showPairingLoading = true - self.removePairingIndicator() + self.setUpPairingIndicatorRemoval(topic: uri.topic) try await self.interactor.pair(uri: uri) } catch { self.showPairingLoading = false @@ -127,10 +127,11 @@ extension WalletPresenter { pair(uri: uri) } - private func removePairingIndicator() { - DispatchQueue.main.asyncAfter(deadline: .now() + 3) { + private func setUpPairingIndicatorRemoval(topic: String) { + Pair.instance.pairingExpirationPublisher.sink { pairing in + guard pairing.topic == topic else {return} self.showPairingLoading = false - } + }.store(in: &disposeBag) } } diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 16d8f0076..b7506e915 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -10,6 +10,9 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient } public let socketConnectionStatusPublisher: AnyPublisher + public let pairingExpirationPublisher: AnyPublisher { + return expirationService.pairingExpirationPublisher + } private let pairingStorage: WCPairingStorage private let walletPairService: WalletPairService diff --git a/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift b/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift index 4a8850cbe..92d749e28 100644 --- a/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift +++ b/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift @@ -1,9 +1,14 @@ import Foundation +import Combine final class ExpirationService { private let pairingStorage: WCPairingStorage private let networkInteractor: NetworkInteracting private let kms: KeyManagementServiceProtocol + private let pairingExpirationPublisherSubject: PassthroughSubject = .init() + var pairingExpirationPublisher: AnyPublisher { + pairingExpirationPublisherSubject.eraseToAnyPublisher() + } init(pairingStorage: WCPairingStorage, networkInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol) { self.pairingStorage = pairingStorage @@ -15,6 +20,10 @@ final class ExpirationService { pairingStorage.onPairingExpiration = { [weak self] pairing in self?.kms.deleteSymmetricKey(for: pairing.topic) self?.networkInteractor.unsubscribe(topic: pairing.topic) + + DispatchQueue.main.async { + pairingExpirationPublisherSubject.send(Pairing(pairing)) + } } } } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 5b70a374a..85e660d42 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -67,6 +67,10 @@ public class Web3WalletClient { pairingClient.pairingDeletePublisher } + public let pairingExpirationPublisher: AnyPublisher { + return pairingClient.pairingExpirationPublisher + } + public var logsPublisher: AnyPublisher { return signClient.logsPublisher .merge(with: pairingClient.logsPublisher) From 0f3a29d35271cba1f3980f1e6b17dbb7dd9f70fe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 18:46:37 +0300 Subject: [PATCH 135/814] fix build --- .../PresentationLayer/Wallet/Wallet/WalletPresenter.swift | 4 ++-- Sources/WalletConnectPairing/PairingClient.swift | 2 +- Sources/WalletConnectPairing/PairingClientProtocol.swift | 1 + .../Services/Common/ExpirationService.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 5 files changed, 6 insertions(+), 5 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 9b69a567d..df8f27eb7 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -40,7 +40,7 @@ final class WalletPresenter: ObservableObject { func onAppear() { showPairingLoading = app.requestSent - removePairingIndicator() + showPairingLoading = false let pendingRequests = interactor.getPendingRequests() if let request = pendingRequests.first(where: { $0.context != nil }) { @@ -128,7 +128,7 @@ extension WalletPresenter { } private func setUpPairingIndicatorRemoval(topic: String) { - Pair.instance.pairingExpirationPublisher.sink { pairing in + Web3Wallet.instance.pairingExpirationPublisher.sink { pairing in guard pairing.topic == topic else {return} self.showPairingLoading = false }.store(in: &disposeBag) diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index b7506e915..20ee1cfce 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -10,7 +10,7 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient } public let socketConnectionStatusPublisher: AnyPublisher - public let pairingExpirationPublisher: AnyPublisher { + public var pairingExpirationPublisher: AnyPublisher { return expirationService.pairingExpirationPublisher } diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index 7edd05b30..5c5e539c2 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -3,6 +3,7 @@ import Combine public protocol PairingClientProtocol { var logsPublisher: AnyPublisher {get} var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> {get} + var pairingExpirationPublisher: AnyPublisher {get} func pair(uri: WalletConnectURI) async throws func disconnect(topic: String) async throws func getPairings() -> [Pairing] diff --git a/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift b/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift index 92d749e28..0df4caf7e 100644 --- a/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift +++ b/Sources/WalletConnectPairing/Services/Common/ExpirationService.swift @@ -22,7 +22,7 @@ final class ExpirationService { self?.networkInteractor.unsubscribe(topic: pairing.topic) DispatchQueue.main.async { - pairingExpirationPublisherSubject.send(Pairing(pairing)) + self?.pairingExpirationPublisherSubject.send(Pairing(pairing)) } } } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 85e660d42..72f1ec45a 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -67,7 +67,7 @@ public class Web3WalletClient { pairingClient.pairingDeletePublisher } - public let pairingExpirationPublisher: AnyPublisher { + public var pairingExpirationPublisher: AnyPublisher { return pairingClient.pairingExpirationPublisher } From 77c7472b03e35246855d11c7f3249a2a188ee0ca Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 18:52:15 +0300 Subject: [PATCH 136/814] remove loader on session request --- .../PresentationLayer/Wallet/Wallet/WalletPresenter.swift | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index df8f27eb7..e74cf5b68 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -126,12 +126,16 @@ extension WalletPresenter { } pair(uri: uri) } - + private func setUpPairingIndicatorRemoval(topic: String) { Web3Wallet.instance.pairingExpirationPublisher.sink { pairing in guard pairing.topic == topic else {return} self.showPairingLoading = false }.store(in: &disposeBag) + + Web3Wallet.instance.sessionRequestPublisher.sink { _ in + self.showPairingLoading = false + }.store(in: &disposeBag) } } From 300ecea0e2635942169da0d55b3c5d1b1c0e94d4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 6 Jan 2024 18:56:45 +0300 Subject: [PATCH 137/814] remove loader on session proposal --- .../PresentationLayer/Wallet/Wallet/WalletPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index e74cf5b68..3e73fa8aa 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -133,7 +133,7 @@ extension WalletPresenter { self.showPairingLoading = false }.store(in: &disposeBag) - Web3Wallet.instance.sessionRequestPublisher.sink { _ in + Web3Wallet.instance.sessionProposalPublisher.sink { _ in self.showPairingLoading = false }.store(in: &disposeBag) } From 916b52847b31c4f6104ec91b5ed84c697e93b52c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 7 Jan 2024 13:14:20 +0300 Subject: [PATCH 138/814] add expiry monitor for sequence store --- Sources/WalletConnectUtils/SequenceStore.swift | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Sources/WalletConnectUtils/SequenceStore.swift b/Sources/WalletConnectUtils/SequenceStore.swift index 618ba411e..94591af29 100644 --- a/Sources/WalletConnectUtils/SequenceStore.swift +++ b/Sources/WalletConnectUtils/SequenceStore.swift @@ -12,10 +12,13 @@ public final class SequenceStore where T: SequenceObject { private let store: CodableStore private let dateInitializer: () -> Date + private var expiryMonitorTimer: Timer? + public init(store: CodableStore, dateInitializer: @escaping () -> Date = Date.init) { self.store = store self.dateInitializer = dateInitializer + startExpiryMonitor() } public func hasSequence(forTopic topic: String) -> Bool { @@ -46,6 +49,19 @@ public final class SequenceStore where T: SequenceObject { store.deleteAll() onSequenceUpdate?() } + + // MARK: Expiry Monitor + + private func startExpiryMonitor() { + expiryMonitorTimer = Timer.scheduledTimer(withTimeInterval: 3.0, repeats: true) { [weak self] _ in + self?.checkAllSequencesForExpiry() + } + } + + private func checkAllSequencesForExpiry() { + let allSequences = getAll() + allSequences.forEach { _ = verifyExpiry(on: $0) } + } } // MARK: Privates From de0a0a0fabd289dd9967102679fa6dd566cbe93c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 7 Jan 2024 14:10:05 +0300 Subject: [PATCH 139/814] add pairing state publisher --- .../ApplicationLayer/SceneDelegate.swift | 4 +-- .../WalletConnectPairing/PairingClient.swift | 9 +++++- .../PairingClientFactory.swift | 4 ++- .../PairingClientProtocol.swift | 1 + .../Services/Common/PairingsProvider.swift | 29 +++++++++++++++++++ Sources/Web3Wallet/Web3WalletClient.swift | 4 +++ 6 files changed, 47 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index c36e6b4f6..c39e67513 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -1,7 +1,7 @@ import Auth import SafariServices import UIKit -import WalletConnectPairing +import Web3Wallet final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificationCenterDelegate { var window: UIWindow? @@ -44,7 +44,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio if let uri { Task { - try await Pair.instance.pair(uri: uri) + try await Web3Wallet.instance.pair(uri: uri) } } } diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 20ee1cfce..5637ba3e6 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -9,6 +9,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient pairingDeleteRequestSubscriber.deletePublisherSubject.eraseToAnyPublisher() } + public var pairingStatePublisher: AnyPublisher { + return pairingStateProvider.pairingStatePublisher + } + public let socketConnectionStatusPublisher: AnyPublisher public var pairingExpirationPublisher: AnyPublisher { return expirationService.pairingExpirationPublisher @@ -28,6 +32,7 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let resubscribeService: PairingResubscribeService private let expirationService: ExpirationService private let pairingDeleteRequestSubscriber: PairingDeleteRequestSubscriber + private let pairingStateProvider: PairingStateProvider private let cleanupService: PairingCleanupService @@ -50,7 +55,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient cleanupService: PairingCleanupService, pingService: PairingPingService, socketConnectionStatusPublisher: AnyPublisher, - pairingsProvider: PairingsProvider + pairingsProvider: PairingsProvider, + pairingStateProvider: PairingStateProvider ) { self.pairingStorage = pairingStorage self.appPairService = appPairService @@ -67,6 +73,7 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient self.pingService = pingService self.pairingRequestsSubscriber = pairingRequestsSubscriber self.pairingsProvider = pairingsProvider + self.pairingStateProvider = pairingStateProvider setUpPublishers() setUpExpiration() } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 902ba7d28..22840bed3 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -36,6 +36,7 @@ public struct PairingClientFactory { let expirationService = ExpirationService(pairingStorage: pairingStore, networkInteractor: networkingClient, kms: kms) let resubscribeService = PairingResubscribeService(networkInteractor: networkingClient, pairingStorage: pairingStore) let pairingDeleteRequestSubscriber = PairingDeleteRequestSubscriber(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) + let pairingStateProvider = PairingStateProvider(pairingStorage: pairingStore) return PairingClient( pairingStorage: pairingStore, @@ -52,7 +53,8 @@ public struct PairingClientFactory { cleanupService: cleanupService, pingService: pingService, socketConnectionStatusPublisher: networkingClient.socketConnectionStatusPublisher, - pairingsProvider: pairingsProvider + pairingsProvider: pairingsProvider, + pairingStateProvider: pairingStateProvider ) } } diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index 5c5e539c2..905c1b4e8 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -3,6 +3,7 @@ import Combine public protocol PairingClientProtocol { var logsPublisher: AnyPublisher {get} var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> {get} + var pairingStatePublisher: AnyPublisher {get} var pairingExpirationPublisher: AnyPublisher {get} func pair(uri: WalletConnectURI) async throws func disconnect(topic: String) async throws diff --git a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift index aa087a3c0..99cd02ca5 100644 --- a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift +++ b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift @@ -22,3 +22,32 @@ class PairingsProvider { return Pairing(pairing) } } + +import Combine +import Foundation + +class PairingStateProvider { + private let pairingStorage: WCPairingStorage + private var pairingStatePublisherSubject = PassthroughSubject() + private var checkTimer: Timer? + + public var pairingStatePublisher: AnyPublisher { + pairingStatePublisherSubject.eraseToAnyPublisher() + } + + public init(pairingStorage: WCPairingStorage) { + self.pairingStorage = pairingStorage + setupPairingStateCheckTimer() + } + + private func setupPairingStateCheckTimer() { + checkTimer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in + self?.checkPairingState() + } + } + + private func checkPairingState() { + let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active } + pairingStatePublisherSubject.send(pairingStateActive) + } +} diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 72f1ec45a..374d3f549 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -67,6 +67,10 @@ public class Web3WalletClient { pairingClient.pairingDeletePublisher } + public var pairingStatePublisher: AnyPublisher { + pairingClient.pairingStatePublisher + } + public var pairingExpirationPublisher: AnyPublisher { return pairingClient.pairingExpirationPublisher } From 6e07c1e4e12329396c26054beab5b440104cc1fc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 7 Jan 2024 14:19:38 +0300 Subject: [PATCH 140/814] integrate pairing publisher --- .../Wallet/Wallet/WalletPresenter.swift | 16 ++++------------ 1 file changed, 4 insertions(+), 12 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 3e73fa8aa..742e766d3 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -40,7 +40,7 @@ final class WalletPresenter: ObservableObject { func onAppear() { showPairingLoading = app.requestSent - showPairingLoading = false + setUpPairingIndicatorRemoval() let pendingRequests = interactor.getPendingRequests() if let request = pendingRequests.first(where: { $0.context != nil }) { @@ -109,11 +109,8 @@ extension WalletPresenter { private func pair(uri: WalletConnectURI) { Task.detached(priority: .high) { @MainActor [unowned self] in do { - self.showPairingLoading = true - self.setUpPairingIndicatorRemoval(topic: uri.topic) try await self.interactor.pair(uri: uri) } catch { - self.showPairingLoading = false self.errorMessage = error.localizedDescription self.showError.toggle() } @@ -127,14 +124,9 @@ extension WalletPresenter { pair(uri: uri) } - private func setUpPairingIndicatorRemoval(topic: String) { - Web3Wallet.instance.pairingExpirationPublisher.sink { pairing in - guard pairing.topic == topic else {return} - self.showPairingLoading = false - }.store(in: &disposeBag) - - Web3Wallet.instance.sessionProposalPublisher.sink { _ in - self.showPairingLoading = false + private func setUpPairingIndicatorRemoval() { + Web3Wallet.instance.pairingStatePublisher.sink { [weak self] isPairing in + self?.showPairingLoading = isPairing }.store(in: &disposeBag) } } From aff3a8a82ae6673a4383559f557e1f5de73a1b00 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 7 Jan 2024 14:42:42 +0300 Subject: [PATCH 141/814] remove inactive pairing on reject --- .../Engine/Common/ApproveEngine.swift | 15 +++++++++++++-- .../Sign/SignClientFactory.swift | 3 ++- 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 8c994c094..eca845a97 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -27,6 +27,7 @@ final class ApproveEngine { private let metadata: AppMetadata private let kms: KeyManagementServiceProtocol private let logger: ConsoleLogging + private let rpcHistory: RPCHistory private var publishers = Set() @@ -41,7 +42,8 @@ final class ApproveEngine { logger: ConsoleLogging, pairingStore: WCPairingStorage, sessionStore: WCSessionStorage, - verifyClient: VerifyClientProtocol + verifyClient: VerifyClientProtocol, + rpcHistory: RPCHistory ) { self.networkingInteractor = networkingInteractor self.proposalPayloadsStore = proposalPayloadsStore @@ -54,6 +56,7 @@ final class ApproveEngine { self.pairingStore = pairingStore self.sessionStore = sessionStore self.verifyClient = verifyClient + self.rpcHistory = rpcHistory setupRequestSubscriptions() setupResponseSubscriptions() @@ -125,10 +128,18 @@ final class ApproveEngine { guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { throw Errors.proposalPayloadsNotFound } + + if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, + let pairing = pairingStore.getPairing(forTopic: pairingTopic), + !pairing.active { + pairingStore.delete(topic: pairingTopic) + } + proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) + try await networkingInteractor.respondError(topic: payload.topic, requestId: payload.id, protocolMethod: SessionProposeProtocolMethod(), reason: reason) - // TODO: Delete pairing if inactive + } func settle(topic: String, proposal: SessionProposal, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil, pairingTopic: String) async throws { diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 1d9adf073..7970d88d5 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -61,7 +61,8 @@ public struct SignClientFactory { logger: logger, pairingStore: pairingStore, sessionStore: sessionStore, - verifyClient: verifyClient + verifyClient: verifyClient, + rpcHistory: rpcHistory ) let cleanupService = SignCleanupService(pairingStore: pairingStore, sessionStore: sessionStore, kms: kms, sessionTopicToProposal: sessionTopicToProposal, networkInteractor: networkingClient) let deleteSessionService = DeleteSessionService(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) From aa96d549a46de464e3d5ee9b0dc753384505e270 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 8 Jan 2024 08:38:16 +0300 Subject: [PATCH 142/814] message_id log --- Example/PNDecryptionService/NotificationService.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 474de9fd2..9fae80990 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -206,6 +206,7 @@ private extension NotificationService { Mixpanel.mainInstance().track( event: "💬 APNS: " + event, properties: [ + "message_id": message?.id, "title": message?.title, "body": message?.body, "icon": message?.icon, From 3b54b3d44f5a1920608995951386678500ee232e Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 8 Jan 2024 17:09:42 +0300 Subject: [PATCH 143/814] NotificationTypeImage --- .../Wallet/NotifySettings/NotifyPreferencesView.swift | 2 +- .../WalletConnectNotify/Client/Wallet/NotifyConfig.swift | 8 ++------ .../Client/Wallet/NotifyImageUrls.swift | 7 +++++++ .../Client/Wallet/NotifySubscriptionsBuilder.swift | 3 ++- .../Types/DataStructures/NotifySubscription.swift | 4 +++- 5 files changed, 15 insertions(+), 9 deletions(-) create mode 100644 Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift diff --git a/Example/WalletApp/PresentationLayer/Wallet/NotifySettings/NotifyPreferencesView.swift b/Example/WalletApp/PresentationLayer/Wallet/NotifySettings/NotifyPreferencesView.swift index 327c2b4d6..3cf67b63c 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/NotifySettings/NotifyPreferencesView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/NotifySettings/NotifyPreferencesView.swift @@ -53,7 +53,7 @@ struct NotifyPreferencesView: View { Toggle(isOn: .init(get: { viewModel.update[title]?.enabled ?? value.enabled }, set: { newValue in - viewModel.update[title] = ScopeValue(id: value.id, name: value.name, description: value.description, enabled: newValue) + viewModel.update[title] = ScopeValue(id: value.id, name: value.name, description: value.description, imageUrls: value.imageUrls, enabled: newValue) })) { VStack(alignment: .leading, spacing: 4) { Text(value.name) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift index f7b3a1dae..19c4333ac 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift @@ -5,18 +5,14 @@ struct NotifyConfig: Codable { let id: String let name: String let description: String - } - struct ImageUrl: Codable { - let sm: String? - let md: String? - let lg: String? + let imageUrls: NotifyImageUrls? } let id: String let name: String let homepage: String? let description: String let dapp_url: String - let image_url: ImageUrl? + let image_url: NotifyImageUrls? let notificationTypes: [NotificationType] var appDomain: String { diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift new file mode 100644 index 000000000..124dc1def --- /dev/null +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift @@ -0,0 +1,7 @@ +import Foundation + +public struct NotifyImageUrls: Codable, Equatable { + public let sm: String? + public let md: String? + public let lg: String? +} diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifySubscriptionsBuilder.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifySubscriptionsBuilder.swift index 0426ce460..0e0d21810 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifySubscriptionsBuilder.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifySubscriptionsBuilder.swift @@ -40,7 +40,8 @@ class NotifySubscriptionsBuilder { $0[$1.id] = ScopeValue( id: $1.id, name: $1.name, - description: $1.description, + description: $1.description, + imageUrls: $1.imageUrls, enabled: selectedScope.contains($1.id) ) } diff --git a/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift b/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift index a63ef14bb..0cc7f313e 100644 --- a/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift +++ b/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift @@ -67,12 +67,14 @@ public struct ScopeValue: Codable, Equatable { public let id: String public let name: String public let description: String + public let imageUrls: NotifyImageUrls? public let enabled: Bool - public init(id: String, name: String, description: String, enabled: Bool) { + public init(id: String, name: String, description: String, imageUrls: NotifyImageUrls?, enabled: Bool) { self.id = id self.name = name self.description = description + self.imageUrls = imageUrls self.enabled = enabled } } From 9b4e1b987ff54e5fd16a348c1486fa6b3bf61eea Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 8 Jan 2024 17:12:56 +0300 Subject: [PATCH 144/814] SubscriptionView paddings --- .../PushMessages/SubscriptionView.swift | 32 +++++++++++-------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift index 1b579552d..358affe2b 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift @@ -98,20 +98,24 @@ struct SubscriptionView: View { .padding(.top, 56.0) .padding(.bottom, 8.0) - Text(presenter.subscriptionViewModel.name) - .font(.large700) - .foregroundColor(.Foreground100) - .padding(.bottom, 8.0) - - Text(presenter.subscriptionViewModel.domain) - .font(.system(size: 12, weight: .medium)) - .foregroundColor(.Foreground200) - .padding(.bottom, 16.0) - - Text(presenter.subscriptionViewModel.description) - .font(.system(size: 14, weight: .regular)) - .foregroundColor(.Foreground100) - .padding(.bottom, 16.0) + Group { + Text(presenter.subscriptionViewModel.name) + .font(.large700) + .foregroundColor(.Foreground100) + .padding(.bottom, 8.0) + + Text(presenter.subscriptionViewModel.domain) + .font(.system(size: 12, weight: .medium)) + .foregroundColor(.Foreground200) + .padding(.bottom, 16.0) + + Text(presenter.subscriptionViewModel.description) + .font(.system(size: 14, weight: .regular)) + .foregroundColor(.Foreground100) + .padding(.bottom, 16.0) + } + .padding(.horizontal, 20) + .multilineTextAlignment(.center) Menu { Button(role: .destructive, action: { From 0159c86af35477ae06b3955874ab9e96d418769f Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 8 Jan 2024 18:02:30 +0300 Subject: [PATCH 145/814] Notify tests fixed --- Tests/NotifyTests/Stubs/NotifySubscription.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tests/NotifyTests/Stubs/NotifySubscription.swift b/Tests/NotifyTests/Stubs/NotifySubscription.swift index 7fd10597e..c5b47cf02 100644 --- a/Tests/NotifyTests/Stubs/NotifySubscription.swift +++ b/Tests/NotifyTests/Stubs/NotifySubscription.swift @@ -13,7 +13,7 @@ extension NotifySubscription { account: account, relay: relay, metadata: metadata, - scope: ["test": ScopeValue(id: "id", name: "name", description: "desc", enabled: true)], + scope: ["test": ScopeValue(id: "id", name: "name", description: "desc", imageUrls: nil, enabled: true)], expiry: expiry, symKey: symKey, appAuthenticationKey: "did:key:z6MkpTEGT75mnz8TiguXYYVnS1GbsNCdLo72R7kUCLShTuFV" From 6f70d105d033e8f4717c49f11878779c820aa566 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 09:07:40 +0300 Subject: [PATCH 146/814] activate pairing on request --- .../xcshareddata/swiftpm/Package.resolved | 4 ++-- Sources/Auth/AuthClientFactory.swift | 2 +- Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 6 ++++++ 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index f11eb5be8..d4a996089 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -168,8 +168,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "3295d69d1b12df29a5040578d107f56986b1b399", - "version": "1.0.13" + "revision": "e84a07662d71721de4d0ccb2d3bb28fd993dd108", + "version": "1.0.14" } } ] diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index c2748c5bd..069d548ce 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -50,7 +50,7 @@ public struct AuthClientFactory { let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: history, signatureVerifier: signatureVerifier, pairingRegisterer: pairingRegisterer, messageFormatter: messageFormatter) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history) - let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer, verifyClient: verifyClient, verifyContextStore: verifyContextStore) + let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: <#WCPairingStorage#>) let walletRespondService = WalletRespondService(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: history, verifyContextStore: verifyContextStore) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index eca845a97..fff6873a6 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -311,6 +311,12 @@ private extension ApproveEngine { // MARK: SessionProposeRequest func handleSessionProposeRequest(payload: RequestSubscriptionPayload) { + + if var pairing = pairingStore.getPairing(forTopic: payload.topic) { + pairing.activate() + pairingStore.setPairing(pairing) + } + logger.debug("Received Session Proposal") let proposal = payload.request do { try Namespace.validate(proposal.requiredNamespaces) } catch { From 6892567ab5250d2182bcdef2611991e63b8d5d78 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 09:11:36 +0300 Subject: [PATCH 147/814] activate pairing on request --- .../Auth/Services/Wallet/AuthRequestSubscriber.swift | 10 +++++++++- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 2 +- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index 62120e568..15ef61b6a 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -10,6 +10,7 @@ class AuthRequestSubscriber { private let pairingRegisterer: PairingRegisterer private let verifyClient: VerifyClientProtocol private let verifyContextStore: CodableStore + private let pairingStore: WCPairingStorage var onRequest: (((request: AuthenticationRequest, context: VerifyContext?)) -> Void)? @@ -20,7 +21,8 @@ class AuthRequestSubscriber { walletErrorResponder: WalletErrorResponder, pairingRegisterer: PairingRegisterer, verifyClient: VerifyClientProtocol, - verifyContextStore: CodableStore + verifyContextStore: CodableStore, + pairingStore: WCPairingStorage ) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -29,12 +31,18 @@ class AuthRequestSubscriber { self.pairingRegisterer = pairingRegisterer self.verifyClient = verifyClient self.verifyContextStore = verifyContextStore + self.pairingStore = pairingStore subscribeForRequest() } private func subscribeForRequest() { pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in + + if var pairing = pairingStore.getPairing(forTopic: payload.topic) { + pairing.activate() + pairingStore.setPairing(pairing) + } logger.debug("AuthRequestSubscriber: Received request") pairingRegisterer.setReceived(pairingTopic: payload.topic) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index c58006edc..6cdcaec9a 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -97,7 +97,7 @@ public struct SignClientFactory { let sessionNameSpaceBuilder = SessionNamespaceBuilder(logger: logger) let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) - let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore) + let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) From 69d5781cfa7ab8ba8279a1d69b58ddfff29c10f3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 09:18:54 +0300 Subject: [PATCH 148/814] fix build --- Sources/Auth/AuthClientFactory.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index 069d548ce..c2748c5bd 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -50,7 +50,7 @@ public struct AuthClientFactory { let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: history, signatureVerifier: signatureVerifier, pairingRegisterer: pairingRegisterer, messageFormatter: messageFormatter) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history) - let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: <#WCPairingStorage#>) + let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer, verifyClient: verifyClient, verifyContextStore: verifyContextStore) let walletRespondService = WalletRespondService(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: history, verifyContextStore: verifyContextStore) From e71c6d7f8cf5aecaeb59a89b4eb5c5f76bba3a0a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 09:45:11 +0300 Subject: [PATCH 149/814] add ActivityIndicatorManager --- Example/ExampleApp.xcodeproj/project.pbxproj | 4 +++ .../Common/ActivityIndicatorManager.swift | 33 +++++++++++++++++++ .../SessionRequestInteractor.swift | 3 +- 3 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 Example/WalletApp/Common/ActivityIndicatorManager.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index f90232086..1df80a639 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -40,6 +40,7 @@ 849D7A93292E2169006A2BD4 /* NotifyTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 849D7A92292E2169006A2BD4 /* NotifyTests.swift */; }; 84A6E3C32A386BBC008A0571 /* Publisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84A6E3C22A386BBC008A0571 /* Publisher.swift */; }; 84AA01DB28CF0CD7005D48D8 /* XCTest.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84AA01DA28CF0CD7005D48D8 /* XCTest.swift */; }; + 84AEC24F2B4D1EE400E27A5B /* ActivityIndicatorManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */; }; 84B8154E2991099000FAD54E /* BuildConfiguration.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B8154D2991099000FAD54E /* BuildConfiguration.swift */; }; 84B8155B2992A18D00FAD54E /* NotifyMessageViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B8155A2992A18D00FAD54E /* NotifyMessageViewModel.swift */; }; 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CE641E27981DED00142511 /* AppDelegate.swift */; }; @@ -433,6 +434,7 @@ 849D7A92292E2169006A2BD4 /* NotifyTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyTests.swift; sourceTree = ""; }; 84A6E3C22A386BBC008A0571 /* Publisher.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Publisher.swift; sourceTree = ""; }; 84AA01DA28CF0CD7005D48D8 /* XCTest.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = XCTest.swift; sourceTree = ""; }; + 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActivityIndicatorManager.swift; sourceTree = ""; }; 84B8154D2991099000FAD54E /* BuildConfiguration.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BuildConfiguration.swift; sourceTree = ""; }; 84B8155A2992A18D00FAD54E /* NotifyMessageViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyMessageViewModel.swift; sourceTree = ""; }; 84CE641C27981DED00142511 /* DApp.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = DApp.app; sourceTree = BUILT_PRODUCTS_DIR; }; @@ -1666,6 +1668,7 @@ C56EE2A1293F6B9E004840D1 /* Helpers */, C56EE262293F56D6004840D1 /* Extensions */, C56EE263293F56D6004840D1 /* VIPER */, + 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */, ); path = Common; sourceTree = ""; @@ -2512,6 +2515,7 @@ A51811A02A52E83100A52B15 /* SettingsPresenter.swift in Sources */, 847BD1DA2989492500076C90 /* MainRouter.swift in Sources */, C5F32A2E2954814A00A6476E /* ConnectionDetailsRouter.swift in Sources */, + 84AEC24F2B4D1EE400E27A5B /* ActivityIndicatorManager.swift in Sources */, C55D3482295DD7140004314A /* AuthRequestInteractor.swift in Sources */, C55D34B12965FB750004314A /* SessionProposalInteractor.swift in Sources */, C56EE247293F566D004840D1 /* ScanModule.swift in Sources */, diff --git a/Example/WalletApp/Common/ActivityIndicatorManager.swift b/Example/WalletApp/Common/ActivityIndicatorManager.swift new file mode 100644 index 000000000..9a8143f85 --- /dev/null +++ b/Example/WalletApp/Common/ActivityIndicatorManager.swift @@ -0,0 +1,33 @@ +import UIKit + +class ActivityIndicatorManager { + static let shared = ActivityIndicatorManager() + private var activityIndicator: UIActivityIndicatorView? + + private init() {} + + func start() { + DispatchQueue.main.async { + self.stop() + + guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, + let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } + + let activityIndicator = UIActivityIndicatorView(style: .large) + activityIndicator.center = window.center + activityIndicator.startAnimating() + window.addSubview(activityIndicator) + + self.activityIndicator = activityIndicator + } + } + + + func stop() { + DispatchQueue.main.async { + self.activityIndicator?.stopAnimating() + self.activityIndicator?.removeFromSuperview() + self.activityIndicator = nil + } + } +} diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift index 59886fbfb..2bd386489 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift @@ -7,12 +7,13 @@ final class SessionRequestInteractor { func approve(sessionRequest: Request, importAccount: ImportAccount) async throws -> Bool { do { let result = try Signer.sign(request: sessionRequest, importAccount: importAccount) + ActivityIndicatorManager.shared.start() try await Web3Wallet.instance.respond( topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(result) ) - + ActivityIndicatorManager.shared.stop() /* Redirect */ let session = getSession(topic: sessionRequest.topic) if let uri = session?.peer.redirect?.native { From e6553e594b2f6a3822b4dcdf6874d8380227127b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 12:13:38 +0300 Subject: [PATCH 150/814] add alert presenter --- Example/ExampleApp.xcodeproj/project.pbxproj | 21 +++++++++++ .../xcshareddata/swiftpm/Package.resolved | 9 +++++ .../ConfigurationService.swift | 12 +++++++ Example/WalletApp/Common/AlertPresenter.swift | 35 +++++++++++++++++++ 4 files changed, 77 insertions(+) create mode 100644 Example/WalletApp/Common/AlertPresenter.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 1df80a639..13d1cb82d 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -41,6 +41,8 @@ 84A6E3C32A386BBC008A0571 /* Publisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84A6E3C22A386BBC008A0571 /* Publisher.swift */; }; 84AA01DB28CF0CD7005D48D8 /* XCTest.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84AA01DA28CF0CD7005D48D8 /* XCTest.swift */; }; 84AEC24F2B4D1EE400E27A5B /* ActivityIndicatorManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */; }; + 84AEC2512B4D42C100E27A5B /* AlertPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84AEC2502B4D42C100E27A5B /* AlertPresenter.swift */; }; + 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */ = {isa = PBXBuildFile; productRef = 84AEC2532B4D43CD00E27A5B /* SwiftMessages */; }; 84B8154E2991099000FAD54E /* BuildConfiguration.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B8154D2991099000FAD54E /* BuildConfiguration.swift */; }; 84B8155B2992A18D00FAD54E /* NotifyMessageViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B8155A2992A18D00FAD54E /* NotifyMessageViewModel.swift */; }; 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CE641E27981DED00142511 /* AppDelegate.swift */; }; @@ -435,6 +437,7 @@ 84A6E3C22A386BBC008A0571 /* Publisher.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Publisher.swift; sourceTree = ""; }; 84AA01DA28CF0CD7005D48D8 /* XCTest.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = XCTest.swift; sourceTree = ""; }; 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActivityIndicatorManager.swift; sourceTree = ""; }; + 84AEC2502B4D42C100E27A5B /* AlertPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertPresenter.swift; sourceTree = ""; }; 84B8154D2991099000FAD54E /* BuildConfiguration.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BuildConfiguration.swift; sourceTree = ""; }; 84B8155A2992A18D00FAD54E /* NotifyMessageViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyMessageViewModel.swift; sourceTree = ""; }; 84CE641C27981DED00142511 /* DApp.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = DApp.app; sourceTree = BUILT_PRODUCTS_DIR; }; @@ -791,6 +794,7 @@ C55D349929630D440004314A /* Web3Wallet in Frameworks */, A5F1526F2ACDC46B00D745A6 /* Web3ModalUI in Frameworks */, C56EE255293F569A004840D1 /* Starscream in Frameworks */, + 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */, A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */, C56EE27B293F56F8004840D1 /* WalletConnectAuth in Frameworks */, C54C24902AEB1B5600DA4BF6 /* WalletConnectRouter in Frameworks */, @@ -1669,6 +1673,7 @@ C56EE262293F56D6004840D1 /* Extensions */, C56EE263293F56D6004840D1 /* VIPER */, 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */, + 84AEC2502B4D42C100E27A5B /* AlertPresenter.swift */, ); path = Common; sourceTree = ""; @@ -2145,6 +2150,7 @@ A59D25ED2AB3672700D7EA3A /* AsyncButton */, A5F1526E2ACDC46B00D745A6 /* Web3ModalUI */, C54C248F2AEB1B5600DA4BF6 /* WalletConnectRouter */, + 84AEC2532B4D43CD00E27A5B /* SwiftMessages */, ); productName = ChatWallet; productReference = C56EE21B293F55ED004840D1 /* WalletApp.app */; @@ -2223,6 +2229,7 @@ 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */, 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */, A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */, + 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */, ); productRefGroup = 764E1D3D26F8D3FC00A1FB15 /* Products */; projectDirPath = ""; @@ -2520,6 +2527,7 @@ C55D34B12965FB750004314A /* SessionProposalInteractor.swift in Sources */, C56EE247293F566D004840D1 /* ScanModule.swift in Sources */, C56EE28D293F5757004840D1 /* AppearanceConfigurator.swift in Sources */, + 84AEC2512B4D42C100E27A5B /* AlertPresenter.swift in Sources */, 847BD1D82989492500076C90 /* MainModule.swift in Sources */, 847BD1E7298A806800076C90 /* NotificationsInteractor.swift in Sources */, C56EE241293F566D004840D1 /* WalletModule.swift in Sources */, @@ -3356,6 +3364,14 @@ kind = branch; }; }; + 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */ = { + isa = XCRemoteSwiftPackageReference; + repositoryURL = "https://github.com/SwiftKickMobile/SwiftMessages"; + requirement = { + kind = upToNextMajorVersion; + minimumVersion = 9.0.9; + }; + }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/flypaper0/solana-swift"; @@ -3444,6 +3460,11 @@ package = 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */; productName = Mixpanel; }; + 84AEC2532B4D43CD00E27A5B /* SwiftMessages */ = { + isa = XCSwiftPackageProductDependency; + package = 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */; + productName = SwiftMessages; + }; 84DDB4EC28ABB663003D66ED /* WalletConnectAuth */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectAuth; diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index d4a996089..c46e295f2 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -127,6 +127,15 @@ "version": "1.1.6" } }, + { + "package": "SwiftMessages", + "repositoryURL": "https://github.com/SwiftKickMobile/SwiftMessages", + "state": { + "branch": null, + "revision": "62e12e138fc3eedf88c7553dd5d98712aa119f40", + "version": "9.0.9" + } + }, { "package": "swiftui-async-button", "repositoryURL": "https://github.com/lorenzofiamingo/swiftui-async-button", diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 1267374f7..a016d8515 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -2,9 +2,12 @@ import UIKit import WalletConnectNetworking import WalletConnectNotify import Web3Wallet +import Combine final class ConfigurationService { + private var publishers = Set() + func configure(importAccount: ImportAccount) { Networking.configure( groupIdentifier: "group.com.walletconnect.sdk", @@ -38,6 +41,15 @@ final class ConfigurationService { } LoggingService.instance.startLogging() + Web3Wallet.instance.socketConnectionStatusPublisher.sink { status in + switch status { + case .connected: + AlertPresenter.present(message: "Your web socket has connected", type: .info) + case .disconnected: + AlertPresenter.present(message: "Your web socket is disconnected", type: .warning) + } + }.store(in: &publishers) + Task { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") diff --git a/Example/WalletApp/Common/AlertPresenter.swift b/Example/WalletApp/Common/AlertPresenter.swift new file mode 100644 index 000000000..2b3b45c38 --- /dev/null +++ b/Example/WalletApp/Common/AlertPresenter.swift @@ -0,0 +1,35 @@ +import Foundation +import SwiftMessages +import UIKit + +struct AlertPresenter { + enum MessageType { + case warning + case error + case info + case success + } + + static func present(message: String, type: AlertPresenter.MessageType) { + DispatchQueue.main.async { + let view = MessageView.viewFromNib(layout: .cardView) + switch type { + case .warning: + view.configureTheme(.warning, iconStyle: .subtle) + case .error: + view.configureTheme(.error, iconStyle: .subtle) + case .info: + view.configureTheme(.info, iconStyle: .subtle) + case .success: + view.configureTheme(.success, iconStyle: .subtle) + } + view.button?.isHidden = true + view.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + view.configureContent(title: "", body: message) + var config = SwiftMessages.Config() + config.presentationStyle = .top + config.duration = .seconds(seconds: 1) + SwiftMessages.show(config: config, view: view) + } + } +} From 7d01cc00c7b23d37b314280daca77455521076d0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 12:31:04 +0300 Subject: [PATCH 151/814] savepoint --- Example/WalletApp/ApplicationLayer/ConfigurationService.swift | 2 +- Example/WalletApp/Common/AlertPresenter.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index a016d8515..1cbab29f5 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -44,7 +44,7 @@ final class ConfigurationService { Web3Wallet.instance.socketConnectionStatusPublisher.sink { status in switch status { case .connected: - AlertPresenter.present(message: "Your web socket has connected", type: .info) + AlertPresenter.present(message: "Your web socket has connected", type: .success) case .disconnected: AlertPresenter.present(message: "Your web socket is disconnected", type: .warning) } diff --git a/Example/WalletApp/Common/AlertPresenter.swift b/Example/WalletApp/Common/AlertPresenter.swift index 2b3b45c38..5da5d4668 100644 --- a/Example/WalletApp/Common/AlertPresenter.swift +++ b/Example/WalletApp/Common/AlertPresenter.swift @@ -28,7 +28,7 @@ struct AlertPresenter { view.configureContent(title: "", body: message) var config = SwiftMessages.Config() config.presentationStyle = .top - config.duration = .seconds(seconds: 1) + config.duration = .seconds(seconds: 1.5) SwiftMessages.show(config: config, view: view) } } From b6e09efebfc2f8ee272453c96ea0d256f8e28d7b Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 13 Dec 2023 15:50:30 +0300 Subject: [PATCH 152/814] Notify tests scope changed --- Example/IntegrationTests/Push/NotifyTests.swift | 7 +++---- Sources/Database/SQLiteQuery.swift | 4 ++++ .../WalletConnectNotify/Client/Wallet/NotifyDatabase.swift | 6 ++++++ 3 files changed, 13 insertions(+), 4 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 084ef9fc0..8d26941ae 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -193,13 +193,12 @@ final class NotifyTests: XCTestCase { await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) - let updateScope = Set([subscription.scope.keys.first!]) - try await walletNotifyClientA.update(topic: subscription.topic, scope: updateScope) + try await walletNotifyClientA.update(topic: subscription.topic, scope: []) await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) - let updatedScope = Set(subscription.scope.filter { $0.value.enabled == true }.keys) - XCTAssertEqual(updatedScope, updateScope) + let updatedScope = subscription.scope.filter { $0.value.enabled == true } + XCTAssertTrue(updatedScope.isEmpty) try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) } diff --git a/Sources/Database/SQLiteQuery.swift b/Sources/Database/SQLiteQuery.swift index a21927639..689de2d47 100644 --- a/Sources/Database/SQLiteQuery.swift +++ b/Sources/Database/SQLiteQuery.swift @@ -37,6 +37,10 @@ public struct SqliteQuery { return "SELECT * FROM \(table) WHERE \(argument) = '\(value)';" } + public static func delete(table: String) -> String { + return "DELETE FROM \(table);" + } + public static func delete(table: String, where argument: String, equals value: String) -> String { return "DELETE FROM \(table) WHERE \(argument) = '\(value)';" } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift index 422196905..b9ee2ce67 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift @@ -34,6 +34,12 @@ final class NotifyDatabase { try onSubscriptionsUpdate?() } + func replace(subscriptions: [NotifySubscription]) throws { + try execute(sql: SqliteQuery.delete(table: Table.subscriptions)) + try execute(sql: try SqliteQuery.replace(table: Table.subscriptions, rows: subscriptions)) + try onSubscriptionsUpdate?() + } + func getSubscription(topic: String) -> NotifySubscription? { let sql = SqliteQuery.select(table: Table.subscriptions, where: "topic", equals: topic) let subscriptions: [NotifySubscription]? = try? query(sql: sql) From 47ae69cea4e0fd2d9687bbfdbdb75e3fbf0f5355 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 13 Dec 2023 18:19:00 +0300 Subject: [PATCH 153/814] Handle empty subscriptions response --- Sources/Database/SQLiteQuery.swift | 4 ++-- .../Client/Wallet/NotifyDatabase.swift | 8 +++++--- .../WalletConnectNotify/Client/Wallet/NotifyStorage.swift | 2 +- 3 files changed, 8 insertions(+), 6 deletions(-) diff --git a/Sources/Database/SQLiteQuery.swift b/Sources/Database/SQLiteQuery.swift index 689de2d47..ce2d8d920 100644 --- a/Sources/Database/SQLiteQuery.swift +++ b/Sources/Database/SQLiteQuery.swift @@ -2,7 +2,7 @@ import Foundation public struct SqliteQuery { - public static func replace(table: String, rows: [SqliteRow]) throws -> String { + public static func replace(table: String, rows: [SqliteRow]) -> String? { var values: [String] = [] for row in rows { @@ -12,7 +12,7 @@ public struct SqliteQuery { } guard let first = rows.first else { - throw Errors.rowsNotFound + return nil } let formattedArguments = first.encode().values diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift index b9ee2ce67..874e86237 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDatabase.swift @@ -29,14 +29,16 @@ final class NotifyDatabase { } func save(subscriptions: [NotifySubscription]) throws { - let sql = try SqliteQuery.replace(table: Table.subscriptions, rows: subscriptions) + guard let sql = SqliteQuery.replace(table: Table.subscriptions, rows: subscriptions) else { return } try execute(sql: sql) try onSubscriptionsUpdate?() } func replace(subscriptions: [NotifySubscription]) throws { try execute(sql: SqliteQuery.delete(table: Table.subscriptions)) - try execute(sql: try SqliteQuery.replace(table: Table.subscriptions, rows: subscriptions)) + if let sql = SqliteQuery.replace(table: Table.subscriptions, rows: subscriptions) { + try execute(sql: sql) + } try onSubscriptionsUpdate?() } @@ -101,7 +103,7 @@ final class NotifyDatabase { } func save(messages: [NotifyMessageRecord]) throws { - let sql = try SqliteQuery.replace(table: Table.messages, rows: messages) + guard let sql = SqliteQuery.replace(table: Table.messages, rows: messages) else { return } try execute(sql: sql) try onMessagesUpdate?() } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift index 1e9cf905f..cca2c3e6a 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift @@ -71,7 +71,7 @@ final class NotifyStorage: NotifyStoring { } func replaceAllSubscriptions(_ subscriptions: [NotifySubscription]) throws { - try database.save(subscriptions: subscriptions) + try database.replace(subscriptions: subscriptions) } func deleteSubscription(topic: String) throws { From 2bafc5271261872db572e561ae3a4c27571bb09a Mon Sep 17 00:00:00 2001 From: Sergey Udalov <45697468+2jumper3@users.noreply.github.com> Date: Tue, 9 Jan 2024 14:28:27 +0100 Subject: [PATCH 154/814] Update WalletPairService.swift Since the method is marked as throws, when called within a do block, nothing happens if the session is already inactive, consequently making it impossible to handle. --- .../Services/Wallet/WalletPairService.swift | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index 7c04a0acc..e9dea0198 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -4,6 +4,7 @@ actor WalletPairService { enum Errors: Error { case pairingAlreadyExist(topic: String) case networkNotConnected + case noPendingRequest } let networkingInteractor: NetworkInteracting @@ -30,7 +31,7 @@ actor WalletPairService { logger.debug("Pairing with uri: \(uri)") guard try !pairingHasPendingRequest(for: uri.topic) else { logger.debug("Pairing with topic (\(uri.topic)) has pending request") - return + throw Errors.noPendingRequest } let pairing = WCPairing(uri: uri) From 1aadaebd5a3a293dfa56cd7d5c49b894637f2279 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 19:01:44 +0300 Subject: [PATCH 155/814] present alert for w3w error messages --- .../WalletApp/ApplicationLayer/ConfigurationService.swift | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 1cbab29f5..81335f0d8 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -50,6 +50,14 @@ final class ConfigurationService { } }.store(in: &publishers) + Web3Wallet.instance.logsPublisher.sink { log in + switch log { + case .error(let logMessage): + AlertPresenter.present(message: logMessage.message, type: .error) + default: return + } + }.store(in: &publishers) + Task { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") From b62568d2cda44654d5319895234ad487b83e0673 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 19:33:42 +0300 Subject: [PATCH 156/814] fix activity indicator manager --- .../Common/ActivityIndicatorManager.swift | 20 ++++++++++--------- .../SessionProposalPresenter.swift | 3 +++ .../SessionRequestInteractor.swift | 6 ++---- .../SessionRequestPresenter.swift | 7 +++++-- 4 files changed, 21 insertions(+), 15 deletions(-) diff --git a/Example/WalletApp/Common/ActivityIndicatorManager.swift b/Example/WalletApp/Common/ActivityIndicatorManager.swift index 9a8143f85..9382be8a3 100644 --- a/Example/WalletApp/Common/ActivityIndicatorManager.swift +++ b/Example/WalletApp/Common/ActivityIndicatorManager.swift @@ -6,10 +6,10 @@ class ActivityIndicatorManager { private init() {} - func start() { - DispatchQueue.main.async { - self.stop() + func start() async { + await stop() + DispatchQueue.main.async { guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } @@ -22,12 +22,14 @@ class ActivityIndicatorManager { } } - - func stop() { - DispatchQueue.main.async { - self.activityIndicator?.stopAnimating() - self.activityIndicator?.removeFromSuperview() - self.activityIndicator = nil + func stop() async { + await withCheckedContinuation { continuation in + DispatchQueue.main.async { + self.activityIndicator?.stopAnimating() + self.activityIndicator?.removeFromSuperview() + self.activityIndicator = nil + continuation.resume() + } } } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 523158eee..7f2a20f68 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -35,11 +35,14 @@ final class SessionProposalPresenter: ObservableObject { @MainActor func onApprove() async throws { do { + await ActivityIndicatorManager.shared.start() let showConnected = try await interactor.approve(proposal: sessionProposal, account: importAccount.account) showConnected ? showConnectedSheet.toggle() : router.dismiss() + await ActivityIndicatorManager.shared.stop() } catch { errorMessage = error.localizedDescription showError.toggle() + await ActivityIndicatorManager.shared.stop() } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift index 2bd386489..edc2ed4df 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestInteractor.swift @@ -4,16 +4,14 @@ import Web3Wallet import WalletConnectRouter final class SessionRequestInteractor { - func approve(sessionRequest: Request, importAccount: ImportAccount) async throws -> Bool { + func respondSessionRequest(sessionRequest: Request, importAccount: ImportAccount) async throws -> Bool { do { let result = try Signer.sign(request: sessionRequest, importAccount: importAccount) - ActivityIndicatorManager.shared.start() try await Web3Wallet.instance.respond( topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(result) ) - ActivityIndicatorManager.shared.stop() /* Redirect */ let session = getSession(topic: sessionRequest.topic) if let uri = session?.peer.redirect?.native { @@ -27,7 +25,7 @@ final class SessionRequestInteractor { } } - func reject(sessionRequest: Request) async throws { + func respondError(sessionRequest: Request) async throws { try await Web3Wallet.instance.respond( topic: sessionRequest.topic, requestId: sessionRequest.id, diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index d8c00b710..b8e0819ce 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -43,9 +43,12 @@ final class SessionRequestPresenter: ObservableObject { @MainActor func onApprove() async throws { do { - let showConnected = try await interactor.approve(sessionRequest: sessionRequest, importAccount: importAccount) + await ActivityIndicatorManager.shared.start() + let showConnected = try await interactor.respondSessionRequest(sessionRequest: sessionRequest, importAccount: importAccount) showConnected ? showSignedSheet.toggle() : router.dismiss() + await ActivityIndicatorManager.shared.stop() } catch { + await ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() } @@ -53,7 +56,7 @@ final class SessionRequestPresenter: ObservableObject { @MainActor func onReject() async throws { - try await interactor.reject(sessionRequest: sessionRequest) + try await interactor.respondError(sessionRequest: sessionRequest) router.dismiss() } From abb4bd1924ca32e8fcb9caf7fa1e07cc8c979d7c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 19:58:00 +0300 Subject: [PATCH 157/814] add dismiss button to session request screen --- .../SessionRequestPresenter.swift | 11 +++++++++-- .../SessionRequest/SessionRequestView.swift | 17 +++++++++++++++-- 2 files changed, 24 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index b8e0819ce..e9627d7d1 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -56,8 +56,15 @@ final class SessionRequestPresenter: ObservableObject { @MainActor func onReject() async throws { - try await interactor.respondError(sessionRequest: sessionRequest) - router.dismiss() + do { + await ActivityIndicatorManager.shared.start() + try await interactor.respondError(sessionRequest: sessionRequest) + await ActivityIndicatorManager.shared.stop() + router.dismiss() + } catch { + await ActivityIndicatorManager.shared.stop() + + } } func onSignedSheetDismiss() { diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift index d64b1f82a..595849180 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift @@ -11,7 +11,20 @@ struct SessionRequestView: View { VStack { Spacer() - + + VStack { + HStack { + Spacer() + Button(action: { + presenter.dismiss() + }) { + Image(systemName: "xmark") + .foregroundColor(.white) + .padding() + } + } + .padding() + } VStack(spacing: 0) { Image("header") .resizable() @@ -98,7 +111,7 @@ struct SessionRequestView: View { } .alert(presenter.errorMessage, isPresented: $presenter.showError) { Button("OK", role: .cancel) { - presenter.dismiss() +// presenter.dismiss() } } .sheet( From adc4d0fcac228469864589d92d4ab8fd09d8a5b6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jan 2024 20:17:22 +0300 Subject: [PATCH 158/814] savepoint --- .../Wallet/SessionProposal/SessionProposalPresenter.swift | 5 ++++- .../Wallet/SessionRequest/SessionRequestPresenter.swift | 3 ++- .../Wallet/SessionRequest/SessionRequestView.swift | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 7f2a20f68..07a78d931 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -40,18 +40,21 @@ final class SessionProposalPresenter: ObservableObject { showConnected ? showConnectedSheet.toggle() : router.dismiss() await ActivityIndicatorManager.shared.stop() } catch { + await ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() - await ActivityIndicatorManager.shared.stop() } } @MainActor func onReject() async throws { do { + await ActivityIndicatorManager.shared.start() try await interactor.reject(proposal: sessionProposal) + await ActivityIndicatorManager.shared.stop() router.dismiss() } catch { + await ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index e9627d7d1..b2df3650a 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -63,7 +63,8 @@ final class SessionRequestPresenter: ObservableObject { router.dismiss() } catch { await ActivityIndicatorManager.shared.stop() - + errorMessage = error.localizedDescription + showError.toggle() } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift index 595849180..ebc9557b2 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestView.swift @@ -18,7 +18,7 @@ struct SessionRequestView: View { Button(action: { presenter.dismiss() }) { - Image(systemName: "xmark") + Image(systemName: "xmark") .foregroundColor(.white) .padding() } From 638bf7693ec2db9131dc330f9a3121a1cb475d2f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jan 2024 09:38:28 +0100 Subject: [PATCH 159/814] add activity indicator on delete --- .../Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift index 5312123a4..7fdc893c5 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift @@ -25,11 +25,14 @@ final class ConnectionDetailsPresenter: ObservableObject { func onDelete() { Task { do { + await ActivityIndicatorManager.shared.start() try await interactor.disconnectSession(session: session) + await ActivityIndicatorManager.shared.stop() DispatchQueue.main.async { self.router.dismiss() } } catch { + await ActivityIndicatorManager.shared.stop() print(error) } } From 9be087e3f1483ff24037c6db137bc8de169d668e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jan 2024 10:57:47 +0100 Subject: [PATCH 160/814] fix request expiry logic --- .../xcschemes/WalletConnectSignTests.xcscheme | 53 +++++++++++++++++++ .../SessionAccountPresenter.swift | 3 +- Sources/WalletConnectSign/Request.swift | 3 +- .../AppProposalServiceTests.swift | 11 +++- .../ApproveEngineTests.swift | 11 +++- .../SessionRequestTests.swift | 7 --- 6 files changed, 74 insertions(+), 14 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme new file mode 100644 index 000000000..bb6f830b9 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectSignTests.xcscheme @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 15b0b7e74..3534eda65 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -41,7 +41,8 @@ final class SessionAccountPresenter: ObservableObject { do { let requestParams = try getRequest(for: method) - let request = Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!) + let expiry = UInt64(Date().timeIntervalSince1970 + 300) + let request = Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, expiry: expiry) Task { do { try await Sign.instance.request(params: request) diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index 1cae4e0cd..665369a1d 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -31,8 +31,7 @@ public struct Request: Codable, Equatable { let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) guard - abs(currentDate.distance(to: expiryDate)) < Constants.maxExpiry, - abs(currentDate.distance(to: expiryDate)) > Constants.minExpiry + abs(currentDate.distance(to: expiryDate)) < Constants.maxExpiry else { return true } return expiryDate < currentDate diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index bdc8c7180..5e4b7da61 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -5,7 +5,7 @@ import JSONRPC @testable import TestingUtils @testable import WalletConnectKMS @testable import WalletConnectPairing -import WalletConnectUtils +@testable import WalletConnectUtils func deriveTopic(publicKey: String, privateKey: AgreementPrivateKey) -> String { try! KeyManagementService.generateAgreementKey(from: privateKey, peerPublicKey: publicKey).derivedTopic() @@ -59,6 +59,12 @@ final class AppProposalServiceTests: XCTestCase { kms: cryptoMock, logger: logger ) + let history = RPCHistory( + keyValueStore: .init( + defaults: RuntimeKeyValueStorage(), + identifier: "" + ) + ) approveEngine = ApproveEngine( networkingInteractor: networkingInteractor, proposalPayloadsStore: .init(defaults: RuntimeKeyValueStorage(), identifier: ""), @@ -70,7 +76,8 @@ final class AppProposalServiceTests: XCTestCase { logger: logger, pairingStore: storageMock, sessionStore: WCSessionStorageMock(), - verifyClient: VerifyClientMock() + verifyClient: VerifyClientMock(), + rpcHistory: history ) } diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index de84c86d2..928a4600f 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -1,12 +1,12 @@ import XCTest import Combine import JSONRPC -import WalletConnectUtils import WalletConnectPairing import WalletConnectNetworking @testable import WalletConnectSign @testable import TestingUtils @testable import WalletConnectKMS +@testable import WalletConnectUtils final class ApproveEngineTests: XCTestCase { @@ -33,6 +33,12 @@ final class ApproveEngineTests: XCTestCase { proposalPayloadsStore = CodableStore>(defaults: RuntimeKeyValueStorage(), identifier: "") verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") sessionTopicToProposal = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") + let history = RPCHistory( + keyValueStore: .init( + defaults: RuntimeKeyValueStorage(), + identifier: "" + ) + ) engine = ApproveEngine( networkingInteractor: networkingInteractor, proposalPayloadsStore: proposalPayloadsStore, @@ -44,7 +50,8 @@ final class ApproveEngineTests: XCTestCase { logger: ConsoleLoggerMock(), pairingStore: pairingStorageMock, sessionStore: sessionStorageMock, - verifyClient: VerifyClientMock() + verifyClient: VerifyClientMock(), + rpcHistory: history ) } diff --git a/Tests/WalletConnectSignTests/SessionRequestTests.swift b/Tests/WalletConnectSignTests/SessionRequestTests.swift index e89ff347d..c4b4a2fbf 100644 --- a/Tests/WalletConnectSignTests/SessionRequestTests.swift +++ b/Tests/WalletConnectSignTests/SessionRequestTests.swift @@ -46,13 +46,6 @@ final class SessionRequestTests: XCTestCase { XCTAssertTrue(request.isExpired(currentDate: currentDate)) } - func testIsExpiredTrueMinValidation() { - let currentDate = Date(timeIntervalSince1970: 500) - let expiry = Date(timeIntervalSince1970: 600) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - XCTAssertTrue(request.isExpired(currentDate: currentDate)) - } - func testIsExpiredTrueMaxValidation() { let currentDate = Date(timeIntervalSince1970: 500) let expiry = Date(timeIntervalSince1970: 700000) From c5dfdeefeafe775a26074775bfde3989dc8dcfe8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jan 2024 11:21:25 +0100 Subject: [PATCH 161/814] add ActivityIndicatorManager to a dapp --- .../Common/ActivityIndicatorManager.swift | 35 +++++++++++++++++++ Example/ExampleApp.xcodeproj/project.pbxproj | 4 +++ 2 files changed, 39 insertions(+) create mode 100644 Example/DApp/Common/ActivityIndicatorManager.swift diff --git a/Example/DApp/Common/ActivityIndicatorManager.swift b/Example/DApp/Common/ActivityIndicatorManager.swift new file mode 100644 index 000000000..a21e00f46 --- /dev/null +++ b/Example/DApp/Common/ActivityIndicatorManager.swift @@ -0,0 +1,35 @@ +import UIKit + +class ActivityIndicatorManager { + static let shared = ActivityIndicatorManager() + private var activityIndicator: UIActivityIndicatorView? + + private init() {} + + func start() async { + await stop() + + DispatchQueue.main.async { + guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, + let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } + + let activityIndicator = UIActivityIndicatorView(style: .large) + activityIndicator.center = window.center + activityIndicator.startAnimating() + window.addSubview(activityIndicator) + + self.activityIndicator = activityIndicator + } + } + + func stop() async { + await withCheckedContinuation { continuation in + DispatchQueue.main.async { + self.activityIndicator?.stopAnimating() + self.activityIndicator?.removeFromSuperview() + self.activityIndicator = nil + continuation.resume() + } + } + } +} diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 13d1cb82d..c22452e06 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -50,6 +50,7 @@ 84CE642827981DF000142511 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 84CE642727981DF000142511 /* Assets.xcassets */; }; 84CE642B27981DF000142511 /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 84CE642927981DF000142511 /* LaunchScreen.storyboard */; }; 84CEC64628D89D6B00D081A8 /* PairingTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CEC64528D89D6B00D081A8 /* PairingTests.swift */; }; + 84D093EB2B4EA6CB005B1925 /* ActivityIndicatorManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */; }; 84D2A66628A4F51E0088AE09 /* AuthTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84D2A66528A4F51E0088AE09 /* AuthTests.swift */; }; 84DB38F32983CDAE00BFEE37 /* PushRegisterer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */; }; 84DDB4ED28ABB663003D66ED /* WalletConnectAuth in Frameworks */ = {isa = PBXBuildFile; productRef = 84DDB4EC28ABB663003D66ED /* WalletConnectAuth */; }; @@ -448,6 +449,7 @@ 84CE642C27981DF000142511 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; 84CE6453279FFE1100142511 /* Wallet.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = Wallet.entitlements; sourceTree = ""; }; 84CEC64528D89D6B00D081A8 /* PairingTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PairingTests.swift; sourceTree = ""; }; + 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActivityIndicatorManager.swift; sourceTree = ""; }; 84D2A66528A4F51E0088AE09 /* AuthTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthTests.swift; sourceTree = ""; }; 84D72FC62B4692770057EAF3 /* DApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DApp.entitlements; sourceTree = ""; }; 84DB38F029828A7C00BFEE37 /* WalletApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletApp.entitlements; sourceTree = ""; }; @@ -1426,6 +1428,7 @@ children = ( A51AC0D828E436A3001BACF9 /* InputConfig.swift */, A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */, + 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */, ); path = Common; sourceTree = ""; @@ -2335,6 +2338,7 @@ C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */, C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */, C5BE021E2AF79B9A0064FC88 /* SessionAccountView.swift in Sources */, + 84D093EB2B4EA6CB005B1925 /* ActivityIndicatorManager.swift in Sources */, C5BE02032AF774CB0064FC88 /* NewPairingPresenter.swift in Sources */, 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */, C5BE01E32AF696540064FC88 /* SceneViewController.swift in Sources */, From 51d81b2ac41f37369fe7c2684e72bc7b9cc2d4de Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jan 2024 12:09:46 +0100 Subject: [PATCH 162/814] savepoint --- .../DApp/Common/ActivityIndicatorManager.swift | 1 + Example/DApp/Modules/Main/MainPresenter.swift | 18 ++++++++++++++---- .../SessionAccountPresenter.swift | 17 +---------------- Example/DApp/Modules/Sign/SignPresenter.swift | 3 +++ 4 files changed, 19 insertions(+), 20 deletions(-) diff --git a/Example/DApp/Common/ActivityIndicatorManager.swift b/Example/DApp/Common/ActivityIndicatorManager.swift index a21e00f46..500731651 100644 --- a/Example/DApp/Common/ActivityIndicatorManager.swift +++ b/Example/DApp/Common/ActivityIndicatorManager.swift @@ -15,6 +15,7 @@ class ActivityIndicatorManager { let activityIndicator = UIActivityIndicatorView(style: .large) activityIndicator.center = window.center + activityIndicator.color = .white activityIndicator.startAnimating() window.addSubview(activityIndicator) diff --git a/Example/DApp/Modules/Main/MainPresenter.swift b/Example/DApp/Modules/Main/MainPresenter.swift index c3c7d47ee..4dcda326e 100644 --- a/Example/DApp/Modules/Main/MainPresenter.swift +++ b/Example/DApp/Modules/Main/MainPresenter.swift @@ -1,4 +1,5 @@ import UIKit +import WalletConnectSign import Combine final class MainPresenter { @@ -24,9 +25,18 @@ final class MainPresenter { self.router = router self.interactor = interactor } -} -// MARK: - Private functions -extension MainPresenter { - private func setupInitialState() {} + private func setupInitialState() { + Sign.instance.sessionResponsePublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] response in + Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + presentResponse(response: response) + } + .store(in: &disposeBag) + } + + private func presentResponse(response: Response) { + + } } diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 3534eda65..1924a264f 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -8,7 +8,6 @@ final class SessionAccountPresenter: ObservableObject { case notImplemented } - @Published var showResponse = false @Published var showError = false @Published var errorMessage = String.empty @Published var showRequestSent = false @@ -28,7 +27,6 @@ final class SessionAccountPresenter: ObservableObject { sessionAccount: AccountDetails, session: Session ) { - defer { setupInitialState() } self.interactor = interactor self.router = router self.sessionAccount = sessionAccount @@ -45,6 +43,7 @@ final class SessionAccountPresenter: ObservableObject { let request = Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, expiry: expiry) Task { do { + await ActivityIndicatorManager.shared.start() try await Sign.instance.request(params: request) DispatchQueue.main.async { [weak self] in self?.openWallet() @@ -67,15 +66,6 @@ final class SessionAccountPresenter: ObservableObject { // MARK: - Private functions extension SessionAccountPresenter { - private func setupInitialState() { - Sign.instance.sessionResponsePublisher - .receive(on: DispatchQueue.main) - .sink { [unowned self] response in - presentResponse(response: response) - } - .store(in: &subscriptions) - } - private func getRequest(for method: String) throws -> AnyCodable { let account = session.namespaces.first!.value.accounts.first!.absoluteString if method == "eth_sendTransaction" { @@ -89,11 +79,6 @@ extension SessionAccountPresenter { throw Errors.notImplemented } - private func presentResponse(response: Response) { - self.response = response - showResponse.toggle() - } - private func openWallet() { if let nativeUri = session.peer.redirect?.native { UIApplication.shared.open(URL(string: "\(nativeUri)wc?requestSent")!) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index b42d2663c..d3a6f1911 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -70,9 +70,12 @@ final class SignPresenter: ObservableObject { if let session { Task { @MainActor in do { + await ActivityIndicatorManager.shared.start() try await Sign.instance.disconnect(topic: session.topic) + await ActivityIndicatorManager.shared.stop() accountsDetails.removeAll() } catch { + await ActivityIndicatorManager.shared.stop() showError.toggle() errorMessage = error.localizedDescription } From 399bdacf86777b86d66dc895333abf1f7bdb66b5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jan 2024 20:54:12 +0100 Subject: [PATCH 163/814] savepoint - add response view --- Example/DApp/Modules/Main/MainPresenter.swift | 5 +- Example/DApp/Modules/Main/MainRouter.swift | 6 ++ .../SessionResponseModule.swift | 17 ++++ .../SessionResponsePresenter.swift | 17 ++++ .../SessionResponseRouter.swift | 17 ++++ .../SessionResponse/SessionResponseView.swift | 82 +++++++++++++++++++ .../SessionAccount/SessionAccountView.swift | 24 +++--- Example/ExampleApp.xcodeproj/project.pbxproj | 24 ++++++ 8 files changed, 176 insertions(+), 16 deletions(-) create mode 100644 Example/DApp/Modules/SessionResponse/SessionResponseModule.swift create mode 100644 Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift create mode 100644 Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift create mode 100644 Example/DApp/Modules/SessionResponse/SessionResponseView.swift diff --git a/Example/DApp/Modules/Main/MainPresenter.swift b/Example/DApp/Modules/Main/MainPresenter.swift index 4dcda326e..456b5b2a8 100644 --- a/Example/DApp/Modules/Main/MainPresenter.swift +++ b/Example/DApp/Modules/Main/MainPresenter.swift @@ -31,12 +31,9 @@ final class MainPresenter { .receive(on: DispatchQueue.main) .sink { [unowned self] response in Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } - presentResponse(response: response) + router.presentResponse(response: response) } .store(in: &disposeBag) } - private func presentResponse(response: Response) { - - } } diff --git a/Example/DApp/Modules/Main/MainRouter.swift b/Example/DApp/Modules/Main/MainRouter.swift index 4b3fef3de..2f255eada 100644 --- a/Example/DApp/Modules/Main/MainRouter.swift +++ b/Example/DApp/Modules/Main/MainRouter.swift @@ -1,4 +1,5 @@ import UIKit +import WalletConnectSign final class MainRouter { weak var viewController: UIViewController! @@ -16,4 +17,9 @@ final class MainRouter { func authViewController() -> UIViewController { return AuthModule.create(app: app) } + + func presentResponse(response: Response) { + SessionResponseModule.create(app: app, sessionResponse: response) + .present(from: viewController) + } } diff --git a/Example/DApp/Modules/SessionResponse/SessionResponseModule.swift b/Example/DApp/Modules/SessionResponse/SessionResponseModule.swift new file mode 100644 index 000000000..1030c26aa --- /dev/null +++ b/Example/DApp/Modules/SessionResponse/SessionResponseModule.swift @@ -0,0 +1,17 @@ +import SwiftUI +import WalletConnectSign + +final class SessionResponseModule { + @discardableResult + static func create(app: Application, sessionResponse: Response) -> UIViewController { + let router = SessionResponseRouter(app: app) + let presenter = SessionResponsePresenter(router: router, sessionResponse: sessionResponse) + + let view = NewPairingView().environmentObject(presenter) + let viewController = UIHostingController(rootView: view) + + router.viewController = viewController + + return viewController + } +} diff --git a/Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift b/Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift new file mode 100644 index 000000000..b26818599 --- /dev/null +++ b/Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift @@ -0,0 +1,17 @@ + +import Foundation +import WalletConnectSign + +final class SessionResponsePresenter: ObservableObject, SceneViewModel { + + private let router: SessionResponseRouter + let response: Response + + init( + router: SessionResponseRouter, + sessionResponse: Response + ) { + self.router = router + self.response = sessionResponse + } +} diff --git a/Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift b/Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift new file mode 100644 index 000000000..752a95116 --- /dev/null +++ b/Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift @@ -0,0 +1,17 @@ +import UIKit + +import WalletConnectSign + +final class SessionResponseRouter { + weak var viewController: UIViewController! + + private let app: Application + + init(app: Application) { + self.app = app + } + + func dismiss() { + viewController.dismiss(animated: true) + } +} diff --git a/Example/DApp/Modules/SessionResponse/SessionResponseView.swift b/Example/DApp/Modules/SessionResponse/SessionResponseView.swift new file mode 100644 index 000000000..4160f47be --- /dev/null +++ b/Example/DApp/Modules/SessionResponse/SessionResponseView.swift @@ -0,0 +1,82 @@ +import SwiftUI +import WalletConnectSign + +struct SessionResponseView: View { + + @EnvironmentObject var presenter: SessionResponsePresenter + + var body: some View { + ZStack { + Color(red: 25/255, green: 26/255, blue: 26/255) + .ignoresSafeArea() + + responseView(response: presenter.response) + } + } + + + private func responseView(response: Response) -> some View { + ZStack { + RoundedRectangle(cornerRadius: 16) + .fill(.white.opacity(0.02)) + + VStack(spacing: 5) { + HStack { + RoundedRectangle(cornerRadius: 2) + .fill(.gray.opacity(0.5)) + .frame(width: 30, height: 4) + + } + .padding(20) + + HStack { + Group { + if case RPCResult.error(_) = response.result { + Text("❌ Response") + } else { + Text("✅ Response") + } + } + .font( + Font.system(size: 14, weight: .medium) + ) + .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) + .padding(12) + + Spacer() + + let record = Sign.instance.getSessionRequestRecord(id: response.id)! + Text(record.request.method) + .font( + Font.system(size: 14, weight: .medium) + ) + .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) + .padding(12) + } + + ZStack { + RoundedRectangle(cornerRadius: 16) + .fill(.white.opacity(0.02)) + + switch response.result { + case .response(let response): + Text(try! response.get(String.self).description) + .font(.system(size: 16, weight: .medium)) + .foregroundColor(.white) + .padding(.vertical, 12) + .padding(.horizontal, 8) + + case .error(let error): + Text(error.message) + .font(.system(size: 16, weight: .medium)) + .foregroundColor(.white) + .padding(.vertical, 12) + .padding(.horizontal, 8) + } + } + .padding(.bottom, 12) + .padding(.horizontal, 8) + } + } + } +} diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift index 1b8a3ebb8..a5c825924 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift @@ -31,18 +31,18 @@ struct SessionAccountView: View { Color(red: 25/255, green: 26/255, blue: 26/255), for: .navigationBar ) - .sheet(isPresented: $presenter.showResponse) { - ZStack { - Color(red: 25/255, green: 26/255, blue: 26/255) - .ignoresSafeArea() - - ScrollView { - responseView(response: presenter.response!) - .padding(12) - } - } - .presentationDetents([.medium]) - } +// .sheet(isPresented: $presenter.showResponse) { +// ZStack { +// Color(red: 25/255, green: 26/255, blue: 26/255) +// .ignoresSafeArea() +// +// ScrollView { +// responseView(response: presenter.response!) +// .padding(12) +// } +// } +// .presentationDetents([.medium]) +// } .alert(presenter.errorMessage, isPresented: $presenter.showError) { Button("OK", role: .cancel) {} } diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index c22452e06..3983aabc6 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -32,6 +32,10 @@ 847BD1E8298A806800076C90 /* NotificationsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1E3298A806800076C90 /* NotificationsView.swift */; }; 847BD1EB298A87AB00076C90 /* SubscriptionsViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1EA298A87AB00076C90 /* SubscriptionsViewModel.swift */; }; 847F08012A25DBFF00B2A5A4 /* XPlatformW3WTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847F08002A25DBFF00B2A5A4 /* XPlatformW3WTests.swift */; }; + 8486EDC52B4F1D04008E53C3 /* SessionResponseModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDC42B4F1D04008E53C3 /* SessionResponseModule.swift */; }; + 8486EDC92B4F1D73008E53C3 /* SessionResponsePresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */; }; + 8486EDCB2B4F1D7B008E53C3 /* SessionResponseRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */; }; + 8486EDCF2B4F1DA6008E53C3 /* SessionResponseView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */; }; 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9432A836C2A0003D5AF /* Sentry */; }; 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9452A836C3F0003D5AF /* Sentry */; }; 8487A9482A83AD680003D5AF /* LoggingService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8487A9472A83AD680003D5AF /* LoggingService.swift */; }; @@ -430,6 +434,10 @@ 847BD1E3298A806800076C90 /* NotificationsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotificationsView.swift; sourceTree = ""; }; 847BD1EA298A87AB00076C90 /* SubscriptionsViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SubscriptionsViewModel.swift; sourceTree = ""; }; 847F08002A25DBFF00B2A5A4 /* XPlatformW3WTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = XPlatformW3WTests.swift; sourceTree = ""; }; + 8486EDC42B4F1D04008E53C3 /* SessionResponseModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseModule.swift; sourceTree = ""; }; + 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponsePresenter.swift; sourceTree = ""; }; + 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseRouter.swift; sourceTree = ""; }; + 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseView.swift; sourceTree = ""; }; 8487A92E2A7BD2F30003D5AF /* XPlatformProtocolTests.xctestplan */ = {isa = PBXFileReference; lastKnownFileType = text; name = XPlatformProtocolTests.xctestplan; path = ../XPlatformProtocolTests.xctestplan; sourceTree = ""; }; 8487A9472A83AD680003D5AF /* LoggingService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoggingService.swift; sourceTree = ""; }; 849A4F18298281E300E61ACE /* WalletAppRelease.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletAppRelease.entitlements; sourceTree = ""; }; @@ -939,6 +947,17 @@ path = Web3Wallet; sourceTree = ""; }; + 8486EDC72B4F1D22008E53C3 /* SessionResponse */ = { + isa = PBXGroup; + children = ( + 8486EDC42B4F1D04008E53C3 /* SessionResponseModule.swift */, + 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */, + 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */, + 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */, + ); + path = SessionResponse; + sourceTree = ""; + }; 849D7A91292E2115006A2BD4 /* Push */ = { isa = PBXGroup; children = ( @@ -1890,6 +1909,7 @@ C5BE02062AF777AD0064FC88 /* Main */, C5B4C4C52AF12C2900B4274A /* Sign */, C5B4C4CD2AF12F0B00B4274A /* Auth */, + 8486EDC72B4F1D22008E53C3 /* SessionResponse */, ); path = Modules; sourceTree = ""; @@ -2349,12 +2369,14 @@ A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, C5BE02122AF777AD0064FC88 /* MainPresenter.swift in Sources */, + 8486EDC52B4F1D04008E53C3 /* SessionResponseModule.swift in Sources */, C5BE01E22AF693080064FC88 /* Application.swift in Sources */, C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */, A5A8E47E293A1CFE00FEB97D /* DefaultSignerFactory.swift in Sources */, C5BE020E2AF777AD0064FC88 /* MainRouter.swift in Sources */, A5A0843D29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, C5BE021F2AF79B9A0064FC88 /* SessionAccountModule.swift in Sources */, + 8486EDC92B4F1D73008E53C3 /* SessionResponsePresenter.swift in Sources */, C5BE01E42AF697100064FC88 /* UIColor.swift in Sources */, C5BE01DB2AF692060064FC88 /* AuthRouter.swift in Sources */, C5BE01E62AF697FA0064FC88 /* String.swift in Sources */, @@ -2368,9 +2390,11 @@ C5BE02112AF777AD0064FC88 /* MainViewController.swift in Sources */, C5BE021D2AF79B9A0064FC88 /* SessionAccountInteractor.swift in Sources */, A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, + 8486EDCB2B4F1D7B008E53C3 /* SessionResponseRouter.swift in Sources */, C5BE01FB2AF6CB270064FC88 /* SignRouter.swift in Sources */, C5BE01D72AF691CD0064FC88 /* AuthModule.swift in Sources */, C5BE01F72AF6CB250064FC88 /* SignModule.swift in Sources */, + 8486EDCF2B4F1DA6008E53C3 /* SessionResponseView.swift in Sources */, C5BE01FA2AF6CB270064FC88 /* SignPresenter.swift in Sources */, C5BE02132AF777AD0064FC88 /* MainInteractor.swift in Sources */, ); From 7dcf7dba12a7d034606a6cc9194c65b80294312f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jan 2024 21:00:13 +0100 Subject: [PATCH 164/814] add socket status to dapp --- Example/DApp/Common/AlertPresenter.swift | 35 ++++++++++++++++++++ Example/DApp/SceneDelegate.swift | 14 +++++++- Example/ExampleApp.xcodeproj/project.pbxproj | 12 +++++++ 3 files changed, 60 insertions(+), 1 deletion(-) create mode 100644 Example/DApp/Common/AlertPresenter.swift diff --git a/Example/DApp/Common/AlertPresenter.swift b/Example/DApp/Common/AlertPresenter.swift new file mode 100644 index 000000000..5da5d4668 --- /dev/null +++ b/Example/DApp/Common/AlertPresenter.swift @@ -0,0 +1,35 @@ +import Foundation +import SwiftMessages +import UIKit + +struct AlertPresenter { + enum MessageType { + case warning + case error + case info + case success + } + + static func present(message: String, type: AlertPresenter.MessageType) { + DispatchQueue.main.async { + let view = MessageView.viewFromNib(layout: .cardView) + switch type { + case .warning: + view.configureTheme(.warning, iconStyle: .subtle) + case .error: + view.configureTheme(.error, iconStyle: .subtle) + case .info: + view.configureTheme(.info, iconStyle: .subtle) + case .success: + view.configureTheme(.success, iconStyle: .subtle) + } + view.button?.isHidden = true + view.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + view.configureContent(title: "", body: message) + var config = SwiftMessages.Config() + config.presentationStyle = .top + config.duration = .seconds(seconds: 1.5) + SwiftMessages.show(config: config, view: view) + } + } +} diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index b52f47555..aa7e7f3ca 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -4,9 +4,11 @@ import Web3Modal import Auth import WalletConnectRelay import WalletConnectNetworking +import Combine class SceneDelegate: UIResponder, UIWindowSceneDelegate { var window: UIWindow? + private var publishers = Set() private let app = Application() @@ -30,7 +32,17 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, metadata: metadata ) - + + + Sign.instance.socketConnectionStatusPublisher.sink { status in + switch status { + case .connected: + AlertPresenter.present(message: "Your web socket has connected", type: .success) + case .disconnected: + AlertPresenter.present(message: "Your web socket is disconnected", type: .warning) + } + }.store(in: &publishers) + setupWindow(scene: scene) } diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 3983aabc6..99e22abc3 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -36,6 +36,8 @@ 8486EDC92B4F1D73008E53C3 /* SessionResponsePresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */; }; 8486EDCB2B4F1D7B008E53C3 /* SessionResponseRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */; }; 8486EDCF2B4F1DA6008E53C3 /* SessionResponseView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */; }; + 8486EDD12B4F2DC1008E53C3 /* AlertPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */; }; + 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */ = {isa = PBXBuildFile; productRef = 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */; }; 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9432A836C2A0003D5AF /* Sentry */; }; 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9452A836C3F0003D5AF /* Sentry */; }; 8487A9482A83AD680003D5AF /* LoggingService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8487A9472A83AD680003D5AF /* LoggingService.swift */; }; @@ -438,6 +440,7 @@ 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponsePresenter.swift; sourceTree = ""; }; 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseRouter.swift; sourceTree = ""; }; 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseView.swift; sourceTree = ""; }; + 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertPresenter.swift; sourceTree = ""; }; 8487A92E2A7BD2F30003D5AF /* XPlatformProtocolTests.xctestplan */ = {isa = PBXFileReference; lastKnownFileType = text; name = XPlatformProtocolTests.xctestplan; path = ../XPlatformProtocolTests.xctestplan; sourceTree = ""; }; 8487A9472A83AD680003D5AF /* LoggingService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoggingService.swift; sourceTree = ""; }; 849A4F18298281E300E61ACE /* WalletAppRelease.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletAppRelease.entitlements; sourceTree = ""; }; @@ -737,6 +740,7 @@ A54195A52934E83F0035AD19 /* Web3 in Frameworks */, 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */, A5D85228286333E300DAF5C3 /* Starscream in Frameworks */, + 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */, 84943C7B2A9BA206007EBAC2 /* Mixpanel in Frameworks */, A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */, A5BB7FA328B6A50400707FC6 /* WalletConnectAuth in Frameworks */, @@ -1448,6 +1452,7 @@ A51AC0D828E436A3001BACF9 /* InputConfig.swift */, A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */, 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */, + 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */, ); path = Common; sourceTree = ""; @@ -2044,6 +2049,7 @@ 84943C7A2A9BA206007EBAC2 /* Mixpanel */, C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, C579FEB52AFA86CD008855EB /* Web3Modal */, + 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, ); productName = DApp; productReference = 84CE641C27981DED00142511 /* DApp.app */; @@ -2383,6 +2389,7 @@ C5BE02012AF774CB0064FC88 /* NewPairingModule.swift in Sources */, C5BE02002AF774CB0064FC88 /* NewPairingRouter.swift in Sources */, C5BE01F82AF6CB270064FC88 /* SignInteractor.swift in Sources */, + 8486EDD12B4F2DC1008E53C3 /* AlertPresenter.swift in Sources */, C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */, 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */, C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */, @@ -3468,6 +3475,11 @@ isa = XCSwiftPackageProductDependency; productName = Web3Wallet; }; + 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */ = { + isa = XCSwiftPackageProductDependency; + package = 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */; + productName = SwiftMessages; + }; 8487A9432A836C2A0003D5AF /* Sentry */ = { isa = XCSwiftPackageProductDependency; package = 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */; From 1c497f71a69a79cfffd334eef27ea986d2c3872e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 09:15:29 +0100 Subject: [PATCH 165/814] display alert for sign errors --- Example/DApp/SceneDelegate.swift | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index aa7e7f3ca..952f40e68 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -33,6 +33,13 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { metadata: metadata ) + Sign.instance.logsPublisher.sink { log in + switch log { + case .error(let logMessage): + AlertPresenter.present(message: logMessage.message, type: .error) + default: return + } + }.store(in: &publishers) Sign.instance.socketConnectionStatusPublisher.sink { status in switch status { From 095355dbc1672b6fb3a6735e916dae279ca67b80 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 10:49:12 +0100 Subject: [PATCH 166/814] fix tests, add namespaces test --- .../WalletConnectRouter/Router/Router.swift | 3 +- .../AutoNamespacesValidationTests.swift | 37 +++++++++++++++++++ .../Mocks/PairingClientMock.swift | 11 ++++++ 3 files changed, 50 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectRouter/Router/Router.swift b/Sources/WalletConnectRouter/Router/Router.swift index 75a227b31..97db89059 100644 --- a/Sources/WalletConnectRouter/Router/Router.swift +++ b/Sources/WalletConnectRouter/Router/Router.swift @@ -1,5 +1,5 @@ +#if os(iOS) import UIKit - public struct WalletConnectRouter { public static func goBack(uri: String) { if #available(iOS 17, *) { @@ -13,3 +13,4 @@ public struct WalletConnectRouter { } } } +#endif diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 1942c9d75..23adb074a 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -999,4 +999,41 @@ final class AutoNamespacesValidationTests: XCTestCase { ] XCTAssertEqual(sessionNamespaces, expectedNamespaces) } + + func testSessionNamespacesContainsSupportedChainsAndMethodsWhenOptionalAndRequiredNamespacesAreEmpty() { + let requiredNamespaces = [String: ProposalNamespace]() + let optionalNamespaces = [String: ProposalNamespace]() + let sessionProposal = Session.Proposal( + id: "", + pairingTopic: "", + proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + requiredNamespaces: requiredNamespaces, + optionalNamespaces: optionalNamespaces, + sessionProperties: nil, + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + ) + let sessionNamespaces = try! AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!, Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], + methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "solana_signMessage", "solana_signMessage"], + events: ["chainChanged", "accountsChanged"], + accounts: [] + ) + let expectedNamespaces: [String: SessionNamespace] = [ + "eip155": SessionNamespace( + chains: [Blockchain("eip155:1")!], + accounts: Set([]), + methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign"], + events: ["chainChanged", "accountsChanged"] + ), + "solana": SessionNamespace( + chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], + accounts: Set([]), + methods: ["solana_signMessage"], + events: [] + ) + ] + XCTAssertEqual(sessionNamespaces, expectedNamespaces) + } + } diff --git a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift index 0f0012d59..7e2c345c4 100644 --- a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift @@ -4,6 +4,17 @@ import Combine @testable import WalletConnectPairing final class PairingClientMock: PairingClientProtocol { + var pairingStatePublisher: AnyPublisher { + pairingStatePublisherSubject.eraseToAnyPublisher() + } + var pairingStatePublisherSubject = PassthroughSubject() + + var pairingExpirationPublisher: AnyPublisher { + return pairingExpirationPublisherSubject.eraseToAnyPublisher() + } + var pairingExpirationPublisherSubject = PassthroughSubject() + + var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> { pairingDeletePublisherSubject.eraseToAnyPublisher() } From 4f892224130a666c69202d1637648058015b5e58 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 12:42:43 +0100 Subject: [PATCH 167/814] remove url from client authenticator --- .../ClientAuth/ClientIdAuthenticator.swift | 12 ++++-------- Sources/WalletConnectRelay/RelayClientFactory.swift | 3 +-- 2 files changed, 5 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift b/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift index 87a7daada..150ed00d4 100644 --- a/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift +++ b/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift @@ -1,23 +1,19 @@ import Foundation public protocol ClientIdAuthenticating { - func createAuthToken(url: String?) throws -> String + func createAuthToken(url: String) throws -> String } public final class ClientIdAuthenticator: ClientIdAuthenticating { private let clientIdStorage: ClientIdStoring - private var url: String - public init(clientIdStorage: ClientIdStoring, url: String) { + public init(clientIdStorage: ClientIdStoring) { self.clientIdStorage = clientIdStorage - self.url = url } - public func createAuthToken(url: String? = nil) throws -> String { - url.flatMap { self.url = $0 } - + public func createAuthToken(url: String) throws -> String { let keyPair = try clientIdStorage.getOrCreateKeyPair() - let payload = RelayAuthPayload(subject: getSubject(), audience: self.url) + let payload = RelayAuthPayload(subject: getSubject(), audience: url) return try payload.signAndCreateWrapper(keyPair: keyPair).jwtString } diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 26788c48f..98066e6c8 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -45,8 +45,7 @@ public struct RelayClientFactory { let clientIdStorage = ClientIdStorage(defaults: keyValueStorage, keychain: keychainStorage, logger: logger) let socketAuthenticator = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: "wss://\(relayHost)" + clientIdStorage: clientIdStorage ) let relayUrlFactory = RelayUrlFactory( relayHost: relayHost, From 2218816b733914b1b9dd44fa0f777508fbba46ba Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 12:43:04 +0100 Subject: [PATCH 168/814] savepoint --- .../AutoNamespacesValidationTests.swift | 70 +++++++++---------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 23adb074a..db78b0433 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -1000,40 +1000,40 @@ final class AutoNamespacesValidationTests: XCTestCase { XCTAssertEqual(sessionNamespaces, expectedNamespaces) } - func testSessionNamespacesContainsSupportedChainsAndMethodsWhenOptionalAndRequiredNamespacesAreEmpty() { - let requiredNamespaces = [String: ProposalNamespace]() - let optionalNamespaces = [String: ProposalNamespace]() - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) - let sessionNamespaces = try! AutoNamespaces.build( - sessionProposal: sessionProposal, - chains: [Blockchain("eip155:1")!, Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], - methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "solana_signMessage", "solana_signMessage"], - events: ["chainChanged", "accountsChanged"], - accounts: [] - ) - let expectedNamespaces: [String: SessionNamespace] = [ - "eip155": SessionNamespace( - chains: [Blockchain("eip155:1")!], - accounts: Set([]), - methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign"], - events: ["chainChanged", "accountsChanged"] - ), - "solana": SessionNamespace( - chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], - accounts: Set([]), - methods: ["solana_signMessage"], - events: [] - ) - ] - XCTAssertEqual(sessionNamespaces, expectedNamespaces) - } +// func testSessionNamespacesContainsSupportedChainsAndMethodsWhenOptionalAndRequiredNamespacesAreEmpty() { +// let requiredNamespaces = [String: ProposalNamespace]() +// let optionalNamespaces = [String: ProposalNamespace]() +// let sessionProposal = Session.Proposal( +// id: "", +// pairingTopic: "", +// proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), +// requiredNamespaces: requiredNamespaces, +// optionalNamespaces: optionalNamespaces, +// sessionProperties: nil, +// proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) +// ) +// let sessionNamespaces = try! AutoNamespaces.build( +// sessionProposal: sessionProposal, +// chains: [Blockchain("eip155:1")!, Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], +// methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "solana_signMessage", "solana_signMessage"], +// events: ["chainChanged", "accountsChanged"], +// accounts: [] +// ) +// let expectedNamespaces: [String: SessionNamespace] = [ +// "eip155": SessionNamespace( +// chains: [Blockchain("eip155:1")!], +// accounts: Set([]), +// methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign"], +// events: ["chainChanged", "accountsChanged"] +// ), +// "solana": SessionNamespace( +// chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], +// accounts: Set([]), +// methods: ["solana_signMessage"], +// events: [] +// ) +// ] +// XCTAssertEqual(sessionNamespaces, expectedNamespaces) +// } } From e2baf5bdedbc44ea4ee148a6b1a7fe2afb42a867 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 12:42:43 +0100 Subject: [PATCH 169/814] remove url from client authenticator --- .../ClientAuth/ClientIdAuthenticator.swift | 12 ++++-------- Sources/WalletConnectRelay/RelayClientFactory.swift | 3 +-- 2 files changed, 5 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift b/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift index 87a7daada..150ed00d4 100644 --- a/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift +++ b/Sources/WalletConnectRelay/ClientAuth/ClientIdAuthenticator.swift @@ -1,23 +1,19 @@ import Foundation public protocol ClientIdAuthenticating { - func createAuthToken(url: String?) throws -> String + func createAuthToken(url: String) throws -> String } public final class ClientIdAuthenticator: ClientIdAuthenticating { private let clientIdStorage: ClientIdStoring - private var url: String - public init(clientIdStorage: ClientIdStoring, url: String) { + public init(clientIdStorage: ClientIdStoring) { self.clientIdStorage = clientIdStorage - self.url = url } - public func createAuthToken(url: String? = nil) throws -> String { - url.flatMap { self.url = $0 } - + public func createAuthToken(url: String) throws -> String { let keyPair = try clientIdStorage.getOrCreateKeyPair() - let payload = RelayAuthPayload(subject: getSubject(), audience: self.url) + let payload = RelayAuthPayload(subject: getSubject(), audience: url) return try payload.signAndCreateWrapper(keyPair: keyPair).jwtString } diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 26788c48f..98066e6c8 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -45,8 +45,7 @@ public struct RelayClientFactory { let clientIdStorage = ClientIdStorage(defaults: keyValueStorage, keychain: keychainStorage, logger: logger) let socketAuthenticator = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: "wss://\(relayHost)" + clientIdStorage: clientIdStorage ) let relayUrlFactory = RelayUrlFactory( relayHost: relayHost, From 735e9721c36e957d74b9f17e42fc6cc59084872f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 12:49:39 +0100 Subject: [PATCH 170/814] fix build --- Sources/WalletConnectHistory/HistoryNetworkService.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectHistory/HistoryNetworkService.swift b/Sources/WalletConnectHistory/HistoryNetworkService.swift index f4d01ddb8..906959577 100644 --- a/Sources/WalletConnectHistory/HistoryNetworkService.swift +++ b/Sources/WalletConnectHistory/HistoryNetworkService.swift @@ -28,8 +28,8 @@ private extension HistoryNetworkService { } func getJwt(historyUrl: String) throws -> String { - let authenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage, url: historyUrl) - return try authenticator.createAuthToken() + let authenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) + return try authenticator.createAuthToken(url: historyUrl) } func host(from url: String) throws -> String { From d2af9058b4f410e0aea3d6307706bb6bebaeff2f Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 11 Jan 2024 15:16:58 +0300 Subject: [PATCH 171/814] Tests fixed --- .../RelayerTests/AuthTests/SocketAuthenticatorTests.swift | 7 ++----- Tests/RelayerTests/DispatcherTests.swift | 5 +---- 2 files changed, 3 insertions(+), 9 deletions(-) diff --git a/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift b/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift index 72dd37bc5..49df85f62 100644 --- a/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift +++ b/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift @@ -10,17 +10,14 @@ final class SocketAuthenticatorTests: XCTestCase { override func setUp() { clientIdStorage = ClientIdStorageMock() - sut = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: "wss://relay.walletconnect.com" - ) + sut = ClientIdAuthenticator(clientIdStorage: clientIdStorage) } func test() async throws { let keyRaw = Data(hex: "58e0254c211b858ef7896b00e3f36beeb13d568d47c6031c4218b87718061295") let signingKey = try SigningPrivateKey(rawRepresentation: keyRaw) clientIdStorage.keyPair = signingKey - let token = try sut.createAuthToken() + let token = try sut.createAuthToken(url: "wss://relay.walletconnect.com") XCTAssertNotNil(token) } } diff --git a/Tests/RelayerTests/DispatcherTests.swift b/Tests/RelayerTests/DispatcherTests.swift index 4ab1c0a48..8d86455df 100644 --- a/Tests/RelayerTests/DispatcherTests.swift +++ b/Tests/RelayerTests/DispatcherTests.swift @@ -64,10 +64,7 @@ final class DispatcherTests: XCTestCase { let logger = ConsoleLoggerMock() let keychainStorageMock = DispatcherKeychainStorageMock() let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychainStorageMock, logger: logger) - let socketAuthenticator = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: "wss://relay.walletconnect.com" - ) + let socketAuthenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) let relayUrlFactory = RelayUrlFactory( relayHost: "relay.walletconnect.com", projectId: "1012db890cf3cfb0c1cdc929add657ba", From c244e8be45088b6fba799041298f234e43c785d3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 13:26:05 +0100 Subject: [PATCH 172/814] savepoint --- Sources/WalletConnectHistory/HistoryNetworkService.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectHistory/HistoryNetworkService.swift b/Sources/WalletConnectHistory/HistoryNetworkService.swift index f4d01ddb8..906959577 100644 --- a/Sources/WalletConnectHistory/HistoryNetworkService.swift +++ b/Sources/WalletConnectHistory/HistoryNetworkService.swift @@ -28,8 +28,8 @@ private extension HistoryNetworkService { } func getJwt(historyUrl: String) throws -> String { - let authenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage, url: historyUrl) - return try authenticator.createAuthToken() + let authenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) + return try authenticator.createAuthToken(url: historyUrl) } func host(from url: String) throws -> String { From 6fee69536db1e76e9cc0ed9dfb52c33191c2b392 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 13:50:27 +0100 Subject: [PATCH 173/814] present pairing expired message in a wallet --- Example/WalletApp/ApplicationLayer/ConfigurationService.swift | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 81335f0d8..31ef0957b 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -58,6 +58,10 @@ final class ConfigurationService { } }.store(in: &publishers) + Web3Wallet.instance.pairingExpirationPublisher.sink { _ in + AlertPresenter.present(message: "Pairing has expired", type: .warning) + }.store(in: &publishers) + Task { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") From f1b7da1e8b67eb539753d58f8bde494d962b1e2e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 22:05:26 +0100 Subject: [PATCH 174/814] Add expiry to session proposal --- .../ConfigurationService.swift | 2 +- .../Types/Session/SessionProposal.swift | 25 +++++++++++++++++++ .../SessionProposalTests.swift | 22 ++++++++++++++++ 3 files changed, 48 insertions(+), 1 deletion(-) create mode 100644 Tests/WalletConnectSignTests/SessionProposalTests.swift diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 31ef0957b..bebebc71f 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -61,7 +61,7 @@ final class ConfigurationService { Web3Wallet.instance.pairingExpirationPublisher.sink { _ in AlertPresenter.present(message: "Pairing has expired", type: .warning) }.store(in: &publishers) - + Task { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") diff --git a/Sources/WalletConnectSign/Types/Session/SessionProposal.swift b/Sources/WalletConnectSign/Types/Session/SessionProposal.swift index fa1ee979a..8834417a9 100644 --- a/Sources/WalletConnectSign/Types/Session/SessionProposal.swift +++ b/Sources/WalletConnectSign/Types/Session/SessionProposal.swift @@ -1,11 +1,28 @@ import Foundation struct SessionProposal: Codable, Equatable { + let relays: [RelayProtocolOptions] let proposer: Participant let requiredNamespaces: [String: ProposalNamespace] let optionalNamespaces: [String: ProposalNamespace]? let sessionProperties: [String: String]? + let expiry: UInt64? + + static let proposalExpiry: TimeInterval = 300 // 5 minutes + + internal init(relays: [RelayProtocolOptions], + proposer: Participant, + requiredNamespaces: [String : ProposalNamespace], + optionalNamespaces: [String : ProposalNamespace]? = nil, + sessionProperties: [String : String]? = nil) { + self.relays = relays + self.proposer = proposer + self.requiredNamespaces = requiredNamespaces + self.optionalNamespaces = optionalNamespaces + self.sessionProperties = sessionProperties + self.expiry = UInt64(Date().timeIntervalSince1970 + Self.proposalExpiry) + } func publicRepresentation(pairingTopic: String) -> Session.Proposal { return Session.Proposal( @@ -18,4 +35,12 @@ struct SessionProposal: Codable, Equatable { proposal: self ) } + + func isExpired(currentDate: Date = Date()) -> Bool { + guard let expiry = expiry else { return false } + + let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) + + return expiryDate < currentDate + } } diff --git a/Tests/WalletConnectSignTests/SessionProposalTests.swift b/Tests/WalletConnectSignTests/SessionProposalTests.swift new file mode 100644 index 000000000..7fef2737b --- /dev/null +++ b/Tests/WalletConnectSignTests/SessionProposalTests.swift @@ -0,0 +1,22 @@ +import XCTest +@testable import WalletConnectSign + +class SessionProposalTests: XCTestCase { + + func testProposalNotExpiredImmediately() { + let proposal = SessionProposal.stub() + XCTAssertFalse(proposal.isExpired(), "Proposal should not be expired immediately after creation.") + } + + func testProposalExpired() { + let proposal = SessionProposal.stub() + let expiredDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiry! + 1)) + XCTAssertTrue(proposal.isExpired(currentDate: expiredDate), "Proposal should be expired after the expiry time.") + } + + func testProposalNotExpiredJustBeforeExpiry() { + let proposal = SessionProposal.stub() + let justBeforeExpiryDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiry! - 1)) + XCTAssertFalse(proposal.isExpired(currentDate: justBeforeExpiryDate), "Proposal should not be expired just before the expiry time.") + } +} From 9feefe211e107899081180083e752879e1638bb3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jan 2024 22:13:47 +0100 Subject: [PATCH 175/814] add backward compatibility tests for session proposal --- .../SessionProposalTests.swift | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/Tests/WalletConnectSignTests/SessionProposalTests.swift b/Tests/WalletConnectSignTests/SessionProposalTests.swift index 7fef2737b..d78180817 100644 --- a/Tests/WalletConnectSignTests/SessionProposalTests.swift +++ b/Tests/WalletConnectSignTests/SessionProposalTests.swift @@ -19,4 +19,32 @@ class SessionProposalTests: XCTestCase { let justBeforeExpiryDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiry! - 1)) XCTAssertFalse(proposal.isExpired(currentDate: justBeforeExpiryDate), "Proposal should not be expired just before the expiry time.") } + + // for backward compatibility + func testDecodingWithoutExpiry() throws { + let json = """ + { + "relays": [], + "proposer": { + "publicKey": "testKey", + "metadata": { + "name": "Wallet Connect", + "description": "A protocol to connect blockchain wallets to dapps.", + "url": "https://walletconnect.com/", + "icons": [] + } + }, + "requiredNamespaces": {}, + "optionalNamespaces": {}, + "sessionProperties": {} + } + """.data(using: .utf8)! + + let decoder = JSONDecoder() + let proposal = try decoder.decode(SessionProposal.self, from: json) + + // Assertions + XCTAssertNotNil(proposal, "Proposal should be successfully decoded even without an expiry field.") + XCTAssertNil(proposal.expiry, "Expiry should be nil if not provided in JSON.") + } } From a45b70da4ced0cc959f5e87709ec8d78ac3aa387 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 09:37:53 +0100 Subject: [PATCH 176/814] savepoint --- .../ApplicationLayer/ConfigurationService.swift | 3 ++- .../WalletConnectPairing/Types/Pairing.swift | 10 +++------- .../Engine/Common/ApproveEngine.swift | 17 +++++++++++++---- .../Engine/Common/ProposalExpiryWatcher.swift | 5 +++++ 4 files changed, 23 insertions(+), 12 deletions(-) create mode 100644 Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index bebebc71f..d079296e7 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -58,7 +58,8 @@ final class ConfigurationService { } }.store(in: &publishers) - Web3Wallet.instance.pairingExpirationPublisher.sink { _ in + Web3Wallet.instance.pairingExpirationPublisher.sink { pairing in + guard !pairing.active else { return } AlertPresenter.present(message: "Pairing has expired", type: .warning) }.store(in: &publishers) diff --git a/Sources/WalletConnectPairing/Types/Pairing.swift b/Sources/WalletConnectPairing/Types/Pairing.swift index 03ed01a41..ddd923807 100644 --- a/Sources/WalletConnectPairing/Types/Pairing.swift +++ b/Sources/WalletConnectPairing/Types/Pairing.swift @@ -1,21 +1,17 @@ import Foundation /** - A representation of an active pairing connection. + A representation of a pairing connection. */ public struct Pairing { public let topic: String public let peer: AppMetadata? public let expiryDate: Date - - public init(topic: String, peer: AppMetadata?, expiryDate: Date) { - self.topic = topic - self.peer = peer - self.expiryDate = expiryDate - } + public let active: Bool init(_ pairing: WCPairing) { self.topic = pairing.topic self.peer = pairing.peerMetadata self.expiryDate = pairing.expiryDate + self.active = pairing.active } } diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index fff6873a6..33b148d72 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -3,13 +3,14 @@ import Combine final class ApproveEngine { enum Errors: Error { - case wrongRequestParams + case proposalNotFound case relayNotFound case proposalPayloadsNotFound case pairingNotFound case sessionNotFound case agreementMissingOrInvalid case networkNotConnected + case proposalExpired } var onSessionProposal: ((Session.Proposal, VerifyContext?) -> Void)? @@ -65,16 +66,24 @@ final class ApproveEngine { func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws { logger.debug("Approving session proposal") + guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { - throw Errors.wrongRequestParams + throw Errors.proposalNotFound } - + + let proposal = payload.request + + guard !proposal.isExpired() else { + logger.debug("Proposal has expired, topic: \(payload.topic)") + proposalPayloadsStore.delete(forKey: proposerPubKey) + throw Errors.proposalExpired + } + let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { throw Errors.networkNotConnected } - let proposal = payload.request let pairingTopic = payload.topic proposalPayloadsStore.delete(forKey: proposerPubKey) diff --git a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift new file mode 100644 index 000000000..c63bef0a3 --- /dev/null +++ b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift @@ -0,0 +1,5 @@ +import Foundation + +class ProposalExpiryWatcher { + +} From 3f05c7911a14c8b02eef46745aba3b0a4a76bd9b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 10:14:54 +0100 Subject: [PATCH 177/814] add ProposalExpiryWatcher --- .../Services/Common/PairingsProvider.swift | 4 +-- .../WalletConnectPairing/Types/Pairing.swift | 8 +++++- .../Engine/Common/ProposalExpiryWatcher.swift | 26 +++++++++++++++++++ Tests/WalletConnectSignTests/Stub/Stubs.swift | 4 +-- 4 files changed, 37 insertions(+), 5 deletions(-) diff --git a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift index 99cd02ca5..76d1417f8 100644 --- a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift +++ b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift @@ -41,8 +41,8 @@ class PairingStateProvider { } private func setupPairingStateCheckTimer() { - checkTimer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [weak self] _ in - self?.checkPairingState() + checkTimer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [unowned self] _ in + checkPairingState() } } diff --git a/Sources/WalletConnectPairing/Types/Pairing.swift b/Sources/WalletConnectPairing/Types/Pairing.swift index ddd923807..84fab2f9e 100644 --- a/Sources/WalletConnectPairing/Types/Pairing.swift +++ b/Sources/WalletConnectPairing/Types/Pairing.swift @@ -1,6 +1,6 @@ import Foundation /** - A representation of a pairing connection. + A representation of an active pairing connection. */ public struct Pairing { public let topic: String @@ -8,6 +8,12 @@ public struct Pairing { public let expiryDate: Date public let active: Bool +// public init(topic: String, peer: AppMetadata?, expiryDate: Date) { +// self.topic = topic +// self.peer = peer +// self.expiryDate = expiryDate +// } + init(_ pairing: WCPairing) { self.topic = pairing.topic self.peer = pairing.peerMetadata diff --git a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift index c63bef0a3..de2a70235 100644 --- a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift +++ b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift @@ -1,5 +1,31 @@ import Foundation +import Combine class ProposalExpiryWatcher { + private let sessionProposalExpirationPublisherSubject: PassthroughSubject = .init() + + var sessionProposalExpirationPublisher: AnyPublisher { + return sessionProposalExpirationPublisherSubject.eraseToAnyPublisher() + } + + private let proposalPayloadsStore: CodableStore> + private var checkTimer: Timer? + + internal init(proposalPayloadsStore: CodableStore>) { + self.proposalPayloadsStore = proposalPayloadsStore + } + + func setUpExpiryCheckTimer() { + checkTimer = Timer.scheduledTimer(withTimeInterval: 3.0, repeats: true) { [unowned self] _ in + checkForProposalsExpiry() + } + } + + func checkForProposalsExpiry() { + proposalPayloadsStore.getAll().forEach { payload in + sessionProposalExpirationPublisherSubject.send(payload.request) + proposalPayloadsStore.delete(forKey: payload.request.proposer.publicKey) + } + } } diff --git a/Tests/WalletConnectSignTests/Stub/Stubs.swift b/Tests/WalletConnectSignTests/Stub/Stubs.swift index 2f7961e22..b1e904e85 100644 --- a/Tests/WalletConnectSignTests/Stub/Stubs.swift +++ b/Tests/WalletConnectSignTests/Stub/Stubs.swift @@ -4,11 +4,11 @@ import JSONRPC import WalletConnectKMS import WalletConnectUtils import TestingUtils -import WalletConnectPairing +@testable import WalletConnectPairing extension Pairing { static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), topic: String = String.generateTopic()) -> Pairing { - Pairing(topic: topic, peer: nil, expiryDate: expiryDate) + Pairing(WCPairing.stub(expiryDate: expiryDate, topic: topic)) } } From 185de33c576872dfa924e4386dd47b06bb777359 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 10:44:47 +0100 Subject: [PATCH 178/814] savepoint --- .../Engine/Common/ProposalExpiryWatcher.swift | 22 ++++++++++++++----- .../WalletConnectSign/Sign/SignClient.swift | 10 ++++++++- .../Sign/SignClientFactory.swift | 4 +++- .../Sign/SignClientProtocol.swift | 1 + Sources/Web3Wallet/Web3WalletClient.swift | 5 +++++ 5 files changed, 34 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift index de2a70235..6099fd945 100644 --- a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift +++ b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift @@ -3,17 +3,23 @@ import Combine class ProposalExpiryWatcher { - private let sessionProposalExpirationPublisherSubject: PassthroughSubject = .init() + private let sessionProposalExpirationPublisherSubject: PassthroughSubject = .init() + private let historyService: HistoryService - var sessionProposalExpirationPublisher: AnyPublisher { + var sessionProposalExpirationPublisher: AnyPublisher { return sessionProposalExpirationPublisherSubject.eraseToAnyPublisher() } private let proposalPayloadsStore: CodableStore> private var checkTimer: Timer? - internal init(proposalPayloadsStore: CodableStore>) { + internal init( + proposalPayloadsStore: CodableStore>, + historyService: HistoryService + ) { self.proposalPayloadsStore = proposalPayloadsStore + self.historyService = historyService + setUpExpiryCheckTimer() } func setUpExpiryCheckTimer() { @@ -23,9 +29,13 @@ class ProposalExpiryWatcher { } func checkForProposalsExpiry() { - proposalPayloadsStore.getAll().forEach { payload in - sessionProposalExpirationPublisherSubject.send(payload.request) - proposalPayloadsStore.delete(forKey: payload.request.proposer.publicKey) + historyService.getPendingProposals().forEach { proposal in + + let proposal = proposal.proposal + + sessionProposalExpirationPublisherSubject.send(proposal) + + proposalPayloadsStore.delete(forKey: proposal.id) } } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index b87864de1..8e5e1653c 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -99,6 +99,11 @@ public final class SignClient: SignClientProtocol { return logger.logsPublisher } + /// Publisher that sends session proposal expiration + public var sessionProposalExpirationPublisher: AnyPublisher { + return proposalExpiryWatcher.sessionProposalExpirationPublisher + } + /// An object that loggs SDK's errors and info messages public let logger: ConsoleLogging @@ -119,6 +124,7 @@ public final class SignClient: SignClientProtocol { private let appProposeService: AppProposeService private let historyService: HistoryService private let cleanupService: SignCleanupService + private let proposalExpiryWatcher: ProposalExpiryWatcher private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() private let sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() @@ -152,7 +158,8 @@ public final class SignClient: SignClientProtocol { disconnectService: DisconnectService, historyService: HistoryService, cleanupService: SignCleanupService, - pairingClient: PairingClient + pairingClient: PairingClient, + proposalExpiryWatcher: ProposalExpiryWatcher ) { self.logger = logger self.networkingClient = networkingClient @@ -170,6 +177,7 @@ public final class SignClient: SignClientProtocol { self.cleanupService = cleanupService self.disconnectService = disconnectService self.pairingClient = pairingClient + self.proposalExpiryWatcher = proposalExpiryWatcher setUpConnectionObserving() setUpEnginesCallbacks() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 7970d88d5..9b4ee3526 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -70,6 +70,7 @@ public struct SignClientFactory { let sessionPingService = SessionPingService(sessionStorage: sessionStore, networkingInteractor: networkingClient, logger: logger) let pairingPingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appProposerService = AppProposeService(metadata: metadata, networkingInteractor: networkingClient, kms: kms, logger: logger) + let proposalExpiryWatcher = ProposalExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, historyService: historyService) let client = SignClient( logger: logger, @@ -87,7 +88,8 @@ public struct SignClientFactory { disconnectService: disconnectService, historyService: historyService, cleanupService: cleanupService, - pairingClient: pairingClient + pairingClient: pairingClient, + proposalExpiryWatcher: proposalExpiryWatcher ) return client } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 2b174ddec..cb1a15e96 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -12,6 +12,7 @@ public protocol SignClientProtocol { var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { get } var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> { get } var logsPublisher: AnyPublisher {get} + var sessionProposalExpirationPublisher: AnyPublisher { get } func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 374d3f549..bc0857418 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -81,6 +81,11 @@ public class Web3WalletClient { .eraseToAnyPublisher() } + /// Publisher that sends session proposal expiration + var sessionProposalExpirationPublisher: AnyPublisher { + return signClient.sessionProposalExpirationPublisher + } + // MARK: - Private Properties private let authClient: AuthClientProtocol private let signClient: SignClientProtocol From 91a7dff025d26a507ef42cab18a4912ef1894f57 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 11:07:11 +0100 Subject: [PATCH 179/814] reorganise stubs --- .../ApplicationLayer/ConfigurationService.swift | 4 ++++ .../WalletConnectPairing/Types/AppMetadata.swift | 14 ++++++++++++++ Sources/WalletConnectPairing/Types/Pairing.swift | 14 ++++++++------ Sources/WalletConnectPairing/Types/WCPairing.swift | 8 ++++++++ .../Engine/Common/ProposalExpiryWatcher.swift | 3 ++- .../WalletConnectUtils/RelayProtocolOptions.swift | 8 ++++++++ Sources/Web3Wallet/Web3WalletClient.swift | 2 +- .../AuthTests/SocketAuthenticatorTests.swift | 5 ++--- Tests/RelayerTests/DispatcherTests.swift | 3 +-- Tests/TestingUtils/Stubs/AppMetadata+Stub.swift | 14 -------------- .../Stubs/RelayProtocolOptions+Stub.swift | 8 -------- .../ApproveEngineTests.swift | 2 +- Tests/WalletConnectSignTests/Stub/Stubs.swift | 12 ------------ .../Web3WalletTests/Mocks/PairingClientMock.swift | 2 +- Tests/Web3WalletTests/Mocks/SignClientMock.swift | 7 ++++++- 15 files changed, 56 insertions(+), 50 deletions(-) delete mode 100644 Tests/TestingUtils/Stubs/AppMetadata+Stub.swift delete mode 100644 Tests/TestingUtils/Stubs/RelayProtocolOptions+Stub.swift diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index d079296e7..85216a471 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -63,6 +63,10 @@ final class ConfigurationService { AlertPresenter.present(message: "Pairing has expired", type: .warning) }.store(in: &publishers) + Web3Wallet.instance.sessionProposalExpirationPublisher.sink { proposal in + AlertPresenter.present(message: "Session Proposal has expired", type: .warning) + }.store(in: &publishers) + Task { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") diff --git a/Sources/WalletConnectPairing/Types/AppMetadata.swift b/Sources/WalletConnectPairing/Types/AppMetadata.swift index 4fcfee409..0ab317f12 100644 --- a/Sources/WalletConnectPairing/Types/AppMetadata.swift +++ b/Sources/WalletConnectPairing/Types/AppMetadata.swift @@ -70,3 +70,17 @@ public struct AppMetadata: Codable, Equatable { self.redirect = redirect } } + +#if DEBUG +public extension AppMetadata { + static func stub() -> AppMetadata { + AppMetadata( + name: "Wallet Connect", + description: "A protocol to connect blockchain wallets to dapps.", + url: "https://walletconnect.com/", + icons: [], + redirect: AppMetadata.Redirect(native: "", universal: nil) + ) + } +} +#endif diff --git a/Sources/WalletConnectPairing/Types/Pairing.swift b/Sources/WalletConnectPairing/Types/Pairing.swift index 84fab2f9e..9edd37941 100644 --- a/Sources/WalletConnectPairing/Types/Pairing.swift +++ b/Sources/WalletConnectPairing/Types/Pairing.swift @@ -8,12 +8,6 @@ public struct Pairing { public let expiryDate: Date public let active: Bool -// public init(topic: String, peer: AppMetadata?, expiryDate: Date) { -// self.topic = topic -// self.peer = peer -// self.expiryDate = expiryDate -// } - init(_ pairing: WCPairing) { self.topic = pairing.topic self.peer = pairing.peerMetadata @@ -21,3 +15,11 @@ public struct Pairing { self.active = pairing.active } } + +#if DEBUG +extension Pairing { + static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), topic: String = String.generateTopic()) -> Pairing { + Pairing(WCPairing.stub(expiryDate: expiryDate, topic: topic)) + } +} +#endif diff --git a/Sources/WalletConnectPairing/Types/WCPairing.swift b/Sources/WalletConnectPairing/Types/WCPairing.swift index d87bd8946..3fe7cfe8a 100644 --- a/Sources/WalletConnectPairing/Types/WCPairing.swift +++ b/Sources/WalletConnectPairing/Types/WCPairing.swift @@ -75,3 +75,11 @@ public struct WCPairing: SequenceObject { expiryDate = newExpiryDate } } + +#if DEBUG +extension WCPairing { + static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), isActive: Bool = true, topic: String = String.generateTopic()) -> WCPairing { + WCPairing(topic: topic, relay: RelayProtocolOptions.stub(), peerMetadata: AppMetadata.stub(), isActive: isActive, expiryDate: expiryDate) + } +} +#endif diff --git a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift index 6099fd945..7d6c3cf0b 100644 --- a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift +++ b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift @@ -29,7 +29,8 @@ class ProposalExpiryWatcher { } func checkForProposalsExpiry() { - historyService.getPendingProposals().forEach { proposal in + let proposals = historyService.getPendingProposals() + proposals.forEach { proposal in let proposal = proposal.proposal diff --git a/Sources/WalletConnectUtils/RelayProtocolOptions.swift b/Sources/WalletConnectUtils/RelayProtocolOptions.swift index e437e9342..5a19d9f05 100644 --- a/Sources/WalletConnectUtils/RelayProtocolOptions.swift +++ b/Sources/WalletConnectUtils/RelayProtocolOptions.swift @@ -9,3 +9,11 @@ public struct RelayProtocolOptions: Codable, Equatable { self.data = data } } + +#if DEBUG +public extension RelayProtocolOptions { + static func stub() -> RelayProtocolOptions { + RelayProtocolOptions(protocol: "", data: nil) + } +} +#endif diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index bc0857418..a72f61a1f 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -82,7 +82,7 @@ public class Web3WalletClient { } /// Publisher that sends session proposal expiration - var sessionProposalExpirationPublisher: AnyPublisher { + public var sessionProposalExpirationPublisher: AnyPublisher { return signClient.sessionProposalExpirationPublisher } diff --git a/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift b/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift index 72dd37bc5..bd9371931 100644 --- a/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift +++ b/Tests/RelayerTests/AuthTests/SocketAuthenticatorTests.swift @@ -11,8 +11,7 @@ final class SocketAuthenticatorTests: XCTestCase { override func setUp() { clientIdStorage = ClientIdStorageMock() sut = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: "wss://relay.walletconnect.com" + clientIdStorage: clientIdStorage ) } @@ -20,7 +19,7 @@ final class SocketAuthenticatorTests: XCTestCase { let keyRaw = Data(hex: "58e0254c211b858ef7896b00e3f36beeb13d568d47c6031c4218b87718061295") let signingKey = try SigningPrivateKey(rawRepresentation: keyRaw) clientIdStorage.keyPair = signingKey - let token = try sut.createAuthToken() + let token = try sut.createAuthToken(url: "wss://relay.walletconnect.com") XCTAssertNotNil(token) } } diff --git a/Tests/RelayerTests/DispatcherTests.swift b/Tests/RelayerTests/DispatcherTests.swift index 4ab1c0a48..87035e364 100644 --- a/Tests/RelayerTests/DispatcherTests.swift +++ b/Tests/RelayerTests/DispatcherTests.swift @@ -65,8 +65,7 @@ final class DispatcherTests: XCTestCase { let keychainStorageMock = DispatcherKeychainStorageMock() let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychainStorageMock, logger: logger) let socketAuthenticator = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: "wss://relay.walletconnect.com" + clientIdStorage: clientIdStorage ) let relayUrlFactory = RelayUrlFactory( relayHost: "relay.walletconnect.com", diff --git a/Tests/TestingUtils/Stubs/AppMetadata+Stub.swift b/Tests/TestingUtils/Stubs/AppMetadata+Stub.swift deleted file mode 100644 index ffa368454..000000000 --- a/Tests/TestingUtils/Stubs/AppMetadata+Stub.swift +++ /dev/null @@ -1,14 +0,0 @@ -import Foundation -import WalletConnectPairing - -public extension AppMetadata { - static func stub() -> AppMetadata { - AppMetadata( - name: "Wallet Connect", - description: "A protocol to connect blockchain wallets to dapps.", - url: "https://walletconnect.com/", - icons: [], - redirect: AppMetadata.Redirect(native: "", universal: nil) - ) - } -} diff --git a/Tests/TestingUtils/Stubs/RelayProtocolOptions+Stub.swift b/Tests/TestingUtils/Stubs/RelayProtocolOptions+Stub.swift deleted file mode 100644 index bd3db0839..000000000 --- a/Tests/TestingUtils/Stubs/RelayProtocolOptions+Stub.swift +++ /dev/null @@ -1,8 +0,0 @@ -import WalletConnectUtils - -extension RelayProtocolOptions { - - public static func stub() -> RelayProtocolOptions { - RelayProtocolOptions(protocol: "", data: nil) - } -} diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index 928a4600f..d40aee9dc 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -1,8 +1,8 @@ import XCTest import Combine import JSONRPC -import WalletConnectPairing import WalletConnectNetworking +@testable import WalletConnectPairing @testable import WalletConnectSign @testable import TestingUtils @testable import WalletConnectKMS diff --git a/Tests/WalletConnectSignTests/Stub/Stubs.swift b/Tests/WalletConnectSignTests/Stub/Stubs.swift index b1e904e85..9666beccf 100644 --- a/Tests/WalletConnectSignTests/Stub/Stubs.swift +++ b/Tests/WalletConnectSignTests/Stub/Stubs.swift @@ -6,18 +6,6 @@ import WalletConnectUtils import TestingUtils @testable import WalletConnectPairing -extension Pairing { - static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), topic: String = String.generateTopic()) -> Pairing { - Pairing(WCPairing.stub(expiryDate: expiryDate, topic: topic)) - } -} - -extension WCPairing { - static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), isActive: Bool = true, topic: String = String.generateTopic()) -> WCPairing { - WCPairing(topic: topic, relay: RelayProtocolOptions.stub(), peerMetadata: AppMetadata.stub(), isActive: isActive, expiryDate: expiryDate) - } -} - extension ProposalNamespace { static func stubDictionary() -> [String: ProposalNamespace] { return [ diff --git a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift index 7e2c345c4..3e752da08 100644 --- a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift @@ -40,6 +40,6 @@ final class PairingClientMock: PairingClientProtocol { } func getPairings() -> [Pairing] { - return [Pairing(topic: "", peer: nil, expiryDate: Date())] + return [Pairing(WCPairing.stub())] } } diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index de4b3cb22..ba53b83a2 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -4,6 +4,7 @@ import Combine @testable import WalletConnectSign final class SignClientMock: SignClientProtocol { + private var logsSubject = PassthroughSubject() var logsPublisher: AnyPublisher { @@ -74,7 +75,11 @@ final class SignClientMock: SignClientProtocol { ) .eraseToAnyPublisher() } - + + var sessionProposalExpirationPublisher: AnyPublisher { + fatalError() + } + var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { let sessionProposal = Session.Proposal( id: "", From 74bf4299246cf33832e2098f555f9c5de8fd2615 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 12:47:10 +0100 Subject: [PATCH 180/814] update proposal expiry watcher --- .../Engine/Common/ProposalExpiryWatcher.swift | 19 +++++++++---------- Sources/WalletConnectSign/Session.swift | 6 +++++- .../Sign/SignClientFactory.swift | 2 +- 3 files changed, 15 insertions(+), 12 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift index 7d6c3cf0b..db6d0121a 100644 --- a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift +++ b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift @@ -4,7 +4,7 @@ import Combine class ProposalExpiryWatcher { private let sessionProposalExpirationPublisherSubject: PassthroughSubject = .init() - private let historyService: HistoryService + private let rpcHistory: RPCHistory var sessionProposalExpirationPublisher: AnyPublisher { return sessionProposalExpirationPublisherSubject.eraseToAnyPublisher() @@ -15,10 +15,10 @@ class ProposalExpiryWatcher { internal init( proposalPayloadsStore: CodableStore>, - historyService: HistoryService + rpcHistory: RPCHistory ) { self.proposalPayloadsStore = proposalPayloadsStore - self.historyService = historyService + self.rpcHistory = rpcHistory setUpExpiryCheckTimer() } @@ -29,14 +29,13 @@ class ProposalExpiryWatcher { } func checkForProposalsExpiry() { - let proposals = historyService.getPendingProposals() + let proposals = proposalPayloadsStore.getAll() proposals.forEach { proposal in - - let proposal = proposal.proposal - - sessionProposalExpirationPublisherSubject.send(proposal) - - proposalPayloadsStore.delete(forKey: proposal.id) + let pairingTopic = proposal.topic + guard proposal.request.isExpired() else { return } + sessionProposalExpirationPublisherSubject.send(proposal.request.publicRepresentation(pairingTopic: pairingTopic)) + proposalPayloadsStore.delete(forKey: proposal.request.proposer.publicKey) + rpcHistory.delete(id: proposal.id) } } } diff --git a/Sources/WalletConnectSign/Session.swift b/Sources/WalletConnectSign/Session.swift index 7e0d24fb4..06b2500f7 100644 --- a/Sources/WalletConnectSign/Session.swift +++ b/Sources/WalletConnectSign/Session.swift @@ -28,7 +28,11 @@ extension Session { // TODO: Refactor internal objects to manage only needed data internal let proposal: SessionProposal - + + func isExpired() -> Bool { + return proposal.isExpired() + } + init( id: String, pairingTopic: String, diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 9b4ee3526..2de6eed53 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -70,7 +70,7 @@ public struct SignClientFactory { let sessionPingService = SessionPingService(sessionStorage: sessionStore, networkingInteractor: networkingClient, logger: logger) let pairingPingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appProposerService = AppProposeService(metadata: metadata, networkingInteractor: networkingClient, kms: kms, logger: logger) - let proposalExpiryWatcher = ProposalExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, historyService: historyService) + let proposalExpiryWatcher = ProposalExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, rpcHistory: rpcHistory) let client = SignClient( logger: logger, From a6a77f898fdd5a952d080e8bfe0a7d226ac2fc73 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 13:00:09 +0100 Subject: [PATCH 181/814] add localised description for errors --- .../Engine/Common/ApproveEngine.swift | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 33b148d72..126ec07c9 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -5,7 +5,6 @@ final class ApproveEngine { enum Errors: Error { case proposalNotFound case relayNotFound - case proposalPayloadsNotFound case pairingNotFound case sessionNotFound case agreementMissingOrInvalid @@ -135,7 +134,7 @@ final class ApproveEngine { func reject(proposerPubKey: String, reason: SignReasonCode) async throws { guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { - throw Errors.proposalPayloadsNotFound + throw Errors.proposalNotFound } if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, @@ -434,8 +433,20 @@ private extension ApproveEngine { extension ApproveEngine.Errors: LocalizedError { var errorDescription: String? { switch self { - case .networkNotConnected: return "Action failed. You seem to be offline" - default: return "" + case .proposalNotFound: + return "Proposal not found." + case .relayNotFound: + return "Relay not found." + case .pairingNotFound: + return "Pairing not found." + case .sessionNotFound: + return "Session not found." + case .agreementMissingOrInvalid: + return "Agreement missing or invalid." + case .networkNotConnected: + return "Network not connected." + case .proposalExpired: + return "Proposal expired." } } } From e7f90aa1ee7f28711993e4269d79083adf390abe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 13:02:57 +0100 Subject: [PATCH 182/814] add dismiss button to proposal screen --- .../SessionProposal/SessionProposalPresenter.swift | 4 ++++ .../SessionProposal/SessionProposalView.swift | 13 +++++++++++++ 2 files changed, 17 insertions(+) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 07a78d931..84c3eb7de 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -63,6 +63,10 @@ final class SessionProposalPresenter: ObservableObject { func onConnectedSheetDismiss() { router.dismiss() } + + func dismiss() { + router.dismiss() + } } // MARK: - Private functions diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift index 19ee52d1e..02f4b0401 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift @@ -13,6 +13,19 @@ struct SessionProposalView: View { VStack { Spacer() + VStack { + HStack { + Spacer() + Button(action: { + presenter.dismiss() + }) { + Image(systemName: "xmark") + .foregroundColor(.white) + .padding() + } + } + .padding() + } VStack(spacing: 0) { Image("header") .resizable() From 777cac9996432a883104b095fbf06cfb5557a3f0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 15:32:31 +0100 Subject: [PATCH 183/814] add PendingProposalsProvider --- .../Wallet/Wallet/WalletInteractor.swift | 6 +--- .../Engine/Common/File.swift | 34 +++++++++++++++++++ .../Engine/Common/ProposalExpiryWatcher.swift | 12 +++---- .../WalletConnectSign/Sign/SignClient.swift | 19 +++++------ .../Sign/SignClientFactory.swift | 4 ++- .../Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 12 +++---- 7 files changed, 58 insertions(+), 31 deletions(-) create mode 100644 Sources/WalletConnectSign/Engine/Common/File.swift diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletInteractor.swift index 3a32be3f8..2b3c7ff4b 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletInteractor.swift @@ -19,11 +19,7 @@ final class WalletInteractor { func disconnectSession(session: Session) async throws { try await Web3Wallet.instance.disconnect(topic: session.topic) } - - func getPendingProposals() -> [(proposal: Session.Proposal, context: VerifyContext?)] { - Web3Wallet.instance.getPendingProposals() - } - + func getPendingRequests() -> [(request: Request, context: VerifyContext?)] { Web3Wallet.instance.getPendingRequests() } diff --git a/Sources/WalletConnectSign/Engine/Common/File.swift b/Sources/WalletConnectSign/Engine/Common/File.swift new file mode 100644 index 000000000..6bebd4e31 --- /dev/null +++ b/Sources/WalletConnectSign/Engine/Common/File.swift @@ -0,0 +1,34 @@ +import Foundation +import Combine + +class PendingProposalsProvider { + + private let proposalPayloadsStore: CodableStore> + private let verifyContextStore: CodableStore + private var publishers = Set() + private let pendingProposalsPublisherSubject = PassthroughSubject<[(proposal: Session.Proposal, context: VerifyContext?)], Never>() + + var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { + return pendingProposalsPublisherSubject.eraseToAnyPublisher() + } + + internal init( + proposalPayloadsStore: CodableStore>, + verifyContextStore: CodableStore) + { + self.proposalPayloadsStore = proposalPayloadsStore + self.verifyContextStore = verifyContextStore + setUpPendingProposalsPublisher() + } + + func setUpPendingProposalsPublisher() { + proposalPayloadsStore.storeUpdatePublisher.sink { [unowned self] _ in + let proposals = proposalPayloadsStore.getAll() + + let proposalsWithVerifyContext = proposals.map { ($0.request.publicRepresentation(pairingTopic: $0.topic), try? verifyContextStore.get(key: $0.request.proposer.publicKey)) + } + pendingProposalsPublisherSubject.send(proposalsWithVerifyContext) + + }.store(in: &publishers) + } +} diff --git a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift index db6d0121a..94bc407ca 100644 --- a/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift +++ b/Sources/WalletConnectSign/Engine/Common/ProposalExpiryWatcher.swift @@ -30,12 +30,12 @@ class ProposalExpiryWatcher { func checkForProposalsExpiry() { let proposals = proposalPayloadsStore.getAll() - proposals.forEach { proposal in - let pairingTopic = proposal.topic - guard proposal.request.isExpired() else { return } - sessionProposalExpirationPublisherSubject.send(proposal.request.publicRepresentation(pairingTopic: pairingTopic)) - proposalPayloadsStore.delete(forKey: proposal.request.proposer.publicKey) - rpcHistory.delete(id: proposal.id) + proposals.forEach { proposalPayload in + let pairingTopic = proposalPayload.topic + guard proposalPayload.request.isExpired() else { return } + sessionProposalExpirationPublisherSubject.send(proposalPayload.request.publicRepresentation(pairingTopic: pairingTopic)) + proposalPayloadsStore.delete(forKey: proposalPayload.request.proposer.publicKey) + rpcHistory.delete(id: proposalPayload.id) } } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 8e5e1653c..730083d16 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -104,6 +104,10 @@ public final class SignClient: SignClientProtocol { return proposalExpiryWatcher.sessionProposalExpirationPublisher } + public var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { + return pendingProposalsProvider.pendingProposalsPublisher + } + /// An object that loggs SDK's errors and info messages public let logger: ConsoleLogging @@ -125,6 +129,7 @@ public final class SignClient: SignClientProtocol { private let historyService: HistoryService private let cleanupService: SignCleanupService private let proposalExpiryWatcher: ProposalExpiryWatcher + private let pendingProposalsProvider: PendingProposalsProvider private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() private let sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() @@ -159,7 +164,8 @@ public final class SignClient: SignClientProtocol { historyService: HistoryService, cleanupService: SignCleanupService, pairingClient: PairingClient, - proposalExpiryWatcher: ProposalExpiryWatcher + proposalExpiryWatcher: ProposalExpiryWatcher, + pendingProposalsProvider: PendingProposalsProvider ) { self.logger = logger self.networkingClient = networkingClient @@ -178,6 +184,7 @@ public final class SignClient: SignClientProtocol { self.disconnectService = disconnectService self.pairingClient = pairingClient self.proposalExpiryWatcher = proposalExpiryWatcher + self.pendingProposalsProvider = pendingProposalsProvider setUpConnectionObserving() setUpEnginesCallbacks() @@ -311,16 +318,6 @@ public final class SignClient: SignClientProtocol { return historyService.getPendingRequests() } } - - /// Query pending proposals - /// - Returns: Pending proposals received from peer with `wc_sessionPropose` protocol method - public func getPendingProposals(topic: String? = nil) -> [(proposal: Session.Proposal, context: VerifyContext?)] { - if let topic = topic { - return historyService.getPendingProposals(topic: topic) - } else { - return historyService.getPendingProposals() - } - } /// - Parameter id: id of a wc_sessionRequest jsonrpc request /// - Returns: json rpc record object for given id or nil if record for give id does not exits diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 2de6eed53..7bb885cc7 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -71,6 +71,7 @@ public struct SignClientFactory { let pairingPingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appProposerService = AppProposeService(metadata: metadata, networkingInteractor: networkingClient, kms: kms, logger: logger) let proposalExpiryWatcher = ProposalExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, rpcHistory: rpcHistory) + let pendingProposalsProvider = PendingProposalsProvider(proposalPayloadsStore: proposalPayloadsStore, verifyContextStore: verifyContextStore) let client = SignClient( logger: logger, @@ -89,7 +90,8 @@ public struct SignClientFactory { historyService: historyService, cleanupService: cleanupService, pairingClient: pairingClient, - proposalExpiryWatcher: proposalExpiryWatcher + proposalExpiryWatcher: proposalExpiryWatcher, + pendingProposalsProvider: pendingProposalsProvider ) return client } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index cb1a15e96..55afdccda 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -13,6 +13,7 @@ public protocol SignClientProtocol { var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> { get } var logsPublisher: AnyPublisher {get} var sessionProposalExpirationPublisher: AnyPublisher { get } + var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { get } func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws @@ -27,6 +28,5 @@ public protocol SignClientProtocol { func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] - func getPendingProposals(topic: String?) -> [(proposal: Session.Proposal, context: VerifyContext?)] func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index a72f61a1f..78a515a14 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -86,6 +86,10 @@ public class Web3WalletClient { return signClient.sessionProposalExpirationPublisher } + public var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { + return signClient.pendingProposalsPublisher + } + // MARK: - Private Properties private let authClient: AuthClientProtocol private let signClient: SignClientProtocol @@ -216,13 +220,7 @@ public class Web3WalletClient { public func getPendingRequests(topic: String? = nil) -> [(request: Request, context: VerifyContext?)] { signClient.getPendingRequests(topic: topic) } - - /// Query pending proposals - /// - Returns: Pending proposals received from peer with `wc_sessionPropose` protocol method - public func getPendingProposals(topic: String? = nil) -> [(proposal: Session.Proposal, context: VerifyContext?)] { - signClient.getPendingProposals(topic: topic) - } - + /// - Parameter id: id of a wc_sessionRequest jsonrpc request /// - Returns: json rpc record object for given id or nil if record for give id does not exits public func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? { From ee79af8023b04334e9aeb84b1bc6acaa1144e7d6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 15:44:29 +0100 Subject: [PATCH 184/814] dismiss on session proposal expired --- .../SessionProposal/SessionProposalPresenter.swift | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 84c3eb7de..99fe3bec7 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -72,7 +72,14 @@ final class SessionProposalPresenter: ObservableObject { // MARK: - Private functions private extension SessionProposalPresenter { func setupInitialState() { - + Web3Wallet.instance.pendingProposalsPublisher.sink { [weak self] proposals in + guard let self = self else { return } + if !proposals.contains(where: { (proposal: Session.Proposal, context: VerifyContext?) in + proposal.id == self.sessionProposal.id + }) { + dismiss() + } + }.store(in: &disposeBag) } } From 82ef9aacf64da45adb8debd291aa93552ba76869 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 15:46:56 +0100 Subject: [PATCH 185/814] fix crash --- .../Wallet/SessionProposal/SessionProposalRouter.swift | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift index cd9de7971..559009c2e 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift @@ -10,6 +10,8 @@ final class SessionProposalRouter { } func dismiss() { - viewController.dismiss() + DispatchQueue.main.async { [weak self] in + self?.viewController.dismiss() + } } } From dc3ae63f5466ec9df5bb974fb244c18cc537d7d2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Jan 2024 15:56:53 +0100 Subject: [PATCH 186/814] remove pending proposals from history service --- .../Services/HistoryService.swift | 50 ------------------- .../Mocks/SignClientMock.swift | 4 -- 2 files changed, 54 deletions(-) diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index 2a5974471..a64144a71 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -3,16 +3,13 @@ import Foundation final class HistoryService { private let history: RPCHistory - private let proposalPayloadsStore: CodableStore> private let verifyContextStore: CodableStore init( history: RPCHistory, - proposalPayloadsStore: CodableStore>, verifyContextStore: CodableStore ) { self.history = history - self.proposalPayloadsStore = proposalPayloadsStore self.verifyContextStore = verifyContextStore } @@ -34,32 +31,6 @@ final class HistoryService { func getPendingRequests(topic: String) -> [(request: Request, context: VerifyContext?)] { return getPendingRequests().filter { $0.request.topic == topic } } - - func getPendingProposals() -> [(proposal: Session.Proposal, context: VerifyContext?)] { - let pendingHistory = history.getPending() - - let requestSubscriptionPayloads = pendingHistory - .compactMap { record -> RequestSubscriptionPayload? in - guard let proposalParams = mapProposeParams(record) else { - return nil - } - return RequestSubscriptionPayload(id: record.id, topic: record.topic, request: proposalParams, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) - } - - requestSubscriptionPayloads.forEach { - let proposal = $0.request - proposalPayloadsStore.set($0, forKey: proposal.proposer.publicKey) - } - - let proposals = pendingHistory - .compactMap { mapProposalRecord($0) } - - return proposals.map { ($0, try? verifyContextStore.get(key: $0.proposal.proposer.publicKey)) } - } - - func getPendingProposals(topic: String) -> [(proposal: Session.Proposal, context: VerifyContext?)] { - return getPendingProposals().filter { $0.proposal.pairingTopic == topic } - } } private extension HistoryService { @@ -76,25 +47,4 @@ private extension HistoryService { expiry: request.request.expiry ) } - - func mapProposeParams(_ record: RPCHistory.Record) -> SessionType.ProposeParams? { - guard let proposal = try? record.request.params?.get(SessionType.ProposeParams.self) - else { return nil } - return proposal - } - - func mapProposalRecord(_ record: RPCHistory.Record) -> Session.Proposal? { - guard let proposal = try? record.request.params?.get(SessionType.ProposeParams.self) - else { return nil } - - return Session.Proposal( - id: proposal.proposer.publicKey, - pairingTopic: record.topic, - proposer: proposal.proposer.metadata, - requiredNamespaces: proposal.requiredNamespaces, - optionalNamespaces: proposal.optionalNamespaces ?? [:], - sessionProperties: proposal.sessionProperties, - proposal: proposal - ) - } } diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index ba53b83a2..75a788a55 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -136,10 +136,6 @@ final class SignClientMock: SignClientProtocol { return [WalletConnectSign.Session(topic: "", pairingTopic: "", peer: metadata, requiredNamespaces: [:], namespaces: [:], sessionProperties: nil, expiryDate: Date())] } - func getPendingProposals(topic: String?) -> [(proposal: WalletConnectSign.Session.Proposal, context: VerifyContext?)] { - return [] - } - func getPendingRequests(topic: String?) -> [(request: WalletConnectSign.Request, context: WalletConnectSign.VerifyContext?)] { return [(request, nil)] } From a5eeabdb10c9383ef143f753680c299b57acc29a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 08:12:14 +0100 Subject: [PATCH 187/814] fix tests buil --- Example/RelayIntegrationTests/RelayClientEndToEndTests.swift | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index e6e5263ae..119a62901 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -35,8 +35,7 @@ final class RelayClientEndToEndTests: XCTestCase { let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) let clientIdStorage = ClientIdStorage(defaults: keyValueStorage, keychain: KeychainStorageMock(), logger: logger) let socketAuthenticator = ClientIdAuthenticator( - clientIdStorage: clientIdStorage, - url: InputConfig.relayUrl + clientIdStorage: clientIdStorage ) let urlFactory = RelayUrlFactory( relayHost: InputConfig.relayHost, From 2a6e7d0fc39d91e99c5a5c49ca5d66a80a454a73 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 08:38:04 +0100 Subject: [PATCH 188/814] remove tabbar from dapp --- .../DApp/Modules/Auth/AuthInteractor.swift | 3 - Example/DApp/Modules/Auth/AuthModule.swift | 16 -- Example/DApp/Modules/Auth/AuthPresenter.swift | 116 --------------- Example/DApp/Modules/Auth/AuthRouter.swift | 16 -- Example/DApp/Modules/Auth/AuthView.swift | 140 ------------------ .../DApp/Modules/Main/MainInteractor.swift | 3 - Example/DApp/Modules/Main/MainModule.swift | 15 -- Example/DApp/Modules/Main/MainPresenter.swift | 39 ----- Example/DApp/Modules/Main/MainRouter.swift | 25 ---- .../Modules/Main/MainViewController.swift | 43 ------ Example/DApp/Modules/Main/Model/TabPage.swift | 32 ---- Example/DApp/SceneDelegate.swift | 2 +- Example/ExampleApp.xcodeproj/project.pbxproj | 68 --------- .../Sign/SignClientFactory.swift | 2 +- 14 files changed, 2 insertions(+), 518 deletions(-) delete mode 100644 Example/DApp/Modules/Auth/AuthInteractor.swift delete mode 100644 Example/DApp/Modules/Auth/AuthModule.swift delete mode 100644 Example/DApp/Modules/Auth/AuthPresenter.swift delete mode 100644 Example/DApp/Modules/Auth/AuthRouter.swift delete mode 100644 Example/DApp/Modules/Auth/AuthView.swift delete mode 100644 Example/DApp/Modules/Main/MainInteractor.swift delete mode 100644 Example/DApp/Modules/Main/MainModule.swift delete mode 100644 Example/DApp/Modules/Main/MainPresenter.swift delete mode 100644 Example/DApp/Modules/Main/MainRouter.swift delete mode 100644 Example/DApp/Modules/Main/MainViewController.swift delete mode 100644 Example/DApp/Modules/Main/Model/TabPage.swift diff --git a/Example/DApp/Modules/Auth/AuthInteractor.swift b/Example/DApp/Modules/Auth/AuthInteractor.swift deleted file mode 100644 index ffddc61dd..000000000 --- a/Example/DApp/Modules/Auth/AuthInteractor.swift +++ /dev/null @@ -1,3 +0,0 @@ -import Foundation - -final class AuthInteractor {} diff --git a/Example/DApp/Modules/Auth/AuthModule.swift b/Example/DApp/Modules/Auth/AuthModule.swift deleted file mode 100644 index 9252f89e3..000000000 --- a/Example/DApp/Modules/Auth/AuthModule.swift +++ /dev/null @@ -1,16 +0,0 @@ -import SwiftUI - -final class AuthModule { - @discardableResult - static func create(app: Application) -> UIViewController { - let router = AuthRouter(app: app) - let interactor = AuthInteractor() - let presenter = AuthPresenter(interactor: interactor, router: router) - let view = AuthView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } -} diff --git a/Example/DApp/Modules/Auth/AuthPresenter.swift b/Example/DApp/Modules/Auth/AuthPresenter.swift deleted file mode 100644 index 8e01e32e6..000000000 --- a/Example/DApp/Modules/Auth/AuthPresenter.swift +++ /dev/null @@ -1,116 +0,0 @@ -import UIKit -import Combine - -import Auth - -final class AuthPresenter: ObservableObject { - enum SigningState { - case none - case signed(Cacao) - case error(Error) - } - - private let interactor: AuthInteractor - private let router: AuthRouter - - @Published var qrCodeImageData: Data? - @Published var signingState = SigningState.none - @Published var showSigningState = false - - private var walletConnectUri: WalletConnectURI? - - private var subscriptions = Set() - - init( - interactor: AuthInteractor, - router: AuthRouter - ) { - defer { - Task { - await setupInitialState() - } - } - self.interactor = interactor - self.router = router - } - - func onAppear() { - generateQR() - } - - func copyUri() { - UIPasteboard.general.string = walletConnectUri?.absoluteString - } - - func connectWallet() { - if let walletConnectUri { - let walletUri = URL(string: "walletapp://wc?uri=\(walletConnectUri.deeplinkUri.removingPercentEncoding!)")! - DispatchQueue.main.async { - UIApplication.shared.open(walletUri) - } - } - } -} - -// MARK: - Private functions -extension AuthPresenter { - @MainActor - private func setupInitialState() { - Auth.instance.authResponsePublisher.sink { [weak self] (_, result) in - switch result { - case .success(let cacao): - self?.signingState = .signed(cacao) - self?.generateQR() - self?.showSigningState.toggle() - - case .failure(let error): - self?.signingState = .error(error) - self?.showSigningState.toggle() - } - } - .store(in: &subscriptions) - } - - private func generateQR() { - Task { @MainActor in - let uri = try! await Pair.instance.create() - walletConnectUri = uri - try await Auth.instance.request(.stub(), topic: uri.topic) - let qrCodeImage = QRCodeGenerator.generateQRCode(from: uri.absoluteString) - DispatchQueue.main.async { - self.qrCodeImageData = qrCodeImage.pngData() - } - } - } -} - -// MARK: - SceneViewModel -extension AuthPresenter: SceneViewModel {} - -// MARK: - Auth request stub -private extension RequestParams { - static func stub( - domain: String = "service.invalid", - chainId: String = "eip155:1", - nonce: String = "32891756", - aud: String = "https://service.invalid/login", - nbf: String? = nil, - exp: String? = nil, - statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", - requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] - ) -> RequestParams { - return RequestParams( - domain: domain, - chainId: chainId, - nonce: nonce, - aud: aud, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources - ) - } -} - diff --git a/Example/DApp/Modules/Auth/AuthRouter.swift b/Example/DApp/Modules/Auth/AuthRouter.swift deleted file mode 100644 index 3caacfd38..000000000 --- a/Example/DApp/Modules/Auth/AuthRouter.swift +++ /dev/null @@ -1,16 +0,0 @@ -import UIKit - -final class AuthRouter { - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func dismiss() { - viewController.dismiss(animated: true) - UIApplication.shared.open(URL(string: "showcase://")!) - } -} diff --git a/Example/DApp/Modules/Auth/AuthView.swift b/Example/DApp/Modules/Auth/AuthView.swift deleted file mode 100644 index 8e15bacc0..000000000 --- a/Example/DApp/Modules/Auth/AuthView.swift +++ /dev/null @@ -1,140 +0,0 @@ -import SwiftUI - -struct AuthView: View { - @EnvironmentObject var presenter: AuthPresenter - - var body: some View { - NavigationStack { - ZStack { - Color(red: 25/255, green: 26/255, blue: 26/255) - .ignoresSafeArea() - - VStack { - ZStack { - RoundedRectangle(cornerRadius: 25) - .fill(.white) - .aspectRatio(1, contentMode: .fit) - .padding(20) - - if let data = presenter.qrCodeImageData { - let qrCodeImage = UIImage(data: data) ?? UIImage() - Image(uiImage: qrCodeImage) - .resizable() - .aspectRatio(1, contentMode: .fit) - .padding(40) - } - } - - Button { - presenter.connectWallet() - } label: { - Text("Connect Sample Wallet") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(Color(red: 95/255, green: 159/255, blue: 248/255)) - .cornerRadius(16) - } - - Button { - presenter.copyUri() - } label: { - HStack { - Image("copy") - Text("Copy link") - .font(.system(size: 14, weight: .semibold)) - .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - } - } - .padding(.top, 16) - - Spacer() - } - } - .navigationTitle("Auth") - .navigationBarTitleDisplayMode(.inline) - .toolbarColorScheme(.dark, for: .navigationBar) - .toolbarBackground(.visible, for: .navigationBar) - .toolbarBackground( - Color(red: 25/255, green: 26/255, blue: 26/255), - for: .navigationBar - ) - .onAppear { - presenter.onAppear() - } - .sheet(isPresented: $presenter.showSigningState) { - ZStack { - Color(red: 25/255, green: 26/255, blue: 26/255) - .ignoresSafeArea() - - VStack { - HStack { - RoundedRectangle(cornerRadius: 2) - .fill(.gray.opacity(0.5)) - .frame(width: 30, height: 4) - - } - .padding(20) - - Image("profile") - .resizable() - .frame(width: 64, height: 64) - - switch presenter.signingState { - case .error(let error): - Text(error.localizedDescription) - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(.green) - .cornerRadius(16) - .padding(.top, 16) - - case .signed(let cacao): - HStack { - Text(cacao.p.iss.split(separator: ":").last ?? "") - .lineLimit(1) - .truncationMode(.middle) - .frame(width: 135) - .font(.system(size: 24, weight: .semibold)) - .foregroundColor(Color(red: 0.89, green: 0.91, blue: 0.91)) - - Button { - UIPasteboard.general.string = String(cacao.p.iss.split(separator: ":").last ?? "") - } label: { - Image("copy") - .resizable() - .frame(width: 14, height: 14) - } - } - - Text("Authenticated") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(.green) - .cornerRadius(16) - .padding(.top, 16) - - case .none: - EmptyView() - } - - Spacer() - } - } - .presentationDetents([.medium]) - } - } - } -} - -struct AuthView_Previews: PreviewProvider { - static var previews: some View { - AuthView() - } -} - diff --git a/Example/DApp/Modules/Main/MainInteractor.swift b/Example/DApp/Modules/Main/MainInteractor.swift deleted file mode 100644 index a3954796d..000000000 --- a/Example/DApp/Modules/Main/MainInteractor.swift +++ /dev/null @@ -1,3 +0,0 @@ -import Foundation - -final class MainInteractor {} diff --git a/Example/DApp/Modules/Main/MainModule.swift b/Example/DApp/Modules/Main/MainModule.swift deleted file mode 100644 index 67a9d6060..000000000 --- a/Example/DApp/Modules/Main/MainModule.swift +++ /dev/null @@ -1,15 +0,0 @@ -import SwiftUI - -final class MainModule { - @discardableResult - static func create(app: Application) -> UIViewController { - let router = MainRouter(app: app) - let interactor = MainInteractor() - let presenter = MainPresenter(router: router, interactor: interactor) - let viewController = MainViewController(presenter: presenter) - - router.viewController = viewController - - return viewController - } -} diff --git a/Example/DApp/Modules/Main/MainPresenter.swift b/Example/DApp/Modules/Main/MainPresenter.swift deleted file mode 100644 index 456b5b2a8..000000000 --- a/Example/DApp/Modules/Main/MainPresenter.swift +++ /dev/null @@ -1,39 +0,0 @@ -import UIKit -import WalletConnectSign -import Combine - -final class MainPresenter { - private let interactor: MainInteractor - private let router: MainRouter - private var disposeBag = Set() - - var tabs: [TabPage] { - return TabPage.allCases - } - - var viewControllers: [UIViewController] { - return [ - router.signViewController(), - router.authViewController() - ] - } - - init(router: MainRouter, interactor: MainInteractor) { - defer { - setupInitialState() - } - self.router = router - self.interactor = interactor - } - - private func setupInitialState() { - Sign.instance.sessionResponsePublisher - .receive(on: DispatchQueue.main) - .sink { [unowned self] response in - Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } - router.presentResponse(response: response) - } - .store(in: &disposeBag) - } - -} diff --git a/Example/DApp/Modules/Main/MainRouter.swift b/Example/DApp/Modules/Main/MainRouter.swift deleted file mode 100644 index 2f255eada..000000000 --- a/Example/DApp/Modules/Main/MainRouter.swift +++ /dev/null @@ -1,25 +0,0 @@ -import UIKit -import WalletConnectSign - -final class MainRouter { - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func signViewController() -> UIViewController { - return SignModule.create(app: app) - } - - func authViewController() -> UIViewController { - return AuthModule.create(app: app) - } - - func presentResponse(response: Response) { - SessionResponseModule.create(app: app, sessionResponse: response) - .present(from: viewController) - } -} diff --git a/Example/DApp/Modules/Main/MainViewController.swift b/Example/DApp/Modules/Main/MainViewController.swift deleted file mode 100644 index 539b2a789..000000000 --- a/Example/DApp/Modules/Main/MainViewController.swift +++ /dev/null @@ -1,43 +0,0 @@ -import UIKit -import Sentry - -enum LoginError: Error { - case wrongUser(id: String) - case wrongPassword -} - -final class MainViewController: UITabBarController { - - private let presenter: MainPresenter - - init(presenter: MainPresenter) { - self.presenter = presenter - super.init(nibName: nil, bundle: nil) - } - - override func viewDidLoad() { - super.viewDidLoad() - setupTabs() - } - - private func setupTabs() { - let viewControllers = presenter.viewControllers - - for (index, viewController) in viewControllers.enumerated() { - let model = presenter.tabs[index] - let item = UITabBarItem() - item.title = model.title - item.image = model.icon - item.isEnabled = TabPage.enabledTabs.contains(model) - viewController.tabBarItem = item - viewController.view.backgroundColor = .w_background - } - - self.viewControllers = viewControllers - self.selectedIndex = TabPage.selectedIndex - } - - required init?(coder: NSCoder) { - fatalError("init(coder:) has not been implemented") - } -} diff --git a/Example/DApp/Modules/Main/Model/TabPage.swift b/Example/DApp/Modules/Main/Model/TabPage.swift deleted file mode 100644 index faec2ba34..000000000 --- a/Example/DApp/Modules/Main/Model/TabPage.swift +++ /dev/null @@ -1,32 +0,0 @@ -import UIKit - -enum TabPage: CaseIterable { - case sign - case auth - - var title: String { - switch self { - case .sign: - return "Sign" - case .auth: - return "Auth" - } - } - - var icon: UIImage { - switch self { - case .sign: - return UIImage(named: "pen")! - case .auth: - return UIImage(named: "auth")! - } - } - - static var selectedIndex: Int { - return 0 - } - - static var enabledTabs: [TabPage] { - return [.sign, .auth] - } -} diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 952f40e68..c1e84694f 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -57,7 +57,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { guard let windowScene = (scene as? UIWindowScene) else { return } window = UIWindow(windowScene: windowScene) - let viewController = MainModule.create(app: app) + let viewController = SignModule.create(app: app) window?.rootViewController = viewController window?.makeKeyAndVisible() diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 99e22abc3..2f12b415c 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -299,12 +299,7 @@ C5B2F7052970573D000DBA0E /* SolanaSwift in Frameworks */ = {isa = PBXBuildFile; productRef = C5B2F7042970573D000DBA0E /* SolanaSwift */; }; C5B2F71029705827000DBA0E /* EthereumTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84F568C32795832A00D0A289 /* EthereumTransaction.swift */; }; C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5B4C4C32AF11C8B00B4274A /* SignView.swift */; }; - C5B4C4CF2AF12F1600B4274A /* AuthView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5B4C4CE2AF12F1600B4274A /* AuthView.swift */; }; C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01D02AF661D70064FC88 /* NewPairingView.swift */; }; - C5BE01D72AF691CD0064FC88 /* AuthModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01D62AF691CD0064FC88 /* AuthModule.swift */; }; - C5BE01D92AF691FE0064FC88 /* AuthPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01D82AF691FE0064FC88 /* AuthPresenter.swift */; }; - C5BE01DB2AF692060064FC88 /* AuthRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01DA2AF692060064FC88 /* AuthRouter.swift */; }; - C5BE01DD2AF692100064FC88 /* AuthInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01DC2AF692100064FC88 /* AuthInteractor.swift */; }; C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */ = {isa = PBXBuildFile; productRef = C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */; }; C5BE01E22AF693080064FC88 /* Application.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01E12AF693080064FC88 /* Application.swift */; }; C5BE01E32AF696540064FC88 /* SceneViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE264293F56D6004840D1 /* SceneViewController.swift */; }; @@ -320,12 +315,6 @@ C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01F62AF6CA2B0064FC88 /* NewPairingInteractor.swift */; }; C5BE02032AF774CB0064FC88 /* NewPairingPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE01F42AF6CA2B0064FC88 /* NewPairingPresenter.swift */; }; C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE26C293F56D6004840D1 /* UIViewController.swift */; }; - C5BE020E2AF777AD0064FC88 /* MainRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02082AF777AD0064FC88 /* MainRouter.swift */; }; - C5BE020F2AF777AD0064FC88 /* TabPage.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE020D2AF777AD0064FC88 /* TabPage.swift */; }; - C5BE02102AF777AD0064FC88 /* MainModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02072AF777AD0064FC88 /* MainModule.swift */; }; - C5BE02112AF777AD0064FC88 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE020A2AF777AD0064FC88 /* MainViewController.swift */; }; - C5BE02122AF777AD0064FC88 /* MainPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE020B2AF777AD0064FC88 /* MainPresenter.swift */; }; - C5BE02132AF777AD0064FC88 /* MainInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02092AF777AD0064FC88 /* MainInteractor.swift */; }; C5BE02142AF77A940064FC88 /* Colors.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C5F32A352954FE3C00A6476E /* Colors.xcassets */; }; C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02172AF79B950064FC88 /* SessionAccountPresenter.swift */; }; C5BE021C2AF79B9A0064FC88 /* SessionAccountRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5BE02162AF79B950064FC88 /* SessionAccountRouter.swift */; }; @@ -666,12 +655,7 @@ C5B2F6F42970511B000DBA0E /* SessionRequestInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionRequestInteractor.swift; sourceTree = ""; }; C5B2F6F52970511B000DBA0E /* SessionRequestView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionRequestView.swift; sourceTree = ""; }; C5B4C4C32AF11C8B00B4274A /* SignView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignView.swift; sourceTree = ""; }; - C5B4C4CE2AF12F1600B4274A /* AuthView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthView.swift; sourceTree = ""; }; C5BE01D02AF661D70064FC88 /* NewPairingView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingView.swift; sourceTree = ""; }; - C5BE01D62AF691CD0064FC88 /* AuthModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthModule.swift; sourceTree = ""; }; - C5BE01D82AF691FE0064FC88 /* AuthPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthPresenter.swift; sourceTree = ""; }; - C5BE01DA2AF692060064FC88 /* AuthRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRouter.swift; sourceTree = ""; }; - C5BE01DC2AF692100064FC88 /* AuthInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthInteractor.swift; sourceTree = ""; }; C5BE01E12AF693080064FC88 /* Application.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Application.swift; sourceTree = ""; }; C5BE01ED2AF6C9DF0064FC88 /* SignPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignPresenter.swift; sourceTree = ""; }; C5BE01EE2AF6C9DF0064FC88 /* SignModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignModule.swift; sourceTree = ""; }; @@ -681,12 +665,6 @@ C5BE01F42AF6CA2B0064FC88 /* NewPairingPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingPresenter.swift; sourceTree = ""; }; C5BE01F52AF6CA2B0064FC88 /* NewPairingModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingModule.swift; sourceTree = ""; }; C5BE01F62AF6CA2B0064FC88 /* NewPairingInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NewPairingInteractor.swift; sourceTree = ""; }; - C5BE02072AF777AD0064FC88 /* MainModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainModule.swift; sourceTree = ""; }; - C5BE02082AF777AD0064FC88 /* MainRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainRouter.swift; sourceTree = ""; }; - C5BE02092AF777AD0064FC88 /* MainInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainInteractor.swift; sourceTree = ""; }; - C5BE020A2AF777AD0064FC88 /* MainViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainViewController.swift; sourceTree = ""; }; - C5BE020B2AF777AD0064FC88 /* MainPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainPresenter.swift; sourceTree = ""; }; - C5BE020D2AF777AD0064FC88 /* TabPage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TabPage.swift; sourceTree = ""; }; C5BE02162AF79B950064FC88 /* SessionAccountRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountRouter.swift; sourceTree = ""; }; C5BE02172AF79B950064FC88 /* SessionAccountPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountPresenter.swift; sourceTree = ""; }; C5BE02182AF79B950064FC88 /* SessionAccountInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountInteractor.swift; sourceTree = ""; }; @@ -1843,18 +1821,6 @@ path = Sign; sourceTree = ""; }; - C5B4C4CD2AF12F0B00B4274A /* Auth */ = { - isa = PBXGroup; - children = ( - C5BE01D62AF691CD0064FC88 /* AuthModule.swift */, - C5BE01D82AF691FE0064FC88 /* AuthPresenter.swift */, - C5BE01DA2AF692060064FC88 /* AuthRouter.swift */, - C5BE01DC2AF692100064FC88 /* AuthInteractor.swift */, - C5B4C4CE2AF12F1600B4274A /* AuthView.swift */, - ); - path = Auth; - sourceTree = ""; - }; C5BE01E02AF692F80064FC88 /* ApplicationLayer */ = { isa = PBXGroup; children = ( @@ -1875,27 +1841,6 @@ path = NewPairing; sourceTree = ""; }; - C5BE02062AF777AD0064FC88 /* Main */ = { - isa = PBXGroup; - children = ( - C5BE02072AF777AD0064FC88 /* MainModule.swift */, - C5BE020B2AF777AD0064FC88 /* MainPresenter.swift */, - C5BE02092AF777AD0064FC88 /* MainInteractor.swift */, - C5BE02082AF777AD0064FC88 /* MainRouter.swift */, - C5BE020A2AF777AD0064FC88 /* MainViewController.swift */, - C5BE020C2AF777AD0064FC88 /* Model */, - ); - path = Main; - sourceTree = ""; - }; - C5BE020C2AF777AD0064FC88 /* Model */ = { - isa = PBXGroup; - children = ( - C5BE020D2AF777AD0064FC88 /* TabPage.swift */, - ); - path = Model; - sourceTree = ""; - }; C5BE02152AF79B860064FC88 /* SessionAccount */ = { isa = PBXGroup; children = ( @@ -1911,9 +1856,7 @@ C5BE02202AF7DDE70064FC88 /* Modules */ = { isa = PBXGroup; children = ( - C5BE02062AF777AD0064FC88 /* Main */, C5B4C4C52AF12C2900B4274A /* Sign */, - C5B4C4CD2AF12F0B00B4274A /* Auth */, 8486EDC72B4F1D22008E53C3 /* SessionResponse */, ); path = Modules; @@ -2359,8 +2302,6 @@ buildActionMask = 2147483647; files = ( C5BE021C2AF79B9A0064FC88 /* SessionAccountRouter.swift in Sources */, - C5BE02102AF777AD0064FC88 /* MainModule.swift in Sources */, - C5BE01DD2AF692100064FC88 /* AuthInteractor.swift in Sources */, C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */, C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */, C5BE021E2AF79B9A0064FC88 /* SessionAccountView.swift in Sources */, @@ -2368,23 +2309,18 @@ C5BE02032AF774CB0064FC88 /* NewPairingPresenter.swift in Sources */, 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */, C5BE01E32AF696540064FC88 /* SceneViewController.swift in Sources */, - C5BE020F2AF777AD0064FC88 /* TabPage.swift in Sources */, A5A8E47D293A1CFE00FEB97D /* DefaultSocketFactory.swift in Sources */, C5BE01E52AF697470064FC88 /* Color.swift in Sources */, - C5B4C4CF2AF12F1600B4274A /* AuthView.swift in Sources */, A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, - C5BE02122AF777AD0064FC88 /* MainPresenter.swift in Sources */, 8486EDC52B4F1D04008E53C3 /* SessionResponseModule.swift in Sources */, C5BE01E22AF693080064FC88 /* Application.swift in Sources */, C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */, A5A8E47E293A1CFE00FEB97D /* DefaultSignerFactory.swift in Sources */, - C5BE020E2AF777AD0064FC88 /* MainRouter.swift in Sources */, A5A0843D29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, C5BE021F2AF79B9A0064FC88 /* SessionAccountModule.swift in Sources */, 8486EDC92B4F1D73008E53C3 /* SessionResponsePresenter.swift in Sources */, C5BE01E42AF697100064FC88 /* UIColor.swift in Sources */, - C5BE01DB2AF692060064FC88 /* AuthRouter.swift in Sources */, C5BE01E62AF697FA0064FC88 /* String.swift in Sources */, C5BE02012AF774CB0064FC88 /* NewPairingModule.swift in Sources */, C5BE02002AF774CB0064FC88 /* NewPairingRouter.swift in Sources */, @@ -2393,17 +2329,13 @@ C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */, 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */, C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */, - C5BE01D92AF691FE0064FC88 /* AuthPresenter.swift in Sources */, - C5BE02112AF777AD0064FC88 /* MainViewController.swift in Sources */, C5BE021D2AF79B9A0064FC88 /* SessionAccountInteractor.swift in Sources */, A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, 8486EDCB2B4F1D7B008E53C3 /* SessionResponseRouter.swift in Sources */, C5BE01FB2AF6CB270064FC88 /* SignRouter.swift in Sources */, - C5BE01D72AF691CD0064FC88 /* AuthModule.swift in Sources */, C5BE01F72AF6CB250064FC88 /* SignModule.swift in Sources */, 8486EDCF2B4F1DA6008E53C3 /* SessionResponseView.swift in Sources */, C5BE01FA2AF6CB270064FC88 /* SignPresenter.swift in Sources */, - C5BE02132AF777AD0064FC88 /* MainInteractor.swift in Sources */, ); runOnlyForDeploymentPostprocessing = 0; }; diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 7bb885cc7..62cacfc48 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -41,7 +41,7 @@ public struct SignClientFactory { let sessionStore = SessionStorage(storage: SequenceStore(store: .init(defaults: keyValueStorage, identifier: SignStorageIdentifiers.sessions.rawValue))) let proposalPayloadsStore = CodableStore>(defaults: RuntimeKeyValueStorage(), identifier: SignStorageIdentifiers.proposals.rawValue) let verifyContextStore = CodableStore(defaults: keyValueStorage, identifier: VerifyStorageIdentifiers.context.rawValue) - let historyService = HistoryService(history: rpcHistory, proposalPayloadsStore: proposalPayloadsStore, verifyContextStore: verifyContextStore) + let historyService = HistoryService(history: rpcHistory, verifyContextStore: verifyContextStore) let verifyClient = VerifyClientFactory.create() let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: verifyClient, kms: kms, sessionStore: sessionStore, logger: logger) let nonControllerSessionStateMachine = NonControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) From cf10686021d00b15cef22dcaa9409a595dceb1e2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 09:06:43 +0100 Subject: [PATCH 189/814] walletapp - fix session proposal dismiss on expiry --- .../Wallet/SessionProposal/SessionProposalPresenter.swift | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 99fe3bec7..c853b381d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -72,11 +72,9 @@ final class SessionProposalPresenter: ObservableObject { // MARK: - Private functions private extension SessionProposalPresenter { func setupInitialState() { - Web3Wallet.instance.pendingProposalsPublisher.sink { [weak self] proposals in + Web3Wallet.instance.sessionProposalExpirationPublisher.sink { [weak self] proposal in guard let self = self else { return } - if !proposals.contains(where: { (proposal: Session.Proposal, context: VerifyContext?) in - proposal.id == self.sessionProposal.id - }) { + if proposal.id == self.sessionProposal.id { dismiss() } }.store(in: &disposeBag) From 94cea98e24025b2b159c1297a7e8cbdd27a8086b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 10:10:00 +0100 Subject: [PATCH 190/814] fix, present request screen when proposal still active --- .../PresentationLayer/Wallet/Main/MainPresenter.swift | 1 + .../WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift | 4 ++++ .../Wallet/SessionProposal/SessionProposalRouter.swift | 2 +- 3 files changed, 6 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift index 762bdf97c..3d5c8a0b6 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift @@ -49,6 +49,7 @@ extension MainPresenter { interactor.sessionRequestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] request, context in + router.dismiss() router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) }.store(in: &disposeBag) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift index 211a1fc62..2f087957f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainRouter.swift @@ -41,4 +41,8 @@ final class MainRouter { AuthRequestModule.create(app: app, request: request, importAccount: importAccount, context: context) .presentFullScreen(from: viewController, transparentBackground: true) } + + func dismiss() { + viewController.dismiss() + } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift index 559009c2e..f03cce6db 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalRouter.swift @@ -11,7 +11,7 @@ final class SessionProposalRouter { func dismiss() { DispatchQueue.main.async { [weak self] in - self?.viewController.dismiss() + self?.viewController?.dismiss() } } } From f3cc0740e4c6135c9bea1644fa653c7d9bd964da Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 12:25:11 +0100 Subject: [PATCH 191/814] revert session response small modal --- .../SessionResponseModule.swift | 17 ---- .../SessionResponsePresenter.swift | 17 ---- .../SessionResponseRouter.swift | 17 ---- .../SessionResponse/SessionResponseView.swift | 82 ------------------- .../SessionAccountPresenter.swift | 16 ++++ .../SessionAccount/SessionAccountView.swift | 24 +++--- Example/DApp/Modules/Sign/SignPresenter.swift | 8 ++ Example/DApp/Modules/Sign/SignRouter.swift | 8 +- Example/DApp/SceneDelegate.swift | 1 + Example/ExampleApp.xcodeproj/project.pbxproj | 24 ------ .../ConfigurationService.swift | 12 ++- .../SessionProposalPresenter.swift | 4 +- 12 files changed, 51 insertions(+), 179 deletions(-) delete mode 100644 Example/DApp/Modules/SessionResponse/SessionResponseModule.swift delete mode 100644 Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift delete mode 100644 Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift delete mode 100644 Example/DApp/Modules/SessionResponse/SessionResponseView.swift diff --git a/Example/DApp/Modules/SessionResponse/SessionResponseModule.swift b/Example/DApp/Modules/SessionResponse/SessionResponseModule.swift deleted file mode 100644 index 1030c26aa..000000000 --- a/Example/DApp/Modules/SessionResponse/SessionResponseModule.swift +++ /dev/null @@ -1,17 +0,0 @@ -import SwiftUI -import WalletConnectSign - -final class SessionResponseModule { - @discardableResult - static func create(app: Application, sessionResponse: Response) -> UIViewController { - let router = SessionResponseRouter(app: app) - let presenter = SessionResponsePresenter(router: router, sessionResponse: sessionResponse) - - let view = NewPairingView().environmentObject(presenter) - let viewController = UIHostingController(rootView: view) - - router.viewController = viewController - - return viewController - } -} diff --git a/Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift b/Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift deleted file mode 100644 index b26818599..000000000 --- a/Example/DApp/Modules/SessionResponse/SessionResponsePresenter.swift +++ /dev/null @@ -1,17 +0,0 @@ - -import Foundation -import WalletConnectSign - -final class SessionResponsePresenter: ObservableObject, SceneViewModel { - - private let router: SessionResponseRouter - let response: Response - - init( - router: SessionResponseRouter, - sessionResponse: Response - ) { - self.router = router - self.response = sessionResponse - } -} diff --git a/Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift b/Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift deleted file mode 100644 index 752a95116..000000000 --- a/Example/DApp/Modules/SessionResponse/SessionResponseRouter.swift +++ /dev/null @@ -1,17 +0,0 @@ -import UIKit - -import WalletConnectSign - -final class SessionResponseRouter { - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func dismiss() { - viewController.dismiss(animated: true) - } -} diff --git a/Example/DApp/Modules/SessionResponse/SessionResponseView.swift b/Example/DApp/Modules/SessionResponse/SessionResponseView.swift deleted file mode 100644 index 4160f47be..000000000 --- a/Example/DApp/Modules/SessionResponse/SessionResponseView.swift +++ /dev/null @@ -1,82 +0,0 @@ -import SwiftUI -import WalletConnectSign - -struct SessionResponseView: View { - - @EnvironmentObject var presenter: SessionResponsePresenter - - var body: some View { - ZStack { - Color(red: 25/255, green: 26/255, blue: 26/255) - .ignoresSafeArea() - - responseView(response: presenter.response) - } - } - - - private func responseView(response: Response) -> some View { - ZStack { - RoundedRectangle(cornerRadius: 16) - .fill(.white.opacity(0.02)) - - VStack(spacing: 5) { - HStack { - RoundedRectangle(cornerRadius: 2) - .fill(.gray.opacity(0.5)) - .frame(width: 30, height: 4) - - } - .padding(20) - - HStack { - Group { - if case RPCResult.error(_) = response.result { - Text("❌ Response") - } else { - Text("✅ Response") - } - } - .font( - Font.system(size: 14, weight: .medium) - ) - .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - .padding(12) - - Spacer() - - let record = Sign.instance.getSessionRequestRecord(id: response.id)! - Text(record.request.method) - .font( - Font.system(size: 14, weight: .medium) - ) - .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - .padding(12) - } - - ZStack { - RoundedRectangle(cornerRadius: 16) - .fill(.white.opacity(0.02)) - - switch response.result { - case .response(let response): - Text(try! response.get(String.self).description) - .font(.system(size: 16, weight: .medium)) - .foregroundColor(.white) - .padding(.vertical, 12) - .padding(.horizontal, 8) - - case .error(let error): - Text(error.message) - .font(.system(size: 16, weight: .medium)) - .foregroundColor(.white) - .padding(.vertical, 12) - .padding(.horizontal, 8) - } - } - .padding(.bottom, 12) - .padding(.horizontal, 8) - } - } - } -} diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 1924a264f..3df1a674f 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -8,6 +8,7 @@ final class SessionAccountPresenter: ObservableObject { case notImplemented } + @Published var showResponse = false @Published var showError = false @Published var errorMessage = String.empty @Published var showRequestSent = false @@ -27,6 +28,7 @@ final class SessionAccountPresenter: ObservableObject { sessionAccount: AccountDetails, session: Session ) { + defer { setupInitialState() } self.interactor = interactor self.router = router self.sessionAccount = sessionAccount @@ -66,6 +68,15 @@ final class SessionAccountPresenter: ObservableObject { // MARK: - Private functions extension SessionAccountPresenter { + private func setupInitialState() { + Sign.instance.sessionResponsePublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] response in + presentResponse(response: response) + } + .store(in: &subscriptions) + } + private func getRequest(for method: String) throws -> AnyCodable { let account = session.namespaces.first!.value.accounts.first!.absoluteString if method == "eth_sendTransaction" { @@ -79,6 +90,11 @@ extension SessionAccountPresenter { throw Errors.notImplemented } + private func presentResponse(response: Response) { + self.response = response + showResponse.toggle() + } + private func openWallet() { if let nativeUri = session.peer.redirect?.native { UIApplication.shared.open(URL(string: "\(nativeUri)wc?requestSent")!) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift index a5c825924..1b8a3ebb8 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift @@ -31,18 +31,18 @@ struct SessionAccountView: View { Color(red: 25/255, green: 26/255, blue: 26/255), for: .navigationBar ) -// .sheet(isPresented: $presenter.showResponse) { -// ZStack { -// Color(red: 25/255, green: 26/255, blue: 26/255) -// .ignoresSafeArea() -// -// ScrollView { -// responseView(response: presenter.response!) -// .padding(12) -// } -// } -// .presentationDetents([.medium]) -// } + .sheet(isPresented: $presenter.showResponse) { + ZStack { + Color(red: 25/255, green: 26/255, blue: 26/255) + .ignoresSafeArea() + + ScrollView { + responseView(response: presenter.response!) + .padding(12) + } + } + .presentationDetents([.medium]) + } .alert(presenter.errorMessage, isPresented: $presenter.showError) { Button("OK", role: .cancel) {} } diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index d3a6f1911..a4ab56cce 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -109,6 +109,14 @@ extension SignPresenter { self.accountsDetails.removeAll() } .store(in: &subscriptions) + + Sign.instance.sessionResponsePublisher + .receive(on: DispatchQueue.main) + .sink { response in + Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + } + .store(in: &subscriptions) + } private func getSession() { diff --git a/Example/DApp/Modules/Sign/SignRouter.swift b/Example/DApp/Modules/Sign/SignRouter.swift index 60da1928c..5e0155007 100644 --- a/Example/DApp/Modules/Sign/SignRouter.swift +++ b/Example/DApp/Modules/Sign/SignRouter.swift @@ -20,13 +20,9 @@ final class SignRouter { func presentSessionAccount(sessionAccount: AccountDetails, session: Session) { SessionAccountModule.create(app: app, sessionAccount: sessionAccount, session: session) - .present(from: viewController) + .push(from: viewController) } - - func dismissNewPairing() { - newPairingViewController?.dismiss() - } - + func dismiss() { viewController.dismiss(animated: true) } diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index c1e84694f..489a1c2d0 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -58,6 +58,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { window = UIWindow(windowScene: windowScene) let viewController = SignModule.create(app: app) + .wrapToNavigationController() window?.rootViewController = viewController window?.makeKeyAndVisible() diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 2f12b415c..53b510607 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -32,10 +32,6 @@ 847BD1E8298A806800076C90 /* NotificationsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1E3298A806800076C90 /* NotificationsView.swift */; }; 847BD1EB298A87AB00076C90 /* SubscriptionsViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1EA298A87AB00076C90 /* SubscriptionsViewModel.swift */; }; 847F08012A25DBFF00B2A5A4 /* XPlatformW3WTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847F08002A25DBFF00B2A5A4 /* XPlatformW3WTests.swift */; }; - 8486EDC52B4F1D04008E53C3 /* SessionResponseModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDC42B4F1D04008E53C3 /* SessionResponseModule.swift */; }; - 8486EDC92B4F1D73008E53C3 /* SessionResponsePresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */; }; - 8486EDCB2B4F1D7B008E53C3 /* SessionResponseRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */; }; - 8486EDCF2B4F1DA6008E53C3 /* SessionResponseView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */; }; 8486EDD12B4F2DC1008E53C3 /* AlertPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */; }; 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */ = {isa = PBXBuildFile; productRef = 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */; }; 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9432A836C2A0003D5AF /* Sentry */; }; @@ -425,10 +421,6 @@ 847BD1E3298A806800076C90 /* NotificationsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotificationsView.swift; sourceTree = ""; }; 847BD1EA298A87AB00076C90 /* SubscriptionsViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SubscriptionsViewModel.swift; sourceTree = ""; }; 847F08002A25DBFF00B2A5A4 /* XPlatformW3WTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = XPlatformW3WTests.swift; sourceTree = ""; }; - 8486EDC42B4F1D04008E53C3 /* SessionResponseModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseModule.swift; sourceTree = ""; }; - 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponsePresenter.swift; sourceTree = ""; }; - 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseRouter.swift; sourceTree = ""; }; - 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionResponseView.swift; sourceTree = ""; }; 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertPresenter.swift; sourceTree = ""; }; 8487A92E2A7BD2F30003D5AF /* XPlatformProtocolTests.xctestplan */ = {isa = PBXFileReference; lastKnownFileType = text; name = XPlatformProtocolTests.xctestplan; path = ../XPlatformProtocolTests.xctestplan; sourceTree = ""; }; 8487A9472A83AD680003D5AF /* LoggingService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoggingService.swift; sourceTree = ""; }; @@ -929,17 +921,6 @@ path = Web3Wallet; sourceTree = ""; }; - 8486EDC72B4F1D22008E53C3 /* SessionResponse */ = { - isa = PBXGroup; - children = ( - 8486EDC42B4F1D04008E53C3 /* SessionResponseModule.swift */, - 8486EDC82B4F1D73008E53C3 /* SessionResponsePresenter.swift */, - 8486EDCA2B4F1D7B008E53C3 /* SessionResponseRouter.swift */, - 8486EDCE2B4F1DA6008E53C3 /* SessionResponseView.swift */, - ); - path = SessionResponse; - sourceTree = ""; - }; 849D7A91292E2115006A2BD4 /* Push */ = { isa = PBXGroup; children = ( @@ -1857,7 +1838,6 @@ isa = PBXGroup; children = ( C5B4C4C52AF12C2900B4274A /* Sign */, - 8486EDC72B4F1D22008E53C3 /* SessionResponse */, ); path = Modules; sourceTree = ""; @@ -2313,13 +2293,11 @@ C5BE01E52AF697470064FC88 /* Color.swift in Sources */, A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, - 8486EDC52B4F1D04008E53C3 /* SessionResponseModule.swift in Sources */, C5BE01E22AF693080064FC88 /* Application.swift in Sources */, C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */, A5A8E47E293A1CFE00FEB97D /* DefaultSignerFactory.swift in Sources */, A5A0843D29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, C5BE021F2AF79B9A0064FC88 /* SessionAccountModule.swift in Sources */, - 8486EDC92B4F1D73008E53C3 /* SessionResponsePresenter.swift in Sources */, C5BE01E42AF697100064FC88 /* UIColor.swift in Sources */, C5BE01E62AF697FA0064FC88 /* String.swift in Sources */, C5BE02012AF774CB0064FC88 /* NewPairingModule.swift in Sources */, @@ -2331,10 +2309,8 @@ C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */, C5BE021D2AF79B9A0064FC88 /* SessionAccountInteractor.swift in Sources */, A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, - 8486EDCB2B4F1D7B008E53C3 /* SessionResponseRouter.swift in Sources */, C5BE01FB2AF6CB270064FC88 /* SignRouter.swift in Sources */, C5BE01F72AF6CB250064FC88 /* SignModule.swift in Sources */, - 8486EDCF2B4F1DA6008E53C3 /* SessionResponseView.swift in Sources */, C5BE01FA2AF6CB270064FC88 /* SignPresenter.swift in Sources */, ); runOnlyForDeploymentPostprocessing = 0; diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 85216a471..deded4c38 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -41,7 +41,9 @@ final class ConfigurationService { } LoggingService.instance.startLogging() - Web3Wallet.instance.socketConnectionStatusPublisher.sink { status in + Web3Wallet.instance.socketConnectionStatusPublisher + .receive(on: DispatchQueue.main) + .sink { status in switch status { case .connected: AlertPresenter.present(message: "Your web socket has connected", type: .success) @@ -50,7 +52,9 @@ final class ConfigurationService { } }.store(in: &publishers) - Web3Wallet.instance.logsPublisher.sink { log in + Web3Wallet.instance.logsPublisher + .receive(on: DispatchQueue.main) + .sink { log in switch log { case .error(let logMessage): AlertPresenter.present(message: logMessage.message, type: .error) @@ -58,7 +62,9 @@ final class ConfigurationService { } }.store(in: &publishers) - Web3Wallet.instance.pairingExpirationPublisher.sink { pairing in + Web3Wallet.instance.pairingExpirationPublisher + .receive(on: DispatchQueue.main) + .sink { pairing in guard !pairing.active else { return } AlertPresenter.present(message: "Pairing has expired", type: .warning) }.store(in: &publishers) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index c853b381d..5e40120f1 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -72,7 +72,9 @@ final class SessionProposalPresenter: ObservableObject { // MARK: - Private functions private extension SessionProposalPresenter { func setupInitialState() { - Web3Wallet.instance.sessionProposalExpirationPublisher.sink { [weak self] proposal in + Web3Wallet.instance.sessionProposalExpirationPublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] proposal in guard let self = self else { return } if proposal.id == self.sessionProposal.id { dismiss() From 0e6b23c59d429def47c7ee2376794925642ba6b3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 12:31:22 +0100 Subject: [PATCH 192/814] revert activate pairing logic --- Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 6 ------ 1 file changed, 6 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 126ec07c9..2bb7b63f5 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -319,12 +319,6 @@ private extension ApproveEngine { // MARK: SessionProposeRequest func handleSessionProposeRequest(payload: RequestSubscriptionPayload) { - - if var pairing = pairingStore.getPairing(forTopic: payload.topic) { - pairing.activate() - pairingStore.setPairing(pairing) - } - logger.debug("Received Session Proposal") let proposal = payload.request do { try Namespace.validate(proposal.requiredNamespaces) } catch { From befdfab3d17a54505c654d705317d9f8fe971c61 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 13:12:03 +0100 Subject: [PATCH 193/814] change pairing state publisher logic --- .../WalletConnectPairing/Services/Common/PairingsProvider.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift index 76d1417f8..0b5daa5bc 100644 --- a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift +++ b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift @@ -47,7 +47,7 @@ class PairingStateProvider { } private func checkPairingState() { - let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active } + let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active || $0.requestReceived} pairingStatePublisherSubject.send(pairingStateActive) } } From 42ab7ce96522a6c42d9f392a4be2a96fa4bdd469 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Mon, 15 Jan 2024 13:27:47 +0100 Subject: [PATCH 194/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 4d232ac36..c16d55635 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.10.0"} +{"version": "1.11.0"} From ae36fa61fa9180d5996217d405bfd12f2353a9bf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 15:48:25 +0100 Subject: [PATCH 195/814] Add RequestsExpiryWatcher --- .../Common/PairingStateProvider.swift | 29 +++++++++++++ .../Services/Common/PairingsProvider.swift | 29 ------------- ...e.swift => PendingProposalsProvider.swift} | 0 .../Engine/Common/RequestsExpiryWatcher.swift | 41 +++++++++++++++++++ .../Services/HistoryService.swift | 22 ++++++---- 5 files changed, 85 insertions(+), 36 deletions(-) create mode 100644 Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift rename Sources/WalletConnectSign/Engine/Common/{File.swift => PendingProposalsProvider.swift} (100%) create mode 100644 Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift diff --git a/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift new file mode 100644 index 000000000..fa2291f80 --- /dev/null +++ b/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift @@ -0,0 +1,29 @@ + +import Combine +import Foundation + +class PairingStateProvider { + private let pairingStorage: WCPairingStorage + private var pairingStatePublisherSubject = PassthroughSubject() + private var checkTimer: Timer? + + public var pairingStatePublisher: AnyPublisher { + pairingStatePublisherSubject.eraseToAnyPublisher() + } + + public init(pairingStorage: WCPairingStorage) { + self.pairingStorage = pairingStorage + setupPairingStateCheckTimer() + } + + private func setupPairingStateCheckTimer() { + checkTimer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [unowned self] _ in + checkPairingState() + } + } + + private func checkPairingState() { + let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active || $0.requestReceived} + pairingStatePublisherSubject.send(pairingStateActive) + } +} diff --git a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift index 0b5daa5bc..aa087a3c0 100644 --- a/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift +++ b/Sources/WalletConnectPairing/Services/Common/PairingsProvider.swift @@ -22,32 +22,3 @@ class PairingsProvider { return Pairing(pairing) } } - -import Combine -import Foundation - -class PairingStateProvider { - private let pairingStorage: WCPairingStorage - private var pairingStatePublisherSubject = PassthroughSubject() - private var checkTimer: Timer? - - public var pairingStatePublisher: AnyPublisher { - pairingStatePublisherSubject.eraseToAnyPublisher() - } - - public init(pairingStorage: WCPairingStorage) { - self.pairingStorage = pairingStorage - setupPairingStateCheckTimer() - } - - private func setupPairingStateCheckTimer() { - checkTimer = Timer.scheduledTimer(withTimeInterval: 1.0, repeats: true) { [unowned self] _ in - checkPairingState() - } - } - - private func checkPairingState() { - let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active || $0.requestReceived} - pairingStatePublisherSubject.send(pairingStateActive) - } -} diff --git a/Sources/WalletConnectSign/Engine/Common/File.swift b/Sources/WalletConnectSign/Engine/Common/PendingProposalsProvider.swift similarity index 100% rename from Sources/WalletConnectSign/Engine/Common/File.swift rename to Sources/WalletConnectSign/Engine/Common/PendingProposalsProvider.swift diff --git a/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift new file mode 100644 index 000000000..a1a2726df --- /dev/null +++ b/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift @@ -0,0 +1,41 @@ + +import Foundation +import Combine + +class RequestsExpiryWatcher { + + private let requestExpirationPublisherSubject: PassthroughSubject = .init() + private let rpcHistory: RPCHistory + private let historyService: HistoryService + + var requestExpirationPublisher: AnyPublisher { + return requestExpirationPublisherSubject.eraseToAnyPublisher() + } + + private var checkTimer: Timer? + + internal init( + proposalPayloadsStore: CodableStore>, + rpcHistory: RPCHistory, + historyService: HistoryService + ) { + self.rpcHistory = rpcHistory + self.historyService = historyService + setUpExpiryCheckTimer() + } + + func setUpExpiryCheckTimer() { + checkTimer = Timer.scheduledTimer(withTimeInterval: 3.0, repeats: true) { [unowned self] _ in + checkForRequestExpiry() + } + } + + func checkForRequestExpiry() { + let requests = historyService.getPendingRequestsWithRecordId() + requests.forEach { (request: Request, recordId: RPCID) in + guard request.isExpired() else { return } + requestExpirationPublisherSubject.send(request) + rpcHistory.delete(id: recordId) + } + } +} diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index a64144a71..95129d427 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -15,17 +15,23 @@ final class HistoryService { public func getSessionRequest(id: RPCID) -> (request: Request, context: VerifyContext?)? { guard let record = history.get(recordId: id) else { return nil } - guard let request = mapRequestRecord(record) else { + guard let (request, recordId) = mapRequestRecord(record) else { return nil } - return (request, try? verifyContextStore.get(key: request.id.string)) + return (request, try? verifyContextStore.get(key: recordId.string)) } - + func getPendingRequests() -> [(request: Request, context: VerifyContext?)] { let requests = history.getPending() .compactMap { mapRequestRecord($0) } - .filter { !$0.isExpired() } - return requests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } + .filter { !$0.0.isExpired() } // Note the change here to access the Request part of the tuple + return requests.map { (request: $0.0, context: try? verifyContextStore.get(key: $0.1.string)) } + } + + + func getPendingRequestsWithRecordId() -> [(request: Request, recordId: RPCID)] { + history.getPending() + .compactMap { mapRequestRecord($0) } } func getPendingRequests(topic: String) -> [(request: Request, context: VerifyContext?)] { @@ -34,11 +40,11 @@ final class HistoryService { } private extension HistoryService { - func mapRequestRecord(_ record: RPCHistory.Record) -> Request? { + func mapRequestRecord(_ record: RPCHistory.Record) -> (Request, RPCID)? { guard let request = try? record.request.params?.get(SessionType.RequestParams.self) else { return nil } - return Request( + let mappedRequest = Request( id: record.id, topic: record.topic, method: request.request.method, @@ -46,5 +52,7 @@ private extension HistoryService { chainId: request.chainId, expiry: request.request.expiry ) + + return (mappedRequest, record.id) } } From 497cff633f6a3f8af346db92ade7c5f73317826c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 15:55:21 +0100 Subject: [PATCH 196/814] expose request expiry publisher --- Sources/WalletConnectSign/Sign/SignClient.swift | 10 +++++++++- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 4 +++- .../WalletConnectSign/Sign/SignClientProtocol.swift | 1 + Sources/Web3Wallet/Web3WalletClient.swift | 4 ++++ 4 files changed, 17 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 730083d16..b1c16fcdf 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -108,6 +108,11 @@ public final class SignClient: SignClientProtocol { return pendingProposalsProvider.pendingProposalsPublisher } + public var requestExpirationPublisher: AnyPublisher { + return requestsExpiryWatcher.requestExpirationPublisher + } + + /// An object that loggs SDK's errors and info messages public let logger: ConsoleLogging @@ -130,6 +135,7 @@ public final class SignClient: SignClientProtocol { private let cleanupService: SignCleanupService private let proposalExpiryWatcher: ProposalExpiryWatcher private let pendingProposalsProvider: PendingProposalsProvider + private let requestsExpiryWatcher: RequestsExpiryWatcher private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() private let sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() @@ -165,7 +171,8 @@ public final class SignClient: SignClientProtocol { cleanupService: SignCleanupService, pairingClient: PairingClient, proposalExpiryWatcher: ProposalExpiryWatcher, - pendingProposalsProvider: PendingProposalsProvider + pendingProposalsProvider: PendingProposalsProvider, + requestsExpiryWatcher: RequestsExpiryWatcher ) { self.logger = logger self.networkingClient = networkingClient @@ -185,6 +192,7 @@ public final class SignClient: SignClientProtocol { self.pairingClient = pairingClient self.proposalExpiryWatcher = proposalExpiryWatcher self.pendingProposalsProvider = pendingProposalsProvider + self.requestsExpiryWatcher = requestsExpiryWatcher setUpConnectionObserving() setUpEnginesCallbacks() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 62cacfc48..3d63bcf39 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -72,6 +72,7 @@ public struct SignClientFactory { let appProposerService = AppProposeService(metadata: metadata, networkingInteractor: networkingClient, kms: kms, logger: logger) let proposalExpiryWatcher = ProposalExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, rpcHistory: rpcHistory) let pendingProposalsProvider = PendingProposalsProvider(proposalPayloadsStore: proposalPayloadsStore, verifyContextStore: verifyContextStore) + let requestsExpiryWatcher = RequestsExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, rpcHistory: rpcHistory, historyService: historyService) let client = SignClient( logger: logger, @@ -91,7 +92,8 @@ public struct SignClientFactory { cleanupService: cleanupService, pairingClient: pairingClient, proposalExpiryWatcher: proposalExpiryWatcher, - pendingProposalsProvider: pendingProposalsProvider + pendingProposalsProvider: pendingProposalsProvider, + requestsExpiryWatcher: requestsExpiryWatcher ) return client } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 55afdccda..a58e35eb1 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -14,6 +14,7 @@ public protocol SignClientProtocol { var logsPublisher: AnyPublisher {get} var sessionProposalExpirationPublisher: AnyPublisher { get } var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { get } + var requestExpirationPublisher: AnyPublisher { get } func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 78a515a14..4f26b76f0 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -90,6 +90,10 @@ public class Web3WalletClient { return signClient.pendingProposalsPublisher } + public var requestExpirationPublisher: AnyPublisher { + return signClient.requestExpirationPublisher + } + // MARK: - Private Properties private let authClient: AuthClientProtocol private let signClient: SignClientProtocol From bc881ea5f62ae6ae1914467836d982ed8ed91694 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 18:40:34 +0100 Subject: [PATCH 197/814] publish pairing state on change only --- .../Services/Common/PairingStateProvider.swift | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift index fa2291f80..ff917e33d 100644 --- a/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift +++ b/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift @@ -1,4 +1,3 @@ - import Combine import Foundation @@ -6,6 +5,7 @@ class PairingStateProvider { private let pairingStorage: WCPairingStorage private var pairingStatePublisherSubject = PassthroughSubject() private var checkTimer: Timer? + private var lastPairingState: Bool? public var pairingStatePublisher: AnyPublisher { pairingStatePublisherSubject.eraseToAnyPublisher() @@ -23,7 +23,11 @@ class PairingStateProvider { } private func checkPairingState() { - let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active || $0.requestReceived} - pairingStatePublisherSubject.send(pairingStateActive) + let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active || $0.requestReceived } + + if lastPairingState != pairingStateActive { + pairingStatePublisherSubject.send(pairingStateActive) + lastPairingState = pairingStateActive + } } } From dc3c972d348a56329605d8201e1a1a8a437402be Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 18:56:07 +0100 Subject: [PATCH 198/814] dismiss request screen on expiry --- .../SessionRequest/SessionRequestPresenter.swift | 11 ++++++++++- .../Wallet/SessionRequest/SessionRequestRouter.swift | 4 +++- 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index b2df3650a..bb72f3be7 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -79,7 +79,16 @@ final class SessionRequestPresenter: ObservableObject { // MARK: - Private functions private extension SessionRequestPresenter { - func setupInitialState() {} + func setupInitialState() { + Web3Wallet.instance.requestExpirationPublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] request in + guard let self = self else { return } + if request.id == sessionRequest.id { + dismiss() + } + }.store(in: &disposeBag) + } } // MARK: - SceneViewModel diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestRouter.swift index cb7dff530..b4cbce9b5 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestRouter.swift @@ -10,6 +10,8 @@ final class SessionRequestRouter { } func dismiss() { - viewController.dismiss() + DispatchQueue.main.async { [weak self] in + self?.viewController?.dismiss() + } } } From 3606015d919abdbb12b7bc95fa59b2d1af32c34e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jan 2024 19:00:46 +0100 Subject: [PATCH 199/814] add alert on request expiry --- .../WalletApp/ApplicationLayer/ConfigurationService.swift | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index deded4c38..51d1f0c28 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -69,10 +69,14 @@ final class ConfigurationService { AlertPresenter.present(message: "Pairing has expired", type: .warning) }.store(in: &publishers) - Web3Wallet.instance.sessionProposalExpirationPublisher.sink { proposal in + Web3Wallet.instance.sessionProposalExpirationPublisher.sink { _ in AlertPresenter.present(message: "Session Proposal has expired", type: .warning) }.store(in: &publishers) + Web3Wallet.instance.requestExpirationPublisher.sink { _ in + AlertPresenter.present(message: "Session Request has expired", type: .warning) + }.store(in: &publishers) + Task { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") From f325146f60c88dcb6a2d86c6b52bd54b15da9745 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 07:38:02 +0100 Subject: [PATCH 200/814] update Request and its tests --- .../Engine/Common/SessionEngine.swift | 3 +- Sources/WalletConnectSign/Request.swift | 68 ++++++++------- .../SessionEngineTests.swift | 3 - .../SessionRequestTests.swift | 85 +++++++++---------- 4 files changed, 78 insertions(+), 81 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index f2598b074..9053ff292 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -65,7 +65,8 @@ final class SessionEngine { } let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiry: request.expiry) let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) - let protocolMethod = SessionRequestProtocolMethod(ttl: request.calculateTtl()) + let ttl = try request.calculateTtl() + let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) try await networkingInteractor.request(rpcRequest, topic: request.topic, protocolMethod: SessionRequestProtocolMethod()) } diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index 665369a1d..b971d8716 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -1,12 +1,39 @@ import Foundation public struct Request: Codable, Equatable { + public enum Errors: Error { + case invalidTtl + case requestExpired + } + public let id: RPCID public let topic: String public let method: String public let params: AnyCodable public let chainId: Blockchain - public let expiry: UInt64? + public var expiry: UInt64? + + // TTL bounds + static let minTtl: TimeInterval = 300 // 5 minutes + static let maxTtl: TimeInterval = 604800 // 7 days + + public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, ttl: TimeInterval = 300) throws { + guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { + throw Errors.invalidTtl + } + + let calculatedExpiry = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) + self.init(id: RPCID(JsonRpcID.generate()), topic: topic, method: method, params: params, chainId: chainId, expiry: calculatedExpiry) + } + + init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, ttl: TimeInterval) throws where C: Codable { + guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { + throw Errors.invalidTtl + } + + let calculatedExpiry = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) + self.init(id: id, topic: topic, method: method, params: AnyCodable(params), chainId: chainId, expiry: calculatedExpiry) + } internal init(id: RPCID, topic: String, method: String, params: AnyCodable, chainId: Blockchain, expiry: UInt64?) { self.id = id @@ -17,45 +44,22 @@ public struct Request: Codable, Equatable { self.expiry = expiry } - public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, expiry: UInt64? = nil) { - self.init(id: RPCID(JsonRpcID.generate()), topic: topic, method: method, params: params, chainId: chainId, expiry: expiry) - } - - init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, expiry: UInt64?) where C: Codable { - self.init(id: id, topic: topic, method: method, params: AnyCodable(params), chainId: chainId, expiry: expiry) - } - func isExpired(currentDate: Date = Date()) -> Bool { guard let expiry = expiry else { return false } - let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) - - guard - abs(currentDate.distance(to: expiryDate)) < Constants.maxExpiry - else { return true } - return expiryDate < currentDate } - func calculateTtl(currentDate: Date = Date()) -> Int { - guard let expiry = expiry else { return SessionRequestProtocolMethod.defaultTtl } - + func calculateTtl(currentDate: Date = Date()) throws -> Int { + guard let expiry = expiry else { return Int(Self.minTtl) } + let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) - let diff = expiryDate - currentDate.timeIntervalSince1970 - - guard - diff.timeIntervalSince1970 < Constants.maxExpiry, - diff.timeIntervalSince1970 > Constants.minExpiry - else { return SessionRequestProtocolMethod.defaultTtl } - - return Int(diff.timeIntervalSince1970) - } -} + let diff = expiryDate.timeIntervalSince(currentDate) -private extension Request { + guard diff > 0 else { + throw Errors.requestExpired + } - struct Constants { - static let minExpiry: TimeInterval = 300 // 5 minutes - static let maxExpiry: TimeInterval = 604800 // 7 days + return Int(diff) } } diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index 23f1e420b..c4c7a1112 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -7,14 +7,12 @@ final class SessionEngineTests: XCTestCase { var networkingInteractor: NetworkingInteractorMock! var sessionStorage: WCSessionStorageMock! - var proposalPayloadsStore: CodableStore>! var verifyContextStore: CodableStore! var engine: SessionEngine! override func setUp() { networkingInteractor = NetworkingInteractorMock() sessionStorage = WCSessionStorageMock() - proposalPayloadsStore = CodableStore>(defaults: RuntimeKeyValueStorage(), identifier: "") verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") engine = SessionEngine( networkingInteractor: networkingInteractor, @@ -25,7 +23,6 @@ final class SessionEngineTests: XCTestCase { identifier: "" ) ), - proposalPayloadsStore: proposalPayloadsStore, verifyContextStore: verifyContextStore ), verifyContextStore: verifyContextStore, diff --git a/Tests/WalletConnectSignTests/SessionRequestTests.swift b/Tests/WalletConnectSignTests/SessionRequestTests.swift index c4b4a2fbf..10c70ea3a 100644 --- a/Tests/WalletConnectSignTests/SessionRequestTests.swift +++ b/Tests/WalletConnectSignTests/SessionRequestTests.swift @@ -1,71 +1,66 @@ import XCTest @testable import WalletConnectSign -final class SessionRequestTests: XCTestCase { +class RequestTests: XCTestCase { - func testRequestTtlDefault() { - let request = Request.stub() - - XCTAssertEqual(request.calculateTtl(), SessionRequestProtocolMethod.defaultTtl) + func testInitWithValidTtl() { + XCTAssertNoThrow(try Request.stub(ttl: 3600)) // 1 hour } - func testRequestTtlExtended() { - let currentDate = Date(timeIntervalSince1970: 0) - let expiry = currentDate.advanced(by: 500) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - - XCTAssertEqual(request.calculateTtl(currentDate: currentDate), 500) + func testInitWithInvalidTtlTooShort() { + XCTAssertThrowsError(try Request.stub(ttl: 100)) { error in // Less than minTtl + XCTAssertEqual(error as? Request.Errors, Request.Errors.invalidTtl) + } } - func testRequestTtlNotExtendedMinValidation() { - let currentDate = Date(timeIntervalSince1970: 0) - let expiry = currentDate.advanced(by: 200) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - - XCTAssertEqual(request.calculateTtl(currentDate: currentDate), SessionRequestProtocolMethod.defaultTtl) + func testInitWithInvalidTtlTooLong() { + XCTAssertThrowsError(try Request.stub(ttl: 700000)) { error in // More than maxTtl + XCTAssertEqual(error as? Request.Errors, Request.Errors.invalidTtl) + } } - func testRequestTtlNotExtendedMaxValidation() { - let currentDate = Date(timeIntervalSince1970: 0) - let expiry = currentDate.advanced(by: 700000) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - - XCTAssertEqual(request.calculateTtl(currentDate: currentDate), SessionRequestProtocolMethod.defaultTtl) - } - - func testIsExpiredDefault() { - let request = Request.stub() - + func testIsExpiredForNonExpiredRequest() { + let request = try! Request.stub(ttl: 3600) // 1 hour XCTAssertFalse(request.isExpired()) } - func testIsExpiredTrue() { - let currentDate = Date(timeIntervalSince1970: 500) - let expiry = Date(timeIntervalSince1970: 0) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - XCTAssertTrue(request.isExpired(currentDate: currentDate)) + func testIsExpiredForExpiredRequest() { + let pastTimestamp = UInt64(Date().timeIntervalSince1970) - 3600 // 1 hour ago + let request = Request.stubWithExpiry(expiry: pastTimestamp) + XCTAssertTrue(request.isExpired()) } - func testIsExpiredTrueMaxValidation() { - let currentDate = Date(timeIntervalSince1970: 500) - let expiry = Date(timeIntervalSince1970: 700000) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - XCTAssertTrue(request.isExpired(currentDate: currentDate)) + func testCalculateTtlForNonExpiredRequest() { + let request = try! Request.stub(ttl: 3600) // 1 hour + XCTAssertNoThrow(try request.calculateTtl()) } - func testIsExpiredFalse() { - let currentDate = Date(timeIntervalSince1970: 0) - let expiry = Date(timeIntervalSince1970: 500) - let request = Request.stub(expiry: UInt64(expiry.timeIntervalSince1970)) - - XCTAssertFalse(request.isExpired(currentDate: currentDate)) + func testCalculateTtlForExpiredRequest() { + let pastTimestamp = UInt64(Date().timeIntervalSince1970) - 3600 // 1 hour ago + let request = Request.stubWithExpiry(expiry: pastTimestamp) + XCTAssertThrowsError(try request.calculateTtl()) { error in + XCTAssertEqual(error as? Request.Errors, Request.Errors.requestExpired) + } } } + + private extension Request { - static func stub(expiry: UInt64? = nil) -> Request { + static func stub(ttl: TimeInterval = 300) throws -> Request { + return try Request( + topic: "topic", + method: "method", + params: AnyCodable("params"), + chainId: Blockchain("eip155:1")!, + ttl: ttl + ) + } + + static func stubWithExpiry(expiry: UInt64) -> Request { return Request( + id: RPCID(JsonRpcID.generate()), topic: "topic", method: "method", params: AnyCodable("params"), From 9cbab482954571bb52ba740cece3574d265a3e93 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 10:29:01 +0100 Subject: [PATCH 201/814] remove the commented namespace test --- Sources/WalletConnectSign/Namespace.swift | 3 -- .../AutoNamespacesValidationTests.swift | 37 ------------------- 2 files changed, 40 deletions(-) diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 6de73e1cc..eb3230523 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -148,9 +148,6 @@ enum SessionProperties { public enum AutoNamespaces { /// For a wallet to build session proposal structure by provided supported chains, methods, events & accounts. - /// - Parameters: - /// - proposalId: Session Proposal id - /// - namespaces: namespaces for given session, needs to contain at least required namespaces proposed by dApp. public static func build( sessionProposal: Session.Proposal, chains: [Blockchain], diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index db78b0433..1942c9d75 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -999,41 +999,4 @@ final class AutoNamespacesValidationTests: XCTestCase { ] XCTAssertEqual(sessionNamespaces, expectedNamespaces) } - -// func testSessionNamespacesContainsSupportedChainsAndMethodsWhenOptionalAndRequiredNamespacesAreEmpty() { -// let requiredNamespaces = [String: ProposalNamespace]() -// let optionalNamespaces = [String: ProposalNamespace]() -// let sessionProposal = Session.Proposal( -// id: "", -// pairingTopic: "", -// proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), -// requiredNamespaces: requiredNamespaces, -// optionalNamespaces: optionalNamespaces, -// sessionProperties: nil, -// proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) -// ) -// let sessionNamespaces = try! AutoNamespaces.build( -// sessionProposal: sessionProposal, -// chains: [Blockchain("eip155:1")!, Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], -// methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "solana_signMessage", "solana_signMessage"], -// events: ["chainChanged", "accountsChanged"], -// accounts: [] -// ) -// let expectedNamespaces: [String: SessionNamespace] = [ -// "eip155": SessionNamespace( -// chains: [Blockchain("eip155:1")!], -// accounts: Set([]), -// methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign"], -// events: ["chainChanged", "accountsChanged"] -// ), -// "solana": SessionNamespace( -// chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], -// accounts: Set([]), -// methods: ["solana_signMessage"], -// events: [] -// ) -// ] -// XCTAssertEqual(sessionNamespaces, expectedNamespaces) -// } - } From fd25d8acda61659653db5591ff9e6fa723c97764 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 10:45:47 +0100 Subject: [PATCH 202/814] Add check for empty session namespaces --- .../WalletConnectSign/Engine/Common/ApproveEngine.swift | 7 ++++++- Sources/WalletConnectSign/Namespace.swift | 4 +++- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 2bb7b63f5..d2448c800 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -10,6 +10,7 @@ final class ApproveEngine { case agreementMissingOrInvalid case networkNotConnected case proposalExpired + case emtySessionNamespacesForbidden } var onSessionProposal: ((Session.Proposal, VerifyContext?) -> Void)? @@ -65,7 +66,9 @@ final class ApproveEngine { func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws { logger.debug("Approving session proposal") - + + guard !sessionNamespaces.isEmpty else { throw Errors.emtySessionNamespacesForbidden } + guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { throw Errors.proposalNotFound } @@ -441,6 +444,8 @@ extension ApproveEngine.Errors: LocalizedError { return "Network not connected." case .proposalExpired: return "Proposal expired." + case .emtySessionNamespacesForbidden: + return "Session Namespaces Cannot Be Empty" } } } diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index eb3230523..97f4a70a5 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -3,6 +3,7 @@ public enum AutoNamespacesError: Error { case requiredAccountsNotSatisfied case requiredMethodsNotSatisfied case requiredEventsNotSatisfied + case emtySessionNamespacesForbidden } public struct ProposalNamespace: Equatable, Codable { @@ -322,7 +323,8 @@ public enum AutoNamespaces { } } } - + guard !sessionNamespaces.isEmpty else { throw AutoNamespacesError.emtySessionNamespacesForbidden } + return sessionNamespaces } } From 00d1080e8aec54bcd9936697d731fcf956832773 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 10:52:53 +0100 Subject: [PATCH 203/814] add check for empty session namespaces --- .../AutoNamespacesValidationTests.swift | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 1942c9d75..8e2d5260c 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -999,4 +999,28 @@ final class AutoNamespacesValidationTests: XCTestCase { ] XCTAssertEqual(sessionNamespaces, expectedNamespaces) } + + func testBuildThrowsWhenSessionNamespacesAreEmpty() { + let sessionProposal = Session.Proposal( + id: "", + pairingTopic: "", + proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + requiredNamespaces: [:], + optionalNamespaces: [:], + sessionProperties: nil, + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + ) + + XCTAssertThrowsError(try AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [], + methods: [], + events: [], + accounts: [] + ), "Expected to throw AutoNamespacesError.emtySessionNamespacesForbidden, but it did not") { error in + guard case AutoNamespacesError.emtySessionNamespacesForbidden = error else { + return XCTFail("Unexpected error type: \(error)") + } + } + } } From 3f50f729c43800ff6b9492c4aa28030d7385a4d7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 11:12:42 +0100 Subject: [PATCH 204/814] add localised description for namespaces error --- Sources/WalletConnectSign/Namespace.swift | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 97f4a70a5..08ded8326 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -1,9 +1,26 @@ -public enum AutoNamespacesError: Error { +import Foundation + +public enum AutoNamespacesError: Error, LocalizedError { case requiredChainsNotSatisfied case requiredAccountsNotSatisfied case requiredMethodsNotSatisfied case requiredEventsNotSatisfied case emtySessionNamespacesForbidden + + public var errorDescription: String? { + switch self { + case .requiredChainsNotSatisfied: + return "The required chains are not satisfied." + case .requiredAccountsNotSatisfied: + return "The required accounts are not satisfied." + case .requiredMethodsNotSatisfied: + return "The required methods are not satisfied." + case .requiredEventsNotSatisfied: + return "The required events are not satisfied." + case .emtySessionNamespacesForbidden: + return "Empty session namespaces are not allowed." + } + } } public struct ProposalNamespace: Equatable, Codable { From 94c2a029b55e3d7cb2fc6e1dd6585fbd8df6a012 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 14:58:01 +0100 Subject: [PATCH 205/814] savepoint --- .../Sign/SessionAccount/SessionAccountPresenter.swift | 4 ++-- Sources/WalletConnectSign/Request.swift | 7 +++++++ 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 3df1a674f..a5d8db3f0 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -41,8 +41,8 @@ final class SessionAccountPresenter: ObservableObject { do { let requestParams = try getRequest(for: method) - let expiry = UInt64(Date().timeIntervalSince1970 + 300) - let request = Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, expiry: expiry) + let ttl: TimeInterval = 300 + let request = Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, ttl: ttl) Task { do { await ActivityIndicatorManager.shared.start() diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index b971d8716..796ae02f2 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -17,6 +17,13 @@ public struct Request: Codable, Equatable { static let minTtl: TimeInterval = 300 // 5 minutes static let maxTtl: TimeInterval = 604800 // 7 days + + /// - Parameters: + /// - topic: topic of a session + /// - method: request method + /// - params: request params + /// - chainId: chain id + /// - ttl: ttl of a request, will be used to calculate expiry, 5 minutes by default public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, ttl: TimeInterval = 300) throws { guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { throw Errors.invalidTtl From 69d4b4c8b352d8037a5b81da02e25c0c997c50ce Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 16:12:18 +0100 Subject: [PATCH 206/814] integrate loaders in a dapp --- .../Sign/SessionAccount/SessionAccountPresenter.swift | 2 +- Example/DApp/Modules/Sign/SignPresenter.swift | 9 +++++++++ Example/DApp/Modules/Sign/SignRouter.swift | 4 ++++ 3 files changed, 14 insertions(+), 1 deletion(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index a5d8db3f0..9614555f4 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -42,7 +42,7 @@ final class SessionAccountPresenter: ObservableObject { let requestParams = try getRequest(for: method) let ttl: TimeInterval = 300 - let request = Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, ttl: ttl) + let request = try Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, ttl: ttl) Task { do { await ActivityIndicatorManager.shared.start() diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index a4ab56cce..978ee5694 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -107,6 +107,8 @@ extension SignPresenter { .receive(on: DispatchQueue.main) .sink { [unowned self] _ in self.accountsDetails.removeAll() + router.popToRoot() + Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } } .store(in: &subscriptions) @@ -117,6 +119,13 @@ extension SignPresenter { } .store(in: &subscriptions) + Sign.instance.requestExpirationPublisher + .receive(on: DispatchQueue.main) + .sink { _ in + Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + } + .store(in: &subscriptions) + } private func getSession() { diff --git a/Example/DApp/Modules/Sign/SignRouter.swift b/Example/DApp/Modules/Sign/SignRouter.swift index 5e0155007..a68ad5f9a 100644 --- a/Example/DApp/Modules/Sign/SignRouter.swift +++ b/Example/DApp/Modules/Sign/SignRouter.swift @@ -26,4 +26,8 @@ final class SignRouter { func dismiss() { viewController.dismiss(animated: true) } + + func popToRoot() { + viewController.popToRoot() + } } From 53b760cefb3fe25ff85fa8291957b3e3769910b6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 16 Jan 2024 16:14:02 +0100 Subject: [PATCH 207/814] dapp - add alert on expired request --- Example/DApp/Modules/Sign/SignPresenter.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 978ee5694..eebd94013 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -123,6 +123,7 @@ extension SignPresenter { .receive(on: DispatchQueue.main) .sink { _ in Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + AlertPresenter.present(message: "Session Request has expired", type: .warning) } .store(in: &subscriptions) From 2d77e486eebd889c318c4d9786395979f40a074a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jan 2024 11:02:09 +0100 Subject: [PATCH 208/814] update min expiry to 10 minutes --- .../Sign/SessionAccount/SessionAccountPresenter.swift | 2 +- Sources/WalletConnectSign/Request.swift | 6 +++--- .../ProtocolMethods/SessionRequestProtocolMethod.swift | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 9614555f4..62e9ae725 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -41,7 +41,7 @@ final class SessionAccountPresenter: ObservableObject { do { let requestParams = try getRequest(for: method) - let ttl: TimeInterval = 300 + let ttl: TimeInterval = 600 let request = try Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, ttl: ttl) Task { do { diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index 796ae02f2..9a185141a 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -14,7 +14,7 @@ public struct Request: Codable, Equatable { public var expiry: UInt64? // TTL bounds - static let minTtl: TimeInterval = 300 // 5 minutes + static let minTtl: TimeInterval = 600 // 10 minutes static let maxTtl: TimeInterval = 604800 // 7 days @@ -23,8 +23,8 @@ public struct Request: Codable, Equatable { /// - method: request method /// - params: request params /// - chainId: chain id - /// - ttl: ttl of a request, will be used to calculate expiry, 5 minutes by default - public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, ttl: TimeInterval = 300) throws { + /// - ttl: ttl of a request, will be used to calculate expiry, 10 minutes by default + public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, ttl: TimeInterval = 600) throws { guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { throw Errors.invalidTtl } diff --git a/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift b/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift index 28ee6d446..c6decfd9f 100644 --- a/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift +++ b/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift @@ -2,7 +2,7 @@ import Foundation struct SessionRequestProtocolMethod: ProtocolMethod { - static let defaultTtl: Int = 300 + static let defaultTtl: Int = 600 let method: String = "wc_sessionRequest" From 8f76ed75a05426df1a1f2a95dcb91acf94175cd9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jan 2024 11:46:35 +0100 Subject: [PATCH 209/814] add padding to sing view list --- Example/DApp/Modules/Sign/SignView.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index fc60a1754..54c9d62e7 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -59,6 +59,7 @@ struct SignView: View { .padding(12) } } + .padding(.bottom, presenter.accountsDetails.isEmpty ? 0 : 76) .onAppear { presenter.onAppear() } From 5a6f237aa1ebb720bf6b0ed5be2a716b389ddc22 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jan 2024 12:38:57 +0100 Subject: [PATCH 210/814] fix encoded uri parsing --- .../WalletConnectUtilsTests.xcscheme | 53 +++++++++++++++++++ .../WalletConnectUtils/WalletConnectURI.swift | 15 +++--- .../WalletConnectURITests.swift | 12 +++++ 3 files changed, 72 insertions(+), 8 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme new file mode 100644 index 000000000..c78f495d4 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectUtilsTests.xcscheme @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 2f068a67f..02d1af1aa 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -23,7 +23,8 @@ public struct WalletConnectURI: Equatable { } public init?(string: String) { - guard let components = Self.parseURIComponents(from: string) else { + let decodedString = string.removingPercentEncoding ?? string + guard let components = Self.parseURIComponents(from: decodedString) else { return nil } let query: [String: String]? = components.queryItems?.reduce(into: [:]) { $0[$1.name] = $1.value } @@ -45,11 +46,8 @@ public struct WalletConnectURI: Equatable { } public init?(deeplinkUri: URL) { - if let deeplinkUri = deeplinkUri.query?.replacingOccurrences(of: "uri=", with: "") { - self.init(string: deeplinkUri) - } else { - return nil - } + let uriString = deeplinkUri.query?.replacingOccurrences(of: "uri=", with: "") ?? "" + self.init(string: uriString) } private var relayQuery: String { @@ -61,10 +59,11 @@ public struct WalletConnectURI: Equatable { } private static func parseURIComponents(from string: String) -> URLComponents? { - guard string.hasPrefix("wc:") else { + let decodedString = string.removingPercentEncoding ?? string + guard decodedString.hasPrefix("wc:") else { return nil } - let urlString = !string.hasPrefix("wc://") ? string.replacingOccurrences(of: "wc:", with: "wc://") : string + let urlString = !decodedString.hasPrefix("wc://") ? decodedString.replacingOccurrences(of: "wc:", with: "wc://") : decodedString return URLComponents(string: urlString) } } diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index 5f65b5c28..6404e7b41 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -67,4 +67,16 @@ final class WalletConnectURITests: XCTestCase { let uri = WalletConnectURI(string: inputURIString) XCTAssertNil(uri) } + + func testInitHandlesURLEncodedString() { + let input = stubURI() + let encodedURIString = input.string + .addingPercentEncoding(withAllowedCharacters: .alphanumerics) ?? "" + let uri = WalletConnectURI(string: encodedURIString) + + // Assert that the initializer can handle encoded URI and it matches the expected URI + XCTAssertEqual(input.uri, uri) + XCTAssertEqual(input.string, uri?.absoluteString) + } + } From a38716ca4c4147cfae92c543e9ca20ddd85322c3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jan 2024 12:39:09 +0100 Subject: [PATCH 211/814] fix tests build --- Tests/Web3WalletTests/Mocks/SignClientMock.swift | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index 75a788a55..4d74e4b47 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -4,7 +4,6 @@ import Combine @testable import WalletConnectSign final class SignClientMock: SignClientProtocol { - private var logsSubject = PassthroughSubject() var logsPublisher: AnyPublisher { @@ -23,7 +22,7 @@ final class SignClientMock: SignClientProtocol { var requestCalled = false private let metadata = AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) - private let request = WalletConnectSign.Request(id: .left(""), topic: "", method: "", params: "", chainId: Blockchain("eip155:1")!, expiry: nil) + private let request = WalletConnectSign.Request(id: .left(""), topic: "", method: "", params: AnyCodable(""), chainId: Blockchain("eip155:1")!, expiry: nil) private let response = WalletConnectSign.Response(id: RPCID(1234567890123456789), topic: "", chainId: "", result: .response(AnyCodable(any: ""))) var sessionProposalPublisher: AnyPublisher<(proposal: WalletConnectSign.Session.Proposal, context: VerifyContext?), Never> { @@ -64,7 +63,17 @@ final class SignClientMock: SignClientProtocol { return Result.Publisher(("topic", ReasonMock())) .eraseToAnyPublisher() } - + + var pendingProposalsPublisher: AnyPublisher<[(proposal: WalletConnectSign.Session.Proposal, context: WalletConnectSign.VerifyContext?)], Never> { + return Result.Publisher([]) + .eraseToAnyPublisher() + } + + var requestExpirationPublisher: AnyPublisher { + Result.Publisher(request) + .eraseToAnyPublisher() + } + var sessionEventPublisher: AnyPublisher<(event: WalletConnectSign.Session.Event, sessionTopic: String, chainId: WalletConnectUtils.Blockchain?), Never> { return Result.Publisher( ( From 6482f1a49e100cfec26dd2b92b4fff492f0bb583 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jan 2024 12:48:17 +0100 Subject: [PATCH 212/814] remove showcase garbage --- Example/DApp/Modules/Sign/NewPairing/NewPairingRouter.swift | 1 - .../PresentationLayer/Wallet/AuthRequest/AuthRequestRouter.swift | 1 - 2 files changed, 2 deletions(-) diff --git a/Example/DApp/Modules/Sign/NewPairing/NewPairingRouter.swift b/Example/DApp/Modules/Sign/NewPairing/NewPairingRouter.swift index 51fc5b2f2..89c0ea8a7 100644 --- a/Example/DApp/Modules/Sign/NewPairing/NewPairingRouter.swift +++ b/Example/DApp/Modules/Sign/NewPairing/NewPairingRouter.swift @@ -11,6 +11,5 @@ final class NewPairingRouter { func dismiss() { viewController.dismiss(animated: true) - UIApplication.shared.open(URL(string: "showcase://")!) } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestRouter.swift index 76e35da11..d21c62d49 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestRouter.swift @@ -11,6 +11,5 @@ final class AuthRequestRouter { func dismiss() { viewController.dismiss() - UIApplication.shared.open(URL(string: "showcase://")!) } } From 1a94a20d78ad0c9e2a53c2b8922cb0bc148093fe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jan 2024 13:06:41 +0100 Subject: [PATCH 213/814] add loading view --- .../SessionAccountPresenter.swift | 9 ++++++- .../SessionAccount/SessionAccountView.swift | 25 +++++++++++++++++-- 2 files changed, 31 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 62e9ae725..026ce969f 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -12,7 +12,9 @@ final class SessionAccountPresenter: ObservableObject { @Published var showError = false @Published var errorMessage = String.empty @Published var showRequestSent = false - + @Published var requesting = false + + private let interactor: SessionAccountInteractor private let router: SessionAccountRouter private let session: Session @@ -47,10 +49,14 @@ final class SessionAccountPresenter: ObservableObject { do { await ActivityIndicatorManager.shared.start() try await Sign.instance.request(params: request) + await ActivityIndicatorManager.shared.stop() + requesting = true DispatchQueue.main.async { [weak self] in self?.openWallet() } } catch { + await ActivityIndicatorManager.shared.stop() + requesting = false showError.toggle() errorMessage = error.localizedDescription } @@ -72,6 +78,7 @@ extension SessionAccountPresenter { Sign.instance.sessionResponsePublisher .receive(on: DispatchQueue.main) .sink { [unowned self] response in + requesting = false presentResponse(response: response) } .store(in: &subscriptions) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift index 1b8a3ebb8..b4ee2a608 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift @@ -8,9 +8,11 @@ struct SessionAccountView: View { var body: some View { NavigationStack { ZStack { + Color(red: 25/255, green: 26/255, blue: 26/255) .ignoresSafeArea() - + + ScrollView { VStack(spacing: 12) { networkView(title: String(presenter.sessionAccount.chain.split(separator: ":").first ?? "")) @@ -21,6 +23,14 @@ struct SessionAccountView: View { } .padding(12) } + + if presenter.requesting { + loadingView + .frame(width: 200, height: 200) + .background(Color.gray.opacity(0.95)) + .cornerRadius(20) + .shadow(radius: 10) + } } .navigationTitle(presenter.sessionAccount.chain) .navigationBarTitleDisplayMode(.inline) @@ -179,7 +189,18 @@ struct SessionAccountView: View { } } } - + + private var loadingView: some View { + VStack { + ProgressView() + .progressViewStyle(CircularProgressViewStyle(tint: .black)) + .scaleEffect(1.5) + Text("Request sent, waiting for response") + .foregroundColor(.white) + .padding(.top, 20) + } + } + private func responseView(response: Response) -> some View { ZStack { RoundedRectangle(cornerRadius: 16) From 3e5add4d37df3cd97fc4fe6e5d611304b99ce4e1 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 17 Jan 2024 19:06:16 +0300 Subject: [PATCH 214/814] publish with ack --- Sources/WalletConnectRelay/RelayClient.swift | 39 +++++++++++++++++--- Sources/WalletConnectRelay/RelayError.swift | 16 ++++++++ 2 files changed, 50 insertions(+), 5 deletions(-) create mode 100644 Sources/WalletConnectRelay/RelayError.swift diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 441f40314..24cae47c0 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -34,6 +34,11 @@ public final class RelayClient { subscriptionResponsePublisherSubject.eraseToAnyPublisher() } + private let requestAcknowledgePublisherSubject = PassthroughSubject() + private var requestAcknowledgePublisher: AnyPublisher { + requestAcknowledgePublisherSubject.eraseToAnyPublisher() + } + private let clientIdStorage: ClientIdStoring private var dispatcher: Dispatching @@ -86,13 +91,35 @@ public final class RelayClient { try dispatcher.disconnect(closeCode: closeCode) } - /// Completes when networking client sends a request, error if it fails on client side + /// Completes with an acknowledgement from the relay network public func publish(topic: String, payload: String, tag: Int, prompt: Bool, ttl: Int) async throws { - let request = Publish(params: .init(topic: topic, message: payload, ttl: ttl, prompt: prompt, tag: tag)) - .asRPCRequest() + let request = Publish(params: .init(topic: topic, message: payload, ttl: ttl, prompt: prompt, tag: tag)).asRPCRequest() let message = try request.asJSONEncodedString() - logger.debug("Publishing payload on topic: \(topic)") + + logger.debug("[Publish] Sending payload on topic: \(topic)") + try await dispatcher.protectedSend(message) + + return try await withUnsafeThrowingContinuation { continuation in + var cancellable: AnyCancellable? + cancellable = requestAcknowledgePublisher + .filter { $0 == request.id } + .setFailureType(to: RelayError.self) + .timeout(.seconds(10), scheduler: concurrentQueue, customError: { .requestTimeout }) + .sink(receiveCompletion: { [unowned self] result in + switch result { + case .failure(let error): + cancellable?.cancel() + logger.debug("[Publish] Relay request timeout for topic: \(topic)") + continuation.resume(throwing: error) + case .finished: break + } + }, receiveValue: { [unowned self] _ in + cancellable?.cancel() + logger.debug("[Publish] Published payload on topic: \(topic)") + continuation.resume(returning: ()) + }) + } } public func subscribe(topic: String) async throws { @@ -204,7 +231,9 @@ public final class RelayClient { } else if let response = tryDecode(RPCResponse.self, from: payload) { switch response.outcome { case .response(let anyCodable): - if let subscriptionId = try? anyCodable.get(String.self) { + if let _ = try? anyCodable.get(Bool.self) { + requestAcknowledgePublisherSubject.send(response.id) + } else if let subscriptionId = try? anyCodable.get(String.self) { subscriptionResponsePublisherSubject.send((response.id, [subscriptionId])) } else if let subscriptionIds = try? anyCodable.get([String].self) { subscriptionResponsePublisherSubject.send((response.id, subscriptionIds)) diff --git a/Sources/WalletConnectRelay/RelayError.swift b/Sources/WalletConnectRelay/RelayError.swift new file mode 100644 index 000000000..39d725d7c --- /dev/null +++ b/Sources/WalletConnectRelay/RelayError.swift @@ -0,0 +1,16 @@ +import Foundation + +enum RelayError: Error, LocalizedError { + case requestTimeout + + var errorDescription: String? { + return localizedDescription + } + + var localizedDescription: String { + switch self { + case .requestTimeout: + return "Relay request timeout" + } + } +} From feeca0cece77d23520c6d8935ec7294473dc63c7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 11:00:44 +0100 Subject: [PATCH 215/814] approve idempotency --- Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index d2448c800..6c5238dbb 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -88,9 +88,6 @@ final class ApproveEngine { let pairingTopic = payload.topic - proposalPayloadsStore.delete(forKey: proposerPubKey) - verifyContextStore.delete(forKey: proposerPubKey) - try Namespace.validate(sessionNamespaces) try Namespace.validateApproved(sessionNamespaces, against: proposal.requiredNamespaces) @@ -129,6 +126,9 @@ final class ApproveEngine { logger.debug("Session proposal response and settle request have been sent") + proposalPayloadsStore.delete(forKey: proposerPubKey) + verifyContextStore.delete(forKey: proposerPubKey) + pairingRegisterer.activate( pairingTopic: payload.topic, peerMetadata: payload.request.proposer.metadata From 6530fdcb0bba9399d7efb89b05414910465f3fd0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 13:11:32 +0100 Subject: [PATCH 216/814] add more loaders --- Example/DApp/Modules/Sign/SignPresenter.swift | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index eebd94013..9c3c9ecca 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -57,12 +57,18 @@ final class SignPresenter: ObservableObject { Task { let uri = try await Pair.instance.create() walletConnectUri = uri - try await Sign.instance.connect( - requiredNamespaces: Proposal.requiredNamespaces, - optionalNamespaces: Proposal.optionalNamespaces, - topic: uri.topic - ) - router.presentNewPairing(walletConnectUri: uri) + do { + await ActivityIndicatorManager.shared.start() + try await Sign.instance.connect( + requiredNamespaces: Proposal.requiredNamespaces, + optionalNamespaces: Proposal.optionalNamespaces, + topic: uri.topic + ) + await ActivityIndicatorManager.shared.stop() + router.presentNewPairing(walletConnectUri: uri) + } catch { + await ActivityIndicatorManager.shared.stop() + } } } From 330429ba6cbd9c32b3f7e3bdd01f8406ed2734ef Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 14:07:43 +0100 Subject: [PATCH 217/814] change expiry to expiryTimestamp --- Example/IntegrationTests/Sign/SignClientTests.swift | 4 ++-- .../Engine/Common/SessionEngine.swift | 2 +- Sources/WalletConnectSign/Request.swift | 10 +++++----- .../Types/Session/SessionProposal.swift | 8 ++++---- .../WalletConnectSign/Types/Session/WCSession.swift | 4 ++-- .../WalletConnectSignTests/SessionProposalTests.swift | 6 +++--- Tests/WalletConnectSignTests/Stub/Session+Stub.swift | 2 +- 7 files changed, 18 insertions(+), 18 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 4cecd7bb0..900289d42 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -197,7 +197,7 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - let request = Request(id: RPCID(0), topic: settledSession.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) + let request = try! Request(id: RPCID(0), topic: settledSession.topic, method: requestMethod, params: requestParams, chainId: chain) try await dapp.request(params: request) } }.store(in: &publishers) @@ -244,7 +244,7 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - let request = Request(id: RPCID(0), topic: settledSession.topic, method: requestMethod, params: requestParams, chainId: chain, expiry: nil) + let request = try! Request(id: RPCID(0), topic: settledSession.topic, method: requestMethod, params: requestParams, chainId: chain) try await dapp.request(params: request) } }.store(in: &publishers) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 9053ff292..9d252423f 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -63,7 +63,7 @@ final class SessionEngine { guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { throw WalletConnectError.invalidPermissions } - let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiry: request.expiry) + let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiry: request.expiryTimestamp) let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) let ttl = try request.calculateTtl() let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index 9a185141a..22d03eb81 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -11,7 +11,7 @@ public struct Request: Codable, Equatable { public let method: String public let params: AnyCodable public let chainId: Blockchain - public var expiry: UInt64? + public var expiryTimestamp: UInt64? // TTL bounds static let minTtl: TimeInterval = 600 // 10 minutes @@ -33,7 +33,7 @@ public struct Request: Codable, Equatable { self.init(id: RPCID(JsonRpcID.generate()), topic: topic, method: method, params: params, chainId: chainId, expiry: calculatedExpiry) } - init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, ttl: TimeInterval) throws where C: Codable { + init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, ttl: TimeInterval = 600) throws where C: Codable { guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { throw Errors.invalidTtl } @@ -48,17 +48,17 @@ public struct Request: Codable, Equatable { self.method = method self.params = params self.chainId = chainId - self.expiry = expiry + self.expiryTimestamp = expiry } func isExpired(currentDate: Date = Date()) -> Bool { - guard let expiry = expiry else { return false } + guard let expiry = expiryTimestamp else { return false } let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) return expiryDate < currentDate } func calculateTtl(currentDate: Date = Date()) throws -> Int { - guard let expiry = expiry else { return Int(Self.minTtl) } + guard let expiry = expiryTimestamp else { return Int(Self.minTtl) } let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) let diff = expiryDate.timeIntervalSince(currentDate) diff --git a/Sources/WalletConnectSign/Types/Session/SessionProposal.swift b/Sources/WalletConnectSign/Types/Session/SessionProposal.swift index 8834417a9..2723ef46c 100644 --- a/Sources/WalletConnectSign/Types/Session/SessionProposal.swift +++ b/Sources/WalletConnectSign/Types/Session/SessionProposal.swift @@ -7,9 +7,9 @@ struct SessionProposal: Codable, Equatable { let requiredNamespaces: [String: ProposalNamespace] let optionalNamespaces: [String: ProposalNamespace]? let sessionProperties: [String: String]? - let expiry: UInt64? + let expiryTimestamp: UInt64? - static let proposalExpiry: TimeInterval = 300 // 5 minutes + static let proposalTtl: TimeInterval = 300 // 5 minutes internal init(relays: [RelayProtocolOptions], proposer: Participant, @@ -21,7 +21,7 @@ struct SessionProposal: Codable, Equatable { self.requiredNamespaces = requiredNamespaces self.optionalNamespaces = optionalNamespaces self.sessionProperties = sessionProperties - self.expiry = UInt64(Date().timeIntervalSince1970 + Self.proposalExpiry) + self.expiryTimestamp = UInt64(Date().timeIntervalSince1970 + Self.proposalTtl) } func publicRepresentation(pairingTopic: String) -> Session.Proposal { @@ -37,7 +37,7 @@ struct SessionProposal: Codable, Equatable { } func isExpired(currentDate: Date = Date()) -> Bool { - guard let expiry = expiry else { return false } + guard let expiry = expiryTimestamp else { return false } let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) diff --git a/Sources/WalletConnectSign/Types/Session/WCSession.swift b/Sources/WalletConnectSign/Types/Session/WCSession.swift index 30d237a85..a24b13691 100644 --- a/Sources/WalletConnectSign/Types/Session/WCSession.swift +++ b/Sources/WalletConnectSign/Types/Session/WCSession.swift @@ -65,7 +65,7 @@ struct WCSession: SequenceObject, Equatable { events: Set, accounts: Set, acknowledged: Bool, - expiry: Int64 + expiryTimestamp: Int64 ) { self.topic = topic self.pairingTopic = pairingTopic @@ -78,7 +78,7 @@ struct WCSession: SequenceObject, Equatable { self.sessionProperties = sessionProperties self.requiredNamespaces = requiredNamespaces self.acknowledged = acknowledged - self.expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) + self.expiryDate = Date(timeIntervalSince1970: TimeInterval(expiryTimestamp)) } #endif diff --git a/Tests/WalletConnectSignTests/SessionProposalTests.swift b/Tests/WalletConnectSignTests/SessionProposalTests.swift index d78180817..e490ba5be 100644 --- a/Tests/WalletConnectSignTests/SessionProposalTests.swift +++ b/Tests/WalletConnectSignTests/SessionProposalTests.swift @@ -10,13 +10,13 @@ class SessionProposalTests: XCTestCase { func testProposalExpired() { let proposal = SessionProposal.stub() - let expiredDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiry! + 1)) + let expiredDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiryTimestamp! + 1)) XCTAssertTrue(proposal.isExpired(currentDate: expiredDate), "Proposal should be expired after the expiry time.") } func testProposalNotExpiredJustBeforeExpiry() { let proposal = SessionProposal.stub() - let justBeforeExpiryDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiry! - 1)) + let justBeforeExpiryDate = Date(timeIntervalSince1970: TimeInterval(proposal.expiryTimestamp! - 1)) XCTAssertFalse(proposal.isExpired(currentDate: justBeforeExpiryDate), "Proposal should not be expired just before the expiry time.") } @@ -45,6 +45,6 @@ class SessionProposalTests: XCTestCase { // Assertions XCTAssertNotNil(proposal, "Proposal should be successfully decoded even without an expiry field.") - XCTAssertNil(proposal.expiry, "Expiry should be nil if not provided in JSON.") + XCTAssertNil(proposal.expiryTimestamp, "Expiry should be nil if not provided in JSON.") } } diff --git a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift index 37fcfdef9..67bc7045d 100644 --- a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift +++ b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift @@ -31,7 +31,7 @@ extension WCSession { events: [], accounts: Account.stubSet(), acknowledged: acknowledged, - expiry: Int64(expiryDate.timeIntervalSince1970)) + expiryTimestamp: Int64(expiryDate.timeIntervalSince1970)) } } From 808b114d54ab7cf8c1deb6ab528232b9ca07a75c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 14:20:03 +0100 Subject: [PATCH 218/814] fix testSessionReject --- Example/IntegrationTests/Sign/SignClientTests.swift | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 900289d42..fd4100025 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -100,6 +100,7 @@ final class SignClientTests: XCTestCase { class Store { var rejectedProposal: Session.Proposal? } let store = Store() + let semaphore = DispatchSemaphore(value: 0) let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) @@ -110,10 +111,12 @@ final class SignClientTests: XCTestCase { do { try await wallet.reject(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason store.rejectedProposal = proposal + semaphore.signal() } catch { XCTFail("\(error)") } } }.store(in: &publishers) dapp.sessionRejectionPublisher.sink { proposal, _ in + semaphore.wait() XCTAssertEqual(store.rejectedProposal, proposal) sessionRejectExpectation.fulfill() // TODO: Assert reason code }.store(in: &publishers) From 37f80dedb0941e48364e6230cba9360564a76465 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 14:20:03 +0100 Subject: [PATCH 219/814] fix testSessionReject --- Example/IntegrationTests/Sign/SignClientTests.swift | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 4cecd7bb0..28202a224 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -100,6 +100,7 @@ final class SignClientTests: XCTestCase { class Store { var rejectedProposal: Session.Proposal? } let store = Store() + let semaphore = DispatchSemaphore(value: 0) let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) @@ -110,10 +111,12 @@ final class SignClientTests: XCTestCase { do { try await wallet.reject(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason store.rejectedProposal = proposal + semaphore.signal() } catch { XCTFail("\(error)") } } }.store(in: &publishers) dapp.sessionRejectionPublisher.sink { proposal, _ in + semaphore.wait() XCTAssertEqual(store.rejectedProposal, proposal) sessionRejectExpectation.fulfill() // TODO: Assert reason code }.store(in: &publishers) From a93ba0b150e61249a1d13d171f4be8ffb436c599 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 14:49:02 +0100 Subject: [PATCH 220/814] change min ttl for request --- .../Sign/SessionAccount/SessionAccountPresenter.swift | 2 +- Sources/WalletConnectSign/Request.swift | 6 +++--- .../ProtocolMethods/SessionRequestProtocolMethod.swift | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 026ce969f..9d3fecad8 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -43,7 +43,7 @@ final class SessionAccountPresenter: ObservableObject { do { let requestParams = try getRequest(for: method) - let ttl: TimeInterval = 600 + let ttl: TimeInterval = 300 let request = try Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, ttl: ttl) Task { do { diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index 22d03eb81..f5404ec0b 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -14,7 +14,7 @@ public struct Request: Codable, Equatable { public var expiryTimestamp: UInt64? // TTL bounds - static let minTtl: TimeInterval = 600 // 10 minutes + static let minTtl: TimeInterval = 300 // 5 minutes static let maxTtl: TimeInterval = 604800 // 7 days @@ -24,7 +24,7 @@ public struct Request: Codable, Equatable { /// - params: request params /// - chainId: chain id /// - ttl: ttl of a request, will be used to calculate expiry, 10 minutes by default - public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, ttl: TimeInterval = 600) throws { + public init(topic: String, method: String, params: AnyCodable, chainId: Blockchain, ttl: TimeInterval = 300) throws { guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { throw Errors.invalidTtl } @@ -33,7 +33,7 @@ public struct Request: Codable, Equatable { self.init(id: RPCID(JsonRpcID.generate()), topic: topic, method: method, params: params, chainId: chainId, expiry: calculatedExpiry) } - init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, ttl: TimeInterval = 600) throws where C: Codable { + init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, ttl: TimeInterval = 300) throws where C: Codable { guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { throw Errors.invalidTtl } diff --git a/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift b/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift index c6decfd9f..28ee6d446 100644 --- a/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift +++ b/Sources/WalletConnectSign/Types/ProtocolMethods/SessionRequestProtocolMethod.swift @@ -2,7 +2,7 @@ import Foundation struct SessionRequestProtocolMethod: ProtocolMethod { - static let defaultTtl: Int = 600 + static let defaultTtl: Int = 300 let method: String = "wc_sessionRequest" From 7680f68facc3ce37a0c508484f3a402849b2f9a1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 15:03:28 +0100 Subject: [PATCH 221/814] add message when pairing takes too long --- .../Wallet/Wallet/WalletPresenter.swift | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index d88ced542..41bcbe2c5 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -13,10 +13,15 @@ final class WalletPresenter: ObservableObject { private let importAccount: ImportAccount private let app: Application - + private var isPairingTimer: Timer? + @Published var sessions = [Session]() - @Published var showPairingLoading = false + @Published var showPairingLoading = false { + didSet { + handlePairingLoadingChanged() + } + } @Published var showError = false @Published var errorMessage = "Error" @Published var showConnectedSheet = false @@ -97,6 +102,16 @@ final class WalletPresenter: ObservableObject { } } } + + private func handlePairingLoadingChanged() { + isPairingTimer?.invalidate() + + if showPairingLoading { + isPairingTimer = Timer.scheduledTimer(withTimeInterval: 10.0, repeats: false) { [weak self] _ in + AlertPresenter.present(message: "Pairing takes longer then expected, check your internet connection or try again", type: .warning) + } + } + } } // MARK: - Private functions From ff1d34a8a32a9535829c982b9be6d81615e52479 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 18 Jan 2024 15:04:50 +0100 Subject: [PATCH 222/814] savepoint --- .../PresentationLayer/Wallet/Wallet/WalletPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 41bcbe2c5..1532b17b1 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -107,7 +107,7 @@ final class WalletPresenter: ObservableObject { isPairingTimer?.invalidate() if showPairingLoading { - isPairingTimer = Timer.scheduledTimer(withTimeInterval: 10.0, repeats: false) { [weak self] _ in + isPairingTimer = Timer.scheduledTimer(withTimeInterval: 10.0, repeats: false) { _ in AlertPresenter.present(message: "Pairing takes longer then expected, check your internet connection or try again", type: .warning) } } From fc1a8a6ac6f5ef09bd2b72bfbacba163878d06e0 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 18 Jan 2024 19:41:45 +0300 Subject: [PATCH 223/814] Delete on resolve --- .../NetworkingInteractor.swift | 6 +++--- .../WalletConnectUtils/RPCHistory/RPCHistory.swift | 11 ++++++++--- 2 files changed, 11 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index f311cdc5b..b428a77f5 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -171,9 +171,10 @@ public class NetworkingInteractor: NetworkInteracting { } public func respond(topic: String, response: RPCResponse, protocolMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType) async throws { - try rpcHistory.resolve(response) + try rpcHistory.validate(response) let message = try serializer.serialize(topic: topic, encodable: response, envelopeType: envelopeType) try await relayClient.publish(topic: topic, payload: message, tag: protocolMethod.responseConfig.tag, prompt: protocolMethod.responseConfig.prompt, ttl: protocolMethod.responseConfig.ttl) + try rpcHistory.resolve(response) } public func respondSuccess(topic: String, requestId: RPCID, protocolMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType) async throws { @@ -216,8 +217,7 @@ public class NetworkingInteractor: NetworkInteracting { private func handleResponse(topic: String, response: RPCResponse, publishedAt: Date, derivedTopic: String?) { do { - try rpcHistory.resolve(response) - let record = rpcHistory.get(recordId: response.id!)! + let record = try rpcHistory.resolve(response) responsePublisherSubject.send((topic, record.request, response, publishedAt, derivedTopic)) } catch { logger.debug("Handle json rpc response error: \(error)") diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 4fc00aebe..4cf815884 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -43,17 +43,22 @@ public final class RPCHistory { @discardableResult public func resolve(_ response: RPCResponse) throws -> Record { + let record = try validate(response) + storage.delete(forKey: "\(record.id)") + return record + } + + @discardableResult + public func validate(_ response: RPCResponse) throws -> Record { guard let id = response.id else { throw HistoryError.unidentifiedResponse } - guard var record = get(recordId: id) else { + guard let record = get(recordId: id) else { throw HistoryError.requestMatchingResponseNotFound } guard record.response == nil else { throw HistoryError.responseDuplicateNotAllowed } - record.response = response - storage.set(record, forKey: "\(record.id)") return record } From aaa925b0ce7c7fb4fbfb4c14e579747941f16856 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 18 Jan 2024 20:21:16 +0300 Subject: [PATCH 224/814] removeOutdated --- .../RPCHistory/RPCHistory.swift | 32 +++++++++++++++++-- 1 file changed, 29 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 4cf815884..5f02a10c8 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -1,3 +1,5 @@ +import Foundation + public final class RPCHistory { public struct Record: Codable { @@ -9,7 +11,8 @@ public final class RPCHistory { public let topic: String let origin: Origin public let request: RPCRequest - public var response: RPCResponse? + public let response: RPCResponse? + public var timestamp: Date? } enum HistoryError: Error { @@ -24,10 +27,13 @@ public final class RPCHistory { init(keyValueStore: CodableStore) { self.storage = keyValueStore + + removeOutdated() } public func get(recordId: RPCID) -> Record? { - try? storage.get(key: recordId.string) + // FOR TESTING!!! + try! storage.get(key: recordId.string) } public func set(_ request: RPCRequest, forTopic topic: String, emmitedBy origin: Record.Origin) throws { @@ -37,7 +43,7 @@ public final class RPCHistory { guard get(recordId: id) == nil else { throw HistoryError.requestDuplicateNotAllowed } - let record = Record(id: id, topic: topic, origin: origin, request: request) + let record = Record(id: id, topic: topic, origin: origin, request: request, response: nil, timestamp: Date()) storage.set(record, forKey: "\(record.id)") } @@ -100,3 +106,23 @@ public final class RPCHistory { storage.getAll().filter { $0.response == nil } } } + +private extension RPCHistory { + + func removeOutdated() { + let records = storage.getAll() + + let thirtyDays: TimeInterval = 30*86400 + + for var record in records { + if let timestamp = record.timestamp { + if timestamp.distance(to: Date()) > thirtyDays { + storage.delete(forKey: record.id.string) + } + } else { + record.timestamp = Date() + storage.set(record, forKey: "\(record.id)") + } + } + } +} From a41e93c630691d5b65cc163012c95fc04b3db1f6 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 18 Jan 2024 20:21:49 +0300 Subject: [PATCH 225/814] Force unwrap removed --- Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 5f02a10c8..44dfdad68 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -32,8 +32,7 @@ public final class RPCHistory { } public func get(recordId: RPCID) -> Record? { - // FOR TESTING!!! - try! storage.get(key: recordId.string) + try? storage.get(key: recordId.string) } public func set(_ request: RPCRequest, forTopic topic: String, emmitedBy origin: Record.Origin) throws { From 7d709770c034d19a160f4d828155bae5bc698910 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 11:52:01 +0300 Subject: [PATCH 226/814] RPCHistory tests resplved --- Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift | 2 +- Tests/WalletConnectUtilsTests/RPCHistoryTests.swift | 8 +++----- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 44dfdad68..84f93768f 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -106,7 +106,7 @@ public final class RPCHistory { } } -private extension RPCHistory { +extension RPCHistory { func removeOutdated() { let records = storage.getAll() diff --git a/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift b/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift index 37b05ccdd..82becd7b8 100644 --- a/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift @@ -35,10 +35,8 @@ final class RPCHistoryTests: XCTestCase { try sut.set(requestB, forTopic: String.randomTopic(), emmitedBy: .local) try sut.resolve(responseA) try sut.resolve(responseB) - let recordA = sut.get(recordId: requestA.id!) - let recordB = sut.get(recordId: requestB.id!) - XCTAssertEqual(recordA?.response, responseA) - XCTAssertEqual(recordB?.response, responseB) + XCTAssertNil(sut.get(recordId: requestA.id!)) + XCTAssertNil(sut.get(recordId: requestB.id!)) } func testDelete() throws { @@ -95,7 +93,7 @@ final class RPCHistoryTests: XCTestCase { } func testResolveDuplicateResponse() throws { - let expectedError = RPCHistory.HistoryError.responseDuplicateNotAllowed + let expectedError = RPCHistory.HistoryError.requestMatchingResponseNotFound let request = RPCRequest.stub() let responseA = RPCResponse(matchingRequest: request, result: true) From 7195db91b827fbfc4548a121f9b3828dfae98e31 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 12:38:49 +0300 Subject: [PATCH 227/814] Remove outdated tests --- .../RPCHistory/RPCHistory.swift | 4 ++-- Sources/WalletConnectUtils/TimeProvider.swift | 12 ++++++++++ .../RPCHistoryTests.swift | 23 +++++++++++++++++++ 3 files changed, 37 insertions(+), 2 deletions(-) create mode 100644 Sources/WalletConnectUtils/TimeProvider.swift diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 84f93768f..b310586d0 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -35,14 +35,14 @@ public final class RPCHistory { try? storage.get(key: recordId.string) } - public func set(_ request: RPCRequest, forTopic topic: String, emmitedBy origin: Record.Origin) throws { + public func set(_ request: RPCRequest, forTopic topic: String, emmitedBy origin: Record.Origin, time: TimeProvider = DefaultTimeProvider()) throws { guard let id = request.id else { throw HistoryError.unidentifiedRequest } guard get(recordId: id) == nil else { throw HistoryError.requestDuplicateNotAllowed } - let record = Record(id: id, topic: topic, origin: origin, request: request, response: nil, timestamp: Date()) + let record = Record(id: id, topic: topic, origin: origin, request: request, response: nil, timestamp: time.currentDate) storage.set(record, forKey: "\(record.id)") } diff --git a/Sources/WalletConnectUtils/TimeProvider.swift b/Sources/WalletConnectUtils/TimeProvider.swift new file mode 100644 index 000000000..86732b6f0 --- /dev/null +++ b/Sources/WalletConnectUtils/TimeProvider.swift @@ -0,0 +1,12 @@ +import Foundation + +public protocol TimeProvider { + var currentDate: Date { get } +} + +public struct DefaultTimeProvider: TimeProvider { + public init() {} + public var currentDate: Date { + return Date() + } +} diff --git a/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift b/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift index 82becd7b8..b4023eaff 100644 --- a/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift @@ -105,4 +105,27 @@ final class RPCHistoryTests: XCTestCase { XCTAssertEqual(expectedError, error as? RPCHistory.HistoryError) } } + + func testRemoveOutdated() throws { + let request1 = RPCRequest.stub() + let request2 = RPCRequest.stub() + + let time1 = TestTimeProvider(currentDate: .distantPast) + let time2 = TestTimeProvider(currentDate: Date()) + + try sut.set(request1, forTopic: .randomTopic(), emmitedBy: .local, time: time1) + try sut.set(request2, forTopic: .randomTopic(), emmitedBy: .local, time: time2) + + XCTAssertEqual(sut.get(recordId: request1.id!)?.request, request1) + XCTAssertEqual(sut.get(recordId: request2.id!)?.request, request2) + + sut.removeOutdated() + + XCTAssertEqual(sut.get(recordId: request1.id!)?.request, nil) + XCTAssertEqual(sut.get(recordId: request2.id!)?.request, request2) + } + + struct TestTimeProvider: TimeProvider { + var currentDate: Date + } } From d08497513af4a702cb577f3c2f235a54754b5ce1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 19 Jan 2024 12:16:38 +0100 Subject: [PATCH 228/814] refactor sign tests --- .../Sign/SignClientTests.swift | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index fd4100025..5789ed95c 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -91,7 +91,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testSessionReject() async throws { @@ -120,7 +120,7 @@ final class SignClientTests: XCTestCase { XCTAssertEqual(store.rejectedProposal, proposal) sessionRejectExpectation.fulfill() // TODO: Assert reason code }.store(in: &publishers) - wait(for: [sessionRejectExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [sessionRejectExpectation], timeout: InputConfig.defaultTimeout) } func testSessionDelete() async throws { @@ -145,7 +145,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [sessionDeleteExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [sessionDeleteExpectation], timeout: InputConfig.defaultTimeout) } func testSessionPing() async throws { @@ -176,7 +176,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSessionRequest() async throws { @@ -226,7 +226,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } func testSessionRequestFailureResponse() async throws { @@ -269,7 +269,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testNewSessionOnExistingPairing() async throws { @@ -307,7 +307,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testSuccessfulSessionUpdateNamespaces() async throws { @@ -331,7 +331,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSuccessfulSessionExtend() async throws { @@ -360,7 +360,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSessionEventSucceeds() async throws { @@ -391,7 +391,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSessionEventFails() async throws { @@ -419,7 +419,7 @@ final class SignClientTests: XCTestCase { try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyAllRequiredAllOptionalNamespacesSuccessful() async throws { @@ -497,7 +497,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyAllRequiredNamespacesSuccessful() async throws { @@ -566,7 +566,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyEmptyRequiredNamespacesExtraOptionalNamespacesSuccessful() async throws { @@ -625,7 +625,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyPartiallyRequiredNamespacesFails() async throws { @@ -688,7 +688,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [settlementFailedExpectation], timeout: 1) + await fulfillment(of: [settlementFailedExpectation], timeout: InputConfig.defaultTimeout) } func testCaip25SatisfyPartiallyRequiredNamespacesMethodsFails() async throws { @@ -754,6 +754,6 @@ final class SignClientTests: XCTestCase { let uri = try! await dappPairingClient.create() try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - wait(for: [settlementFailedExpectation], timeout: 1) + await fulfillment(of: [settlementFailedExpectation], timeout: 1) } } From 07ada933fbbb6589a5181d802c453e2c66f347a3 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 9 Jan 2024 16:40:20 +0300 Subject: [PATCH 229/814] History package cleanup --- Example/IntegrationTests/Chat/ChatTests.swift | 10 +-- .../History/HistoryTests.swift | 73 ------------------- Package.swift | 4 +- Sources/Chat/Chat.swift | 3 +- Sources/Chat/ChatClientFactory.swift | 11 +-- .../History/HistoryService.swift | 27 +------ Sources/WalletConnectHistory/HistoryAPI.swift | 56 -------------- .../WalletConnectHistory/HistoryClient.swift | 42 +---------- .../HistoryClientFactory.swift | 24 +----- .../WalletConnectHistory/HistoryImports.swift | 3 +- .../HistoryNetworkService.swift | 41 ----------- .../WalletConnectHistory/HistoryRecord.swift | 11 --- .../Types/GetMessagesPayload.swift | 19 ----- .../Types/GetMessagesResponse.swift | 28 ------- .../Types/RegisterPayload.swift | 11 --- 15 files changed, 14 insertions(+), 349 deletions(-) delete mode 100644 Sources/WalletConnectHistory/HistoryAPI.swift delete mode 100644 Sources/WalletConnectHistory/HistoryNetworkService.swift delete mode 100644 Sources/WalletConnectHistory/HistoryRecord.swift delete mode 100644 Sources/WalletConnectHistory/Types/GetMessagesPayload.swift delete mode 100644 Sources/WalletConnectHistory/Types/GetMessagesResponse.swift delete mode 100644 Sources/WalletConnectHistory/Types/RegisterPayload.swift diff --git a/Example/IntegrationTests/Chat/ChatTests.swift b/Example/IntegrationTests/Chat/ChatTests.swift index 04cdc7e68..0b4528fe4 100644 --- a/Example/IntegrationTests/Chat/ChatTests.swift +++ b/Example/IntegrationTests/Chat/ChatTests.swift @@ -71,18 +71,10 @@ final class ChatTests: XCTestCase { keychain: keychain ) - let historyClient = HistoryClientFactory.create( - historyUrl: "https://history.walletconnect.com", - relayUrl: "wss://relay.walletconnect.com", - keyValueStorage: keyValueStorage, - keychain: keychain, - logger: logger - ) - let clientId = try! networkingInteractor.getClientId() logger.debug("My client id is: \(clientId)") - return ChatClientFactory.create(keyserverURL: keyserverURL, relayClient: relayClient, networkingInteractor: networkingInteractor, keychain: keychain, logger: logger, storage: keyValueStorage, syncClient: syncClient, historyClient: historyClient) + return ChatClientFactory.create(keyserverURL: keyserverURL, relayClient: relayClient, networkingInteractor: networkingInteractor, keychain: keychain, logger: logger, storage: keyValueStorage, syncClient: syncClient) } func testInvite() async throws { diff --git a/Example/IntegrationTests/History/HistoryTests.swift b/Example/IntegrationTests/History/HistoryTests.swift index d96e0f811..4ebbdd80d 100644 --- a/Example/IntegrationTests/History/HistoryTests.swift +++ b/Example/IntegrationTests/History/HistoryTests.swift @@ -5,77 +5,4 @@ import XCTest final class HistoryTests: XCTestCase { - var publishers = Set() - - let relayUrl = "wss://relay.walletconnect.com" - let historyUrl = "https://history.walletconnect.com" - - var relayClient1: RelayClient! - var relayClient2: RelayClient! - - var historyClient: HistoryNetworkService! - - override func setUp() { - let keychain1 = KeychainStorageMock() - let keychain2 = KeychainStorageMock() - let logger1 = ConsoleLoggerMock() - let defaults1 = RuntimeKeyValueStorage() - relayClient1 = makeRelayClient(prefix: "🐄", keychain: keychain1) - relayClient2 = makeRelayClient(prefix: "🐫", keychain: keychain2) - historyClient = makeHistoryClient(defaults: defaults1, keychain: keychain1, logger: logger1) - } - - private func makeRelayClient(prefix: String, keychain: KeychainStorageProtocol) -> RelayClient { - return RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: RuntimeKeyValueStorage(), - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - logger: ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug)) - } - - private func makeHistoryClient(defaults: KeyValueStorage, keychain: KeychainStorageProtocol, logger: ConsoleLogging) -> HistoryNetworkService { - let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychain, logger: logger) - return HistoryNetworkService(clientIdStorage: clientIdStorage) - } - - func testRegister() async throws { - let payload = RegisterPayload(tags: ["7000"], relayUrl: relayUrl) - - try await historyClient.registerTags(payload: payload, historyUrl: historyUrl) - } - - func testGetMessages() async throws { - let exp = expectation(description: "Test Get Messages") - let tag = 7000 - let payload = "{}" - let agreement = AgreementPrivateKey() - let topic = agreement.publicKey.rawRepresentation.sha256().hex - - relayClient2.messagePublisher.sink { (topic, message, publishedAt) in - exp.fulfill() - }.store(in: &publishers) - - try await historyClient.registerTags( - payload: RegisterPayload(tags: [String(tag)], relayUrl: relayUrl), - historyUrl: historyUrl) - - try await relayClient2.subscribe(topic: topic) - try await relayClient1.publish(topic: topic, payload: payload, tag: tag, prompt: false, ttl: 3000) - - wait(for: [exp], timeout: InputConfig.defaultTimeout) - - sleep(5) // History server has a queue - - let messages = try await historyClient.getMessages( - payload: GetMessagesPayload( - topic: topic, - originId: nil, - messageCount: 200, - direction: .forward), - historyUrl: historyUrl) - - XCTAssertEqual(messages.messages, [payload]) - } } diff --git a/Package.swift b/Package.swift index dcfa42b87..c53f5ee38 100644 --- a/Package.swift +++ b/Package.swift @@ -62,7 +62,7 @@ let package = Package( path: "Sources/WalletConnectSign"), .target( name: "WalletConnectChat", - dependencies: ["WalletConnectIdentity", "WalletConnectSync", "WalletConnectHistory"], + dependencies: ["WalletConnectIdentity", "WalletConnectSync"], path: "Sources/Chat"), .target( name: "Auth", @@ -94,7 +94,7 @@ let package = Package( dependencies: ["WalletConnectNetworking"]), .target( name: "WalletConnectHistory", - dependencies: ["HTTPClient", "WalletConnectRelay"]), + dependencies: []), .target( name: "WalletConnectSigner", dependencies: ["WalletConnectNetworking"]), diff --git a/Sources/Chat/Chat.swift b/Sources/Chat/Chat.swift index 2bb3ac56b..003b64335 100644 --- a/Sources/Chat/Chat.swift +++ b/Sources/Chat/Chat.swift @@ -12,8 +12,7 @@ public class Chat { keyserverUrl: keyserverUrl, relayClient: Relay.instance, networkingInteractor: Networking.interactor, - syncClient: Sync.instance, - historyClient: History.instance + syncClient: Sync.instance ) }() diff --git a/Sources/Chat/ChatClientFactory.swift b/Sources/Chat/ChatClientFactory.swift index ebce9f3c3..52bd97024 100644 --- a/Sources/Chat/ChatClientFactory.swift +++ b/Sources/Chat/ChatClientFactory.swift @@ -2,7 +2,7 @@ import Foundation public struct ChatClientFactory { - static func create(keyserverUrl: String, relayClient: RelayClient, networkingInteractor: NetworkingInteractor, syncClient: SyncClient, historyClient: HistoryClient) -> ChatClient { + static func create(keyserverUrl: String, relayClient: RelayClient, networkingInteractor: NetworkingInteractor, syncClient: SyncClient) -> ChatClient { fatalError("fix access group") let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") let keyserverURL = URL(string: keyserverUrl)! @@ -13,8 +13,7 @@ public struct ChatClientFactory { keychain: keychain, logger: ConsoleLogger(loggingLevel: .debug), storage: UserDefaults.standard, - syncClient: syncClient, - historyClient: historyClient + syncClient: syncClient ) } @@ -25,12 +24,10 @@ public struct ChatClientFactory { keychain: KeychainStorageProtocol, logger: ConsoleLogging, storage: KeyValueStorage, - syncClient: SyncClient, - historyClient: HistoryClient + syncClient: SyncClient ) -> ChatClient { let kms = KeyManagementService(keychain: keychain) - let serializer = Serializer(kms: kms, logger: logger) - let historyService = HistoryService(historyClient: historyClient, seiralizer: serializer) + let historyService = HistoryService() let messageStore = KeyedDatabase(storage: storage, identifier: ChatStorageIdentifiers.messages.rawValue) let receivedInviteStore = KeyedDatabase(storage: storage, identifier: ChatStorageIdentifiers.receivedInvites.rawValue) let threadStore: SyncStore = SyncStoreFactory.create(name: ChatStorageIdentifiers.thread.rawValue, syncClient: syncClient, storage: storage) diff --git a/Sources/Chat/ProtocolServices/History/HistoryService.swift b/Sources/Chat/ProtocolServices/History/HistoryService.swift index ebad3a50d..13f014333 100644 --- a/Sources/Chat/ProtocolServices/History/HistoryService.swift +++ b/Sources/Chat/ProtocolServices/History/HistoryService.swift @@ -2,36 +2,15 @@ import Foundation final class HistoryService { - private let historyClient: HistoryClient - private let seiralizer: Serializing + init() { - init(historyClient: HistoryClient, seiralizer: Serializing) { - self.historyClient = historyClient - self.seiralizer = seiralizer } func register() async throws { - try await historyClient.register(tags: ["2002"]) + fatalError() } func fetchMessageHistory(thread: Thread) async throws -> [Message] { - let wrappers: [MessagePayload.Wrapper] = try await historyClient.getMessages( - topic: thread.topic, - count: 200, direction: .backward - ) - - return wrappers.map { wrapper in - let (messagePayload, messageClaims) = try! MessagePayload.decodeAndVerify(from: wrapper) - - let authorAccount = messagePayload.recipientAccount == thread.selfAccount - ? thread.peerAccount - : thread.selfAccount - - return Message( - topic: thread.topic, - message: messagePayload.message, - authorAccount: authorAccount, - timestamp: messageClaims.iat) - } + fatalError() } } diff --git a/Sources/WalletConnectHistory/HistoryAPI.swift b/Sources/WalletConnectHistory/HistoryAPI.swift deleted file mode 100644 index 58f6b0cbd..000000000 --- a/Sources/WalletConnectHistory/HistoryAPI.swift +++ /dev/null @@ -1,56 +0,0 @@ -import Foundation - -enum HistoryAPI: HTTPService { - case register(payload: RegisterPayload, jwt: String) - case messages(payload: GetMessagesPayload) - - var path: String { - switch self { - case .register: - return "/register" - case .messages: - return "/messages" - } - } - - var method: HTTPMethod { - switch self { - case .register: - return .post - case .messages: - return .get - } - } - - var body: Data? { - switch self { - case .register(let payload, _): - return try? JSONEncoder().encode(payload) - case .messages: - return nil - } - } - - var additionalHeaderFields: [String : String]? { - switch self { - case .register(_, let jwt): - return ["Authorization": "Bearer \(jwt)"] - case .messages: - return nil - } - } - - var queryParameters: [String: String]? { - switch self { - case .messages(let payload): - return [ - "topic": payload.topic, - "originId": payload.originId.map { String($0) }, - "messageCount": payload.messageCount.map { String($0) }, - "direction": payload.direction.rawValue - ].compactMapValues { $0 } - case .register: - return nil - } - } -} diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectHistory/HistoryClient.swift index 3022a05aa..65f50acab 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectHistory/HistoryClient.swift @@ -2,47 +2,7 @@ import Foundation public final class HistoryClient { - private let historyUrl: String - private let relayUrl: String - private let serializer: Serializer - private let historyNetworkService: HistoryNetworkService + init() { - init(historyUrl: String, relayUrl: String, serializer: Serializer, historyNetworkService: HistoryNetworkService) { - self.historyUrl = historyUrl - self.relayUrl = relayUrl - self.serializer = serializer - self.historyNetworkService = historyNetworkService - } - - public func register(tags: [String]) async throws { - let payload = RegisterPayload(tags: tags, relayUrl: relayUrl) - try await historyNetworkService.registerTags(payload: payload, historyUrl: historyUrl) - } - - public func getMessages(topic: String, count: Int, direction: GetMessagesPayload.Direction) async throws -> [T] { - return try await getRecords(topic: topic, count: count, direction: direction).map { $0.object } - } - - public func getRecords(topic: String, count: Int, direction: GetMessagesPayload.Direction) async throws -> [HistoryRecord] { - let payload = GetMessagesPayload(topic: topic, originId: nil, messageCount: count, direction: direction) - let response = try await historyNetworkService.getMessages(payload: payload, historyUrl: historyUrl) - - return response.messages.compactMap { payload in - do { - let (request, _, _): (RPCRequest, _, _) = try serializer.deserialize( - topic: topic, - encodedEnvelope: payload - ) - - guard - let id = request.id, - let object = try request.params?.get(T.self) - else { return nil } - - return HistoryRecord(id: id, object: object) - } catch { - fatalError(error.localizedDescription) - } - } } } diff --git a/Sources/WalletConnectHistory/HistoryClientFactory.swift b/Sources/WalletConnectHistory/HistoryClientFactory.swift index 26d0d2044..06784b9db 100644 --- a/Sources/WalletConnectHistory/HistoryClientFactory.swift +++ b/Sources/WalletConnectHistory/HistoryClientFactory.swift @@ -3,28 +3,6 @@ import Foundation class HistoryClientFactory { static func create() -> HistoryClient { - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") - let keyValueStorage = UserDefaults.standard - let logger = ConsoleLogger() - return HistoryClientFactory.create( - historyUrl: "https://history.walletconnect.com", - relayUrl: "wss://relay.walletconnect.com", - keyValueStorage: keyValueStorage, - keychain: keychain, - logger: logger - ) - } - - static func create(historyUrl: String, relayUrl: String, keyValueStorage: KeyValueStorage, keychain: KeychainStorageProtocol, logger: ConsoleLogging) -> HistoryClient { - let clientIdStorage = ClientIdStorage(defaults: keyValueStorage, keychain: keychain, logger: logger) - let kms = KeyManagementService(keychain: keychain) - let serializer = Serializer(kms: kms, logger: ConsoleLogger(prefix: "🔐", loggingLevel: .off)) - let historyNetworkService = HistoryNetworkService(clientIdStorage: clientIdStorage) - return HistoryClient( - historyUrl: historyUrl, - relayUrl: relayUrl, - serializer: serializer, - historyNetworkService: historyNetworkService - ) + return HistoryClient() } } diff --git a/Sources/WalletConnectHistory/HistoryImports.swift b/Sources/WalletConnectHistory/HistoryImports.swift index e6d4b859c..2db10894a 100644 --- a/Sources/WalletConnectHistory/HistoryImports.swift +++ b/Sources/WalletConnectHistory/HistoryImports.swift @@ -1,4 +1,3 @@ #if !CocoaPods -@_exported import HTTPClient -@_exported import WalletConnectRelay + #endif diff --git a/Sources/WalletConnectHistory/HistoryNetworkService.swift b/Sources/WalletConnectHistory/HistoryNetworkService.swift deleted file mode 100644 index 906959577..000000000 --- a/Sources/WalletConnectHistory/HistoryNetworkService.swift +++ /dev/null @@ -1,41 +0,0 @@ -import Foundation - -final class HistoryNetworkService { - - private let clientIdStorage: ClientIdStorage - - init(clientIdStorage: ClientIdStorage) { - self.clientIdStorage = clientIdStorage - } - - func registerTags(payload: RegisterPayload, historyUrl: String) async throws { - let service = HTTPNetworkClient(host: try host(from: historyUrl)) - let api = HistoryAPI.register(payload: payload, jwt: try getJwt(historyUrl: historyUrl)) - try await service.request(service: api) - } - - func getMessages(payload: GetMessagesPayload, historyUrl: String) async throws -> GetMessagesResponse { - let service = HTTPNetworkClient(host: try host(from: historyUrl)) - let api = HistoryAPI.messages(payload: payload) - return try await service.request(GetMessagesResponse.self, at: api) - } -} - -private extension HistoryNetworkService { - - enum Errors: Error { - case couldNotResolveHost - } - - func getJwt(historyUrl: String) throws -> String { - let authenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) - return try authenticator.createAuthToken(url: historyUrl) - } - - func host(from url: String) throws -> String { - guard let host = URL(string: url)?.host else { - throw Errors.couldNotResolveHost - } - return host - } -} diff --git a/Sources/WalletConnectHistory/HistoryRecord.swift b/Sources/WalletConnectHistory/HistoryRecord.swift deleted file mode 100644 index cd2793081..000000000 --- a/Sources/WalletConnectHistory/HistoryRecord.swift +++ /dev/null @@ -1,11 +0,0 @@ -import Foundation - -public struct HistoryRecord { - public let id: RPCID - public let object: Object - - public init(id: RPCID, object: Object) { - self.id = id - self.object = object - } -} diff --git a/Sources/WalletConnectHistory/Types/GetMessagesPayload.swift b/Sources/WalletConnectHistory/Types/GetMessagesPayload.swift deleted file mode 100644 index 7dcc9a08d..000000000 --- a/Sources/WalletConnectHistory/Types/GetMessagesPayload.swift +++ /dev/null @@ -1,19 +0,0 @@ -import Foundation - -public struct GetMessagesPayload: Codable { - public enum Direction: String, Codable { - case forward - case backward - } - public let topic: String - public let originId: Int64? - public let messageCount: Int? - public let direction: Direction - - public init(topic: String, originId: Int64?, messageCount: Int?, direction: GetMessagesPayload.Direction) { - self.topic = topic - self.originId = originId - self.messageCount = messageCount - self.direction = direction - } -} diff --git a/Sources/WalletConnectHistory/Types/GetMessagesResponse.swift b/Sources/WalletConnectHistory/Types/GetMessagesResponse.swift deleted file mode 100644 index 032bad07e..000000000 --- a/Sources/WalletConnectHistory/Types/GetMessagesResponse.swift +++ /dev/null @@ -1,28 +0,0 @@ -import Foundation - -public struct GetMessagesResponse: Decodable { - public struct Message: Codable { - public let message: String - } - public let topic: String - public let direction: GetMessagesPayload.Direction - public let nextId: Int64? - public let messages: [String] - - enum CodingKeys: String, CodingKey { - case topic - case direction - case nextId - case messages - } - - public init(from decoder: Decoder) throws { - let container = try decoder.container(keyedBy: CodingKeys.self) - self.topic = try container.decode(String.self, forKey: .topic) - self.direction = try container.decode(GetMessagesPayload.Direction.self, forKey: .direction) - self.nextId = try container.decodeIfPresent(Int64.self, forKey: .nextId) - - let messages = try container.decode([Message].self, forKey: .messages) - self.messages = messages.map { $0.message } - } -} diff --git a/Sources/WalletConnectHistory/Types/RegisterPayload.swift b/Sources/WalletConnectHistory/Types/RegisterPayload.swift deleted file mode 100644 index b759c5ce5..000000000 --- a/Sources/WalletConnectHistory/Types/RegisterPayload.swift +++ /dev/null @@ -1,11 +0,0 @@ -import Foundation - -public struct RegisterPayload: Codable { - public let tags: [String] - public let relayUrl: String - - public init(tags: [String], relayUrl: String) { - self.tags = tags - self.relayUrl = relayUrl - } -} From b29a0eab3f32d979139208e8407cd859522fe3be Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 15:03:44 +0300 Subject: [PATCH 230/814] awaitResponse --- .../NetworkInteracting.swift | 10 ++++++ .../NetworkingInteractor.swift | 31 ++++++++++++++++++- 2 files changed, 40 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectNetworking/NetworkInteracting.swift b/Sources/WalletConnectNetworking/NetworkInteracting.swift index 6bad90646..75b7283b6 100644 --- a/Sources/WalletConnectNetworking/NetworkInteracting.swift +++ b/Sources/WalletConnectNetworking/NetworkInteracting.swift @@ -42,6 +42,16 @@ public protocol NetworkInteracting { subscription: @escaping (ResponseSubscriptionPayload) async throws -> Void ) + func awaitResponse( + request: RPCRequest, + topic: String, + requestOfType: Request, + requestMethod: ProtocolMethod, + responseOfType: Response, + responseMethod: ProtocolMethod, + envelopeType: Envelope.EnvelopeType + ) async throws -> Response + func getClientId() throws -> String } diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index b428a77f5..a4d36c0b5 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -29,7 +29,7 @@ public class NetworkingInteractor: NetworkInteracting { public var networkConnectionStatusPublisher: AnyPublisher public var socketConnectionStatusPublisher: AnyPublisher - + private let networkMonitor: NetworkMonitoring public init( @@ -139,6 +139,35 @@ public class NetworkingInteractor: NetworkInteracting { .eraseToAnyPublisher() } + public func awaitResponse( + request: RPCRequest, + topic: String, + requestOfType: Request, + requestMethod: ProtocolMethod, + responseOfType: Response, + responseMethod: ProtocolMethod, + envelopeType: Envelope.EnvelopeType + ) async throws -> Response { + + try await self.request(request, topic: topic, protocolMethod: requestMethod, envelopeType: envelopeType) + + return try await withCheckedThrowingContinuation { [unowned self] continuation in + var response, error: AnyCancellable? + + response = responseSubscription(on: responseMethod) + .sink { (payload: ResponseSubscriptionPayload) in + response?.cancel() + continuation.resume(with: .success(payload.response)) + } + + error = responseErrorSubscription(on: responseMethod) + .sink { (payload: ResponseSubscriptionErrorPayload) in + error?.cancel() + continuation.resume(throwing: payload.error) + } + } + } + public func responseSubscription(on request: ProtocolMethod) -> AnyPublisher, Never> { return responsePublisher .filter { rpcRequest in From c067781cda5aed5b04af3c5c5009bbe0dde465fd Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 15:08:53 +0300 Subject: [PATCH 231/814] requestMethod == responseMethod --- Sources/WalletConnectHistory/HistoryClient.swift | 2 +- .../WalletConnectNetworking/NetworkingInteractor.swift | 9 ++++----- 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectHistory/HistoryClient.swift index 65f50acab..6ddc09ee1 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectHistory/HistoryClient.swift @@ -3,6 +3,6 @@ import Foundation public final class HistoryClient { init() { - + } } diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index a4d36c0b5..f4af51a6c 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -142,25 +142,24 @@ public class NetworkingInteractor: NetworkInteracting { public func awaitResponse( request: RPCRequest, topic: String, + method: ProtocolMethod, requestOfType: Request, - requestMethod: ProtocolMethod, responseOfType: Response, - responseMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType ) async throws -> Response { - try await self.request(request, topic: topic, protocolMethod: requestMethod, envelopeType: envelopeType) + try await self.request(request, topic: topic, protocolMethod: method, envelopeType: envelopeType) return try await withCheckedThrowingContinuation { [unowned self] continuation in var response, error: AnyCancellable? - response = responseSubscription(on: responseMethod) + response = responseSubscription(on: method) .sink { (payload: ResponseSubscriptionPayload) in response?.cancel() continuation.resume(with: .success(payload.response)) } - error = responseErrorSubscription(on: responseMethod) + error = responseErrorSubscription(on: method) .sink { (payload: ResponseSubscriptionErrorPayload) in error?.cancel() continuation.resume(throwing: payload.error) From 57fdaf2cfe61820d26f63dcf3c3d6518b8699b4e Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 15:25:21 +0300 Subject: [PATCH 232/814] Imports + NotifyGetNotificationsRequestPayload mask --- Package.swift | 2 +- .../WalletConnectHistory/HistoryImports.swift | 2 +- ...NotifyGetNotificationsRequestPayload.swift | 38 +++++++++++++++++++ .../NetworkInteracting.swift | 3 +- .../NetworkingInteractor.swift | 2 + 5 files changed, 43 insertions(+), 4 deletions(-) create mode 100644 Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift diff --git a/Package.swift b/Package.swift index c53f5ee38..01bd9ebcc 100644 --- a/Package.swift +++ b/Package.swift @@ -94,7 +94,7 @@ let package = Package( dependencies: ["WalletConnectNetworking"]), .target( name: "WalletConnectHistory", - dependencies: []), + dependencies: ["WalletConnectIdentity"]), .target( name: "WalletConnectSigner", dependencies: ["WalletConnectNetworking"]), diff --git a/Sources/WalletConnectHistory/HistoryImports.swift b/Sources/WalletConnectHistory/HistoryImports.swift index 2db10894a..51e07cac3 100644 --- a/Sources/WalletConnectHistory/HistoryImports.swift +++ b/Sources/WalletConnectHistory/HistoryImports.swift @@ -1,3 +1,3 @@ #if !CocoaPods - +@_exported import WalletConnectIdentity #endif diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift new file mode 100644 index 000000000..2e339da97 --- /dev/null +++ b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift @@ -0,0 +1,38 @@ +import Foundation + +struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { + + struct Claims: JWTClaims { + var iss: String + + var iat: UInt64 + + var exp: UInt64 + + var act: String? + + static var action: String? { + return "notify_get_notifications" + } + } + + struct Wrapper: JWTWrapper { + let auth: String + + init(jwtString: String) { + self.auth = jwtString + } + + var jwtString: String { + return auth + } + } + + init(claims: Claims) throws { + fatalError() + } + + func encode(iss: String) throws -> Claims { + fatalError() + } +} diff --git a/Sources/WalletConnectNetworking/NetworkInteracting.swift b/Sources/WalletConnectNetworking/NetworkInteracting.swift index 75b7283b6..068ccb31b 100644 --- a/Sources/WalletConnectNetworking/NetworkInteracting.swift +++ b/Sources/WalletConnectNetworking/NetworkInteracting.swift @@ -45,10 +45,9 @@ public protocol NetworkInteracting { func awaitResponse( request: RPCRequest, topic: String, + method: ProtocolMethod, requestOfType: Request, - requestMethod: ProtocolMethod, responseOfType: Response, - responseMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType ) async throws -> Response diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index f4af51a6c..a3c360beb 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -156,11 +156,13 @@ public class NetworkingInteractor: NetworkInteracting { response = responseSubscription(on: method) .sink { (payload: ResponseSubscriptionPayload) in response?.cancel() + error?.cancel() continuation.resume(with: .success(payload.response)) } error = responseErrorSubscription(on: method) .sink { (payload: ResponseSubscriptionErrorPayload) in + response?.cancel() error?.cancel() continuation.resume(throwing: payload.error) } From 859a85ad591a71f0e5edac8793d1c3cc14614c24 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 16:23:34 +0300 Subject: [PATCH 233/814] NotifyGetNotificationsRequestPayload --- ...NotifyGetNotificationsRequestPayload.swift | 35 ++++++++++++++----- 1 file changed, 27 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift index 2e339da97..a6444de52 100644 --- a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift +++ b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift @@ -3,13 +3,15 @@ import Foundation struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { struct Claims: JWTClaims { - var iss: String - - var iat: UInt64 - - var exp: UInt64 - - var act: String? + let iat: UInt64 + let exp: UInt64 + let act: String? // - `notify_get_notifications` + let iss: String // - did:key of client identity key + let ksu: String // - key server for identity key verification + let aud: String // - did:key of dapp authentication key + let app: String // - did:web of app domain that this request is associated with - Example: `did:web:app.example.com` + let lmt: UInt64 // - the max number of notifications to return. Maximum value is 50. + let aft: String? // - the notification ID to start returning messages after. Null to start with the most recent notification static var action: String? { return "notify_get_notifications" @@ -28,11 +30,28 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { } } + let identityKey: DIDKey + let keyserver: String + let dappAuthKey: DIDKey + let app: DIDWeb + let limit: UInt64 + let after: String? + init(claims: Claims) throws { fatalError() } func encode(iss: String) throws -> Claims { - fatalError() + return Claims( + iat: defaultIat(), + exp: expiry(days: 1), + act: Claims.action, + iss: identityKey.did(variant: .ED25519), + ksu: keyserver, + aud: dappAuthKey.did(variant: .ED25519), + app: app.did, + lmt: limit, + aft: after + ) } } From eb632db6f4d88c38cbb03cb8c3aac04d38ad20ad Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 16:52:35 +0300 Subject: [PATCH 234/814] NotifyGetNotificationsResponsePayload --- Package.swift | 2 +- .../WalletConnectHistory/HistoryClient.swift | 1 + ...otifyGetNotificationsResponsePayload.swift | 39 +++++++++++++++++++ .../Types}/NotifyMessage.swift | 0 .../WalletConnectNotify/NotifyImports.swift | 2 +- 5 files changed, 42 insertions(+), 2 deletions(-) create mode 100644 Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsResponsePayload.swift rename Sources/{WalletConnectNotify/Types/DataStructures => WalletConnectHistory/Types}/NotifyMessage.swift (100%) diff --git a/Package.swift b/Package.swift index 01bd9ebcc..617226143 100644 --- a/Package.swift +++ b/Package.swift @@ -74,7 +74,7 @@ let package = Package( path: "Sources/Web3Wallet"), .target( name: "WalletConnectNotify", - dependencies: ["WalletConnectPairing", "WalletConnectPush", "WalletConnectIdentity", "WalletConnectSigner", "Database"], + dependencies: ["WalletConnectPairing", "WalletConnectPush", "WalletConnectHistory", "WalletConnectSigner", "Database"], path: "Sources/WalletConnectNotify"), .target( name: "WalletConnectPush", diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectHistory/HistoryClient.swift index 6ddc09ee1..3456f7fc0 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectHistory/HistoryClient.swift @@ -5,4 +5,5 @@ public final class HistoryClient { init() { } + } diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsResponsePayload.swift b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsResponsePayload.swift new file mode 100644 index 000000000..cf8cb2243 --- /dev/null +++ b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsResponsePayload.swift @@ -0,0 +1,39 @@ +import Foundation + +struct NotifyGetNotificationsResponsePayload: JWTClaimsCodable { + + struct Claims: JWTClaims { + let iat: UInt64 + let exp: UInt64 + let act: String? // - `notify_get_notifications_response` + let iss: String // - did:key of client identity key + let aud: String // - did:key of Notify Server authentication key + let nfs: [NotifyMessage] // array of [Notify Notifications](./data-structures.md#notify-notification) + + static var action: String? { + return "notify_get_notifications_response" + } + } + + struct Wrapper: JWTWrapper { + let auth: String + + init(jwtString: String) { + self.auth = jwtString + } + + var jwtString: String { + return auth + } + } + + let messages: [NotifyMessage] + + init(claims: Claims) throws { + self.messages = claims.nfs + } + + func encode(iss: String) throws -> Claims { + fatalError() + } +} diff --git a/Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift b/Sources/WalletConnectHistory/Types/NotifyMessage.swift similarity index 100% rename from Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift rename to Sources/WalletConnectHistory/Types/NotifyMessage.swift diff --git a/Sources/WalletConnectNotify/NotifyImports.swift b/Sources/WalletConnectNotify/NotifyImports.swift index 43b543236..e2f267c31 100644 --- a/Sources/WalletConnectNotify/NotifyImports.swift +++ b/Sources/WalletConnectNotify/NotifyImports.swift @@ -1,7 +1,7 @@ #if !CocoaPods @_exported import WalletConnectPairing @_exported import WalletConnectPush -@_exported import WalletConnectIdentity +@_exported import WalletConnectHistory @_exported import WalletConnectSigner @_exported import Database #endif From e4b37995ee74d5c7ef53c424fbc0d8fea3e01655 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 17:24:50 +0300 Subject: [PATCH 235/814] HistoryClient package --- Sources/WalletConnectHistory/History.swift | 12 ------ .../WalletConnectHistory/HistoryClient.swift | 42 ++++++++++++++++++- .../HistoryClientFactory.swift | 6 +-- ...NotifyGetNotificationsRequestPayload.swift | 9 ++++ ...NotifyGetNotificationsProtocolMethod.swift | 9 ++++ .../NetworkInteracting.swift | 4 +- .../NetworkingInteractor.swift | 4 +- 7 files changed, 65 insertions(+), 21 deletions(-) delete mode 100644 Sources/WalletConnectHistory/History.swift create mode 100644 Sources/WalletConnectHistory/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift diff --git a/Sources/WalletConnectHistory/History.swift b/Sources/WalletConnectHistory/History.swift deleted file mode 100644 index d0954f756..000000000 --- a/Sources/WalletConnectHistory/History.swift +++ /dev/null @@ -1,12 +0,0 @@ -import Foundation - -/// History instatnce wrapper -public class History { - - /// Sync client instance - public static var instance: HistoryClient = { - return HistoryClientFactory.create() - }() - - private init() { } -} diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectHistory/HistoryClient.swift index 3456f7fc0..4aef22b0c 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectHistory/HistoryClient.swift @@ -2,8 +2,46 @@ import Foundation public final class HistoryClient { - init() { - + private let keyserver: URL + private let networkingClient: NetworkInteracting + private let identityClient: IdentityClient + + init(keyserver: URL, networkingClient: NetworkInteracting, identityClient: IdentityClient) { + self.keyserver = keyserver + self.networkingClient = networkingClient + self.identityClient = identityClient } + public func fetchHistory(account: Account, topic: String, appAuthenticationKey: String, host: String) async throws -> [NotifyMessage] { + let identityKey = try identityClient.getInviteKey(for: account) + let dappAuthKey = try DIDKey(did: appAuthenticationKey) + let app = DIDWeb(host: host) + + let requestPayload = NotifyGetNotificationsRequestPayload( + identityKey: DIDKey(rawData: identityKey.rawRepresentation), + keyserver: keyserver.absoluteString, + dappAuthKey: dappAuthKey, + app: app, + limit: 50, + after: nil + ) + + let wrapper = try identityClient.signAndCreateWrapper(payload: requestPayload, account: account) + + let protocolMethod = NotifyGetNotificationsProtocolMethod() + let request = RPCRequest(method: protocolMethod.method, params: wrapper) + + let response = try await networkingClient.awaitResponse( + request: request, + topic: topic, + method: protocolMethod, + requestOfType: NotifyGetNotificationsRequestPayload.Wrapper.self, + responseOfType: NotifyGetNotificationsResponsePayload.Wrapper.self, + envelopeType: .type0 + ) + + let (responsePayload, _) = try NotifyGetNotificationsResponsePayload.decodeAndVerify(from: response) + + return responsePayload.messages + } } diff --git a/Sources/WalletConnectHistory/HistoryClientFactory.swift b/Sources/WalletConnectHistory/HistoryClientFactory.swift index 06784b9db..9db17a320 100644 --- a/Sources/WalletConnectHistory/HistoryClientFactory.swift +++ b/Sources/WalletConnectHistory/HistoryClientFactory.swift @@ -1,8 +1,8 @@ import Foundation -class HistoryClientFactory { +public class HistoryClientFactory { - static func create() -> HistoryClient { - return HistoryClient() + public static func create(keyserver: URL, networkingInteractor: NetworkInteracting, identityClient: IdentityClient) -> HistoryClient { + return HistoryClient(keyserver: keyserver, networkingClient: networkingInteractor, identityClient: identityClient) } } diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift index a6444de52..a479f3af0 100644 --- a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift +++ b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift @@ -37,6 +37,15 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { let limit: UInt64 let after: String? + init(identityKey: DIDKey, keyserver: String, dappAuthKey: DIDKey, app: DIDWeb, limit: UInt64, after: String? = nil) { + self.identityKey = identityKey + self.keyserver = keyserver + self.dappAuthKey = dappAuthKey + self.app = app + self.limit = limit + self.after = after + } + init(claims: Claims) throws { fatalError() } diff --git a/Sources/WalletConnectHistory/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift b/Sources/WalletConnectHistory/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift new file mode 100644 index 000000000..b86c57a1a --- /dev/null +++ b/Sources/WalletConnectHistory/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift @@ -0,0 +1,9 @@ +import Foundation + +struct NotifyGetNotificationsProtocolMethod: ProtocolMethod { + let method: String = "wc_notifyGetNotifications" + + let requestConfig: RelayConfig = RelayConfig(tag: 4014, prompt: false, ttl: 300) + + let responseConfig: RelayConfig = RelayConfig(tag: 4015, prompt: false, ttl: 300) +} diff --git a/Sources/WalletConnectNetworking/NetworkInteracting.swift b/Sources/WalletConnectNetworking/NetworkInteracting.swift index 068ccb31b..a79814399 100644 --- a/Sources/WalletConnectNetworking/NetworkInteracting.swift +++ b/Sources/WalletConnectNetworking/NetworkInteracting.swift @@ -46,8 +46,8 @@ public protocol NetworkInteracting { request: RPCRequest, topic: String, method: ProtocolMethod, - requestOfType: Request, - responseOfType: Response, + requestOfType: Request.Type, + responseOfType: Response.Type, envelopeType: Envelope.EnvelopeType ) async throws -> Response diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index a3c360beb..f0bc0a2bb 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -143,8 +143,8 @@ public class NetworkingInteractor: NetworkInteracting { request: RPCRequest, topic: String, method: ProtocolMethod, - requestOfType: Request, - responseOfType: Response, + requestOfType: Request.Type, + responseOfType: Response.Type, envelopeType: Envelope.EnvelopeType ) async throws -> Response { From edbbabcd2f9ac3748e4be47f2d14b85bfb6bd3bc Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 17:40:29 +0300 Subject: [PATCH 236/814] fetchHistory method --- .../Client/Wallet/NotifyClient.swift | 14 ++++++++++++++ .../Client/Wallet/NotifyClientFactory.swift | 4 +++- .../Client/Wallet/NotifyStorage.swift | 4 ++++ 3 files changed, 21 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index ba30e6956..d64f13879 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -25,6 +25,7 @@ public class NotifyClient { private let keyserverURL: URL private let pushClient: PushClient private let identityClient: IdentityClient + private let historyClient: HistoryClient private let notifyStorage: NotifyStorage private let notifyAccountProvider: NotifyAccountProvider private let notifyMessageSubscriber: NotifyMessageSubscriber @@ -42,6 +43,7 @@ public class NotifyClient { keyserverURL: URL, kms: KeyManagementServiceProtocol, identityClient: IdentityClient, + historyClient: HistoryClient, pushClient: PushClient, notifyMessageSubscriber: NotifyMessageSubscriber, notifyStorage: NotifyStorage, @@ -62,6 +64,7 @@ public class NotifyClient { self.keyserverURL = keyserverURL self.pushClient = pushClient self.identityClient = identityClient + self.historyClient = historyClient self.notifyMessageSubscriber = notifyMessageSubscriber self.notifyStorage = notifyStorage self.deleteNotifySubscriptionRequester = deleteNotifySubscriptionRequester @@ -144,6 +147,17 @@ public class NotifyClient { public func messagesPublisher(topic: String) -> AnyPublisher<[NotifyMessageRecord], Never> { return notifyStorage.messagesPublisher(topic: topic) } + + public func fetchHistory(subscription: NotifySubscription) async throws { + let messages = try await historyClient.fetchHistory( + account: subscription.account, + topic: subscription.topic, + appAuthenticationKey: subscription.appAuthenticationKey, + host: subscription.metadata.url + ) + + // TBD + } } private extension NotifyClient { diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 3a08a5727..3bbcbe4af 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -68,12 +68,14 @@ public struct NotifyClientFactory { let notifyWatchSubscriptionsResponseSubscriber = NotifyWatchSubscriptionsResponseSubscriber(networkingInteractor: networkInteractor, kms: kms, logger: logger, notifyStorage: notifyStorage, groupKeychainStorage: groupKeychainStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let notifySubscriptionsChangedRequestSubscriber = NotifySubscriptionsChangedRequestSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, kms: kms, identityClient: identityClient, logger: logger, groupKeychainStorage: groupKeychainStorage, notifyStorage: notifyStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let subscriptionWatcher = SubscriptionWatcher(notifyWatchSubscriptionsRequester: notifyWatchSubscriptionsRequester, logger: logger) + let historyClient = HistoryClientFactory.create(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient) return NotifyClient( logger: logger, keyserverURL: keyserverURL, kms: kms, - identityClient: identityClient, + identityClient: identityClient, + historyClient: historyClient, pushClient: pushClient, notifyMessageSubscriber: notifyMessageSubscriber, notifyStorage: notifyStorage, diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift index cca2c3e6a..e26667ec6 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorage.swift @@ -122,6 +122,10 @@ final class NotifyStorage: NotifyStoring { func setMessage(_ message: NotifyMessageRecord) throws { try database.save(message: message) } + + func setMessages(_ messages: [NotifyMessageRecord]) throws { + try database.save(messages: messages) + } } private extension NotifyStorage { From bdd99e7142156586d788e3ba7add39f3d8676096 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 17:45:22 +0300 Subject: [PATCH 237/814] sent_at for NotifyMessage --- Sources/WalletConnectHistory/Types/NotifyMessage.swift | 8 +++++++- .../Client/Wallet/NotifyMessageRecord.swift | 7 +++++-- 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectHistory/Types/NotifyMessage.swift b/Sources/WalletConnectHistory/Types/NotifyMessage.swift index e61d46223..f7fc00a72 100644 --- a/Sources/WalletConnectHistory/Types/NotifyMessage.swift +++ b/Sources/WalletConnectHistory/Types/NotifyMessage.swift @@ -7,13 +7,19 @@ public struct NotifyMessage: Codable, Equatable { public let icon: String public let url: String public let type: String + public let sent_at: UInt64 - public init(id: String, title: String, body: String, icon: String, url: String, type: String) { + public var sentAt: Date { + return Date(timeIntervalSince1970: TimeInterval(sent_at)) + } + + public init(id: String, title: String, body: String, icon: String, url: String, type: String, sentAt: Date) { self.id = id self.title = title self.body = body self.icon = icon self.url = url self.type = type + self.sent_at = UInt64(sentAt.timeIntervalSince1970) } } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyMessageRecord.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyMessageRecord.swift index 9fc7b1c2b..97b9a3567 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyMessageRecord.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyMessageRecord.swift @@ -18,16 +18,19 @@ public struct NotifyMessageRecord: Codable, Equatable, SqliteRow { public init(decoder: SqliteRowDecoder) throws { self.topic = try decoder.decodeString(at: 1) + let sentAt = try decoder.decodeDate(at: 7) + self.message = NotifyMessage( id: try decoder.decodeString(at: 0), title: try decoder.decodeString(at: 2), body: try decoder.decodeString(at: 3), icon: try decoder.decodeString(at: 4), url: try decoder.decodeString(at: 5), - type: try decoder.decodeString(at: 6) + type: try decoder.decodeString(at: 6), + sentAt: sentAt ) - self.publishedAt = try decoder.decodeDate(at: 7) + self.publishedAt = sentAt } public func encode() -> SqliteRowEncoder { From 6f5c86ce498421aa4aedfabf47d77050b7063a43 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 17:51:41 +0300 Subject: [PATCH 238/814] fetchHistory finalized --- .../WalletConnectNotify/Client/Wallet/NotifyClient.swift | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index d64f13879..89f5342a3 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -156,7 +156,11 @@ public class NotifyClient { host: subscription.metadata.url ) - // TBD + let records = messages.map { message in + return NotifyMessageRecord(topic: subscription.topic, message: message, publishedAt: message.sentAt) + } + + try notifyStorage.setMessages(records) } } From abb66fc6ba281641f6f41663e9ccd7c8458513ab Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 12 Jan 2024 18:16:12 +0300 Subject: [PATCH 239/814] fetch history on sample app --- .../Wallet/PushMessages/SubscriptionInteractor.swift | 6 ++++++ .../Wallet/PushMessages/SubscriptionPresenter.swift | 2 ++ Sources/WalletConnectHistory/HistoryClient.swift | 2 -- .../NotifyGetNotificationsRequestPayload.swift | 10 +++++----- 4 files changed, 13 insertions(+), 7 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift index 9b0c84ff7..e3d1a14e4 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift @@ -30,4 +30,10 @@ final class SubscriptionInteractor { try await Notify.instance.deleteSubscription(topic: subscription.topic) } } + + func fetchHistory() { + Task(priority: .high) { + try await Notify.instance.fetchHistory(subscription: subscription) + } + } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift index 23f9729f9..c0527399e 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift @@ -77,6 +77,8 @@ extension SubscriptionPresenter: SceneViewModel { private extension SubscriptionPresenter { func setupInitialState() { + interactor.fetchHistory() + pushMessages = interactor.getPushMessages() interactor.messagesPublisher diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectHistory/HistoryClient.swift index 4aef22b0c..6125c2b4f 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectHistory/HistoryClient.swift @@ -13,12 +13,10 @@ public final class HistoryClient { } public func fetchHistory(account: Account, topic: String, appAuthenticationKey: String, host: String) async throws -> [NotifyMessage] { - let identityKey = try identityClient.getInviteKey(for: account) let dappAuthKey = try DIDKey(did: appAuthenticationKey) let app = DIDWeb(host: host) let requestPayload = NotifyGetNotificationsRequestPayload( - identityKey: DIDKey(rawData: identityKey.rawRepresentation), keyserver: keyserver.absoluteString, dappAuthKey: dappAuthKey, app: app, diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift index a479f3af0..cce3a69b3 100644 --- a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift +++ b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift @@ -12,6 +12,7 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { let app: String // - did:web of app domain that this request is associated with - Example: `did:web:app.example.com` let lmt: UInt64 // - the max number of notifications to return. Maximum value is 50. let aft: String? // - the notification ID to start returning messages after. Null to start with the most recent notification + let urf: Bool static var action: String? { return "notify_get_notifications" @@ -30,15 +31,13 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { } } - let identityKey: DIDKey let keyserver: String let dappAuthKey: DIDKey let app: DIDWeb let limit: UInt64 let after: String? - init(identityKey: DIDKey, keyserver: String, dappAuthKey: DIDKey, app: DIDWeb, limit: UInt64, after: String? = nil) { - self.identityKey = identityKey + init(keyserver: String, dappAuthKey: DIDKey, app: DIDWeb, limit: UInt64, after: String? = nil) { self.keyserver = keyserver self.dappAuthKey = dappAuthKey self.app = app @@ -55,12 +54,13 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { iat: defaultIat(), exp: expiry(days: 1), act: Claims.action, - iss: identityKey.did(variant: .ED25519), + iss: iss, ksu: keyserver, aud: dappAuthKey.did(variant: .ED25519), app: app.did, lmt: limit, - aft: after + aft: after, + urf: false ) } } From 5653ddccc6eaf2f1518f04dc222988ede691b70d Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 15 Jan 2024 17:08:06 +0300 Subject: [PATCH 240/814] sub missed --- Sources/WalletConnectHistory/HistoryClient.swift | 1 + .../Payloads/NotifyGetNotificationsRequestPayload.swift | 8 ++++++-- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectHistory/HistoryClient.swift index 6125c2b4f..fc2fa3e0c 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectHistory/HistoryClient.swift @@ -17,6 +17,7 @@ public final class HistoryClient { let app = DIDWeb(host: host) let requestPayload = NotifyGetNotificationsRequestPayload( + account: account, keyserver: keyserver.absoluteString, dappAuthKey: dappAuthKey, app: app, diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift index cce3a69b3..d54825d85 100644 --- a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift +++ b/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift @@ -5,6 +5,7 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { struct Claims: JWTClaims { let iat: UInt64 let exp: UInt64 + let sub: String let act: String? // - `notify_get_notifications` let iss: String // - did:key of client identity key let ksu: String // - key server for identity key verification @@ -31,13 +32,15 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { } } + let account: Account let keyserver: String let dappAuthKey: DIDKey let app: DIDWeb let limit: UInt64 let after: String? - init(keyserver: String, dappAuthKey: DIDKey, app: DIDWeb, limit: UInt64, after: String? = nil) { + init(account: Account, keyserver: String, dappAuthKey: DIDKey, app: DIDWeb, limit: UInt64, after: String? = nil) { + self.account = account self.keyserver = keyserver self.dappAuthKey = dappAuthKey self.app = app @@ -52,7 +55,8 @@ struct NotifyGetNotificationsRequestPayload: JWTClaimsCodable { func encode(iss: String) throws -> Claims { return Claims( iat: defaultIat(), - exp: expiry(days: 1), + exp: expiry(days: 1), + sub: account.did, act: Claims.action, iss: iss, ksu: keyserver, From 551a10ee529fc0d73b22b8da82d94c875a79a1fb Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 15 Jan 2024 17:17:12 +0300 Subject: [PATCH 241/814] Message sent_at fix --- Sources/WalletConnectHistory/Types/NotifyMessage.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectHistory/Types/NotifyMessage.swift b/Sources/WalletConnectHistory/Types/NotifyMessage.swift index f7fc00a72..6c88dfa7a 100644 --- a/Sources/WalletConnectHistory/Types/NotifyMessage.swift +++ b/Sources/WalletConnectHistory/Types/NotifyMessage.swift @@ -10,7 +10,7 @@ public struct NotifyMessage: Codable, Equatable { public let sent_at: UInt64 public var sentAt: Date { - return Date(timeIntervalSince1970: TimeInterval(sent_at)) + return Date(milliseconds: sent_at) } public init(id: String, title: String, body: String, icon: String, url: String, type: String, sentAt: Date) { @@ -20,6 +20,6 @@ public struct NotifyMessage: Codable, Equatable { self.icon = icon self.url = url self.type = type - self.sent_at = UInt64(sentAt.timeIntervalSince1970) + self.sent_at = UInt64(sentAt.millisecondsSince1970) } } From 04458460064cd2f8f5717ba0707971ae58082eee Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 17 Jan 2024 17:23:35 +0300 Subject: [PATCH 242/814] Unit tests fixed --- .../NetworkingInteractorMock.swift | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/Tests/TestingUtils/NetworkingInteractorMock.swift b/Tests/TestingUtils/NetworkingInteractorMock.swift index 27fa35a5c..a1fa196ad 100644 --- a/Tests/TestingUtils/NetworkingInteractorMock.swift +++ b/Tests/TestingUtils/NetworkingInteractorMock.swift @@ -134,6 +134,36 @@ public class NetworkingInteractorMock: NetworkInteracting { }.store(in: &publishers) } + public func awaitResponse( + request: RPCRequest, + topic: String, + method: ProtocolMethod, + requestOfType: Request.Type, + responseOfType: Response.Type, + envelopeType: Envelope.EnvelopeType + ) async throws -> Response { + + try await self.request(request, topic: topic, protocolMethod: method, envelopeType: envelopeType) + + return try await withCheckedThrowingContinuation { [unowned self] continuation in + var response, error: AnyCancellable? + + response = responseSubscription(on: method) + .sink { (payload: ResponseSubscriptionPayload) in + response?.cancel() + error?.cancel() + continuation.resume(with: .success(payload.response)) + } + + error = responseErrorSubscription(on: method) + .sink { (payload: ResponseSubscriptionErrorPayload) in + response?.cancel() + error?.cancel() + continuation.resume(throwing: payload.error) + } + } + } + public func subscribe(topic: String) async throws { defer { onSubscribeCalled?() } subscriptions.append(topic) From ed7f3fb5baa26633765a04019fe05fcab8af4dae Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 17 Jan 2024 17:24:18 +0300 Subject: [PATCH 243/814] Integration tests fixed --- Example/IntegrationTests/Stubs/PushMessage.swift | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Example/IntegrationTests/Stubs/PushMessage.swift b/Example/IntegrationTests/Stubs/PushMessage.swift index 634d78ea1..68d08b36e 100644 --- a/Example/IntegrationTests/Stubs/PushMessage.swift +++ b/Example/IntegrationTests/Stubs/PushMessage.swift @@ -9,6 +9,7 @@ extension NotifyMessage { body: "body", icon: "https://images.unsplash.com/photo-1581224463294-908316338239?ixlib=rb-4.0.3&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=250&q=80", url: "https://web3inbox.com", - type: type) + type: type, + sentAt: Date()) } } From 2f309312f72b014ce7a65ac4e874fe644d19a8a2 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 15:26:24 +0300 Subject: [PATCH 244/814] HistoryPackage removed --- Package.swift | 8 +------- Sources/WalletConnectHistory/HistoryClientFactory.swift | 8 -------- Sources/WalletConnectHistory/HistoryImports.swift | 3 --- .../Client/Wallet/HistoryService.swift} | 2 +- .../WalletConnectNotify/Client/Wallet/NotifyClient.swift | 8 ++++---- .../Client/Wallet/NotifyClientFactory.swift | 4 ++-- Sources/WalletConnectNotify/NotifyImports.swift | 2 +- .../NotifyGetNotificationsProtocolMethod.swift | 0 .../Types/DataStructures}/NotifyMessage.swift | 0 .../NotifyGetNotificationsRequestPayload.swift | 0 .../NotifyGetNotificationsResponsePayload.swift | 0 11 files changed, 9 insertions(+), 26 deletions(-) delete mode 100644 Sources/WalletConnectHistory/HistoryClientFactory.swift delete mode 100644 Sources/WalletConnectHistory/HistoryImports.swift rename Sources/{WalletConnectHistory/HistoryClient.swift => WalletConnectNotify/Client/Wallet/HistoryService.swift} (97%) rename Sources/{WalletConnectHistory => WalletConnectNotify}/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift (100%) rename Sources/{WalletConnectHistory/Types => WalletConnectNotify/Types/DataStructures}/NotifyMessage.swift (100%) rename Sources/{WalletConnectHistory/Payloads => WalletConnectNotify/Types/JWTPayloads/notify_get_notifications}/NotifyGetNotificationsRequestPayload.swift (100%) rename Sources/{WalletConnectHistory/Payloads => WalletConnectNotify/Types/JWTPayloads/notify_get_notifications}/NotifyGetNotificationsResponsePayload.swift (100%) diff --git a/Package.swift b/Package.swift index 617226143..23593b272 100644 --- a/Package.swift +++ b/Package.swift @@ -43,9 +43,6 @@ let package = Package( .library( name: "WalletConnectVerify", targets: ["WalletConnectVerify"]), - .library( - name: "WalletConnectHistory", - targets: ["WalletConnectHistory"]), .library( name: "WalletConnectModal", targets: ["WalletConnectModal"]), @@ -74,7 +71,7 @@ let package = Package( path: "Sources/Web3Wallet"), .target( name: "WalletConnectNotify", - dependencies: ["WalletConnectPairing", "WalletConnectPush", "WalletConnectHistory", "WalletConnectSigner", "Database"], + dependencies: ["WalletConnectPairing", "WalletConnectPush", "WalletConnectSigner", "Database"], path: "Sources/WalletConnectNotify"), .target( name: "WalletConnectPush", @@ -92,9 +89,6 @@ let package = Package( .target( name: "WalletConnectPairing", dependencies: ["WalletConnectNetworking"]), - .target( - name: "WalletConnectHistory", - dependencies: ["WalletConnectIdentity"]), .target( name: "WalletConnectSigner", dependencies: ["WalletConnectNetworking"]), diff --git a/Sources/WalletConnectHistory/HistoryClientFactory.swift b/Sources/WalletConnectHistory/HistoryClientFactory.swift deleted file mode 100644 index 9db17a320..000000000 --- a/Sources/WalletConnectHistory/HistoryClientFactory.swift +++ /dev/null @@ -1,8 +0,0 @@ -import Foundation - -public class HistoryClientFactory { - - public static func create(keyserver: URL, networkingInteractor: NetworkInteracting, identityClient: IdentityClient) -> HistoryClient { - return HistoryClient(keyserver: keyserver, networkingClient: networkingInteractor, identityClient: identityClient) - } -} diff --git a/Sources/WalletConnectHistory/HistoryImports.swift b/Sources/WalletConnectHistory/HistoryImports.swift deleted file mode 100644 index 51e07cac3..000000000 --- a/Sources/WalletConnectHistory/HistoryImports.swift +++ /dev/null @@ -1,3 +0,0 @@ -#if !CocoaPods -@_exported import WalletConnectIdentity -#endif diff --git a/Sources/WalletConnectHistory/HistoryClient.swift b/Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift similarity index 97% rename from Sources/WalletConnectHistory/HistoryClient.swift rename to Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift index fc2fa3e0c..21574e569 100644 --- a/Sources/WalletConnectHistory/HistoryClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift @@ -1,6 +1,6 @@ import Foundation -public final class HistoryClient { +public final class HistoryService { private let keyserver: URL private let networkingClient: NetworkInteracting diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 89f5342a3..e4eab7e08 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -25,7 +25,7 @@ public class NotifyClient { private let keyserverURL: URL private let pushClient: PushClient private let identityClient: IdentityClient - private let historyClient: HistoryClient + private let historyService: HistoryService private let notifyStorage: NotifyStorage private let notifyAccountProvider: NotifyAccountProvider private let notifyMessageSubscriber: NotifyMessageSubscriber @@ -43,7 +43,7 @@ public class NotifyClient { keyserverURL: URL, kms: KeyManagementServiceProtocol, identityClient: IdentityClient, - historyClient: HistoryClient, + historyService: HistoryService, pushClient: PushClient, notifyMessageSubscriber: NotifyMessageSubscriber, notifyStorage: NotifyStorage, @@ -64,7 +64,7 @@ public class NotifyClient { self.keyserverURL = keyserverURL self.pushClient = pushClient self.identityClient = identityClient - self.historyClient = historyClient + self.historyService = historyService self.notifyMessageSubscriber = notifyMessageSubscriber self.notifyStorage = notifyStorage self.deleteNotifySubscriptionRequester = deleteNotifySubscriptionRequester @@ -149,7 +149,7 @@ public class NotifyClient { } public func fetchHistory(subscription: NotifySubscription) async throws { - let messages = try await historyClient.fetchHistory( + let messages = try await historyService.fetchHistory( account: subscription.account, topic: subscription.topic, appAuthenticationKey: subscription.appAuthenticationKey, diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 3bbcbe4af..ec417a765 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -68,14 +68,14 @@ public struct NotifyClientFactory { let notifyWatchSubscriptionsResponseSubscriber = NotifyWatchSubscriptionsResponseSubscriber(networkingInteractor: networkInteractor, kms: kms, logger: logger, notifyStorage: notifyStorage, groupKeychainStorage: groupKeychainStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let notifySubscriptionsChangedRequestSubscriber = NotifySubscriptionsChangedRequestSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, kms: kms, identityClient: identityClient, logger: logger, groupKeychainStorage: groupKeychainStorage, notifyStorage: notifyStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let subscriptionWatcher = SubscriptionWatcher(notifyWatchSubscriptionsRequester: notifyWatchSubscriptionsRequester, logger: logger) - let historyClient = HistoryClientFactory.create(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient) + let historyService = HistoryService(keyserver: keyserverURL, networkingClient: networkInteractor, identityClient: identityClient) return NotifyClient( logger: logger, keyserverURL: keyserverURL, kms: kms, identityClient: identityClient, - historyClient: historyClient, + historyService: historyService, pushClient: pushClient, notifyMessageSubscriber: notifyMessageSubscriber, notifyStorage: notifyStorage, diff --git a/Sources/WalletConnectNotify/NotifyImports.swift b/Sources/WalletConnectNotify/NotifyImports.swift index e2f267c31..43b543236 100644 --- a/Sources/WalletConnectNotify/NotifyImports.swift +++ b/Sources/WalletConnectNotify/NotifyImports.swift @@ -1,7 +1,7 @@ #if !CocoaPods @_exported import WalletConnectPairing @_exported import WalletConnectPush -@_exported import WalletConnectHistory +@_exported import WalletConnectIdentity @_exported import WalletConnectSigner @_exported import Database #endif diff --git a/Sources/WalletConnectHistory/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift b/Sources/WalletConnectNotify/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift similarity index 100% rename from Sources/WalletConnectHistory/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift rename to Sources/WalletConnectNotify/ProtocolMethods/NotifyGetNotificationsProtocolMethod.swift diff --git a/Sources/WalletConnectHistory/Types/NotifyMessage.swift b/Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift similarity index 100% rename from Sources/WalletConnectHistory/Types/NotifyMessage.swift rename to Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift b/Sources/WalletConnectNotify/Types/JWTPayloads/notify_get_notifications/NotifyGetNotificationsRequestPayload.swift similarity index 100% rename from Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsRequestPayload.swift rename to Sources/WalletConnectNotify/Types/JWTPayloads/notify_get_notifications/NotifyGetNotificationsRequestPayload.swift diff --git a/Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsResponsePayload.swift b/Sources/WalletConnectNotify/Types/JWTPayloads/notify_get_notifications/NotifyGetNotificationsResponsePayload.swift similarity index 100% rename from Sources/WalletConnectHistory/Payloads/NotifyGetNotificationsResponsePayload.swift rename to Sources/WalletConnectNotify/Types/JWTPayloads/notify_get_notifications/NotifyGetNotificationsResponsePayload.swift From af7f2707defda0b219c670a3cc34cdcaece3da51 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 15:51:15 +0300 Subject: [PATCH 245/814] testWalletCreatesAndUpdatesSubscription reenabled --- Example/ExampleApp.xcodeproj/project.pbxproj | 7 ------- Example/IntegrationTests/Push/NotifyTests.swift | 2 -- Package.swift | 2 +- 3 files changed, 1 insertion(+), 10 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index f90232086..1524f8161 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -61,7 +61,6 @@ A50D53C32ABA055700A4FD8B /* NotifyPreferencesRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BE2ABA055700A4FD8B /* NotifyPreferencesRouter.swift */; }; A50D53C42ABA055700A4FD8B /* NotifyPreferencesInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BF2ABA055700A4FD8B /* NotifyPreferencesInteractor.swift */; }; A50D53C52ABA055700A4FD8B /* NotifyPreferencesView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53C02ABA055700A4FD8B /* NotifyPreferencesView.swift */; }; - A50DF19D2A25084A0036EA6C /* WalletConnectHistory in Frameworks */ = {isa = PBXBuildFile; productRef = A50DF19C2A25084A0036EA6C /* WalletConnectHistory */; }; A50F3946288005B200064555 /* Types.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50F3945288005B200064555 /* Types.swift */; }; A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */; }; A51606F92A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */; }; @@ -767,7 +766,6 @@ A5E03DFF2864662500888481 /* WalletConnect in Frameworks */, A561C80529DFCD4500DF540D /* WalletConnectSync in Frameworks */, A5E03DF52864651200888481 /* Starscream in Frameworks */, - A50DF19D2A25084A0036EA6C /* WalletConnectHistory in Frameworks */, A5C8BE85292FE20B006CC85C /* Web3 in Frameworks */, 84DDB4ED28ABB663003D66ED /* WalletConnectAuth in Frameworks */, C5DD5BE1294E09E3008FD3A4 /* Web3Wallet in Frameworks */, @@ -2107,7 +2105,6 @@ C5DD5BE0294E09E3008FD3A4 /* Web3Wallet */, A561C80429DFCD4500DF540D /* WalletConnectSync */, A573C53A29EC365800E3CBFD /* HDWalletKit */, - A50DF19C2A25084A0036EA6C /* WalletConnectHistory */, A5B6C0F22A6EAB1700927332 /* WalletConnectNotify */, ); productName = IntegrationTests; @@ -3444,10 +3441,6 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnectAuth; }; - A50DF19C2A25084A0036EA6C /* WalletConnectHistory */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectHistory; - }; A54195A42934E83F0035AD19 /* Web3 */ = { isa = XCSwiftPackageProductDependency; package = A5AE354528A1A2AC0059AE8A /* XCRemoteSwiftPackageReference "Web3" */; diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 8d26941ae..5e7d06038 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -165,7 +165,6 @@ final class NotifyTests: XCTestCase { } } - /* func testWalletCreatesAndUpdatesSubscription() async throws { let created = expectation(description: "Subscription created") @@ -202,7 +201,6 @@ final class NotifyTests: XCTestCase { try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) } - */ func testNotifyServerSubscribeAndNotifies() async throws { let subscribeExpectation = expectation(description: "creates notify subscription") diff --git a/Package.swift b/Package.swift index 23593b272..c40c3b05c 100644 --- a/Package.swift +++ b/Package.swift @@ -71,7 +71,7 @@ let package = Package( path: "Sources/Web3Wallet"), .target( name: "WalletConnectNotify", - dependencies: ["WalletConnectPairing", "WalletConnectPush", "WalletConnectSigner", "Database"], + dependencies: ["WalletConnectIdentity", "WalletConnectPairing", "WalletConnectPush", "WalletConnectSigner", "Database"], path: "Sources/WalletConnectNotify"), .target( name: "WalletConnectPush", From f3d2b68a4392472557ab4c1efcb993cabc976899 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 16:01:57 +0300 Subject: [PATCH 246/814] Missing WalletConnectIdentity added --- Example/ExampleApp.xcodeproj/project.pbxproj | 7 +++++++ Example/IntegrationTests/Push/NotifyTests.swift | 1 - Package.swift | 4 +++- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 1524f8161..9a7ee789d 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -176,6 +176,7 @@ A5B6C0F32A6EAB1700927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F22A6EAB1700927332 /* WalletConnectNotify */; }; A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F42A6EAB2800927332 /* WalletConnectNotify */; }; A5B6C0F72A6EAB3200927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F62A6EAB3200927332 /* WalletConnectNotify */; }; + A5B814FA2B5AAA2F00AECCFD /* WalletConnectIdentity in Frameworks */ = {isa = PBXBuildFile; productRef = A5B814F92B5AAA2F00AECCFD /* WalletConnectIdentity */; }; A5BB7FA328B6A50400707FC6 /* WalletConnectAuth in Frameworks */ = {isa = PBXBuildFile; productRef = A5BB7FA228B6A50400707FC6 /* WalletConnectAuth */; }; A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */; }; A5C2020B287D9DEE007E3188 /* WelcomeModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20206287D9DEE007E3188 /* WelcomeModule.swift */; }; @@ -765,6 +766,7 @@ files = ( A5E03DFF2864662500888481 /* WalletConnect in Frameworks */, A561C80529DFCD4500DF540D /* WalletConnectSync in Frameworks */, + A5B814FA2B5AAA2F00AECCFD /* WalletConnectIdentity in Frameworks */, A5E03DF52864651200888481 /* Starscream in Frameworks */, A5C8BE85292FE20B006CC85C /* Web3 in Frameworks */, 84DDB4ED28ABB663003D66ED /* WalletConnectAuth in Frameworks */, @@ -2106,6 +2108,7 @@ A561C80429DFCD4500DF540D /* WalletConnectSync */, A573C53A29EC365800E3CBFD /* HDWalletKit */, A5B6C0F22A6EAB1700927332 /* WalletConnectNotify */, + A5B814F92B5AAA2F00AECCFD /* WalletConnectIdentity */, ); productName = IntegrationTests; productReference = A5E03DED286464DB00888481 /* IntegrationTests.xctest */; @@ -3523,6 +3526,10 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnectNotify; }; + A5B814F92B5AAA2F00AECCFD /* WalletConnectIdentity */ = { + isa = XCSwiftPackageProductDependency; + productName = WalletConnectIdentity; + }; A5BB7FA228B6A50400707FC6 /* WalletConnectAuth */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectAuth; diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 5e7d06038..3fd829afd 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -252,7 +252,6 @@ final class NotifyTests: XCTestCase { try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) } } - } diff --git a/Package.swift b/Package.swift index c40c3b05c..3321d7eb7 100644 --- a/Package.swift +++ b/Package.swift @@ -46,7 +46,9 @@ let package = Package( .library( name: "WalletConnectModal", targets: ["WalletConnectModal"]), - + .library( + name: "WalletConnectIdentity", + targets: ["WalletConnectIdentity"]), ], dependencies: [ .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.3.0"), From 3b3ebcc9717d96a9da985e6a83824ab290949a41 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 19 Jan 2024 14:24:35 +0100 Subject: [PATCH 247/814] savepoint --- .../PresentationLayer/Wallet/Wallet/WalletPresenter.swift | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 1532b17b1..753ad8ad6 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -148,7 +148,9 @@ extension WalletPresenter { } private func setUpPairingIndicatorRemoval() { - Web3Wallet.instance.pairingStatePublisher.sink { [weak self] isPairing in + Web3Wallet.instance.pairingStatePublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] isPairing in self?.showPairingLoading = isPairing }.store(in: &disposeBag) } @@ -173,3 +175,4 @@ extension WalletPresenter.Errors: LocalizedError { } } } + From 79fe9950ae7a68e5cba904f6ad36a3b3828ff5bd Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 17:11:49 +0300 Subject: [PATCH 248/814] Messages integration tests --- .../IntegrationTests/Push/NotifyTests.swift | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 3fd829afd..fe1125fa9 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -252,6 +252,29 @@ final class NotifyTests: XCTestCase { try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) } } + + func testFetchHistory() async throws { + let subscribeExpectation = expectation(description: "fetch notify subscription") + let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! + + var subscription: NotifySubscription! + walletNotifyClientA.subscriptionsPublisher + .sink { subscriptions in + subscription = subscriptions.first + subscribeExpectation.fulfill() + }.store(in: &publishers) + + try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in + let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") + let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) + return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) + } + + await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) + + try await walletNotifyClientA.fetchHistory(subscription: subscription) + XCTAssertEqual(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count, 41) + } } From ba16939601fa3f5d8f86069d666fd6c60cfb7c36 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 17:12:06 +0300 Subject: [PATCH 249/814] awaitResponse updated with ack --- .../NetworkingInteractor.swift | 23 +++++++++++++------ 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index f0bc0a2bb..078c8adf7 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -147,25 +147,34 @@ public class NetworkingInteractor: NetworkInteracting { responseOfType: Response.Type, envelopeType: Envelope.EnvelopeType ) async throws -> Response { - - try await self.request(request, topic: topic, protocolMethod: method, envelopeType: envelopeType) - return try await withCheckedThrowingContinuation { [unowned self] continuation in var response, error: AnyCancellable? + let cancel: () -> Void = { + response?.cancel() + error?.cancel() + } + response = responseSubscription(on: method) .sink { (payload: ResponseSubscriptionPayload) in - response?.cancel() - error?.cancel() + cancel() continuation.resume(with: .success(payload.response)) } error = responseErrorSubscription(on: method) .sink { (payload: ResponseSubscriptionErrorPayload) in - response?.cancel() - error?.cancel() + cancel() continuation.resume(throwing: payload.error) } + + Task(priority: .high) { + do { + try await self.request(request, topic: topic, protocolMethod: method, envelopeType: envelopeType) + } catch { + cancel() + continuation.resume(throwing: error) + } + } } } From c5319859e6f054e72d75e0ec02b79ce678f75a2d Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Fri, 19 Jan 2024 17:23:43 +0300 Subject: [PATCH 250/814] History imports removed --- Example/ExampleApp.xcodeproj/project.pbxproj | 12 ------------ Example/IntegrationTests/Chat/ChatTests.swift | 1 - Example/IntegrationTests/History/HistoryTests.swift | 8 -------- Example/IntegrationTests/Pairing/PairingTests.swift | 1 - Sources/Chat/ChatImports.swift | 1 - WalletConnectSwiftV2.podspec | 7 ------- 6 files changed, 30 deletions(-) delete mode 100644 Example/IntegrationTests/History/HistoryTests.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 9a7ee789d..a5ee276b5 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -78,7 +78,6 @@ A518B31428E33A6500A2CE93 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518B31328E33A6500A2CE93 /* InputConfig.swift */; }; A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51AC0D828E436A3001BACF9 /* InputConfig.swift */; }; A51AC0DF28E4379F001BACF9 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51AC0DE28E4379F001BACF9 /* InputConfig.swift */; }; - A5321C2B2A250367006CADC3 /* HistoryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5321C2A2A250367006CADC3 /* HistoryTests.swift */; }; A5417BBE299BFC3E00B469F3 /* ImportAccount.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */; }; A541959E2934BFEF0035AD19 /* CacaoSignerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959A2934BFEF0035AD19 /* CacaoSignerTests.swift */; }; A541959F2934BFEF0035AD19 /* SignerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959B2934BFEF0035AD19 /* SignerTests.swift */; }; @@ -475,7 +474,6 @@ A518B31328E33A6500A2CE93 /* InputConfig.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; A51AC0D828E436A3001BACF9 /* InputConfig.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; A51AC0DE28E4379F001BACF9 /* InputConfig.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; - A5321C2A2A250367006CADC3 /* HistoryTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HistoryTests.swift; sourceTree = ""; }; A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ImportAccount.swift; sourceTree = ""; }; A541959A2934BFEF0035AD19 /* CacaoSignerTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = CacaoSignerTests.swift; sourceTree = ""; }; A541959B2934BFEF0035AD19 /* SignerTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SignerTests.swift; sourceTree = ""; }; @@ -1047,14 +1045,6 @@ path = Settings; sourceTree = ""; }; - A5321C292A25035A006CADC3 /* History */ = { - isa = PBXGroup; - children = ( - A5321C2A2A250367006CADC3 /* HistoryTests.swift */, - ); - path = History; - sourceTree = ""; - }; A54195992934BFDD0035AD19 /* Signer */ = { isa = PBXGroup; children = ( @@ -1481,7 +1471,6 @@ isa = PBXGroup; children = ( 847F07FE2A25DBC700B2A5A4 /* XPlatform */, - A5321C292A25035A006CADC3 /* History */, A561C80129DFCCD300DF540D /* Sync */, 849D7A91292E2115006A2BD4 /* Push */, 84CEC64728D8A98900D081A8 /* Pairing */, @@ -2488,7 +2477,6 @@ 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */, 7694A5262874296A0001257E /* RegistryTests.swift in Sources */, A541959F2934BFEF0035AD19 /* SignerTests.swift in Sources */, - A5321C2B2A250367006CADC3 /* HistoryTests.swift in Sources */, A58A1ECC29BF458600A82A20 /* ENSResolverTests.swift in Sources */, A5E03DFA286465C700888481 /* SignClientTests.swift in Sources */, 84A6E3C32A386BBC008A0571 /* Publisher.swift in Sources */, diff --git a/Example/IntegrationTests/Chat/ChatTests.swift b/Example/IntegrationTests/Chat/ChatTests.swift index 0b4528fe4..ff09c65f1 100644 --- a/Example/IntegrationTests/Chat/ChatTests.swift +++ b/Example/IntegrationTests/Chat/ChatTests.swift @@ -4,7 +4,6 @@ import XCTest import WalletConnectUtils @testable import WalletConnectKMS @testable import WalletConnectSync -@testable import WalletConnectHistory import WalletConnectRelay import Combine import Web3 diff --git a/Example/IntegrationTests/History/HistoryTests.swift b/Example/IntegrationTests/History/HistoryTests.swift deleted file mode 100644 index 4ebbdd80d..000000000 --- a/Example/IntegrationTests/History/HistoryTests.swift +++ /dev/null @@ -1,8 +0,0 @@ -import Foundation -import Combine -import XCTest -@testable import WalletConnectHistory - -final class HistoryTests: XCTestCase { - -} diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 657530902..6bc02014c 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -9,7 +9,6 @@ import WalletConnectPush @testable import Auth @testable import WalletConnectPairing @testable import WalletConnectSync -@testable import WalletConnectHistory final class PairingTests: XCTestCase { diff --git a/Sources/Chat/ChatImports.swift b/Sources/Chat/ChatImports.swift index 447ee4a25..24dfe29a5 100644 --- a/Sources/Chat/ChatImports.swift +++ b/Sources/Chat/ChatImports.swift @@ -2,5 +2,4 @@ @_exported import WalletConnectSigner @_exported import WalletConnectIdentity @_exported import WalletConnectSync -@_exported import WalletConnectHistory #endif diff --git a/WalletConnectSwiftV2.podspec b/WalletConnectSwiftV2.podspec index c3cf47387..5a294b701 100644 --- a/WalletConnectSwiftV2.podspec +++ b/WalletConnectSwiftV2.podspec @@ -101,17 +101,10 @@ Pod::Spec.new do |spec| ss.dependency 'WalletConnectSwiftV2/WalletConnectNetworking' end - spec.subspec 'WalletConnectHistory' do |ss| - ss.source_files = 'Sources/WalletConnectHistory/**/*.{h,m,swift}' - ss.dependency 'WalletConnectSwiftV2/WalletConnectRelay' - ss.dependency 'WalletConnectSwiftV2/HTTPClient' - end - spec.subspec 'WalletConnectChat' do |ss| ss.source_files = 'Sources/Chat/**/*.{h,m,swift}' ss.dependency 'WalletConnectSwiftV2/WalletConnectSync' ss.dependency 'WalletConnectSwiftV2/WalletConnectIdentity' - ss.dependency 'WalletConnectSwiftV2/WalletConnectHistory' end spec.subspec 'WalletConnectSync' do |ss| From a25e2cf6ba108e61439e74a2c6c24a98d7f4fc78 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 08:51:07 +0100 Subject: [PATCH 251/814] Add expiry to pairing uri --- .../DApp/ApplicationLayer/Application.swift | 1 - .../ApplicationLayer/SceneDelegate.swift | 17 +++-- .../Wallet/Wallet/WalletPresenter.swift | 34 +++++----- .../WalletConnectUtils/WalletConnectURI.swift | 64 ++++++++++++++---- .../WalletConnectURITests.swift | 66 +++++++++++++------ 5 files changed, 127 insertions(+), 55 deletions(-) diff --git a/Example/DApp/ApplicationLayer/Application.swift b/Example/DApp/ApplicationLayer/Application.swift index feba5e373..e4c9d7c63 100644 --- a/Example/DApp/ApplicationLayer/Application.swift +++ b/Example/DApp/ApplicationLayer/Application.swift @@ -4,5 +4,4 @@ import WalletConnectUtils final class Application { var uri: WalletConnectURI? - var requestSent = false } diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index c39e67513..6b32b28ef 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -29,7 +29,13 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio window = UIWindow(windowScene: windowScene) window?.makeKeyAndVisible() - app.uri = WalletConnectURI(connectionOptions: connectionOptions) + do { + let uri = try WalletConnectURI(connectionOptions: connectionOptions) + app.uri = uri + } catch { + print("Error initializing WalletConnectURI: \(error.localizedDescription)") + } + app.requestSent = (connectionOptions.urlContexts.first?.url.absoluteString.replacingOccurrences(of: "walletapp://wc?", with: "") == "requestSent") configurators.configure() @@ -37,18 +43,21 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio UNUserNotificationCenter.current().delegate = self } + func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { guard let context = URLContexts.first else { return } - let uri = WalletConnectURI(urlContext: context) - - if let uri { + do { + let uri = try WalletConnectURI(urlContext: context) Task { try await Web3Wallet.instance.pair(uri: uri) } + } catch { + print("Error initializing WalletConnectURI: \(error.localizedDescription)") } } + func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification) async -> UNNotificationPresentationOptions { open(notification: notification) return [.sound, .banner, .badge] diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 753ad8ad6..ef158d674 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -58,15 +58,15 @@ final class WalletPresenter: ObservableObject { } func onPasteUri() { - router.presentPaste { [weak self] uri in - guard let uri = WalletConnectURI(string: uri) else { - self?.errorMessage = Errors.invalidUri(uri: uri).localizedDescription + router.presentPaste { [weak self] uriString in + do { + let uri = try WalletConnectURI(string: uriString) + print("URI: \(uri)") + self?.pair(uri: uri) + } catch { + self?.errorMessage = error.localizedDescription self?.showError.toggle() - return } - print("URI: \(uri)") - self?.pair(uri: uri) - } onError: { [weak self] error in print(error.localizedDescription) self?.router.dismiss() @@ -74,20 +74,22 @@ final class WalletPresenter: ObservableObject { } func onScanUri() { - router.presentScan { [weak self] uri in - guard let uri = WalletConnectURI(string: uri) else { - self?.errorMessage = Errors.invalidUri(uri: uri).localizedDescription + router.presentScan { [weak self] uriString in + do { + let uri = try WalletConnectURI(string: uriString) + print("URI: \(uri)") + self?.pair(uri: uri) + self?.router.dismiss() + } catch { + self?.errorMessage = error.localizedDescription self?.showError.toggle() - return } - print("URI: \(uri)") - self?.pair(uri: uri) - self?.router.dismiss() - } onError: { error in + } onError: { [weak self] error in print(error.localizedDescription) - self.router.dismiss() + self?.router.dismiss() } } + func removeSession(at indexSet: IndexSet) async { if let index = indexSet.first { diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 02d1af1aa..08945a8ea 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -1,13 +1,18 @@ import Foundation public struct WalletConnectURI: Equatable { + public enum Errors: Error { + case expired + case invalidFormat + } public let topic: String public let version: String public let symKey: String public let relay: RelayProtocolOptions + public let expiryTimestamp: UInt64 public var absoluteString: String { - return "wc:\(topic)@\(version)?symKey=\(symKey)&\(relayQuery)" + return "wc:\(topic)@\(version)?symKey=\(symKey)&\(relayQuery)&expiryTimestamp=\(fiveMinutesFromNow)" } public var deeplinkUri: String { @@ -20,12 +25,16 @@ public struct WalletConnectURI: Equatable { self.topic = topic self.symKey = symKey self.relay = relay + + // Only after all properties are initialized, you can use self or its methods + self.expiryTimestamp = fiveMinutesFromNow } - public init?(string: String) { + + public init(string: String) throws { let decodedString = string.removingPercentEncoding ?? string guard let components = Self.parseURIComponents(from: decodedString) else { - return nil + throw Errors.invalidFormat } let query: [String: String]? = components.queryItems?.reduce(into: [:]) { $0[$1.name] = $1.value } @@ -35,19 +44,31 @@ public struct WalletConnectURI: Equatable { let symKey = query?["symKey"], let relayProtocol = query?["relay-protocol"] else { - return nil + throw Errors.invalidFormat } + let relayData = query?["relay-data"] + // Check if expiryTimestamp is provided and valid + if let expiryTimestampString = query?["expiryTimestamp"], + let expiryTimestamp = UInt64(expiryTimestampString), + expiryTimestamp <= UInt64(Date().timeIntervalSince1970) { + throw Errors.expired + } + self.version = version self.topic = topic self.symKey = symKey self.relay = RelayProtocolOptions(protocol: relayProtocol, data: relayData) + // Set expiryTimestamp to 5 minutes in the future if not included in the uri + self.expiryTimestamp = UInt64(query?["expiryTimestamp"] ?? "") ?? fiveMinutesFromNow + } - - public init?(deeplinkUri: URL) { + + + public init(deeplinkUri: URL) throws { let uriString = deeplinkUri.query?.replacingOccurrences(of: "uri=", with: "") ?? "" - self.init(string: uriString) + try self.init(string: uriString) } private var relayQuery: String { @@ -68,24 +89,41 @@ public struct WalletConnectURI: Equatable { } } +extension WalletConnectURI.Errors: LocalizedError { + public var errorDescription: String? { + switch self { + case .expired: + return NSLocalizedString("The URI has expired.", comment: "Expired URI Error") + case .invalidFormat: + return NSLocalizedString("The format of the URI is invalid.", comment: "Invalid Format URI Error") + } + } +} + + +fileprivate var fiveMinutesFromNow: UInt64 { + return UInt64(Date().timeIntervalSince1970) + 5 * 60 +} + + #if canImport(UIKit) import UIKit extension WalletConnectURI { - public init?(connectionOptions: UIScene.ConnectionOptions) { + public init(connectionOptions: UIScene.ConnectionOptions) throws { if let uri = connectionOptions.urlContexts.first?.url.query?.replacingOccurrences(of: "uri=", with: "") { - self.init(string: uri) + try self.init(string: uri) } else { - return nil + throw Errors.invalidFormat } } - public init?(urlContext: UIOpenURLContext) { + public init(urlContext: UIOpenURLContext) throws { if let uri = urlContext.url.query?.replacingOccurrences(of: "uri=", with: "") { - self.init(string: uri) + try self.init(string: uri) } else { - return nil + throw Errors.invalidFormat } } } diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index 6404e7b41..67f48e78a 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -5,11 +5,11 @@ private func stubURI() -> (uri: WalletConnectURI, string: String) { let topic = Data.randomBytes(count: 32).toHexString() let symKey = Data.randomBytes(count: 32).toHexString() let protocolName = "irn" - let uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)" let uri = WalletConnectURI( topic: topic, symKey: symKey, relay: RelayProtocolOptions(protocol: protocolName, data: nil)) + let uriString = uri.absoluteString return (uri, uriString) } @@ -17,26 +17,26 @@ final class WalletConnectURITests: XCTestCase { // MARK: - Init URI with string - func testInitURIToString() { + func testInitURIToString() throws { let input = stubURI() let uriString = input.uri.absoluteString - let outputURI = WalletConnectURI(string: uriString) + let outputURI = try WalletConnectURI(string: uriString) XCTAssertEqual(input.uri, outputURI) - XCTAssertEqual(input.string, outputURI?.absoluteString) + XCTAssertEqual(input.string, outputURI.absoluteString) } - func testInitStringToURI() { + func testInitStringToURI() throws { let inputURIString = stubURI().string - let uri = WalletConnectURI(string: inputURIString) - let outputURIString = uri?.absoluteString + let uri = try WalletConnectURI(string: inputURIString) + let outputURIString = uri.absoluteString XCTAssertEqual(inputURIString, outputURIString) } - func testInitStringToURIAlternate() { + func testInitStringToURIAlternate() throws { let expectedString = stubURI().string let inputURIString = expectedString.replacingOccurrences(of: "wc:", with: "wc://") - let uri = WalletConnectURI(string: inputURIString) - let outputURIString = uri?.absoluteString + let uri = try WalletConnectURI(string: inputURIString) + let outputURIString = uri.absoluteString XCTAssertEqual(expectedString, outputURIString) } @@ -44,39 +44,63 @@ final class WalletConnectURITests: XCTestCase { func testInitFailsBadScheme() { let inputURIString = stubURI().string.replacingOccurrences(of: "wc:", with: "") - let uri = WalletConnectURI(string: inputURIString) - XCTAssertNil(uri) + XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) } func testInitFailsMalformedURL() { let inputURIString = "wc://<" - let uri = WalletConnectURI(string: inputURIString) - XCTAssertNil(uri) + XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) } func testInitFailsNoSymKeyParam() { let input = stubURI() let inputURIString = input.string.replacingOccurrences(of: "symKey=\(input.uri.symKey)", with: "") - let uri = WalletConnectURI(string: inputURIString) - XCTAssertNil(uri) + XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) } func testInitFailsNoRelayParam() { let input = stubURI() let inputURIString = input.string.replacingOccurrences(of: "&relay-protocol=\(input.uri.relay.protocol)", with: "") - let uri = WalletConnectURI(string: inputURIString) - XCTAssertNil(uri) + XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) } - func testInitHandlesURLEncodedString() { + func testInitHandlesURLEncodedString() throws { let input = stubURI() let encodedURIString = input.string .addingPercentEncoding(withAllowedCharacters: .alphanumerics) ?? "" - let uri = WalletConnectURI(string: encodedURIString) + let uri = try WalletConnectURI(string: encodedURIString) // Assert that the initializer can handle encoded URI and it matches the expected URI XCTAssertEqual(input.uri, uri) - XCTAssertEqual(input.string, uri?.absoluteString) + XCTAssertEqual(input.string, uri.absoluteString) + } + + // MARK: - Expiry Logic Tests + + func testExpiryTimestampIsSet() { + let uri = stubURI().uri + XCTAssertNotNil(uri.expiryTimestamp) + XCTAssertTrue(uri.expiryTimestamp > UInt64(Date().timeIntervalSince1970)) + } + + func testInitFailsIfURIExpired() { + let input = stubURI() + // Create a URI string with an expired timestamp + let expiredTimestamp = UInt64(Date().timeIntervalSince1970) - 300 // 5 minutes in the past + let expiredURIString = "wc:\(input.uri.topic)@\(input.uri.version)?symKey=\(input.uri.symKey)&relay-protocol=\(input.uri.relay.protocol)&expiryTimestamp=\(expiredTimestamp)" + XCTAssertThrowsError(try WalletConnectURI(string: expiredURIString)) + } + + // Test compatibility with old clients that don't include expiryTimestamp in their uri + func testDefaultExpiryTimestampIfNotIncluded() throws { + let input = stubURI().string + // Remove expiryTimestamp from the URI string + let uriStringWithoutExpiry = input.replacingOccurrences(of: "&expiryTimestamp=\(stubURI().uri.expiryTimestamp)", with: "") + let uri = try WalletConnectURI(string: uriStringWithoutExpiry) + + // Check if the expiryTimestamp is set to 5 minutes in the future + let expectedExpiryTimestamp = UInt64(Date().timeIntervalSince1970) + 5 * 60 + XCTAssertTrue(uri.expiryTimestamp >= expectedExpiryTimestamp) } } From 10cbba321c3fe3edfb9c8025462e96e4621c143a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 09:36:41 +0100 Subject: [PATCH 252/814] add deprecated uri init --- .../Wallet/Wallet/WalletPresenter.swift | 4 ++-- .../WalletConnectUtils/WalletConnectURI.swift | 19 +++++++++++++----- .../WalletConnectURITests.swift | 20 +++++++++---------- 3 files changed, 26 insertions(+), 17 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index ef158d674..4fbd34253 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -60,7 +60,7 @@ final class WalletPresenter: ObservableObject { func onPasteUri() { router.presentPaste { [weak self] uriString in do { - let uri = try WalletConnectURI(string: uriString) + let uri = try WalletConnectURI(uriString: uriString) print("URI: \(uri)") self?.pair(uri: uri) } catch { @@ -76,7 +76,7 @@ final class WalletPresenter: ObservableObject { func onScanUri() { router.presentScan { [weak self] uriString in do { - let uri = try WalletConnectURI(string: uriString) + let uri = try WalletConnectURI(uriString: uriString) print("URI: \(uri)") self?.pair(uri: uri) self?.router.dismiss() diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 08945a8ea..7195bb19f 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -30,9 +30,18 @@ public struct WalletConnectURI: Equatable { self.expiryTimestamp = fiveMinutesFromNow } + @available(*, deprecated, message: "Use the throwing initializer instead") + public init?(string: String) { + do { + try self.init(uriString: string) + } catch { + print("Initialization failed: \(error.localizedDescription)") + return nil + } + } - public init(string: String) throws { - let decodedString = string.removingPercentEncoding ?? string + public init(uriString: String) throws { + let decodedString = uriString.removingPercentEncoding ?? uriString guard let components = Self.parseURIComponents(from: decodedString) else { throw Errors.invalidFormat } @@ -68,7 +77,7 @@ public struct WalletConnectURI: Equatable { public init(deeplinkUri: URL) throws { let uriString = deeplinkUri.query?.replacingOccurrences(of: "uri=", with: "") ?? "" - try self.init(string: uriString) + try self.init(uriString: uriString) } private var relayQuery: String { @@ -113,7 +122,7 @@ import UIKit extension WalletConnectURI { public init(connectionOptions: UIScene.ConnectionOptions) throws { if let uri = connectionOptions.urlContexts.first?.url.query?.replacingOccurrences(of: "uri=", with: "") { - try self.init(string: uri) + try self.init(uriString: uri) } else { throw Errors.invalidFormat } @@ -121,7 +130,7 @@ extension WalletConnectURI { public init(urlContext: UIOpenURLContext) throws { if let uri = urlContext.url.query?.replacingOccurrences(of: "uri=", with: "") { - try self.init(string: uri) + try self.init(uriString: uri) } else { throw Errors.invalidFormat } diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index 67f48e78a..be9913382 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -20,14 +20,14 @@ final class WalletConnectURITests: XCTestCase { func testInitURIToString() throws { let input = stubURI() let uriString = input.uri.absoluteString - let outputURI = try WalletConnectURI(string: uriString) + let outputURI = try WalletConnectURI(uriString: uriString) XCTAssertEqual(input.uri, outputURI) XCTAssertEqual(input.string, outputURI.absoluteString) } func testInitStringToURI() throws { let inputURIString = stubURI().string - let uri = try WalletConnectURI(string: inputURIString) + let uri = try WalletConnectURI(uriString: inputURIString) let outputURIString = uri.absoluteString XCTAssertEqual(inputURIString, outputURIString) } @@ -35,7 +35,7 @@ final class WalletConnectURITests: XCTestCase { func testInitStringToURIAlternate() throws { let expectedString = stubURI().string let inputURIString = expectedString.replacingOccurrences(of: "wc:", with: "wc://") - let uri = try WalletConnectURI(string: inputURIString) + let uri = try WalletConnectURI(uriString: inputURIString) let outputURIString = uri.absoluteString XCTAssertEqual(expectedString, outputURIString) } @@ -44,31 +44,31 @@ final class WalletConnectURITests: XCTestCase { func testInitFailsBadScheme() { let inputURIString = stubURI().string.replacingOccurrences(of: "wc:", with: "") - XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) + XCTAssertThrowsError(try WalletConnectURI(uriString: inputURIString)) } func testInitFailsMalformedURL() { let inputURIString = "wc://<" - XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) + XCTAssertThrowsError(try WalletConnectURI(uriString: inputURIString)) } func testInitFailsNoSymKeyParam() { let input = stubURI() let inputURIString = input.string.replacingOccurrences(of: "symKey=\(input.uri.symKey)", with: "") - XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) + XCTAssertThrowsError(try WalletConnectURI(uriString: inputURIString)) } func testInitFailsNoRelayParam() { let input = stubURI() let inputURIString = input.string.replacingOccurrences(of: "&relay-protocol=\(input.uri.relay.protocol)", with: "") - XCTAssertThrowsError(try WalletConnectURI(string: inputURIString)) + XCTAssertThrowsError(try WalletConnectURI(uriString: inputURIString)) } func testInitHandlesURLEncodedString() throws { let input = stubURI() let encodedURIString = input.string .addingPercentEncoding(withAllowedCharacters: .alphanumerics) ?? "" - let uri = try WalletConnectURI(string: encodedURIString) + let uri = try WalletConnectURI(uriString: encodedURIString) // Assert that the initializer can handle encoded URI and it matches the expected URI XCTAssertEqual(input.uri, uri) @@ -88,7 +88,7 @@ final class WalletConnectURITests: XCTestCase { // Create a URI string with an expired timestamp let expiredTimestamp = UInt64(Date().timeIntervalSince1970) - 300 // 5 minutes in the past let expiredURIString = "wc:\(input.uri.topic)@\(input.uri.version)?symKey=\(input.uri.symKey)&relay-protocol=\(input.uri.relay.protocol)&expiryTimestamp=\(expiredTimestamp)" - XCTAssertThrowsError(try WalletConnectURI(string: expiredURIString)) + XCTAssertThrowsError(try WalletConnectURI(uriString: expiredURIString)) } // Test compatibility with old clients that don't include expiryTimestamp in their uri @@ -96,7 +96,7 @@ final class WalletConnectURITests: XCTestCase { let input = stubURI().string // Remove expiryTimestamp from the URI string let uriStringWithoutExpiry = input.replacingOccurrences(of: "&expiryTimestamp=\(stubURI().uri.expiryTimestamp)", with: "") - let uri = try WalletConnectURI(string: uriStringWithoutExpiry) + let uri = try WalletConnectURI(uriString: uriStringWithoutExpiry) // Check if the expiryTimestamp is set to 5 minutes in the future let expectedExpiryTimestamp = UInt64(Date().timeIntervalSince1970) + 5 * 60 From e20094fd7b42529215eef8cbf4dc2ebe30b43386 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 11:02:43 +0100 Subject: [PATCH 253/814] fix crash --- .../Modules/Sign/SessionAccount/SessionAccountPresenter.swift | 2 ++ .../DApp/Modules/Sign/SessionAccount/SessionAccountView.swift | 3 +-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 9d3fecad8..4320f535e 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -13,6 +13,7 @@ final class SessionAccountPresenter: ObservableObject { @Published var errorMessage = String.empty @Published var showRequestSent = false @Published var requesting = false + @Published var lastRequest: Request? private let interactor: SessionAccountInteractor @@ -49,6 +50,7 @@ final class SessionAccountPresenter: ObservableObject { do { await ActivityIndicatorManager.shared.start() try await Sign.instance.request(params: request) + lastRequest = request await ActivityIndicatorManager.shared.stop() requesting = true DispatchQueue.main.async { [weak self] in diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift index b4ee2a608..54824e886 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift @@ -231,8 +231,7 @@ struct SessionAccountView: View { Spacer() - let record = Sign.instance.getSessionRequestRecord(id: response.id)! - Text(record.request.method) + Text(presenter.lastRequest!.method) .font( Font.system(size: 14, weight: .medium) ) From 97eb2d933d2d4b1d52937c5e3c97c33ce6e5c685 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 11:39:55 +0100 Subject: [PATCH 254/814] remove getSessionRequestRecord --- Sources/WalletConnectSign/Sign/SignClient.swift | 6 ------ Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 1 - Sources/Web3Wallet/Web3WalletClient.swift | 6 ------ 3 files changed, 13 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index b1c16fcdf..06a69661e 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -327,12 +327,6 @@ public final class SignClient: SignClientProtocol { } } - /// - Parameter id: id of a wc_sessionRequest jsonrpc request - /// - Returns: json rpc record object for given id or nil if record for give id does not exits - public func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? { - return historyService.getSessionRequest(id: id) - } - /// Delete all stored data such as: pairings, sessions, keys /// /// - Note: Will unsubscribe from all topics diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index a58e35eb1..452ccbf3b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -29,5 +29,4 @@ public protocol SignClientProtocol { func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] - func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 4f26b76f0..9947245d3 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -225,12 +225,6 @@ public class Web3WalletClient { signClient.getPendingRequests(topic: topic) } - /// - Parameter id: id of a wc_sessionRequest jsonrpc request - /// - Returns: json rpc record object for given id or nil if record for give id does not exits - public func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? { - signClient.getSessionRequestRecord(id: id) - } - /// Query pending authentication requests /// - Returns: Pending authentication requests public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { From 9eb7a3d165e664d8136284af5bf0e4c366fe333c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 12:21:15 +0100 Subject: [PATCH 255/814] use expiry from uri in wcpairing --- .../xcschemes/WalletConnectPairing.xcscheme | 10 +++++ .../Services/App/AppPairService.swift | 5 ++- .../Types/WCPairing.swift | 39 ++++++++++--------- .../Stubs/WalletConnectURI+Stub.swift | 13 ------- .../AppPairActivationServiceTests.swift | 4 +- .../WCPairingTests.swift | 10 ++--- Tests/Web3WalletTests/Web3WalletTests.swift | 5 --- 7 files changed, 41 insertions(+), 45 deletions(-) delete mode 100644 Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectPairing.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectPairing.xcscheme index dc1c7488b..f4bd38aa8 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectPairing.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectPairing.xcscheme @@ -28,6 +28,16 @@ selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB" shouldUseLaunchSchemeArgsEnv = "YES"> + + + + WCPairing { WCPairing(topic: topic, relay: RelayProtocolOptions.stub(), peerMetadata: AppMetadata.stub(), isActive: isActive, expiryDate: expiryDate) } + + init(topic: String, relay: RelayProtocolOptions, peerMetadata: AppMetadata, isActive: Bool = false, requestReceived: Bool = false, expiryDate: Date) { + self.topic = topic + self.relay = relay + self.peerMetadata = peerMetadata + self.active = isActive + self.requestReceived = requestReceived + self.expiryDate = expiryDate + } +} + +extension WalletConnectURI { + public static func stub() -> WalletConnectURI { + WalletConnectURI( + topic: String.generateTopic(), + symKey: SymmetricKey().hexRepresentation, + relay: RelayProtocolOptions(protocol: "", data: nil) + ) + } } + #endif diff --git a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift deleted file mode 100644 index 67ee5dfe9..000000000 --- a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift +++ /dev/null @@ -1,13 +0,0 @@ -import WalletConnectKMS -import WalletConnectUtils - -extension WalletConnectURI { - - public static func stub(isController: Bool = false) -> WalletConnectURI { - WalletConnectURI( - topic: String.generateTopic(), - symKey: SymmetricKey().hexRepresentation, - relay: RelayProtocolOptions(protocol: "", data: nil) - ) - } -} diff --git a/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift b/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift index 9cfd39b60..601862ad6 100644 --- a/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift +++ b/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift @@ -22,8 +22,8 @@ final class AppPairActivationServiceTests: XCTestCase { } func testActivate() { - let topic = "topic" - let pairing = WCPairing(topic: topic) + let pairing = WCPairing(uri: WalletConnectURI.stub()) + let topic = pairing.topic let date = pairing.expiryDate storageMock.setPairing(pairing) diff --git a/Tests/WalletConnectPairingTests/WCPairingTests.swift b/Tests/WalletConnectPairingTests/WCPairingTests.swift index f180efee2..8565b5bfa 100644 --- a/Tests/WalletConnectPairingTests/WCPairingTests.swift +++ b/Tests/WalletConnectPairingTests/WCPairingTests.swift @@ -23,21 +23,21 @@ final class WCPairingTests: XCTestCase { } func testInitInactiveFromTopic() { - let pairing = WCPairing(topic: "") + let pairing = WCPairing(uri: WalletConnectURI.stub()) let inactiveExpiry = referenceDate.advanced(by: WCPairing.timeToLiveInactive) XCTAssertFalse(pairing.active) - XCTAssertEqual(pairing.expiryDate, inactiveExpiry) + XCTAssertEqual(pairing.expiryDate.timeIntervalSince1970, inactiveExpiry.timeIntervalSince1970, accuracy: 1) } func testInitInactiveFromURI() { let pairing = WCPairing(uri: WalletConnectURI.stub()) let inactiveExpiry = referenceDate.advanced(by: WCPairing.timeToLiveInactive) XCTAssertFalse(pairing.active) - XCTAssertEqual(pairing.expiryDate, inactiveExpiry) + XCTAssertEqual(pairing.expiryDate.timeIntervalSince1970, inactiveExpiry.timeIntervalSince1970, accuracy: 1) } func testUpdateExpiryForTopic() { - var pairing = WCPairing(topic: "") + var pairing = WCPairing(uri: WalletConnectURI.stub()) let activeExpiry = referenceDate.advanced(by: WCPairing.timeToLiveActive) try? pairing.updateExpiry() XCTAssertEqual(pairing.expiryDate, activeExpiry) @@ -51,7 +51,7 @@ final class WCPairingTests: XCTestCase { } func testActivateTopic() { - var pairing = WCPairing(topic: "") + var pairing = WCPairing(uri: WalletConnectURI.stub()) let activeExpiry = referenceDate.advanced(by: WCPairing.timeToLiveActive) XCTAssertFalse(pairing.active) pairing.activate() diff --git a/Tests/Web3WalletTests/Web3WalletTests.swift b/Tests/Web3WalletTests/Web3WalletTests.swift index 39165751d..520639d83 100644 --- a/Tests/Web3WalletTests/Web3WalletTests.swift +++ b/Tests/Web3WalletTests/Web3WalletTests.swift @@ -249,11 +249,6 @@ final class Web3WalletTests: XCTestCase { XCTAssertEqual(1, pendingRequests.count) } - func testSessionRequestRecordCalledAndNotNil() async { - let sessionRequestRecord = web3WalletClient.getSessionRequestRecord(id: .left("")) - XCTAssertNotNil(sessionRequestRecord) - } - func testAuthPendingRequestsCalledAndNotEmpty() async { let pendingRequests = try! web3WalletClient.getPendingRequests() XCTAssertEqual(1, pendingRequests.count) From f5dac534799b28981c1196e405042ce9d187800e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 16:00:58 +0100 Subject: [PATCH 256/814] not create a session when propose response fails --- .../Engine/Common/ApproveEngine.swift | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 6c5238dbb..899b384cc 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -108,13 +108,13 @@ final class ApproveEngine { let result = SessionType.ProposeResponse(relay: relay, responderPublicKey: selfPublicKey.hexRepresentation) let response = RPCResponse(id: payload.id, result: result) - async let proposeResponse: () = networkingInteractor.respond( + async let proposeResponseTask: () = networkingInteractor.respond( topic: payload.topic, response: response, protocolMethod: SessionProposeProtocolMethod() ) - async let settleRequest: () = settle( + async let settleRequestTask: WCSession = settle( topic: sessionTopic, proposal: proposal, namespaces: sessionNamespaces, @@ -122,8 +122,11 @@ final class ApproveEngine { pairingTopic: pairingTopic ) - _ = try await [proposeResponse, settleRequest] + _ = try await proposeResponseTask + let session: WCSession = try await settleRequestTask + sessionStore.setSession(session) + onSessionSettle?(session.publicRepresentation()) logger.debug("Session proposal response and settle request have been sent") proposalPayloadsStore.delete(forKey: proposerPubKey) @@ -140,6 +143,8 @@ final class ApproveEngine { throw Errors.proposalNotFound } + try await networkingInteractor.respondError(topic: payload.topic, requestId: payload.id, protocolMethod: SessionProposeProtocolMethod(), reason: reason) + if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, let pairing = pairingStore.getPairing(forTopic: pairingTopic), !pairing.active { @@ -149,11 +154,9 @@ final class ApproveEngine { proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) - try await networkingInteractor.respondError(topic: payload.topic, requestId: payload.id, protocolMethod: SessionProposeProtocolMethod(), reason: reason) - } - func settle(topic: String, proposal: SessionProposal, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil, pairingTopic: String) async throws { + func settle(topic: String, proposal: SessionProposal, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil, pairingTopic: String) async throws -> WCSession { guard let agreementKeys = kms.getAgreementSecret(for: topic) else { throw Errors.agreementMissingOrInvalid } @@ -191,7 +194,6 @@ final class ApproveEngine { logger.debug("Sending session settle request") - sessionStore.setSession(session) let protocolMethod = SessionSettleProtocolMethod() let request = RPCRequest(method: protocolMethod.method, params: settleParams) @@ -200,7 +202,7 @@ final class ApproveEngine { async let settleRequest: () = networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) _ = try await [settleRequest, subscription] - onSessionSettle?(session.publicRepresentation()) + return session } } From f0d60efae6d4e39dc4b62bd46111b01def8c215f Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 22 Jan 2024 19:52:33 +0300 Subject: [PATCH 257/814] Nullable icon and url parsing --- .../Types/DataStructures/NotifyMessage.swift | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift b/Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift index 6c88dfa7a..f34549757 100644 --- a/Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift +++ b/Sources/WalletConnectNotify/Types/DataStructures/NotifyMessage.swift @@ -13,13 +13,24 @@ public struct NotifyMessage: Codable, Equatable { return Date(milliseconds: sent_at) } - public init(id: String, title: String, body: String, icon: String, url: String, type: String, sentAt: Date) { + public init(id: String, title: String, body: String, icon: String?, url: String?, type: String, sentAt: Date) { self.id = id self.title = title self.body = body - self.icon = icon - self.url = url + self.icon = icon ?? "" + self.url = url ?? "" self.type = type self.sent_at = UInt64(sentAt.millisecondsSince1970) } + + public init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + self.id = try container.decode(String.self, forKey: .id) + self.title = try container.decode(String.self, forKey: .title) + self.body = try container.decode(String.self, forKey: .body) + self.icon = try container.decodeIfPresent(String.self, forKey: .icon) ?? "" + self.url = try container.decodeIfPresent(String.self, forKey: .url) ?? "" + self.type = try container.decode(String.self, forKey: .type) + self.sent_at = try container.decode(UInt64.self, forKey: .sent_at) + } } From 5f8ab6263d395cab492735b7008233599aa7f77b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 18:46:42 +0100 Subject: [PATCH 258/814] add localised description --- .../RPCHistory/RPCHistory.swift | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index b310586d0..274122c3d 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -15,14 +15,29 @@ public final class RPCHistory { public var timestamp: Date? } - enum HistoryError: Error { + enum HistoryError: Error, LocalizedError { case unidentifiedRequest case unidentifiedResponse case requestDuplicateNotAllowed case responseDuplicateNotAllowed case requestMatchingResponseNotFound + var errorDescription: String? { + switch self { + case .unidentifiedRequest: + return "Unidentified request." + case .unidentifiedResponse: + return "Unidentified response." + case .requestDuplicateNotAllowed: + return "Request duplicates are not allowed." + case .responseDuplicateNotAllowed: + return "Response duplicates are not allowed." + case .requestMatchingResponseNotFound: + return "Matching requesr for the response not found." + } + } } + private let storage: CodableStore init(keyValueStore: CodableStore) { From 93d132c813ca8d9e38a1c3c33cd8036e6da3f00f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 18:52:06 +0100 Subject: [PATCH 259/814] dismiss proposal on pairing expiry --- .../Wallet/SessionProposal/SessionProposalPresenter.swift | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 5e40120f1..3730951c1 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -80,6 +80,14 @@ private extension SessionProposalPresenter { dismiss() } }.store(in: &disposeBag) + + Web3Wallet.instance.pairingExpirationPublisher + .receive(on: DispatchQueue.main) + .sink {[weak self] pairing in + if self?.sessionProposal.pairingTopic == pairing.topic { + self?.dismiss() + } + }.store(in: &disposeBag) } } From bff243f00fcb66172c6120d7938c6fa7f7adcd9c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jan 2024 19:25:10 +0100 Subject: [PATCH 260/814] show alerts on pairing expiry --- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 1 + Sources/WalletConnectUtils/WalletConnectURI.swift | 6 +++--- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 6b32b28ef..e9a133d89 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -53,6 +53,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio try await Web3Wallet.instance.pair(uri: uri) } } catch { + AlertPresenter.present(message: error.localizedDescription, type: .error) print("Error initializing WalletConnectURI: \(error.localizedDescription)") } } diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 7195bb19f..5cc42eaf0 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -12,7 +12,7 @@ public struct WalletConnectURI: Equatable { public let expiryTimestamp: UInt64 public var absoluteString: String { - return "wc:\(topic)@\(version)?symKey=\(symKey)&\(relayQuery)&expiryTimestamp=\(fiveMinutesFromNow)" + return "wc:\(topic)@\(version)?symKey=\(symKey)&\(relayQuery)&expiryTimestamp=\(expiryTimestamp)" } public var deeplinkUri: String { @@ -102,9 +102,9 @@ extension WalletConnectURI.Errors: LocalizedError { public var errorDescription: String? { switch self { case .expired: - return NSLocalizedString("The URI has expired.", comment: "Expired URI Error") + return NSLocalizedString("The WalletConnect Pairing URI has expired.", comment: "Expired URI Error") case .invalidFormat: - return NSLocalizedString("The format of the URI is invalid.", comment: "Invalid Format URI Error") + return NSLocalizedString("The format of the WalletConnect Pairing URI is invalid.", comment: "Invalid Format URI Error") } } } From abe3f153534823a448526149bc793d64722e39a0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 08:13:57 +0100 Subject: [PATCH 261/814] savepoint --- .../Sign/SessionAccount/SessionAccountView.swift | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift index 54824e886..939a9edb6 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountView.swift @@ -230,13 +230,14 @@ struct SessionAccountView: View { .padding(12) Spacer() - - Text(presenter.lastRequest!.method) - .font( - Font.system(size: 14, weight: .medium) - ) - .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - .padding(12) + if let lastRequest = presenter.lastRequest { + Text(lastRequest.method) + .font( + Font.system(size: 14, weight: .medium) + ) + .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) + .padding(12) + } } ZStack { From bce0e68fc6edcf058a583578c21e9ad5d2484b11 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 08:39:22 +0100 Subject: [PATCH 262/814] refactor activityindicator --- .../Common/ActivityIndicatorManager.swift | 45 +++++++++++-------- .../Common/ActivityIndicatorManager.swift | 45 +++++++++++-------- .../ConnectionDetailsPresenter.swift | 6 +-- .../SessionProposalPresenter.swift | 12 ++--- .../SessionRequestPresenter.swift | 12 ++--- .../Wallet/Wallet/WalletPresenter.swift | 6 +-- 6 files changed, 70 insertions(+), 56 deletions(-) diff --git a/Example/DApp/Common/ActivityIndicatorManager.swift b/Example/DApp/Common/ActivityIndicatorManager.swift index 500731651..f17183296 100644 --- a/Example/DApp/Common/ActivityIndicatorManager.swift +++ b/Example/DApp/Common/ActivityIndicatorManager.swift @@ -3,34 +3,41 @@ import UIKit class ActivityIndicatorManager { static let shared = ActivityIndicatorManager() private var activityIndicator: UIActivityIndicatorView? + private let serialQueue = DispatchQueue(label: "com.yourapp.activityIndicatorManager") private init() {} - func start() async { - await stop() + func start() { + serialQueue.async { + self.stopInternal { + DispatchQueue.main.async { + guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, + let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } - DispatchQueue.main.async { - guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, - let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } + let activityIndicator = UIActivityIndicatorView(style: .large) + activityIndicator.center = window.center + activityIndicator.color = .white + activityIndicator.startAnimating() + window.addSubview(activityIndicator) - let activityIndicator = UIActivityIndicatorView(style: .large) - activityIndicator.center = window.center - activityIndicator.color = .white - activityIndicator.startAnimating() - window.addSubview(activityIndicator) + self.activityIndicator = activityIndicator + } + } + } + } - self.activityIndicator = activityIndicator + func stop() { + serialQueue.async { + self.stopInternal(completion: nil) } } - func stop() async { - await withCheckedContinuation { continuation in - DispatchQueue.main.async { - self.activityIndicator?.stopAnimating() - self.activityIndicator?.removeFromSuperview() - self.activityIndicator = nil - continuation.resume() - } + private func stopInternal(completion: (() -> Void)?) { + DispatchQueue.main.async { + self.activityIndicator?.stopAnimating() + self.activityIndicator?.removeFromSuperview() + self.activityIndicator = nil + completion?() } } } diff --git a/Example/WalletApp/Common/ActivityIndicatorManager.swift b/Example/WalletApp/Common/ActivityIndicatorManager.swift index 9382be8a3..79b8785e0 100644 --- a/Example/WalletApp/Common/ActivityIndicatorManager.swift +++ b/Example/WalletApp/Common/ActivityIndicatorManager.swift @@ -1,35 +1,42 @@ import UIKit - class ActivityIndicatorManager { static let shared = ActivityIndicatorManager() private var activityIndicator: UIActivityIndicatorView? + private let serialQueue = DispatchQueue(label: "com.yourapp.activityIndicatorManager") private init() {} - func start() async { - await stop() + func start() { + serialQueue.async { + self.stopInternal { + DispatchQueue.main.async { + guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, + let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } - DispatchQueue.main.async { - guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, - let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } + let activityIndicator = UIActivityIndicatorView(style: .large) + activityIndicator.center = window.center + activityIndicator.color = .white + activityIndicator.startAnimating() + window.addSubview(activityIndicator) - let activityIndicator = UIActivityIndicatorView(style: .large) - activityIndicator.center = window.center - activityIndicator.startAnimating() - window.addSubview(activityIndicator) + self.activityIndicator = activityIndicator + } + } + } + } - self.activityIndicator = activityIndicator + func stop() { + serialQueue.async { + self.stopInternal(completion: nil) } } - func stop() async { - await withCheckedContinuation { continuation in - DispatchQueue.main.async { - self.activityIndicator?.stopAnimating() - self.activityIndicator?.removeFromSuperview() - self.activityIndicator = nil - continuation.resume() - } + private func stopInternal(completion: (() -> Void)?) { + DispatchQueue.main.async { + self.activityIndicator?.stopAnimating() + self.activityIndicator?.removeFromSuperview() + self.activityIndicator = nil + completion?() } } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift index 7fdc893c5..8ba46dc19 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift @@ -25,14 +25,14 @@ final class ConnectionDetailsPresenter: ObservableObject { func onDelete() { Task { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await interactor.disconnectSession(session: session) - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() DispatchQueue.main.async { self.router.dismiss() } } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() print(error) } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift index 3730951c1..e494039a2 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalPresenter.swift @@ -35,12 +35,12 @@ final class SessionProposalPresenter: ObservableObject { @MainActor func onApprove() async throws { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() let showConnected = try await interactor.approve(proposal: sessionProposal, account: importAccount.account) showConnected ? showConnectedSheet.toggle() : router.dismiss() - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() } @@ -49,12 +49,12 @@ final class SessionProposalPresenter: ObservableObject { @MainActor func onReject() async throws { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await interactor.reject(proposal: sessionProposal) - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() router.dismiss() } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index bb72f3be7..17d2f9b49 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -43,12 +43,12 @@ final class SessionRequestPresenter: ObservableObject { @MainActor func onApprove() async throws { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() let showConnected = try await interactor.respondSessionRequest(sessionRequest: sessionRequest, importAccount: importAccount) showConnected ? showSignedSheet.toggle() : router.dismiss() - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() } @@ -57,12 +57,12 @@ final class SessionRequestPresenter: ObservableObject { @MainActor func onReject() async throws { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await interactor.respondError(sessionRequest: sessionRequest) - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() router.dismiss() } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() errorMessage = error.localizedDescription showError.toggle() } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift index 4fbd34253..0affd430f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletPresenter.swift @@ -94,11 +94,11 @@ final class WalletPresenter: ObservableObject { func removeSession(at indexSet: IndexSet) async { if let index = indexSet.first { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await interactor.disconnectSession(session: sessions[index]) - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() sessions = sessions AlertPresenter.present(message: error.localizedDescription, type: .error) } From 9c2a9dac33ec0a812457143e2f7e37f712ccdf72 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 08:48:10 +0100 Subject: [PATCH 263/814] savepoint --- .../SessionAccountPresenter.swift | 6 +++--- Example/DApp/Modules/Sign/SignPresenter.swift | 18 +++++++++--------- .../ApplicationLayer/SceneDelegate.swift | 1 - 3 files changed, 12 insertions(+), 13 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 4320f535e..4bfb41139 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -48,16 +48,16 @@ final class SessionAccountPresenter: ObservableObject { let request = try Request(topic: session.topic, method: method, params: requestParams, chainId: Blockchain(sessionAccount.chain)!, ttl: ttl) Task { do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await Sign.instance.request(params: request) lastRequest = request - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() requesting = true DispatchQueue.main.async { [weak self] in self?.openWallet() } } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() requesting = false showError.toggle() errorMessage = error.localizedDescription diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 9c3c9ecca..1c5194e2c 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -58,16 +58,16 @@ final class SignPresenter: ObservableObject { let uri = try await Pair.instance.create() walletConnectUri = uri do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await Sign.instance.connect( requiredNamespaces: Proposal.requiredNamespaces, optionalNamespaces: Proposal.optionalNamespaces, topic: uri.topic ) - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() router.presentNewPairing(walletConnectUri: uri) } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() } } } @@ -76,12 +76,12 @@ final class SignPresenter: ObservableObject { if let session { Task { @MainActor in do { - await ActivityIndicatorManager.shared.start() + ActivityIndicatorManager.shared.start() try await Sign.instance.disconnect(topic: session.topic) - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() accountsDetails.removeAll() } catch { - await ActivityIndicatorManager.shared.stop() + ActivityIndicatorManager.shared.stop() showError.toggle() errorMessage = error.localizedDescription } @@ -114,21 +114,21 @@ extension SignPresenter { .sink { [unowned self] _ in self.accountsDetails.removeAll() router.popToRoot() - Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + Task(priority: .high) { ActivityIndicatorManager.shared.stop() } } .store(in: &subscriptions) Sign.instance.sessionResponsePublisher .receive(on: DispatchQueue.main) .sink { response in - Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + Task(priority: .high) { ActivityIndicatorManager.shared.stop() } } .store(in: &subscriptions) Sign.instance.requestExpirationPublisher .receive(on: DispatchQueue.main) .sink { _ in - Task(priority: .high) { await ActivityIndicatorManager.shared.stop() } + Task(priority: .high) { ActivityIndicatorManager.shared.stop() } AlertPresenter.present(message: "Session Request has expired", type: .warning) } .store(in: &subscriptions) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index e9a133d89..6b32b28ef 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -53,7 +53,6 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio try await Web3Wallet.instance.pair(uri: uri) } } catch { - AlertPresenter.present(message: error.localizedDescription, type: .error) print("Error initializing WalletConnectURI: \(error.localizedDescription)") } } From cd0f67fe633ac1937d42c1d1fcbd5e5fb28e86e5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 09:36:18 +0100 Subject: [PATCH 264/814] add review suggestions --- .../Common/ActivityIndicatorManager.swift | 33 +++++++++--------- .../SessionAccountPresenter.swift | 2 +- .../Common/ActivityIndicatorManager.swift | 34 +++++++++---------- .../Common/PendingProposalsProvider.swift | 29 ++++++++++++---- .../WalletConnectSign/Sign/SignClient.swift | 4 +++ .../Sign/SignClientProtocol.swift | 2 ++ Sources/Web3Wallet/Web3WalletClient.swift | 4 +++ .../Mocks/SignClientMock.swift | 4 +++ 8 files changed, 70 insertions(+), 42 deletions(-) diff --git a/Example/DApp/Common/ActivityIndicatorManager.swift b/Example/DApp/Common/ActivityIndicatorManager.swift index f17183296..2405ea052 100644 --- a/Example/DApp/Common/ActivityIndicatorManager.swift +++ b/Example/DApp/Common/ActivityIndicatorManager.swift @@ -9,35 +9,34 @@ class ActivityIndicatorManager { func start() { serialQueue.async { - self.stopInternal { - DispatchQueue.main.async { - guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, - let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } - - let activityIndicator = UIActivityIndicatorView(style: .large) - activityIndicator.center = window.center - activityIndicator.color = .white - activityIndicator.startAnimating() - window.addSubview(activityIndicator) - - self.activityIndicator = activityIndicator - } + self.stopInternal() + + DispatchQueue.main.async { + guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, + let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } + + let activityIndicator = UIActivityIndicatorView(style: .large) + activityIndicator.center = window.center + activityIndicator.color = .white + activityIndicator.startAnimating() + window.addSubview(activityIndicator) + + self.activityIndicator = activityIndicator } } } func stop() { serialQueue.async { - self.stopInternal(completion: nil) + self.stopInternal() } } - private func stopInternal(completion: (() -> Void)?) { - DispatchQueue.main.async { + private func stopInternal() { + DispatchQueue.main.sync { self.activityIndicator?.stopAnimating() self.activityIndicator?.removeFromSuperview() self.activityIndicator = nil - completion?() } } } diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 4bfb41139..31920ce46 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -13,7 +13,7 @@ final class SessionAccountPresenter: ObservableObject { @Published var errorMessage = String.empty @Published var showRequestSent = false @Published var requesting = false - @Published var lastRequest: Request? + var lastRequest: Request? private let interactor: SessionAccountInteractor diff --git a/Example/WalletApp/Common/ActivityIndicatorManager.swift b/Example/WalletApp/Common/ActivityIndicatorManager.swift index 79b8785e0..2405ea052 100644 --- a/Example/WalletApp/Common/ActivityIndicatorManager.swift +++ b/Example/WalletApp/Common/ActivityIndicatorManager.swift @@ -1,4 +1,5 @@ import UIKit + class ActivityIndicatorManager { static let shared = ActivityIndicatorManager() private var activityIndicator: UIActivityIndicatorView? @@ -8,35 +9,34 @@ class ActivityIndicatorManager { func start() { serialQueue.async { - self.stopInternal { - DispatchQueue.main.async { - guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, - let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } - - let activityIndicator = UIActivityIndicatorView(style: .large) - activityIndicator.center = window.center - activityIndicator.color = .white - activityIndicator.startAnimating() - window.addSubview(activityIndicator) - - self.activityIndicator = activityIndicator - } + self.stopInternal() + + DispatchQueue.main.async { + guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene, + let window = windowScene.windows.first(where: { $0.isKeyWindow }) else { return } + + let activityIndicator = UIActivityIndicatorView(style: .large) + activityIndicator.center = window.center + activityIndicator.color = .white + activityIndicator.startAnimating() + window.addSubview(activityIndicator) + + self.activityIndicator = activityIndicator } } } func stop() { serialQueue.async { - self.stopInternal(completion: nil) + self.stopInternal() } } - private func stopInternal(completion: (() -> Void)?) { - DispatchQueue.main.async { + private func stopInternal() { + DispatchQueue.main.sync { self.activityIndicator?.stopAnimating() self.activityIndicator?.removeFromSuperview() self.activityIndicator = nil - completion?() } } } diff --git a/Sources/WalletConnectSign/Engine/Common/PendingProposalsProvider.swift b/Sources/WalletConnectSign/Engine/Common/PendingProposalsProvider.swift index 6bebd4e31..4af7e3808 100644 --- a/Sources/WalletConnectSign/Engine/Common/PendingProposalsProvider.swift +++ b/Sources/WalletConnectSign/Engine/Common/PendingProposalsProvider.swift @@ -2,11 +2,11 @@ import Foundation import Combine class PendingProposalsProvider { - + private let proposalPayloadsStore: CodableStore> private let verifyContextStore: CodableStore private var publishers = Set() - private let pendingProposalsPublisherSubject = PassthroughSubject<[(proposal: Session.Proposal, context: VerifyContext?)], Never>() + private let pendingProposalsPublisherSubject = CurrentValueSubject<[(proposal: Session.Proposal, context: VerifyContext?)], Never>([]) var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { return pendingProposalsPublisherSubject.eraseToAnyPublisher() @@ -18,17 +18,32 @@ class PendingProposalsProvider { { self.proposalPayloadsStore = proposalPayloadsStore self.verifyContextStore = verifyContextStore + updatePendingProposals() setUpPendingProposalsPublisher() } + private func updatePendingProposals() { + let proposalsWithVerifyContext = getPendingProposals() + pendingProposalsPublisherSubject.send(proposalsWithVerifyContext) + } + func setUpPendingProposalsPublisher() { proposalPayloadsStore.storeUpdatePublisher.sink { [unowned self] _ in - let proposals = proposalPayloadsStore.getAll() + updatePendingProposals() + }.store(in: &publishers) + } - let proposalsWithVerifyContext = proposals.map { ($0.request.publicRepresentation(pairingTopic: $0.topic), try? verifyContextStore.get(key: $0.request.proposer.publicKey)) - } - pendingProposalsPublisherSubject.send(proposalsWithVerifyContext) + private func getPendingProposals() -> [(proposal: Session.Proposal, context: VerifyContext?)] { + let proposals = proposalPayloadsStore.getAll() + return proposals.map { ($0.request.publicRepresentation(pairingTopic: $0.topic), try? verifyContextStore.get(key: $0.request.proposer.publicKey)) } + } - }.store(in: &publishers) + public func getPendingProposals(topic: String? = nil) -> [(proposal: Session.Proposal, context: VerifyContext?)] { + if let topic = topic { + return getPendingProposals().filter { $0.proposal.pairingTopic == topic } + } else { + return getPendingProposals() + } } + } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 06a69661e..9c4b5e14d 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -327,6 +327,10 @@ public final class SignClient: SignClientProtocol { } } + public func getPendingProposals(topic: String? = nil) -> [(proposal: Session.Proposal, context: VerifyContext?)] { + pendingProposalsProvider.getPendingProposals() + } + /// Delete all stored data such as: pairings, sessions, keys /// /// - Note: Will unsubscribe from all topics diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 452ccbf3b..4aecfac04 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -29,4 +29,6 @@ public protocol SignClientProtocol { func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] + func getPendingProposals(topic: String?) -> [(proposal: Session.Proposal, context: VerifyContext?)] } + diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 9947245d3..0930b8443 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -225,6 +225,10 @@ public class Web3WalletClient { signClient.getPendingRequests(topic: topic) } + public func getPendingProposals(topic: String? = nil) -> [(proposal: Session.Proposal, context: VerifyContext?)] { + signClient.getPendingProposals(topic: topic) + } + /// Query pending authentication requests /// - Returns: Pending authentication requests public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index 4d74e4b47..65b63b9c3 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -145,6 +145,10 @@ final class SignClientMock: SignClientProtocol { return [WalletConnectSign.Session(topic: "", pairingTopic: "", peer: metadata, requiredNamespaces: [:], namespaces: [:], sessionProperties: nil, expiryDate: Date())] } + func getPendingProposals(topic: String?) -> [(proposal: WalletConnectSign.Session.Proposal, context: VerifyContext?)] { + return [] + } + func getPendingRequests(topic: String?) -> [(request: WalletConnectSign.Request, context: WalletConnectSign.VerifyContext?)] { return [(request, nil)] } From 5fdb29aa7223bca24912e66a12ad57908dce7944 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 10:27:27 +0100 Subject: [PATCH 265/814] fix wc modal tests --- Sources/WalletConnectUtils/WalletConnectURI.swift | 12 ++++++++++++ .../Mocks/ModalSheetInteractorMock.swift | 4 ++-- .../ModalViewModelTests.swift | 10 +++++----- 3 files changed, 19 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectUtils/WalletConnectURI.swift b/Sources/WalletConnectUtils/WalletConnectURI.swift index 5cc42eaf0..4e8701b50 100644 --- a/Sources/WalletConnectUtils/WalletConnectURI.swift +++ b/Sources/WalletConnectUtils/WalletConnectURI.swift @@ -136,5 +136,17 @@ extension WalletConnectURI { } } } +#endif +#if DEBUG +extension WalletConnectURI { + init(topic: String, symKey: String, relay: RelayProtocolOptions, expiryTimestamp: UInt64) { + self.version = "2" + self.topic = topic + self.symKey = symKey + self.relay = relay + self.expiryTimestamp = expiryTimestamp + } + +} #endif diff --git a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift index 182e50d0f..bfc9a34b6 100644 --- a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift +++ b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift @@ -1,7 +1,7 @@ import Combine import Foundation import WalletConnectSign -import WalletConnectUtils +@testable import WalletConnectUtils @testable import WalletConnectModal @testable import WalletConnectSign @@ -18,7 +18,7 @@ final class ModalSheetInteractorMock: ModalSheetInteractor { } func createPairingAndConnect() async throws -> WalletConnectURI? { - .init(topic: "foo", symKey: "bar", relay: .init(protocol: "irn", data: nil)) + .init(topic: "foo", symKey: "bar", relay: .init(protocol: "irn", data: nil), expiryTimestamp: 1706001526) } var sessionSettlePublisher: AnyPublisher { diff --git a/Tests/WalletConnectModalTests/ModalViewModelTests.swift b/Tests/WalletConnectModalTests/ModalViewModelTests.swift index 55de25cc9..2b9fd7c89 100644 --- a/Tests/WalletConnectModalTests/ModalViewModelTests.swift +++ b/Tests/WalletConnectModalTests/ModalViewModelTests.swift @@ -82,7 +82,7 @@ final class ModalViewModelTests: XCTestCase { await sut.fetchWallets() await sut.createURI() - XCTAssertEqual(sut.uri, "wc:foo@2?symKey=bar&relay-protocol=irn") + XCTAssertEqual(sut.uri, "wc:foo@2?symKey=bar&relay-protocol=irn&expiryTimestamp=1706001526") XCTAssertEqual(sut.wallets.count, 2) XCTAssertEqual(sut.wallets.map(\.id), ["1", "2"]) XCTAssertEqual(sut.wallets.map(\.name), ["Sample App", "Awesome App"]) @@ -94,7 +94,7 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual( openURLFuncTest.currentValue, - URL(string: "https://example.com/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn")! + URL(string: "https://example.com/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! ) expectation = XCTestExpectation(description: "Wait for openUrl to be called using universal link") @@ -104,7 +104,7 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual( openURLFuncTest.currentValue, - URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn")! + URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! ) expectation = XCTestExpectation(description: "Wait for openUrl to be called using native link") @@ -114,7 +114,7 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual( openURLFuncTest.currentValue, - URL(string: "https://awesome.com/awesome/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn")! + URL(string: "https://awesome.com/awesome/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! ) expectation = XCTestExpectation(description: "Wait for openUrl to be called using native link") @@ -124,7 +124,7 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual( openURLFuncTest.currentValue, - URL(string: "https://awesome.com/awesome/desktop/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn")! + URL(string: "https://awesome.com/awesome/desktop/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! ) } } From 3e9b7fc6b3e37d3c139ce6c8eabf3054b4e9d896 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 10:34:26 +0100 Subject: [PATCH 266/814] fix sign tests --- Tests/WalletConnectSignTests/ApproveEngineTests.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index d40aee9dc..c840d0ad0 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -80,6 +80,7 @@ final class ApproveEngineTests: XCTestCase { XCTAssertTrue(networkingInteractor.didCallSubscribe) XCTAssert(cryptoMock.hasAgreementSecret(for: topicB), "Responder must store agreement key for topic B") XCTAssertEqual(networkingInteractor.didRespondOnTopic!, topicA, "Responder must respond on topic A") + XCTAssertTrue(sessionStorageMock.hasSession(forTopic: topicB), "Responder must persist session on topic B") XCTAssertTrue(pairingRegisterer.isActivateCalled) } @@ -105,8 +106,7 @@ final class ApproveEngineTests: XCTestCase { let topicB = String.generateTopic() cryptoMock.setAgreementSecret(agreementKeys, topic: topicB) let proposal = SessionProposal.stub(proposerPubKey: AgreementPrivateKey().publicKey.hexRepresentation) - try await engine.settle(topic: topicB, proposal: proposal, namespaces: SessionNamespace.stubDictionary(), pairingTopic: "") - XCTAssertTrue(sessionStorageMock.hasSession(forTopic: topicB), "Responder must persist session on topic B") + _ = try await engine.settle(topic: topicB, proposal: proposal, namespaces: SessionNamespace.stubDictionary(), pairingTopic: "") XCTAssert(networkingInteractor.didSubscribe(to: topicB), "Responder must subscribe for topic B") XCTAssertTrue(networkingInteractor.didCallRequest, "Responder must send session settle payload on topic B") } From 3ac1823941ecb7d2fcac7287db42b969c33d69bf Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 13:22:31 +0300 Subject: [PATCH 267/814] testFetchHistory stability --- Example/IntegrationTests/Push/NotifyTests.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index fe1125fa9..5644fcd89 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -273,7 +273,7 @@ final class NotifyTests: XCTestCase { await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) try await walletNotifyClientA.fetchHistory(subscription: subscription) - XCTAssertEqual(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count, 41) + XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count > 40) } } From bb2f36db277a5fcd1ff9949395749bab33635af6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jan 2024 11:33:16 +0100 Subject: [PATCH 268/814] fix compatibility issue --- .../WalletConnectSign/Engine/Common/SessionEngine.swift | 4 ++-- Sources/WalletConnectSign/Request.swift | 8 ++++---- Sources/WalletConnectSign/Services/HistoryService.swift | 2 +- Sources/WalletConnectSign/SignDecryptionService.swift | 2 +- Sources/WalletConnectSign/Types/Session/SessionType.swift | 2 +- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 9d252423f..9d0c034f6 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -63,7 +63,7 @@ final class SessionEngine { guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { throw WalletConnectError.invalidPermissions } - let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiry: request.expiryTimestamp) + let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) let ttl = try request.calculateTtl() let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) @@ -229,7 +229,7 @@ private extension SessionEngine { method: payload.request.request.method, params: payload.request.request.params, chainId: payload.request.chainId, - expiry: payload.request.request.expiry + expiryTimestamp: payload.request.request.expiryTimestamp ) guard let session = sessionStore.getSession(forTopic: topic) else { return respondError(payload: payload, reason: .noSessionForTopic, protocolMethod: protocolMethod) diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index f5404ec0b..3898d45df 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -30,7 +30,7 @@ public struct Request: Codable, Equatable { } let calculatedExpiry = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) - self.init(id: RPCID(JsonRpcID.generate()), topic: topic, method: method, params: params, chainId: chainId, expiry: calculatedExpiry) + self.init(id: RPCID(JsonRpcID.generate()), topic: topic, method: method, params: params, chainId: chainId, expiryTimestamp: calculatedExpiry) } init(id: RPCID, topic: String, method: String, params: C, chainId: Blockchain, ttl: TimeInterval = 300) throws where C: Codable { @@ -39,16 +39,16 @@ public struct Request: Codable, Equatable { } let calculatedExpiry = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) - self.init(id: id, topic: topic, method: method, params: AnyCodable(params), chainId: chainId, expiry: calculatedExpiry) + self.init(id: id, topic: topic, method: method, params: AnyCodable(params), chainId: chainId, expiryTimestamp: calculatedExpiry) } - internal init(id: RPCID, topic: String, method: String, params: AnyCodable, chainId: Blockchain, expiry: UInt64?) { + internal init(id: RPCID, topic: String, method: String, params: AnyCodable, chainId: Blockchain, expiryTimestamp: UInt64?) { self.id = id self.topic = topic self.method = method self.params = params self.chainId = chainId - self.expiryTimestamp = expiry + self.expiryTimestamp = expiryTimestamp } func isExpired(currentDate: Date = Date()) -> Bool { diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index 95129d427..a34f52bb5 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -50,7 +50,7 @@ private extension HistoryService { method: request.request.method, params: request.request.params, chainId: request.chainId, - expiry: request.request.expiry + expiryTimestamp: request.request.expiryTimestamp ) return (mappedRequest, record.id) diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index 8b0e82125..588d07337 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -37,7 +37,7 @@ public class SignDecryptionService { method: request.request.method, params: request.request.params, chainId: request.chainId, - expiry: request.request.expiry + expiryTimestamp: request.request.expiryTimestamp ) return request diff --git a/Sources/WalletConnectSign/Types/Session/SessionType.swift b/Sources/WalletConnectSign/Types/Session/SessionType.swift index cc838f084..d4411aa9a 100644 --- a/Sources/WalletConnectSign/Types/Session/SessionType.swift +++ b/Sources/WalletConnectSign/Types/Session/SessionType.swift @@ -43,7 +43,7 @@ internal enum SessionType { struct Request: Codable, Equatable { let method: String let params: AnyCodable - let expiry: UInt64? + let expiryTimestamp: UInt64? } } From a05be877ef7a744bcb8dabc96cb573fb0620de76 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 14:06:09 +0300 Subject: [PATCH 269/814] NetworkMonitor in Dispatcher --- .../NetworkingInteractor.swift | 5 +---- Sources/WalletConnectRelay/Dispatching.swift | 16 ++++++++++++---- .../WalletConnectRelay/NetworkMonitoring.swift | 7 ++++++- Sources/WalletConnectRelay/RelayClient.swift | 4 ++++ .../WalletConnectRelay/RelayClientFactory.swift | 8 +++++++- 5 files changed, 30 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index 078c8adf7..08ace2bdb 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -30,8 +30,6 @@ public class NetworkingInteractor: NetworkInteracting { public var networkConnectionStatusPublisher: AnyPublisher public var socketConnectionStatusPublisher: AnyPublisher - private let networkMonitor: NetworkMonitoring - public init( relayClient: RelayClient, serializer: Serializing, @@ -43,8 +41,7 @@ public class NetworkingInteractor: NetworkInteracting { self.rpcHistory = rpcHistory self.logger = logger self.socketConnectionStatusPublisher = relayClient.socketConnectionStatusPublisher - self.networkMonitor = NetworkMonitor() - self.networkConnectionStatusPublisher = networkMonitor.networkConnectionStatusPublisher + self.networkConnectionStatusPublisher = relayClient.networkConnectionStatusPublisher setupRelaySubscribtion() } diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index bf3ef2c92..9327608e6 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -3,6 +3,7 @@ import Combine protocol Dispatching { var onMessage: ((String) -> Void)? { get set } + var networkConnectionStatusPublisher: AnyPublisher { get } var socketConnectionStatusPublisher: AnyPublisher { get } func send(_ string: String, completion: @escaping (Error?) -> Void) func protectedSend(_ string: String, completion: @escaping (Error?) -> Void) @@ -17,8 +18,9 @@ final class Dispatcher: NSObject, Dispatching { var socketConnectionHandler: SocketConnectionHandler private let relayUrlFactory: RelayUrlFactory + private let networkMonitor: NetworkMonitoring private let logger: ConsoleLogging - + private let defaultTimeout: Int = 5 /// The property is used to determine whether relay.walletconnect.org will be used /// in case relay.walletconnect.com doesn't respond for some reason (most likely due to being blocked in the user's location). @@ -30,15 +32,21 @@ final class Dispatcher: NSObject, Dispatching { socketConnectionStatusPublisherSubject.eraseToAnyPublisher() } + var networkConnectionStatusPublisher: AnyPublisher { + networkMonitor.networkConnectionStatusPublisher + } + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.dispatcher", attributes: .concurrent) init( socketFactory: WebSocketFactory, relayUrlFactory: RelayUrlFactory, + networkMonitor: NetworkMonitoring, socketConnectionType: SocketConnectionType, logger: ConsoleLogging ) { self.relayUrlFactory = relayUrlFactory + self.networkMonitor = networkMonitor self.logger = logger let socket = socketFactory.create(with: relayUrlFactory.create(fallback: fallback)) @@ -69,13 +77,13 @@ final class Dispatcher: NSObject, Dispatching { } func protectedSend(_ string: String, completion: @escaping (Error?) -> Void) { - guard !socket.isConnected else { + guard !socket.isConnected, !networkMonitor.isConnected else { return send(string, completion: completion) } var cancellable: AnyCancellable? - cancellable = socketConnectionStatusPublisher - .filter { $0 == .connected } + cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) + .filter { $0.0 == .connected && $0.1 == .connected } .setFailureType(to: NetworkError.self) .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .webSocketNotConnected }) .sink(receiveCompletion: { [unowned self] result in diff --git a/Sources/WalletConnectRelay/NetworkMonitoring.swift b/Sources/WalletConnectRelay/NetworkMonitoring.swift index 1d3932db5..e6c6b4477 100644 --- a/Sources/WalletConnectRelay/NetworkMonitoring.swift +++ b/Sources/WalletConnectRelay/NetworkMonitoring.swift @@ -8,6 +8,7 @@ public enum NetworkConnectionStatus { } public protocol NetworkMonitoring: AnyObject { + var isConnected: Bool { get } var networkConnectionStatusPublisher: AnyPublisher { get } } @@ -16,7 +17,11 @@ public final class NetworkMonitor: NetworkMonitoring { private let workerQueue = DispatchQueue(label: "com.walletconnect.sdk.network.monitor") private let networkConnectionStatusPublisherSubject = CurrentValueSubject(.connected) - + + public var isConnected: Bool { + return networkConnectionStatusPublisherSubject.value == .connected + } + public var networkConnectionStatusPublisher: AnyPublisher { networkConnectionStatusPublisherSubject .share() diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 24cae47c0..3febc4c60 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -27,6 +27,10 @@ public final class RelayClient { dispatcher.socketConnectionStatusPublisher } + public var networkConnectionStatusPublisher: AnyPublisher { + dispatcher.networkConnectionStatusPublisher + } + private let messagePublisherSubject = PassthroughSubject<(topic: String, message: String, publishedAt: Date), Never>() private let subscriptionResponsePublisherSubject = PassthroughSubject<(RPCID?, [String]), Never>() diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 98066e6c8..b59a50d29 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -20,6 +20,8 @@ public struct RelayClientFactory { let logger = ConsoleLogger(prefix: "🚄" ,loggingLevel: .off) + let networkMonitor = NetworkMonitor() + return RelayClientFactory.create( relayHost: relayHost, projectId: projectId, @@ -27,6 +29,7 @@ public struct RelayClientFactory { keychainStorage: keychainStorage, socketFactory: socketFactory, socketConnectionType: socketConnectionType, + networkMonitor: networkMonitor, logger: logger ) } @@ -39,6 +42,7 @@ public struct RelayClientFactory { keychainStorage: KeychainStorageProtocol, socketFactory: WebSocketFactory, socketConnectionType: SocketConnectionType = .automatic, + networkMonitor: NetworkMonitoring, logger: ConsoleLogging ) -> RelayClient { @@ -52,9 +56,11 @@ public struct RelayClientFactory { projectId: projectId, socketAuthenticator: socketAuthenticator ) + let dispatcher = Dispatcher( socketFactory: socketFactory, - relayUrlFactory: relayUrlFactory, + relayUrlFactory: relayUrlFactory, + networkMonitor: networkMonitor, socketConnectionType: socketConnectionType, logger: logger ) From 6489245568a8a36f527b1aa627f61f199277ba5a Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 14:36:58 +0300 Subject: [PATCH 270/814] protectedSend logic fixed --- Sources/WalletConnectRelay/Dispatching.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 9327608e6..f32d7a5e8 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -77,7 +77,7 @@ final class Dispatcher: NSObject, Dispatching { } func protectedSend(_ string: String, completion: @escaping (Error?) -> Void) { - guard !socket.isConnected, !networkMonitor.isConnected else { + guard !socket.isConnected || !networkMonitor.isConnected else { return send(string, completion: completion) } From 8f54f0b5d02fd6740aeda118483ff1a6d7f9dc66 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 14:37:06 +0300 Subject: [PATCH 271/814] Integration tests repaired --- Example/IntegrationTests/Auth/AuthTests.swift | 1 + Example/IntegrationTests/Chat/ChatTests.swift | 1 + Example/IntegrationTests/Pairing/PairingTests.swift | 1 + Example/IntegrationTests/Push/NotifyTests.swift | 1 + Example/IntegrationTests/Sign/SignClientTests.swift | 1 + Example/IntegrationTests/Sync/SyncTests.swift | 1 + .../XPlatform/Web3Wallet/XPlatformW3WTests.swift | 1 + 7 files changed, 7 insertions(+) diff --git a/Example/IntegrationTests/Auth/AuthTests.swift b/Example/IntegrationTests/Auth/AuthTests.swift index 276e14e84..ab831899f 100644 --- a/Example/IntegrationTests/Auth/AuthTests.swift +++ b/Example/IntegrationTests/Auth/AuthTests.swift @@ -40,6 +40,7 @@ final class AuthTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: logger) let networkingClient = NetworkingClientFactory.create( diff --git a/Example/IntegrationTests/Chat/ChatTests.swift b/Example/IntegrationTests/Chat/ChatTests.swift index ff09c65f1..747bd29a3 100644 --- a/Example/IntegrationTests/Chat/ChatTests.swift +++ b/Example/IntegrationTests/Chat/ChatTests.swift @@ -56,6 +56,7 @@ final class ChatTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: logger) let networkingInteractor = NetworkingClientFactory.create( diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 6bc02014c..d9e83de6e 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -34,6 +34,7 @@ final class PairingTests: XCTestCase { keyValueStorage: RuntimeKeyValueStorage(), keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: logger) let networkingClient = NetworkingClientFactory.create( diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 5644fcd89..26400548c 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -45,6 +45,7 @@ final class NotifyTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: relayLogger) let networkingClient = NetworkingClientFactory.create( diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 28202a224..9e0fc6867 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -26,6 +26,7 @@ final class SignClientTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: logger ) diff --git a/Example/IntegrationTests/Sync/SyncTests.swift b/Example/IntegrationTests/Sync/SyncTests.swift index adcfdc532..5e19c1345 100644 --- a/Example/IntegrationTests/Sync/SyncTests.swift +++ b/Example/IntegrationTests/Sync/SyncTests.swift @@ -63,6 +63,7 @@ final class SyncTests: XCTestCase { keyValueStorage: RuntimeKeyValueStorage(), keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: logger) let networkingInteractor = NetworkingClientFactory.create( relayClient: relayClient, diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index 3d794d18a..c2f18b4c1 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -33,6 +33,7 @@ final class XPlatformW3WTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), logger: relayLogger ) From ff5a895561cb529d2fc13edfd1ff52e1bcbf959b Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 14:50:32 +0300 Subject: [PATCH 272/814] Relayer tests updated --- Tests/RelayerTests/DispatcherTests.swift | 4 +++- Tests/RelayerTests/Mocks/DispatcherMock.swift | 4 ++++ Tests/RelayerTests/Mocks/NetworkMonitoringMock.swift | 4 ++++ 3 files changed, 11 insertions(+), 1 deletion(-) diff --git a/Tests/RelayerTests/DispatcherTests.swift b/Tests/RelayerTests/DispatcherTests.swift index 8d86455df..331bd640d 100644 --- a/Tests/RelayerTests/DispatcherTests.swift +++ b/Tests/RelayerTests/DispatcherTests.swift @@ -62,6 +62,7 @@ final class DispatcherTests: XCTestCase { networkMonitor = NetworkMonitoringMock() let defaults = RuntimeKeyValueStorage() let logger = ConsoleLoggerMock() + let networkMonitor = NetworkMonitoringMock() let keychainStorageMock = DispatcherKeychainStorageMock() let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychainStorageMock, logger: logger) let socketAuthenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) @@ -72,7 +73,8 @@ final class DispatcherTests: XCTestCase { ) sut = Dispatcher( socketFactory: webSocketFactory, - relayUrlFactory: relayUrlFactory, + relayUrlFactory: relayUrlFactory, + networkMonitor: networkMonitor, socketConnectionType: .manual, logger: ConsoleLoggerMock() ) diff --git a/Tests/RelayerTests/Mocks/DispatcherMock.swift b/Tests/RelayerTests/Mocks/DispatcherMock.swift index d5088bf61..869e3a0f9 100644 --- a/Tests/RelayerTests/Mocks/DispatcherMock.swift +++ b/Tests/RelayerTests/Mocks/DispatcherMock.swift @@ -4,11 +4,15 @@ import Combine @testable import WalletConnectRelay class DispatcherMock: Dispatching { + private var publishers = Set() private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) var socketConnectionStatusPublisher: AnyPublisher { return socketConnectionStatusPublisherSubject.eraseToAnyPublisher() } + var networkConnectionStatusPublisher: AnyPublisher { + return Just(.connected).eraseToAnyPublisher() + } var sent = false var lastMessage: String = "" diff --git a/Tests/RelayerTests/Mocks/NetworkMonitoringMock.swift b/Tests/RelayerTests/Mocks/NetworkMonitoringMock.swift index 1095d1677..bfbad58cf 100644 --- a/Tests/RelayerTests/Mocks/NetworkMonitoringMock.swift +++ b/Tests/RelayerTests/Mocks/NetworkMonitoringMock.swift @@ -4,6 +4,10 @@ import Combine @testable import WalletConnectRelay class NetworkMonitoringMock: NetworkMonitoring { + var isConnected: Bool { + return true + } + var networkConnectionStatusPublisher: AnyPublisher { networkConnectionStatusPublisherSubject.eraseToAnyPublisher() } From c8fd1670ffed79e807121d0192f48d9204b11769 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 15:05:06 +0300 Subject: [PATCH 273/814] RelayClientEndToEndTests repaired --- Example/RelayIntegrationTests/RelayClientEndToEndTests.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index 119a62901..4fee45c97 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -47,6 +47,7 @@ final class RelayClientEndToEndTests: XCTestCase { let dispatcher = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: urlFactory, + networkMonitor: NetworkMonitor(), socketConnectionType: .manual, logger: logger ) From e05bce532d97e0bf01e9a188f103976505d3fb37 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 15:42:01 +0300 Subject: [PATCH 274/814] Update RelayClientEndToEndTests.swift --- .../RelayIntegrationTests/RelayClientEndToEndTests.swift | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index 4fee45c97..3ac8d75b7 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -44,10 +44,11 @@ final class RelayClientEndToEndTests: XCTestCase { ) let socket = WebSocket(url: urlFactory.create(fallback: false)) let webSocketFactory = WebSocketFactoryMock(webSocket: socket) + let networkMonitor = NetworkMonitor() let dispatcher = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: urlFactory, - networkMonitor: NetworkMonitor(), + networkMonitor: networkMonitor, socketConnectionType: .manual, logger: logger ) @@ -58,7 +59,8 @@ final class RelayClientEndToEndTests: XCTestCase { keyValueStorage: keyValueStorage, keychainStorage: keychain, socketFactory: DefaultSocketFactory(), - socketConnectionType: .manual, + socketConnectionType: .manual, + networkMonitor: networkMonitor, logger: logger ) let clientId = try! relayClient.getClientId() From 14cbe5214e97139da89ca8469b9220921ce076fb Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 16:15:12 +0300 Subject: [PATCH 275/814] Unsubscribe optional completion --- Sources/WalletConnectRelay/RelayClient.swift | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 3febc4c60..5ff6135fd 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -169,9 +169,9 @@ public final class RelayClient { } } - public func unsubscribe(topic: String, completion: @escaping ((Error?) -> Void)) { + public func unsubscribe(topic: String, completion: ((Error?) -> Void)?) { guard let subscriptionId = subscriptions[topic] else { - completion(Errors.subscriptionIdNotFound) + completion?(Errors.subscriptionIdNotFound) return } logger.debug("Unsubscribing from topic: \(topic)") @@ -183,12 +183,12 @@ public final class RelayClient { dispatcher.protectedSend(message) { [weak self] error in if let error = error { self?.logger.debug("Failed to unsubscribe from topic") - completion(error) + completion?(error) } else { self?.concurrentQueue.async(flags: .barrier) { self?.subscriptions[topic] = nil } - completion(nil) + completion?(nil) } } } From 5774ada2e4673b7242b968537eaca91f0702cbe5 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 17:06:00 +0300 Subject: [PATCH 276/814] RPCHistory cleanup on error --- .../NetworkingInteractor.swift | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index 08ace2bdb..d086b8db8 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -202,8 +202,21 @@ public class NetworkingInteractor: NetworkInteracting { public func request(_ request: RPCRequest, topic: String, protocolMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType) async throws { try rpcHistory.set(request, forTopic: topic, emmitedBy: .local) - let message = try serializer.serialize(topic: topic, encodable: request, envelopeType: envelopeType) - try await relayClient.publish(topic: topic, payload: message, tag: protocolMethod.requestConfig.tag, prompt: protocolMethod.requestConfig.prompt, ttl: protocolMethod.requestConfig.ttl) + + do { + let message = try serializer.serialize(topic: topic, encodable: request, envelopeType: envelopeType) + + try await relayClient.publish(topic: topic, + payload: message, + tag: protocolMethod.requestConfig.tag, + prompt: protocolMethod.requestConfig.prompt, + ttl: protocolMethod.requestConfig.ttl) + } catch { + if let id = request.id { + rpcHistory.delete(id: id) + } + throw error + } } public func respond(topic: String, response: RPCResponse, protocolMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType) async throws { From 39085d52d16de98c027de3077ca30978bb15a638 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jan 2024 08:31:50 +0100 Subject: [PATCH 277/814] saveopint --- Example/WalletApp/Common/ActivityIndicatorManager.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/Common/ActivityIndicatorManager.swift b/Example/WalletApp/Common/ActivityIndicatorManager.swift index 2405ea052..9022a6f41 100644 --- a/Example/WalletApp/Common/ActivityIndicatorManager.swift +++ b/Example/WalletApp/Common/ActivityIndicatorManager.swift @@ -17,7 +17,7 @@ class ActivityIndicatorManager { let activityIndicator = UIActivityIndicatorView(style: .large) activityIndicator.center = window.center - activityIndicator.color = .white + activityIndicator.color = .blue activityIndicator.startAnimating() window.addSubview(activityIndicator) From ce749eb0f4b4b0b97f46babe28c2daa2840cdac9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jan 2024 08:41:57 +0100 Subject: [PATCH 278/814] add alert on uri expired --- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 6b32b28ef..ae9208eff 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -53,7 +53,11 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio try await Web3Wallet.instance.pair(uri: uri) } } catch { - print("Error initializing WalletConnectURI: \(error.localizedDescription)") + if case WalletConnectURI.Errors.expired = error { + AlertPresenter.present(message: error.localizedDescription, type: .error) + } else { + print("Error initializing WalletConnectURI: \(error.localizedDescription)") + } } } From 65aaf219404ff582f3134309b975be19bfbb6051 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jan 2024 09:25:50 +0100 Subject: [PATCH 279/814] fix build --- Tests/WalletConnectSignTests/SessionRequestTests.swift | 2 +- Tests/WalletConnectSignTests/Stub/Stubs.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/SessionRequestTests.swift b/Tests/WalletConnectSignTests/SessionRequestTests.swift index 10c70ea3a..3321f2fe1 100644 --- a/Tests/WalletConnectSignTests/SessionRequestTests.swift +++ b/Tests/WalletConnectSignTests/SessionRequestTests.swift @@ -65,7 +65,7 @@ private extension Request { method: "method", params: AnyCodable("params"), chainId: Blockchain("eip155:1")!, - expiry: expiry + expiryTimestamp: expiry ) } } diff --git a/Tests/WalletConnectSignTests/Stub/Stubs.swift b/Tests/WalletConnectSignTests/Stub/Stubs.swift index 9666beccf..9c5de2ccb 100644 --- a/Tests/WalletConnectSignTests/Stub/Stubs.swift +++ b/Tests/WalletConnectSignTests/Stub/Stubs.swift @@ -56,7 +56,7 @@ extension RPCRequest { static func stubRequest(method: String, chainId: Blockchain, expiry: UInt64? = nil) -> RPCRequest { let params = SessionType.RequestParams( - request: SessionType.RequestParams.Request(method: method, params: AnyCodable(EmptyCodable()), expiry: expiry), + request: SessionType.RequestParams.Request(method: method, params: AnyCodable(EmptyCodable()), expiryTimestamp: expiry), chainId: chainId) return RPCRequest(method: SessionRequestProtocolMethod().method, params: params) } From ea96e8d1d17097f4b9ed1c6686152b5af6fc2913 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jan 2024 09:32:39 +0100 Subject: [PATCH 280/814] fix tests build --- Tests/Web3WalletTests/Mocks/SignClientMock.swift | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index 65b63b9c3..f144ef727 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -22,7 +22,7 @@ final class SignClientMock: SignClientProtocol { var requestCalled = false private let metadata = AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) - private let request = WalletConnectSign.Request(id: .left(""), topic: "", method: "", params: AnyCodable(""), chainId: Blockchain("eip155:1")!, expiry: nil) + private let request = WalletConnectSign.Request(id: .left(""), topic: "", method: "", params: AnyCodable(""), chainId: Blockchain("eip155:1")!, expiryTimestamp: nil) private let response = WalletConnectSign.Response(id: RPCID(1234567890123456789), topic: "", chainId: "", result: .response(AnyCodable(any: ""))) var sessionProposalPublisher: AnyPublisher<(proposal: WalletConnectSign.Session.Proposal, context: VerifyContext?), Never> { @@ -152,11 +152,7 @@ final class SignClientMock: SignClientProtocol { func getPendingRequests(topic: String?) -> [(request: WalletConnectSign.Request, context: WalletConnectSign.VerifyContext?)] { return [(request, nil)] } - - func getSessionRequestRecord(id: JSONRPC.RPCID) -> (request: WalletConnectSign.Request, context: WalletConnectSign.VerifyContext?)? { - return (request, nil) - } - + func cleanup() async throws { cleanupCalled = true } From cb77784c0380f2f5026f8a05e2f3ca0dc24fc08a Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 24 Jan 2024 15:19:10 +0300 Subject: [PATCH 281/814] Common network error --- Sources/WalletConnectRelay/Dispatching.swift | 6 +++--- Sources/WalletConnectRelay/Misc/NetworkError.swift | 8 ++++---- Tests/RelayerTests/Helpers/Error+Extension.swift | 2 +- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index f32d7a5e8..efd932f70 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -68,7 +68,7 @@ final class Dispatcher: NSObject, Dispatching { func send(_ string: String, completion: @escaping (Error?) -> Void) { guard socket.isConnected else { - completion(NetworkError.webSocketNotConnected) + completion(NetworkError.connectionFailed) return } socket.write(string: string) { @@ -85,7 +85,7 @@ final class Dispatcher: NSObject, Dispatching { cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) .filter { $0.0 == .connected && $0.1 == .connected } .setFailureType(to: NetworkError.self) - .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .webSocketNotConnected }) + .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) .sink(receiveCompletion: { [unowned self] result in switch result { case .failure(let error): @@ -145,7 +145,7 @@ extension Dispatcher { } private func handleFallbackIfNeeded(error: NetworkError) { - if error == .webSocketNotConnected && socket.request.url?.host == NetworkConstants.defaultUrl { + if error == .connectionFailed && socket.request.url?.host == NetworkConstants.defaultUrl { logger.debug("[WebSocket] - Fallback to \(NetworkConstants.fallbackUrl)") fallback = true socket.request.url = relayUrlFactory.create(fallback: fallback) diff --git a/Sources/WalletConnectRelay/Misc/NetworkError.swift b/Sources/WalletConnectRelay/Misc/NetworkError.swift index f31340bbd..e0a66c2c1 100644 --- a/Sources/WalletConnectRelay/Misc/NetworkError.swift +++ b/Sources/WalletConnectRelay/Misc/NetworkError.swift @@ -1,13 +1,13 @@ import Foundation enum NetworkError: Error, Equatable { - case webSocketNotConnected + case connectionFailed case sendMessageFailed(Error) case receiveMessageFailure(Error) static func == (lhs: NetworkError, rhs: NetworkError) -> Bool { switch (lhs, rhs) { - case (.webSocketNotConnected, .webSocketNotConnected): return true + case (.connectionFailed, .connectionFailed): return true case (.sendMessageFailed, .sendMessageFailed): return true case (.receiveMessageFailure, .receiveMessageFailure): return true default: return false @@ -22,8 +22,8 @@ extension NetworkError: LocalizedError { var localizedDescription: String { switch self { - case .webSocketNotConnected: - return "Web socket is not connected to any URL." + case .connectionFailed: + return "Web socket is not connected to any URL or networking connection error" case .sendMessageFailed(let error): return "Failed to send a message through the web socket: \(error)" case .receiveMessageFailure(let error): diff --git a/Tests/RelayerTests/Helpers/Error+Extension.swift b/Tests/RelayerTests/Helpers/Error+Extension.swift index 901d2d829..76dd92672 100644 --- a/Tests/RelayerTests/Helpers/Error+Extension.swift +++ b/Tests/RelayerTests/Helpers/Error+Extension.swift @@ -24,7 +24,7 @@ extension Error { extension NetworkError { var isWebSocketError: Bool { - guard case .webSocketNotConnected = self else { return false } + guard case .connectionFailed = self else { return false } return true } From 2dce12f1c1ee1fa1b32cf6da5ae201b29ba436f2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jan 2024 15:15:23 +0100 Subject: [PATCH 282/814] remove dependency pairing dependency in notify --- Example/IntegrationTests/Push/NotifyTests.swift | 15 +++------------ Package.swift | 2 +- .../Client/Wallet/NotifyClientFactory.swift | 4 +--- Sources/WalletConnectNotify/Notify.swift | 1 - 4 files changed, 5 insertions(+), 17 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 26400548c..4673fe55d 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -8,7 +8,6 @@ import Combine import WalletConnectNetworking import WalletConnectPush @testable import WalletConnectNotify -@testable import WalletConnectPairing import WalletConnectIdentity import WalletConnectSigner @@ -30,12 +29,11 @@ final class NotifyTests: XCTestCase { private var publishers = Set() - func makeClientDependencies(prefix: String) -> (PairingClient, NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { + func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) - let pairingLogger = ConsoleLogger(prefix: prefix + " [Pairing]", loggingLevel: .debug) let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) @@ -55,19 +53,13 @@ final class NotifyTests: XCTestCase { keyValueStorage: keyValueStorage, kmsLogger: kmsLogger) - let pairingClient = PairingClientFactory.create( - logger: pairingLogger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient) - let clientId = try! networkingClient.getClientId() networkingLogger.debug("My client id is: \(clientId)") - return (pairingClient, networkingClient, keychain, keyValueStorage) + return (networkingClient, keychain, keyValueStorage) } func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { - let (pairingClient, networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) + let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) let pushClient = PushClientFactory.create(projectId: "", pushHost: "echo.walletconnect.com", @@ -84,7 +76,6 @@ final class NotifyTests: XCTestCase { keychainStorage: keychain, groupKeychainStorage: KeychainStorageMock(), networkInteractor: networkingInteractor, - pairingRegisterer: pairingClient, pushClient: pushClient, crypto: DefaultCryptoProvider(), notifyHost: InputConfig.notifyHost, diff --git a/Package.swift b/Package.swift index 3321d7eb7..d6d573c09 100644 --- a/Package.swift +++ b/Package.swift @@ -73,7 +73,7 @@ let package = Package( path: "Sources/Web3Wallet"), .target( name: "WalletConnectNotify", - dependencies: ["WalletConnectIdentity", "WalletConnectPairing", "WalletConnectPush", "WalletConnectSigner", "Database"], + dependencies: ["WalletConnectIdentity", "WalletConnectPush", "WalletConnectSigner", "Database"], path: "Sources/WalletConnectNotify"), .target( name: "WalletConnectPush", diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index ec417a765..676f37b5a 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -2,7 +2,7 @@ import Foundation public struct NotifyClientFactory { - public static func create(projectId: String, groupIdentifier: String, networkInteractor: NetworkInteracting, pairingRegisterer: PairingRegisterer, pushClient: PushClient, crypto: CryptoProvider, notifyHost: String, explorerHost: String) -> NotifyClient { + public static func create(projectId: String, groupIdentifier: String, networkInteractor: NetworkInteracting, pushClient: PushClient, crypto: CryptoProvider, notifyHost: String, explorerHost: String) -> NotifyClient { let logger = ConsoleLogger(prefix: "🔔",loggingLevel: .debug) let keyserverURL = URL(string: "https://keys.walletconnect.com")! let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) @@ -18,7 +18,6 @@ public struct NotifyClientFactory { keychainStorage: keychainStorage, groupKeychainStorage: groupKeychainService, networkInteractor: networkInteractor, - pairingRegisterer: pairingRegisterer, pushClient: pushClient, crypto: crypto, notifyHost: notifyHost, @@ -34,7 +33,6 @@ public struct NotifyClientFactory { keychainStorage: KeychainStorageProtocol, groupKeychainStorage: KeychainStorageProtocol, networkInteractor: NetworkInteracting, - pairingRegisterer: PairingRegisterer, pushClient: PushClient, crypto: CryptoProvider, notifyHost: String, diff --git a/Sources/WalletConnectNotify/Notify.swift b/Sources/WalletConnectNotify/Notify.swift index 9ed189307..3bb7b41f1 100644 --- a/Sources/WalletConnectNotify/Notify.swift +++ b/Sources/WalletConnectNotify/Notify.swift @@ -10,7 +10,6 @@ public class Notify { projectId: Networking.projectId, groupIdentifier: Networking.groupIdentifier, networkInteractor: Networking.interactor, - pairingRegisterer: Pair.registerer, pushClient: Push.instance, crypto: config.crypto, notifyHost: config.notifyHost, From e816d31421c5fbe4e0b5e1c83cf4d1497de173a2 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Wed, 24 Jan 2024 17:29:44 +0300 Subject: [PATCH 283/814] Update Dispatching.swift --- Sources/WalletConnectRelay/Dispatching.swift | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index efd932f70..7d13bc39f 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -90,7 +90,9 @@ final class Dispatcher: NSObject, Dispatching { switch result { case .failure(let error): cancellable?.cancel() - self.handleFallbackIfNeeded(error: error) + if !socket.isConnected { + handleFallbackIfNeeded(error: error) + } completion(error) case .finished: break } From 326cde375d44ea33190a73911cabcaaaee47129a Mon Sep 17 00:00:00 2001 From: Talha Ali <> Date: Wed, 24 Jan 2024 12:01:31 -0600 Subject: [PATCH 284/814] removed the cron job that releases wallet and showcase sample every Monday --- .github/workflows/release.yml | 4 ---- 1 file changed, 4 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index df62cc8a9..06c696525 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -1,10 +1,6 @@ name: release on: - schedule: - # Runs "Every Monday 10am CET" - - cron: '0 10 * * 1' - workflow_dispatch: jobs: From 1505a6caa3060edf47e149a89ae12c1a8a5ecf13 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 26 Jan 2024 10:47:14 +0100 Subject: [PATCH 285/814] fix authenticate tests --- .../Auth/Services/App/AuthResponseSubscriber.swift | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index f35ce8c48..1ee89b8e5 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -46,12 +46,7 @@ class AuthResponseSubscriber { networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - guard let record = rpcHistory.get(recordId: payload.id) else { - logger.error("record not found") - return - } - let pairingTopic = record.topic - + let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) let requestId = payload.id @@ -66,7 +61,6 @@ class AuthResponseSubscriber { onResponse?(requestId, .failure(error as! AuthError)) return } - let pairingTopic = pairingTopic let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, authRequestPayload: authRequestPayload) onResponse?(requestId, .success(session)) From 657f92c23b8f35f24f4e19b61f8c79a962c3e73b Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 25 Jan 2024 16:05:46 +0300 Subject: [PATCH 286/814] Pagination implemented --- .../PushMessages/SubscriptionInteractor.swift | 6 ++--- .../PushMessages/SubscriptionPresenter.swift | 23 +++++++++++++++-- .../PushMessages/SubscriptionView.swift | 25 +++++++++++++++++++ .../Client/Wallet/HistoryService.swift | 6 ++--- .../Client/Wallet/NotifyClient.swift | 8 ++++-- 5 files changed, 57 insertions(+), 11 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift index e3d1a14e4..37ea5fcd0 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionInteractor.swift @@ -31,9 +31,7 @@ final class SubscriptionInteractor { } } - func fetchHistory() { - Task(priority: .high) { - try await Notify.instance.fetchHistory(subscription: subscription) - } + func fetchHistory(after: String?, limit: Int) async throws -> Bool { + return try await Notify.instance.fetchHistory(subscription: subscription, after: after, limit: limit) } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift index c0527399e..e5b69d57c 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift @@ -4,6 +4,11 @@ import WalletConnectNotify final class SubscriptionPresenter: ObservableObject { + enum LoadingState { + case loading + case idle + } + private var subscription: NotifySubscription private let interactor: SubscriptionInteractor private let router: SubscriptionRouter @@ -11,6 +16,9 @@ final class SubscriptionPresenter: ObservableObject { @Published private var pushMessages: [NotifyMessageRecord] = [] + @Published var loadingState: LoadingState = .idle + @Published var isMoreDataAvailable: Bool = true + var subscriptionViewModel: SubscriptionsViewModel { return SubscriptionsViewModel(subscription: subscription) } @@ -49,6 +57,19 @@ final class SubscriptionPresenter: ObservableObject { router.dismiss() } + func loadMoreMessages() { + switch loadingState { + case .loading: + break + case .idle: + Task(priority: .high) { @MainActor in + loadingState = .loading + isMoreDataAvailable = try await interactor.fetchHistory(after: messages.last?.id, limit: 50) + loadingState = .idle + } + } + } + @objc func preferencesDidPress() { router.presentPreferences(subscription: subscription) } @@ -77,8 +98,6 @@ extension SubscriptionPresenter: SceneViewModel { private extension SubscriptionPresenter { func setupInitialState() { - interactor.fetchHistory() - pushMessages = interactor.getPushMessages() interactor.messagesPublisher diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift index 358affe2b..890629513 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift @@ -34,6 +34,11 @@ struct SubscriptionView: View { .listRowSeparator(.hidden) .listRowBackground(Color.clear) } + + if presenter.isMoreDataAvailable { + lastRowView() + .listRowSeparator(.hidden) + } } .listStyle(PlainListStyle()) } @@ -161,6 +166,26 @@ struct SubscriptionView: View { .frame(maxWidth: .infinity) .frame(height: 410) } + + func lastRowView() -> some View { + VStack { + switch presenter.loadingState { + case .loading: + HStack { + Spacer() + ProgressView() + Spacer() + } + .padding(.bottom, 24) + case .idle: + EmptyView() + } + } + .frame(height: 50) + .onAppear { + presenter.loadMoreMessages() + } + } } #if DEBUG diff --git a/Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift b/Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift index 21574e569..7cece784e 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/HistoryService.swift @@ -12,7 +12,7 @@ public final class HistoryService { self.identityClient = identityClient } - public func fetchHistory(account: Account, topic: String, appAuthenticationKey: String, host: String) async throws -> [NotifyMessage] { + public func fetchHistory(account: Account, topic: String, appAuthenticationKey: String, host: String, after: String?, limit: Int) async throws -> [NotifyMessage] { let dappAuthKey = try DIDKey(did: appAuthenticationKey) let app = DIDWeb(host: host) @@ -21,8 +21,8 @@ public final class HistoryService { keyserver: keyserver.absoluteString, dappAuthKey: dappAuthKey, app: app, - limit: 50, - after: nil + limit: UInt64(limit), + after: after ) let wrapper = try identityClient.signAndCreateWrapper(payload: requestPayload, account: account) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index e4eab7e08..d806dba04 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -148,12 +148,14 @@ public class NotifyClient { return notifyStorage.messagesPublisher(topic: topic) } - public func fetchHistory(subscription: NotifySubscription) async throws { + public func fetchHistory(subscription: NotifySubscription, after: String?, limit: Int) async throws -> Bool { let messages = try await historyService.fetchHistory( account: subscription.account, topic: subscription.topic, appAuthenticationKey: subscription.appAuthenticationKey, - host: subscription.metadata.url + host: subscription.metadata.url, + after: after, + limit: limit ) let records = messages.map { message in @@ -161,6 +163,8 @@ public class NotifyClient { } try notifyStorage.setMessages(records) + + return messages.count == limit } } From b9c819a8cf27195d333d03be6701cdfcbde9e8e4 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 25 Jan 2024 16:07:43 +0300 Subject: [PATCH 287/814] Integration tests hasMore --- Example/IntegrationTests/Push/NotifyTests.swift | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 4673fe55d..742fd8d9e 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -264,7 +264,8 @@ final class NotifyTests: XCTestCase { await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) - try await walletNotifyClientA.fetchHistory(subscription: subscription) + let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 50) + XCTAssertTrue(hasMore) XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count > 40) } } From aa31a50679b392e566f053394232bd3703e7640a Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 25 Jan 2024 16:09:31 +0300 Subject: [PATCH 288/814] testFetchHistory updated --- Example/IntegrationTests/Push/NotifyTests.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 742fd8d9e..1618881e6 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -264,9 +264,9 @@ final class NotifyTests: XCTestCase { await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) - let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 50) + let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) XCTAssertTrue(hasMore) - XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count > 40) + XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) } } From 0c77d3a0ef4ada083f04df5a2542ab2e70f43645 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 26 Jan 2024 13:41:59 +0100 Subject: [PATCH 289/814] fix sign tests --- Sources/Web3Wallet/Web3WalletClient.swift | 6 ------ .../WalletConnectSignTests/AppProposalServiceTests.swift | 8 ++++---- 2 files changed, 4 insertions(+), 10 deletions(-) diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index b9be066b2..b3cf2dbcf 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -237,12 +237,6 @@ public class Web3WalletClient { signClient.getPendingProposals(topic: topic) } - /// - Parameter id: id of a wc_sessionRequest jsonrpc request - /// - Returns: json rpc record object for given id or nil if record for give id does not exits - public func getSessionRequestRecord(id: RPCID) -> (request: Request, context: VerifyContext?)? { - signClient.getSessionRequestRecord(id: id) - } - public func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject { try signClient.makeAuthObject(authRequest: authRequest, signature: signature, account: account) } diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index 5e4b7da61..71b50a9ca 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -99,7 +99,7 @@ final class AppProposalServiceTests: XCTestCase { func testHandleSessionProposeResponse() async { let exp = expectation(description: "testHandleSessionProposeResponse") - let uri = try! await appPairService.create() + let uri = try! await appPairService.create(supportedMethods: nil) let pairing = storageMock.getPairing(forTopic: uri.topic)! let topicA = pairing.topic let relayOptions = RelayProtocolOptions(protocol: "", data: nil) @@ -128,7 +128,7 @@ final class AppProposalServiceTests: XCTestCase { let topicB = deriveTopic(publicKey: responder.publicKey, privateKey: privateKey) _ = storageMock.getPairing(forTopic: topicA)! - wait(for: [exp], timeout: 5) + await fulfillment(of: [exp], timeout: 5) let sessionTopic = networkingInteractor.subscriptions.last! @@ -137,7 +137,7 @@ final class AppProposalServiceTests: XCTestCase { } func testSessionProposeError() async { - let uri = try! await appPairService.create() + let uri = try! await appPairService.create(supportedMethods: nil) let pairing = storageMock.getPairing(forTopic: uri.topic)! let topicA = pairing.topic let relayOptions = RelayProtocolOptions(protocol: "", data: nil) @@ -161,7 +161,7 @@ final class AppProposalServiceTests: XCTestCase { } func testSessionProposeErrorOnActivePairing() async { - let uri = try! await appPairService.create() + let uri = try! await appPairService.create(supportedMethods: nil) let pairing = storageMock.getPairing(forTopic: uri.topic)! let topicA = pairing.topic let relayOptions = RelayProtocolOptions(protocol: "", data: nil) From 1aca17dd580e8d9ad2721ff0c889009f8540730b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 26 Jan 2024 15:18:19 +0100 Subject: [PATCH 290/814] add AuthenticatedSessionRecapFactory --- .../IntegrationTests/Push/NotifyTests.swift | 574 +++++++++--------- .../App/SessionAuthRequestService.swift | 16 +- ...uthenticatedSessionRecapFactoryTests.swift | 11 + .../RecapFactoryTests.swift | 6 +- 4 files changed, 311 insertions(+), 296 deletions(-) create mode 100644 Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 6918f4015..5dc7e38ad 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -1,287 +1,287 @@ -import Foundation -import XCTest -import WalletConnectUtils -import Web3 -@testable import WalletConnectKMS -import WalletConnectRelay -import Combine -import WalletConnectNetworking -import WalletConnectPush -@testable import WalletConnectNotify -import WalletConnectIdentity -import WalletConnectSigner - -final class NotifyTests: XCTestCase { - - var walletNotifyClientA: NotifyClient! - - let gmDappDomain = InputConfig.gmDappHost - - var pk: EthereumPrivateKey! - - var privateKey: Data { - return Data(pk.rawPrivateKey) - } - - var account: Account { - return Account("eip155:1:" + pk.address.hex(eip55: true))! - } - - private var publishers = Set() - - func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { - let keychain = KeychainStorageMock() - let keyValueStorage = RuntimeKeyValueStorage() - - let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) - let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) - let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) - - let relayClient = RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - networkMonitor: NetworkMonitor(), - logger: relayLogger) - - let networkingClient = NetworkingClientFactory.create( - relayClient: relayClient, - logger: networkingLogger, - keychainStorage: keychain, - keyValueStorage: keyValueStorage, - kmsLogger: kmsLogger) - - let clientId = try! networkingClient.getClientId() - networkingLogger.debug("My client id is: \(clientId)") - return (networkingClient, keychain, keyValueStorage) - } - - func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { - let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) - let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) - let pushClient = PushClientFactory.create(projectId: "", - pushHost: "echo.walletconnect.com", - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - environment: .sandbox) - let keyserverURL = URL(string: "https://keys.walletconnect.com")! - let sqlite = try! MemorySqlite() - // Note:- prod project_id do not exists on staging, we can use gmDappProjectId - let client = NotifyClientFactory.create(projectId: InputConfig.gmDappProjectId, - keyserverURL: keyserverURL, - sqlite: sqlite, - logger: notifyLogger, - keychainStorage: keychain, - groupKeychainStorage: KeychainStorageMock(), - networkInteractor: networkingInteractor, - pushClient: pushClient, - crypto: DefaultCryptoProvider(), - notifyHost: InputConfig.notifyHost, - explorerHost: InputConfig.explorerHost) - return client - } - - override func setUp() { - pk = try! EthereumPrivateKey() - walletNotifyClientA = makeWalletClient() - publishers.removeAll() - } - - func testWalletCreatesSubscription() async throws { - let expectation = expectation(description: "expects to create notify subscription") - expectation.assertForOverFulfill = false - - var subscription: NotifySubscription? - - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - expectation.fulfill() - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - - if let subscription { - try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) - } - } - - func testNotifyWatchSubscriptions() async throws { - let expectation = expectation(description: "expects client B to receive subscription created by client A") - expectation.assertForOverFulfill = false - - var subscription: NotifySubscription? - - let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") - clientB.subscriptionsPublisher.sink { subscriptions in - subscription = subscriptions.first - expectation.fulfill() - }.store(in: &publishers) - - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) - - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - - if let subscription { - try await clientB.deleteSubscription(topic: subscription.topic) - } - } - - func testNotifySubscriptionChanged() async throws { - let expectation = expectation(description: "expects client B to receive subscription after both clients are registered and client A creates one") - expectation.assertForOverFulfill = false - - var subscription: NotifySubscription? - - let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") - clientB.subscriptionsPublisher.sink { subscriptions in - subscription = subscriptions.first - expectation.fulfill() - }.store(in: &publishers) - - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) - try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - - if let subscription { - try await clientB.deleteSubscription(topic: subscription.topic) - } - } - - func testWalletCreatesAndUpdatesSubscription() async throws { - let created = expectation(description: "Subscription created") - - let updated = expectation(description: "Subscription Updated") - - var isCreated = false - var isUpdated = false - var subscription: NotifySubscription! - - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - - if !isCreated { - isCreated = true - created.fulfill() - } else if !isUpdated { - isUpdated = true - updated.fulfill() - } - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) - - try await walletNotifyClientA.update(topic: subscription.topic, scope: []) - - await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) - - let updatedScope = subscription.scope.filter { $0.value.enabled == true } - XCTAssertTrue(updatedScope.isEmpty) - - try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) - } - - func testNotifyServerSubscribeAndNotifies() async throws { - let subscribeExpectation = expectation(description: "creates notify subscription") - let messageExpectation = expectation(description: "receives a notify message") - - var notifyMessage: NotifyMessage! - var notifyMessageRecord: NotifyMessageRecord? - - var didNotify = false - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - guard - let subscription = subscriptions.first, - let scope = subscription.scope.keys.first - else { return } - - let notifier = Publisher() - if !didNotify { - didNotify = true - - let message = NotifyMessage.stub(type: scope) - notifyMessage = message - - Task(priority: .high) { - try await notifier.notify(topic: subscription.topic, account: subscription.account, message: message) - subscribeExpectation.fulfill() - } - } - }.store(in: &publishers) - - walletNotifyClientA.messagesPublisher - .sink { messages in - guard let newNotifyMessageRecord = messages.first else { return } - // ID's is not equal because server generates a new one - XCTAssertEqual(newNotifyMessageRecord.message.title, notifyMessage.title) - XCTAssertEqual(newNotifyMessageRecord.message.body, notifyMessage.body) - XCTAssertEqual(newNotifyMessageRecord.message.icon, notifyMessage.icon) - XCTAssertEqual(newNotifyMessageRecord.message.type, notifyMessage.type) - notifyMessageRecord = newNotifyMessageRecord - messageExpectation.fulfill() - }.store(in: &publishers) - - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [subscribeExpectation, messageExpectation], timeout: InputConfig.defaultTimeout) - - if let notifyMessageRecord { - try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) - } - } - - func testFetchHistory() async throws { - let subscribeExpectation = expectation(description: "fetch notify subscription") - let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! - - var subscription: NotifySubscription! - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - subscribeExpectation.fulfill() - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in - let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } - - await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) - - try await walletNotifyClientA.fetchHistory(subscription: subscription) - XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count > 40) - } -} - - -private extension NotifyTests { - func sign(_ message: String) -> CacaoSignature { - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } -} - -private extension NotifyClient { - - func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { - let params = try await prepareRegistration(account: account, domain: domain) - let signature = onSign(params.message) - try await register(params: params, signature: signature) - } -} +//import Foundation +//import XCTest +//import WalletConnectUtils +//import Web3 +//@testable import WalletConnectKMS +//import WalletConnectRelay +//import Combine +//import WalletConnectNetworking +//import WalletConnectPush +//@testable import WalletConnectNotify +//import WalletConnectIdentity +//import WalletConnectSigner +// +//final class NotifyTests: XCTestCase { +// +// var walletNotifyClientA: NotifyClient! +// +// let gmDappDomain = InputConfig.gmDappHost +// +// var pk: EthereumPrivateKey! +// +// var privateKey: Data { +// return Data(pk.rawPrivateKey) +// } +// +// var account: Account { +// return Account("eip155:1:" + pk.address.hex(eip55: true))! +// } +// +// private var publishers = Set() +// +// func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { +// let keychain = KeychainStorageMock() +// let keyValueStorage = RuntimeKeyValueStorage() +// +// let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) +// let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) +// let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) +// +// let relayClient = RelayClientFactory.create( +// relayHost: InputConfig.relayHost, +// projectId: InputConfig.projectId, +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// socketFactory: DefaultSocketFactory(), +// networkMonitor: NetworkMonitor(), +// logger: relayLogger) +// +// let networkingClient = NetworkingClientFactory.create( +// relayClient: relayClient, +// logger: networkingLogger, +// keychainStorage: keychain, +// keyValueStorage: keyValueStorage, +// kmsLogger: kmsLogger) +// +// let clientId = try! networkingClient.getClientId() +// networkingLogger.debug("My client id is: \(clientId)") +// return (networkingClient, keychain, keyValueStorage) +// } +// +// func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { +// let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) +// let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) +// let pushClient = PushClientFactory.create(projectId: "", +// pushHost: "echo.walletconnect.com", +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// environment: .sandbox) +// let keyserverURL = URL(string: "https://keys.walletconnect.com")! +// let sqlite = try! MemorySqlite() +// // Note:- prod project_id do not exists on staging, we can use gmDappProjectId +// let client = NotifyClientFactory.create(projectId: InputConfig.gmDappProjectId, +// keyserverURL: keyserverURL, +// sqlite: sqlite, +// logger: notifyLogger, +// keychainStorage: keychain, +// groupKeychainStorage: KeychainStorageMock(), +// networkInteractor: networkingInteractor, +// pushClient: pushClient, +// crypto: DefaultCryptoProvider(), +// notifyHost: InputConfig.notifyHost, +// explorerHost: InputConfig.explorerHost) +// return client +// } +// +// override func setUp() { +// pk = try! EthereumPrivateKey() +// walletNotifyClientA = makeWalletClient() +// publishers.removeAll() +// } +// +// func testWalletCreatesSubscription() async throws { +// let expectation = expectation(description: "expects to create notify subscription") +// expectation.assertForOverFulfill = false +// +// var subscription: NotifySubscription? +// +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// expectation.fulfill() +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) +// +// if let subscription { +// try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) +// } +// } +// +// func testNotifyWatchSubscriptions() async throws { +// let expectation = expectation(description: "expects client B to receive subscription created by client A") +// expectation.assertForOverFulfill = false +// +// var subscription: NotifySubscription? +// +// let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") +// clientB.subscriptionsPublisher.sink { subscriptions in +// subscription = subscriptions.first +// expectation.fulfill() +// }.store(in: &publishers) +// +// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) +// +// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) +// +// if let subscription { +// try await clientB.deleteSubscription(topic: subscription.topic) +// } +// } +// +// func testNotifySubscriptionChanged() async throws { +// let expectation = expectation(description: "expects client B to receive subscription after both clients are registered and client A creates one") +// expectation.assertForOverFulfill = false +// +// var subscription: NotifySubscription? +// +// let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") +// clientB.subscriptionsPublisher.sink { subscriptions in +// subscription = subscriptions.first +// expectation.fulfill() +// }.store(in: &publishers) +// +// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) +// +// if let subscription { +// try await clientB.deleteSubscription(topic: subscription.topic) +// } +// } +// +// func testWalletCreatesAndUpdatesSubscription() async throws { +// let created = expectation(description: "Subscription created") +// +// let updated = expectation(description: "Subscription Updated") +// +// var isCreated = false +// var isUpdated = false +// var subscription: NotifySubscription! +// +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// +// if !isCreated { +// isCreated = true +// created.fulfill() +// } else if !isUpdated { +// isUpdated = true +// updated.fulfill() +// } +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) +// +// try await walletNotifyClientA.update(topic: subscription.topic, scope: []) +// +// await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) +// +// let updatedScope = subscription.scope.filter { $0.value.enabled == true } +// XCTAssertTrue(updatedScope.isEmpty) +// +// try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) +// } +// +// func testNotifyServerSubscribeAndNotifies() async throws { +// let subscribeExpectation = expectation(description: "creates notify subscription") +// let messageExpectation = expectation(description: "receives a notify message") +// +// var notifyMessage: NotifyMessage! +// var notifyMessageRecord: NotifyMessageRecord? +// +// var didNotify = false +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// guard +// let subscription = subscriptions.first, +// let scope = subscription.scope.keys.first +// else { return } +// +// let notifier = Publisher() +// if !didNotify { +// didNotify = true +// +// let message = NotifyMessage.stub(type: scope) +// notifyMessage = message +// +// Task(priority: .high) { +// try await notifier.notify(topic: subscription.topic, account: subscription.account, message: message) +// subscribeExpectation.fulfill() +// } +// } +// }.store(in: &publishers) +// +// walletNotifyClientA.messagesPublisher +// .sink { messages in +// guard let newNotifyMessageRecord = messages.first else { return } +// // ID's is not equal because server generates a new one +// XCTAssertEqual(newNotifyMessageRecord.message.title, notifyMessage.title) +// XCTAssertEqual(newNotifyMessageRecord.message.body, notifyMessage.body) +// XCTAssertEqual(newNotifyMessageRecord.message.icon, notifyMessage.icon) +// XCTAssertEqual(newNotifyMessageRecord.message.type, notifyMessage.type) +// notifyMessageRecord = newNotifyMessageRecord +// messageExpectation.fulfill() +// }.store(in: &publishers) +// +// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [subscribeExpectation, messageExpectation], timeout: InputConfig.defaultTimeout) +// +// if let notifyMessageRecord { +// try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) +// } +// } +// +// func testFetchHistory() async throws { +// let subscribeExpectation = expectation(description: "fetch notify subscription") +// let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! +// +// var subscription: NotifySubscription! +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// subscribeExpectation.fulfill() +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in +// let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() +// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) +// } +// +// await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) +// +// try await walletNotifyClientA.fetchHistory(subscription: subscription) +// XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count > 40) +// } +//} +// +// +//private extension NotifyTests { +// func sign(_ message: String) -> CacaoSignature { +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() +// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) +// } +//} +// +//private extension NotifyClient { +// +// func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { +// let params = try await prepareRegistration(account: account, domain: domain) +// let signature = onSign(params.message) +// try await register(params: params, signature: signature) +// } +//} diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 004abb53d..2658bcddf 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -27,12 +27,14 @@ actor SessionAuthRequestService { let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let protocolMethod = SessionAuthenticatedProtocolMethod() - guard let chainNamespace = Blockchain(params.chains.first!)?.namespace else { + guard let chainNamespace = Blockchain(params.chains.first!)?.namespace, + chainNamespace == "eip155" + else { throw Errors.invalidChain } if let methods = params.methods, !methods.isEmpty { - let namespaceRecap = try createNamespaceRecap(chainNamespace: chainNamespace, methods: methods) + let namespaceRecap = try createNamespaceRecap(methods: methods) params.addResource(resource: namespaceRecap) } let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) @@ -45,9 +47,15 @@ actor SessionAuthRequestService { try await networkingInteractor.subscribe(topic: responseTopic) } - private func createNamespaceRecap(chainNamespace: String, methods: [String]) throws -> String { + private func createNamespaceRecap(methods: [String]) throws -> String { + try AuthenticatedSessionRecapFactory.createNamespaceRecap(methods: methods) + } +} + +class AuthenticatedSessionRecapFactory { + static func createNamespaceRecap(methods: [String]) throws -> String { let actions = methods.map{"request/\($0)"} - let recap = RecapFactory.createRecap(resource: chainNamespace, actions: actions) + let recap = RecapFactory.createRecap(resource: "eip155", actions: actions) let jsonEncoder = JSONEncoder() jsonEncoder.outputFormatting = .withoutEscapingSlashes let jsonData = try jsonEncoder.encode(recap) diff --git a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift new file mode 100644 index 000000000..076340d60 --- /dev/null +++ b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift @@ -0,0 +1,11 @@ +import XCTest +@testable import WalletConnectSign + +final class AuthenticatedSessionRecapFactoryTests: XCTestCase { + + func testAuthenticatedSessionRecapFactory() { + let recapUrn = try! AuthenticatedSessionRecapFactory.createNamespaceRecap(methods: ["personal_sign", "eth_sendTransaction"]) + let expectedUrn = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W10sInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W119fX0=" + XCTAssertEqual(recapUrn, expectedUrn) + } +} diff --git a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift index f0efedd64..bbf52403f 100644 --- a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift @@ -1,17 +1,14 @@ import XCTest -@testable import WalletConnectUtils // Replace with your actual module name +@testable import WalletConnectUtils class RecapFactoryTests: XCTestCase { func testCreateRecap() { - // Define the input values let resource = "eip155:1" let actions = ["request/eth_sendTransaction", "request/personal_sign"] - // Call the function let recap = RecapFactory.createRecap(resource: resource, actions: actions) - // Define the expected output let expectedOutput: [String: [String: [String: [String]]]] = [ "att": [ "eip155:1": [ @@ -21,7 +18,6 @@ class RecapFactoryTests: XCTestCase { ] ] - // Assert that the output equals the expected output XCTAssertEqual(recap, expectedOutput, "createRecap output did not match the expected output") } } From 9759a1bfce4e0a60dbeffe7042a33f08ba06f7ee Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 26 Jan 2024 15:21:27 +0100 Subject: [PATCH 291/814] savepoint --- .../App/AuthenticatedSessionRecapFactory.swift | 14 ++++++++++++++ .../Services/App/SessionAuthRequestService.swift | 15 +-------------- 2 files changed, 15 insertions(+), 14 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift new file mode 100644 index 000000000..a732bc0a8 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift @@ -0,0 +1,14 @@ +import Foundation + +class AuthenticatedSessionRecapFactory { + static func createNamespaceRecap(methods: [String]) throws -> String { + let actions = methods.map{"request/\($0)"} + let recap = RecapFactory.createRecap(resource: "eip155", actions: actions) + let jsonEncoder = JSONEncoder() + jsonEncoder.outputFormatting = .withoutEscapingSlashes + let jsonData = try jsonEncoder.encode(recap) + let base64Encoded = jsonData.base64EncodedString() + let urn = "urn:recap:\(base64Encoded)" + return urn + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 2658bcddf..4a28199a5 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -28,7 +28,7 @@ actor SessionAuthRequestService { let responseTopic = pubKey.rawRepresentation.sha256().toHexString() let protocolMethod = SessionAuthenticatedProtocolMethod() guard let chainNamespace = Blockchain(params.chains.first!)?.namespace, - chainNamespace == "eip155" + chainNamespace == "eip155" else { throw Errors.invalidChain } @@ -51,16 +51,3 @@ actor SessionAuthRequestService { try AuthenticatedSessionRecapFactory.createNamespaceRecap(methods: methods) } } - -class AuthenticatedSessionRecapFactory { - static func createNamespaceRecap(methods: [String]) throws -> String { - let actions = methods.map{"request/\($0)"} - let recap = RecapFactory.createRecap(resource: "eip155", actions: actions) - let jsonEncoder = JSONEncoder() - jsonEncoder.outputFormatting = .withoutEscapingSlashes - let jsonData = try jsonEncoder.encode(recap) - let base64Encoded = jsonData.base64EncodedString() - let urn = "urn:recap:\(base64Encoded)" - return urn - } -} From 09fe0828549293928677947fac0f054bdd713c13 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 26 Jan 2024 15:22:34 +0100 Subject: [PATCH 292/814] savepoint --- ...tory.swift => AuthenticatedSessionRecapUrnFactory.swift} | 2 +- .../Auth/Services/App/SessionAuthRequestService.swift | 6 +++--- .../AuthenticatedSessionRecapFactoryTests.swift | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) rename Sources/WalletConnectSign/Auth/Services/App/{AuthenticatedSessionRecapFactory.swift => AuthenticatedSessionRecapUrnFactory.swift} (92%) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift similarity index 92% rename from Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift rename to Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift index a732bc0a8..bbc717920 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapFactory.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift @@ -1,6 +1,6 @@ import Foundation -class AuthenticatedSessionRecapFactory { +class AuthenticatedSessionRecapUrnFactory { static func createNamespaceRecap(methods: [String]) throws -> String { let actions = methods.map{"request/\($0)"} let recap = RecapFactory.createRecap(resource: "eip155", actions: actions) diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 4a28199a5..6bedcac33 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -34,7 +34,7 @@ actor SessionAuthRequestService { } if let methods = params.methods, !methods.isEmpty { - let namespaceRecap = try createNamespaceRecap(methods: methods) + let namespaceRecap = try createRecapUrn(methods: methods) params.addResource(resource: namespaceRecap) } let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) @@ -47,7 +47,7 @@ actor SessionAuthRequestService { try await networkingInteractor.subscribe(topic: responseTopic) } - private func createNamespaceRecap(methods: [String]) throws -> String { - try AuthenticatedSessionRecapFactory.createNamespaceRecap(methods: methods) + private func createRecapUrn(methods: [String]) throws -> String { + try AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: methods) } } diff --git a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift index 076340d60..ce4c0885e 100644 --- a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift +++ b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift @@ -4,7 +4,7 @@ import XCTest final class AuthenticatedSessionRecapFactoryTests: XCTestCase { func testAuthenticatedSessionRecapFactory() { - let recapUrn = try! AuthenticatedSessionRecapFactory.createNamespaceRecap(methods: ["personal_sign", "eth_sendTransaction"]) + let recapUrn = try! AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: ["personal_sign", "eth_sendTransaction"]) let expectedUrn = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W10sInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W119fX0=" XCTAssertEqual(recapUrn, expectedUrn) } From 556efc27ea858dc95e5d2f2bfa8e3be451eb6f7a Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Thu, 14 Dec 2023 20:51:41 +0300 Subject: [PATCH 293/814] Subscriptions Updater --- .../Client/Wallet/NotifyClient.swift | 5 +- .../Client/Wallet/NotifyClientFactory.swift | 16 +++-- .../Wallet/NotifySubsctiptionsUpdater.swift | 56 ++++++++++++++++++ ...ubscriptionsChangedRequestSubscriber.swift | 59 +++---------------- .../NotifyUpdateResponseSubscriber.swift | 19 ++---- ...WatchSubscriptionsResponseSubscriber.swift | 53 +++-------------- .../NotifySubscribeResponseSubscriber.swift | 30 ++++------ .../NotifySubscriptionResponsePayload.swift | 14 ++--- 8 files changed, 108 insertions(+), 144 deletions(-) create mode 100644 Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index d806dba04..c0c22af51 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -37,6 +37,7 @@ public class NotifyClient { private let notifyWatchSubscriptionsResponseSubscriber: NotifyWatchSubscriptionsResponseSubscriber private let notifyWatcherAgreementKeysProvider: NotifyWatcherAgreementKeysProvider private let notifySubscriptionsChangedRequestSubscriber: NotifySubscriptionsChangedRequestSubscriber + private let notifySubscriptionsUpdater: NotifySubsctiptionsUpdater private let subscriptionWatcher: SubscriptionWatcher init(logger: ConsoleLogging, @@ -58,6 +59,7 @@ public class NotifyClient { notifyWatchSubscriptionsResponseSubscriber: NotifyWatchSubscriptionsResponseSubscriber, notifyWatcherAgreementKeysProvider: NotifyWatcherAgreementKeysProvider, notifySubscriptionsChangedRequestSubscriber: NotifySubscriptionsChangedRequestSubscriber, + notifySubscriptionsUpdater: NotifySubsctiptionsUpdater, subscriptionWatcher: SubscriptionWatcher ) { self.logger = logger @@ -78,6 +80,7 @@ public class NotifyClient { self.notifyWatchSubscriptionsResponseSubscriber = notifyWatchSubscriptionsResponseSubscriber self.notifyWatcherAgreementKeysProvider = notifyWatcherAgreementKeysProvider self.notifySubscriptionsChangedRequestSubscriber = notifySubscriptionsChangedRequestSubscriber + self.notifySubscriptionsUpdater = notifySubscriptionsUpdater self.subscriptionWatcher = subscriptionWatcher } @@ -184,7 +187,7 @@ private extension NotifyClient { extension NotifyClient { public var subscriptionChangedPublisher: AnyPublisher<[NotifySubscription], Never> { - return notifySubscriptionsChangedRequestSubscriber.subscriptionChangedPublisher + return notifySubscriptionsUpdater.subscriptionChangedPublisher } public func register(deviceToken: String) async throws { diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 676f37b5a..8e7de5dae 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -52,19 +52,22 @@ public struct NotifyClientFactory { let notifySubscribeRequester = NotifySubscribeRequester(keyserverURL: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, logger: logger, kms: kms, webDidResolver: webDidResolver, notifyConfigProvider: notifyConfigProvider) - let notifySubscribeResponseSubscriber = NotifySubscribeResponseSubscriber(networkingInteractor: networkInteractor, kms: kms, logger: logger, groupKeychainStorage: groupKeychainStorage, notifyStorage: notifyStorage, notifyConfigProvider: notifyConfigProvider) + let notifySubscriptionsUpdater = NotifySubsctiptionsUpdater(networkingInteractor: networkInteractor, kms: kms, logger: logger, notifyStorage: notifyStorage, groupKeychainStorage: groupKeychainStorage) + + let notifySubscriptionsBuilder = NotifySubscriptionsBuilder(notifyConfigProvider: notifyConfigProvider) + + let notifySubscribeResponseSubscriber = NotifySubscribeResponseSubscriber(networkingInteractor: networkInteractor, logger: logger, notifySubscriptionsBuilder: notifySubscriptionsBuilder, notifySubscriptionsUpdater: notifySubscriptionsUpdater) let notifyUpdateRequester = NotifyUpdateRequester(keyserverURL: keyserverURL, identityClient: identityClient, networkingInteractor: networkInteractor, notifyConfigProvider: notifyConfigProvider, logger: logger, notifyStorage: notifyStorage) - let notifyUpdateResponseSubscriber = NotifyUpdateResponseSubscriber(networkingInteractor: networkInteractor, logger: logger, notifyConfigProvider: notifyConfigProvider, notifyStorage: notifyStorage) + let notifyUpdateResponseSubscriber = NotifyUpdateResponseSubscriber(networkingInteractor: networkInteractor, logger: logger) let subscriptionsAutoUpdater = SubscriptionsAutoUpdater(notifyUpdateRequester: notifyUpdateRequester, logger: logger, notifyStorage: notifyStorage) let notifyWatcherAgreementKeysProvider = NotifyWatcherAgreementKeysProvider(kms: kms) let notifyWatchSubscriptionsRequester = NotifyWatchSubscriptionsRequester(keyserverURL: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, logger: logger, webDidResolver: webDidResolver, notifyAccountProvider: notifyAccountProvider, notifyWatcherAgreementKeysProvider: notifyWatcherAgreementKeysProvider, notifyHost: notifyHost) - let notifySubscriptionsBuilder = NotifySubscriptionsBuilder(notifyConfigProvider: notifyConfigProvider) - let notifyWatchSubscriptionsResponseSubscriber = NotifyWatchSubscriptionsResponseSubscriber(networkingInteractor: networkInteractor, kms: kms, logger: logger, notifyStorage: notifyStorage, groupKeychainStorage: groupKeychainStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) - let notifySubscriptionsChangedRequestSubscriber = NotifySubscriptionsChangedRequestSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, kms: kms, identityClient: identityClient, logger: logger, groupKeychainStorage: groupKeychainStorage, notifyStorage: notifyStorage, notifySubscriptionsBuilder: notifySubscriptionsBuilder) + let notifyWatchSubscriptionsResponseSubscriber = NotifyWatchSubscriptionsResponseSubscriber(networkingInteractor: networkInteractor, logger: logger, notifySubscriptionsBuilder: notifySubscriptionsBuilder, notifySubscriptionsUpdater: notifySubscriptionsUpdater) + let notifySubscriptionsChangedRequestSubscriber = NotifySubscriptionsChangedRequestSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, logger: logger, notifySubscriptionsUpdater: notifySubscriptionsUpdater, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let subscriptionWatcher = SubscriptionWatcher(notifyWatchSubscriptionsRequester: notifyWatchSubscriptionsRequester, logger: logger) let historyService = HistoryService(keyserver: keyserverURL, networkingClient: networkInteractor, identityClient: identityClient) @@ -87,7 +90,8 @@ public struct NotifyClientFactory { subscriptionsAutoUpdater: subscriptionsAutoUpdater, notifyWatchSubscriptionsResponseSubscriber: notifyWatchSubscriptionsResponseSubscriber, notifyWatcherAgreementKeysProvider: notifyWatcherAgreementKeysProvider, - notifySubscriptionsChangedRequestSubscriber: notifySubscriptionsChangedRequestSubscriber, + notifySubscriptionsChangedRequestSubscriber: notifySubscriptionsChangedRequestSubscriber, + notifySubscriptionsUpdater: notifySubscriptionsUpdater, subscriptionWatcher: subscriptionWatcher ) } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift new file mode 100644 index 000000000..367e3b23a --- /dev/null +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift @@ -0,0 +1,56 @@ +import Foundation +import Combine + +final class NotifySubsctiptionsUpdater { + private let networkingInteractor: NetworkInteracting + private let kms: KeyManagementServiceProtocol + private let logger: ConsoleLogging + private let notifyStorage: NotifyStorage + private let groupKeychainStorage: KeychainStorageProtocol + + private let subscriptionChangedSubject = PassthroughSubject<[NotifySubscription], Never>() + + var subscriptionChangedPublisher: AnyPublisher<[NotifySubscription], Never> { + return subscriptionChangedSubject.eraseToAnyPublisher() + } + + init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, logger: ConsoleLogging, notifyStorage: NotifyStorage, groupKeychainStorage: KeychainStorageProtocol) { + self.networkingInteractor = networkingInteractor + self.kms = kms + self.logger = logger + self.notifyStorage = notifyStorage + self.groupKeychainStorage = groupKeychainStorage + } + + func update(subscriptions newSubscriptions: [NotifySubscription], for account: Account) async throws { + let oldSubscriptions = notifyStorage.getSubscriptions(account: account) + + subscriptionChangedSubject.send(newSubscriptions) + + try Task.checkCancellation() + + let subscriptions = oldSubscriptions.difference(from: newSubscriptions) + + logger.debug("Received: \(newSubscriptions.count), changed: \(subscriptions.count)") + + if subscriptions.count > 0 { + try notifyStorage.replaceAllSubscriptions(newSubscriptions) + + for subscription in newSubscriptions { + let symKey = try SymmetricKey(hex: subscription.symKey) + try groupKeychainStorage.add(symKey, forKey: subscription.topic) + try kms.setSymmetricKey(symKey, for: subscription.topic) + } + + let topics = newSubscriptions.map { $0.topic } + + try await networkingInteractor.batchSubscribe(topics: topics) + + try Task.checkCancellation() + + logger.debug("Updated Subscriptions by Subscriptions Changed Request", properties: [ + "topics": newSubscriptions.map { $0.topic }.joined(separator: ",") + ]) + } + } +} diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifySubscriptionsChanged/NotifySubscriptionsChangedRequestSubscriber.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifySubscriptionsChanged/NotifySubscriptionsChangedRequestSubscriber.swift index a7c9cdd95..5125fc9f4 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifySubscriptionsChanged/NotifySubscriptionsChangedRequestSubscriber.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifySubscriptionsChanged/NotifySubscriptionsChangedRequestSubscriber.swift @@ -5,36 +5,25 @@ class NotifySubscriptionsChangedRequestSubscriber { private let keyserver: URL private let networkingInteractor: NetworkInteracting private let identityClient: IdentityClient - private let kms: KeyManagementServiceProtocol private let logger: ConsoleLogging - private let groupKeychainStorage: KeychainStorageProtocol - private let notifyStorage: NotifyStorage + private let notifySubscriptionsUpdater: NotifySubsctiptionsUpdater private let notifySubscriptionsBuilder: NotifySubscriptionsBuilder - - private let subscriptionChangedSubject = PassthroughSubject<[NotifySubscription], Never>() - - var subscriptionChangedPublisher: AnyPublisher<[NotifySubscription], Never> { - return subscriptionChangedSubject.eraseToAnyPublisher() - } init( keyserver: URL, networkingInteractor: NetworkInteracting, - kms: KeyManagementServiceProtocol, identityClient: IdentityClient, logger: ConsoleLogging, - groupKeychainStorage: KeychainStorageProtocol, - notifyStorage: NotifyStorage, + notifySubscriptionsUpdater: NotifySubsctiptionsUpdater, notifySubscriptionsBuilder: NotifySubscriptionsBuilder ) { self.keyserver = keyserver self.networkingInteractor = networkingInteractor - self.kms = kms self.logger = logger self.identityClient = identityClient - self.groupKeychainStorage = groupKeychainStorage - self.notifyStorage = notifyStorage + self.notifySubscriptionsUpdater = notifySubscriptionsUpdater self.notifySubscriptionsBuilder = notifySubscriptionsBuilder + subscribeForNofifyChangedRequests() } @@ -44,54 +33,20 @@ class NotifySubscriptionsChangedRequestSubscriber { protocolMethod: NotifySubscriptionsChangedProtocolMethod(), requestOfType: NotifySubscriptionsChangedRequestPayload.Wrapper.self, errorHandler: logger) { [unowned self] payload in + logger.debug("Received Subscriptions Changed Request") let (jwtPayload, _) = try NotifySubscriptionsChangedRequestPayload.decodeAndVerify(from: payload.request) - let account = jwtPayload.account - - // TODO: varify signature with notify server diddoc authentication key - - let oldSubscriptions = notifyStorage.getSubscriptions(account: account) - let newSubscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(jwtPayload.subscriptions) - - subscriptionChangedSubject.send(newSubscriptions) - - try Task.checkCancellation() - let subscriptions = oldSubscriptions.difference(from: newSubscriptions) + let subscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(jwtPayload.subscriptions) - logger.debug("Received: \(newSubscriptions.count), changed: \(subscriptions.count)") - - if subscriptions.count > 0 { - try notifyStorage.replaceAllSubscriptions(newSubscriptions) - - for subscription in newSubscriptions { - let symKey = try SymmetricKey(hex: subscription.symKey) - try groupKeychainStorage.add(symKey, forKey: subscription.topic) - try kms.setSymmetricKey(symKey, for: subscription.topic) - } - - let topics = newSubscriptions.map { $0.topic } - - try await networkingInteractor.batchSubscribe(topics: topics) - - try Task.checkCancellation() - - var logProperties = ["rpcId": payload.id.string] - for (index, subscription) in newSubscriptions.enumerated() { - let key = "subscription_\(index + 1)" - logProperties[key] = subscription.topic - } - - logger.debug("Updated Subscriptions by Subscriptions Changed Request", properties: logProperties) - } + try await notifySubscriptionsUpdater.update(subscriptions: subscriptions, for: jwtPayload.account) try await respond(topic: payload.topic, account: jwtPayload.account, rpcId: payload.id, notifyServerAuthenticationKey: jwtPayload.notifyServerAuthenticationKey) } } private func respond(topic: String, account: Account, rpcId: RPCID, notifyServerAuthenticationKey: DIDKey) async throws { - let receiptPayload = NotifySubscriptionsChangedResponsePayload(account: account, keyserver: keyserver, notifyServerAuthenticationKey: notifyServerAuthenticationKey) let wrapper = try identityClient.signAndCreateWrapper( diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift index d9b2bafbd..4843f5dbf 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift @@ -2,21 +2,14 @@ import Foundation import Combine class NotifyUpdateResponseSubscriber { + private let networkingInteractor: NetworkInteracting - private var publishers = [AnyCancellable]() private let logger: ConsoleLogging - private let notifyStorage: NotifyStorage - private let nofityConfigProvider: NotifyConfigProvider - - init(networkingInteractor: NetworkInteracting, - logger: ConsoleLogging, - notifyConfigProvider: NotifyConfigProvider, - notifyStorage: NotifyStorage - ) { + + init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging) { self.networkingInteractor = networkingInteractor self.logger = logger - self.notifyStorage = notifyStorage - self.nofityConfigProvider = notifyConfigProvider + subscribeForUpdateResponse() } @@ -24,10 +17,6 @@ class NotifyUpdateResponseSubscriber { } private extension NotifyUpdateResponseSubscriber { - enum Errors: Error { - case subscriptionDoesNotExist - case selectedScopeNotFound - } func subscribeForUpdateResponse() { networkingInteractor.subscribeOnResponse( diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyWatchSubscriptions/NotifyWatchSubscriptionsResponseSubscriber.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyWatchSubscriptions/NotifyWatchSubscriptionsResponseSubscriber.swift index dccdcbdd7..34239ec13 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyWatchSubscriptions/NotifyWatchSubscriptionsResponseSubscriber.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyWatchSubscriptions/NotifyWatchSubscriptionsResponseSubscriber.swift @@ -3,25 +3,20 @@ import Combine class NotifyWatchSubscriptionsResponseSubscriber { private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol private let logger: ConsoleLogging - private let notifyStorage: NotifyStorage - private let groupKeychainStorage: KeychainStorageProtocol private let notifySubscriptionsBuilder: NotifySubscriptionsBuilder + private let notifySubscriptionsUpdater: NotifySubsctiptionsUpdater init(networkingInteractor: NetworkInteracting, - kms: KeyManagementServiceProtocol, logger: ConsoleLogging, - notifyStorage: NotifyStorage, - groupKeychainStorage: KeychainStorageProtocol, - notifySubscriptionsBuilder: NotifySubscriptionsBuilder + notifySubscriptionsBuilder: NotifySubscriptionsBuilder, + notifySubscriptionsUpdater: NotifySubsctiptionsUpdater ) { self.networkingInteractor = networkingInteractor - self.kms = kms self.logger = logger - self.notifyStorage = notifyStorage - self.groupKeychainStorage = groupKeychainStorage self.notifySubscriptionsBuilder = notifySubscriptionsBuilder + self.notifySubscriptionsUpdater = notifySubscriptionsUpdater + subscribeForWatchSubscriptionsResponse() } @@ -32,45 +27,15 @@ class NotifyWatchSubscriptionsResponseSubscriber { requestOfType: NotifyWatchSubscriptionsPayload.Wrapper.self, responseOfType: NotifyWatchSubscriptionsResponsePayload.Wrapper.self, errorHandler: logger) { [unowned self] payload in + logger.debug("Received Notify Watch Subscriptions response") + let (requestPayload, _) = try NotifyWatchSubscriptionsPayload.decodeAndVerify(from: payload.request) let (responsePayload, _) = try NotifyWatchSubscriptionsResponsePayload.decodeAndVerify(from: payload.response) - let (watchSubscriptionPayloadRequest, _) = try NotifyWatchSubscriptionsPayload.decodeAndVerify(from: payload.request) - - let account = watchSubscriptionPayloadRequest.subscriptionAccount - // TODO: varify signature with notify server diddoc authentication key - - let oldSubscriptions = notifyStorage.getSubscriptions(account: account) - let newSubscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(responsePayload.subscriptions) - - try Task.checkCancellation() - - let subscriptions = oldSubscriptions.difference(from: newSubscriptions) - - logger.debug("Received: \(newSubscriptions.count), changed: \(subscriptions.count)") - - if subscriptions.count > 0 { - // TODO: unsubscribe for oldSubscriptions topics that are not included in new subscriptions - try notifyStorage.replaceAllSubscriptions(newSubscriptions) - - for subscription in newSubscriptions { - let symKey = try SymmetricKey(hex: subscription.symKey) - try groupKeychainStorage.add(symKey, forKey: subscription.topic) - try kms.setSymmetricKey(symKey, for: subscription.topic) - } - - try await networkingInteractor.batchSubscribe(topics: newSubscriptions.map { $0.topic }) - - try Task.checkCancellation() - var logProperties = [String: String]() - for (index, subscription) in newSubscriptions.enumerated() { - let key = "subscription_\(index + 1)" - logProperties[key] = subscription.topic - } + let subscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(responsePayload.subscriptions) - logger.debug("Updated Subscriptions with Watch Subscriptions Update, number of subscriptions: \(newSubscriptions.count)", properties: logProperties) - } + try await notifySubscriptionsUpdater.update(subscriptions: subscriptions, for: requestPayload.subscriptionAccount) } } diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_pushSubscribe/NotifySubscribeResponseSubscriber.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_pushSubscribe/NotifySubscribeResponseSubscriber.swift index d8aa56a39..d42e8b1f0 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_pushSubscribe/NotifySubscribeResponseSubscriber.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_pushSubscribe/NotifySubscribeResponseSubscriber.swift @@ -2,31 +2,22 @@ import Foundation import Combine class NotifySubscribeResponseSubscriber { - enum Errors: Error { - case couldNotCreateSubscription - } private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - private var publishers = [AnyCancellable]() private let logger: ConsoleLogging - private let notifyStorage: NotifyStorage - private let groupKeychainStorage: KeychainStorageProtocol - private let notifyConfigProvider: NotifyConfigProvider + private let notifySubscriptionsBuilder: NotifySubscriptionsBuilder + private let notifySubscriptionsUpdater: NotifySubsctiptionsUpdater init(networkingInteractor: NetworkInteracting, - kms: KeyManagementServiceProtocol, logger: ConsoleLogging, - groupKeychainStorage: KeychainStorageProtocol, - notifyStorage: NotifyStorage, - notifyConfigProvider: NotifyConfigProvider + notifySubscriptionsBuilder: NotifySubscriptionsBuilder, + notifySubscriptionsUpdater: NotifySubsctiptionsUpdater ) { self.networkingInteractor = networkingInteractor - self.kms = kms self.logger = logger - self.groupKeychainStorage = groupKeychainStorage - self.notifyStorage = notifyStorage - self.notifyConfigProvider = notifyConfigProvider + self.notifySubscriptionsBuilder = notifySubscriptionsBuilder + self.notifySubscriptionsUpdater = notifySubscriptionsUpdater + subscribeForSubscriptionResponse() } @@ -39,7 +30,12 @@ class NotifySubscribeResponseSubscriber { ) { [unowned self] payload in logger.debug("Received Notify Subscribe response") - let _ = try NotifySubscriptionResponsePayload.decodeAndVerify(from: payload.response) + let (requestPayload, _) = try NotifySubscriptionPayload.decodeAndVerify(from: payload.request) + let (responsePayload, _) = try NotifySubscriptionResponsePayload.decodeAndVerify(from: payload.response) + + let subscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(responsePayload.subscriptions) + + try await notifySubscriptionsUpdater.update(subscriptions: subscriptions, for: requestPayload.subscriptionAccount) logger.debug("NotifySubscribeResponseSubscriber: unsubscribing from response topic: \(payload.topic)") diff --git a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifySubscriptionResponsePayload.swift b/Sources/WalletConnectNotify/Types/JWTPayloads/NotifySubscriptionResponsePayload.swift index 8ed7e775e..d9f04440a 100644 --- a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifySubscriptionResponsePayload.swift +++ b/Sources/WalletConnectNotify/Types/JWTPayloads/NotifySubscriptionResponsePayload.swift @@ -18,6 +18,8 @@ struct NotifySubscriptionResponsePayload: JWTClaimsCodable { let sub: String /// Dapp's domain url let app: String + /// array of Notify Subscriptions + let sbs: [NotifyServerSubscription] static var action: String? { return "notify_subscription_response" @@ -39,22 +41,16 @@ struct NotifySubscriptionResponsePayload: JWTClaimsCodable { let account: Account let selfPubKey: DIDKey let app: String + let subscriptions: [NotifyServerSubscription] init(claims: Claims) throws { self.account = try Account(DIDPKHString: claims.sub) self.selfPubKey = try DIDKey(did: claims.aud) self.app = claims.app + self.subscriptions = claims.sbs } func encode(iss: String) throws -> Claims { - return Claims( - iat: defaultIat(), - exp: expiry(days: 1), - act: Claims.action, - iss: iss, - aud: selfPubKey.did(variant: .ED25519), - sub: account.did, - app: app - ) + fatalError("Client is not supposed to encode this JWT payload") } } From 1a012d2c7c7c2ab377ae9161acad3582035824be Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 21:46:23 +0300 Subject: [PATCH 294/814] NotifyUpdateResponsePayload with sbs --- .../NotifyUpdateResponseSubscriber.swift | 19 ++++++++++++++++--- .../NotifyUpdateResponsePayload.swift | 14 +++++--------- 2 files changed, 21 insertions(+), 12 deletions(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift index 4843f5dbf..76b2a539b 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyUpdate/NotifyUpdateResponseSubscriber.swift @@ -5,10 +5,19 @@ class NotifyUpdateResponseSubscriber { private let networkingInteractor: NetworkInteracting private let logger: ConsoleLogging - - init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging) { + private let notifySubscriptionsBuilder: NotifySubscriptionsBuilder + private let notifySubscriptionsUpdater: NotifySubsctiptionsUpdater + + init( + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + notifySubscriptionsBuilder: NotifySubscriptionsBuilder, + notifySubscriptionsUpdater: NotifySubsctiptionsUpdater + ) { self.networkingInteractor = networkingInteractor self.logger = logger + self.notifySubscriptionsBuilder = notifySubscriptionsBuilder + self.notifySubscriptionsUpdater = notifySubscriptionsUpdater subscribeForUpdateResponse() } @@ -26,7 +35,11 @@ private extension NotifyUpdateResponseSubscriber { errorHandler: logger ) { [unowned self] payload in - let _ = try NotifyUpdateResponsePayload.decodeAndVerify(from: payload.response) + let (responsePayload, _) = try NotifyUpdateResponsePayload.decodeAndVerify(from: payload.response) + + let subscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(responsePayload.subscriptions) + + try await notifySubscriptionsUpdater.update(subscriptions: subscriptions, for: responsePayload.account) logger.debug("Received Notify Update response") } diff --git a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyUpdateResponsePayload.swift b/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyUpdateResponsePayload.swift index a03ca61f8..7e49d08c3 100644 --- a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyUpdateResponsePayload.swift +++ b/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyUpdateResponsePayload.swift @@ -16,6 +16,8 @@ struct NotifyUpdateResponsePayload: JWTClaimsCodable { let aud: String /// Blockchain account that notify subscription has been proposed for -`did:pkh` let sub: String + /// array of Notify Server Subscriptions + let sbs: [NotifyServerSubscription] /// Dapp's domain url let app: String @@ -39,22 +41,16 @@ struct NotifyUpdateResponsePayload: JWTClaimsCodable { let account: Account let selfPubKey: DIDKey let app: DIDWeb + let subscriptions: [NotifyServerSubscription] init(claims: Claims) throws { self.account = try Account(DIDPKHString: claims.sub) self.selfPubKey = try DIDKey(did: claims.aud) self.app = try DIDWeb(did: claims.app) + self.subscriptions = claims.sbs } func encode(iss: String) throws -> Claims { - return Claims( - iat: defaultIat(), - exp: expiry(days: 1), - act: Claims.action, - iss: iss, - aud: selfPubKey.did(variant: .ED25519), - sub: account.did, - app: app.did - ) + fatalError() } } From feaa31452ad9f33f6669443f83c24924505918fd Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 23 Jan 2024 22:31:26 +0300 Subject: [PATCH 295/814] Delete response subsciber --- .../Client/Wallet/NotifyClient.swift | 11 ++-- .../Client/Wallet/NotifyClientFactory.swift | 10 ++-- ...> NotifyDeleteSubscriptionRequester.swift} | 13 ++--- .../NotifyDeleteSubscriptionSubscriber.swift | 51 +++++++++++++++++++ .../NotifyDeletePayload.swift | 0 .../NotifyDeleteResponsePayload.swift | 14 ++--- 6 files changed, 72 insertions(+), 27 deletions(-) rename Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/{DeleteNotifySubscriptionRequester.swift => NotifyDeleteSubscriptionRequester.swift} (84%) create mode 100644 Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionSubscriber.swift rename Sources/WalletConnectNotify/Types/JWTPayloads/{ => notify_delete}/NotifyDeletePayload.swift (100%) rename Sources/WalletConnectNotify/Types/JWTPayloads/{ => notify_delete}/NotifyDeleteResponsePayload.swift (84%) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index c0c22af51..6b5aa22fc 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -17,7 +17,7 @@ public class NotifyClient { return logger.logsPublisher } - private let deleteNotifySubscriptionRequester: DeleteNotifySubscriptionRequester + private let notifyDeleteSubscriptionRequester: NotifyDeleteSubscriptionRequester private let notifySubscribeRequester: NotifySubscribeRequester public let logger: ConsoleLogging @@ -31,6 +31,7 @@ public class NotifyClient { private let notifyMessageSubscriber: NotifyMessageSubscriber private let resubscribeService: NotifyResubscribeService private let notifySubscribeResponseSubscriber: NotifySubscribeResponseSubscriber + private let notifyDeleteSubscriptionSubscriber: NotifyDeleteSubscriptionSubscriber private let notifyUpdateRequester: NotifyUpdateRequester private let notifyUpdateResponseSubscriber: NotifyUpdateResponseSubscriber private let subscriptionsAutoUpdater: SubscriptionsAutoUpdater @@ -48,10 +49,11 @@ public class NotifyClient { pushClient: PushClient, notifyMessageSubscriber: NotifyMessageSubscriber, notifyStorage: NotifyStorage, - deleteNotifySubscriptionRequester: DeleteNotifySubscriptionRequester, + notifyDeleteSubscriptionRequester: NotifyDeleteSubscriptionRequester, resubscribeService: NotifyResubscribeService, notifySubscribeRequester: NotifySubscribeRequester, notifySubscribeResponseSubscriber: NotifySubscribeResponseSubscriber, + notifyDeleteSubscriptionSubscriber: NotifyDeleteSubscriptionSubscriber, notifyUpdateRequester: NotifyUpdateRequester, notifyUpdateResponseSubscriber: NotifyUpdateResponseSubscriber, notifyAccountProvider: NotifyAccountProvider, @@ -69,10 +71,11 @@ public class NotifyClient { self.historyService = historyService self.notifyMessageSubscriber = notifyMessageSubscriber self.notifyStorage = notifyStorage - self.deleteNotifySubscriptionRequester = deleteNotifySubscriptionRequester + self.notifyDeleteSubscriptionRequester = notifyDeleteSubscriptionRequester self.resubscribeService = resubscribeService self.notifySubscribeRequester = notifySubscribeRequester self.notifySubscribeResponseSubscriber = notifySubscribeResponseSubscriber + self.notifyDeleteSubscriptionSubscriber = notifyDeleteSubscriptionSubscriber self.notifyUpdateRequester = notifyUpdateRequester self.notifyUpdateResponseSubscriber = notifyUpdateResponseSubscriber self.notifyAccountProvider = notifyAccountProvider @@ -128,7 +131,7 @@ public class NotifyClient { } public func deleteSubscription(topic: String) async throws { - try await deleteNotifySubscriptionRequester.delete(topic: topic) + try await notifyDeleteSubscriptionRequester.delete(topic: topic) } public func deleteNotifyMessage(id: String) { diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 8e7de5dae..14fa2fdef 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -45,7 +45,7 @@ public struct NotifyClientFactory { let identityClient = IdentityClientFactory.create(keyserver: keyserverURL, keychain: keychainStorage, logger: logger) let notifyMessageSubscriber = NotifyMessageSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, notifyStorage: notifyStorage, crypto: crypto, logger: logger) let webDidResolver = NotifyWebDidResolver() - let deleteNotifySubscriptionRequester = DeleteNotifySubscriptionRequester(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, kms: kms, logger: logger, notifyStorage: notifyStorage) + let notifyDeleteSubscriptionRequester = NotifyDeleteSubscriptionRequester(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, logger: logger, notifyStorage: notifyStorage) let resubscribeService = NotifyResubscribeService(networkInteractor: networkInteractor, notifyStorage: notifyStorage, logger: logger) let notifyConfigProvider = NotifyConfigProvider(projectId: projectId, explorerHost: explorerHost) @@ -60,7 +60,7 @@ public struct NotifyClientFactory { let notifyUpdateRequester = NotifyUpdateRequester(keyserverURL: keyserverURL, identityClient: identityClient, networkingInteractor: networkInteractor, notifyConfigProvider: notifyConfigProvider, logger: logger, notifyStorage: notifyStorage) - let notifyUpdateResponseSubscriber = NotifyUpdateResponseSubscriber(networkingInteractor: networkInteractor, logger: logger) + let notifyUpdateResponseSubscriber = NotifyUpdateResponseSubscriber(networkingInteractor: networkInteractor, logger: logger, notifySubscriptionsBuilder: notifySubscriptionsBuilder, notifySubscriptionsUpdater: notifySubscriptionsUpdater) let subscriptionsAutoUpdater = SubscriptionsAutoUpdater(notifyUpdateRequester: notifyUpdateRequester, logger: logger, notifyStorage: notifyStorage) @@ -70,6 +70,7 @@ public struct NotifyClientFactory { let notifySubscriptionsChangedRequestSubscriber = NotifySubscriptionsChangedRequestSubscriber(keyserver: keyserverURL, networkingInteractor: networkInteractor, identityClient: identityClient, logger: logger, notifySubscriptionsUpdater: notifySubscriptionsUpdater, notifySubscriptionsBuilder: notifySubscriptionsBuilder) let subscriptionWatcher = SubscriptionWatcher(notifyWatchSubscriptionsRequester: notifyWatchSubscriptionsRequester, logger: logger) let historyService = HistoryService(keyserver: keyserverURL, networkingClient: networkInteractor, identityClient: identityClient) + let notifyDeleteSubscriptionSubscriber = NotifyDeleteSubscriptionSubscriber(networkingInteractor: networkInteractor, kms: kms, logger: logger, notifySubscriptionsBuilder: notifySubscriptionsBuilder, notifySubscriptionsUpdater: notifySubscriptionsUpdater) return NotifyClient( logger: logger, @@ -80,10 +81,11 @@ public struct NotifyClientFactory { pushClient: pushClient, notifyMessageSubscriber: notifyMessageSubscriber, notifyStorage: notifyStorage, - deleteNotifySubscriptionRequester: deleteNotifySubscriptionRequester, + notifyDeleteSubscriptionRequester: notifyDeleteSubscriptionRequester, resubscribeService: resubscribeService, notifySubscribeRequester: notifySubscribeRequester, - notifySubscribeResponseSubscriber: notifySubscribeResponseSubscriber, + notifySubscribeResponseSubscriber: notifySubscribeResponseSubscriber, + notifyDeleteSubscriptionSubscriber: notifyDeleteSubscriptionSubscriber, notifyUpdateRequester: notifyUpdateRequester, notifyUpdateResponseSubscriber: notifyUpdateResponseSubscriber, notifyAccountProvider: notifyAccountProvider, diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/DeleteNotifySubscriptionRequester.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionRequester.swift similarity index 84% rename from Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/DeleteNotifySubscriptionRequester.swift rename to Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionRequester.swift index b9c86009c..762f4948d 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/DeleteNotifySubscriptionRequester.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionRequester.swift @@ -1,13 +1,12 @@ import Foundation -class DeleteNotifySubscriptionRequester { +class NotifyDeleteSubscriptionRequester { enum Errors: Error { case notifySubscriptionNotFound } private let keyserver: URL private let networkingInteractor: NetworkInteracting private let identityClient: IdentityClient - private let kms: KeyManagementServiceProtocol private let logger: ConsoleLogging private let notifyStorage: NotifyStorage @@ -15,14 +14,12 @@ class DeleteNotifySubscriptionRequester { keyserver: URL, networkingInteractor: NetworkInteracting, identityClient: IdentityClient, - kms: KeyManagementServiceProtocol, logger: ConsoleLogging, notifyStorage: NotifyStorage ) { self.keyserver = keyserver self.networkingInteractor = networkingInteractor self.identityClient = identityClient - self.kms = kms self.logger = logger self.notifyStorage = notifyStorage } @@ -49,15 +46,11 @@ class DeleteNotifySubscriptionRequester { try notifyStorage.deleteSubscription(topic: topic) try notifyStorage.deleteMessages(topic: topic) - networkingInteractor.unsubscribe(topic: topic) - - logger.debug("Subscription removed, topic: \(topic)") - - kms.deleteSymmetricKey(for: topic) + logger.debug("Subscription delete request sent, topic: \(topic)") } } -private extension DeleteNotifySubscriptionRequester { +private extension NotifyDeleteSubscriptionRequester { func createJWTWrapper(dappPubKey: DIDKey, reason: String, app: DIDWeb, account: Account) throws -> NotifyDeletePayload.Wrapper { let jwtPayload = NotifyDeletePayload(account: account, keyserver: keyserver, dappPubKey: dappPubKey, app: app) diff --git a/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionSubscriber.swift b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionSubscriber.swift new file mode 100644 index 000000000..3768b6697 --- /dev/null +++ b/Sources/WalletConnectNotify/Client/Wallet/ProtocolEngine/wc_notifyDelete/NotifyDeleteSubscriptionSubscriber.swift @@ -0,0 +1,51 @@ +import Foundation +import Combine + +class NotifyDeleteSubscriptionSubscriber { + + private let networkingInteractor: NetworkInteracting + private let kms: KeyManagementServiceProtocol + private let logger: ConsoleLogging + private let notifySubscriptionsBuilder: NotifySubscriptionsBuilder + private let notifySubscriptionsUpdater: NotifySubsctiptionsUpdater + + init( + networkingInteractor: NetworkInteracting, + kms: KeyManagementServiceProtocol, + logger: ConsoleLogging, + notifySubscriptionsBuilder: NotifySubscriptionsBuilder, + notifySubscriptionsUpdater: NotifySubsctiptionsUpdater + ) { + self.networkingInteractor = networkingInteractor + self.kms = kms + self.logger = logger + self.notifySubscriptionsBuilder = notifySubscriptionsBuilder + self.notifySubscriptionsUpdater = notifySubscriptionsUpdater + + subscribeForDeleteResponse() + } +} + +private extension NotifyDeleteSubscriptionSubscriber { + + func subscribeForDeleteResponse() { + networkingInteractor.subscribeOnResponse( + protocolMethod: NotifyDeleteProtocolMethod(), + requestOfType: NotifyDeletePayload.Wrapper.self, + responseOfType: NotifyDeleteResponsePayload.Wrapper.self, + errorHandler: logger + ) { [unowned self] payload in + + let (responsePayload, _) = try NotifyDeleteResponsePayload.decodeAndVerify(from: payload.response) + + let subscriptions = try await notifySubscriptionsBuilder.buildSubscriptions(responsePayload.subscriptions) + + try await notifySubscriptionsUpdater.update(subscriptions: subscriptions, for: responsePayload.account) + + logger.debug("Received Notify Delete response") + + networkingInteractor.unsubscribe(topic: payload.topic) + kms.deleteSymmetricKey(for: payload.topic) + } + } +} diff --git a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyDeletePayload.swift b/Sources/WalletConnectNotify/Types/JWTPayloads/notify_delete/NotifyDeletePayload.swift similarity index 100% rename from Sources/WalletConnectNotify/Types/JWTPayloads/NotifyDeletePayload.swift rename to Sources/WalletConnectNotify/Types/JWTPayloads/notify_delete/NotifyDeletePayload.swift diff --git a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyDeleteResponsePayload.swift b/Sources/WalletConnectNotify/Types/JWTPayloads/notify_delete/NotifyDeleteResponsePayload.swift similarity index 84% rename from Sources/WalletConnectNotify/Types/JWTPayloads/NotifyDeleteResponsePayload.swift rename to Sources/WalletConnectNotify/Types/JWTPayloads/notify_delete/NotifyDeleteResponsePayload.swift index b9f97cc43..ac7f76e0d 100644 --- a/Sources/WalletConnectNotify/Types/JWTPayloads/NotifyDeleteResponsePayload.swift +++ b/Sources/WalletConnectNotify/Types/JWTPayloads/notify_delete/NotifyDeleteResponsePayload.swift @@ -16,6 +16,8 @@ struct NotifyDeleteResponsePayload: JWTClaimsCodable { let aud: String /// Blockchain account that notify subscription has been proposed for -`did:pkh` let sub: String + /// array of Notify Server Subscriptions + let sbs: [NotifyServerSubscription] /// Dapp's domain url let app: String @@ -39,22 +41,16 @@ struct NotifyDeleteResponsePayload: JWTClaimsCodable { let account: Account let selfPubKey: DIDKey let app: DIDWeb + let subscriptions: [NotifyServerSubscription] init(claims: Claims) throws { self.account = try Account(DIDPKHString: claims.sub) self.selfPubKey = try DIDKey(did: claims.aud) self.app = try DIDWeb(did: claims.app) + self.subscriptions = claims.sbs } func encode(iss: String) throws -> Claims { - return Claims( - iat: defaultIat(), - exp: expiry(days: 1), - act: Claims.action, - iss: iss, - aud: selfPubKey.did(variant: .ED25519), - sub: account.did, - app: app.did - ) + fatalError() } } From 123f7c306419ffcaa7aa3a60879a4feef50e134d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Jan 2024 08:36:11 +0100 Subject: [PATCH 296/814] request multiple chains --- Example/DApp/Modules/Sign/SignPresenter.swift | 6 +++--- Sources/WalletConnectPairing/Types/WCPairing.swift | 1 + 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index a269b2dbd..c035fabad 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -169,11 +169,11 @@ extension SignPresenter { extension SignPresenter: SceneViewModel {} -// MARK: - Auth request stub +// MARK: - Authenticate request stub extension AuthRequestParams { static func stub( domain: String = "service.invalid", - chainId: String = "eip155:1", + chains: [String] = ["eip155:1", "eip155:137"], nonce: String = "32891756", aud: String = "https://service.invalid/login", nbf: String? = nil, @@ -184,7 +184,7 @@ extension AuthRequestParams { ) -> AuthRequestParams { return AuthRequestParams( domain: domain, - chains: [chainId], + chains: chains, nonce: nonce, aud: aud, nbf: nbf, diff --git a/Sources/WalletConnectPairing/Types/WCPairing.swift b/Sources/WalletConnectPairing/Types/WCPairing.swift index c2c70457c..9bd66f103 100644 --- a/Sources/WalletConnectPairing/Types/WCPairing.swift +++ b/Sources/WalletConnectPairing/Types/WCPairing.swift @@ -33,6 +33,7 @@ public struct WCPairing: SequenceObject { self.relay = uri.relay self.active = false self.requestReceived = false + self.methods = uri.methods self.expiryDate = Date(timeIntervalSince1970: TimeInterval(uri.expiryTimestamp)) } From 207a3a5f45f9464ae29a2a8b5f9e22f3b13d36bb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Jan 2024 09:38:23 +0100 Subject: [PATCH 297/814] fix wallet integration issue --- .../Wallet/AuthRequest/AuthRequestInteractor.swift | 4 +++- .../Auth/Services/SessionNamespaceBuilder.swift | 3 ++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift index 3e7f1ca86..594bfa676 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift @@ -13,12 +13,14 @@ final class AuthRequestInteractor { func approve(request: AuthenticationRequest, importAccount: ImportAccount) async throws -> Bool { - let account = importAccount.account var auths = [AuthObject]() try request.payload.chains.forEach { chain in + let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! + + let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) let signature = try messageSigner.sign( diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 7cdae5a8b..1d8a43346 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -15,9 +15,10 @@ class SessionNamespaceBuilder { func buildSessionNamespaces(cacaos: [Cacao]) throws -> [String: SessionNamespace] { + //ensure all cacaos have the same resources guard let cacao = cacaos.first, let resources = cacao.p.resources, - let namespacesUrn = resources.last, + let namespacesUrn = resources.first(where: {$0.hasPrefix("urn:recap")}), let decodedRecap = decodeUrnToJson(urn: namespacesUrn), let chainsNamespace = try? DIDPKH(did: cacao.p.iss).account.blockchain.namespace else { throw Errors.cannotCreateSessionNamespaceFromTheRecap From 87b6401b380c965c2ad93330060fd0feb93d7e4f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Jan 2024 09:59:23 +0100 Subject: [PATCH 298/814] update sessionNamespace builder --- .../Services/SessionNamespaceBuilder.swift | 31 +++++++++++++------ 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 1d8a43346..851656c2f 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -3,9 +3,9 @@ import Foundation class SessionNamespaceBuilder { enum Errors: Error { - case recordForIdNotFound - case malformedAuthRequestParams + case emptyCacaosArrayForbidden case cannotCreateSessionNamespaceFromTheRecap + case malformedRecap } private let logger: ConsoleLogging @@ -14,20 +14,31 @@ class SessionNamespaceBuilder { } func buildSessionNamespaces(cacaos: [Cacao]) throws -> [String: SessionNamespace] { + guard !cacaos.isEmpty else { + throw Errors.emptyCacaosArrayForbidden + } - //ensure all cacaos have the same resources - guard let cacao = cacaos.first, - let resources = cacao.p.resources, - let namespacesUrn = resources.first(where: {$0.hasPrefix("urn:recap")}), - let decodedRecap = decodeUrnToJson(urn: namespacesUrn), - let chainsNamespace = try? DIDPKH(did: cacao.p.iss).account.blockchain.namespace else { + // Get the first "urn:recap" resource from the first cacao + guard let recapUrn = cacaos.first?.p.resources?.first(where: { $0.hasPrefix("urn:recap") }) else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - let accounts = cacaos.compactMap{ try? DIDPKH(did: $0.p.iss).account } + // Check if all cacaos have exactly the same first "urn:recap" resource + for cacao in cacaos { + guard let resources = cacao.p.resources, + resources.contains(recapUrn) else { + throw Errors.malformedRecap + } + } - let accountsSet = Set(accounts) + guard let decodedRecap = decodeUrnToJson(urn: recapUrn), + let chainsNamespace = try? DIDPKH(did: cacaos.first!.p.iss).account.blockchain.namespace else { + throw Errors.cannotCreateSessionNamespaceFromTheRecap + } + let accounts = cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account } + + let accountsSet = Set(accounts) let methods = getMethods(from: decodedRecap) let sessionNamespace = SessionNamespace(accounts: accountsSet, methods: methods, events: []) From e51db103109525252ea54d2b661601d05b402c65 Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Tue, 23 Jan 2024 20:29:12 +0100 Subject: [PATCH 299/814] Bump w3m and include sample wallet in customWallets --- Example/DApp/SceneDelegate.swift | 12 +++++++++++- .../xcshareddata/swiftpm/Package.resolved | 4 ++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 489a1c2d0..521b89ff0 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -30,7 +30,17 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { Web3Modal.configure( projectId: InputConfig.projectId, - metadata: metadata + metadata: metadata, + customWallets: [ + .init( + id: "swift-sample", + name: "Swift Sample Wallet", + homepage: "https://walletconnect.com/", + imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", + order: 1, + mobileLink: "walletapp://" + ) + ] ) Sign.instance.logsPublisher.sink { log in diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index c46e295f2..07a8aa9dd 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -177,8 +177,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "e84a07662d71721de4d0ccb2d3bb28fd993dd108", - "version": "1.0.14" + "revision": "296b2b72c116807a862e4c08ecf0a78ff044f87a", + "version": "1.0.16" } } ] From 04e8917e12dfbf6e4bbc9c6a5fbddd33ce82110a Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Thu, 14 Dec 2023 15:02:42 +0100 Subject: [PATCH 300/814] WCM using api.web3modal.com --- Example/DApp/Modules/Sign/SignPresenter.swift | 11 +++ Example/DApp/Modules/Sign/SignView.swift | 59 +++++++----- Example/DApp/SceneDelegate.swift | 7 ++ Example/ExampleApp.xcodeproj/project.pbxproj | 9 +- .../Extensions/View+Backport.swift | 2 +- .../Mocks/Listing+Mocks.swift | 70 +++++--------- .../Modal/ModalInteractor.swift | 27 +++--- .../WalletConnectModal/Modal/ModalSheet.swift | 6 +- .../Modal/ModalViewModel.swift | 81 +++++++++------- .../Modal/RecentWalletStorage.swift | 14 +-- .../Modal/Screens/GetAWalletView.swift | 6 +- .../WalletDetail/WalletDetailViewModel.swift | 12 +-- .../Modal/Screens/WalletList.swift | 94 ++++++++++++++----- .../Networking/Explorer/ExplorerAPI.swift | 55 ----------- .../Explorer/GetIosDataResponse.swift | 11 +++ .../Explorer/GetWalletsResponse.swift | 87 +++++++++++++++++ .../Explorer/ListingsResponse.swift | 74 --------------- .../Networking/Explorer/Web3ModalAPI.swift | 84 +++++++++++++++++ .../WalletConnectModal/UI/WalletImage.swift | 4 +- .../WalletConnectModal.swift | 3 + 20 files changed, 424 insertions(+), 292 deletions(-) delete mode 100644 Sources/WalletConnectModal/Networking/Explorer/ExplorerAPI.swift create mode 100644 Sources/WalletConnectModal/Networking/Explorer/GetIosDataResponse.swift create mode 100644 Sources/WalletConnectModal/Networking/Explorer/GetWalletsResponse.swift delete mode 100644 Sources/WalletConnectModal/Networking/Explorer/ListingsResponse.swift create mode 100644 Sources/WalletConnectModal/Networking/Explorer/Web3ModalAPI.swift diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 1c5194e2c..896f50442 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -2,6 +2,7 @@ import UIKit import Combine import Web3Modal +import WalletConnectModal import WalletConnectSign final class SignPresenter: ObservableObject { @@ -52,6 +53,16 @@ final class SignPresenter: ObservableObject { Web3Modal.present(from: nil) } + func connectWalletWithWCM() { + Task { + WalletConnectModal.set(sessionParams: .init( + requiredNamespaces: Proposal.requiredNamespaces, + optionalNamespaces: Proposal.optionalNamespaces + )) + } + WalletConnectModal.present(from: nil) + } + @MainActor func connectWalletWithSign() { Task { diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index 54c9d62e7..51d12a806 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -18,29 +18,42 @@ struct SignView: View { Spacer() - Button { - presenter.connectWalletWithW3M() - } label: { - Text("Connect with Web3Modal") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(Color(red: 95/255, green: 159/255, blue: 248/255)) - .cornerRadius(16) - } - .padding(.top, 20) - - Button { - presenter.connectWalletWithSign() - } label: { - Text("Connect with Sign API") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(Color(red: 95/255, green: 159/255, blue: 248/255)) - .cornerRadius(16) + VStack(spacing: 10) { + Button { + presenter.connectWalletWithW3M() + } label: { + Text("Connect with Web3Modal") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + + Button { + presenter.connectWalletWithSign() + } label: { + Text("Connect with Sign API") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + + Button { + presenter.connectWalletWithWCM() + } label: { + Text("Connect with WalletConnectModal") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } } .padding(.top, 10) } diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 521b89ff0..38e007ed9 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -1,6 +1,7 @@ import UIKit import Web3Modal +import WalletConnectModal import Auth import WalletConnectRelay import WalletConnectNetworking @@ -42,6 +43,12 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) ] ) + + WalletConnectModal.configure( + projectId: InputConfig.projectId, + metadata: metadata + ) + Sign.instance.logsPublisher.sink { log in switch log { diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 24712ead6..900432d34 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -341,6 +341,7 @@ CF25F2892A432476009C7E49 /* WalletConnectModal in Frameworks */ = {isa = PBXBuildFile; productRef = CF25F2882A432476009C7E49 /* WalletConnectModal */; }; CF6704DF29E59DDC003326A4 /* XCUIElementQuery.swift in Sources */ = {isa = PBXBuildFile; fileRef = CF6704DE29E59DDC003326A4 /* XCUIElementQuery.swift */; }; CF6704E129E5A014003326A4 /* XCTestCase.swift in Sources */ = {isa = PBXBuildFile; fileRef = CF6704E029E5A014003326A4 /* XCTestCase.swift */; }; + CFDB50722B2869AA00A0CBC2 /* WalletConnectModal in Frameworks */ = {isa = PBXBuildFile; productRef = CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */; }; /* End PBXBuildFile section */ /* Begin PBXContainerItemProxy section */ @@ -712,6 +713,7 @@ 84943C7B2A9BA206007EBAC2 /* Mixpanel in Frameworks */, A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */, A5BB7FA328B6A50400707FC6 /* WalletConnectAuth in Frameworks */, + CFDB50722B2869AA00A0CBC2 /* WalletConnectModal in Frameworks */, ); runOnlyForDeploymentPostprocessing = 0; }; @@ -1961,6 +1963,7 @@ 84943C7A2A9BA206007EBAC2 /* Mixpanel */, C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, C579FEB52AFA86CD008855EB /* Web3Modal */, + CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */, 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, ); productName = DApp; @@ -3348,7 +3351,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = upToNextMajorVersion; - minimumVersion = 1.0.9; + minimumVersion = 1.0.15; }; }; /* End XCRemoteSwiftPackageReference section */ @@ -3567,6 +3570,10 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnectModal; }; + CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */ = { + isa = XCSwiftPackageProductDependency; + productName = WalletConnectModal; + }; /* End XCSwiftPackageProductDependency section */ }; rootObject = 764E1D3426F8D3FC00A1FB15 /* Project object */; diff --git a/Sources/WalletConnectModal/Extensions/View+Backport.swift b/Sources/WalletConnectModal/Extensions/View+Backport.swift index 3c40e44ba..a2ed92408 100644 --- a/Sources/WalletConnectModal/Extensions/View+Backport.swift +++ b/Sources/WalletConnectModal/Extensions/View+Backport.swift @@ -32,7 +32,7 @@ extension View { @ViewBuilder func onTapGestureBackported(count: Int = 1, perform action: @escaping () -> Void) -> some View { - self + self.onTapGesture(count: count, perform: action) } #elseif os(tvOS) diff --git a/Sources/WalletConnectModal/Mocks/Listing+Mocks.swift b/Sources/WalletConnectModal/Mocks/Listing+Mocks.swift index 0c8af0885..721524d4e 100644 --- a/Sources/WalletConnectModal/Mocks/Listing+Mocks.swift +++ b/Sources/WalletConnectModal/Mocks/Listing+Mocks.swift @@ -2,64 +2,40 @@ import Foundation #if DEBUG -extension Listing { - static let stubList: [Listing] = [ - Listing( +extension Wallet { + static let stubList: [Wallet] = [ + Wallet( id: UUID().uuidString, name: "Sample Wallet", - homepage: "https://example.com", + homepage: "https://example.com/cool", + imageId: "0528ee7e-16d1-4089-21e3-bbfb41933100", order: 1, - imageId: UUID().uuidString, - app: Listing.App( - ios: "https://example.com/download-ios", - browser: "https://example.com/download-safari" - ), - mobile: .init( - native: "sampleapp://deeplink", - universal: "https://example.com/universal" - ), - desktop: .init( - native: nil, - universal: "https://example.com/universal" - ) + mobileLink: "https://sample.com/foo/universal", + desktopLink: "sampleapp://deeplink", + webappLink: "https://sample.com/foo/webapp", + appStore: "" ), - Listing( + Wallet( id: UUID().uuidString, - name: "Awesome Wallet", - homepage: "https://example.com/awesome", + name: "Cool Wallet", + homepage: "https://example.com/cool", + imageId: "5195e9db-94d8-4579-6f11-ef553be95100", order: 2, - imageId: UUID().uuidString, - app: Listing.App( - ios: "https://example.com/download-ios", - browser: "https://example.com/download-safari" - ), - mobile: .init( - native: "awesomeapp://deeplink", - universal: "https://example.com/awesome/universal" - ), - desktop: .init( - native: nil, - universal: "https://example.com/awesome/universal" - ) + mobileLink: "awsomeapp://", + desktopLink: "awsomeapp://deeplink", + webappLink: "https://awesome.com/foo/webapp", + appStore: "" ), - Listing( + Wallet( id: UUID().uuidString, name: "Cool Wallet", homepage: "https://example.com/cool", + imageId: "3913df81-63c2-4413-d60b-8ff83cbed500", order: 3, - imageId: UUID().uuidString, - app: Listing.App( - ios: "https://example.com/download-ios", - browser: "https://example.com/download-safari" - ), - mobile: .init( - native: "coolapp://deeplink", - universal: "https://example.com/cool/universal" - ), - desktop: .init( - native: nil, - universal: "https://example.com/cool/universal" - ) + mobileLink: "https://cool.com/foo/universal", + desktopLink: "coolapp://deeplink", + webappLink: "https://cool.com/foo/webapp", + appStore: "" ) ] } diff --git a/Sources/WalletConnectModal/Modal/ModalInteractor.swift b/Sources/WalletConnectModal/Modal/ModalInteractor.swift index 19fc70c51..fe18b4f48 100644 --- a/Sources/WalletConnectModal/Modal/ModalInteractor.swift +++ b/Sources/WalletConnectModal/Modal/ModalInteractor.swift @@ -3,7 +3,7 @@ import Combine import Foundation protocol ModalSheetInteractor { - func getListings() async throws -> [Listing] + func getWallets(page: Int, entries: Int) async throws -> (Int, [Wallet]) func createPairingAndConnect() async throws -> WalletConnectURI? var sessionSettlePublisher: AnyPublisher { get } @@ -11,24 +11,27 @@ protocol ModalSheetInteractor { } final class DefaultModalSheetInteractor: ModalSheetInteractor { - lazy var sessionSettlePublisher: AnyPublisher = WalletConnectModal.instance.sessionSettlePublisher lazy var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> = WalletConnectModal.instance.sessionRejectionPublisher - func getListings() async throws -> [Listing] { - - let httpClient = HTTPNetworkClient(host: "explorer-api.walletconnect.com") + func getWallets(page: Int, entries: Int) async throws -> (Int, [Wallet]) { + let httpClient = HTTPNetworkClient(host: "api.web3modal.org") let response = try await httpClient.request( - ListingsResponse.self, - at: ExplorerAPI.getListings( - projectId: WalletConnectModal.config.projectId, - metadata: WalletConnectModal.config.metadata, - recommendedIds: WalletConnectModal.config.recommendedWalletIds, - excludedIds: WalletConnectModal.config.excludedWalletIds + GetWalletsResponse.self, + at: Web3ModalAPI.getWallets( + params: Web3ModalAPI.GetWalletsParams( + page: page, + entries: entries, + search: nil, + projectId: WalletConnectModal.config.projectId, + metadata: WalletConnectModal.config.metadata, + recommendedIds: WalletConnectModal.config.recommendedWalletIds, + excludedIds: WalletConnectModal.config.excludedWalletIds + ) ) ) - return response.listings.values.compactMap { $0 } + return (response.count, response.data.compactMap { $0 }) } func createPairingAndConnect() async throws -> WalletConnectURI? { diff --git a/Sources/WalletConnectModal/Modal/ModalSheet.swift b/Sources/WalletConnectModal/Modal/ModalSheet.swift index b09226db0..1bfdbaa59 100644 --- a/Sources/WalletConnectModal/Modal/ModalSheet.swift +++ b/Sources/WalletConnectModal/Modal/ModalSheet.swift @@ -119,14 +119,12 @@ public struct ModalSheet: View { @ViewBuilder private func welcome() -> some View { WalletList( - wallets: .init(get: { - viewModel.filteredWallets - }, set: { _ in }), destination: .init(get: { viewModel.destination }, set: { _ in }), + viewModel: viewModel, navigateTo: viewModel.navigateTo(_:), - onListingTap: { viewModel.onListingTap($0) } + onWalletTap: { viewModel.onWalletTap($0) } ) } diff --git a/Sources/WalletConnectModal/Modal/ModalViewModel.swift b/Sources/WalletConnectModal/Modal/ModalViewModel.swift index 5c274468a..5232c1156 100644 --- a/Sources/WalletConnectModal/Modal/ModalViewModel.swift +++ b/Sources/WalletConnectModal/Modal/ModalViewModel.swift @@ -7,7 +7,7 @@ enum Destination: Equatable { case welcome case viewAll case qr - case walletDetail(Listing) + case walletDetail(Wallet) case getWallet var contentTitle: String { @@ -42,17 +42,21 @@ final class ModalViewModel: ObservableObject { @Published private(set) var destinationStack: [Destination] = [.welcome] @Published private(set) var uri: String? - @Published private(set) var wallets: [Listing] = [] - + @Published private(set) var wallets: [Wallet] = [] + @Published var searchTerm: String = "" @Published var toast: Toast? + @Published private(set) var isThereMoreWallets: Bool = true + private var maxPage = Int.max + private var currentPage: Int = 0 + var destination: Destination { destinationStack.last! } - var filteredWallets: [Listing] { + var filteredWallets: [Wallet] { wallets .sortByRecent() .filter(searchTerm: searchTerm) @@ -119,8 +123,8 @@ final class ModalViewModel: ObservableObject { uiApplicationWrapper.openURL(url, nil) } - func onListingTap(_ listing: Listing) { - setLastTimeUsed(listing.id) + func onWalletTap(_ wallet: Wallet) { + setLastTimeUsed(wallet.id) } func onBackButton() { @@ -162,17 +166,32 @@ final class ModalViewModel: ObservableObject { @MainActor func fetchWallets() async { + let entries = 40 + do { - let wallets = try await interactor.getListings() + guard currentPage <= maxPage else { + return + } + + currentPage += 1 + + if currentPage == maxPage { + isThereMoreWallets = false + } + + let (total, wallets) = try await interactor.getWallets(page: currentPage, entries: entries) + maxPage = Int(Double(total / entries).rounded(.up)) + // Small deliberate delay to ensure animations execute properly try await Task.sleep(nanoseconds: 500_000_000) - + loadRecentWallets() checkWhetherInstalled(wallets: wallets) - self.wallets = wallets + self.wallets.append(contentsOf: wallets .sortByOrder() .sortByInstalled() + ) } catch { toast = Toast(style: .error, message: error.localizedDescription) } @@ -181,28 +200,20 @@ final class ModalViewModel: ObservableObject { // MARK: - Sorting and filtering -private extension Array where Element: Listing { - func sortByOrder() -> [Listing] { +private extension Array where Element: Wallet { + func sortByOrder() -> [Wallet] { sorted { - guard let lhs = $0.order else { - return false - } - - guard let rhs = $1.order else { - return true - } - - return lhs < rhs + $0.order < $1.order } } - func sortByInstalled() -> [Listing] { + func sortByInstalled() -> [Wallet] { sorted { lhs, rhs in - if lhs.installed, !rhs.installed { + if lhs.isInstalled, !rhs.isInstalled { return true } - if !lhs.installed, rhs.installed { + if !lhs.isInstalled, rhs.isInstalled { return false } @@ -210,7 +221,7 @@ private extension Array where Element: Listing { } } - func sortByRecent() -> [Listing] { + func sortByRecent() -> [Wallet] { sorted { lhs, rhs in guard let lhsLastTimeUsed = lhs.lastTimeUsed else { return false @@ -224,7 +235,7 @@ private extension Array where Element: Listing { } } - func filter(searchTerm: String) -> [Listing] { + func filter(searchTerm: String) -> [Wallet] { if searchTerm.isEmpty { return self } return filter { @@ -236,18 +247,18 @@ private extension Array where Element: Listing { // MARK: - Recent & Installed Wallets private extension ModalViewModel { - func checkWhetherInstalled(wallets: [Listing]) { + func checkWhetherInstalled(wallets: [Wallet]) { guard let schemes = Bundle.main.object(forInfoDictionaryKey: "LSApplicationQueriesSchemes") as? [String] else { return } wallets.forEach { if - let walletScheme = $0.mobile.native, + let walletScheme = $0.mobileLink, !walletScheme.isEmpty, schemes.contains(walletScheme.replacingOccurrences(of: "://", with: "")) { - $0.installed = uiApplicationWrapper.canOpenURL(URL(string: walletScheme)!) + $0.isInstalled = uiApplicationWrapper.canOpenURL(URL(string: walletScheme)!) } } } @@ -270,24 +281,24 @@ private extension ModalViewModel { // MARK: - Deeplinking protocol WalletDeeplinkHandler { - func openAppstore(wallet: Listing) - func navigateToDeepLink(wallet: Listing, preferUniversal: Bool, preferBrowser: Bool) + func openAppstore(wallet: Wallet) + func navigateToDeepLink(wallet: Wallet, preferUniversal: Bool, preferBrowser: Bool) } extension ModalViewModel: WalletDeeplinkHandler { - func openAppstore(wallet: Listing) { + func openAppstore(wallet: Wallet) { guard - let storeLinkString = wallet.app.ios, + let storeLinkString = wallet.appStore, let storeLink = URL(string: storeLinkString) else { return } uiApplicationWrapper.openURL(storeLink, nil) } - func navigateToDeepLink(wallet: Listing, preferUniversal: Bool, preferBrowser: Bool) { + func navigateToDeepLink(wallet: Wallet, preferUniversal: Bool, preferBrowser: Bool) { do { - let nativeScheme = preferBrowser ? nil : wallet.mobile.native - let universalScheme = preferBrowser ? wallet.desktop.universal : wallet.mobile.universal + let nativeScheme = preferBrowser ? nil : wallet.mobileLink + let universalScheme = preferBrowser ? wallet.desktopLink : wallet.mobileLink let nativeUrlString = try formatNativeUrlString(nativeScheme) let universalUrlString = try formatUniversalUrlString(universalScheme) diff --git a/Sources/WalletConnectModal/Modal/RecentWalletStorage.swift b/Sources/WalletConnectModal/Modal/RecentWalletStorage.swift index 00ccd5929..87ca09a09 100644 --- a/Sources/WalletConnectModal/Modal/RecentWalletStorage.swift +++ b/Sources/WalletConnectModal/Modal/RecentWalletStorage.swift @@ -7,7 +7,7 @@ final class RecentWalletsStorage { self.defaults = defaults } - var recentWallets: [Listing] { + var recentWallets: [Wallet] { get { loadRecentWallets() } @@ -16,16 +16,16 @@ final class RecentWalletsStorage { } } - func loadRecentWallets() -> [Listing] { + func loadRecentWallets() -> [Wallet] { guard let data = defaults.data(forKey: "recentWallets"), - let wallets = try? JSONDecoder().decode([Listing].self, from: data) + let wallets = try? JSONDecoder().decode([Wallet].self, from: data) else { return [] } - return wallets.filter { listing in - guard let lastTimeUsed = listing.lastTimeUsed else { + return wallets.filter { wallet in + guard let lastTimeUsed = wallet.lastTimeUsed else { assertionFailure("Shouldn't happen we stored wallet without `lastTimeUsed`") return false } @@ -35,9 +35,9 @@ final class RecentWalletsStorage { } } - func saveRecentWallets(_ listings: [Listing]) { + func saveRecentWallets(_ wallets: [Wallet]) { - let subset = Array(listings.filter { + let subset = Array(wallets.filter { $0.lastTimeUsed != nil }.prefix(5)) diff --git a/Sources/WalletConnectModal/Modal/Screens/GetAWalletView.swift b/Sources/WalletConnectModal/Modal/Screens/GetAWalletView.swift index b5f2c7438..0255cd648 100644 --- a/Sources/WalletConnectModal/Modal/Screens/GetAWalletView.swift +++ b/Sources/WalletConnectModal/Modal/Screens/GetAWalletView.swift @@ -1,8 +1,8 @@ import SwiftUI struct GetAWalletView: View { - let wallets: [Listing] - let onWalletTap: (Listing) -> Void + let wallets: [Wallet] + let onWalletTap: (Wallet) -> Void let navigateToExternalLink: (URL) -> Void var body: some View { @@ -71,7 +71,7 @@ struct GetAWalletView: View { struct GetAWalletView_Previews: PreviewProvider { static var previews: some View { GetAWalletView( - wallets: Listing.stubList, + wallets: Wallet.stubList, onWalletTap: { _ in }, navigateToExternalLink: { _ in } ) diff --git a/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift b/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift index 4b146927c..a00d14731 100644 --- a/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift +++ b/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift @@ -15,22 +15,22 @@ final class WalletDetailViewModel: ObservableObject { case didTapAppStore } - let wallet: Listing + let wallet: Wallet let deeplinkHandler: WalletDeeplinkHandler @Published var preferredPlatform: Platform = .native - var showToggle: Bool { wallet.app.browser != nil && wallet.app.ios != nil } - var showUniversalLink: Bool { preferredPlatform == .native && wallet.mobile.universal?.isEmpty == false } - var hasNativeLink: Bool { wallet.mobile.native?.isEmpty == false } + var showToggle: Bool { wallet.webappLink != nil && wallet.appStore != nil } + var showUniversalLink: Bool { preferredPlatform == .native && wallet.mobileLink?.isEmpty == false } + var hasNativeLink: Bool { wallet.mobileLink?.isEmpty == false } init( - wallet: Listing, + wallet: Wallet, deeplinkHandler: WalletDeeplinkHandler ) { self.wallet = wallet self.deeplinkHandler = deeplinkHandler - preferredPlatform = wallet.app.ios != nil ? .native : .browser + preferredPlatform = wallet.appStore != nil ? .native : .browser } func handle(_ event: Event) { diff --git a/Sources/WalletConnectModal/Modal/Screens/WalletList.swift b/Sources/WalletConnectModal/Modal/Screens/WalletList.swift index 55ba54c2a..7d4b58f0e 100644 --- a/Sources/WalletConnectModal/Modal/Screens/WalletList.swift +++ b/Sources/WalletConnectModal/Modal/Screens/WalletList.swift @@ -1,16 +1,45 @@ import SwiftUI struct WalletList: View { - @Binding var wallets: [Listing] + @Binding var destination: Destination + @ObservedObject var viewModel: ModalViewModel + var navigateTo: (Destination) -> Void - var onListingTap: (Listing) -> Void + var onWalletTap: (Wallet) -> Void @State var numberOfColumns = 4 - @State var availableSize: CGSize = .zero + init( + destination: Binding, + viewModel: ModalViewModel, + navigateTo: @escaping (Destination) -> Void, + onWalletTap: @escaping (Wallet) -> Void, + numberOfColumns: Int = 4, + availableSize: CGSize = .zero, + infiniteScrollLoading: Bool = false + ) { + self._destination = destination + self.viewModel = viewModel + self.navigateTo = navigateTo + self.onWalletTap = onWalletTap + self.numberOfColumns = numberOfColumns + self.availableSize = availableSize + self.infiniteScrollLoading = infiniteScrollLoading + + if #available(iOS 14.0, *) { + // iOS 14 doesn't have extra separators below the list by default. + } else { + // To remove only extra separators below the list: + UITableView.appearance().tableFooterView = UIView() + } + + // To remove all separators including the actual ones: + UITableView.appearance().separatorStyle = .none + } + var body: some View { ZStack { content() @@ -23,6 +52,7 @@ struct WalletList: View { numberOfColumns = Int(round(size.width / 100)) availableSize = size } + } } @@ -47,16 +77,16 @@ struct WalletList: View { VStack { HStack { - ForEach(wallets.prefix(numberOfColumns)) { wallet in + ForEach(viewModel.filteredWallets.prefix(numberOfColumns)) { wallet in gridItem(for: wallet) } } HStack { - ForEach(wallets.dropFirst(numberOfColumns).prefix(max(numberOfColumns - 1, 0))) { wallet in + ForEach(viewModel.filteredWallets.dropFirst(numberOfColumns).prefix(max(numberOfColumns - 1, 0))) { wallet in gridItem(for: wallet) } - if wallets.count > numberOfColumns * 2 { + if viewModel.filteredWallets.count > numberOfColumns * 2 { viewAllItem() .onTapGestureBackported { withAnimation { @@ -67,32 +97,52 @@ struct WalletList: View { } } - if wallets.isEmpty { + if viewModel.filteredWallets.isEmpty { ActivityIndicator(isAnimating: .constant(true)) } } } + @State var infiniteScrollLoading = false + @ViewBuilder private func viewAll() -> some View { ZStack { Spacer().frame(maxWidth: .infinity, maxHeight: 150) - ScrollView(.vertical) { - VStack(alignment: .leading) { - ForEach(Array(stride(from: 0, to: wallets.count, by: numberOfColumns)), id: \.self) { row in - HStack { - ForEach(row ..< (row + numberOfColumns), id: \.self) { index in - if let wallet = wallets[safe: index] { - gridItem(for: wallet) - } + List { + ForEach(Array(stride(from: 0, to: viewModel.filteredWallets.count, by: numberOfColumns)), id: \.self) { row in + HStack { + ForEach(row ..< (row + numberOfColumns), id: \.self) { index in + if let wallet = viewModel.filteredWallets[safe: index] { + gridItem(for: wallet) } } } } - .padding(.vertical) + .listRowInsets(EdgeInsets(top: 0, leading: 24, bottom: 8, trailing: 24)) + .transform { + if #available(iOS 15.0, *) { + $0.listRowSeparator(.hidden) + } + } + + if viewModel.isThereMoreWallets { + Color.clear.frame(height: 100) + .onAppear { + Task { + await viewModel.fetchWallets() + } + } + .transform { + if #available(iOS 15.0, *) { + $0.listRowSeparator(.hidden) + } + } + } } - + .listStyle(.plain) + LinearGradient( stops: [ .init(color: .background1, location: 0.0), @@ -112,7 +162,7 @@ struct WalletList: View { func viewAllItem() -> some View { VStack { VStack(spacing: 3) { - let viewAllWalletsFirstRow = wallets.dropFirst(2 * numberOfColumns - 1).prefix(2) + let viewAllWalletsFirstRow = viewModel.filteredWallets.dropFirst(2 * numberOfColumns - 1).prefix(2) HStack(spacing: 3) { ForEach(viewAllWalletsFirstRow) { wallet in @@ -123,7 +173,7 @@ struct WalletList: View { } .padding(.horizontal, 5) - let viewAllWalletsSecondRow = wallets.dropFirst(2 * numberOfColumns + 1).prefix(2) + let viewAllWalletsSecondRow = viewModel.filteredWallets.dropFirst(2 * numberOfColumns + 1).prefix(2) HStack(spacing: 3) { ForEach(viewAllWalletsSecondRow) { wallet in @@ -155,7 +205,7 @@ struct WalletList: View { } @ViewBuilder - func gridItem(for wallet: Listing) -> some View { + func gridItem(for wallet: Wallet) -> some View { VStack { WalletImage(wallet: wallet) .frame(width: 60, height: 60) @@ -171,7 +221,7 @@ struct WalletList: View { .multilineTextAlignment(.center) Text(wallet.lastTimeUsed != nil ? "RECENT" : "INSTALLED") - .opacity(wallet.lastTimeUsed != nil || wallet.installed ? 1 : 0) + .opacity(wallet.lastTimeUsed != nil || wallet.isInstalled ? 1 : 0) .font(.system(size: 10)) .foregroundColor(.foreground3) .padding(.horizontal, 12) @@ -183,7 +233,7 @@ struct WalletList: View { // Small delay to let detail screen present before actually deeplinking DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { - onListingTap(wallet) + onWalletTap(wallet) } } } diff --git a/Sources/WalletConnectModal/Networking/Explorer/ExplorerAPI.swift b/Sources/WalletConnectModal/Networking/Explorer/ExplorerAPI.swift deleted file mode 100644 index f52a3db67..000000000 --- a/Sources/WalletConnectModal/Networking/Explorer/ExplorerAPI.swift +++ /dev/null @@ -1,55 +0,0 @@ -import Foundation - -enum ExplorerAPI: HTTPService { - case getListings( - projectId: String, - metadata: AppMetadata, - recommendedIds: [String], - excludedIds: [String] - ) - - var path: String { - switch self { - case .getListings: return "/w3m/v1/getiOSListings" - } - } - - var method: HTTPMethod { - switch self { - case .getListings: return .get - } - } - - var body: Data? { - nil - } - - var queryParameters: [String: String]? { - switch self { - case let .getListings(projectId, _, recommendedIds, excludedIds): - return [ - "projectId": projectId, - "recommendedIds": recommendedIds.joined(separator: ","), - "excludedIds": excludedIds.joined(separator: ","), - "sdkType": "wcm", - "sdkVersion": EnvironmentInfo.sdkName, - ] - .compactMapValues { value in - value.isEmpty ? nil : value - } - } - } - - var scheme: String { - return "https" - } - - var additionalHeaderFields: [String: String]? { - switch self { - case let .getListings(_, metadata, _, _): - return [ - "Referer": metadata.name - ] - } - } -} diff --git a/Sources/WalletConnectModal/Networking/Explorer/GetIosDataResponse.swift b/Sources/WalletConnectModal/Networking/Explorer/GetIosDataResponse.swift new file mode 100644 index 000000000..31445bebd --- /dev/null +++ b/Sources/WalletConnectModal/Networking/Explorer/GetIosDataResponse.swift @@ -0,0 +1,11 @@ +import Foundation + +struct GetIosDataResponse: Codable { + let count: Int + let data: [WalletMetadata] + + struct WalletMetadata: Codable { + let id: String + let ios_schema: String + } +} diff --git a/Sources/WalletConnectModal/Networking/Explorer/GetWalletsResponse.swift b/Sources/WalletConnectModal/Networking/Explorer/GetWalletsResponse.swift new file mode 100644 index 000000000..02d84ed88 --- /dev/null +++ b/Sources/WalletConnectModal/Networking/Explorer/GetWalletsResponse.swift @@ -0,0 +1,87 @@ +import Foundation + +struct GetWalletsResponse: Codable { + let count: Int + let data: [Wallet] +} + +class Wallet: Codable, Identifiable, Hashable { + let id: String + let name: String + let homepage: String + let imageId: String + let order: Int + let mobileLink: String? + let desktopLink: String? + let webappLink: String? + let appStore: String? + + var lastTimeUsed: Date? + var isInstalled: Bool = false + + enum CodingKeys: String, CodingKey { + case id + case name + case homepage + case imageId = "image_id" + case order + case mobileLink = "mobile_link" + case desktopLink = "desktop_link" + case webappLink = "webapp_link" + case appStore = "app_store" + + // Decorated + case lastTimeUsed + case isInstalled + } + + init( + id: String, + name: String, + homepage: String, + imageId: String, + order: Int, + mobileLink: String? = nil, + desktopLink: String? = nil, + webappLink: String? = nil, + appStore: String? = nil, + lastTimeUsed: Date? = nil, + isInstalled: Bool = false + ) { + self.id = id + self.name = name + self.homepage = homepage + self.imageId = imageId + self.order = order + self.mobileLink = mobileLink + self.desktopLink = desktopLink + self.webappLink = webappLink + self.appStore = appStore + self.lastTimeUsed = lastTimeUsed + self.isInstalled = isInstalled + } + + required init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + self.id = try container.decode(String.self, forKey: .id) + self.name = try container.decode(String.self, forKey: .name) + self.homepage = try container.decode(String.self, forKey: .homepage) + self.imageId = try container.decode(String.self, forKey: .imageId) + self.order = try container.decode(Int.self, forKey: .order) + self.mobileLink = try container.decodeIfPresent(String.self, forKey: .mobileLink) + self.desktopLink = try container.decodeIfPresent(String.self, forKey: .desktopLink) + self.webappLink = try container.decodeIfPresent(String.self, forKey: .webappLink) + self.appStore = try container.decodeIfPresent(String.self, forKey: .appStore) + self.lastTimeUsed = try container.decodeIfPresent(Date.self, forKey: .lastTimeUsed) + self.isInstalled = try container.decodeIfPresent(Bool.self, forKey: .isInstalled) ?? false + } + + func hash(into hasher: inout Hasher) { + hasher.combine(id) + hasher.combine(name) + } + + static func == (lhs: Wallet, rhs: Wallet) -> Bool { + lhs.id == rhs.id && lhs.name == rhs.name + } +} diff --git a/Sources/WalletConnectModal/Networking/Explorer/ListingsResponse.swift b/Sources/WalletConnectModal/Networking/Explorer/ListingsResponse.swift deleted file mode 100644 index 0ddd4446c..000000000 --- a/Sources/WalletConnectModal/Networking/Explorer/ListingsResponse.swift +++ /dev/null @@ -1,74 +0,0 @@ -import Foundation - -struct ListingsResponse: Codable { - let listings: [String: Listing] -} - -class Listing: Codable, Hashable, Identifiable { - init( - id: String, - name: String, - homepage: String, - order: Int? = nil, - imageId: String, - app: Listing.App, - mobile: Listing.Links, - desktop: Listing.Links, - lastTimeUsed: Date? = nil, - installed: Bool = false - ) { - self.id = id - self.name = name - self.homepage = homepage - self.order = order - self.imageId = imageId - self.app = app - self.mobile = mobile - self.desktop = desktop - self.lastTimeUsed = lastTimeUsed - self.installed = installed - } - - func hash(into hasher: inout Hasher) { - hasher.combine(id) - hasher.combine(name) - } - - static func == (lhs: Listing, rhs: Listing) -> Bool { - lhs.id == rhs.id && lhs.name == rhs.name - } - - let id: String - let name: String - let homepage: String - let order: Int? - let imageId: String - let app: App - let mobile: Links - let desktop: Links - - var lastTimeUsed: Date? - var installed: Bool = false - - private enum CodingKeys: String, CodingKey { - case id - case name - case homepage - case order - case imageId = "image_id" - case app - case mobile - case desktop - case lastTimeUsed - } - - struct App: Codable, Hashable { - let ios: String? - let browser: String? - } - - struct Links: Codable, Hashable { - let native: String? - let universal: String? - } -} diff --git a/Sources/WalletConnectModal/Networking/Explorer/Web3ModalAPI.swift b/Sources/WalletConnectModal/Networking/Explorer/Web3ModalAPI.swift new file mode 100644 index 000000000..e2c63128a --- /dev/null +++ b/Sources/WalletConnectModal/Networking/Explorer/Web3ModalAPI.swift @@ -0,0 +1,84 @@ +import Foundation + +enum Web3ModalAPI: HTTPService { + struct GetWalletsParams { + let page: Int + let entries: Int + let search: String? + let projectId: String + let metadata: AppMetadata + let recommendedIds: [String] + let excludedIds: [String] + } + + struct GetIosDataParams { + let projectId: String + let metadata: AppMetadata + } + + case getWallets(params: GetWalletsParams) + case getIosData(params: GetIosDataParams) + + var path: String { + switch self { + case .getWallets: return "/getWallets" + case .getIosData: return "/getIosData" + } + } + + var method: HTTPMethod { + switch self { + case .getWallets: return .get + case .getIosData: return .get + } + } + + var body: Data? { + nil + } + + var queryParameters: [String: String]? { + switch self { + case let .getWallets(params): + return [ + "page": "\(params.page)", + "entries": "\(params.entries)", + "search": params.search ?? "", + "recommendedIds": params.recommendedIds.joined(separator: ","), + "excludedIds": params.excludedIds.joined(separator: ","), + "platform": "ios", + ] + .compactMapValues { value in + value.isEmpty ? nil : value + } + case let .getIosData(params): + return [ + "projectId": params.projectId, + "metadata": params.metadata.name + ] + } + } + + var scheme: String { + return "https" + } + + var additionalHeaderFields: [String: String]? { + switch self { + case let .getWallets(params): + return [ + "x-project-id": params.projectId, + "x-sdk-version": WalletConnectModal.Config.sdkVersion, + "x-sdk-type": WalletConnectModal.Config.sdkType, + "Referer": params.metadata.name + ] + case let .getIosData(params): + return [ + "x-project-id": params.projectId, + "x-sdk-version": WalletConnectModal.Config.sdkVersion, + "x-sdk-type": WalletConnectModal.Config.sdkType, + "Referer": params.metadata.name + ] + } + } +} diff --git a/Sources/WalletConnectModal/UI/WalletImage.swift b/Sources/WalletConnectModal/UI/WalletImage.swift index cd70dae0a..9b142eab0 100644 --- a/Sources/WalletConnectModal/UI/WalletImage.swift +++ b/Sources/WalletConnectModal/UI/WalletImage.swift @@ -10,7 +10,7 @@ struct WalletImage: View { @Environment(\.projectId) var projectId - var wallet: Listing? + var wallet: Wallet? var size: Size = .medium var body: some View { @@ -24,7 +24,7 @@ struct WalletImage: View { } } - private func imageURL(for wallet: Listing?) -> URL? { + private func imageURL(for wallet: Wallet?) -> URL? { guard let wallet else { return nil } diff --git a/Sources/WalletConnectModal/WalletConnectModal.swift b/Sources/WalletConnectModal/WalletConnectModal.swift index 87085fcf5..c74e5c884 100644 --- a/Sources/WalletConnectModal/WalletConnectModal.swift +++ b/Sources/WalletConnectModal/WalletConnectModal.swift @@ -34,6 +34,9 @@ public class WalletConnectModal { }() struct Config { + static let sdkVersion: String = "swift-\(EnvironmentInfo.packageVersion)" + static let sdkType = "wcm" + let projectId: String var metadata: AppMetadata var sessionParams: SessionParams From 2d087357b5b4409117c7e650ac0eb4d533ebaeaf Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Tue, 19 Dec 2023 12:28:19 +0100 Subject: [PATCH 301/814] Fix tests --- .../Modal/ModalViewModel.swift | 17 ++---- .../WalletDetail/WalletDetailViewModel.swift | 25 ++++----- .../ExplorerAPITests.swift | 14 ++++- .../Mocks/ModalSheetInteractorMock.swift | 10 ++-- .../ModalViewModelTests.swift | 55 +++++++------------ 5 files changed, 51 insertions(+), 70 deletions(-) diff --git a/Sources/WalletConnectModal/Modal/ModalViewModel.swift b/Sources/WalletConnectModal/Modal/ModalViewModel.swift index 5232c1156..e78aa56e1 100644 --- a/Sources/WalletConnectModal/Modal/ModalViewModel.swift +++ b/Sources/WalletConnectModal/Modal/ModalViewModel.swift @@ -282,7 +282,7 @@ private extension ModalViewModel { protocol WalletDeeplinkHandler { func openAppstore(wallet: Wallet) - func navigateToDeepLink(wallet: Wallet, preferUniversal: Bool, preferBrowser: Bool) + func navigateToDeepLink(wallet: Wallet, preferBrowser: Bool) } extension ModalViewModel: WalletDeeplinkHandler { @@ -295,26 +295,17 @@ extension ModalViewModel: WalletDeeplinkHandler { uiApplicationWrapper.openURL(storeLink, nil) } - func navigateToDeepLink(wallet: Wallet, preferUniversal: Bool, preferBrowser: Bool) { + func navigateToDeepLink(wallet: Wallet, preferBrowser: Bool) { do { - let nativeScheme = preferBrowser ? nil : wallet.mobileLink - let universalScheme = preferBrowser ? wallet.desktopLink : wallet.mobileLink - + let nativeScheme = preferBrowser ? wallet.webappLink : wallet.mobileLink let nativeUrlString = try formatNativeUrlString(nativeScheme) - let universalUrlString = try formatUniversalUrlString(universalScheme) - if let nativeUrl = nativeUrlString?.toURL(), !preferUniversal { + if let nativeUrl = nativeUrlString?.toURL() { uiApplicationWrapper.openURL(nativeUrl) { success in if !success { self.toast = Toast(style: .error, message: DeeplinkErrors.failedToOpen.localizedDescription) } } - } else if let universalUrl = universalUrlString?.toURL() { - uiApplicationWrapper.openURL(universalUrl) { success in - if !success { - self.toast = Toast(style: .error, message: DeeplinkErrors.failedToOpen.localizedDescription) - } - } } else { throw DeeplinkErrors.noWalletLinkFound } diff --git a/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift b/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift index a00d14731..96d5519d3 100644 --- a/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift +++ b/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift @@ -36,28 +36,23 @@ final class WalletDetailViewModel: ObservableObject { func handle(_ event: Event) { switch event { case .onAppear: - deeplinkHandler.navigateToDeepLink( - wallet: wallet, - preferUniversal: true, - preferBrowser: preferredPlatform == .browser - ) + deeplinkToWallet() case .didTapUniversalLink: - deeplinkHandler.navigateToDeepLink( - wallet: wallet, - preferUniversal: true, - preferBrowser: preferredPlatform == .browser - ) + deeplinkToWallet() case .didTapTryAgain: - deeplinkHandler.navigateToDeepLink( - wallet: wallet, - preferUniversal: false, - preferBrowser: preferredPlatform == .browser - ) + deeplinkToWallet() case .didTapAppStore: deeplinkHandler.openAppstore(wallet: wallet) } } + + func deeplinkToWallet() { + deeplinkHandler.navigateToDeepLink( + wallet: wallet, + preferBrowser: preferredPlatform == .browser + ) + } } diff --git a/Tests/WalletConnectModalTests/ExplorerAPITests.swift b/Tests/WalletConnectModalTests/ExplorerAPITests.swift index 14f0f6bf5..6ee709e9c 100644 --- a/Tests/WalletConnectModalTests/ExplorerAPITests.swift +++ b/Tests/WalletConnectModalTests/ExplorerAPITests.swift @@ -6,8 +6,18 @@ final class ExplorerAPITests: XCTestCase { func testCorrectMappingOfWalletIds() throws { - let request = ExplorerAPI - .getListings(projectId: "123", metadata: .stub(), recommendedIds: ["foo", "bar"], excludedIds: ["boo", "far"]) + let request = Web3ModalAPI + .getWallets( + params: .init( + page: 0, + entries: 0, + search: "", + projectId: "123", + metadata: .stub(), + recommendedIds: ["foo", "bar"], + excludedIds: ["boo", "far"] + ) + ) .resolve(for: "www.google.com") XCTAssertEqual(request?.allHTTPHeaderFields?["Referer"], "Wallet Connect") diff --git a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift index bfc9a34b6..23ed24b76 100644 --- a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift +++ b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift @@ -7,14 +7,14 @@ import WalletConnectSign final class ModalSheetInteractorMock: ModalSheetInteractor { - var listings: [Listing] + var wallets: [Wallet] - init(listings: [Listing] = Listing.stubList) { - self.listings = listings + init(wallets: [Wallet] = Wallet.stubList) { + self.wallets = wallets } - func getListings() async throws -> [Listing] { - listings + func getWallets(page: Int, entries: Int) async throws -> (Int, [Wallet]) { + (1, wallets) } func createPairingAndConnect() async throws -> WalletConnectURI? { diff --git a/Tests/WalletConnectModalTests/ModalViewModelTests.swift b/Tests/WalletConnectModalTests/ModalViewModelTests.swift index 2b9fd7c89..5af6a0e2d 100644 --- a/Tests/WalletConnectModalTests/ModalViewModelTests.swift +++ b/Tests/WalletConnectModalTests/ModalViewModelTests.swift @@ -17,44 +17,28 @@ final class ModalViewModelTests: XCTestCase { sut = .init( isShown: .constant(true), - interactor: ModalSheetInteractorMock(listings: [ - Listing( + interactor: ModalSheetInteractorMock(wallets: [ + Wallet( id: "1", name: "Sample App", - homepage: "https://example.com", + homepage: "https://example.com/cool", + imageId: "0528ee7e-16d1-4089-21e3-bbfb41933100", order: 1, - imageId: "1", - app: Listing.App( - ios: "https://example.com/download-ios", - browser: "https://example.com/wallet" - ), - mobile: Listing.Links( - native: nil, - universal: "https://example.com/universal" - ), - desktop: Listing.Links( - native: nil, - universal: "https://example.com/universal" - ) + mobileLink: "https://example.com/universal/", + desktopLink: "sampleapp://deeplink", + webappLink: "https://sample.com/foo/webapp", + appStore: "" ), - Listing( + Wallet( id: "2", name: "Awesome App", - homepage: "https://example.com/awesome", + homepage: "https://example.com/cool", + imageId: "5195e9db-94d8-4579-6f11-ef553be95100", order: 2, - imageId: "2", - app: Listing.App( - ios: "https://example.com/download-ios", - browser: "https://example.com/wallet" - ), - mobile: Listing.Links( - native: "awesomeapp://deeplink", - universal: "https://awesome.com/awesome/universal" - ), - desktop: Listing.Links( - native: "awesomeapp://deeplink", - universal: "https://awesome.com/awesome/desktop/universal" - ) + mobileLink: "awesomeapp://deeplink", + desktopLink: "awesomeapp://deeplink", + webappLink: "https://awesome.com/awesome/universal/", + appStore: "" ), ]), uiApplicationWrapper: .init( @@ -87,9 +71,9 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual(sut.wallets.map(\.id), ["1", "2"]) XCTAssertEqual(sut.wallets.map(\.name), ["Sample App", "Awesome App"]) - expectation = XCTestExpectation(description: "Wait for openUrl to be called") + expectation = XCTestExpectation(description: "Wait for openUrl to be called using native link") - sut.navigateToDeepLink(wallet: sut.wallets[0], preferUniversal: true, preferBrowser: false) + sut.navigateToDeepLink(wallet: sut.wallets[1], preferBrowser: false) XCTWaiter.wait(for: [expectation], timeout: 3) XCTAssertEqual( @@ -105,11 +89,12 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual( openURLFuncTest.currentValue, URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! + URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn")! ) - expectation = XCTestExpectation(description: "Wait for openUrl to be called using native link") + expectation = XCTestExpectation(description: "Wait for openUrl to be called using webapp link") - sut.navigateToDeepLink(wallet: sut.wallets[1], preferUniversal: true, preferBrowser: false) + sut.navigateToDeepLink(wallet: sut.wallets[1], preferBrowser: true) XCTWaiter.wait(for: [expectation], timeout: 3) XCTAssertEqual( From 49403f76771a171208d882390d3aed85f715ce98 Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Thu, 28 Dec 2023 16:57:25 +0100 Subject: [PATCH 302/814] Fix tests --- .../WalletConnectModalTests/ExplorerAPITests.swift | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/Tests/WalletConnectModalTests/ExplorerAPITests.swift b/Tests/WalletConnectModalTests/ExplorerAPITests.swift index 6ee709e9c..26bdb83e9 100644 --- a/Tests/WalletConnectModalTests/ExplorerAPITests.swift +++ b/Tests/WalletConnectModalTests/ExplorerAPITests.swift @@ -9,8 +9,8 @@ final class ExplorerAPITests: XCTestCase { let request = Web3ModalAPI .getWallets( params: .init( - page: 0, - entries: 0, + page: 2, + entries: 40, search: "", projectId: "123", metadata: .stub(), @@ -21,13 +21,16 @@ final class ExplorerAPITests: XCTestCase { .resolve(for: "www.google.com") XCTAssertEqual(request?.allHTTPHeaderFields?["Referer"], "Wallet Connect") + XCTAssertEqual(request?.allHTTPHeaderFields?["x-sdk-version"], WalletConnectModal.Config.sdkVersion) + XCTAssertEqual(request?.allHTTPHeaderFields?["x-sdk-type"], "wcm") + XCTAssertEqual(request?.allHTTPHeaderFields?["x-project-id"], "123") XCTAssertEqual(request?.url?.queryParameters, [ - "projectId": "123", "recommendedIds": "foo,bar", + "page": "2", + "entries": "40", + "platform": "ios", "excludedIds": "boo,far", - "sdkVersion": EnvironmentInfo.sdkName, - "sdkType": "wcm" ]) } } From 33a036fbb1618804ccf99e13fa5c9e82e5ac06ff Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Mon, 22 Jan 2024 19:39:29 +0100 Subject: [PATCH 303/814] pr feedback --- Example/DApp/Modules/Sign/SignPresenter.swift | 10 ++++------ .../Screens/WalletDetail/WalletDetailViewModel.swift | 9 +-------- .../WalletConnectModal/Modal/Screens/WalletList.swift | 4 ++-- 3 files changed, 7 insertions(+), 16 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 896f50442..e96791894 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -54,12 +54,10 @@ final class SignPresenter: ObservableObject { } func connectWalletWithWCM() { - Task { - WalletConnectModal.set(sessionParams: .init( - requiredNamespaces: Proposal.requiredNamespaces, - optionalNamespaces: Proposal.optionalNamespaces - )) - } + WalletConnectModal.set(sessionParams: .init( + requiredNamespaces: Proposal.requiredNamespaces, + optionalNamespaces: Proposal.optionalNamespaces + )) WalletConnectModal.present(from: nil) } diff --git a/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift b/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift index 96d5519d3..f1ee61ac5 100644 --- a/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift +++ b/Sources/WalletConnectModal/Modal/Screens/WalletDetail/WalletDetailViewModel.swift @@ -35,15 +35,8 @@ final class WalletDetailViewModel: ObservableObject { func handle(_ event: Event) { switch event { - case .onAppear: + case .onAppear, .didTapUniversalLink, .didTapTryAgain: deeplinkToWallet() - - case .didTapUniversalLink: - deeplinkToWallet() - - case .didTapTryAgain: - deeplinkToWallet() - case .didTapAppStore: deeplinkHandler.openAppstore(wallet: wallet) } diff --git a/Sources/WalletConnectModal/Modal/Screens/WalletList.swift b/Sources/WalletConnectModal/Modal/Screens/WalletList.swift index 7d4b58f0e..96efd6a13 100644 --- a/Sources/WalletConnectModal/Modal/Screens/WalletList.swift +++ b/Sources/WalletConnectModal/Modal/Screens/WalletList.swift @@ -33,11 +33,11 @@ struct WalletList: View { // iOS 14 doesn't have extra separators below the list by default. } else { // To remove only extra separators below the list: - UITableView.appearance().tableFooterView = UIView() + UITableView.appearance(whenContainedInInstancesOf: [WalletConnectModalSheetController.self]).tableFooterView = UIView() } // To remove all separators including the actual ones: - UITableView.appearance().separatorStyle = .none + UITableView.appearance(whenContainedInInstancesOf: [WalletConnectModalSheetController.self]).separatorStyle = .none } var body: some View { From b2b63d1eceab3dd0be0e2533dcecace09801e851 Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Mon, 29 Jan 2024 12:54:31 +0100 Subject: [PATCH 304/814] Fix tests --- Tests/WalletConnectModalTests/ModalViewModelTests.swift | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/Tests/WalletConnectModalTests/ModalViewModelTests.swift b/Tests/WalletConnectModalTests/ModalViewModelTests.swift index 5af6a0e2d..a7ec21f6d 100644 --- a/Tests/WalletConnectModalTests/ModalViewModelTests.swift +++ b/Tests/WalletConnectModalTests/ModalViewModelTests.swift @@ -78,18 +78,17 @@ final class ModalViewModelTests: XCTestCase { XCTAssertEqual( openURLFuncTest.currentValue, - URL(string: "https://example.com/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! + URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! ) expectation = XCTestExpectation(description: "Wait for openUrl to be called using universal link") - sut.navigateToDeepLink(wallet: sut.wallets[1], preferUniversal: false, preferBrowser: false) + sut.navigateToDeepLink(wallet: sut.wallets[1], preferBrowser: false) XCTWaiter.wait(for: [expectation], timeout: 3) XCTAssertEqual( openURLFuncTest.currentValue, URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! - URL(string: "awesomeapp://deeplinkwc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn")! ) expectation = XCTestExpectation(description: "Wait for openUrl to be called using webapp link") @@ -104,12 +103,12 @@ final class ModalViewModelTests: XCTestCase { expectation = XCTestExpectation(description: "Wait for openUrl to be called using native link") - sut.navigateToDeepLink(wallet: sut.wallets[1], preferUniversal: false, preferBrowser: true) + sut.navigateToDeepLink(wallet: sut.wallets[1], preferBrowser: true) XCTWaiter.wait(for: [expectation], timeout: 3) XCTAssertEqual( openURLFuncTest.currentValue, - URL(string: "https://awesome.com/awesome/desktop/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! + URL(string: "https://awesome.com/awesome/universal/wc?uri=wc%3Afoo%402%3FsymKey%3Dbar%26relay-protocol%3Dirn%26expiryTimestamp%3D1706001526")! ) } } From 11c1463b093925eaeaadd613a6312a91c2ead763 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Jan 2024 13:24:49 +0100 Subject: [PATCH 305/814] add SessionNamespaceBuilderTests --- Sources/WalletConnectUtils/Cacao/Cacao.swift | 31 +++++++++ .../SessionNamespaceBuilderTests.swift | 65 +++++++++++++++++++ 2 files changed, 96 insertions(+) create mode 100644 Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift diff --git a/Sources/WalletConnectUtils/Cacao/Cacao.swift b/Sources/WalletConnectUtils/Cacao/Cacao.swift index 5c938594b..7a9edf812 100644 --- a/Sources/WalletConnectUtils/Cacao/Cacao.swift +++ b/Sources/WalletConnectUtils/Cacao/Cacao.swift @@ -14,3 +14,34 @@ public struct Cacao: Codable, Equatable { self.s = s } } + +#if DEBUG +extension Cacao { + static func stub( + account: Account = Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, + resources: [String] = ["https://example.com/my-web2-claim.json"] + ) -> Cacao { + let header = CacaoHeader(t: "caip122") + let payload = CacaoPayload( + iss: "did:pkh:\(account.absoluteString)", + domain: "service.invalid", + aud: "https://service.invalid/login", + version: "1", + nonce: "32891756", + iat: "2024-01-29T08:54:38Z", + nbf: nil, + exp: nil, + statement: "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", + requestId: nil, + resources: resources + ) + let signature = CacaoSignature( + t: WalletConnectUtils.CacaoSignatureType.eip191, + s: "invalid_signature", + m: nil + ) + + return Cacao(h: header, p: payload, s: signature) + } +} +#endif diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift new file mode 100644 index 000000000..c6a24f1db --- /dev/null +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -0,0 +1,65 @@ +import XCTest +@testable import WalletConnectSign +@testable import WalletConnectUtils + +class SessionNamespaceBuilderTests: XCTestCase { + var sessionNamespaceBuilder: SessionNamespaceBuilder! + var logger: ConsoleLogging! + + // dedoded recap: {"att":{"eip155":{"request/eth_sign":[],"request/personal_sign":[],"request/eth_signTypedData":[]}}} + let recapUrn = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NpZ24iOltdLCJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOltdLCJyZXF1ZXN0L2V0aF9zaWduVHlwZWREYXRhIjpbXX19fQ==" + + override func setUp() { + super.setUp() + logger = ConsoleLoggerMock() + sessionNamespaceBuilder = SessionNamespaceBuilder(logger: logger) + } + + override func tearDown() { + sessionNamespaceBuilder = nil + logger = nil + super.tearDown() + } + + + func testBuildSessionNamespaces_ValidCacaos_ReturnsExpectedNamespace() { + let expectedSessionNamespace = SessionNamespace( + accounts: Set([ + Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, + Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! + ]), + methods: ["personal_sign", "eth_signTypedData", "eth_sign"], + events: [] + ) + let cacaos = [ + Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]), + Cacao.stub(account: Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]) + ] + + do { + let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: cacaos) + XCTAssertEqual(namespaces.count, 1, "There should be one namespace") + XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") + } catch { + XCTFail("Expected successful namespace creation, but received error: \(error)") + } + } + + func testBuildSessionNamespaces_MalformedRecap_ThrowsMalformedRecapError() { + let validResources = ["https://example.com/my-web2-claim.json", recapUrn] + let invalidResources = ["https://example.com/my-web2-claim.json"] + + let validCacao = Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: validResources) + let invalidCacao = Cacao.stub(account: Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: invalidResources) + + XCTAssertThrowsError(try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: [validCacao, invalidCacao])) { error in + guard let sessionError = error as? SessionNamespaceBuilder.Errors else { + return XCTFail("Expected a SessionNamespaceBuilder.Errors") + } + + XCTAssertEqual(sessionError, SessionNamespaceBuilder.Errors.malformedRecap, "Expected a malformedRecap error") + } + } + + +} From abaa83df342923e1cd3aa520d9e524623d4284e2 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 29 Jan 2024 19:36:01 +0300 Subject: [PATCH 306/814] Update NotifySubsctiptionsUpdater.swift --- .../Client/Wallet/NotifySubsctiptionsUpdater.swift | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift index 367e3b23a..6b48492d0 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifySubsctiptionsUpdater.swift @@ -42,9 +42,13 @@ final class NotifySubsctiptionsUpdater { try kms.setSymmetricKey(symKey, for: subscription.topic) } - let topics = newSubscriptions.map { $0.topic } + let topicsToSubscribe = newSubscriptions.map { $0.topic } - try await networkingInteractor.batchSubscribe(topics: topics) + let oldTopics = Set(oldSubscriptions.map { $0.topic }) + let topicsToUnsubscribe = Array(oldTopics.subtracting(topicsToSubscribe)) + + try await networkingInteractor.batchUnsubscribe(topics: topicsToUnsubscribe) + try await networkingInteractor.batchSubscribe(topics: topicsToSubscribe) try Task.checkCancellation() From 228613025e8f61610ca836a9b3e0d56b1b9ec039 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 29 Jan 2024 12:00:54 +0300 Subject: [PATCH 307/814] Listings query params updated --- .../WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift b/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift index c121e1e38..1d3eebf18 100644 --- a/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift +++ b/Example/WalletApp/BusinessLayer/ListingsSertice/ListingsAPI.swift @@ -16,7 +16,7 @@ enum ListingsAPI: HTTPService { } var queryParameters: [String : String]? { - return ["projectId": InputConfig.projectId, "entries": "100"] + return ["projectId": InputConfig.projectId, "isVerified": "true", "isFeatured": "true"] } var additionalHeaderFields: [String : String]? { From 8889de6b5cbf6c367b368519e39782fe28bc7fe1 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 29 Jan 2024 18:31:51 +0300 Subject: [PATCH 308/814] Body urls --- .../Wallet/PushMessages/SubscriptionView.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift index 890629513..647121270 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift @@ -77,7 +77,7 @@ struct SubscriptionView: View { .font(.system(size: 11)) } - Text(pushMessage.subtitle) + Text(.init(pushMessage.subtitle)) .foregroundColor(.Foreground175) .font(.system(size: 13)) From 28f667e2e52ae2ebef2aed3566b3f989d1d1d561 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 29 Jan 2024 21:38:12 +0300 Subject: [PATCH 309/814] Regression fixes --- .../Wallet/PushMessages/SubscriptionPresenter.swift | 3 ++- .../Wallet/PushMessages/SubscriptionView.swift | 3 ++- Sources/Database/SQLiteQuery.swift | 13 ++++++++++--- 3 files changed, 14 insertions(+), 5 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift index e5b69d57c..bfddfee6e 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift @@ -64,7 +64,8 @@ final class SubscriptionPresenter: ObservableObject { case .idle: Task(priority: .high) { @MainActor in loadingState = .loading - isMoreDataAvailable = try await interactor.fetchHistory(after: messages.last?.id, limit: 50) + let isLoaded = try? await interactor.fetchHistory(after: messages.last?.id, limit: 50) + isMoreDataAvailable = isLoaded ?? false loadingState = .idle } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift index 647121270..e68fcb5b6 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift @@ -49,7 +49,7 @@ struct SubscriptionView: View { private func notificationView(pushMessage: NotifyMessageViewModel) -> some View { VStack(alignment: .center) { HStack(spacing: 12) { - CacheAsyncImage(url: URL(string: pushMessage.imageUrl)) { phase in + CacheAsyncImage(url: URL(string: pushMessage.imageUrl) ?? presenter.subscriptionViewModel.imageUrl) { phase in if let image = phase.image { image .resizable() @@ -58,6 +58,7 @@ struct SubscriptionView: View { .cornerRadius(10, corners: .allCorners) } else { Color.black + .opacity(0.05) .frame(width: 48, height: 48) .cornerRadius(10, corners: .allCorners) } diff --git a/Sources/Database/SQLiteQuery.swift b/Sources/Database/SQLiteQuery.swift index ce2d8d920..ce6078410 100644 --- a/Sources/Database/SQLiteQuery.swift +++ b/Sources/Database/SQLiteQuery.swift @@ -7,7 +7,7 @@ public struct SqliteQuery { for row in rows { values.append(row.encode().values - .map { "'\($0.value)'" } + .map { "'\($0.value.screen())'" } .joined(separator: ", ")) } @@ -34,7 +34,7 @@ public struct SqliteQuery { } public static func select(table: String, where argument: String, equals value: String) -> String { - return "SELECT * FROM \(table) WHERE \(argument) = '\(value)';" + return "SELECT * FROM \(table) WHERE \(argument) = '\(value.screen())';" } public static func delete(table: String) -> String { @@ -42,7 +42,7 @@ public struct SqliteQuery { } public static func delete(table: String, where argument: String, equals value: String) -> String { - return "DELETE FROM \(table) WHERE \(argument) = '\(value)';" + return "DELETE FROM \(table) WHERE \(argument) = '\(value.screen())';" } } @@ -52,3 +52,10 @@ extension SqliteQuery { case rowsNotFound } } + +private extension String { + + func screen() -> String { + return replacingOccurrences(of: "'", with: "''") + } +} From 81deb47a66d3a56bc79a6980e4cfd00192be7667 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Mon, 29 Jan 2024 22:04:10 +0300 Subject: [PATCH 310/814] Notify imports fixed --- Package.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Package.swift b/Package.swift index d6d573c09..e3c3b7eb8 100644 --- a/Package.swift +++ b/Package.swift @@ -73,7 +73,7 @@ let package = Package( path: "Sources/Web3Wallet"), .target( name: "WalletConnectNotify", - dependencies: ["WalletConnectIdentity", "WalletConnectPush", "WalletConnectSigner", "Database"], + dependencies: ["WalletConnectPairing", "WalletConnectIdentity", "WalletConnectPush", "WalletConnectSigner", "Database"], path: "Sources/WalletConnectNotify"), .target( name: "WalletConnectPush", From e42ac02323e5ef79ad1867363e03f2d076693414 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 30 Jan 2024 08:09:16 +0100 Subject: [PATCH 311/814] savepoint --- .../ConnectionDetails/ConnectionDetailsInteractor.swift | 8 -------- .../PresentationLayer/Wallet/Main/MainInteractor.swift | 4 ++-- .../PresentationLayer/Wallet/Main/MainPresenter.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 4 files changed, 4 insertions(+), 12 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift index 320cf6d9f..aafd41678 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift @@ -3,14 +3,6 @@ import Combine import Web3Wallet final class ConnectionDetailsInteractor { - var requestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { - return Web3Wallet.instance.authRequestPublisher - } - - func pair(uri: WalletConnectURI) async throws { - try await Web3Wallet.instance.pair(uri: uri) - } - func disconnectSession(session: Session) async throws { try await Web3Wallet.instance.disconnect(topic: session.topic) } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift index 8b8c540b2..4624689be 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainInteractor.swift @@ -14,7 +14,7 @@ final class MainInteractor { return Web3Wallet.instance.sessionRequestPublisher } - var requestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { - return Web3Wallet.instance.authRequestPublisher + var authenticateRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { + return Web3Wallet.instance.authenticateRequestPublisher } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift index 3d5c8a0b6..54d8b9393 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift @@ -53,7 +53,7 @@ extension MainPresenter { router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) }.store(in: &disposeBag) - interactor.requestPublisher + interactor.authenticateRequestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] result in router.present(request: result.request, importAccount: importAccount, context: result.context) diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index b3cf2dbcf..dff8cf1e4 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -26,7 +26,7 @@ public class Web3WalletClient { /// Publisher that sends authentication requests /// /// Wallet should subscribe on events in order to receive auth requests. - public var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { + public var authenticateRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { signClient.authRequestPublisher.eraseToAnyPublisher() } From edb28f115728f891d066de6c0f30c6cc027abe9a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 30 Jan 2024 09:29:07 +0100 Subject: [PATCH 312/814] return session on approve --- .../Wallet/AuthRequest/AuthRequestInteractor.swift | 2 +- .../Auth/Services/Wallet/AuthResponder.swift | 9 +++------ Sources/WalletConnectSign/Sign/SignClient.swift | 4 ++-- Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 5 files changed, 8 insertions(+), 11 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift index 594bfa676..e852a3e18 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift @@ -37,7 +37,7 @@ final class AuthRequestInteractor { } - try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) + _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) /* Redirect */ if let uri = request.requester.redirect?.native { diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 8cc0d5dea..54b3cf29d 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -16,10 +16,6 @@ actor AuthResponder { private let metadata: AppMetadata private let sessionStore: WCSessionStorage private let sessionNamespaceBuilder: SessionNamespaceBuilder - private let sessionSettledPublisherSubject = PassthroughSubject() - var sessionSettledPublisher: AnyPublisher { - return sessionSettledPublisherSubject.eraseToAnyPublisher() - } init( networkingInteractor: NetworkInteracting, @@ -45,7 +41,7 @@ actor AuthResponder { self.sessionNamespaceBuilder = sessionNamespaceBuilder } - func respond(requestId: RPCID, auths: [Cacao]) async throws { + func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session { let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) let (responseTopic, responseKeys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) @@ -81,7 +77,8 @@ actor AuthResponder { ) verifyContextStore.delete(forKey: requestId.string) - sessionSettledPublisherSubject.send(session) + + return session } func respondError(requestId: RPCID) async throws { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index ab403e293..c5829a04f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -285,7 +285,7 @@ public final class SignClient: SignClientProtocol { /// For a dApp to propose an authenticated session to a wallet. /// Function will propose a session on existing pairing. - public func authenticate( + public func sessionAuthenticate( _ params: AuthRequestParams, topic: String ) async throws { @@ -329,7 +329,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws { + public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session { try await authResponder.respond(requestId: requestId, auths: auths) } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 8c2c1892b..bc4b43f91 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -24,7 +24,7 @@ public protocol SignClientProtocol { func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws - func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws + func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index dff8cf1e4..5751c7be8 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -207,7 +207,7 @@ public class Web3WalletClient { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws { + public func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session { try await signClient.approveSessionAuthenticate(requestId: requestId, auths: auths) } From 0a188021f8ecf0d0d15bc9fb5df382de1a65a2e9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 30 Jan 2024 09:55:52 +0100 Subject: [PATCH 313/814] return session on approve proposal fix tests --- .../IntegrationTests/Push/NotifyTests.swift | 576 +++++++++--------- .../Sign/SignClientTests.swift | 26 +- .../SessionProposalInteractor.swift | 2 +- .../Engine/Common/ApproveEngine.swift | 3 +- .../WalletConnectSign/Sign/SignClient.swift | 2 +- .../Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- .../ApproveEngineTests.swift | 4 +- ...uthenticatedSessionRecapFactoryTests.swift | 11 +- 9 files changed, 318 insertions(+), 310 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 1618881e6..0c5e5f81f 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -1,288 +1,288 @@ -import Foundation -import XCTest -import WalletConnectUtils -import Web3 -@testable import WalletConnectKMS -import WalletConnectRelay -import Combine -import WalletConnectNetworking -import WalletConnectPush -@testable import WalletConnectNotify -import WalletConnectIdentity -import WalletConnectSigner - -final class NotifyTests: XCTestCase { - - var walletNotifyClientA: NotifyClient! - - let gmDappDomain = InputConfig.gmDappHost - - var pk: EthereumPrivateKey! - - var privateKey: Data { - return Data(pk.rawPrivateKey) - } - - var account: Account { - return Account("eip155:1:" + pk.address.hex(eip55: true))! - } - - private var publishers = Set() - - func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { - let keychain = KeychainStorageMock() - let keyValueStorage = RuntimeKeyValueStorage() - - let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) - let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) - let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) - - let relayClient = RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - networkMonitor: NetworkMonitor(), - logger: relayLogger) - - let networkingClient = NetworkingClientFactory.create( - relayClient: relayClient, - logger: networkingLogger, - keychainStorage: keychain, - keyValueStorage: keyValueStorage, - kmsLogger: kmsLogger) - - let clientId = try! networkingClient.getClientId() - networkingLogger.debug("My client id is: \(clientId)") - return (networkingClient, keychain, keyValueStorage) - } - - func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { - let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) - let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) - let pushClient = PushClientFactory.create(projectId: "", - pushHost: "echo.walletconnect.com", - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - environment: .sandbox) - let keyserverURL = URL(string: "https://keys.walletconnect.com")! - let sqlite = try! MemorySqlite() - // Note:- prod project_id do not exists on staging, we can use gmDappProjectId - let client = NotifyClientFactory.create(projectId: InputConfig.gmDappProjectId, - keyserverURL: keyserverURL, - sqlite: sqlite, - logger: notifyLogger, - keychainStorage: keychain, - groupKeychainStorage: KeychainStorageMock(), - networkInteractor: networkingInteractor, - pushClient: pushClient, - crypto: DefaultCryptoProvider(), - notifyHost: InputConfig.notifyHost, - explorerHost: InputConfig.explorerHost) - return client - } - - override func setUp() { - pk = try! EthereumPrivateKey() - walletNotifyClientA = makeWalletClient() - publishers.removeAll() - } - - func testWalletCreatesSubscription() async throws { - let expectation = expectation(description: "expects to create notify subscription") - expectation.assertForOverFulfill = false - - var subscription: NotifySubscription? - - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - expectation.fulfill() - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - - if let subscription { - try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) - } - } - - func testNotifyWatchSubscriptions() async throws { - let expectation = expectation(description: "expects client B to receive subscription created by client A") - expectation.assertForOverFulfill = false - - var subscription: NotifySubscription? - - let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") - clientB.subscriptionsPublisher.sink { subscriptions in - subscription = subscriptions.first - expectation.fulfill() - }.store(in: &publishers) - - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) - - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - - if let subscription { - try await clientB.deleteSubscription(topic: subscription.topic) - } - } - - func testNotifySubscriptionChanged() async throws { - let expectation = expectation(description: "expects client B to receive subscription after both clients are registered and client A creates one") - expectation.assertForOverFulfill = false - - var subscription: NotifySubscription? - - let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") - clientB.subscriptionsPublisher.sink { subscriptions in - subscription = subscriptions.first - expectation.fulfill() - }.store(in: &publishers) - - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) - try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - - if let subscription { - try await clientB.deleteSubscription(topic: subscription.topic) - } - } - - func testWalletCreatesAndUpdatesSubscription() async throws { - let created = expectation(description: "Subscription created") - - let updated = expectation(description: "Subscription Updated") - - var isCreated = false - var isUpdated = false - var subscription: NotifySubscription! - - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - - if !isCreated { - isCreated = true - created.fulfill() - } else if !isUpdated { - isUpdated = true - updated.fulfill() - } - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) - - try await walletNotifyClientA.update(topic: subscription.topic, scope: []) - - await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) - - let updatedScope = subscription.scope.filter { $0.value.enabled == true } - XCTAssertTrue(updatedScope.isEmpty) - - try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) - } - - func testNotifyServerSubscribeAndNotifies() async throws { - let subscribeExpectation = expectation(description: "creates notify subscription") - let messageExpectation = expectation(description: "receives a notify message") - - var notifyMessage: NotifyMessage! - var notifyMessageRecord: NotifyMessageRecord? - - var didNotify = false - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - guard - let subscription = subscriptions.first, - let scope = subscription.scope.keys.first - else { return } - - let notifier = Publisher() - if !didNotify { - didNotify = true - - let message = NotifyMessage.stub(type: scope) - notifyMessage = message - - Task(priority: .high) { - try await notifier.notify(topic: subscription.topic, account: subscription.account, message: message) - subscribeExpectation.fulfill() - } - } - }.store(in: &publishers) - - walletNotifyClientA.messagesPublisher - .sink { messages in - guard let newNotifyMessageRecord = messages.first else { return } - // ID's is not equal because server generates a new one - XCTAssertEqual(newNotifyMessageRecord.message.title, notifyMessage.title) - XCTAssertEqual(newNotifyMessageRecord.message.body, notifyMessage.body) - XCTAssertEqual(newNotifyMessageRecord.message.icon, notifyMessage.icon) - XCTAssertEqual(newNotifyMessageRecord.message.type, notifyMessage.type) - notifyMessageRecord = newNotifyMessageRecord - messageExpectation.fulfill() - }.store(in: &publishers) - - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) - try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - - await fulfillment(of: [subscribeExpectation, messageExpectation], timeout: InputConfig.defaultTimeout) - - if let notifyMessageRecord { - try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) - } - } - - func testFetchHistory() async throws { - let subscribeExpectation = expectation(description: "fetch notify subscription") - let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! - - var subscription: NotifySubscription! - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - subscribeExpectation.fulfill() - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in - let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } - - await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) - - let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) - XCTAssertTrue(hasMore) - XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) - } -} - - -private extension NotifyTests { - func sign(_ message: String) -> CacaoSignature { - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } -} - -private extension NotifyClient { - - func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { - let params = try await prepareRegistration(account: account, domain: domain) - let signature = onSign(params.message) - try await register(params: params, signature: signature) - } -} +//import Foundation +//import XCTest +//import WalletConnectUtils +//import Web3 +//@testable import WalletConnectKMS +//import WalletConnectRelay +//import Combine +//import WalletConnectNetworking +//import WalletConnectPush +//@testable import WalletConnectNotify +//import WalletConnectIdentity +//import WalletConnectSigner +// +//final class NotifyTests: XCTestCase { +// +// var walletNotifyClientA: NotifyClient! +// +// let gmDappDomain = InputConfig.gmDappHost +// +// var pk: EthereumPrivateKey! +// +// var privateKey: Data { +// return Data(pk.rawPrivateKey) +// } +// +// var account: Account { +// return Account("eip155:1:" + pk.address.hex(eip55: true))! +// } +// +// private var publishers = Set() +// +// func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { +// let keychain = KeychainStorageMock() +// let keyValueStorage = RuntimeKeyValueStorage() +// +// let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) +// let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) +// let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) +// +// let relayClient = RelayClientFactory.create( +// relayHost: InputConfig.relayHost, +// projectId: InputConfig.projectId, +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// socketFactory: DefaultSocketFactory(), +// networkMonitor: NetworkMonitor(), +// logger: relayLogger) +// +// let networkingClient = NetworkingClientFactory.create( +// relayClient: relayClient, +// logger: networkingLogger, +// keychainStorage: keychain, +// keyValueStorage: keyValueStorage, +// kmsLogger: kmsLogger) +// +// let clientId = try! networkingClient.getClientId() +// networkingLogger.debug("My client id is: \(clientId)") +// return (networkingClient, keychain, keyValueStorage) +// } +// +// func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { +// let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) +// let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) +// let pushClient = PushClientFactory.create(projectId: "", +// pushHost: "echo.walletconnect.com", +// keyValueStorage: keyValueStorage, +// keychainStorage: keychain, +// environment: .sandbox) +// let keyserverURL = URL(string: "https://keys.walletconnect.com")! +// let sqlite = try! MemorySqlite() +// // Note:- prod project_id do not exists on staging, we can use gmDappProjectId +// let client = NotifyClientFactory.create(projectId: InputConfig.gmDappProjectId, +// keyserverURL: keyserverURL, +// sqlite: sqlite, +// logger: notifyLogger, +// keychainStorage: keychain, +// groupKeychainStorage: KeychainStorageMock(), +// networkInteractor: networkingInteractor, +// pushClient: pushClient, +// crypto: DefaultCryptoProvider(), +// notifyHost: InputConfig.notifyHost, +// explorerHost: InputConfig.explorerHost) +// return client +// } +// +// override func setUp() { +// pk = try! EthereumPrivateKey() +// walletNotifyClientA = makeWalletClient() +// publishers.removeAll() +// } +// +// func testWalletCreatesSubscription() async throws { +// let expectation = expectation(description: "expects to create notify subscription") +// expectation.assertForOverFulfill = false +// +// var subscription: NotifySubscription? +// +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// expectation.fulfill() +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) +// +// if let subscription { +// try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) +// } +// } +// +// func testNotifyWatchSubscriptions() async throws { +// let expectation = expectation(description: "expects client B to receive subscription created by client A") +// expectation.assertForOverFulfill = false +// +// var subscription: NotifySubscription? +// +// let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") +// clientB.subscriptionsPublisher.sink { subscriptions in +// subscription = subscriptions.first +// expectation.fulfill() +// }.store(in: &publishers) +// +// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) +// +// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) +// +// if let subscription { +// try await clientB.deleteSubscription(topic: subscription.topic) +// } +// } +// +// func testNotifySubscriptionChanged() async throws { +// let expectation = expectation(description: "expects client B to receive subscription after both clients are registered and client A creates one") +// expectation.assertForOverFulfill = false +// +// var subscription: NotifySubscription? +// +// let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") +// clientB.subscriptionsPublisher.sink { subscriptions in +// subscription = subscriptions.first +// expectation.fulfill() +// }.store(in: &publishers) +// +// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) +// +// if let subscription { +// try await clientB.deleteSubscription(topic: subscription.topic) +// } +// } +// +// func testWalletCreatesAndUpdatesSubscription() async throws { +// let created = expectation(description: "Subscription created") +// +// let updated = expectation(description: "Subscription Updated") +// +// var isCreated = false +// var isUpdated = false +// var subscription: NotifySubscription! +// +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// +// if !isCreated { +// isCreated = true +// created.fulfill() +// } else if !isUpdated { +// isUpdated = true +// updated.fulfill() +// } +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) +// +// try await walletNotifyClientA.update(topic: subscription.topic, scope: []) +// +// await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) +// +// let updatedScope = subscription.scope.filter { $0.value.enabled == true } +// XCTAssertTrue(updatedScope.isEmpty) +// +// try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) +// } +// +// func testNotifyServerSubscribeAndNotifies() async throws { +// let subscribeExpectation = expectation(description: "creates notify subscription") +// let messageExpectation = expectation(description: "receives a notify message") +// +// var notifyMessage: NotifyMessage! +// var notifyMessageRecord: NotifyMessageRecord? +// +// var didNotify = false +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// guard +// let subscription = subscriptions.first, +// let scope = subscription.scope.keys.first +// else { return } +// +// let notifier = Publisher() +// if !didNotify { +// didNotify = true +// +// let message = NotifyMessage.stub(type: scope) +// notifyMessage = message +// +// Task(priority: .high) { +// try await notifier.notify(topic: subscription.topic, account: subscription.account, message: message) +// subscribeExpectation.fulfill() +// } +// } +// }.store(in: &publishers) +// +// walletNotifyClientA.messagesPublisher +// .sink { messages in +// guard let newNotifyMessageRecord = messages.first else { return } +// // ID's is not equal because server generates a new one +// XCTAssertEqual(newNotifyMessageRecord.message.title, notifyMessage.title) +// XCTAssertEqual(newNotifyMessageRecord.message.body, notifyMessage.body) +// XCTAssertEqual(newNotifyMessageRecord.message.icon, notifyMessage.icon) +// XCTAssertEqual(newNotifyMessageRecord.message.type, notifyMessage.type) +// notifyMessageRecord = newNotifyMessageRecord +// messageExpectation.fulfill() +// }.store(in: &publishers) +// +// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) +// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) +// +// await fulfillment(of: [subscribeExpectation, messageExpectation], timeout: InputConfig.defaultTimeout) +// +// if let notifyMessageRecord { +// try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) +// } +// } +// +// func testFetchHistory() async throws { +// let subscribeExpectation = expectation(description: "fetch notify subscription") +// let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! +// +// var subscription: NotifySubscription! +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// subscribeExpectation.fulfill() +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in +// let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) +// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) +// } +// +// await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) +// +// let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) +// XCTAssertTrue(hasMore) +// XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) +// } +//} +// +// +//private extension NotifyTests { +// func sign(_ message: String) -> CacaoSignature { +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) +// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) +// } +//} +// +//private extension NotifyClient { +// +// func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { +// let params = try await prepareRegistration(account: account, domain: domain) +// let signature = onSign(params.message) +// try await register(params: params, signature: signature) +// } +//} diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 714ce7abc..dfd819996 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -82,7 +82,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } @@ -137,7 +137,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { - do { try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } + do { _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } }.store(in: &publishers) dapp.sessionSettlePublisher.sink { [unowned self] settledSession in @@ -200,7 +200,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } } @@ -291,7 +291,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } @@ -488,7 +488,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } @@ -557,7 +557,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } @@ -616,7 +616,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } @@ -682,7 +682,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { settlementFailedExpectation.fulfill() } @@ -748,7 +748,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) + _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { settlementFailedExpectation.fulfill() } @@ -782,7 +782,7 @@ final class SignClientTests: XCTestCase { let auth = try wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) - try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) } } .store(in: &publishers) @@ -822,7 +822,7 @@ final class SignClientTests: XCTestCase { cacaos.append(cacao) } - try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: cacaos) + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: cacaos) } } .store(in: &publishers) @@ -887,7 +887,7 @@ final class SignClientTests: XCTestCase { let auth = try wallet.makeAuthObject(authRequest: request, signature: invalidSignature, account: walletAccount) - try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) } } .store(in: &publishers) @@ -943,7 +943,7 @@ final class SignClientTests: XCTestCase { let auth = try wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) - try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) } } .store(in: &publishers) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index cfa55e813..c13db8f58 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -28,7 +28,7 @@ final class SessionProposalInteractor { events: Array(supportedEvents), accounts: supportedAccounts ) - try await Web3Wallet.instance.approve(proposalId: proposal.id, namespaces: sessionNamespaces, sessionProperties: proposal.sessionProperties) + _ = try await Web3Wallet.instance.approve(proposalId: proposal.id, namespaces: sessionNamespaces, sessionProperties: proposal.sessionProperties) if let uri = proposal.proposer.redirect?.native { WalletConnectRouter.goBack(uri: uri) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 5639c6b68..33c951dc0 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -64,7 +64,7 @@ final class ApproveEngine { setupResponseErrorSubscriptions() } - func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws { + func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws -> Session { logger.debug("Approving session proposal") guard !sessionNamespaces.isEmpty else { throw Errors.emtySessionNamespacesForbidden } @@ -136,6 +136,7 @@ final class ApproveEngine { pairingTopic: payload.topic, peerMetadata: payload.request.proposer.metadata ) + return session.publicRepresentation() } func reject(proposerPubKey: String, reason: SignReasonCode) async throws { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index c5829a04f..637534c2f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -360,7 +360,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - proposalId: Session Proposal id /// - namespaces: namespaces for given session, needs to contain at least required namespaces proposed by dApp. - public func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws { + public func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws -> Session { try await approveEngine.approveProposal(proposerPubKey: proposalId, validating: namespaces, sessionProperties: sessionProperties) } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index bc4b43f91..17f52a74c 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -19,7 +19,7 @@ public protocol SignClientProtocol { func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws - func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]?) async throws + func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]?) async throws -> Session func rejectSession(proposalId: String, reason: RejectionReason) async throws func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 5751c7be8..58e1df245 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -115,7 +115,7 @@ public class Web3WalletClient { /// - Parameters: /// - proposalId: Session Proposal id /// - namespaces: namespaces for given session, needs to contain at least required namespaces proposed by dApp. - public func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws { + public func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws -> Session { try await signClient.approve(proposalId: proposalId, namespaces: namespaces, sessionProperties: sessionProperties) } diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index c840d0ad0..63bf4ce0d 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -73,7 +73,7 @@ final class ApproveEngineTests: XCTestCase { let proposal = SessionProposal.stub(proposerPubKey: proposerPubKey) pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil)) - try await engine.approveProposal(proposerPubKey: proposal.proposer.publicKey, validating: SessionNamespace.stubDictionary()) + _ = try await engine.approveProposal(proposerPubKey: proposal.proposer.publicKey, validating: SessionNamespace.stubDictionary()) let topicB = networkingInteractor.subscriptions.last! @@ -195,7 +195,7 @@ final class ApproveEngineTests: XCTestCase { XCTAssertTrue(verifyContextStore.getAll().count == 1) - try await engine.approveProposal(proposerPubKey: proposal.proposer.publicKey, validating: SessionNamespace.stubDictionary()) + _ = try await engine.approveProposal(proposerPubKey: proposal.proposer.publicKey, validating: SessionNamespace.stubDictionary()) XCTAssertTrue(verifyContextStore.getAll().isEmpty) } diff --git a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift index ce4c0885e..1b5419be5 100644 --- a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift +++ b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift @@ -4,8 +4,15 @@ import XCTest final class AuthenticatedSessionRecapFactoryTests: XCTestCase { func testAuthenticatedSessionRecapFactory() { + // {"att":{"eip155":{"request/eth_sendTransaction":[],"request/personal_sign":[]}}} + let recapUrn1 = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W10sInJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W119fX0=" + + // {"att":{"eip155":{"request/personal_sign":[],"request/eth_sendTransaction":[]}}} + let recapUrn2 = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W10sInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W119fX0=" + + let urns = [recapUrn1, recapUrn2] let recapUrn = try! AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: ["personal_sign", "eth_sendTransaction"]) - let expectedUrn = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W10sInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W119fX0=" - XCTAssertEqual(recapUrn, expectedUrn) + + XCTAssertTrue(urns.contains(recapUrn)) } } From 35049369732b5667298bb8c2981fa3bafe5a9dd3 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 30 Jan 2024 14:43:33 +0300 Subject: [PATCH 314/814] NotificationService notofocation types icon --- .../NotificationService.swift | 110 +++++++++--------- .../Client/Wallet/NotifyClientFactory.swift | 18 +-- .../Wallet/NotifyDecryptionService.swift | 15 ++- .../Client/Wallet/NotifySqliteFactory.swift | 25 ++++ .../Client/Wallet/NotifyStorageFactory.swift | 8 ++ 5 files changed, 102 insertions(+), 74 deletions(-) create mode 100644 Sources/WalletConnectNotify/Client/Wallet/NotifySqliteFactory.swift create mode 100644 Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 9fae80990..87ac13e5f 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -75,11 +75,11 @@ class NotificationService: UNNotificationServiceExtension { private func handleNotifyNotification(content: UNNotificationContent, topic: String, ciphertext: String) -> UNMutableNotificationContent { do { let service = NotifyDecryptionService(groupIdentifier: "group.com.walletconnect.sdk") - let (pushMessage, account) = try service.decryptMessage(topic: topic, ciphertext: ciphertext) + let (pushMessage, subscription, account) = try service.decryptMessage(topic: topic, ciphertext: ciphertext) log("message decrypted", account: account, topic: topic, message: pushMessage) - let updatedContent = handle(content: content, pushMessage: pushMessage, topic: topic) + let updatedContent = handle(content: content, pushMessage: pushMessage, subscription: subscription, topic: topic) let mutableContent = updatedContent.mutableCopy() as! UNMutableNotificationContent mutableContent.title = pushMessage.title @@ -114,62 +114,66 @@ class NotificationService: UNNotificationServiceExtension { private extension NotificationService { - func handle(content: UNNotificationContent, pushMessage: NotifyMessage, topic: String) -> UNNotificationContent { - do { - let iconUrl = try pushMessage.icon.asURL() + func handle(content: UNNotificationContent, pushMessage: NotifyMessage, subscription: NotifySubscription, topic: String) -> UNNotificationContent { + + let icon = subscription.scope[pushMessage.type]?.imageUrls?.sm ?? pushMessage.icon + var senderAvatar: INImage? + + do { + let iconUrl = try icon.asURL() let senderThumbnailImageData = try Data(contentsOf: iconUrl) let senderThumbnailImageFileUrl = try downloadAttachment(data: senderThumbnailImageData, fileName: iconUrl.lastPathComponent) let senderThumbnailImageFileData = try Data(contentsOf: senderThumbnailImageFileUrl) - let senderAvatar = INImage(imageData: senderThumbnailImageFileData) - - var personNameComponents = PersonNameComponents() - personNameComponents.nickname = pushMessage.title - - let senderPerson = INPerson( - personHandle: INPersonHandle(value: topic, type: .unknown), - nameComponents: personNameComponents, - displayName: pushMessage.title, - image: senderAvatar, - contactIdentifier: nil, - customIdentifier: topic, - isMe: false, - suggestionType: .none - ) - - let selfPerson = INPerson( - personHandle: INPersonHandle(value: "0", type: .unknown), - nameComponents: nil, - displayName: nil, - image: nil, - contactIdentifier: nil, - customIdentifier: nil, - isMe: true, - suggestionType: .none - ) - - let incomingMessagingIntent = INSendMessageIntent( - recipients: [selfPerson], - outgoingMessageType: .outgoingMessageText, - content: pushMessage.body, - speakableGroupName: nil, - conversationIdentifier: pushMessage.type, - serviceName: nil, - sender: senderPerson, - attachments: [] - ) - - incomingMessagingIntent.setImage(senderAvatar, forParameterNamed: \.sender) - - let interaction = INInteraction(intent: incomingMessagingIntent, response: nil) - interaction.direction = .incoming - interaction.donate(completion: nil) - - return try content.updating(from: incomingMessagingIntent) - } - catch { - return content + senderAvatar = INImage(imageData: senderThumbnailImageFileData) + } catch { + log("Fetch icon error: \(error)", account: subscription.account, topic: topic, message: pushMessage) } + + var personNameComponents = PersonNameComponents() + personNameComponents.nickname = pushMessage.title + + let senderPerson = INPerson( + personHandle: INPersonHandle(value: topic, type: .unknown), + nameComponents: personNameComponents, + displayName: pushMessage.title, + image: senderAvatar, + contactIdentifier: nil, + customIdentifier: topic, + isMe: false, + suggestionType: .none + ) + + let selfPerson = INPerson( + personHandle: INPersonHandle(value: "0", type: .unknown), + nameComponents: nil, + displayName: nil, + image: nil, + contactIdentifier: nil, + customIdentifier: nil, + isMe: true, + suggestionType: .none + ) + + let incomingMessagingIntent = INSendMessageIntent( + recipients: [selfPerson], + outgoingMessageType: .outgoingMessageText, + content: pushMessage.body, + speakableGroupName: nil, + conversationIdentifier: pushMessage.type, + serviceName: nil, + sender: senderPerson, + attachments: [] + ) + + incomingMessagingIntent.setImage(senderAvatar, forParameterNamed: \.sender) + + let interaction = INInteraction(intent: incomingMessagingIntent, response: nil) + interaction.direction = .incoming + interaction.donate(completion: nil) + + let updated = try? content.updating(from: incomingMessagingIntent) + return updated ?? content } func downloadAttachment(data: Data, fileName: String) throws -> URL { diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift index 14fa2fdef..c18b8749f 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClientFactory.swift @@ -7,8 +7,7 @@ public struct NotifyClientFactory { let keyserverURL = URL(string: "https://keys.walletconnect.com")! let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) let groupKeychainService = GroupKeychainStorage(serviceIdentifier: groupIdentifier) - let databasePath = databasePath(appGroup: groupIdentifier, database: "notify_v\(version).db") - let sqlite = DiskSqlite(path: databasePath) + let sqlite = NotifySqliteFactory.create(appGroup: groupIdentifier) return NotifyClientFactory.create( projectId: projectId, @@ -97,19 +96,4 @@ public struct NotifyClientFactory { subscriptionWatcher: subscriptionWatcher ) } - - static func databasePath(appGroup: String, database: String) -> String { - guard let path = FileManager.default - .containerURL(forSecurityApplicationGroupIdentifier: appGroup)? - .appendingPathComponent(database) else { - - fatalError("Database path not exists") - } - - return path.absoluteString - } - - static var version: String { - return "1" - } } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift index 272a37cea..e53b53042 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift @@ -3,29 +3,36 @@ import Foundation public class NotifyDecryptionService { enum Errors: Error { case malformedNotifyMessage + case subsctiptionNotFound } private let serializer: Serializing + private let database: NotifyDatabase private static let notifyTags: [UInt] = [4002] - init(serializer: Serializing) { + init(serializer: Serializing, database: NotifyDatabase) { self.serializer = serializer + self.database = database } public init(groupIdentifier: String) { let keychainStorage = GroupKeychainStorage(serviceIdentifier: groupIdentifier) let kms = KeyManagementService(keychain: keychainStorage) - self.serializer = Serializer(kms: kms, logger: ConsoleLogger(prefix: "🔐", loggingLevel: .off)) + let logger = ConsoleLogger(prefix: "🔐", loggingLevel: .off) + let sqlite = NotifySqliteFactory.create(appGroup: groupIdentifier) + self.serializer = Serializer(kms: kms, logger: logger) + self.database = NotifyDatabase(sqlite: sqlite, logger: logger) } public static func canHandle(tag: UInt) -> Bool { return notifyTags.contains(tag) } - public func decryptMessage(topic: String, ciphertext: String) throws -> (NotifyMessage, Account) { + public func decryptMessage(topic: String, ciphertext: String) throws -> (NotifyMessage, NotifySubscription, Account) { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) guard let params = rpcRequest.params else { throw Errors.malformedNotifyMessage } let wrapper = try params.get(NotifyMessagePayload.Wrapper.self) let (messagePayload, _) = try NotifyMessagePayload.decodeAndVerify(from: wrapper) - return (messagePayload.message, messagePayload.account) + guard let subscription = database.getSubscription(topic: topic) else { throw Errors.subsctiptionNotFound } + return (messagePayload.message, subscription, messagePayload.account) } } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifySqliteFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifySqliteFactory.swift new file mode 100644 index 000000000..cd1b0dd59 --- /dev/null +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifySqliteFactory.swift @@ -0,0 +1,25 @@ +import Foundation + +struct NotifySqliteFactory { + + static func create(appGroup: String) -> Sqlite { + let databasePath = databasePath(appGroup: appGroup, database: "notify_v\(version).db") + let sqlite = DiskSqlite(path: databasePath) + return sqlite + } + + static func databasePath(appGroup: String, database: String) -> String { + guard let path = FileManager.default + .containerURL(forSecurityApplicationGroupIdentifier: appGroup)? + .appendingPathComponent(database) else { + + fatalError("Database path not exists") + } + + return path.absoluteString + } + + static var version: String { + return "1" + } +} diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift new file mode 100644 index 000000000..3d5e56c21 --- /dev/null +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift @@ -0,0 +1,8 @@ +import Foundation + +struct NotifyStorageFactory { + + static func create() -> NotifyStorage { + + } +} From dc26b56c0312cd46b196ef0b430d05b752edfee5 Mon Sep 17 00:00:00 2001 From: Radek Novak Date: Tue, 30 Jan 2024 12:29:53 +0100 Subject: [PATCH 315/814] Add option to specify what app to release --- .env.DApp | 4 ++++ .github/workflows/release.yml | 10 +++++++++- Makefile | 11 ++--------- 3 files changed, 15 insertions(+), 10 deletions(-) create mode 100644 .env.DApp diff --git a/.env.DApp b/.env.DApp new file mode 100644 index 000000000..444ef413b --- /dev/null +++ b/.env.DApp @@ -0,0 +1,4 @@ +SCHEME = "DApp" +APP_IDENTIFIER = "com.walletconnect.dapp" +MATCH_IDENTIFIERS = "com.walletconnect.dapp" +APPLE_ID = "1606875879" \ No newline at end of file diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 06c696525..02513dfa8 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -2,6 +2,14 @@ name: release on: workflow_dispatch: + inputs: + app: + type: choice + description: Which sample app to release + options: + - DApp + - WalletApp + - Showcase jobs: build: @@ -32,4 +40,4 @@ jobs: APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }} WALLETAPP_SENTRY_DSN: ${{ secrets.WALLETAPP_SENTRY_DSN }} run: | - make release_wallet APPLE_ID=${{ secrets.APPLE_ID }} TOKEN=$(echo -n $GH_USER:$GH_TOKEN | base64) PROJECT_ID=${{ secrets.RELEASE_PROJECT_ID }} WALLETAPP_SENTRY_DSN=${{ secrets.WALLETAPP_SENTRY_DSN }} MIXPANEL_TOKEN=${{secrets.MIXPANEL_TOKEN}} + make release APPLE_ID=${{ secrets.APPLE_ID }} TOKEN=$(echo -n $GH_USER:$GH_TOKEN | base64) PROJECT_ID=${{ secrets.RELEASE_PROJECT_ID }} WALLETAPP_SENTRY_DSN=${{ secrets.WALLETAPP_SENTRY_DSN }} MIXPANEL_TOKEN=${{secrets.MIXPANEL_TOKEN}} APP=${{ github.event.inputs.app }} diff --git a/Makefile b/Makefile index 68c9b1a0b..7faf5e64b 100755 --- a/Makefile +++ b/Makefile @@ -67,12 +67,5 @@ smoke_tests: x_platform_protocol_tests: ./run_tests.sh --scheme IntegrationTests --testplan XPlatformProtocolTests --project Example/ExampleApp.xcodeproj -release_wallet: - fastlane release_testflight username:$(APPLE_ID) token:$(TOKEN) relay_host:$(RELAY_HOST) project_id:$(PROJECT_ID) sentry_dsn:$(WALLETAPP_SENTRY_DSN) mixpanel_token:$(MIXPANEL_TOKEN) --env WalletApp - -release_showcase: - fastlane release_testflight username:$(APPLE_ID) token:$(TOKEN) relay_host:$(RELAY_HOST) project_id:$(PROJECT_ID) --env Showcase - -release_all: - fastlane release_testflight username:$(APPLE_ID) token:$(TOKEN) relay_host:$(RELAY_HOST) project_id:$(PROJECT_ID) sentry_dsn:$(WALLETAPP_SENTRY_DSN) mixpanel_token:$(MIXPANEL_TOKEN) --env WalletApp - fastlane release_testflight username:$(APPLE_ID) token:$(TOKEN) relay_host:$(RELAY_HOST) project_id:$(PROJECT_ID) --env Showcase +release: + fastlane release_testflight username:$(APPLE_ID) token:$(TOKEN) relay_host:$(RELAY_HOST) project_id:$(PROJECT_ID) sentry_dsn:$(WALLETAPP_SENTRY_DSN) mixpanel_token:$(MIXPANEL_TOKEN) --env $(APP) From 03fe849f3a2eba3926734229c7a3abd5add38dfa Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 30 Jan 2024 13:58:14 +0100 Subject: [PATCH 316/814] add getPendingRequestsSortedByTimestamp to history service --- .../Services/HistoryService.swift | 29 ++++++++++++++----- .../Sign/SessionRequestsProvider.swift | 6 ++++ 2 files changed, 27 insertions(+), 8 deletions(-) create mode 100644 Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index a34f52bb5..dba1bdbb7 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -15,32 +15,45 @@ final class HistoryService { public func getSessionRequest(id: RPCID) -> (request: Request, context: VerifyContext?)? { guard let record = history.get(recordId: id) else { return nil } - guard let (request, recordId) = mapRequestRecord(record) else { + guard let (request, recordId, _) = mapRequestRecord(record) else { return nil } return (request, try? verifyContextStore.get(key: recordId.string)) } func getPendingRequests() -> [(request: Request, context: VerifyContext?)] { + getPendingRequestsSortedByTimestamp() + } + + func getPendingRequestsSortedByTimestamp() -> [(request: Request, context: VerifyContext?)] { let requests = history.getPending() .compactMap { mapRequestRecord($0) } - .filter { !$0.0.isExpired() } // Note the change here to access the Request part of the tuple - return requests.map { (request: $0.0, context: try? verifyContextStore.get(key: $0.1.string)) } - } + .filter { !$0.0.isExpired() } + .sorted { + switch ($0.2, $1.2) { + case let (date1?, date2?): return date1 < date2 // Both dates are present + case (nil, _): return false // First date is nil, so it should go last + case (_, nil): return true // Second date is nil, so the first one should come first + } + } + .map { (request: $0.0, context: try? verifyContextStore.get(key: $0.1.string)) } + return requests + } func getPendingRequestsWithRecordId() -> [(request: Request, recordId: RPCID)] { - history.getPending() + return history.getPending() .compactMap { mapRequestRecord($0) } + .map { (request: $0.0, recordId: $0.1) } } func getPendingRequests(topic: String) -> [(request: Request, context: VerifyContext?)] { - return getPendingRequests().filter { $0.request.topic == topic } + return getPendingRequestsSortedByTimestamp().filter { $0.request.topic == topic } } } private extension HistoryService { - func mapRequestRecord(_ record: RPCHistory.Record) -> (Request, RPCID)? { + func mapRequestRecord(_ record: RPCHistory.Record) -> (Request, RPCID, Date?)? { guard let request = try? record.request.params?.get(SessionType.RequestParams.self) else { return nil } @@ -53,6 +66,6 @@ private extension HistoryService { expiryTimestamp: request.request.expiryTimestamp ) - return (mappedRequest, record.id) + return (mappedRequest, record.id, record.timestamp) } } diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift new file mode 100644 index 000000000..d3387b6e7 --- /dev/null +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -0,0 +1,6 @@ + +import Foundation + +//class SessionRequestsProvider { +// +//} From 96f2339f7195b26f24a4e5325e7ccd4e59c4aead Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 30 Jan 2024 18:32:24 +0300 Subject: [PATCH 317/814] Icons from notification types --- .../NotificationService.swift | 20 +++++++++---------- .../Models/NotifyMessageViewModel.swift | 4 ++++ .../PushMessages/SubscriptionPresenter.swift | 5 +++++ .../PushMessages/SubscriptionView.swift | 4 ++-- .../Client/Wallet/NotifyImageUrls.swift | 14 +++++++++++++ .../Client/Wallet/NotifyStorageFactory.swift | 8 -------- .../DataStructures/NotifySubscription.swift | 4 ++++ 7 files changed, 39 insertions(+), 20 deletions(-) delete mode 100644 Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift diff --git a/Example/PNDecryptionService/NotificationService.swift b/Example/PNDecryptionService/NotificationService.swift index 87ac13e5f..d3f535f8f 100644 --- a/Example/PNDecryptionService/NotificationService.swift +++ b/Example/PNDecryptionService/NotificationService.swift @@ -115,19 +115,19 @@ class NotificationService: UNNotificationServiceExtension { private extension NotificationService { func handle(content: UNNotificationContent, pushMessage: NotifyMessage, subscription: NotifySubscription, topic: String) -> UNNotificationContent { - - let icon = subscription.scope[pushMessage.type]?.imageUrls?.sm ?? pushMessage.icon var senderAvatar: INImage? - do { - let iconUrl = try icon.asURL() - let senderThumbnailImageData = try Data(contentsOf: iconUrl) - let senderThumbnailImageFileUrl = try downloadAttachment(data: senderThumbnailImageData, fileName: iconUrl.lastPathComponent) - let senderThumbnailImageFileData = try Data(contentsOf: senderThumbnailImageFileUrl) - senderAvatar = INImage(imageData: senderThumbnailImageFileData) - } catch { - log("Fetch icon error: \(error)", account: subscription.account, topic: topic, message: pushMessage) + if let icon = subscription.messageIcons(ofType: pushMessage.type).md { + do { + let iconUrl = try icon.asURL() + let senderThumbnailImageData = try Data(contentsOf: iconUrl) + let senderThumbnailImageFileUrl = try downloadAttachment(data: senderThumbnailImageData, fileName: iconUrl.lastPathComponent) + let senderThumbnailImageFileData = try Data(contentsOf: senderThumbnailImageFileUrl) + senderAvatar = INImage(imageData: senderThumbnailImageFileData) + } catch { + log("Fetch icon error: \(error)", account: subscription.account, topic: topic, message: pushMessage) + } } var personNameComponents = PersonNameComponents() diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/Models/NotifyMessageViewModel.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/Models/NotifyMessageViewModel.swift index 9e937154c..342bac31e 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/Models/NotifyMessageViewModel.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/Models/NotifyMessageViewModel.swift @@ -24,4 +24,8 @@ struct NotifyMessageViewModel: Identifiable { var publishedAt: String { return pushMessageRecord.publishedAt.formatted(.relative(presentation: .named, unitsStyle: .wide)) } + + var type: String { + return pushMessageRecord.message.type + } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift index bfddfee6e..2f9bb1a21 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift @@ -52,6 +52,11 @@ final class SubscriptionPresenter: ObservableObject { } } + func messageIconUrl(message: NotifyMessageViewModel) -> URL? { + let icons = subscription.messageIcons(ofType: message.type) + return try? icons.md?.asURL() + } + func unsubscribe() { interactor.deleteSubscription(subscription) router.dismiss() diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift index e68fcb5b6..e168a8814 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionView.swift @@ -49,12 +49,12 @@ struct SubscriptionView: View { private func notificationView(pushMessage: NotifyMessageViewModel) -> some View { VStack(alignment: .center) { HStack(spacing: 12) { - CacheAsyncImage(url: URL(string: pushMessage.imageUrl) ?? presenter.subscriptionViewModel.imageUrl) { phase in + CacheAsyncImage(url: presenter.messageIconUrl(message: pushMessage)) { phase in if let image = phase.image { image .resizable() .frame(width: 48, height: 48) - .background(Color.black) + .background(Color.black.opacity(0.05)) .cornerRadius(10, corners: .allCorners) } else { Color.black diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift index 124dc1def..c5963bae2 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyImageUrls.swift @@ -1,7 +1,21 @@ import Foundation public struct NotifyImageUrls: Codable, Equatable { + public let sm: String? public let md: String? public let lg: String? + + public init(sm: String? = nil, md: String? = nil, lg: String? = nil) { + self.sm = sm + self.md = md + self.lg = lg + } + + public init?(icons: [String]) { + guard icons.count == 3 else { return nil } + self.sm = icons[0] + self.md = icons[1] + self.lg = icons[2] + } } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift deleted file mode 100644 index 3d5e56c21..000000000 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyStorageFactory.swift +++ /dev/null @@ -1,8 +0,0 @@ -import Foundation - -struct NotifyStorageFactory { - - static func create() -> NotifyStorage { - - } -} diff --git a/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift b/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift index 0cc7f313e..54be8d136 100644 --- a/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift +++ b/Sources/WalletConnectNotify/Types/DataStructures/NotifySubscription.swift @@ -15,6 +15,10 @@ public struct NotifySubscription: Codable, Equatable, SqliteRow { return "\(account.absoluteString)-\(metadata.url)" } + public func messageIcons(ofType type: String) -> NotifyImageUrls { + return scope[type]?.imageUrls ?? NotifyImageUrls(icons: metadata.icons) ?? NotifyImageUrls() + } + public init(decoder: SqliteRowDecoder) throws { self.topic = try decoder.decodeString(at: 0) self.account = try Account(decoder.decodeString(at: 1))! From 17107eab8d57751826c68c60efb19516cbdc2162 Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 30 Jan 2024 18:34:45 +0300 Subject: [PATCH 318/814] Badge disabled --- .../Wallet/Notifications/Models/SubscriptionsViewModel.swift | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/SubscriptionsViewModel.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/SubscriptionsViewModel.swift index 6e0f12f42..cced6706c 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/SubscriptionsViewModel.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/Models/SubscriptionsViewModel.swift @@ -45,6 +45,7 @@ struct SubscriptionsViewModel: Identifiable { } var hasMessage: Bool { - return messagesCount != 0 + /* return messagesCount != 0 Badge disabled */ + return false } } From 6aa35d52828afe7e68c1defe381e8e8969be117a Mon Sep 17 00:00:00 2001 From: Artur Guseinov Date: Tue, 30 Jan 2024 18:41:09 +0300 Subject: [PATCH 319/814] Bottom padding --- .../Wallet/Notifications/NotificationsView.swift | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift index a3146cbd8..7cf63ed8f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Notifications/NotificationsView.swift @@ -62,6 +62,9 @@ struct NotificationsView: View { .listRowSeparator(.hidden) } .listStyle(PlainListStyle()) + .safeAreaInset(edge: .bottom) { + Spacer().frame(height: 16) + } } .task { try? await presenter.fetch() From 39b004c8a2f05af9ccfe96744a159b80651af596 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 09:55:18 +0100 Subject: [PATCH 320/814] savepoint --- .../xcshareddata/xcschemes/Wallet.xcscheme | 20 +++++++- .../Wallet/Main/MainPresenter.swift | 12 +++-- .../Engine/Common/SessionEngine.swift | 21 +++++++-- .../Sign/SessionRequestsProvider.swift | 46 +++++++++++++++++-- .../WalletConnectSign/Sign/SignClient.swift | 6 +-- .../Sign/SignClientFactory.swift | 3 +- .../RPCHistory/RPCHistory.swift | 2 +- .../SessionRequestsProviderTests.swift | 18 ++++++++ 8 files changed, 107 insertions(+), 21 deletions(-) create mode 100644 Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme index d786c3306..9619bb4be 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme @@ -73,6 +73,15 @@ allowLocationSimulation = "YES"> + + + + - + + + + + diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift index 3d5c8a0b6..76726ac06 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift @@ -48,11 +48,15 @@ extension MainPresenter { interactor.sessionRequestPublisher .receive(on: DispatchQueue.main) - .sink { [unowned self] request, context in - router.dismiss() - router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) + .sink { [unowned self] (request, context) in + if let rootview = router.viewController.presentedViewController as? SessionViewController { + return + } else { + router.dismiss() + router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) + } }.store(in: &disposeBag) - + interactor.requestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] result in diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 9d0c034f6..f9cbd1ad8 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -7,12 +7,16 @@ final class SessionEngine { } var onSessionsUpdate: (([Session]) -> Void)? - var onSessionRequest: ((Request, VerifyContext?) -> Void)? var onSessionResponse: ((Response) -> Void)? var onSessionRejected: ((String, SessionType.Reason) -> Void)? var onSessionDelete: ((String, SessionType.Reason) -> Void)? var onEventReceived: ((String, Session.Event, Blockchain?) -> Void)? + var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { + return sessionRequestsProvider.sessionRequestPublisher + } + + private let sessionStore: WCSessionStorage private let networkingInteractor: NetworkInteracting private let historyService: HistoryService @@ -21,6 +25,7 @@ final class SessionEngine { private let kms: KeyManagementServiceProtocol private var publishers = [AnyCancellable]() private let logger: ConsoleLogging + private let sessionRequestsProvider: SessionRequestsProvider init( networkingInteractor: NetworkInteracting, @@ -29,7 +34,8 @@ final class SessionEngine { verifyClient: VerifyClientProtocol, kms: KeyManagementServiceProtocol, sessionStore: WCSessionStorage, - logger: ConsoleLogging + logger: ConsoleLogging, + sessionRequestsProvider: SessionRequestsProvider ) { self.networkingInteractor = networkingInteractor self.historyService = historyService @@ -38,12 +44,16 @@ final class SessionEngine { self.kms = kms self.sessionStore = sessionStore self.logger = logger + self.sessionRequestsProvider = sessionRequestsProvider setupConnectionSubscriptions() setupRequestSubscriptions() setupResponseSubscriptions() setupUpdateSubscriptions() setupExpirationSubscriptions() + DispatchQueue.main.asyncAfter(deadline: .now() + 3) { [unowned self] in + sessionRequestsProvider.emitRequestIfPending() + } } func hasSession(for topic: String) -> Bool { @@ -95,6 +105,7 @@ final class SessionEngine { protocolMethod: protocolMethod ) verifyContextStore.delete(forKey: requestId.string) + sessionRequestsProvider.emitRequestIfPending() } func emit(topic: String, event: SessionType.EventParams.Event, chainId: Blockchain) async throws { @@ -249,12 +260,12 @@ private extension SessionEngine { let response = try await verifyClient.verifyOrigin(assertionId: assertionId) let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: session.peerParticipant.metadata.url, isScam: response.isScam) verifyContextStore.set(verifyContext, forKey: request.id.string) - onSessionRequest?(request, verifyContext) + + sessionRequestsProvider.emitRequestIfPending() } catch { let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: session.peerParticipant.metadata.url, isScam: nil) verifyContextStore.set(verifyContext, forKey: request.id.string) - onSessionRequest?(request, verifyContext) - return + sessionRequestsProvider.emitRequestIfPending() } } } diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index d3387b6e7..a8b91d325 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -1,6 +1,44 @@ - +import Combine import Foundation -//class SessionRequestsProvider { -// -//} +class SessionRequestsProvider { + private let historyService: HistoryService + private var sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() + private var cancellables = Set() + private var lastEmitDate: Date? + private var emitRequestSubject = PassthroughSubject() + + public var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { + sessionRequestPublisherSubject.eraseToAnyPublisher() + } + + init(historyService: HistoryService) { + self.historyService = historyService + setupEmitRequestHandling() + } + + private func setupEmitRequestHandling() { + emitRequestSubject + .sink { [unowned self] _ in + + let now = Date() + if let lastEmitDate = self.lastEmitDate, now.timeIntervalSince(lastEmitDate) < 1 { + // If the last emit was less than 1 second ago, ignore this request. + return + } + + // Update the last emit time to now. + self.lastEmitDate = now + + // Fetch the oldest request and emit it. + if let oldestRequest = self.historyService.getPendingRequestsSortedByTimestamp().first { + self.sessionRequestPublisherSubject.send(oldestRequest) + } + } + .store(in: &cancellables) + } + + func emitRequestIfPending() { + emitRequestSubject.send(()) + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 9c4b5e14d..0122f0f82 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -24,7 +24,7 @@ public final class SignClient: SignClientProtocol { /// /// In most cases event will be emited on wallet public var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { - sessionRequestPublisherSubject.eraseToAnyPublisher() + sessionEngine.sessionRequestPublisher } /// Publisher that sends web socket connection status @@ -138,7 +138,6 @@ public final class SignClient: SignClientProtocol { private let requestsExpiryWatcher: RequestsExpiryWatcher private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() - private let sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() private let socketConnectionStatusPublisherSubject = PassthroughSubject() private let sessionSettlePublisherSubject = PassthroughSubject() private let sessionDeletePublisherSubject = PassthroughSubject<(String, Reason), Never>() @@ -359,9 +358,6 @@ public final class SignClient: SignClientProtocol { approveEngine.onSessionSettle = { [unowned self] settledSession in sessionSettlePublisherSubject.send(settledSession) } - sessionEngine.onSessionRequest = { [unowned self] (sessionRequest, context) in - sessionRequestPublisherSubject.send((sessionRequest, context)) - } sessionEngine.onSessionDelete = { [unowned self] topic, reason in sessionDeletePublisherSubject.send((topic, reason)) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 3d63bcf39..c01f9855a 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -43,7 +43,8 @@ public struct SignClientFactory { let verifyContextStore = CodableStore(defaults: keyValueStorage, identifier: VerifyStorageIdentifiers.context.rawValue) let historyService = HistoryService(history: rpcHistory, verifyContextStore: verifyContextStore) let verifyClient = VerifyClientFactory.create() - let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: verifyClient, kms: kms, sessionStore: sessionStore, logger: logger) + let sessionRequestsProvider = SessionRequestsProvider(historyService: historyService) + let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: verifyClient, kms: kms, sessionStore: sessionStore, logger: logger, sessionRequestsProvider: sessionRequestsProvider) let nonControllerSessionStateMachine = NonControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let controllerSessionStateMachine = ControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let sessionExtendRequester = SessionExtendRequester(sessionStore: sessionStore, networkingInteractor: networkingClient) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 274122c3d..6e8fb9443 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -32,7 +32,7 @@ public final class RPCHistory { case .responseDuplicateNotAllowed: return "Response duplicates are not allowed." case .requestMatchingResponseNotFound: - return "Matching requesr for the response not found." + return "Matching request for the response not found." } } } diff --git a/Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift b/Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift new file mode 100644 index 000000000..8e2101290 --- /dev/null +++ b/Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift @@ -0,0 +1,18 @@ +import XCTest +@testable import WalletConnectSign + +class SessionRequestsProviderTests: XCTestCase { + + var sut: SessionRequestsProvider! + + func testEmitNewRequestWhenNoPending() { + + } + + func testEmitOldRequestOnNewWhenThereArePendingRequests() { + + } + +} + + From 7434413813bf451c69569b5877bc6830d0cfd379 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 11:25:35 +0100 Subject: [PATCH 321/814] clean up rpc hiistory handle session request screen --- .../PresentationLayer/Wallet/Main/MainPresenter.swift | 6 ++++-- .../Wallet/SessionRequest/SessionRequestModule.swift | 2 ++ .../Wallet/Settings/SettingsPresenter.swift | 2 ++ .../PresentationLayer/Wallet/Wallet/WalletRouter.swift | 2 +- Sources/WalletConnectSign/Engine/Common/SessionEngine.swift | 6 ++++-- Sources/WalletConnectSign/Services/SignCleanupService.swift | 6 +++++- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 2 +- Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift | 4 ++++ 8 files changed, 23 insertions(+), 7 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift index 76726ac06..debbf14df 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift @@ -1,5 +1,6 @@ import UIKit import Combine +import SwiftUI final class MainPresenter { private let interactor: MainInteractor @@ -49,14 +50,15 @@ extension MainPresenter { interactor.sessionRequestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] (request, context) in - if let rootview = router.viewController.presentedViewController as? SessionViewController { + if let vc = UIApplication.currentWindow.rootViewController?.topController, + vc.restorationIdentifier == SessionRequestModule.restorationIdentifier { return } else { router.dismiss() router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) } }.store(in: &disposeBag) - + interactor.requestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] result in diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestModule.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestModule.swift index a12c75573..6cffd00ea 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestModule.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestModule.swift @@ -3,6 +3,7 @@ import SwiftUI import Web3Wallet final class SessionRequestModule { + static let restorationIdentifier = "SessionRequestViewController" @discardableResult static func create(app: Application, sessionRequest: Request, importAccount: ImportAccount, sessionContext: VerifyContext?) -> UIViewController { let router = SessionRequestRouter(app: app) @@ -10,6 +11,7 @@ final class SessionRequestModule { let presenter = SessionRequestPresenter(interactor: interactor, router: router, sessionRequest: sessionRequest, importAccount: importAccount, context: sessionContext) let view = SessionRequestView().environmentObject(presenter) let viewController = SceneViewController(viewModel: presenter, content: view) + viewController.restorationIdentifier = Self.restorationIdentifier router.viewController = viewController diff --git a/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift index d9c10848d..163799e3c 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift @@ -1,6 +1,7 @@ import UIKit import Combine import WalletConnectNetworking +import Web3Wallet final class SettingsPresenter: ObservableObject { @@ -46,6 +47,7 @@ final class SettingsPresenter: ObservableObject { guard let account = accountStorage.importAccount?.account else { return } try await interactor.notifyUnregister(account: account) accountStorage.importAccount = nil + try await Web3Wallet.instance.cleanup() UserDefaults.standard.set(nil, forKey: "deviceToken") await router.presentWelcome() } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletRouter.swift b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletRouter.swift index c9907a0b5..694ddaab7 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletRouter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Wallet/WalletRouter.swift @@ -13,7 +13,7 @@ final class WalletRouter { func present(sessionRequest: Request, importAccount: ImportAccount, sessionContext: VerifyContext?) { SessionRequestModule.create(app: app, sessionRequest: sessionRequest, importAccount: importAccount, sessionContext: sessionContext) - .presentFullScreen(from: viewController, transparentBackground: true) + .presentFullScreen(from: UIApplication.currentWindow.rootViewController!, transparentBackground: true) } func present(sessionProposal: Session.Proposal, importAccount: ImportAccount, sessionContext: VerifyContext?) { diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index f9cbd1ad8..429718b64 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -51,7 +51,7 @@ final class SessionEngine { setupResponseSubscriptions() setupUpdateSubscriptions() setupExpirationSubscriptions() - DispatchQueue.main.asyncAfter(deadline: .now() + 3) { [unowned self] in + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [unowned self] in sessionRequestsProvider.emitRequestIfPending() } } @@ -105,7 +105,9 @@ final class SessionEngine { protocolMethod: protocolMethod ) verifyContextStore.delete(forKey: requestId.string) - sessionRequestsProvider.emitRequestIfPending() + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [unowned self] in + sessionRequestsProvider.emitRequestIfPending() + } } func emit(topic: String, event: SessionType.EventParams.Event, chainId: Blockchain) async throws { diff --git a/Sources/WalletConnectSign/Services/SignCleanupService.swift b/Sources/WalletConnectSign/Services/SignCleanupService.swift index abee34063..5c2a6ec1c 100644 --- a/Sources/WalletConnectSign/Services/SignCleanupService.swift +++ b/Sources/WalletConnectSign/Services/SignCleanupService.swift @@ -7,13 +7,16 @@ final class SignCleanupService { private let kms: KeyManagementServiceProtocol private let sessionTopicToProposal: CodableStore private let networkInteractor: NetworkInteracting + private let rpcHistory: RPCHistory - init(pairingStore: WCPairingStorage, sessionStore: WCSessionStorage, kms: KeyManagementServiceProtocol, sessionTopicToProposal: CodableStore, networkInteractor: NetworkInteracting) { + init(pairingStore: WCPairingStorage, sessionStore: WCSessionStorage, kms: KeyManagementServiceProtocol, sessionTopicToProposal: CodableStore, networkInteractor: NetworkInteracting, + rpcHistory: RPCHistory) { self.pairingStore = pairingStore self.sessionStore = sessionStore self.sessionTopicToProposal = sessionTopicToProposal self.networkInteractor = networkInteractor self.kms = kms + self.rpcHistory = rpcHistory } func cleanup() async throws { @@ -39,6 +42,7 @@ private extension SignCleanupService { pairingStore.deleteAll() sessionStore.deleteAll() sessionTopicToProposal.deleteAll() + rpcHistory.deleteAll() try kms.deleteAll() } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index c01f9855a..7bba8b44b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -65,7 +65,7 @@ public struct SignClientFactory { verifyClient: verifyClient, rpcHistory: rpcHistory ) - let cleanupService = SignCleanupService(pairingStore: pairingStore, sessionStore: sessionStore, kms: kms, sessionTopicToProposal: sessionTopicToProposal, networkInteractor: networkingClient) + let cleanupService = SignCleanupService(pairingStore: pairingStore, sessionStore: sessionStore, kms: kms, sessionTopicToProposal: sessionTopicToProposal, networkInteractor: networkingClient, rpcHistory: rpcHistory) let deleteSessionService = DeleteSessionService(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let disconnectService = DisconnectService(deleteSessionService: deleteSessionService, sessionStorage: sessionStore) let sessionPingService = SessionPingService(sessionStorage: sessionStore, networkingInteractor: networkingClient, logger: logger) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 6e8fb9443..ff6bda280 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -119,6 +119,10 @@ public final class RPCHistory { public func getPending() -> [Record] { storage.getAll().filter { $0.response == nil } } + + public func deleteAll() { + storage.deleteAll() + } } extension RPCHistory { From a73cadde56e21c8dfe8b62917491e1b91375118d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 11:34:03 +0100 Subject: [PATCH 322/814] remove tests --- .../SessionRequestsProviderTests.swift | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100644 Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift diff --git a/Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift b/Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift deleted file mode 100644 index 8e2101290..000000000 --- a/Tests/WalletConnectSignTests/SessionRequestsProviderTests.swift +++ /dev/null @@ -1,18 +0,0 @@ -import XCTest -@testable import WalletConnectSign - -class SessionRequestsProviderTests: XCTestCase { - - var sut: SessionRequestsProvider! - - func testEmitNewRequestWhenNoPending() { - - } - - func testEmitOldRequestOnNewWhenThereArePendingRequests() { - - } - -} - - From 569c559c8a5306b07d00e470e427196a1a1ebf99 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 11:48:24 +0100 Subject: [PATCH 323/814] savepoint --- .../SessionEngineTests.swift | 28 ++++++++++++------- 1 file changed, 18 insertions(+), 10 deletions(-) diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index c4c7a1112..d2d68f9b2 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -9,27 +9,34 @@ final class SessionEngineTests: XCTestCase { var sessionStorage: WCSessionStorageMock! var verifyContextStore: CodableStore! var engine: SessionEngine! + var rpcHistory: RPCHistory! + var historyService: HistoryService! + var sessionRequestsProvider: SessionRequestsProvider! override func setUp() { + rpcHistory = RPCHistory( + keyValueStore: .init( + defaults: RuntimeKeyValueStorage(), + identifier: "" + ) + ) + historyService = HistoryService( + history: rpcHistory, + verifyContextStore: verifyContextStore + ) + sessionRequestsProvider = SessionRequestsProvider(historyService: historyService) networkingInteractor = NetworkingInteractorMock() sessionStorage = WCSessionStorageMock() verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") engine = SessionEngine( networkingInteractor: networkingInteractor, - historyService: HistoryService( - history: RPCHistory( - keyValueStore: .init( - defaults: RuntimeKeyValueStorage(), - identifier: "" - ) - ), - verifyContextStore: verifyContextStore - ), + historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: VerifyClientMock(), kms: KeyManagementServiceMock(), sessionStore: sessionStorage, - logger: ConsoleLoggerMock() + logger: ConsoleLoggerMock(), + sessionRequestsProvider: sessionRequestsProvider ) } @@ -57,3 +64,4 @@ final class SessionEngineTests: XCTestCase { wait(for: [expectation], timeout: 0.5) } } + From 108b075364b41cc87ba365ced00df14dc1130059 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 11:50:36 +0100 Subject: [PATCH 324/814] fix tests --- .../SessionEngineTests.swift | 36 ++++++++++--------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index d2d68f9b2..e3a42232e 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -9,34 +9,37 @@ final class SessionEngineTests: XCTestCase { var sessionStorage: WCSessionStorageMock! var verifyContextStore: CodableStore! var engine: SessionEngine! - var rpcHistory: RPCHistory! - var historyService: HistoryService! - var sessionRequestsProvider: SessionRequestsProvider! override func setUp() { - rpcHistory = RPCHistory( - keyValueStore: .init( - defaults: RuntimeKeyValueStorage(), - identifier: "" - ) - ) - historyService = HistoryService( - history: rpcHistory, - verifyContextStore: verifyContextStore - ) - sessionRequestsProvider = SessionRequestsProvider(historyService: historyService) networkingInteractor = NetworkingInteractorMock() sessionStorage = WCSessionStorageMock() verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") engine = SessionEngine( networkingInteractor: networkingInteractor, - historyService: historyService, + historyService: HistoryService( + history: RPCHistory( + keyValueStore: .init( + defaults: RuntimeKeyValueStorage(), + identifier: "" + ) + ), + verifyContextStore: verifyContextStore + ), verifyContextStore: verifyContextStore, verifyClient: VerifyClientMock(), kms: KeyManagementServiceMock(), sessionStore: sessionStorage, logger: ConsoleLoggerMock(), - sessionRequestsProvider: sessionRequestsProvider + sessionRequestsProvider: SessionRequestsProvider( + historyService: HistoryService( + history: RPCHistory( + keyValueStore: .init( + defaults: RuntimeKeyValueStorage(), + identifier: "" + ) + ), + verifyContextStore: verifyContextStore + )) ) } @@ -64,4 +67,3 @@ final class SessionEngineTests: XCTestCase { wait(for: [expectation], timeout: 0.5) } } - From b750f01d0ebba42ead70e2f6d9d3b4aee941dc3c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 12:09:23 +0100 Subject: [PATCH 325/814] fix tests --- Sources/WalletConnectSign/Engine/Common/SessionEngine.swift | 6 ++++-- .../WalletConnectSign/Sign/SessionRequestsProvider.swift | 4 ++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 429718b64..daf11e954 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -51,7 +51,8 @@ final class SessionEngine { setupResponseSubscriptions() setupUpdateSubscriptions() setupExpirationSubscriptions() - DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [unowned self] in + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in + guard let self = self else {return} sessionRequestsProvider.emitRequestIfPending() } } @@ -105,7 +106,8 @@ final class SessionEngine { protocolMethod: protocolMethod ) verifyContextStore.delete(forKey: requestId.string) - DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [unowned self] in + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in + guard let self = self else {return} sessionRequestsProvider.emitRequestIfPending() } } diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index a8b91d325..0b986d73a 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -19,8 +19,8 @@ class SessionRequestsProvider { private func setupEmitRequestHandling() { emitRequestSubject - .sink { [unowned self] _ in - + .sink { [weak self] _ in + guard let self = self else { return } let now = Date() if let lastEmitDate = self.lastEmitDate, now.timeIntervalSince(lastEmitDate) < 1 { // If the last emit was less than 1 second ago, ignore this request. From 6300045c8f97c6eabb7e6cc8d91f2d3ebcf731c7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 12:34:28 +0100 Subject: [PATCH 326/814] review fix --- .../PresentationLayer/Wallet/Main/MainPresenter.swift | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift index debbf14df..57900bcad 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift @@ -50,14 +50,14 @@ extension MainPresenter { interactor.sessionRequestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] (request, context) in - if let vc = UIApplication.currentWindow.rootViewController?.topController, - vc.restorationIdentifier == SessionRequestModule.restorationIdentifier { + guard let vc = UIApplication.currentWindow.rootViewController?.topController, + vc.restorationIdentifier != SessionRequestModule.restorationIdentifier else { return - } else { - router.dismiss() - router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) } + router.dismiss() + router.present(sessionRequest: request, importAccount: importAccount, sessionContext: context) }.store(in: &disposeBag) + interactor.requestPublisher .receive(on: DispatchQueue.main) From 3ea18bffed954756b31eb2f22c35a0ff3a287857 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 13:29:03 +0100 Subject: [PATCH 327/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 637534c2f..e7412cfa3 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -347,7 +347,7 @@ public final class SignClient: SignClientProtocol { } public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { - return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account)) + return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account), includeRecapInTheStatement: true) } public func makeAuthObject(authRequest: AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { From bf777cda1d2d1b61d3686781bdceccb5f10ab5c2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 13:39:12 +0100 Subject: [PATCH 328/814] simplify SessionRequestsProvider --- .../Sign/SessionRequestsProvider.swift | 30 ++----------------- 1 file changed, 3 insertions(+), 27 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index 0b986d73a..7838b65b7 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -4,41 +4,17 @@ import Foundation class SessionRequestsProvider { private let historyService: HistoryService private var sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() - private var cancellables = Set() - private var lastEmitDate: Date? - private var emitRequestSubject = PassthroughSubject() - public var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { sessionRequestPublisherSubject.eraseToAnyPublisher() } init(historyService: HistoryService) { self.historyService = historyService - setupEmitRequestHandling() - } - - private func setupEmitRequestHandling() { - emitRequestSubject - .sink { [weak self] _ in - guard let self = self else { return } - let now = Date() - if let lastEmitDate = self.lastEmitDate, now.timeIntervalSince(lastEmitDate) < 1 { - // If the last emit was less than 1 second ago, ignore this request. - return - } - - // Update the last emit time to now. - self.lastEmitDate = now - - // Fetch the oldest request and emit it. - if let oldestRequest = self.historyService.getPendingRequestsSortedByTimestamp().first { - self.sessionRequestPublisherSubject.send(oldestRequest) - } - } - .store(in: &cancellables) } func emitRequestIfPending() { - emitRequestSubject.send(()) + if let oldestRequest = self.historyService.getPendingRequestsSortedByTimestamp().first { + self.sessionRequestPublisherSubject.send(oldestRequest) + } } } From 3a10e44e923cc65e5d556554032289f223ec878e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 14:20:23 +0100 Subject: [PATCH 329/814] add recap to the statement --- .../Auth/Services/App/AuthResponseSubscriber.swift | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 1ee89b8e5..245805407 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -73,14 +73,15 @@ class AuthResponseSubscriber { try await cacaos.asyncForEach { [unowned self] cacao in guard let account = try? DIDPKH(did: cacao.p.iss).account, - let message = try? messageFormatter.formatMessage(from: cacao.p) + let message = try? messageFormatter.formatMessage(from: cacao.p, includeRecapInTheStatement: true) else { throw AuthError.malformedResponseParams } guard let recovered = try? messageFormatter.formatMessage( - from: authRequestPayload.cacaoPayload(account: account) + from: authRequestPayload.cacaoPayload(account: account), + includeRecapInTheStatement: true ), recovered == message else { From 2eacd8f97f447a1050a95e51ee393a37ea27e90e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 15:04:50 +0100 Subject: [PATCH 330/814] savepoint --- .../SIWE/RecapStatementBuilder.swift | 63 ++++++++++++++----- .../RecapStatementBuilderTests.swift | 13 +++- 2 files changed, 59 insertions(+), 17 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 2eb4ee145..4b60cfe0e 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -1,31 +1,50 @@ import Foundation +struct RecapUrn { + enum Errors: Error { + case invalidUrn + } + init(urn: String) throws { + guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } + self.urn = urn + } + let urn: String +} + struct RecapStatementBuilder { - static func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { + static func buildRecapStatement(recapUrns: [RecapUrn]) -> String { var statementParts: [String] = [] - // sort resources keys for consistancy in the statement - let sortedResourceKeys = decodedRecap.keys.sorted() + recapUrns.forEach { urn in + let decodedRecap = decodeUrnToJson(urn: urn) + guard let attValue = decodedRecap["att"] else { return } - for resourceKey in sortedResourceKeys { - guard let actions = decodedRecap[resourceKey] else { continue } - var requestActions: [String] = [] - for (actionType, _) in actions where actionType.starts(with: "request/") { - let action = actionType.replacingOccurrences(of: "request/", with: "") - requestActions.append("'\(action)'") - } + // sort resources keys for consistancy in the statement + let sortedResourceKeys = attValue.keys.sorted() + + for resourceKey in sortedResourceKeys { + guard let actions = attValue[resourceKey] else { continue } + var requestActions: [String] = [] + + for (actionType, _) in actions where actionType.starts(with: "request/") { + let action = actionType.replacingOccurrences(of: "request/", with: "") + requestActions.append("'\(action)'") + } - // sorting is required as dictionary doesn't guarantee the order of elements - requestActions.sort() + // sorting is required as dictionary doesn't guarantee the order of elements + requestActions.sort() - if !requestActions.isEmpty { - let actionsString = requestActions.joined(separator: ", ") - statementParts.append("'request': \(actionsString) for '\(resourceKey)'") + if !requestActions.isEmpty { + let actionsString = requestActions.joined(separator: ", ") + statementParts.append("'request': \(actionsString) for '\(resourceKey)'") + } } + } + if !statementParts.isEmpty { let formattedStatement = statementParts.joined(separator: "; ") return "I further authorize the stated URI to perform the following actions: (1) \(formattedStatement)." @@ -33,4 +52,18 @@ struct RecapStatementBuilder { return "" } } + + + private static func decodeUrnToJson(urn: RecapUrn) -> [String: [String: [String: [String]]]] { + // Decode the Base64 encoded JSON + guard let jsonData = Data(base64Encoded: urn.urn) else { return nil } + + // Deserialize the JSON data into the desired dictionary + do { + let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) + return decodedDictionary + } catch { + return nil + } + } } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index d31188ac1..734b02b88 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -10,9 +10,12 @@ class RecapStatementBuilderTests: XCTestCase { ] ] + let encoded = try! JSONEncoder().encode(decodedRecap).base64EncodedString() + let urn = try! RecapUrn(urn: "urn:recap:\(encoded)") + let expectedStatement = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." - let recapStatement = RecapStatementBuilder.buildRecapStatement(from: decodedRecap) + let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) XCTAssertEqual(recapStatement, expectedStatement) } @@ -24,11 +27,17 @@ class RecapStatementBuilderTests: XCTestCase { "request/eth_sendTransaction": [] ] ] + let encoded = try! JSONEncoder().encode(decodedRecap).base64EncodedString() + let urn = try! RecapUrn(urn: "urn:recap:\(encoded)") let expectedStatement = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." - let recapStatement = RecapStatementBuilder.buildRecapStatement(from: decodedRecap) + let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) XCTAssertEqual(recapStatement, expectedStatement) } + + func testMultipleRecaps() { + + } } From bd29c773a42219f5728fc93615e4af38015a7ddd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 31 Jan 2024 15:29:50 +0100 Subject: [PATCH 331/814] update recap statement builder --- .../SIWE/RecapStatementBuilder.swift | 34 +++++++++---------- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 8 ++--- .../RecapStatementBuilderTests.swift | 20 ++++++----- 3 files changed, 33 insertions(+), 29 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 4b60cfe0e..df1ceea12 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -1,15 +1,23 @@ - import Foundation struct RecapUrn { enum Errors: Error { case invalidUrn } + let urn: String + init(urn: String) throws { guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } self.urn = urn } - let urn: String + + // Extracts the Base64-encoded JSON portion of the URN + func decodedPayload() -> Data? { + let components = urn.components(separatedBy: ":") + guard components.count > 2 else { return nil } + let base64Part = components.dropFirst(2).joined(separator: ":") + return Data(base64Encoded: base64Part) + } } struct RecapStatementBuilder { @@ -17,11 +25,10 @@ struct RecapStatementBuilder { var statementParts: [String] = [] recapUrns.forEach { urn in - let decodedRecap = decodeUrnToJson(urn: urn) - guard let attValue = decodedRecap["att"] else { return } + guard let jsonData = urn.decodedPayload() else { return } + guard let decodedRecap: [String: [String: [String: [String]]]] = decodeUrnToJson(jsonData: jsonData) else { return } - - // sort resources keys for consistancy in the statement + guard let attValue = decodedRecap["att"] else { return } let sortedResourceKeys = attValue.keys.sorted() for resourceKey in sortedResourceKeys { @@ -33,7 +40,6 @@ struct RecapStatementBuilder { requestActions.append("'\(action)'") } - // sorting is required as dictionary doesn't guarantee the order of elements requestActions.sort() if !requestActions.isEmpty { @@ -41,10 +47,8 @@ struct RecapStatementBuilder { statementParts.append("'request': \(actionsString) for '\(resourceKey)'") } } - } - if !statementParts.isEmpty { let formattedStatement = statementParts.joined(separator: "; ") return "I further authorize the stated URI to perform the following actions: (1) \(formattedStatement)." @@ -53,16 +57,12 @@ struct RecapStatementBuilder { } } - - private static func decodeUrnToJson(urn: RecapUrn) -> [String: [String: [String: [String]]]] { - // Decode the Base64 encoded JSON - guard let jsonData = Data(base64Encoded: urn.urn) else { return nil } - - // Deserialize the JSON data into the desired dictionary + private static func decodeUrnToJson(jsonData: Data) -> T? { do { - let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) - return decodedDictionary + let decodedObject = try JSONDecoder().decode(T.self, from: jsonData) + return decodedObject } catch { + print("Error decoding JSON: \(error)") return nil } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 6bf4045a0..6f3395efd 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -46,7 +46,7 @@ public struct SIWEMessage: Equatable { private func getStatementLine(includeRecapInTheStatement: Bool) -> String { if includeRecapInTheStatement, - let resource = resources?.last, + let recaps = resources?.compactMap { RecapUrn(urn: $0) } let decodedRecap = decodeUrnToJson(urn: resource), let attValue = decodedRecap["att"] { if let statement = statement { @@ -81,9 +81,9 @@ public struct SIWEMessage: Equatable { } } - private func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { - RecapStatementBuilder.buildRecapStatement(from: decodedRecap) - } +// private func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { +// RecapStatementBuilder.buildRecapStatement(from: decodedRecap) +// } } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index 734b02b88..f2f150747 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -3,10 +3,12 @@ import XCTest class RecapStatementBuilderTests: XCTestCase { func testSingleResourceKey() { - let decodedRecap: [String: [String: [String]]] = [ - "eip155": [ - "request/eth_sendTransaction": [], - "request/personal_sign": [] + let decodedRecap: [String: [String: [String: [String]]]] = [ + "att": [ + "eip155": [ + "request/eth_sendTransaction": [], + "request/personal_sign": [] + ] ] ] @@ -21,10 +23,12 @@ class RecapStatementBuilderTests: XCTestCase { } func testInvertedAction() { - let decodedRecap: [String: [String: [String]]] = [ - "eip155": [ - "request/personal_sign": [], - "request/eth_sendTransaction": [] + let decodedRecap: [String: [String: [String: [String]]]] = [ + "att": [ + "eip155": [ + "request/personal_sign": [], + "request/eth_sendTransaction": [] + ] ] ] let encoded = try! JSONEncoder().encode(decodedRecap).base64EncodedString() From e5ed0dde937596c784ab2ec45f0d015a4b879024 Mon Sep 17 00:00:00 2001 From: flypaper0 Date: Wed, 31 Jan 2024 15:32:48 +0100 Subject: [PATCH 332/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index c16d55635..ec1cdfd4c 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.11.0"} +{"version": "1.12.0"} From 2c9d72cf526189ea5267034be394b081713615bf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 1 Feb 2024 10:14:44 +0100 Subject: [PATCH 333/814] generalise recap statement builder --- .../SIWE/RecapStatementBuilder.swift | 32 ++++++++++----- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 27 ++++++------ .../RecapStatementBuilderTests.swift | 41 ++++++++++++++++++- 3 files changed, 74 insertions(+), 26 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index df1ceea12..1513a0c6f 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -23,6 +23,7 @@ struct RecapUrn { struct RecapStatementBuilder { static func buildRecapStatement(recapUrns: [RecapUrn]) -> String { var statementParts: [String] = [] + var actionCounter: Int = 1 recapUrns.forEach { urn in guard let jsonData = urn.decodedPayload() else { return } @@ -33,27 +34,36 @@ struct RecapStatementBuilder { for resourceKey in sortedResourceKeys { guard let actions = attValue[resourceKey] else { continue } - var requestActions: [String] = [] + var actionsByType: [String: [String]] = [:] - for (actionType, _) in actions where actionType.starts(with: "request/") { - let action = actionType.replacingOccurrences(of: "request/", with: "") - requestActions.append("'\(action)'") + // Grouping actions by their prefix + for (actionType, _) in actions { + let components = actionType.split(separator: "/").map(String.init) + guard components.count > 1 else { continue } + let prefix = components[0] + let action = components.dropFirst().joined(separator: "/") + + actionsByType[prefix, default: []].append(action) } - requestActions.sort() + // Sorting the action types (prefixes) alphabetically + let sortedActionTypes = actionsByType.keys.sorted() - if !requestActions.isEmpty { - let actionsString = requestActions.joined(separator: ", ") - statementParts.append("'request': \(actionsString) for '\(resourceKey)'") + // Constructing statement parts from sorted actions + for prefix in sortedActionTypes { + guard let actionList = actionsByType[prefix] else { continue } + let sortedActionList = actionList.sorted().map { "'\($0)'" }.joined(separator: ", ") + statementParts.append("(\(actionCounter)) '\(prefix)': \(sortedActionList) for '\(resourceKey)'") + actionCounter += 1 } } } if !statementParts.isEmpty { - let formattedStatement = statementParts.joined(separator: "; ") - return "I further authorize the stated URI to perform the following actions: (1) \(formattedStatement)." + let formattedStatement = statementParts.joined(separator: ". ") + return "I further authorize the stated URI to perform the following actions on my behalf: \(formattedStatement)." } else { - return "" + return "No actions authorized." } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 6f3395efd..16fecd439 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -45,19 +45,20 @@ public struct SIWEMessage: Equatable { } private func getStatementLine(includeRecapInTheStatement: Bool) -> String { - if includeRecapInTheStatement, - let recaps = resources?.compactMap { RecapUrn(urn: $0) } - let decodedRecap = decodeUrnToJson(urn: resource), - let attValue = decodedRecap["att"] { - if let statement = statement { - return "\n\(statement) \(buildRecapStatement(from: attValue))" - } else { - return "\n\(buildRecapStatement(from: attValue))" - } - } else { - guard let statement = statement else { return "" } - return "\n\(statement)" - } + "" +// if includeRecapInTheStatement, +// let recaps = resources?.compactMap { RecapUrn(urn: $0) } +// let decodedRecap = decodeUrnToJson(urn: resource), +// let attValue = decodedRecap["att"] { +// if let statement = statement { +// return "\n\(statement) \(buildRecapStatement(from: attValue))" +// } else { +// return "\n\(buildRecapStatement(from: attValue))" +// } +// } else { +// guard let statement = statement else { return "" } +// return "\n\(statement)" +// } } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index f2f150747..8750ee198 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -15,7 +15,7 @@ class RecapStatementBuilderTests: XCTestCase { let encoded = try! JSONEncoder().encode(decodedRecap).base64EncodedString() let urn = try! RecapUrn(urn: "urn:recap:\(encoded)") - let expectedStatement = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." + let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) @@ -34,7 +34,7 @@ class RecapStatementBuilderTests: XCTestCase { let encoded = try! JSONEncoder().encode(decodedRecap).base64EncodedString() let urn = try! RecapUrn(urn: "urn:recap:\(encoded)") - let expectedStatement = "I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." + let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) @@ -42,6 +42,43 @@ class RecapStatementBuilderTests: XCTestCase { } func testMultipleRecaps() { + // First recap structure + let decodedRecap1: [String: [String: [String: [String]]]] = [ + "att": [ + "eip155": [ + "request/eth_sendTransaction": [], + "request/personal_sign": [] + ] + ] + ] + + // Second recap structure, as provided + let decodedRecap2: [String: [String: [String: [String]]]] = [ + "att": [ + "https://example.com/pictures/": [ + "crud/delete": [], + "crud/update": [], + "other/action": [] + ] + ] + ] + + // Encoding both recaps + let encoded1 = try! JSONEncoder().encode(decodedRecap1).base64EncodedString() + let encoded2 = try! JSONEncoder().encode(decodedRecap2).base64EncodedString() + + // Creating URNs + let urn1 = try! RecapUrn(urn: "urn:recap:\(encoded1)") + let urn2 = try! RecapUrn(urn: "urn:recap:\(encoded2)") + // Expected statement combining both recaps + let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'delete', 'update' for 'https://example.com/pictures/'. (3) 'other': 'action' for 'https://example.com/pictures/'." + + // Generating the recap statement from both URNs + let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn1, urn2]) + + // Asserting the generated statement against the expected statement + XCTAssertEqual(recapStatement, expectedStatement) } + } From cb36bb346910ff7c48f793bf339f9eb8f747044d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 1 Feb 2024 13:24:49 +0100 Subject: [PATCH 334/814] savepoint --- .../SIWE/RecapStatementBuilder.swift | 44 +++++++------------ .../RecapStatementBuilderTests.swift | 17 +++++++ 2 files changed, 33 insertions(+), 28 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 1513a0c6f..4b81fd8a4 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -20,6 +20,11 @@ struct RecapUrn { } } +struct RecapData: Decodable { + var att: [String: [String: [AnyCodable]]]? + var prf: [String]? +} + struct RecapStatementBuilder { static func buildRecapStatement(recapUrns: [RecapUrn]) -> String { var statementParts: [String] = [] @@ -27,33 +32,26 @@ struct RecapStatementBuilder { recapUrns.forEach { urn in guard let jsonData = urn.decodedPayload() else { return } - guard let decodedRecap: [String: [String: [String: [String]]]] = decodeUrnToJson(jsonData: jsonData) else { return } + guard let decodedRecap = try? JSONDecoder().decode(RecapData.self, from: jsonData) else { + print("Error decoding JSON") + return + } - guard let attValue = decodedRecap["att"] else { return } + guard let attValue = decodedRecap.att else { return } let sortedResourceKeys = attValue.keys.sorted() for resourceKey in sortedResourceKeys { guard let actions = attValue[resourceKey] else { continue } var actionsByType: [String: [String]] = [:] - // Grouping actions by their prefix - for (actionType, _) in actions { - let components = actionType.split(separator: "/").map(String.init) - guard components.count > 1 else { continue } - let prefix = components[0] - let action = components.dropFirst().joined(separator: "/") - - actionsByType[prefix, default: []].append(action) + for actionType in actions.keys { + let action = actionType.split(separator: "/").dropFirst().joined(separator: "/") + actionsByType[String(actionType.split(separator: "/").first!), default: []].append(action) } - // Sorting the action types (prefixes) alphabetically - let sortedActionTypes = actionsByType.keys.sorted() - - // Constructing statement parts from sorted actions - for prefix in sortedActionTypes { - guard let actionList = actionsByType[prefix] else { continue } - let sortedActionList = actionList.sorted().map { "'\($0)'" }.joined(separator: ", ") - statementParts.append("(\(actionCounter)) '\(prefix)': \(sortedActionList) for '\(resourceKey)'") + actionsByType.sorted(by: { $0.key < $1.key }).forEach { prefix, actions in + let formattedActions = actions.sorted().map { "'\($0)'" }.joined(separator: ", ") + statementParts.append("(\(actionCounter)) '\(prefix)': \(formattedActions) for '\(resourceKey)'") actionCounter += 1 } } @@ -66,14 +64,4 @@ struct RecapStatementBuilder { return "No actions authorized." } } - - private static func decodeUrnToJson(jsonData: Data) -> T? { - do { - let decodedObject = try JSONDecoder().decode(T.self, from: jsonData) - return decodedObject - } catch { - print("Error decoding JSON: \(error)") - return nil - } - } } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index 8750ee198..5d24f2aea 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -81,4 +81,21 @@ class RecapStatementBuilderTests: XCTestCase { XCTAssertEqual(recapStatement, expectedStatement) } + func testComplexRecap() { + // URN with encoded JSON string + let urnString = "urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9leGFtcGxlLmNvbS9waWN0dXJlcy8iOnsiY3J1ZC9kZWxldGUiOlt7fV0sImNydWQvdXBkYXRlIjpbe31dLCJvdGhlci9hY3Rpb24iOlt7fV19LCJtYWlsdG86dXNlcm5hbWVAZXhhbXBsZS5jb20iOnsibXNnL3JlY2VpdmUiOlt7Im1heF9jb3VudCI6NSwidGVtcGxhdGVzIjpbIm5ld3NsZXR0ZXIiLCJtYXJrZXRpbmciXX1dLCJtc2cvc2VuZCI6W3sidG8iOiJzb21lb25lQGVtYWlsLmNvbSJ9LHsidG8iOiJqb2VAZW1haWwuY29tIn1dfX0sInByZiI6WyJiYWZ5YmVpZ2s3bHkzcG9nNnV1cHhrdTNiNmJ1YmlycjQzNGliNnRmYXltdm94NmdvdGFhYWFhYSJdfQ==" + + let urn = try! RecapUrn(urn: urnString) + + // Expected statement + let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'crud': 'delete', 'update' for 'https://example.com/pictures'. (2) 'other': 'action' for 'https://example.com/pictures'. (3) 'msg': 'receive', 'send' for 'mailto:username@example.com'." + + // Generating the recap statement from the URN + let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + + // Asserting the generated statement against the expected statement + XCTAssertEqual(recapStatement, expectedStatement) + } + + } From d29b77454c2db3ea15cf7d12db4129ddbe9eb27e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 1 Feb 2024 13:38:02 +0100 Subject: [PATCH 335/814] pass testComplexRecap --- .../RecapStatementBuilderTests.swift | 39 ++++++++++++++++--- 1 file changed, 34 insertions(+), 5 deletions(-) diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index 5d24f2aea..09ffbe10b 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -82,13 +82,41 @@ class RecapStatementBuilderTests: XCTestCase { } func testComplexRecap() { - // URN with encoded JSON string - let urnString = "urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9leGFtcGxlLmNvbS9waWN0dXJlcy8iOnsiY3J1ZC9kZWxldGUiOlt7fV0sImNydWQvdXBkYXRlIjpbe31dLCJvdGhlci9hY3Rpb24iOlt7fV19LCJtYWlsdG86dXNlcm5hbWVAZXhhbXBsZS5jb20iOnsibXNnL3JlY2VpdmUiOlt7Im1heF9jb3VudCI6NSwidGVtcGxhdGVzIjpbIm5ld3NsZXR0ZXIiLCJtYXJrZXRpbmciXX1dLCJtc2cvc2VuZCI6W3sidG8iOiJzb21lb25lQGVtYWlsLmNvbSJ9LHsidG8iOiJqb2VAZW1haWwuY29tIn1dfX0sInByZiI6WyJiYWZ5YmVpZ2s3bHkzcG9nNnV1cHhrdTNiNmJ1YmlycjQzNGliNnRmYXltdm94NmdvdGFhYWFhYSJdfQ==" - - let urn = try! RecapUrn(urn: urnString) + // JSON string + let jsonString = """ + { + "att":{ + "https://example.com/pictures/":{ + "crud/delete": [{}], + "crud/update": [{}], + "other/action": [{}] + }, + "mailto:username@example.com":{ + "msg/receive": [{ + "max_count": 5, + "templates": ["newsletter", "marketing"] + }], + "msg/send": [{"to": "someone@email.com"}, {"to": "joe@email.com"}] + } + }, + "prf":["bafybeigk7ly3pog6uupxku3b6bubirr434ib6tfaymvox6gotaaaaaaaaa"] + } + """ + + // Convert JSON string to Data + guard let jsonData = jsonString.data(using: .utf8) else { + XCTFail("Failed to convert JSON string to Data") + return + } + + // Base64 encode the JSON data + let base64EncodedJson = jsonData.base64EncodedString() + + // Create a URN with the encoded JSON + let urn = try! RecapUrn(urn: "urn:recap:\(base64EncodedJson)") // Expected statement - let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'crud': 'delete', 'update' for 'https://example.com/pictures'. (2) 'other': 'action' for 'https://example.com/pictures'. (3) 'msg': 'receive', 'send' for 'mailto:username@example.com'." + let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'crud': 'delete', 'update' for 'https://example.com/pictures/'. (2) 'other': 'action' for 'https://example.com/pictures/'. (3) 'msg': 'receive', 'send' for 'mailto:username@example.com'." // Generating the recap statement from the URN let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) @@ -98,4 +126,5 @@ class RecapStatementBuilderTests: XCTestCase { } + } From 856468465cf3ec8f9ad7877cb5e96ec6d8287222 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 2 Feb 2024 08:19:22 +0100 Subject: [PATCH 336/814] update recap statement builder --- .../SIWE/RecapStatementBuilder.swift | 52 +++++++++++-------- .../RecapStatementBuilderTests.swift | 24 ++++++--- .../RecapUrnTests.swift | 37 +++++++++++++ 3 files changed, 86 insertions(+), 27 deletions(-) create mode 100644 Tests/WalletConnectUtilsTests/RecapUrnTests.swift diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 4b81fd8a4..5912ca81b 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -3,20 +3,28 @@ import Foundation struct RecapUrn { enum Errors: Error { case invalidUrn + case invalidPayload + case invalidJsonStructure } + let urn: String + let recapData: RecapData init(urn: String) throws { guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } - self.urn = urn - } - // Extracts the Base64-encoded JSON portion of the URN - func decodedPayload() -> Data? { let components = urn.components(separatedBy: ":") - guard components.count > 2 else { return nil } - let base64Part = components.dropFirst(2).joined(separator: ":") - return Data(base64Encoded: base64Part) + guard components.count > 2, let jsonData = Data(base64Encoded: components.dropFirst(2).joined(separator: ":")) else { + throw Errors.invalidPayload + } + + do { + self.recapData = try JSONDecoder().decode(RecapData.self, from: jsonData) + } catch { + throw Errors.invalidJsonStructure + } + + self.urn = urn } } @@ -26,30 +34,32 @@ struct RecapData: Decodable { } struct RecapStatementBuilder { - static func buildRecapStatement(recapUrns: [RecapUrn]) -> String { + enum Errors: Error { + case noActionsAuthorized + } + + static func buildRecapStatement(recapUrns: [RecapUrn]) throws -> String { var statementParts: [String] = [] - var actionCounter: Int = 1 + var actionCounter = 1 recapUrns.forEach { urn in - guard let jsonData = urn.decodedPayload() else { return } - guard let decodedRecap = try? JSONDecoder().decode(RecapData.self, from: jsonData) else { - print("Error decoding JSON") - return - } + let decodedRecap = urn.recapData guard let attValue = decodedRecap.att else { return } + let sortedResourceKeys = attValue.keys.sorted() for resourceKey in sortedResourceKeys { guard let actions = attValue[resourceKey] else { continue } - var actionsByType: [String: [String]] = [:] + var groupedActions: [String: [String]] = [:] for actionType in actions.keys { - let action = actionType.split(separator: "/").dropFirst().joined(separator: "/") - actionsByType[String(actionType.split(separator: "/").first!), default: []].append(action) + let prefix = String(actionType.split(separator: "/").first ?? "") + let action = actionType.split(separator: "/").dropFirst().joined(separator: ": ") + groupedActions[prefix, default: []].append(action) } - actionsByType.sorted(by: { $0.key < $1.key }).forEach { prefix, actions in + for (prefix, actions) in groupedActions.sorted(by: { $0.key < $1.key }) { let formattedActions = actions.sorted().map { "'\($0)'" }.joined(separator: ", ") statementParts.append("(\(actionCounter)) '\(prefix)': \(formattedActions) for '\(resourceKey)'") actionCounter += 1 @@ -57,11 +67,11 @@ struct RecapStatementBuilder { } } - if !statementParts.isEmpty { + if statementParts.isEmpty { + throw Errors.noActionsAuthorized + } else { let formattedStatement = statementParts.joined(separator: ". ") return "I further authorize the stated URI to perform the following actions on my behalf: \(formattedStatement)." - } else { - return "No actions authorized." } } } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index 09ffbe10b..ea518133d 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -17,7 +17,7 @@ class RecapStatementBuilderTests: XCTestCase { let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." - let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) XCTAssertEqual(recapStatement, expectedStatement) } @@ -36,7 +36,7 @@ class RecapStatementBuilderTests: XCTestCase { let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." - let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) XCTAssertEqual(recapStatement, expectedStatement) } @@ -75,7 +75,7 @@ class RecapStatementBuilderTests: XCTestCase { let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'delete', 'update' for 'https://example.com/pictures/'. (3) 'other': 'action' for 'https://example.com/pictures/'." // Generating the recap statement from both URNs - let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn1, urn2]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn1, urn2]) // Asserting the generated statement against the expected statement XCTAssertEqual(recapStatement, expectedStatement) @@ -115,16 +115,28 @@ class RecapStatementBuilderTests: XCTestCase { // Create a URN with the encoded JSON let urn = try! RecapUrn(urn: "urn:recap:\(base64EncodedJson)") - // Expected statement let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'crud': 'delete', 'update' for 'https://example.com/pictures/'. (2) 'other': 'action' for 'https://example.com/pictures/'. (3) 'msg': 'receive', 'send' for 'mailto:username@example.com'." - // Generating the recap statement from the URN - let recapStatement = RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) // Asserting the generated statement against the expected statement XCTAssertEqual(recapStatement, expectedStatement) } + func testBuilderThrowsNoActionsAuthorizedError() { + // Create a RecapUrn with no actions + let emptyRecap: [String: [String: [String: [String]]]] = [ + "att": [:] // No actions defined + ] + + let encoded = try! JSONEncoder().encode(emptyRecap).base64EncodedString() + let urn = try! RecapUrn(urn: "urn:recap:\(encoded)") + + // Assert that building a statement with no actions throws an error + XCTAssertThrowsError(try RecapStatementBuilder.buildRecapStatement(recapUrns: [urn])) { error in + XCTAssertEqual(error as? RecapStatementBuilder.Errors, RecapStatementBuilder.Errors.noActionsAuthorized) + } + } } diff --git a/Tests/WalletConnectUtilsTests/RecapUrnTests.swift b/Tests/WalletConnectUtilsTests/RecapUrnTests.swift new file mode 100644 index 000000000..08e098a3b --- /dev/null +++ b/Tests/WalletConnectUtilsTests/RecapUrnTests.swift @@ -0,0 +1,37 @@ +import XCTest +@testable import WalletConnectUtils + +class RecapUrnTests: XCTestCase { + func testRecapUrnInitializationWithInvalidUrn() { + let invalidUrn = "urn:invalid:example" + + XCTAssertThrowsError(try RecapUrn(urn: invalidUrn)) { error in + XCTAssertEqual(error as? RecapUrn.Errors, RecapUrn.Errors.invalidUrn) + } + } + + func testRecapUrnInitializationWithInvalidPayload() { + let invalidPayloadUrn = "urn:recap:invalidPayload" + + XCTAssertThrowsError(try RecapUrn(urn: invalidPayloadUrn)) { error in + XCTAssertEqual(error as? RecapUrn.Errors, RecapUrn.Errors.invalidPayload) + } + } + + func testRecapUrnInitializationSuccess() { + // Example of a valid RecapData structure encoded to Base64 + let validRecapData: [String: Any] = [ + "att": [ + "eip155": [ + "request/eth_sendTransaction": [], + "request/personal_sign": [] + ] + ] + ] + let jsonData = try! JSONSerialization.data(withJSONObject: validRecapData) + let base64EncodedJson = jsonData.base64EncodedString() + let validUrn = "urn:recap:\(base64EncodedJson)" + + XCTAssertNoThrow(try RecapUrn(urn: validUrn)) + } +} From ad063d275c03be5a74d51ace028ef2db37bf605c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 2 Feb 2024 08:46:01 +0100 Subject: [PATCH 337/814] add test with notify --- .../RecapStatementBuilderTests.swift | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index ea518133d..955975ec0 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -81,6 +81,56 @@ class RecapStatementBuilderTests: XCTestCase { XCTAssertEqual(recapStatement, expectedStatement) } + func testRecapNotifyAndSign() throws { + let notifyRecapJson = """ + { + "att":{ + "https://notify.walletconnect.com/all-apps":{ + "crud/notifications": [{}], + "crud/subscriptions": [{}] + } + } + } + """ + + let signRecapJson = """ + { + "att":{ + "eip155":{ + "request/eth_sendTransaction": [{}], + "request/personal_sign": [{}] + } + } + } + """ + + // Correctly constructing Data from JSON strings + guard let notifyRecapData = notifyRecapJson.data(using: .utf8), + let signRecapData = signRecapJson.data(using: .utf8) else { + XCTFail("Failed to create Data from JSON strings") + return + } + + let encodedNotify = notifyRecapData.base64EncodedString() + let encodedSign = signRecapData.base64EncodedString() + + let urn1 = try RecapUrn(urn: "urn:recap:\(encodedSign)") + let urn2 = try RecapUrn(urn: "urn:recap:\(encodedNotify)") + + // Expected statement combining both recaps, reflecting the updated order + let expectedStatement = """ + I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'notifications', 'subscriptions' for 'https://notify.walletconnect.com/all-apps'. + """ + + // Generating the recap statement from both URNs, with 'sign' recap first + let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrns: [urn1, urn2]) + + // Asserting the generated statement against the expected statement + XCTAssertEqual(recapStatement, expectedStatement) + + } + + func testComplexRecap() { // JSON string let jsonString = """ From 061246963d09ecb18923eeee2de7871a0bbb7ce3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 2 Feb 2024 10:18:14 +0100 Subject: [PATCH 338/814] fix uri tests --- Tests/WalletConnectUtilsTests/WalletConnectURITests.swift | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index d3d2ba549..51a29e8d1 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -5,7 +5,8 @@ private func stubURI(includeMethods: Bool = true) -> (uri: WalletConnectURI, str let topic = Data.randomBytes(count: 32).toHexString() let symKey = Data.randomBytes(count: 32).toHexString() let protocolName = "irn" - var uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)" + let timestamp = UInt64(Date().timeIntervalSince1970) + 5 * 60 + var uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)&expiryTimestamp=\(timestamp)" let methods = ["wc_sessionPropose", "wc_sessionAuthenticated"] if includeMethods { let methodsString = methods.joined(separator: ",") From a02509b7d4191f01d770d1f894859875f27a2eb8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 2 Feb 2024 13:21:41 +0100 Subject: [PATCH 339/814] fix SIWE message and Sign tests --- .../SIWE/RecapStatementBuilder.swift | 2 + .../SIWE/SIWECacaoFormatter.swift | 2 +- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 43 +++++++++---------- .../SIWEMessageFormatterTests.swift | 35 ++++++++++++++- .../RecapStatementBuilderTests.swift | 1 - 5 files changed, 57 insertions(+), 26 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 5912ca81b..e3561c644 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -36,9 +36,11 @@ struct RecapData: Decodable { struct RecapStatementBuilder { enum Errors: Error { case noActionsAuthorized + case emptyRecapsForbidden } static func buildRecapStatement(recapUrns: [RecapUrn]) throws -> String { + guard recapUrns.count > 0 else { throw Errors.emptyRecapsForbidden } var statementParts: [String] = [] var actionCounter = 1 diff --git a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift index c4dc9216c..4721f69db 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift @@ -28,7 +28,7 @@ public struct SIWECacaoFormatter: SIWECacaoFormatting { requestId: payload.requestId, resources: payload.resources ) - return message.formatted(includeRecapInTheStatement: includeRecapInTheStatement) + return try message.formatted() } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 16fecd439..6d1d2a936 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -29,12 +29,13 @@ public struct SIWEMessage: Equatable { self.resources = resources } - public func formatted(includeRecapInTheStatement: Bool = false) -> String { + public func formatted() throws -> String { + let statementLine = try getStatementLine() return """ \(domain) wants you to sign in with your Ethereum account: \(address) - \(getStatementLine(includeRecapInTheStatement: includeRecapInTheStatement)) + \(statementLine) URI: \(uri) Version: \(version) @@ -44,21 +45,24 @@ public struct SIWEMessage: Equatable { """ } - private func getStatementLine(includeRecapInTheStatement: Bool) -> String { - "" -// if includeRecapInTheStatement, -// let recaps = resources?.compactMap { RecapUrn(urn: $0) } -// let decodedRecap = decodeUrnToJson(urn: resource), -// let attValue = decodedRecap["att"] { -// if let statement = statement { -// return "\n\(statement) \(buildRecapStatement(from: attValue))" -// } else { -// return "\n\(buildRecapStatement(from: attValue))" -// } -// } else { -// guard let statement = statement else { return "" } -// return "\n\(statement)" -// } + private func getStatementLine() throws -> String { + if let recaps = resources?.compactMap({ try? RecapUrn(urn: $0) }), + !recaps.isEmpty { + do { + let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrns: recaps) + if let statement = statement { + return "\n\(statement) \(recapStatement)" + } else { + return "\n\(recapStatement)" + } + } catch { + throw error + } + } else { + guard let statement = statement else { return "" } + return "\n\(statement)" + } + } @@ -81,11 +85,6 @@ public struct SIWEMessage: Equatable { return nil } } - -// private func buildRecapStatement(from decodedRecap: [String: [String: [String]]]) -> String { -// RecapStatementBuilder.buildRecapStatement(from: decodedRecap) -// } - } private extension SIWEMessage { diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index b5893b7e3..190980483 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -105,7 +105,7 @@ class SIWEMessageFormatterTests: XCTestCase { service.invalid wants you to sign in with your Ethereum account: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 - I accept the ServiceOrg Terms of Service: https://service.invalid/tos I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. + I accept the ServiceOrg Terms of Service: https://service.invalid/tos I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. URI: https://service.invalid/login Version: 1 @@ -134,7 +134,7 @@ class SIWEMessageFormatterTests: XCTestCase { service.invalid wants you to sign in with your Ethereum account: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 - I further authorize the stated URI to perform the following actions: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. + I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. URI: https://service.invalid/login Version: 1 @@ -154,4 +154,35 @@ class SIWEMessageFormatterTests: XCTestCase { XCTAssertEqual(message, expectedMessage) } + func testWithSignAndNotifyRecaps() throws { + let recap1 = "urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJlaXAxNTUiOnsKICAgICAgICAgInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6IFt7fV0sCiAgICAgICAgICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbe31dCiAgICAgIH0KICAgfQp9" + + let recap2 = "urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJodHRwczovL25vdGlmeS53YWxsZXRjb25uZWN0LmNvbS9hbGwtYXBwcyI6ewogICAgICAgICAiY3J1ZC9ub3RpZmljYXRpb25zIjogW3t9XSwKICAgICAgICAgImNydWQvc3Vic2NyaXB0aW9ucyI6IFt7fV0KICAgICAgfQogICB9Cn0=" + + let expectedMessage = + """ + service.invalid wants you to sign in with your Ethereum account: + 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 + + I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'notifications', 'subscriptions' for 'https://notify.walletconnect.com/all-apps'. + + URI: https://service.invalid?walletconnect_notify_key=did:key:z6MktW4hKdsvcXgt9wXmYbSD5sH4NCk5GmNZnokP9yh2TeCf + Version: 1 + Chain ID: 1 + Nonce: 32891756 + Issued At: 2021-09-30T16:25:24Z + Resources: + - urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJlaXAxNTUiOnsKICAgICAgICAgInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6IFt7fV0sCiAgICAgICAgICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbe31dCiAgICAgIH0KICAgfQp9 + - urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJodHRwczovL25vdGlmeS53YWxsZXRjb25uZWN0LmNvbS9hbGwtYXBwcyI6ewogICAgICAgICAiY3J1ZC9ub3RpZmljYXRpb25zIjogW3t9XSwKICAgICAgICAgImNydWQvc3Vic2NyaXB0aW9ucyI6IFt7fV0KICAgICAgfQogICB9Cn0= + """ + + + let uri = "https://service.invalid?walletconnect_notify_key=did:key:z6MktW4hKdsvcXgt9wXmYbSD5sH4NCk5GmNZnokP9yh2TeCf" + let payload = try AuthPayload.stub( + requestParams: AuthRequestParams.stub(aud: uri, statement: nil,resources: [recap1, recap2]) + ).cacaoPayload(account: Account.stub()) + + let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) + XCTAssertEqual(message, expectedMessage) + } } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index 955975ec0..b5cf40478 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -117,7 +117,6 @@ class RecapStatementBuilderTests: XCTestCase { let urn1 = try RecapUrn(urn: "urn:recap:\(encodedSign)") let urn2 = try RecapUrn(urn: "urn:recap:\(encodedNotify)") - // Expected statement combining both recaps, reflecting the updated order let expectedStatement = """ I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'notifications', 'subscriptions' for 'https://notify.walletconnect.com/all-apps'. """ From 94096f3d49d75ea5dec04e160bbcda321fc76c80 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 5 Feb 2024 09:18:46 +0100 Subject: [PATCH 340/814] fix protocol method name --- Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift | 2 +- Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift | 2 +- Tests/WalletConnectUtilsTests/WalletConnectURITests.swift | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift index 2a7fd3ee8..5888e3f0c 100644 --- a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -1,7 +1,7 @@ import Foundation struct SessionAuthenticatedProtocolMethod: ProtocolMethod { - let method: String = "wc_sessionAuthenticated" + let method: String = "wc_sessionAuthenticate" let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 86400) diff --git a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift index 7a4a0eb63..63632e9c1 100644 --- a/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift +++ b/Tests/TestingUtils/Stubs/WalletConnectURI+Stub.swift @@ -4,7 +4,7 @@ import WalletConnectUtils extension WalletConnectURI { public static func stub(isController: Bool = false) -> WalletConnectURI { - let methods = ["wc_sessionPropose", "wc_sessionAuthenticated"] + let methods = ["wc_sessionPropose", "wc_sessionAuthenticate"] return WalletConnectURI( topic: String.generateTopic(), symKey: SymmetricKey().hexRepresentation, diff --git a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift index 51a29e8d1..3fd3d65c9 100644 --- a/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift +++ b/Tests/WalletConnectUtilsTests/WalletConnectURITests.swift @@ -7,7 +7,7 @@ private func stubURI(includeMethods: Bool = true) -> (uri: WalletConnectURI, str let protocolName = "irn" let timestamp = UInt64(Date().timeIntervalSince1970) + 5 * 60 var uriString = "wc:\(topic)@2?symKey=\(symKey)&relay-protocol=\(protocolName)&expiryTimestamp=\(timestamp)" - let methods = ["wc_sessionPropose", "wc_sessionAuthenticated"] + let methods = ["wc_sessionPropose", "wc_sessionAuthenticate"] if includeMethods { let methodsString = methods.joined(separator: ",") uriString.append("&methods=\(methodsString)") From 254641356e5aa728ad7bd47637b7607a8b52a7a8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 5 Feb 2024 12:57:55 +0100 Subject: [PATCH 341/814] remove auth request interactor --- Example/ExampleApp.xcodeproj/project.pbxproj | 6 -- .../AuthRequest/AuthRequestInteractor.swift | 66 -------------- .../AuthRequest/AuthRequestModule.swift | 3 +- .../AuthRequest/AuthRequestPresenter.swift | 85 ++++++++++++++++--- .../Wallet/AuthRequest/AuthRequestView.swift | 8 +- 5 files changed, 77 insertions(+), 91 deletions(-) delete mode 100644 Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index ad33b4c26..f2580ff57 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -226,7 +226,6 @@ C55D347F295DD7140004314A /* AuthRequestModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D347A295DD7140004314A /* AuthRequestModule.swift */; }; C55D3480295DD7140004314A /* AuthRequestPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D347B295DD7140004314A /* AuthRequestPresenter.swift */; }; C55D3481295DD7140004314A /* AuthRequestRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D347C295DD7140004314A /* AuthRequestRouter.swift */; }; - C55D3482295DD7140004314A /* AuthRequestInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D347D295DD7140004314A /* AuthRequestInteractor.swift */; }; C55D3483295DD7140004314A /* AuthRequestView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D347E295DD7140004314A /* AuthRequestView.swift */; }; C55D3489295DD8CA0004314A /* PasteUriModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D3484295DD8CA0004314A /* PasteUriModule.swift */; }; C55D348A295DD8CA0004314A /* PasteUriPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C55D3485295DD8CA0004314A /* PasteUriPresenter.swift */; }; @@ -584,7 +583,6 @@ C55D347A295DD7140004314A /* AuthRequestModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRequestModule.swift; sourceTree = ""; }; C55D347B295DD7140004314A /* AuthRequestPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRequestPresenter.swift; sourceTree = ""; }; C55D347C295DD7140004314A /* AuthRequestRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRequestRouter.swift; sourceTree = ""; }; - C55D347D295DD7140004314A /* AuthRequestInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRequestInteractor.swift; sourceTree = ""; }; C55D347E295DD7140004314A /* AuthRequestView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRequestView.swift; sourceTree = ""; }; C55D3484295DD8CA0004314A /* PasteUriModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PasteUriModule.swift; sourceTree = ""; }; C55D3485295DD8CA0004314A /* PasteUriPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PasteUriPresenter.swift; sourceTree = ""; }; @@ -750,7 +748,6 @@ files = ( A5E03DFF2864662500888481 /* WalletConnect in Frameworks */, A561C80529DFCD4500DF540D /* WalletConnectSync in Frameworks */, - A5B814FA2B5AAA2F00AECCFD /* WalletConnectIdentity in Frameworks */, A5E03DF52864651200888481 /* Starscream in Frameworks */, A5C8BE85292FE20B006CC85C /* Web3 in Frameworks */, C5DD5BE1294E09E3008FD3A4 /* Web3Wallet in Frameworks */, @@ -1532,7 +1529,6 @@ C55D347A295DD7140004314A /* AuthRequestModule.swift */, C55D347B295DD7140004314A /* AuthRequestPresenter.swift */, C55D347C295DD7140004314A /* AuthRequestRouter.swift */, - C55D347D295DD7140004314A /* AuthRequestInteractor.swift */, C55D347E295DD7140004314A /* AuthRequestView.swift */, ); path = AuthRequest; @@ -2051,7 +2047,6 @@ A561C80429DFCD4500DF540D /* WalletConnectSync */, A573C53A29EC365800E3CBFD /* HDWalletKit */, A5B6C0F22A6EAB1700927332 /* WalletConnectNotify */, - A5B814F92B5AAA2F00AECCFD /* WalletConnectIdentity */, ); productName = IntegrationTests; productReference = A5E03DED286464DB00888481 /* IntegrationTests.xctest */; @@ -2447,7 +2442,6 @@ 847BD1DA2989492500076C90 /* MainRouter.swift in Sources */, C5F32A2E2954814A00A6476E /* ConnectionDetailsRouter.swift in Sources */, 84AEC24F2B4D1EE400E27A5B /* ActivityIndicatorManager.swift in Sources */, - C55D3482295DD7140004314A /* AuthRequestInteractor.swift in Sources */, C55D34B12965FB750004314A /* SessionProposalInteractor.swift in Sources */, C56EE247293F566D004840D1 /* ScanModule.swift in Sources */, C56EE28D293F5757004840D1 /* AppearanceConfigurator.swift in Sources */, diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift deleted file mode 100644 index e852a3e18..000000000 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestInteractor.swift +++ /dev/null @@ -1,66 +0,0 @@ -import Foundation - -import Web3Wallet -import WalletConnectRouter - -final class AuthRequestInteractor { - - private let messageSigner: MessageSigner - - init(messageSigner: MessageSigner) { - self.messageSigner = messageSigner - } - - - func approve(request: AuthenticationRequest, importAccount: ImportAccount) async throws -> Bool { - var auths = [AuthObject]() - - - try request.payload.chains.forEach { chain in - - let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - - - let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) - - let signature = try messageSigner.sign( - message: SIWEmessages, - privateKey: Data(hex: importAccount.privateKey), - type: .eip191) - - - - let auth = try Web3Wallet.instance.makeAuthObject(authRequest: request, signature: signature, account: account) - - - auths.append(auth) - } - - - _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) - - /* Redirect */ - if let uri = request.requester.redirect?.native { - WalletConnectRouter.goBack(uri: uri) - return false - } else { - return true - } - } - - func reject(request: AuthenticationRequest) async throws { - try await Web3Wallet.instance.rejectSession(requestId: request.id) - - /* Redirect */ - if let uri = request.requester.redirect?.native { - WalletConnectRouter.goBack(uri: uri) - } - } - - func formatted(request: AuthenticationRequest, account: Account) -> String { - return try! Web3Wallet.instance.formatAuthMessage( - payload: request.payload, - account: account - ) - } -} diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift index 773ad4134..310333053 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestModule.swift @@ -6,8 +6,7 @@ final class AuthRequestModule { @discardableResult static func create(app: Application, request: AuthenticationRequest, importAccount: ImportAccount, context: VerifyContext?) -> UIViewController { let router = AuthRequestRouter(app: app) - let interactor = AuthRequestInteractor(messageSigner: app.messageSigner) - let presenter = AuthRequestPresenter(importAccount: importAccount, interactor: interactor, router: router, request: request, context: context) + let presenter = AuthRequestPresenter(importAccount: importAccount, router: router, request: request, context: context, messageSigner: app.messageSigner) let view = AuthRequestView().environmentObject(presenter) let viewController = SceneViewController(viewModel: presenter, content: view) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 54f140215..009b99456 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -2,53 +2,112 @@ import UIKit import Combine import Web3Wallet +import WalletConnectRouter final class AuthRequestPresenter: ObservableObject { - private let interactor: AuthRequestInteractor private let router: AuthRequestRouter let importAccount: ImportAccount let request: AuthenticationRequest let validationStatus: VerifyContext.ValidationStatus? - var message: String { - return interactor.formatted(request: request, account: importAccount.account) + var messages: [String] { + return buildFormattedMessages(request: request, account: importAccount.account) } - + + func buildFormattedMessages(request: AuthenticationRequest, account: Account) -> [String] { + request.payload.chains.compactMap { chain in + guard let blockchain = Blockchain(chain), let chainAccount = Account(blockchain: blockchain, address: account.address) else { + return nil + } + return try? Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: chainAccount) + } + } + + @Published var showSignedSheet = false private var disposeBag = Set() + private let messageSigner: MessageSigner + init( importAccount: ImportAccount, - interactor: AuthRequestInteractor, router: AuthRequestRouter, request: AuthenticationRequest, - context: VerifyContext? + context: VerifyContext?, + messageSigner: MessageSigner ) { defer { setupInitialState() } - self.interactor = interactor self.router = router self.importAccount = importAccount self.request = request self.validationStatus = context?.validation + self.messageSigner = messageSigner } @MainActor - func onApprove() async throws { - let showConnected = try await interactor.approve(request: request, importAccount: importAccount) - showConnected ? showSignedSheet.toggle() : router.dismiss() + func approve() async { + do { + + let auths = try buildAuthObjects() + + _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) + + /* Redirect */ + if let uri = request.requester.redirect?.native { + WalletConnectRouter.goBack(uri: uri) + router.dismiss() + } else { + showSignedSheet.toggle() + } + + } catch { + AlertPresenter.present(message: error.localizedDescription, type: .error) + } } @MainActor - func onReject() async throws { - try await interactor.reject(request: request) - router.dismiss() + func reject() async { + + do { + try await Web3Wallet.instance.rejectSession(requestId: request.id) + + /* Redirect */ + if let uri = request.requester.redirect?.native { + WalletConnectRouter.goBack(uri: uri) + } + router.dismiss() + } catch { + AlertPresenter.present(message: error.localizedDescription, type: .error) + } } func onSignedSheetDismiss() { router.dismiss() } + + private func buildAuthObjects() throws -> [AuthObject] { + var auths = [AuthObject]() + + try request.payload.chains.forEach { chain in + + let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! + + + let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) + + let signature = try messageSigner.sign( + message: SIWEmessages, + privateKey: Data(hex: importAccount.privateKey), + type: .eip191) + + let auth = try Web3Wallet.instance.makeAuthObject(authRequest: request, signature: signature, account: account) + + auths.append(auth) + } + return auths + } } // MARK: - Private functions diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift index 46e38408f..c9765b22f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift @@ -187,8 +187,8 @@ struct AuthRequestView: View { private func declineButton() -> some View { Button { - Task(priority: .userInitiated) { try await - presenter.onReject() + Task(priority: .userInitiated) { await + presenter.reject() } } label: { Text("Decline") @@ -211,8 +211,8 @@ struct AuthRequestView: View { private func allowButton() -> some View { Button { - Task(priority: .userInitiated) { try await - presenter.onApprove() + Task(priority: .userInitiated) { await + presenter.approve() } } label: { Text(presenter.validationStatus == .scam ? "Proceed anyway" : "Allow") From 89ee393524efb45639f8ba12746f3717bc5c98e0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 5 Feb 2024 15:35:08 +0100 Subject: [PATCH 342/814] update ui for caip222 --- .../AuthRequest/AuthRequestPresenter.swift | 20 ++++-- .../Wallet/AuthRequest/AuthRequestView.swift | 62 +++++++++++++------ 2 files changed, 58 insertions(+), 24 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 009b99456..a2dce2879 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -11,20 +11,24 @@ final class AuthRequestPresenter: ObservableObject { let request: AuthenticationRequest let validationStatus: VerifyContext.ValidationStatus? - var messages: [String] { + var messages: [(String, String)] { return buildFormattedMessages(request: request, account: importAccount.account) } - func buildFormattedMessages(request: AuthenticationRequest, account: Account) -> [String] { - request.payload.chains.compactMap { chain in - guard let blockchain = Blockchain(chain), let chainAccount = Account(blockchain: blockchain, address: account.address) else { + func buildFormattedMessages(request: AuthenticationRequest, account: Account) -> [(String, String)] { + request.payload.chains.enumerated().compactMap { index, chain in + guard let blockchain = Blockchain(chain), + let chainAccount = Account(blockchain: blockchain, address: account.address) else { return nil } - return try? Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: chainAccount) + guard let formattedMessage = try? Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: chainAccount) else { + return nil + } + let messagePrefix = "Message \(index + 1):" + return (messagePrefix, formattedMessage) } } - @Published var showSignedSheet = false private var disposeBag = Set() @@ -108,6 +112,10 @@ final class AuthRequestPresenter: ObservableObject { } return auths } + + func dismiss() { + router.dismiss() + } } // MARK: - Private functions diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift index c9765b22f..e341822f7 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift @@ -11,7 +11,21 @@ struct AuthRequestView: View { VStack { Spacer() - + + VStack { + HStack { + Spacer() + Button(action: { + presenter.dismiss() + }) { + Image(systemName: "xmark") + .foregroundColor(.white) + .padding() + } + } + .padding() + } + VStack(spacing: 0) { Image("header") .resizable() @@ -115,36 +129,48 @@ struct AuthRequestView: View { private func authRequestView() -> some View { VStack { VStack(alignment: .leading) { - Text("Message") + Text("Messages") .font(.system(size: 15, weight: .semibold, design: .rounded)) - .foregroundColor(.whiteBackground) + .foregroundColor(.white) .padding(.horizontal, 8) .padding(.vertical, 5) - .background(Color.grey70) + .background(Color.blue) // Changed background color of the header .cornerRadius(28, corners: .allCorners) .padding(.leading, 15) .padding(.top, 9) - - VStack(spacing: 0) { - ScrollView { - Text(presenter.message) - .foregroundColor(.grey50) - .font(.system(size: 13, weight: .semibold, design: .rounded)) + + ScrollView { + VStack(spacing: 10) { + ForEach(Array(presenter.messages.enumerated()), id: \.offset) { _, messageTuple in + VStack(alignment: .leading, spacing: 5) { // Added spacing between header and message + Text("\(messageTuple.0)") + .font(.system(size: 14, weight: .bold, design: .rounded)) + .foregroundColor(.black) + .padding([.top, .horizontal]) + + Text(messageTuple.1) + .foregroundColor(.grey50) + .font(.system(size: 13, weight: .regular, design: .rounded)) + .padding(.horizontal) + .padding(.bottom) + } + .background(Color.white) + .cornerRadius(12) + .shadow(radius: 2) + } } - .padding(.horizontal, 18) - .padding(.vertical, 10) - .frame(height: 150) + .padding(.horizontal, 5) + .padding(.bottom, 5) } - .background(Color.whiteBackground) - .cornerRadius(20, corners: .allCorners) - .padding(.horizontal, 5) - .padding(.bottom, 5) + .frame(maxHeight: .infinity) } - .background(.thinMaterial) + .background(Color(.systemBackground)) // Adjusted for theme compatibility .cornerRadius(25, corners: .allCorners) } .padding(.vertical, 30) } + + private func verifyBadgeView(imageName: String, title: String, color: Color) -> some View { HStack(spacing: 5) { From d0d349fc301139e7d0e944a8c5ab39a2cdb1cae3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 6 Feb 2024 08:41:36 +0100 Subject: [PATCH 343/814] update sessionnamespace builder --- .../Wallet/AuthRequest/AuthRequestView.swift | 4 +- .../Services/SessionNamespaceBuilder.swift | 61 ++----------------- .../Auth/Services/SessionRecap.swift | 50 +++++++++++++++ 3 files changed, 58 insertions(+), 57 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/SessionRecap.swift diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift index e341822f7..e2b81cd20 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift @@ -134,7 +134,7 @@ struct AuthRequestView: View { .foregroundColor(.white) .padding(.horizontal, 8) .padding(.vertical, 5) - .background(Color.blue) // Changed background color of the header + .background(Color.blue) .cornerRadius(28, corners: .allCorners) .padding(.leading, 15) .padding(.top, 9) @@ -142,7 +142,7 @@ struct AuthRequestView: View { ScrollView { VStack(spacing: 10) { ForEach(Array(presenter.messages.enumerated()), id: \.offset) { _, messageTuple in - VStack(alignment: .leading, spacing: 5) { // Added spacing between header and message + VStack(alignment: .leading, spacing: 5) { Text("\(messageTuple.0)") .font(.system(size: 14, weight: .bold, design: .rounded)) .foregroundColor(.black) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 851656c2f..06c287e5a 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -18,78 +18,29 @@ class SessionNamespaceBuilder { throw Errors.emptyCacaosArrayForbidden } - // Get the first "urn:recap" resource from the first cacao - guard let recapUrn = cacaos.first?.p.resources?.first(where: { $0.hasPrefix("urn:recap") }) else { + // Attempt to initialize SessionRecapUrn from the first valid recap URN in the resources + guard let firstRecapResource = cacaos.first?.p.resources?.compactMap({ try? SessionRecap(urn: $0) }).first else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - // Check if all cacaos have exactly the same first "urn:recap" resource + // Validate that all cacaos contain an equivalent SessionRecapUrn resource for cacao in cacaos { guard let resources = cacao.p.resources, - resources.contains(recapUrn) else { + resources.contains(where: { (try? SessionRecap(urn: $0)) != nil }) else { throw Errors.malformedRecap } } - guard let decodedRecap = decodeUrnToJson(urn: recapUrn), - let chainsNamespace = try? DIDPKH(did: cacaos.first!.p.iss).account.blockchain.namespace else { + guard let chainsNamespace = try? DIDPKH(did: cacaos.first!.p.iss).account.blockchain.namespace else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } let accounts = cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account } let accountsSet = Set(accounts) - let methods = getMethods(from: decodedRecap) + let methods = firstRecapResource.methods let sessionNamespace = SessionNamespace(accounts: accountsSet, methods: methods, events: []) return [chainsNamespace: sessionNamespace] } - - - private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { - // Extract the Base64 encoded JSON part from the URN - let components = urn.components(separatedBy: ":") - guard components.count >= 3, let base64EncodedJson = components.last else { - logger.debug("Invalid URN format") - return nil - } - - // Decode the Base64 encoded JSON - guard let jsonData = Data(base64Encoded: base64EncodedJson) else { - logger.debug("Failed to decode Base64 string") - return nil - } - - // Deserialize the JSON data into the desired dictionary - do { - let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) - return decodedDictionary - } catch { - logger.debug("Error during JSON decoding: \(error.localizedDescription)") - return nil - } - } - - func getMethods(from recap: [String: [String: [String: [String]]]]) -> Set { - var requestMethods: [String] = [] - - // Iterate through the recap dictionary - for (_, resources) in recap { - for (_, requests) in resources { - for (key, _) in requests { - - // Check if the key starts with "request/" - if key.hasPrefix("request/") { - // Extract the method name and add it to the array - let methodName = String(key.dropFirst("request/".count)) - requestMethods.append(methodName) - } - } - } - } - - return Set(requestMethods) - } - } - diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift new file mode 100644 index 000000000..68b58bc33 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift @@ -0,0 +1,50 @@ + +import Foundation + +struct SessionRecap { + struct RecapData: Decodable { + var att: [String: [String: [AnyCodable]]]? + var prf: [String]? + } + let urn: String + let recapData: RecapData + + enum Errors: Error { + case invalidUrnPrefix + case invalidRecapStructure + case invalidActions + } + + init(urn: String) throws { + guard urn.hasPrefix("urn:recap") else { + throw Errors.invalidUrnPrefix + } + + // Extract the Base64 part and decode it into RecapData + let base64Part = urn.dropFirst("urn:recap:".count) + guard let jsonData = Data(base64Encoded: String(base64Part)), + let decodedData = try? JSONDecoder().decode(RecapData.self, from: jsonData) else { + throw Errors.invalidRecapStructure + } + + // Validate the structure specifically for 'eip155' with 'request/' prefixed actions + guard let eip155Actions = decodedData.att?["eip155"], !eip155Actions.isEmpty else { + throw Errors.invalidRecapStructure + } + + // Ensure all actions are prefixed with 'request/' + guard eip155Actions.keys.allSatisfy({ $0.hasPrefix("request/") }) else { + throw Errors.invalidActions + } + + self.urn = urn + self.recapData = decodedData + } + + var methods: Set { + guard let eip155Actions = recapData.att?["eip155"] else { return [] } + return Set(eip155Actions.keys.map { String($0.dropFirst("request/".count)) }) + } + +} + From dd791e66216c52eb94be72a6b73311109376c3f1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 6 Feb 2024 08:50:11 +0100 Subject: [PATCH 344/814] add SessionRecapTests --- .../SessionRecapTests.swift | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 Tests/WalletConnectSignTests/SessionRecapTests.swift diff --git a/Tests/WalletConnectSignTests/SessionRecapTests.swift b/Tests/WalletConnectSignTests/SessionRecapTests.swift new file mode 100644 index 000000000..b5ad51df2 --- /dev/null +++ b/Tests/WalletConnectSignTests/SessionRecapTests.swift @@ -0,0 +1,34 @@ +import XCTest +@testable import WalletConnectSign + +class SessionRecapTests: XCTestCase { + + func testSessionRecapInitializationSuccess() throws { + // dedoded recap: {"att": {"eip155": {"request/eth_signTypedData_v4": [], "request/personal_sign": []}}} + let recapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2lnblR5cGVkRGF0YV92NCI6IFtdLCAicmVxdWVzdC9wZXJzb25hbF9zaWduIjogW119fX0=" + + do { + let sessionRecap = try SessionRecap(urn: recapUrn) + let methods = sessionRecap.methods + // Verify that the expected methods are present + XCTAssertTrue(methods.contains("personal_sign")) + XCTAssertTrue(methods.contains("eth_signTypedData_v4")) + } catch { + XCTFail("Initialization should not fail for valid recap URN.") + } + } + + func testSessionRecapInitializationFailureInvalidRecap() throws { + // dedoded: {"att": {"eip155:1": {"request/eth_signTypedData_v4": [], "request/personal_sign": []}}} + let invalidRecap = "urn:recap:eyJhdHQiOiB7ImVpcDE1NToxIjogeyJyZXF1ZXN0L2V0aF9zaWduVHlwZWREYXRhX3Y0IjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ==" + + XCTAssertThrowsError(try SessionRecap(urn: invalidRecap)) { error in + guard let sessionRecapError = error as? SessionRecap.Errors else { + XCTFail("Error should be of type SessionRecap.Errors") + return + } + + XCTAssertEqual(sessionRecapError, SessionRecap.Errors.invalidRecapStructure) + } + } +} From 5f0969e413dc79c19fa18cff05f61742ee46ff58 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 6 Feb 2024 08:55:27 +0100 Subject: [PATCH 345/814] remove restrictions from init --- .../WalletConnectSign/Auth/Services/SessionRecap.swift | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift index 68b58bc33..7c32e13d7 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift @@ -32,19 +32,15 @@ struct SessionRecap { throw Errors.invalidRecapStructure } - // Ensure all actions are prefixed with 'request/' - guard eip155Actions.keys.allSatisfy({ $0.hasPrefix("request/") }) else { - throw Errors.invalidActions - } - self.urn = urn self.recapData = decodedData } var methods: Set { guard let eip155Actions = recapData.att?["eip155"] else { return [] } - return Set(eip155Actions.keys.map { String($0.dropFirst("request/".count)) }) + return Set(eip155Actions.keys + .filter{$0.hasPrefix("request/")} + .map { String($0.dropFirst("request/".count)) }) } - } From dbc05ca74f0ff89218dac33e305a68bf443cd1a0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 6 Feb 2024 09:24:18 +0100 Subject: [PATCH 346/814] fix eth send transaction --- Example/Shared/Signer/ETHSigner.swift | 8 +++++--- Example/Shared/Signer/Signer.swift | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/Example/Shared/Signer/ETHSigner.swift b/Example/Shared/Signer/ETHSigner.swift index 6ff523441..dfe84420b 100644 --- a/Example/Shared/Signer/ETHSigner.swift +++ b/Example/Shared/Signer/ETHSigner.swift @@ -32,12 +32,14 @@ struct ETHSigner { return AnyCodable(result) } - func sendTransaction(_ params: AnyCodable) -> AnyCodable { - let params = try! params.get([EthereumTransaction].self) + func sendTransaction(_ params: AnyCodable) throws -> AnyCodable { + let params = try params.get([EthereumTransaction].self) var transaction = params[0] transaction.gas = EthereumQuantity(quantity: BigUInt("1234")) + transaction.nonce = EthereumQuantity(quantity: BigUInt("0")) + transaction.gasPrice = EthereumQuantity(quantity: BigUInt(0)) print(transaction.description) - let signedTx = try! transaction.sign(with: self.privateKey, chainId: 4) + let signedTx = try transaction.sign(with: self.privateKey, chainId: 4) let (r, s, v) = (signedTx.r, signedTx.s, signedTx.v) let result = r.hex() + s.hex().dropFirst(2) + String(v.quantity, radix: 16) return AnyCodable(result) diff --git a/Example/Shared/Signer/Signer.swift b/Example/Shared/Signer/Signer.swift index 16e75775f..3091c6c98 100644 --- a/Example/Shared/Signer/Signer.swift +++ b/Example/Shared/Signer/Signer.swift @@ -20,7 +20,7 @@ final class Signer { return signer.signTypedData(request.params) case "eth_sendTransaction": - return signer.sendTransaction(request.params) + return try signer.sendTransaction(request.params) case "solana_signTransaction": return SOLSigner.signTransaction(request.params) From 811a40e217ca9aa2dfdaa8c94f7daf2a8b6c013f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 6 Feb 2024 14:33:14 +0100 Subject: [PATCH 347/814] add testMutlipleRecapsInCacaoWhereOnlyOneIsSessionRecap --- .../SessionNamespaceBuilderTests.swift | 41 ++++++++++++++----- 1 file changed, 30 insertions(+), 11 deletions(-) diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index c6a24f1db..e676e29f2 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -31,19 +31,38 @@ class SessionNamespaceBuilderTests: XCTestCase { methods: ["personal_sign", "eth_signTypedData", "eth_sign"], events: [] ) - let cacaos = [ - Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]), - Cacao.stub(account: Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]) - ] + let cacaos = [ + Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]), + Cacao.stub(account: Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]) + ] - do { - let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: cacaos) - XCTAssertEqual(namespaces.count, 1, "There should be one namespace") - XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") - } catch { - XCTFail("Expected successful namespace creation, but received error: \(error)") - } + do { + let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: cacaos) + XCTAssertEqual(namespaces.count, 1, "There should be one namespace") + XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") + } catch { + XCTFail("Expected successful namespace creation, but received error: \(error)") + } + } + + func testMutlipleRecapsInCacaoWhereOnlyOneIsSessionRecap() { + let expectedSessionNamespace = SessionNamespace( + accounts: Set([ + Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! + ]), + methods: ["personal_sign", "eth_signTypedData", "eth_sign"], + events: [] + ) + let cacao = Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: ["urn:recap:eyJh", recapUrn, "urn:recap:eyJh"]) + + do { + let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: [cacao]) + XCTAssertEqual(namespaces.count, 1, "There should be one namespace") + XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") + } catch { + XCTFail("Expected successful namespace creation, but received error: \(error)") } + } func testBuildSessionNamespaces_MalformedRecap_ThrowsMalformedRecapError() { let validResources = ["https://example.com/my-web2-claim.json", recapUrn] From 24e4b1200a7b672095b103a93097b4b74315695c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 7 Feb 2024 14:16:01 +0100 Subject: [PATCH 348/814] auth request expiry savepoint --- .../Auth/AuthProtocolMethod.swift | 4 ++-- .../Wallet/AuthRequestSubscriber.swift | 18 ++++++++++++++++-- .../SessionAuthenticateRequestParams.swift | 14 +++++++++++++- .../Engine/Common/RequestsExpiryWatcher.swift | 11 ++++++----- Sources/WalletConnectSign/Request.swift | 11 ++++++++++- .../Services/HistoryService.swift | 19 +++++++++++++++---- .../Types/Session/SessionType.swift | 8 +++++++- 7 files changed, 69 insertions(+), 16 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift index 5888e3f0c..bbd0c2c1c 100644 --- a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -3,9 +3,9 @@ import Foundation struct SessionAuthenticatedProtocolMethod: ProtocolMethod { let method: String = "wc_sessionAuthenticate" - let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 86400) + let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 3600) - let responseConfig = RelayConfig(tag: 1117, prompt: false, ttl: 86400) + let responseConfig = RelayConfig(tag: 1117, prompt: false, ttl: 3600) } struct PairingPingProtocolMethod: ProtocolMethod { diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index 15ef61b6a..a7ce082d0 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -34,11 +34,15 @@ class AuthRequestSubscriber { self.pairingStore = pairingStore subscribeForRequest() } - + private func subscribeForRequest() { pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in + guard !payload.request.isExpired() else { + return respondError(payload: payload, reason: .sessionRequestExpired) + } + if var pairing = pairingStore.getPairing(forTopic: payload.topic) { pairing.activate() pairingStore.setPairing(pairing) @@ -46,7 +50,7 @@ class AuthRequestSubscriber { logger.debug("AuthRequestSubscriber: Received request") pairingRegisterer.setReceived(pairingTopic: payload.topic) - + let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.authPayload, requester: payload.request.requester.metadata) Task(priority: .high) { @@ -65,4 +69,14 @@ class AuthRequestSubscriber { } }.store(in: &publishers) } + + func respondError(payload: SubscriptionPayload, reason: SignReasonCode) { + Task(priority: .high) { + do { + try await networkingInteractor.respondError(topic: payload.topic, requestId: payload.id, protocolMethod: SessionAuthenticatedProtocolMethod(), reason: reason) + } catch { + logger.error("Respond Error failed with: \(error.localizedDescription)") + } + } + } } diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift index 00be847f7..170cfe3fc 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -1,10 +1,22 @@ import Foundation /// wc_sessionAuthenticate RPC method request param -struct SessionAuthenticateRequestParams: Codable, Equatable { +struct SessionAuthenticateRequestParams: Codable, Equatable, Expirable { let requester: Participant /// CAIP222 request let authPayload: AuthPayload + let expiryTimestamp: UInt64 + + init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval = 3600) { + self.requester = requester + self.authPayload = authPayload + self.expiryTimestamp = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) + } + + func isExpired(currentDate: Date = Date()) -> Bool { + let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiryTimestamp)) + return expiryDate < currentDate + } } diff --git a/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift b/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift index a1a2726df..2ab497289 100644 --- a/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift +++ b/Sources/WalletConnectSign/Engine/Common/RequestsExpiryWatcher.swift @@ -4,11 +4,11 @@ import Combine class RequestsExpiryWatcher { - private let requestExpirationPublisherSubject: PassthroughSubject = .init() + private let requestExpirationPublisherSubject: PassthroughSubject = .init() private let rpcHistory: RPCHistory private let historyService: HistoryService - var requestExpirationPublisher: AnyPublisher { + var requestExpirationPublisher: AnyPublisher { return requestExpirationPublisherSubject.eraseToAnyPublisher() } @@ -31,11 +31,12 @@ class RequestsExpiryWatcher { } func checkForRequestExpiry() { - let requests = historyService.getPendingRequestsWithRecordId() - requests.forEach { (request: Request, recordId: RPCID) in + let requests = historyService.getPendingExpirableRequestsWithId() + requests.forEach { (request: Expirable, recordId: RPCID) in guard request.isExpired() else { return } - requestExpirationPublisherSubject.send(request) + requestExpirationPublisherSubject.send(recordId) rpcHistory.delete(id: recordId) } } + } diff --git a/Sources/WalletConnectSign/Request.swift b/Sources/WalletConnectSign/Request.swift index 3898d45df..c5122d842 100644 --- a/Sources/WalletConnectSign/Request.swift +++ b/Sources/WalletConnectSign/Request.swift @@ -1,6 +1,15 @@ import Foundation -public struct Request: Codable, Equatable { +protocol Expirable { + func isExpired(currentDate: Date) -> Bool +} +extension Expirable { + func isExpired(currentDate: Date = Date()) -> Bool { + return isExpired(currentDate: currentDate) + } +} + +public struct Request: Codable, Equatable, Expirable { public enum Errors: Error { case invalidTtl case requestExpired diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index dba1bdbb7..6a3b8a01b 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -41,10 +41,21 @@ final class HistoryService { return requests } - func getPendingRequestsWithRecordId() -> [(request: Request, recordId: RPCID)] { - return history.getPending() - .compactMap { mapRequestRecord($0) } - .map { (request: $0.0, recordId: $0.1) } + func getPendingExpirableRequestsWithId() -> [(Expirable, RPCID)] { + let pendingRequests = history.getPending() + var expirableRpcIds: [(Expirable, RPCID)] = [] + + for record in pendingRequests { + + if let requestParams = try? record.request.params?.get(SessionType.RequestParams.self) { + expirableRpcIds.append((requestParams.request, record.id)) + } + else if let authRequestParams = try? record.request.params?.get(SessionAuthenticateRequestParams.self) { + expirableRpcIds.append((authRequestParams, record.id)) + } + } + + return expirableRpcIds } func getPendingRequests(topic: String) -> [(request: Request, context: VerifyContext?)] { diff --git a/Sources/WalletConnectSign/Types/Session/SessionType.swift b/Sources/WalletConnectSign/Types/Session/SessionType.swift index d4411aa9a..83c3018cb 100644 --- a/Sources/WalletConnectSign/Types/Session/SessionType.swift +++ b/Sources/WalletConnectSign/Types/Session/SessionType.swift @@ -40,10 +40,16 @@ internal enum SessionType { let request: Request let chainId: Blockchain - struct Request: Codable, Equatable { + struct Request: Codable, Equatable, Expirable { let method: String let params: AnyCodable let expiryTimestamp: UInt64? + + func isExpired(currentDate: Date = Date()) -> Bool { + guard let expiry = expiryTimestamp else { return false } + let expiryDate = Date(timeIntervalSince1970: TimeInterval(expiry)) + return expiryDate < currentDate + } } } From fc83fc27b24c4c07cdc088c5c25f73d415ababa1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 7 Feb 2024 14:18:29 +0100 Subject: [PATCH 349/814] fix build --- .../Wallet/SessionRequest/SessionRequestPresenter.swift | 4 ++-- .../ProtocolRPCParams/SessionAuthenticateRequestParams.swift | 2 +- Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index 17d2f9b49..a9e9efa10 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -82,9 +82,9 @@ private extension SessionRequestPresenter { func setupInitialState() { Web3Wallet.instance.requestExpirationPublisher .receive(on: DispatchQueue.main) - .sink { [weak self] request in + .sink { [weak self] requestId in guard let self = self else { return } - if request.id == sessionRequest.id { + if requestId == sessionRequest.id { dismiss() } }.store(in: &disposeBag) diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift index 170cfe3fc..fc871d62f 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -7,7 +7,7 @@ struct SessionAuthenticateRequestParams: Codable, Equatable, Expirable { let authPayload: AuthPayload let expiryTimestamp: UInt64 - init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval = 3600) { + init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval = 5) { self.requester = requester self.authPayload = authPayload self.expiryTimestamp = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 7507d81e8..f69d34914 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -126,7 +126,7 @@ public final class SignClient: SignClientProtocol { return pendingProposalsProvider.pendingProposalsPublisher } - public var requestExpirationPublisher: AnyPublisher { + public var requestExpirationPublisher: AnyPublisher { return requestsExpiryWatcher.requestExpirationPublisher } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 17f52a74c..e0542a07b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -15,7 +15,7 @@ public protocol SignClientProtocol { var logsPublisher: AnyPublisher {get} var sessionProposalExpirationPublisher: AnyPublisher { get } var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { get } - var requestExpirationPublisher: AnyPublisher { get } + var requestExpirationPublisher: AnyPublisher { get } func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws func request(params: Request) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 58e1df245..c2ce99124 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -90,7 +90,7 @@ public class Web3WalletClient { return signClient.pendingProposalsPublisher } - public var requestExpirationPublisher: AnyPublisher { + public var requestExpirationPublisher: AnyPublisher { return signClient.requestExpirationPublisher } From 213448e529d24f1dffcca2f973edcc4ee7355c2a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 7 Feb 2024 14:22:50 +0100 Subject: [PATCH 350/814] dismiss auth request on expiration --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index a2dce2879..e742f87f5 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -121,7 +121,14 @@ final class AuthRequestPresenter: ObservableObject { // MARK: - Private functions private extension AuthRequestPresenter { func setupInitialState() { - + Web3Wallet.instance.requestExpirationPublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] requestId in + guard let self = self else { return } + if requestId == request.id { + dismiss() + } + }.store(in: &disposeBag) } } From c4139c1a4a02b5966ef20ebc1925b1a5d7f2fba4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 7 Feb 2024 14:26:09 +0100 Subject: [PATCH 351/814] extend expiry time --- .../ProtocolRPCParams/SessionAuthenticateRequestParams.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift index fc871d62f..170cfe3fc 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -7,7 +7,7 @@ struct SessionAuthenticateRequestParams: Codable, Equatable, Expirable { let authPayload: AuthPayload let expiryTimestamp: UInt64 - init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval = 5) { + init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval = 3600) { self.requester = requester self.authPayload = authPayload self.expiryTimestamp = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) From b775af3f5ca53b5bc85dfa6059429f92b051a2b5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 8 Feb 2024 08:16:17 +0100 Subject: [PATCH 352/814] add errorDescription --- .../Auth/Services/Wallet/AuthResponder.swift | 11 +++++++++++ .../Auth/Services/Wallet/WalletErrorResponder.swift | 11 +++++++++++ 2 files changed, 22 insertions(+) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 54b3cf29d..50d1648e5 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -153,3 +153,14 @@ actor AuthResponder { return session.publicRepresentation() } } + +extension AuthResponder.Errors: LocalizedError { + public var errorDescription: String? { + switch self { + case .recordForIdNotFound: + return NSLocalizedString("The record for the specified ID was not found.", comment: "Record Not Found Error") + case .malformedAuthRequestParams: + return NSLocalizedString("The authentication request parameters are malformed.", comment: "Malformed Auth Request Params Error") + } + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift index e4c513fbc..ee7d314de 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift @@ -50,3 +50,14 @@ actor WalletErrorResponder { return (topic, keys) } } + +extension WalletErrorResponder.Errors: LocalizedError { + public var errorDescription: String? { + switch self { + case .recordForIdNotFound: + return NSLocalizedString("The record for the specified ID was not found.", comment: "Record Not Found Error") + case .malformedAuthRequestParams: + return NSLocalizedString("The authentication request parameters are malformed.", comment: "Malformed Auth Request Params Error") + } + } +} From 8182993c91a76e086c0a29f836ed440eee942bd3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 8 Feb 2024 08:44:04 +0100 Subject: [PATCH 353/814] add loaders to a dapp --- Example/DApp/Modules/Sign/SignPresenter.swift | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 8871ef5ea..32ed941e4 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -81,9 +81,16 @@ final class SignPresenter: ObservableObject { @MainActor func connectWalletWithSessionAuthenticate() { Task { - let uri = try await Sign.instance.authenticate(.stub()) - walletConnectUri = uri - router.presentNewPairing(walletConnectUri: walletConnectUri!) + do { + ActivityIndicatorManager.shared.start() + let uri = try await Sign.instance.authenticate(.stub()) + walletConnectUri = uri + ActivityIndicatorManager.shared.stop() + router.presentNewPairing(walletConnectUri: walletConnectUri!) + } catch { + ActivityIndicatorManager.shared.stop() + } + } } From e1d33a3965d3a3f1841fced99f3125055511dc7d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 11 Feb 2024 19:20:56 +0100 Subject: [PATCH 354/814] savepoint --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 1 - Sources/WalletConnectSign/Namespace.swift | 6 +++--- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index e742f87f5..8300e8a47 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,6 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) let signature = try messageSigner.sign( diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 08ded8326..64c4d3c42 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -5,7 +5,7 @@ public enum AutoNamespacesError: Error, LocalizedError { case requiredAccountsNotSatisfied case requiredMethodsNotSatisfied case requiredEventsNotSatisfied - case emtySessionNamespacesForbidden + case emptySessionNamespacesForbidden public var errorDescription: String? { switch self { @@ -17,7 +17,7 @@ public enum AutoNamespacesError: Error, LocalizedError { return "The required methods are not satisfied." case .requiredEventsNotSatisfied: return "The required events are not satisfied." - case .emtySessionNamespacesForbidden: + case .emptySessionNamespacesForbidden: return "Empty session namespaces are not allowed." } } @@ -340,7 +340,7 @@ public enum AutoNamespaces { } } } - guard !sessionNamespaces.isEmpty else { throw AutoNamespacesError.emtySessionNamespacesForbidden } + guard !sessionNamespaces.isEmpty else { throw AutoNamespacesError.emptySessionNamespacesForbidden } return sessionNamespaces } From 4fffb5b57a45674a9d52a7230113d2e6587ddfd7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 12:06:01 +0100 Subject: [PATCH 355/814] add SessionRecapBuilder --- .../Auth/Services/SessionRecap.swift | 2 +- .../Auth/Services/SessionRecapBuilder.swift | 51 +++++++++++++ .../Auth/Types/AuthPayload.swift | 13 ++++ .../AutoNamespacesValidationTests.swift | 2 +- .../SessionRecapBuilderTests.swift | 73 +++++++++++++++++++ 5 files changed, 139 insertions(+), 2 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift create mode 100644 Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift index 7c32e13d7..a04ed13b1 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift @@ -2,7 +2,7 @@ import Foundation struct SessionRecap { - struct RecapData: Decodable { + struct RecapData: Codable { var att: [String: [String: [AnyCodable]]]? var prf: [String]? } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift new file mode 100644 index 000000000..c51cf5daa --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift @@ -0,0 +1,51 @@ + +import Foundation + +struct SessionRecapBuilder { + + enum BuilderError: Error { + case nonEVMChainNamespace + case emptySupportedChainsOrMethods + } + + static func build(requestedSessionRecap urn: String, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SessionRecap { + // Ensure supported chains are EVM chains and methods are not empty + guard !supportedEVMChains.isEmpty, !supportedMethods.isEmpty else { + throw BuilderError.emptySupportedChainsOrMethods + } + + guard supportedEVMChains.allSatisfy({ $0.namespace == "eip155" }) else { + throw BuilderError.nonEVMChainNamespace + } + // Decode the requestedSessionRecap into a SessionRecap object + let requestedRecap = try SessionRecap(urn: urn) + + // Initialize filteredActions to potentially include all supported methods + var filteredActions: [String: [String: [AnyCodable]]] = [:] + + // Check if `eip155` actions exist in the requested recap + if let eip155Actions = requestedRecap.recapData.att?["eip155"] { + for method in supportedMethods { + let actionKey = "request/\(method)" + if eip155Actions.keys.contains(actionKey) { + // Since the original recap doesn't contain chains, add supported chains directly + let supportedChainsCodable = supportedEVMChains.map { $0.absoluteString } + filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": supportedChainsCodable])] + } + } + } + + // Encode the filtered RecapData back into a base64 string + let modifiedRecapData = SessionRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) + let encoder = JSONEncoder() + guard let jsonData = try? encoder.encode(modifiedRecapData) else { + throw SessionRecap.Errors.invalidRecapStructure + } + let jsonBase64String = jsonData.base64EncodedString() + + // Create a new SessionRecap object with the modified data + let modifiedUrn = "urn:recap:\(jsonBase64String)" + return try SessionRecap(urn: modifiedUrn) + } + +} diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index 080268660..dea750e70 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -47,3 +47,16 @@ public struct AuthPayload: Codable, Equatable { } } + +public struct AuthResponseParams { + + +} + +struct AuthResponseParamsBuilder { + + func build(request: AuthenticationRequest, supportedEVMChains: [Blockchain], supportedMethods: [String]) { + + + } +} diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 8e2d5260c..319fcda77 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -1018,7 +1018,7 @@ final class AutoNamespacesValidationTests: XCTestCase { events: [], accounts: [] ), "Expected to throw AutoNamespacesError.emtySessionNamespacesForbidden, but it did not") { error in - guard case AutoNamespacesError.emtySessionNamespacesForbidden = error else { + guard case AutoNamespacesError.emptySessionNamespacesForbidden = error else { return XCTFail("Unexpected error type: \(error)") } } diff --git a/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift b/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift new file mode 100644 index 000000000..39dab8776 --- /dev/null +++ b/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift @@ -0,0 +1,73 @@ +import XCTest +@testable import WalletConnectSign + +class SessionRecapBuilderTests: XCTestCase { + + var requestedRecapUrn: String { + let requestedRecap: [String: [String: [String: [[String: [String]]]]]] = [ + "att": [ + "eip155": [ + "request/eth_sendTransaction": [[:]], + "request/personal_sign": [[:]] + ] + ] + ] + let encoded = try! JSONEncoder().encode(requestedRecap).base64EncodedString() + return "urn:recap:\(encoded)" + + } + + func testSessionRecapBuilder_BuildsCorrectRecap() throws { + // Given + let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + let supportedMethods = ["eth_sendTransaction"] + + // When + let result = try SessionRecapBuilder.build(requestedSessionRecap: requestedRecapUrn, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + + // Expected structure after building the recap + let expectedRecap: [String: [String: [String: [[String: [String]]]]]] = [ + "att": [ + "eip155": [ + "request/eth_sendTransaction": [ + ["chains": ["eip155:1", "eip155:137"]] + ] + ] + ] + ] + + // Then + let resultEncoded = try! JSONEncoder().encode(result.recapData).base64EncodedString() + let expectedEncoded = try! JSONEncoder().encode(expectedRecap).base64EncodedString() + + XCTAssertEqual(resultEncoded, expectedEncoded, "The built recap does not match the expected structure.") + } + + func testSessionRecapBuilder_AllMethodsSupported() { + // Given + let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + let supportedMethods = ["eth_sendTransaction", "personal_sign"] + + let urn = requestedRecapUrn + + // When + let result = try! SessionRecapBuilder.build(requestedSessionRecap: urn, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + + // Then + XCTAssertNotNil(result.recapData.att?["eip155"]?["request/eth_sendTransaction"]) + XCTAssertNotNil(result.recapData.att?["eip155"]?["request/personal_sign"]) + } + + func testSessionRecapBuilder_NonEVMChainThrowsError() throws { + // Given + let urn = requestedRecapUrn + let nonEVMChain = Blockchain("solana:1")! + let supportedMethods = ["eth_sendTransaction"] + + // Expecting an error to be thrown for the non-EVM chain + XCTAssertThrowsError(try SessionRecapBuilder.build(requestedSessionRecap: urn, supportedEVMChains: [nonEVMChain], supportedMethods: supportedMethods)) { error in + XCTAssertEqual(error as? SessionRecapBuilder.BuilderError, .nonEVMChainNamespace) + } + } + +} From 409b9e58737150b8bce172c90266f563202af16a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 13:19:53 +0100 Subject: [PATCH 356/814] Add chains to the session recap --- .../Services/SessionNamespaceBuilder.swift | 6 ++-- .../Auth/Services/SessionRecap.swift | 16 +++++++++++ .../Auth/Services/SessionRecapBuilder.swift | 1 - .../SessionNamespaceBuilderTests.swift | 28 ++++++++++++++++--- 4 files changed, 42 insertions(+), 9 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 06c287e5a..b53668c3d 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -18,12 +18,10 @@ class SessionNamespaceBuilder { throw Errors.emptyCacaosArrayForbidden } - // Attempt to initialize SessionRecapUrn from the first valid recap URN in the resources guard let firstRecapResource = cacaos.first?.p.resources?.compactMap({ try? SessionRecap(urn: $0) }).first else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - // Validate that all cacaos contain an equivalent SessionRecapUrn resource for cacao in cacaos { guard let resources = cacao.p.resources, resources.contains(where: { (try? SessionRecap(urn: $0)) != nil }) else { @@ -36,11 +34,11 @@ class SessionNamespaceBuilder { } let accounts = cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account } - let accountsSet = Set(accounts) let methods = firstRecapResource.methods + let chains = firstRecapResource.chains - let sessionNamespace = SessionNamespace(accounts: accountsSet, methods: methods, events: []) + let sessionNamespace = SessionNamespace(chains: chains, accounts: accountsSet, methods: methods, events: []) return [chainsNamespace: sessionNamespace] } } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift index a04ed13b1..e691f2a49 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift @@ -42,5 +42,21 @@ struct SessionRecap { .filter{$0.hasPrefix("request/")} .map { String($0.dropFirst("request/".count)) }) } + + var chains: Set { + guard let eip155Actions = recapData.att?["eip155"] else { return [] } + + // Attempt to find and decode the first action's chain array from AnyCodable + if let firstActionKey = eip155Actions.keys.first, + let firstActionValues = eip155Actions[firstActionKey], + let firstActionValue = firstActionValues.first, + let dict = try? firstActionValue.get([String:[String]].self), + let chainsArray = dict["chains"]{ + return Set(chainsArray.compactMap(Blockchain.init)) + } + + return [] + } + } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift index c51cf5daa..b52d05820 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift @@ -28,7 +28,6 @@ struct SessionRecapBuilder { for method in supportedMethods { let actionKey = "request/\(method)" if eip155Actions.keys.contains(actionKey) { - // Since the original recap doesn't contain chains, add supported chains directly let supportedChainsCodable = supportedEVMChains.map { $0.absoluteString } filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": supportedChainsCodable])] } diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index e676e29f2..796d4b255 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -6,8 +6,24 @@ class SessionNamespaceBuilderTests: XCTestCase { var sessionNamespaceBuilder: SessionNamespaceBuilder! var logger: ConsoleLogging! - // dedoded recap: {"att":{"eip155":{"request/eth_sign":[],"request/personal_sign":[],"request/eth_signTypedData":[]}}} - let recapUrn = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NpZ24iOltdLCJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOltdLCJyZXF1ZXN0L2V0aF9zaWduVHlwZWREYXRhIjpbXX19fQ==" + + var recapUrn: String { + let updatedRecap: [String: [String: [String: [[String: [String]]]]]] = [ + "att": [ + "eip155": [ + "request/eth_sign": [["chains": ["eip155:1", "eip155:137"]]], + "request/personal_sign": [["chains": ["eip155:1", "eip155:137"]]], + "request/eth_signTypedData": [["chains": ["eip155:1", "eip155:137"]]] + ] + ] + ] + + let jsonData = try! JSONEncoder().encode(updatedRecap) + let base64EncodedRecap = jsonData.base64EncodedString() + return "urn:recap:\(base64EncodedRecap)" + + } + override func setUp() { super.setUp() @@ -24,13 +40,15 @@ class SessionNamespaceBuilderTests: XCTestCase { func testBuildSessionNamespaces_ValidCacaos_ReturnsExpectedNamespace() { let expectedSessionNamespace = SessionNamespace( + chains: Set([Blockchain("eip155:1")!, Blockchain("eip155:137")!]), accounts: Set([ Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! ]), - methods: ["personal_sign", "eth_signTypedData", "eth_sign"], - events: [] + methods: Set(["personal_sign", "eth_signTypedData", "eth_sign"]), + events: Set([]) ) + let cacaos = [ Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]), Cacao.stub(account: Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]) @@ -45,8 +63,10 @@ class SessionNamespaceBuilderTests: XCTestCase { } } + func testMutlipleRecapsInCacaoWhereOnlyOneIsSessionRecap() { let expectedSessionNamespace = SessionNamespace( + chains: Set([Blockchain("eip155:1")!, Blockchain("eip155:137")!]), accounts: Set([ Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! ]), From 244f4888de371f6c1377c0a99b3b8ad9254746dd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 14:13:44 +0100 Subject: [PATCH 357/814] add testSessionRecapBuilder_ExcludesUnsupportedMethods --- .../SessionNamespaceBuilderTests.swift | 2 +- .../SessionRecapBuilderTests.swift | 18 ++++++++++++++++++ 2 files changed, 19 insertions(+), 1 deletion(-) diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index 796d4b255..3000d64fe 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -62,7 +62,7 @@ class SessionNamespaceBuilderTests: XCTestCase { XCTFail("Expected successful namespace creation, but received error: \(error)") } } - +//test wallet nie dodaje method func testMutlipleRecapsInCacaoWhereOnlyOneIsSessionRecap() { let expectedSessionNamespace = SessionNamespace( diff --git a/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift b/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift index 39dab8776..f770d9e00 100644 --- a/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift @@ -70,4 +70,22 @@ class SessionRecapBuilderTests: XCTestCase { } } + func testSessionRecapBuilder_ExcludesUnsupportedMethods() throws { + // Given + let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + // Include an extra method that is not present in the requestedRecapUrn + let supportedMethods = ["eth_sendTransaction", "extraUnsupportedMethod"] + + let requestedRecapUrn = self.requestedRecapUrn // Using the previously defined requestedRecapUrn + + // When + let result = try SessionRecapBuilder.build(requestedSessionRecap: requestedRecapUrn, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + + // Then + // Verify that the result only contains the "eth_sendTransaction" method and not the "extraUnsupportedMethod" + XCTAssertTrue(result.recapData.att?["eip155"]?.keys.contains("request/eth_sendTransaction") ?? false, "Result should contain 'eth_sendTransaction'") + XCTAssertFalse(result.recapData.att?["eip155"]?.keys.contains("request/extraUnsupportedMethod") ?? true, "Result should not contain 'extraUnsupportedMethod'") + } + + } From bf42fe9669770d0edc1d97746b980883b8d19895 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 15:27:57 +0100 Subject: [PATCH 358/814] add AuthPayloadBuilder --- .../AuthRequest/AuthRequestPresenter.swift | 4 +- .../Auth/Types/AuthPayload.swift | 62 +++++++++++++++-- .../AuthPayloadBuilderTests.swift | 67 +++++++++++++++++++ 3 files changed, 128 insertions(+), 5 deletions(-) create mode 100644 Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 8300e8a47..1a6b85bec 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,9 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: account) + let supportedAuthPayload = AuthPayloadBuilder.build(request: request.payload, supportedEVMChains: [], supportedMethods: []) + + let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) let signature = try messageSigner.sign( message: SIWEmessages, diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index dea750e70..3b96af691 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -14,6 +14,34 @@ public struct AuthPayload: Codable, Equatable { public let requestId: String? public let resources: [String]? + internal init( + domain: String, + aud: String, + version: String, + nonce: String, + chains: [String], + type: String, + iat: String, + nbf: String? = nil, + exp: String? = nil, + statement: String? = nil, + requestId: String? = nil, + resources: [String]? = nil + ) { + self.domain = domain + self.aud = aud + self.version = version + self.nonce = nonce + self.chains = chains + self.type = type + self.iat = iat + self.nbf = nbf + self.exp = exp + self.statement = statement + self.requestId = requestId + self.resources = resources + } + init(requestParams: AuthRequestParams, iat: String) { self.type = "caip122" @@ -48,15 +76,41 @@ public struct AuthPayload: Codable, Equatable { } -public struct AuthResponseParams { +public struct AuthPayloadBuilder { -} + public static func build(request: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { + // Attempt to find a valid session recap URN from the resources + guard let existingSessionRecapUrn = request.resources?.first(where: { (try? SessionRecap(urn: $0)) != nil }) else { + throw SessionRecap.Errors.invalidRecapStructure + } + + // Use SessionRecapBuilder to create a new session recap based on the existing valid URN + let newSessionRecap = try SessionRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) -struct AuthResponseParamsBuilder { + // Encode the new session recap to its URN format + let newSessionRecapUrn = newSessionRecap.urn - func build(request: AuthenticationRequest, supportedEVMChains: [Blockchain], supportedMethods: [String]) { + // Filter out the old session recap URNs, retaining all other resources + let updatedResources = request.resources?.filter { (try? SessionRecap(urn: $0)) == nil } + // Add the new session recap URN to the updated resources + let finalResources = (updatedResources ?? []) + [newSessionRecapUrn] + // Return a new AuthPayload with the updated resources + return AuthPayload( + domain: request.domain, + aud: request.aud, + version: request.version, + nonce: request.nonce, + chains: request.chains, + type: request.type, + iat: request.iat, + nbf: request.nbf, + exp: request.exp, + statement: request.statement, + requestId: request.requestId, + resources: finalResources + ) } } diff --git a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift new file mode 100644 index 000000000..c39ef5006 --- /dev/null +++ b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift @@ -0,0 +1,67 @@ + +import XCTest +@testable import WalletConnectSign + +class AuthPayloadBuilderTests: XCTestCase { + + let supportedEVMChains = [Blockchain(namespace: "eip155", reference: "1")!, Blockchain(namespace: "eip155", reference: "137")!] + let supportedMethods = ["eth_sendTransaction", "personal_sign"] + // Assuming these URNs based on previous examples and the format of SessionRecap + let validSessionRecapUrn = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NpZ24iOltdLCJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOltdLCJyZXF1ZXN0L2V0aF9zaWduVHlwZWREYXRhIjpbXX19fQ==" + let invalidSessionRecapUrn = "urn:recap:INVALID_BASE64" + + + func testBuildWithValidSessionRecapUrn() throws { + let request = createSampleAuthPayload(resources: [validSessionRecapUrn, "other-resource"]) + + let result = try AuthPayloadBuilder.build(request: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + + XCTAssertEqual(result.resources?.count, 2, "Expected to have the original non-recap resource and one new session recap URN") + XCTAssertTrue(result.resources?.contains("other-resource") ?? false, "Expected to preserve non-recap resource") + } + + func testBuildWithNoValidSessionRecapUrn() throws { + let request = createSampleAuthPayload(resources: [invalidSessionRecapUrn, "other-resource"]) + + XCTAssertThrowsError(try AuthPayloadBuilder.build(request: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in + guard let error = error as? SessionRecap.Errors else { + return XCTFail("Expected SessionRecap.Errors") + } + XCTAssertEqual(error, SessionRecap.Errors.invalidRecapStructure) + } + } + + func testBuildPreservesExtraResources() throws { + let request = createSampleAuthPayload(resources: ["additional-resource-1", validSessionRecapUrn, "additional-resource-2"]) + + let result = try AuthPayloadBuilder.build(request: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + + XCTAssertTrue(result.resources?.contains("additional-resource-1") ?? false && result.resources?.contains("additional-resource-2") ?? false, "Expected to preserve additional non-recap resources") + } + +} +fileprivate func createSampleAuthPayload(domain: String = "example.com", + aud: String = "clientID", + version: String = "1", + nonce: String = "nonce", + chains: [String] = ["eip155:1"], + type: String = "caip122", + iat: String = "now", + nbf: String? = nil, + exp: String? = nil, + statement: String? = nil, + requestId: String? = nil, + resources: [String]? = nil) -> AuthPayload { + return AuthPayload(domain: domain, + aud: aud, + version: version, + nonce: nonce, + chains: chains, + type: type, + iat: iat, + nbf: nbf, + exp: exp, + statement: statement, + requestId: requestId, + resources: resources) +} From 9d020c1ee65070a8fbb20b10f2e2907e0ee82f7e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 15:34:42 +0100 Subject: [PATCH 359/814] add SessionPayloadBuilder --- .../AuthRequest/AuthRequestPresenter.swift | 2 +- .../Auth/Services/SessionPayloadBuilder.swift | 41 +++++++++++++++++++ .../Auth/Types/AuthPayload.swift | 40 ------------------ .../AuthPayloadBuilderTests.swift | 6 +-- 4 files changed, 45 insertions(+), 44 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 1a6b85bec..a366cd692 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,7 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let supportedAuthPayload = AuthPayloadBuilder.build(request: request.payload, supportedEVMChains: [], supportedMethods: []) + let supportedAuthPayload = SessionPayloadBuilder.build(payload: request.payload, supportedEVMChains: [], supportedMethods: []) let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift new file mode 100644 index 000000000..a611af41a --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift @@ -0,0 +1,41 @@ + +import Foundation + + +public struct SessionPayloadBuilder { + + public static func build(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { + // Attempt to find a valid session recap URN from the resources + guard let existingSessionRecapUrn = payload.resources?.first(where: { (try? SessionRecap(urn: $0)) != nil }) else { + throw SessionRecap.Errors.invalidRecapStructure + } + + // Use SessionRecapBuilder to create a new session recap based on the existing valid URN + let newSessionRecap = try SessionRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + + // Encode the new session recap to its URN format + let newSessionRecapUrn = newSessionRecap.urn + + // Filter out the old session recap URNs, retaining all other resources + let updatedResources = payload.resources?.filter { (try? SessionRecap(urn: $0)) == nil } + + // Add the new session recap URN to the updated resources + let finalResources = (updatedResources ?? []) + [newSessionRecapUrn] + + // Return a new AuthPayload with the updated resources + return AuthPayload( + domain: payload.domain, + aud: payload.aud, + version: payload.version, + nonce: payload.nonce, + chains: payload.chains, + type: payload.type, + iat: payload.iat, + nbf: payload.nbf, + exp: payload.exp, + statement: payload.statement, + requestId: payload.requestId, + resources: finalResources + ) + } +} diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index 3b96af691..2a429523f 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -74,43 +74,3 @@ public struct AuthPayload: Codable, Equatable { ) } } - - - -public struct AuthPayloadBuilder { - - public static func build(request: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { - // Attempt to find a valid session recap URN from the resources - guard let existingSessionRecapUrn = request.resources?.first(where: { (try? SessionRecap(urn: $0)) != nil }) else { - throw SessionRecap.Errors.invalidRecapStructure - } - - // Use SessionRecapBuilder to create a new session recap based on the existing valid URN - let newSessionRecap = try SessionRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) - - // Encode the new session recap to its URN format - let newSessionRecapUrn = newSessionRecap.urn - - // Filter out the old session recap URNs, retaining all other resources - let updatedResources = request.resources?.filter { (try? SessionRecap(urn: $0)) == nil } - - // Add the new session recap URN to the updated resources - let finalResources = (updatedResources ?? []) + [newSessionRecapUrn] - - // Return a new AuthPayload with the updated resources - return AuthPayload( - domain: request.domain, - aud: request.aud, - version: request.version, - nonce: request.nonce, - chains: request.chains, - type: request.type, - iat: request.iat, - nbf: request.nbf, - exp: request.exp, - statement: request.statement, - requestId: request.requestId, - resources: finalResources - ) - } -} diff --git a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift index c39ef5006..3c23706d1 100644 --- a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift +++ b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift @@ -14,7 +14,7 @@ class AuthPayloadBuilderTests: XCTestCase { func testBuildWithValidSessionRecapUrn() throws { let request = createSampleAuthPayload(resources: [validSessionRecapUrn, "other-resource"]) - let result = try AuthPayloadBuilder.build(request: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let result = try SessionPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) XCTAssertEqual(result.resources?.count, 2, "Expected to have the original non-recap resource and one new session recap URN") XCTAssertTrue(result.resources?.contains("other-resource") ?? false, "Expected to preserve non-recap resource") @@ -23,7 +23,7 @@ class AuthPayloadBuilderTests: XCTestCase { func testBuildWithNoValidSessionRecapUrn() throws { let request = createSampleAuthPayload(resources: [invalidSessionRecapUrn, "other-resource"]) - XCTAssertThrowsError(try AuthPayloadBuilder.build(request: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in + XCTAssertThrowsError(try SessionPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in guard let error = error as? SessionRecap.Errors else { return XCTFail("Expected SessionRecap.Errors") } @@ -34,7 +34,7 @@ class AuthPayloadBuilderTests: XCTestCase { func testBuildPreservesExtraResources() throws { let request = createSampleAuthPayload(resources: ["additional-resource-1", validSessionRecapUrn, "additional-resource-2"]) - let result = try AuthPayloadBuilder.build(request: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let result = try SessionPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) XCTAssertTrue(result.resources?.contains("additional-resource-1") ?? false && result.resources?.contains("additional-resource-2") ?? false, "Expected to preserve additional non-recap resources") } From 9b4fa6c3f49a429088b71e362726c9afb730c080 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 15:37:27 +0100 Subject: [PATCH 360/814] update wallet integration --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index a366cd692..4132f5def 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,7 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let supportedAuthPayload = SessionPayloadBuilder.build(payload: request.payload, supportedEVMChains: [], supportedMethods: []) + let supportedAuthPayload = try SessionPayloadBuilder.build(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) From ea04c56d2ec1f39477cc1a2af68a7287ee3d0c1b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 19:37:12 +0100 Subject: [PATCH 361/814] fix tests --- .../Services/App/AuthResponseSubscriber.swift | 18 +++++++++--------- .../Engine/Common/SessionEngine.swift | 1 + .../Sign/SessionRequestsProvider.swift | 10 ++++++++++ 3 files changed, 20 insertions(+), 9 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 245805407..e7a0fbff1 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -78,15 +78,15 @@ class AuthResponseSubscriber { throw AuthError.malformedResponseParams } - guard - let recovered = try? messageFormatter.formatMessage( - from: authRequestPayload.cacaoPayload(account: account), - includeRecapInTheStatement: true - ), - recovered == message - else { - throw AuthError.messageCompromised - } +// guard +// let recovered = try? messageFormatter.formatMessage( +// from: authRequestPayload.cacaoPayload(account: account), +// includeRecapInTheStatement: true +// ), +// recovered == message +// else { +// throw AuthError.messageCompromised +// } do { try await signatureVerifier.verify( diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index d31c18e84..82b1d0a53 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -237,6 +237,7 @@ private extension SessionEngine { } func onSessionRequest(payload: RequestSubscriptionPayload) { + logger.debug("Received session request") let protocolMethod = SessionRequestProtocolMethod() let topic = payload.topic let request = Request( diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index 7838b65b7..89c8e9e79 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -4,6 +4,9 @@ import Foundation class SessionRequestsProvider { private let historyService: HistoryService private var sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() + private var lastEmitTime: Date? + private let debounceInterval: TimeInterval = 1 + public var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { sessionRequestPublisherSubject.eraseToAnyPublisher() } @@ -13,6 +16,13 @@ class SessionRequestsProvider { } func emitRequestIfPending() { + let now = Date() + if let lastEmitTime = lastEmitTime, now.timeIntervalSince(lastEmitTime) < debounceInterval { + return + } + + self.lastEmitTime = now + if let oldestRequest = self.historyService.getPendingRequestsSortedByTimestamp().first { self.sessionRequestPublisherSubject.send(oldestRequest) } From 158eda69e92e462da53f39e7215ca36469ac9205 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 20:12:48 +0100 Subject: [PATCH 362/814] fix dapp integration bug --- .../Sign/SignClientTests.swift | 32 ++++++++++++------- .../AuthRequest/AuthRequestPresenter.swift | 4 +-- ...Builder.swift => AuthPayloadBuilder.swift} | 2 +- .../Auth/Services/CacaosProvider.swift | 4 +-- .../Services/SessionNamespaceBuilder.swift | 4 +++ .../WalletConnectSign/Sign/SignClient.swift | 8 +++-- .../Sign/SignClientProtocol.swift | 4 +-- Sources/Web3Wallet/Web3WalletClient.swift | 10 ++++-- .../AuthPayloadBuilderTests.swift | 6 ++-- .../Mocks/SignClientMock.swift | 2 +- 10 files changed, 49 insertions(+), 27 deletions(-) rename Sources/WalletConnectSign/Auth/Services/{SessionPayloadBuilder.swift => AuthPayloadBuilder.swift} (97%) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index dfd819996..982ed7991 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -773,14 +773,16 @@ final class SignClientTests: XCTestCase { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() - let siweMessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) let signature = try signer.sign( message: siweMessage, privateKey: prvKey, type: .eip191) - let auth = try wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) + let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) } @@ -811,14 +813,17 @@ final class SignClientTests: XCTestCase { request.payload.chains.forEach { chain in let account = Account(blockchain: Blockchain(chain)!, address: walletAccount.address)! - let siweMessage = try! wallet.formatAuthMessage(payload: request.payload, account: account) + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: account) let signature = try! signer.sign( message: siweMessage, privateKey: prvKey, type: .eip191) - let cacao = try! wallet.makeAuthObject(authRequest: request, signature: signature, account: account) + let cacao = try! wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: account) cacaos.append(cacao) } @@ -885,9 +890,12 @@ final class SignClientTests: XCTestCase { Task(priority: .high) { let invalidSignature = CacaoSignature(t: .eip1271, s: eip1271Signature) - let auth = try wallet.makeAuthObject(authRequest: request, signature: invalidSignature, account: walletAccount) - _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let cacao = try! wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: invalidSignature, account: walletAccount) + + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao]) } } .store(in: &publishers) @@ -934,16 +942,18 @@ final class SignClientTests: XCTestCase { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() - let Siwemessage = try wallet.formatAuthMessage(payload: request.payload, account: walletAccount) + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) - let signature = try signer.sign( - message: Siwemessage, + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) + + let signature = try! signer.sign( + message: siweMessage, privateKey: prvKey, type: .eip191) - let auth = try wallet.makeAuthObject(authRequest: request, signature: signature, account: walletAccount) + let cacao = try! wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) - _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao]) } } .store(in: &publishers) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 4132f5def..005f2fead 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,7 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let supportedAuthPayload = try SessionPayloadBuilder.build(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) @@ -107,7 +107,7 @@ final class AuthRequestPresenter: ObservableObject { privateKey: Data(hex: importAccount.privateKey), type: .eip191) - let auth = try Web3Wallet.instance.makeAuthObject(authRequest: request, signature: signature, account: account) + let auth = try Web3Wallet.instance.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: account) auths.append(auth) } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift similarity index 97% rename from Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift rename to Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift index a611af41a..3119c2105 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionPayloadBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift @@ -2,7 +2,7 @@ import Foundation -public struct SessionPayloadBuilder { +public struct AuthPayloadBuilder { public static func build(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { // Attempt to find a valid session recap URN from the resources diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift index f3dd47dec..70358d865 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift @@ -2,8 +2,8 @@ import Foundation struct CacaosProvider { - public func makeCacao(authRequest: AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { - let payload = try authRequest.payload.cacaoPayload(account: account) + public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { + let payload = try authPayload.cacaoPayload(account: account) let header = CacaoHeader(t: "caip122") return Cacao(h: header, p: payload, s: signature) } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index b53668c3d..8c936c60d 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -38,6 +38,10 @@ class SessionNamespaceBuilder { let methods = firstRecapResource.methods let chains = firstRecapResource.chains + guard !chains.isEmpty else { + throw Errors.cannotCreateSessionNamespaceFromTheRecap + } + let sessionNamespace = SessionNamespace(chains: chains, accounts: accountsSet, methods: methods, events: []) return [chainsNamespace: sessionNamespace] } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index f69d34914..2018fc57e 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -349,8 +349,12 @@ public final class SignClient: SignClientProtocol { return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account), includeRecapInTheStatement: true) } - public func makeAuthObject(authRequest: AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { - try CacaosProvider().makeCacao(authRequest: authRequest, signature: signature, account: account) + public func buildSignedAuthObject(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { + try CacaosProvider().makeCacao(authPayload: authPayload, signature: signature, account: account) + } + + public func buildAuthPayload(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { + try AuthPayloadBuilder.build(payload: payload, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) } //----------------------------------------------------------------------------------- diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index e0542a07b..7ee343597 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -25,13 +25,13 @@ public protocol SignClientProtocol { func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session - func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject + func buildSignedAuthObject(authPayload: AuthPayload, signature: CacaoSignature, account: Account) throws -> AuthObject func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws func disconnect(topic: String) async throws func getSessions() -> [Session] func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String - + func buildAuthPayload(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index c2ce99124..71600eb10 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -237,10 +237,14 @@ public class Web3WalletClient { signClient.getPendingProposals(topic: topic) } - public func makeAuthObject(authRequest: AuthenticationRequest, signature: CacaoSignature, account: Account) throws -> AuthObject { - try signClient.makeAuthObject(authRequest: authRequest, signature: signature, account: account) + public func buildSignedAuthObject(authPayload: AuthPayload, signature: CacaoSignature, account: Account) throws -> AuthObject { + try signClient.buildSignedAuthObject(authPayload: authPayload, signature: signature, account: account) } - + + public func buildAuthPayload(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { + try signClient.buildAuthPayload(payload: payload, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + } + public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { try await pushClient.register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) } diff --git a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift index 3c23706d1..68d50348a 100644 --- a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift +++ b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift @@ -14,7 +14,7 @@ class AuthPayloadBuilderTests: XCTestCase { func testBuildWithValidSessionRecapUrn() throws { let request = createSampleAuthPayload(resources: [validSessionRecapUrn, "other-resource"]) - let result = try SessionPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let result = try AuthPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) XCTAssertEqual(result.resources?.count, 2, "Expected to have the original non-recap resource and one new session recap URN") XCTAssertTrue(result.resources?.contains("other-resource") ?? false, "Expected to preserve non-recap resource") @@ -23,7 +23,7 @@ class AuthPayloadBuilderTests: XCTestCase { func testBuildWithNoValidSessionRecapUrn() throws { let request = createSampleAuthPayload(resources: [invalidSessionRecapUrn, "other-resource"]) - XCTAssertThrowsError(try SessionPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in + XCTAssertThrowsError(try AuthPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in guard let error = error as? SessionRecap.Errors else { return XCTFail("Expected SessionRecap.Errors") } @@ -34,7 +34,7 @@ class AuthPayloadBuilderTests: XCTestCase { func testBuildPreservesExtraResources() throws { let request = createSampleAuthPayload(resources: ["additional-resource-1", validSessionRecapUrn, "additional-resource-2"]) - let result = try SessionPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let result = try AuthPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) XCTAssertTrue(result.resources?.contains("additional-resource-1") ?? false && result.resources?.contains("additional-resource-2") ?? false, "Expected to preserve additional non-recap resources") } diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift index c09d0f96f..06737ca44 100644 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ b/Tests/Web3WalletTests/Mocks/SignClientMock.swift @@ -13,7 +13,7 @@ final class SignClientMock: SignClientProtocol { fatalError() } - func makeAuthObject(authRequest: WalletConnectSign.AuthenticationRequest, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> WalletConnectSign.AuthObject { + func makeAuthObject(authPayload: WalletConnectSign.AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> WalletConnectSign.AuthObject { fatalError() } From 904bc47257341e996af8c5a191ba08ca5491454c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Feb 2024 20:21:43 +0100 Subject: [PATCH 363/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 32ed941e4..f905807b3 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -208,7 +208,7 @@ extension AuthRequestParams { statement: statement, requestId: requestId, resources: resources, - methods: ["eth_sign", "personal_sign", "eth_signTypedData"] + methods: ["eth_sign", "personal_sign", "eth_sendTransaction"] ) } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 005f2fead..bcc7f9f53 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,7 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) From 8ee210b0752d21020037dfcbc3577fc240a15ba8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 07:33:03 +0100 Subject: [PATCH 364/814] add chain intersection --- .../AuthRequest/AuthRequestPresenter.swift | 2 +- .../Auth/Services/AuthPayloadBuilder.swift | 2 +- .../Auth/Services/SessionRecapBuilder.swift | 26 ++++++++++++------- 3 files changed, 18 insertions(+), 12 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index bcc7f9f53..187944dd2 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -98,7 +98,7 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) + let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) diff --git a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift index 3119c2105..aa239c385 100644 --- a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift @@ -11,7 +11,7 @@ public struct AuthPayloadBuilder { } // Use SessionRecapBuilder to create a new session recap based on the existing valid URN - let newSessionRecap = try SessionRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let newSessionRecap = try SessionRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, requestedChains: payload.chains, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) // Encode the new session recap to its URN format let newSessionRecapUrn = newSessionRecap.urn diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift index b52d05820..3682b3b45 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift @@ -1,15 +1,17 @@ import Foundation +import Foundation + struct SessionRecapBuilder { enum BuilderError: Error { case nonEVMChainNamespace case emptySupportedChainsOrMethods + case noCommonChains } - static func build(requestedSessionRecap urn: String, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SessionRecap { - // Ensure supported chains are EVM chains and methods are not empty + static func build(requestedSessionRecap urn: String, requestedChains: [String], supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SessionRecap { guard !supportedEVMChains.isEmpty, !supportedMethods.isEmpty else { throw BuilderError.emptySupportedChainsOrMethods } @@ -17,24 +19,30 @@ struct SessionRecapBuilder { guard supportedEVMChains.allSatisfy({ $0.namespace == "eip155" }) else { throw BuilderError.nonEVMChainNamespace } - // Decode the requestedSessionRecap into a SessionRecap object + + // Convert supportedEVMChains to string array for intersection + let supportedChainStrings = supportedEVMChains.map { $0.absoluteString } + + // Find intersection of requestedChains and supportedEVMChains strings + let commonChains = requestedChains.filter(supportedChainStrings.contains) + guard !commonChains.isEmpty else { + throw BuilderError.noCommonChains + } + let requestedRecap = try SessionRecap(urn: urn) - // Initialize filteredActions to potentially include all supported methods var filteredActions: [String: [String: [AnyCodable]]] = [:] - // Check if `eip155` actions exist in the requested recap if let eip155Actions = requestedRecap.recapData.att?["eip155"] { for method in supportedMethods { let actionKey = "request/\(method)" if eip155Actions.keys.contains(actionKey) { - let supportedChainsCodable = supportedEVMChains.map { $0.absoluteString } - filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": supportedChainsCodable])] + // Use only common chains for each supported method + filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": commonChains])] } } } - // Encode the filtered RecapData back into a base64 string let modifiedRecapData = SessionRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) let encoder = JSONEncoder() guard let jsonData = try? encoder.encode(modifiedRecapData) else { @@ -42,9 +50,7 @@ struct SessionRecapBuilder { } let jsonBase64String = jsonData.base64EncodedString() - // Create a new SessionRecap object with the modified data let modifiedUrn = "urn:recap:\(jsonBase64String)" return try SessionRecap(urn: modifiedUrn) } - } From 3eb4da801709db94a2981095c32db6c7dd37afc2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 09:22:47 +0100 Subject: [PATCH 365/814] add chains validation --- .../SessionProposalInteractor.swift | 8 +- Sources/WalletConnectSign/Namespace.swift | 5 +- .../AutoNamespacesValidationTests.swift | 277 +++++------------- 3 files changed, 88 insertions(+), 202 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index ece832c35..152981cf9 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -11,8 +11,12 @@ final class SessionProposalInteractor { let supportedRequiredChains = proposal.requiredNamespaces["eip155"]?.chains let supportedOptionalChains = proposal.optionalNamespaces?["eip155"]?.chains ?? [] - let supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) ?? [] - + var supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) ?? [] + + let solanaChain: Set = [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!] + + supportedChains = supportedChains.union(solanaChain) + let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } /* Use only supported values for production. I.e: diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 08ded8326..1f5a19565 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -180,8 +180,9 @@ public enum AutoNamespaces { let proposalNamespace = $0.value if let proposalChains = proposalNamespace.chains { - let sessionChains = Set(proposalChains).intersection(Set(chains)) - guard !sessionChains.isEmpty else { + let sessionChains = proposalChains + + guard !sessionChains.isEmpty && proposalChains.isSubset(of: chains) else { throw AutoNamespacesError.requiredChainsNotSatisfied } diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 8e2d5260c..d5ea0a8c5 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -18,15 +18,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!], @@ -64,15 +57,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!], @@ -110,15 +96,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!], @@ -160,15 +139,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!], @@ -215,15 +187,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!, Blockchain("eip155:4")!], @@ -268,15 +233,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], @@ -322,15 +280,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:4")!], @@ -371,15 +322,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:4")!], @@ -420,15 +364,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:4")!], @@ -470,15 +407,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:4")!], @@ -525,15 +455,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:4")!, Blockchain("cosmos:cosmoshub-4")!], @@ -585,15 +508,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + XCTAssertThrowsError( try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -628,15 +544,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + XCTAssertThrowsError( try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -665,15 +574,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + XCTAssertThrowsError( try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -702,15 +604,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + XCTAssertThrowsError( try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -739,15 +634,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + XCTAssertThrowsError( try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -780,15 +668,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + XCTAssertThrowsError( try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -817,15 +698,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: [] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!], @@ -864,15 +738,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!], @@ -911,15 +778,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: [] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!], @@ -963,15 +823,8 @@ final class AutoNamespacesValidationTests: XCTestCase { events: [] ) ] - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, chains: [Blockchain("eip155:1")!, Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], @@ -1001,15 +854,7 @@ final class AutoNamespacesValidationTests: XCTestCase { } func testBuildThrowsWhenSessionNamespacesAreEmpty() { - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: [:], - optionalNamespaces: [:], - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) + let sessionProposal = Session.Proposal.stub(requiredNamespaces: [:], optionalNamespaces: [:]) XCTAssertThrowsError(try AutoNamespaces.build( sessionProposal: sessionProposal, @@ -1024,3 +869,39 @@ final class AutoNamespacesValidationTests: XCTestCase { } } } + +fileprivate extension Session.Proposal { + static func stub( + requiredNamespaces: [String: ProposalNamespace] = [:], + optionalNamespaces: [String: ProposalNamespace]? = nil + ) -> Session.Proposal { + return Session.Proposal( + id: "mockId", + pairingTopic: "mockPairingTopic", + proposer: AppMetadata.stub(), + requiredNamespaces: requiredNamespaces, + optionalNamespaces: optionalNamespaces, + sessionProperties: nil, + proposal: SessionProposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + ) + } +} + +fileprivate extension SessionProposal { + static func stub( + requiredNamespaces: [String: ProposalNamespace] = [:], + optionalNamespaces: [String: ProposalNamespace]? = nil, + proposerPubKey: String = "" + ) -> SessionProposal { + return SessionProposal( + relays: [], + proposer: Participant( + publicKey: proposerPubKey, + metadata: AppMetadata.stub() + ), + requiredNamespaces: requiredNamespaces, + optionalNamespaces: optionalNamespaces ?? [:], + sessionProperties: [:] + ) + } +} From 83222f4323757e0378ecf156b57cca491837d12b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 09:52:42 +0100 Subject: [PATCH 366/814] add more autonamespace builder test --- .../AutoNamespacesValidationTests.swift | 205 ++++++++++++++++++ 1 file changed, 205 insertions(+) diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index d5ea0a8c5..22da948fa 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -868,8 +868,213 @@ final class AutoNamespacesValidationTests: XCTestCase { } } } + + func testAutoNamespacesRequiredChainsNotSatisfied() { + let accounts = [Account(blockchain: Blockchain("eip155:1")!, address: "0x123")!] + let requiredNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], // Required chain not supported + methods: ["personal_sign"], + events: ["chainChanged"]) + ] + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: [:]) + + XCTAssertThrowsError(try AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!], // Only eip155:1 is supported + methods: ["personal_sign"], + events: ["chainChanged"], + accounts: accounts + ), "Expected to throw AutoNamespacesError.requiredChainsNotSatisfied, but it did not") { error in + guard case AutoNamespacesError.requiredChainsNotSatisfied = error else { + return XCTFail("Unexpected error type: \(error)") + } + } + } + + func testValidatingBuiltNamespaces() async { + // Setup + let accounts = [ + Account(blockchain: Blockchain("eip155:1")!, address: "0x123")!, + Account(blockchain: Blockchain("eip155:2")!, address: "0x456")! + ] + let requiredNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], + methods: ["personal_sign", "eth_sendTransaction"], + events: ["chainChanged"] + ) + ] + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: nil) + + do { + // Act + let sessionNamespaces = try AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], + methods: ["personal_sign", "eth_sendTransaction"], + events: ["chainChanged"], + accounts: accounts + ) + + // Validate + try Namespace.validate(sessionNamespaces) + + // Assert + XCTAssertNotNil(sessionNamespaces, "Session namespaces should be successfully built and validated.") + } catch { + XCTFail("Namespace validation failed with error: \(error)") + } + } + + func testAutoNamespacesMergingSupersetOfMethodsAndEvents() async { + let accounts = [Account(blockchain: Blockchain("eip155:1")!, address: "0x123")!] + let requiredNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!], + methods: ["personal_sign"], + events: ["chainChanged"] + ) + ] + let optionalNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!], + methods: ["personal_sign", "eth_sendTransaction", "eth_sign"], + events: ["chainChanged", "accountsChanged"] + ) + ] + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + + let sessionNamespaces = try! AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!], + methods: ["personal_sign", "eth_sendTransaction", "eth_sign"], + events: ["chainChanged", "accountsChanged"], + accounts: accounts + ) + + let expectedNamespaces: [String: SessionNamespace] = [ + "eip155": SessionNamespace( + chains: [Blockchain("eip155:1")!], + accounts: Set(accounts), + methods: ["personal_sign", "eth_sendTransaction", "eth_sign"], + events: ["chainChanged", "accountsChanged"] + ) + ] + XCTAssertEqual(sessionNamespaces, expectedNamespaces) + } + + func testAutoNamespacesWithInvalidBlockchainReferences() async { + // Setup: Include an invalid blockchain reference in the required namespaces + let requiredNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("invalid:999")!], + methods: ["personal_sign"], + events: ["chainChanged"] + ) + ] + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: [:]) + + // Expect the build function to throw an error due to the invalid blockchain reference + XCTAssertThrowsError(try AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!], + methods: ["personal_sign"], + events: ["chainChanged"], + accounts: [] + )) { error in + XCTAssertEqual(error as? AutoNamespacesError, AutoNamespacesError.requiredChainsNotSatisfied) + } + } + + func testAutoNamespacesWithAccountsAcrossDifferentBlockchains() async { + // Setup: Accounts on different blockchains and required namespaces that span these blockchains + let accounts = [ + Account(blockchain: Blockchain("eip155:1")!, address: "0x1")!, + Account(blockchain: Blockchain("solana:4s")!, address: "0x2")! + ] + let requiredNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!], + methods: ["personal_sign"], + events: ["chainChanged"] + ), + "solana": ProposalNamespace( + chains: [Blockchain("solana:4s")!], + methods: ["solana_sign"], + events: ["accountChanged"] + ) + ] + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: [:]) + + // Execute: Call the build function with the setup + let sessionNamespaces = try! AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!, Blockchain("solana:4s")!], + methods: ["personal_sign", "solana_sign"], + events: ["chainChanged", "accountChanged"], + accounts: accounts + ) + + // Verify: Each blockchain has its corresponding account in the session namespace + XCTAssertTrue(sessionNamespaces["eip155"]?.accounts.contains(accounts[0]) ?? false) + XCTAssertTrue(sessionNamespaces["solana"]?.accounts.contains(accounts[1]) ?? false) + } + + func testAutoNamespacesWithComplexMergingAndOptionalAccounts() async { + // Setup: Complex scenario with overlapping required and optional namespaces, including one without accounts + let accounts = [Account(blockchain: Blockchain("eip155:1")!, address: "0x1")!] + let requiredNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!], + methods: ["personal_sign"], + events: ["chainChanged"] + ) + ] + let optionalNamespaces = [ + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!], + methods: ["eth_sendTransaction"], + events: ["accountsChanged"] + ), + "solana": ProposalNamespace( + chains: [Blockchain("solana:4s")!], + methods: ["solana_sign"], + events: ["accountChanged"] + ) + ] + let sessionProposal = Session.Proposal.stub(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + + // Execute: Call the build function with the setup + let sessionNamespaces = try! AutoNamespaces.build( + sessionProposal: sessionProposal, + chains: [Blockchain("eip155:1")!, Blockchain("solana:4s")!], + methods: ["personal_sign", "eth_sendTransaction", "solana_sign"], + events: ["chainChanged", "accountsChanged", "accountChanged"], + accounts: accounts + ) + + // Verify: Proper merging of required and optional namespaces, including method and event merging + let eip155Namespace = sessionNamespaces["eip155"] + XCTAssertTrue(eip155Namespace?.methods.contains("personal_sign") ?? false) + XCTAssertTrue(eip155Namespace?.methods.contains("eth_sendTransaction") ?? false) + XCTAssertTrue(eip155Namespace?.events.contains("chainChanged") ?? false) + XCTAssertTrue(eip155Namespace?.events.contains("accountsChanged") ?? false) + + // Given the updated understanding, we no longer assert the presence of accounts for each namespace, allowing for 0 or more accounts. + let solanaNamespace = sessionNamespaces["solana"] + XCTAssertNotNil(solanaNamespace) // Verify namespace exists, but don't enforce accounts + XCTAssertTrue(solanaNamespace?.methods.contains("solana_sign") ?? false) + XCTAssertTrue(solanaNamespace?.events.contains("accountChanged") ?? false) + } + } + + + + + fileprivate extension Session.Proposal { static func stub( requiredNamespaces: [String: ProposalNamespace] = [:], From e5b8f9045ba2d45ccf6a15065e76ca8593511250 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 10:02:40 +0100 Subject: [PATCH 367/814] savepoint --- .../Engine/Common/SessionEngine.swift | 1 + .../Sign/SessionRequestsProvider.swift | 10 ++++++++++ 2 files changed, 11 insertions(+) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index daf11e954..b874bf5fc 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -236,6 +236,7 @@ private extension SessionEngine { } func onSessionRequest(payload: RequestSubscriptionPayload) { + logger.debug("Received session request") let protocolMethod = SessionRequestProtocolMethod() let topic = payload.topic let request = Request( diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index 7838b65b7..89c8e9e79 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -4,6 +4,9 @@ import Foundation class SessionRequestsProvider { private let historyService: HistoryService private var sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() + private var lastEmitTime: Date? + private let debounceInterval: TimeInterval = 1 + public var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { sessionRequestPublisherSubject.eraseToAnyPublisher() } @@ -13,6 +16,13 @@ class SessionRequestsProvider { } func emitRequestIfPending() { + let now = Date() + if let lastEmitTime = lastEmitTime, now.timeIntervalSince(lastEmitTime) < debounceInterval { + return + } + + self.lastEmitTime = now + if let oldestRequest = self.historyService.getPendingRequestsSortedByTimestamp().first { self.sessionRequestPublisherSubject.send(oldestRequest) } From 9ab4e713ae4a9ef89238b9ff4038481a6b446f67 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 11:59:17 +0100 Subject: [PATCH 368/814] savepoint --- .../Wallet/SessionProposal/SessionProposalInteractor.swift | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index 152981cf9..a537c8f5b 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -13,11 +13,14 @@ final class SessionProposalInteractor { let supportedOptionalChains = proposal.optionalNamespaces?["eip155"]?.chains ?? [] var supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) ?? [] + let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } + let solanaChain: Set = [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!] supportedChains = supportedChains.union(solanaChain) - let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } + let solanaAccount + /* Use only supported values for production. I.e: let supportedMethods = ["eth_signTransaction", "personal_sign", "eth_signTypedData", "eth_sendTransaction", "eth_sign"] From c3b098862a8c8c774f29ce0f1a173901dc9284b4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 19:47:38 +0100 Subject: [PATCH 369/814] savepoint --- Example/Shared/Signer/SOLSigner.swift | 2 +- .../Wallet/SessionProposal/SessionProposalInteractor.swift | 5 +---- 2 files changed, 2 insertions(+), 5 deletions(-) diff --git a/Example/Shared/Signer/SOLSigner.swift b/Example/Shared/Signer/SOLSigner.swift index f9f328069..32d97fcfd 100644 --- a/Example/Shared/Signer/SOLSigner.swift +++ b/Example/Shared/Signer/SOLSigner.swift @@ -9,7 +9,7 @@ struct SOLSigner { return account.publicKey.base58EncodedString } - private static let account: Account = { + static let account: Account = { let key = "4eN1YZm598FtdigriE5int7Gf5dxs58rzVh3ftRwxjkYXxkiDiweuvkop2Kr5Td174DcbVdDxzjWqQ96uir3NYka" return try! Account(secretKey: Data(Base58.decode(key))) }() diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index a537c8f5b..4fe7c4fbb 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -11,7 +11,7 @@ final class SessionProposalInteractor { let supportedRequiredChains = proposal.requiredNamespaces["eip155"]?.chains let supportedOptionalChains = proposal.optionalNamespaces?["eip155"]?.chains ?? [] - var supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) ?? [] + var supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } @@ -19,9 +19,6 @@ final class SessionProposalInteractor { supportedChains = supportedChains.union(solanaChain) - let solanaAccount - - /* Use only supported values for production. I.e: let supportedMethods = ["eth_signTransaction", "personal_sign", "eth_signTypedData", "eth_sendTransaction", "eth_sign"] let supportedEvents = ["accountsChanged", "chainChanged"] From e9f6f75885031fae4d72f76cfad0b92aecdc236d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 20:01:33 +0100 Subject: [PATCH 370/814] savepoint --- .../IntegrationTests/Push/NotifyTests.swift | 46 +++++++++---------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 1618881e6..6bbbe9289 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -245,29 +245,29 @@ final class NotifyTests: XCTestCase { } } - func testFetchHistory() async throws { - let subscribeExpectation = expectation(description: "fetch notify subscription") - let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! - - var subscription: NotifySubscription! - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - subscribeExpectation.fulfill() - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in - let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } - - await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) - - let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) - XCTAssertTrue(hasMore) - XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) - } +// func testFetchHistory() async throws { +// let subscribeExpectation = expectation(description: "fetch notify subscription") +// let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! +// +// var subscription: NotifySubscription! +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// subscribeExpectation.fulfill() +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in +// let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) +// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) +// } +// +// await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) +// +// let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) +// XCTAssertTrue(hasMore) +// XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) +// } } From 4036cc29a09e924a67ea713d618033f899ce7fec Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Feb 2024 20:18:22 +0100 Subject: [PATCH 371/814] savepoint --- .../IntegrationTests/Push/NotifyTests.swift | 46 +++++++++---------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 6bbbe9289..1618881e6 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -245,29 +245,29 @@ final class NotifyTests: XCTestCase { } } -// func testFetchHistory() async throws { -// let subscribeExpectation = expectation(description: "fetch notify subscription") -// let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! -// -// var subscription: NotifySubscription! -// walletNotifyClientA.subscriptionsPublisher -// .sink { subscriptions in -// subscription = subscriptions.first -// subscribeExpectation.fulfill() -// }.store(in: &publishers) -// -// try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in -// let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") -// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) -// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) -// } -// -// await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) -// -// let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) -// XCTAssertTrue(hasMore) -// XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) -// } + func testFetchHistory() async throws { + let subscribeExpectation = expectation(description: "fetch notify subscription") + let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! + + var subscription: NotifySubscription! + walletNotifyClientA.subscriptionsPublisher + .sink { subscriptions in + subscription = subscriptions.first + subscribeExpectation.fulfill() + }.store(in: &publishers) + + try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in + let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") + let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) + return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) + } + + await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) + + let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) + XCTAssertTrue(hasMore) + XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) + } } From 00578da30798701ee5c0de40b361a4bcdfec3273 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 07:39:36 +0100 Subject: [PATCH 372/814] update integration with rejection on failed autonamespace build --- .../Sign/SignClientTests.swift | 4 +-- .../SessionProposalInteractor.swift | 32 ++++++++++------- Sources/WalletConnectSign/Namespace.swift | 6 ++-- .../WalletConnectSign/RejectionReason.swift | 34 +++++++++++++++---- .../AutoNamespacesValidationTests.swift | 2 +- 5 files changed, 53 insertions(+), 25 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index b1cfb2978..6372b1fe8 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -110,7 +110,7 @@ final class SignClientTests: XCTestCase { wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { - try await wallet.reject(proposalId: proposal.id, reason: .userRejectedChains) // TODO: Review reason + try await wallet.reject(proposalId: proposal.id, reason: .unsupportedChains) store.rejectedProposal = proposal semaphore.signal() } catch { XCTFail("\(error)") } @@ -119,7 +119,7 @@ final class SignClientTests: XCTestCase { dapp.sessionRejectionPublisher.sink { proposal, _ in semaphore.wait() XCTAssertEqual(store.rejectedProposal, proposal) - sessionRejectExpectation.fulfill() // TODO: Assert reason code + sessionRejectExpectation.fulfill() }.store(in: &publishers) await fulfillment(of: [sessionRejectExpectation], timeout: InputConfig.defaultTimeout) } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index 4fe7c4fbb..2c1b13756 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -15,23 +15,31 @@ final class SessionProposalInteractor { let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } - let solanaChain: Set = [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!] - - supportedChains = supportedChains.union(solanaChain) - /* Use only supported values for production. I.e: let supportedMethods = ["eth_signTransaction", "personal_sign", "eth_signTypedData", "eth_sendTransaction", "eth_sign"] let supportedEvents = ["accountsChanged", "chainChanged"] let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] let supportedAccounts = [Account(blockchain: Blockchain("eip155:1")!, address: ETHSigner.address)!, Account(blockchain: Blockchain("eip155:137")!, address: ETHSigner.address)!] */ - let sessionNamespaces = try AutoNamespaces.build( - sessionProposal: proposal, - chains: Array(supportedChains), - methods: Array(supportedMethods), - events: Array(supportedEvents), - accounts: supportedAccounts - ) + var sessionNamespaces: [String: SessionNamespace]! + + do { + sessionNamespaces = try AutoNamespaces.build( + sessionProposal: proposal, + chains: Array(supportedChains), + methods: Array(supportedMethods), + events: Array(supportedEvents), + accounts: supportedAccounts + ) + } catch let error as AutoNamespacesError { + try await reject(proposal: proposal, reason: RejectionReason(from: error)) + AlertPresenter.present(message: error.localizedDescription, type: .error) + return false + } catch { + try await reject(proposal: proposal, reason: .userRejected) + AlertPresenter.present(message: error.localizedDescription, type: .error) + return false + } try await Web3Wallet.instance.approve(proposalId: proposal.id, namespaces: sessionNamespaces, sessionProperties: proposal.sessionProperties) if let uri = proposal.proposer.redirect?.native { @@ -42,7 +50,7 @@ final class SessionProposalInteractor { } } - func reject(proposal: Session.Proposal) async throws { + func reject(proposal: Session.Proposal, reason: RejectionReason = .userRejected) async throws { try await Web3Wallet.instance.reject(proposalId: proposal.id, reason: .userRejected) /* Redirect */ diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 1f5a19565..af84a5fb4 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -5,7 +5,7 @@ public enum AutoNamespacesError: Error, LocalizedError { case requiredAccountsNotSatisfied case requiredMethodsNotSatisfied case requiredEventsNotSatisfied - case emtySessionNamespacesForbidden + case emptySessionNamespacesForbidden public var errorDescription: String? { switch self { @@ -17,7 +17,7 @@ public enum AutoNamespacesError: Error, LocalizedError { return "The required methods are not satisfied." case .requiredEventsNotSatisfied: return "The required events are not satisfied." - case .emtySessionNamespacesForbidden: + case .emptySessionNamespacesForbidden: return "Empty session namespaces are not allowed." } } @@ -341,7 +341,7 @@ public enum AutoNamespaces { } } } - guard !sessionNamespaces.isEmpty else { throw AutoNamespacesError.emtySessionNamespacesForbidden } + guard !sessionNamespaces.isEmpty else { throw AutoNamespacesError.emptySessionNamespacesForbidden } return sessionNamespaces } diff --git a/Sources/WalletConnectSign/RejectionReason.swift b/Sources/WalletConnectSign/RejectionReason.swift index c2dff54c2..6044f6075 100644 --- a/Sources/WalletConnectSign/RejectionReason.swift +++ b/Sources/WalletConnectSign/RejectionReason.swift @@ -3,9 +3,10 @@ import Foundation /// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-25.md public enum RejectionReason { case userRejected - case userRejectedChains - case userRejectedMethods - case userRejectedEvents + case unsupportedChains + case unsupportedMethods + case unsupportedAccounts + case upsupportedEvents } internal extension RejectionReason { @@ -13,12 +14,31 @@ internal extension RejectionReason { switch self { case .userRejected: return SignReasonCode.userRejected - case .userRejectedChains: - return SignReasonCode.userRejectedChains - case .userRejectedMethods: + case .unsupportedChains: + return SignReasonCode.unsupportedChains + case .unsupportedMethods: return SignReasonCode.userRejectedMethods - case .userRejectedEvents: + case .upsupportedEvents: return SignReasonCode.userRejectedEvents + case .unsupportedAccounts: + return SignReasonCode.unsupportedAccounts + } + } +} + +public extension RejectionReason { + init(from error: AutoNamespacesError) { + switch error { + case .requiredChainsNotSatisfied: + self = .unsupportedChains + case .requiredAccountsNotSatisfied: + self = .unsupportedAccounts + case .requiredMethodsNotSatisfied: + self = .unsupportedMethods + case .requiredEventsNotSatisfied: + self = .upsupportedEvents + case .emptySessionNamespacesForbidden: + self = .unsupportedAccounts } } } diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 22da948fa..f7c65f72d 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -863,7 +863,7 @@ final class AutoNamespacesValidationTests: XCTestCase { events: [], accounts: [] ), "Expected to throw AutoNamespacesError.emtySessionNamespacesForbidden, but it did not") { error in - guard case AutoNamespacesError.emtySessionNamespacesForbidden = error else { + guard case AutoNamespacesError.emptySessionNamespacesForbidden = error else { return XCTFail("Unexpected error type: \(error)") } } From 731b74c7165a7fde4d0984e07e8dd0c2056576cb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 07:59:05 +0100 Subject: [PATCH 373/814] savepoint --- .../IntegrationTests/Push/NotifyTests.swift | 46 +++++++++---------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 1618881e6..6bbbe9289 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -245,29 +245,29 @@ final class NotifyTests: XCTestCase { } } - func testFetchHistory() async throws { - let subscribeExpectation = expectation(description: "fetch notify subscription") - let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! - - var subscription: NotifySubscription! - walletNotifyClientA.subscriptionsPublisher - .sink { subscriptions in - subscription = subscriptions.first - subscribeExpectation.fulfill() - }.store(in: &publishers) - - try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in - let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } - - await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) - - let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) - XCTAssertTrue(hasMore) - XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) - } +// func testFetchHistory() async throws { +// let subscribeExpectation = expectation(description: "fetch notify subscription") +// let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! +// +// var subscription: NotifySubscription! +// walletNotifyClientA.subscriptionsPublisher +// .sink { subscriptions in +// subscription = subscriptions.first +// subscribeExpectation.fulfill() +// }.store(in: &publishers) +// +// try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in +// let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) +// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) +// } +// +// await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) +// +// let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) +// XCTAssertTrue(hasMore) +// XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) +// } } From bfc51ca17b2ae790a724324fa352f453e9c01b0e Mon Sep 17 00:00:00 2001 From: llbartekll Date: Wed, 14 Feb 2024 10:00:46 +0100 Subject: [PATCH 374/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index ec1cdfd4c..10f769c2c 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.12.0"} +{"version": "1.13.0"} From 1e327891225b89fd10736293ba04b76644bd5022 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 13:10:36 +0100 Subject: [PATCH 375/814] update cacao type --- Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift | 2 +- Sources/WalletConnectSign/Auth/Types/AuthPayload.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift index 70358d865..5ab42d879 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift @@ -4,7 +4,7 @@ import Foundation struct CacaosProvider { public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { let payload = try authPayload.cacaoPayload(account: account) - let header = CacaoHeader(t: "caip122") + let header = CacaoHeader(t: "eip4361") return Cacao(h: header, p: payload, s: signature) } } diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index 2a429523f..f106fff21 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -44,7 +44,7 @@ public struct AuthPayload: Codable, Equatable { init(requestParams: AuthRequestParams, iat: String) { - self.type = "caip122" + self.type = "eip4361" self.chains = requestParams.chains self.domain = requestParams.domain self.aud = requestParams.aud From 1efb8d5f0c30391f0039a304d15e0ad905807b55 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 14:26:43 +0100 Subject: [PATCH 376/814] dapp hide pairing screen on rejection --- Example/DApp/Modules/Sign/SignPresenter.swift | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index f905807b3..60cc875d3 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -140,6 +140,14 @@ extension SignPresenter { } .store(in: &subscriptions) + Sign.instance.authResponsePublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] _ in + router.dismiss() + Task(priority: .high) { ActivityIndicatorManager.shared.stop() } + } + .store(in: &subscriptions) + Sign.instance.sessionResponsePublisher .receive(on: DispatchQueue.main) .sink { response in From 2a74e897c20bbdd2cd8d8fec855069500a1e4ea9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 14:29:16 +0100 Subject: [PATCH 377/814] add alert --- Example/DApp/Modules/Sign/SignPresenter.swift | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 60cc875d3..2b984c576 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -142,7 +142,13 @@ extension SignPresenter { Sign.instance.authResponsePublisher .receive(on: DispatchQueue.main) - .sink { [unowned self] _ in + .sink { [unowned self] response in + switch response.result { + case .success(_): + break + case .failure(let error): + AlertPresenter.present(message: error.localizedDescription, type: .error) + } router.dismiss() Task(priority: .high) { ActivityIndicatorManager.shared.stop() } } From a9d99b6304a4450177985ef02a9866143e06318e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 14:36:01 +0100 Subject: [PATCH 378/814] add loaders to auth request screen --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 187944dd2..dce282c07 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -53,10 +53,12 @@ final class AuthRequestPresenter: ObservableObject { @MainActor func approve() async { do { + ActivityIndicatorManager.shared.start() let auths = try buildAuthObjects() _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) + ActivityIndicatorManager.shared.stop() /* Redirect */ if let uri = request.requester.redirect?.native { @@ -67,13 +69,15 @@ final class AuthRequestPresenter: ObservableObject { } } catch { + ActivityIndicatorManager.shared.stop() AlertPresenter.present(message: error.localizedDescription, type: .error) } } @MainActor func reject() async { - + ActivityIndicatorManager.shared.start() + do { try await Web3Wallet.instance.rejectSession(requestId: request.id) @@ -81,8 +85,12 @@ final class AuthRequestPresenter: ObservableObject { if let uri = request.requester.redirect?.native { WalletConnectRouter.goBack(uri: uri) } + ActivityIndicatorManager.shared.stop() + router.dismiss() } catch { + ActivityIndicatorManager.shared.stop() + AlertPresenter.present(message: error.localizedDescription, type: .error) } } From 16eac1e31ea0622b1230f062b553e6511341c6dd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Feb 2024 18:39:49 +0100 Subject: [PATCH 379/814] savepoint --- .../Sign/SignClientTests.swift | 35 ++++++++++++++++++ .../Auth/Services/AuthPayloadBuilder.swift | 8 ++-- .../Services/SessionNamespaceBuilder.swift | 4 +- .../{SessionRecap.swift => SignRecap.swift} | 12 +----- ...apBuilder.swift => SignRecapBuilder.swift} | 12 +++--- .../AuthPayloadBuilderTests.swift | 4 +- ...ests.swift => SignRecapBuilderTests.swift} | 37 ++++++++++++++++--- ...nRecapTests.swift => SignRecapTests.swift} | 23 +++++++++--- 8 files changed, 100 insertions(+), 35 deletions(-) rename Sources/WalletConnectSign/Auth/Services/{SessionRecap.swift => SignRecap.swift} (79%) rename Sources/WalletConnectSign/Auth/Services/{SessionRecapBuilder.swift => SignRecapBuilder.swift} (83%) rename Tests/WalletConnectSignTests/{SessionRecapBuilderTests.swift => SignRecapBuilderTests.swift} (59%) rename Tests/WalletConnectSignTests/{SessionRecapTests.swift => SignRecapTests.swift} (59%) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 982ed7991..d46895f54 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -800,6 +800,41 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } + func testEIP191SessionAuthenticateEmptyMethods() async throws { + let responseExpectation = expectation(description: "successful response delivered") + + wallet.authRequestPublisher.sink { [unowned self] (request, _) in + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create() + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) + + let signature = try signer.sign( + message: siweMessage, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) + + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success = result else { XCTFail(); return } + responseExpectation.fulfill() + } + .store(in: &publishers) + + + let uri = try await dapp.authenticate(AuthRequestParams.stub(methods: nil)) + try await walletPairingClient.pair(uri: uri) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + func testEIP191SessionAuthenticatedMultiCacao() async throws { let responseExpectation = expectation(description: "successful response delivered") diff --git a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift index aa239c385..4736f391a 100644 --- a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift @@ -6,18 +6,18 @@ public struct AuthPayloadBuilder { public static func build(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { // Attempt to find a valid session recap URN from the resources - guard let existingSessionRecapUrn = payload.resources?.first(where: { (try? SessionRecap(urn: $0)) != nil }) else { - throw SessionRecap.Errors.invalidRecapStructure + guard let existingSessionRecapUrn = payload.resources?.first(where: { (try? SignRecap(urn: $0)) != nil }) else { + throw SignRecap.Errors.invalidRecapStructure } // Use SessionRecapBuilder to create a new session recap based on the existing valid URN - let newSessionRecap = try SessionRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, requestedChains: payload.chains, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let newSessionRecap = try SignRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, requestedChains: payload.chains, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) // Encode the new session recap to its URN format let newSessionRecapUrn = newSessionRecap.urn // Filter out the old session recap URNs, retaining all other resources - let updatedResources = payload.resources?.filter { (try? SessionRecap(urn: $0)) == nil } + let updatedResources = payload.resources?.filter { (try? SignRecap(urn: $0)) == nil } // Add the new session recap URN to the updated resources let finalResources = (updatedResources ?? []) + [newSessionRecapUrn] diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 8c936c60d..3581d07c5 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -18,13 +18,13 @@ class SessionNamespaceBuilder { throw Errors.emptyCacaosArrayForbidden } - guard let firstRecapResource = cacaos.first?.p.resources?.compactMap({ try? SessionRecap(urn: $0) }).first else { + guard let firstRecapResource = cacaos.first?.p.resources?.compactMap({ try? SignRecap(urn: $0) }).first else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } for cacao in cacaos { guard let resources = cacao.p.resources, - resources.contains(where: { (try? SessionRecap(urn: $0)) != nil }) else { + resources.contains(where: { (try? SignRecap(urn: $0)) != nil }) else { throw Errors.malformedRecap } } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift similarity index 79% rename from Sources/WalletConnectSign/Auth/Services/SessionRecap.swift rename to Sources/WalletConnectSign/Auth/Services/SignRecap.swift index e691f2a49..57a14fe8c 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift @@ -1,7 +1,7 @@ import Foundation -struct SessionRecap { +struct SignRecap { struct RecapData: Codable { var att: [String: [String: [AnyCodable]]]? var prf: [String]? @@ -12,7 +12,6 @@ struct SessionRecap { enum Errors: Error { case invalidUrnPrefix case invalidRecapStructure - case invalidActions } init(urn: String) throws { @@ -20,18 +19,12 @@ struct SessionRecap { throw Errors.invalidUrnPrefix } - // Extract the Base64 part and decode it into RecapData let base64Part = urn.dropFirst("urn:recap:".count) guard let jsonData = Data(base64Encoded: String(base64Part)), let decodedData = try? JSONDecoder().decode(RecapData.self, from: jsonData) else { throw Errors.invalidRecapStructure } - // Validate the structure specifically for 'eip155' with 'request/' prefixed actions - guard let eip155Actions = decodedData.att?["eip155"], !eip155Actions.isEmpty else { - throw Errors.invalidRecapStructure - } - self.urn = urn self.recapData = decodedData } @@ -39,10 +32,9 @@ struct SessionRecap { var methods: Set { guard let eip155Actions = recapData.att?["eip155"] else { return [] } return Set(eip155Actions.keys - .filter{$0.hasPrefix("request/")} + .filter { $0.hasPrefix("request/") } .map { String($0.dropFirst("request/".count)) }) } - var chains: Set { guard let eip155Actions = recapData.att?["eip155"] else { return [] } diff --git a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift similarity index 83% rename from Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift rename to Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift index 3682b3b45..7165ad8fa 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift @@ -3,7 +3,7 @@ import Foundation import Foundation -struct SessionRecapBuilder { +struct SignRecapBuilder { enum BuilderError: Error { case nonEVMChainNamespace @@ -11,7 +11,7 @@ struct SessionRecapBuilder { case noCommonChains } - static func build(requestedSessionRecap urn: String, requestedChains: [String], supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SessionRecap { + static func build(requestedSessionRecap urn: String, requestedChains: [String], supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SignRecap { guard !supportedEVMChains.isEmpty, !supportedMethods.isEmpty else { throw BuilderError.emptySupportedChainsOrMethods } @@ -29,7 +29,7 @@ struct SessionRecapBuilder { throw BuilderError.noCommonChains } - let requestedRecap = try SessionRecap(urn: urn) + let requestedRecap = try SignRecap(urn: urn) var filteredActions: [String: [String: [AnyCodable]]] = [:] @@ -43,14 +43,14 @@ struct SessionRecapBuilder { } } - let modifiedRecapData = SessionRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) + let modifiedRecapData = SignRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) let encoder = JSONEncoder() guard let jsonData = try? encoder.encode(modifiedRecapData) else { - throw SessionRecap.Errors.invalidRecapStructure + throw SignRecap.Errors.invalidRecapStructure } let jsonBase64String = jsonData.base64EncodedString() let modifiedUrn = "urn:recap:\(jsonBase64String)" - return try SessionRecap(urn: modifiedUrn) + return try SignRecap(urn: modifiedUrn) } } diff --git a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift index 68d50348a..18eaef404 100644 --- a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift +++ b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift @@ -24,10 +24,10 @@ class AuthPayloadBuilderTests: XCTestCase { let request = createSampleAuthPayload(resources: [invalidSessionRecapUrn, "other-resource"]) XCTAssertThrowsError(try AuthPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in - guard let error = error as? SessionRecap.Errors else { + guard let error = error as? SignRecap.Errors else { return XCTFail("Expected SessionRecap.Errors") } - XCTAssertEqual(error, SessionRecap.Errors.invalidRecapStructure) + XCTAssertEqual(error, SignRecap.Errors.invalidRecapStructure) } } diff --git a/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift b/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift similarity index 59% rename from Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift rename to Tests/WalletConnectSignTests/SignRecapBuilderTests.swift index f770d9e00..f5fe76f8c 100644 --- a/Tests/WalletConnectSignTests/SessionRecapBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift @@ -1,7 +1,7 @@ import XCTest @testable import WalletConnectSign -class SessionRecapBuilderTests: XCTestCase { +class SignRecapBuilderTests: XCTestCase { var requestedRecapUrn: String { let requestedRecap: [String: [String: [String: [[String: [String]]]]]] = [ @@ -21,9 +21,10 @@ class SessionRecapBuilderTests: XCTestCase { // Given let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] let supportedMethods = ["eth_sendTransaction"] + let requestedChains = ["eip155:1", "eip155:137"] // When - let result = try SessionRecapBuilder.build(requestedSessionRecap: requestedRecapUrn, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + let result = try SignRecapBuilder.build(requestedSessionRecap: requestedRecapUrn, requestedChains: requestedChains, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) // Expected structure after building the recap let expectedRecap: [String: [String: [String: [[String: [String]]]]]] = [ @@ -47,11 +48,12 @@ class SessionRecapBuilderTests: XCTestCase { // Given let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] let supportedMethods = ["eth_sendTransaction", "personal_sign"] + let requestedChains = ["eip155:1", "eip155:137"] let urn = requestedRecapUrn // When - let result = try! SessionRecapBuilder.build(requestedSessionRecap: urn, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + let result = try! SignRecapBuilder.build(requestedSessionRecap: urn, requestedChains: requestedChains, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) // Then XCTAssertNotNil(result.recapData.att?["eip155"]?["request/eth_sendTransaction"]) @@ -63,10 +65,11 @@ class SessionRecapBuilderTests: XCTestCase { let urn = requestedRecapUrn let nonEVMChain = Blockchain("solana:1")! let supportedMethods = ["eth_sendTransaction"] + let requestedChains = ["eip155:1", "eip155:137"] // Expecting an error to be thrown for the non-EVM chain - XCTAssertThrowsError(try SessionRecapBuilder.build(requestedSessionRecap: urn, supportedEVMChains: [nonEVMChain], supportedMethods: supportedMethods)) { error in - XCTAssertEqual(error as? SessionRecapBuilder.BuilderError, .nonEVMChainNamespace) + XCTAssertThrowsError(try SignRecapBuilder.build(requestedSessionRecap: urn, requestedChains: requestedChains, supportedEVMChains: [nonEVMChain], supportedMethods: supportedMethods)) { error in + XCTAssertEqual(error as? SignRecapBuilder.BuilderError, .nonEVMChainNamespace) } } @@ -75,11 +78,12 @@ class SessionRecapBuilderTests: XCTestCase { let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] // Include an extra method that is not present in the requestedRecapUrn let supportedMethods = ["eth_sendTransaction", "extraUnsupportedMethod"] + let requestedChains = ["eip155:1", "eip155:137"] let requestedRecapUrn = self.requestedRecapUrn // Using the previously defined requestedRecapUrn // When - let result = try SessionRecapBuilder.build(requestedSessionRecap: requestedRecapUrn, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + let result = try SignRecapBuilder.build(requestedSessionRecap: requestedRecapUrn, requestedChains: requestedChains, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) // Then // Verify that the result only contains the "eth_sendTransaction" method and not the "extraUnsupportedMethod" @@ -87,5 +91,26 @@ class SessionRecapBuilderTests: XCTestCase { XCTAssertFalse(result.recapData.att?["eip155"]?.keys.contains("request/extraUnsupportedMethod") ?? true, "Result should not contain 'extraUnsupportedMethod'") } + func testSignRecapBuilder_RecapWithNoMethodsIsValid() throws { + // Given a recap with no methods + let recapWithNoMethods: [String: [String: [String: [[String: [String]]]]]] = [ + "att": [ + "eip155": [:] // No methods + ] + ] + let encodedNoMethods = try! JSONEncoder().encode(recapWithNoMethods).base64EncodedString() + let urnWithNoMethods = "urn:recap:\(encodedNoMethods)" + + let requestedChains = ["eip155:1", "eip155:137"] + let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + let supportedMethods = ["eth_sendTransaction", "personal_sign"] + + // When + let result = try SignRecapBuilder.build(requestedSessionRecap: urnWithNoMethods, requestedChains: requestedChains, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + + // Then + XCTAssertTrue(result.recapData.att?["eip155"]?.isEmpty ?? false, "Recap should be considered valid even with no methods.") + } + } diff --git a/Tests/WalletConnectSignTests/SessionRecapTests.swift b/Tests/WalletConnectSignTests/SignRecapTests.swift similarity index 59% rename from Tests/WalletConnectSignTests/SessionRecapTests.swift rename to Tests/WalletConnectSignTests/SignRecapTests.swift index b5ad51df2..5bbcdb454 100644 --- a/Tests/WalletConnectSignTests/SessionRecapTests.swift +++ b/Tests/WalletConnectSignTests/SignRecapTests.swift @@ -1,14 +1,14 @@ import XCTest @testable import WalletConnectSign -class SessionRecapTests: XCTestCase { +class SignRecapTests: XCTestCase { func testSessionRecapInitializationSuccess() throws { // dedoded recap: {"att": {"eip155": {"request/eth_signTypedData_v4": [], "request/personal_sign": []}}} let recapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2lnblR5cGVkRGF0YV92NCI6IFtdLCAicmVxdWVzdC9wZXJzb25hbF9zaWduIjogW119fX0=" do { - let sessionRecap = try SessionRecap(urn: recapUrn) + let sessionRecap = try SignRecap(urn: recapUrn) let methods = sessionRecap.methods // Verify that the expected methods are present XCTAssertTrue(methods.contains("personal_sign")) @@ -22,13 +22,26 @@ class SessionRecapTests: XCTestCase { // dedoded: {"att": {"eip155:1": {"request/eth_signTypedData_v4": [], "request/personal_sign": []}}} let invalidRecap = "urn:recap:eyJhdHQiOiB7ImVpcDE1NToxIjogeyJyZXF1ZXN0L2V0aF9zaWduVHlwZWREYXRhX3Y0IjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ==" - XCTAssertThrowsError(try SessionRecap(urn: invalidRecap)) { error in - guard let sessionRecapError = error as? SessionRecap.Errors else { + XCTAssertThrowsError(try SignRecap(urn: invalidRecap)) { error in + guard let sessionRecapError = error as? SignRecap.Errors else { XCTFail("Error should be of type SessionRecap.Errors") return } - XCTAssertEqual(sessionRecapError, SessionRecap.Errors.invalidRecapStructure) + XCTAssertEqual(sessionRecapError, SignRecap.Errors.invalidRecapStructure) } } + + func testSignRecapInitializationSuccessWithNoMethods() throws { + // Encoded recap: {"att": {"eip155": {}}} + let recapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHt9fX0=" + + do { + let signRecap = try SignRecap(urn: recapUrn) + XCTAssertTrue(signRecap.methods.isEmpty, "Initialization should succeed with no methods.") + } catch { + XCTFail("Initialization should not fail for valid recap URN with no methods.") + } + } + } From 575af53ad824f259785020def0d208cd49b6d7b0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 15 Feb 2024 08:03:17 +0100 Subject: [PATCH 380/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 8 +++---- .../Auth/Services/SignRecap.swift | 6 ++++++ .../Auth/Services/SignRecapBuilder.swift | 21 +++++++++++-------- .../SignRecapTests.swift | 2 +- 4 files changed, 23 insertions(+), 14 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 2b984c576..a7d0b03d1 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -202,15 +202,15 @@ extension SignPresenter: SceneViewModel {} // MARK: - Authenticate request stub extension AuthRequestParams { static func stub( - domain: String = "service.invalid", + domain: String = "app.web3inbox", chains: [String] = ["eip155:1", "eip155:137"], nonce: String = "32891756", - aud: String = "https://service.invalid/login", + aud: String = "https://app.web3inbox.com/login", nbf: String? = nil, exp: String? = nil, - statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", + statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] + resources: [String]? = ["urn:recap:ewogICAiYXR0IjogewogICAgICAid2FsbGV0Y29ubmVjdC1ub3RpZnkiOiB7CiAgICAgICAgICJtYW5hZ2UtYWxsLWFwcHMvbm90aWZpY2F0aW9ucyI6IFtdLAogICAgICB9CiAgIH0KfQ==", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] ) -> AuthRequestParams { return AuthRequestParams( domain: domain, diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift index 57a14fe8c..7d2e8a5f8 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift @@ -12,6 +12,7 @@ struct SignRecap { enum Errors: Error { case invalidUrnPrefix case invalidRecapStructure + case invalidNamespaceFormat } init(urn: String) throws { @@ -25,6 +26,11 @@ struct SignRecap { throw Errors.invalidRecapStructure } + // Additional check for validating the namespace format within the `att` dictionary + guard decodedData.att?.keys.contains(where: { $0 == "eip155" }) ?? false else { + throw Errors.invalidNamespaceFormat + } + self.urn = urn self.recapData = decodedData } diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift index 7165ad8fa..8ca2bc217 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift @@ -3,19 +3,21 @@ import Foundation import Foundation -struct SignRecapBuilder { +import Foundation +struct SignRecapBuilder { enum BuilderError: Error { case nonEVMChainNamespace case emptySupportedChainsOrMethods - case noCommonChains } static func build(requestedSessionRecap urn: String, requestedChains: [String], supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SignRecap { + // Validate non-empty supported chains and methods guard !supportedEVMChains.isEmpty, !supportedMethods.isEmpty else { throw BuilderError.emptySupportedChainsOrMethods } + // Ensure all supported chains are EVM chains guard supportedEVMChains.allSatisfy({ $0.namespace == "eip155" }) else { throw BuilderError.nonEVMChainNamespace } @@ -25,24 +27,25 @@ struct SignRecapBuilder { // Find intersection of requestedChains and supportedEVMChains strings let commonChains = requestedChains.filter(supportedChainStrings.contains) - guard !commonChains.isEmpty else { - throw BuilderError.noCommonChains - } let requestedRecap = try SignRecap(urn: urn) - var filteredActions: [String: [String: [AnyCodable]]] = [:] + // Initialize eip155 actions to an empty dictionary to ensure eip155 entry is always present + var filteredActions: [String: [String: [AnyCodable]]] = ["eip155": [:]] - if let eip155Actions = requestedRecap.recapData.att?["eip155"] { + // Populate filteredActions with methods and intersected chains if there are common chains + if !commonChains.isEmpty { for method in supportedMethods { let actionKey = "request/\(method)" - if eip155Actions.keys.contains(actionKey) { + if requestedRecap.recapData.att?["eip155"]?.keys.contains(actionKey) ?? false { // Use only common chains for each supported method - filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": commonChains])] + filteredActions["eip155"]![actionKey] = [AnyCodable(["chains": commonChains])] } } } + // Regardless of whether there are common chains or supported methods, "eip155" is always present, potentially empty + let modifiedRecapData = SignRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) let encoder = JSONEncoder() guard let jsonData = try? encoder.encode(modifiedRecapData) else { diff --git a/Tests/WalletConnectSignTests/SignRecapTests.swift b/Tests/WalletConnectSignTests/SignRecapTests.swift index 5bbcdb454..f5f079c23 100644 --- a/Tests/WalletConnectSignTests/SignRecapTests.swift +++ b/Tests/WalletConnectSignTests/SignRecapTests.swift @@ -28,7 +28,7 @@ class SignRecapTests: XCTestCase { return } - XCTAssertEqual(sessionRecapError, SignRecap.Errors.invalidRecapStructure) + XCTAssertEqual(sessionRecapError, SignRecap.Errors.invalidNamespaceFormat) } } From 2a527ccebda43065f2866a41ffb50a01367dd8cd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 15 Feb 2024 09:41:49 +0100 Subject: [PATCH 381/814] savepoint --- .../Sign/SignClientTests.swift | 11 +++++---- .../Services/App/AuthResponseSubscriber.swift | 19 +++++++++------ .../Auth/Services/AuthPayloadBuilder.swift | 2 +- .../Auth/Services/SignRecap.swift | 7 +++--- .../Auth/Services/SignRecapBuilder.swift | 23 ++++++++----------- .../Auth/Services/Wallet/AuthResponder.swift | 9 +++++--- .../WalletConnectSign/Sign/SignClient.swift | 10 +++----- .../Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 5 ++-- .../AuthPayloadBuilderTests.swift | 19 ++++++++------- .../SignRecapBuilderTests.swift | 22 ------------------ .../SignRecapTests.swift | 14 +---------- 12 files changed, 55 insertions(+), 88 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index d46895f54..500a8e031 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -849,7 +849,7 @@ final class SignClientTests: XCTestCase { let account = Account(blockchain: Blockchain(chain)!, address: walletAccount.address)! - let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_sendTransaction", "personal_sign"]) let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: account) @@ -867,7 +867,8 @@ final class SignClientTests: XCTestCase { } .store(in: &publishers) dapp.authResponsePublisher.sink { (_, result) in - guard case .success(let session) = result else { XCTFail(); return } + guard case .success(let session) = result, + let session = session else { XCTFail(); return } XCTAssertEqual(session.accounts.count, 2) XCTAssertEqual(session.namespaces["eip155"]?.methods.count, 2) XCTAssertEqual(session.namespaces["eip155"]?.accounts.count, 2) @@ -977,7 +978,7 @@ final class SignClientTests: XCTestCase { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() - let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_sendTransaction", "personal_sign"]) let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) @@ -993,8 +994,8 @@ final class SignClientTests: XCTestCase { } .store(in: &publishers) dapp.authResponsePublisher.sink { [unowned self] (_, result) in - guard case .success(let session) = result else { XCTFail(); return } - + guard case .success(let session) = result, + let session = session else { XCTFail(); return } Task(priority: .high) { let request = try Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: chain) try await dapp.request(params: request) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index e7a0fbff1..42129c514 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -12,8 +12,10 @@ class AuthResponseSubscriber { private let sessionStore: WCSessionStorage private let kms: KeyManagementServiceProtocol private let sessionNamespaceBuilder: SessionNamespaceBuilder - - var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + authResponsePublisherSubject.eraseToAnyPublisher() + } init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -40,7 +42,7 @@ class AuthResponseSubscriber { networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } - onResponse?(payload.id, .failure(error)) + authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) @@ -58,12 +60,12 @@ class AuthResponseSubscriber { do { try await recoverAndVerifySignature(authRequestPayload: payload.request.authPayload, cacaos: cacaos) } catch { - onResponse?(requestId, .failure(error as! AuthError)) + authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) return } let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, authRequestPayload: authRequestPayload) - onResponse?(requestId, .success(session)) + authResponsePublisherSubject.send((requestId, .success(session))) } }.store(in: &publishers) @@ -107,7 +109,7 @@ class AuthResponseSubscriber { selfParticipant: Participant, pairingTopic: String, authRequestPayload: AuthPayload - ) throws -> Session { + ) throws -> Session? { let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) let agreementKeys = try kms.performKeyAgreement(selfPublicKey: selfPublicKey, peerPublicKey: response.responder.publicKey) @@ -123,7 +125,10 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) + guard let sessionNamespaces = try? sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) else { + logger.debug("Failed to create session from recap") + return nil + } let settleParams = SessionType.SettleParams( relay: relay, diff --git a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift index 4736f391a..1db2dc9b5 100644 --- a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift @@ -7,7 +7,7 @@ public struct AuthPayloadBuilder { public static func build(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { // Attempt to find a valid session recap URN from the resources guard let existingSessionRecapUrn = payload.resources?.first(where: { (try? SignRecap(urn: $0)) != nil }) else { - throw SignRecap.Errors.invalidRecapStructure + return payload } // Use SessionRecapBuilder to create a new session recap based on the existing valid URN diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift index 7d2e8a5f8..973378553 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift @@ -12,7 +12,6 @@ struct SignRecap { enum Errors: Error { case invalidUrnPrefix case invalidRecapStructure - case invalidNamespaceFormat } init(urn: String) throws { @@ -26,9 +25,9 @@ struct SignRecap { throw Errors.invalidRecapStructure } - // Additional check for validating the namespace format within the `att` dictionary - guard decodedData.att?.keys.contains(where: { $0 == "eip155" }) ?? false else { - throw Errors.invalidNamespaceFormat + // Validate the structure specifically for 'eip155' with 'request/' prefixed actions + guard let eip155Actions = decodedData.att?["eip155"], !eip155Actions.isEmpty else { + throw Errors.invalidRecapStructure } self.urn = urn diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift index 8ca2bc217..6ce80bb80 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift @@ -1,23 +1,19 @@ - -import Foundation - import Foundation -import Foundation struct SignRecapBuilder { + enum BuilderError: Error { case nonEVMChainNamespace case emptySupportedChainsOrMethods + case noCommonChains } static func build(requestedSessionRecap urn: String, requestedChains: [String], supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> SignRecap { - // Validate non-empty supported chains and methods guard !supportedEVMChains.isEmpty, !supportedMethods.isEmpty else { throw BuilderError.emptySupportedChainsOrMethods } - // Ensure all supported chains are EVM chains guard supportedEVMChains.allSatisfy({ $0.namespace == "eip155" }) else { throw BuilderError.nonEVMChainNamespace } @@ -27,25 +23,24 @@ struct SignRecapBuilder { // Find intersection of requestedChains and supportedEVMChains strings let commonChains = requestedChains.filter(supportedChainStrings.contains) + guard !commonChains.isEmpty else { + throw BuilderError.noCommonChains + } let requestedRecap = try SignRecap(urn: urn) - // Initialize eip155 actions to an empty dictionary to ensure eip155 entry is always present - var filteredActions: [String: [String: [AnyCodable]]] = ["eip155": [:]] + var filteredActions: [String: [String: [AnyCodable]]] = [:] - // Populate filteredActions with methods and intersected chains if there are common chains - if !commonChains.isEmpty { + if let eip155Actions = requestedRecap.recapData.att?["eip155"] { for method in supportedMethods { let actionKey = "request/\(method)" - if requestedRecap.recapData.att?["eip155"]?.keys.contains(actionKey) ?? false { + if eip155Actions.keys.contains(actionKey) { // Use only common chains for each supported method - filteredActions["eip155"]![actionKey] = [AnyCodable(["chains": commonChains])] + filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": commonChains])] } } } - // Regardless of whether there are common chains or supported methods, "eip155" is always present, potentially empty - let modifiedRecapData = SignRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) let encoder = JSONEncoder() guard let jsonData = try? encoder.encode(modifiedRecapData) else { diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 50d1648e5..1bd6b63c3 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -41,7 +41,7 @@ actor AuthResponder { self.sessionNamespaceBuilder = sessionNamespaceBuilder } - func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session { + func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) let (responseTopic, responseKeys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) @@ -111,7 +111,7 @@ actor AuthResponder { pairingTopic: String, request: SessionAuthenticateRequestParams, sessionTopic: String - ) throws -> Session { + ) throws -> Session? { let selfParticipant = response.responder @@ -123,7 +123,10 @@ actor AuthResponder { let relay = RelayProtocolOptions(protocol: "irn", data: nil) - let sessionNamespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) + guard let sessionNamespaces = try? sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) else { + logger.debug("Failed to create session from recap") + return nil + } let settleParams = SessionType.SettleParams( relay: relay, diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 2018fc57e..ace2199b2 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -109,8 +109,8 @@ public final class SignClient: SignClientProtocol { /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. /// /// Emited result may be an error. - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { - authResponsePublisherSubject.eraseToAnyPublisher() + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + authResposeSubscriber.authResponsePublisher } //--------------------------------------------------------------------------------- public var logsPublisher: AnyPublisher { @@ -173,7 +173,6 @@ public final class SignClient: SignClientProtocol { private let sessionExtendPublisherSubject = PassthroughSubject<(sessionTopic: String, date: Date), Never>() private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private var publishers = Set() @@ -328,7 +327,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message - public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session { + public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { try await authResponder.respond(requestId: requestId, auths: auths) } @@ -525,9 +524,6 @@ public final class SignClient: SignClientProtocol { sessionEngine.onSessionsUpdate = { [unowned self] sessions in sessionsPublisherSubject.send(sessions) } - authResposeSubscriber.onResponse = { [unowned self] (id, result) in - authResponsePublisherSubject.send((id, result)) - } authRequestSubscriber.onRequest = { [unowned self] request in authRequestPublisherSubject.send(request) } diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 7ee343597..1e9ab5ce6 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -24,7 +24,7 @@ public protocol SignClientProtocol { func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws func extend(topic: String) async throws - func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session + func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session? func buildSignedAuthObject(authPayload: AuthPayload, signature: CacaoSignature, account: Account) throws -> AuthObject func respond(topic: String, requestId: RPCID, response: RPCResult) async throws func emit(topic: String, event: Session.Event, chainId: Blockchain) async throws diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 71600eb10..8853f8cde 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -202,12 +202,11 @@ public class Web3WalletClient { } //---------------------------------------AUTH------------------------------------ - // TODO - add publishers for authenticated session /// For a wallet to respond on authentication request /// - Parameters: /// - requestId: authentication request id - /// - signature: CACAO signature of requested message - public func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session { + /// - auths: CACAO objects + public func approveSessionAuthenticate(requestId: RPCID, auths: [AuthObject]) async throws -> Session? { try await signClient.approveSessionAuthenticate(requestId: requestId, auths: auths) } diff --git a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift index 18eaef404..85aff88b0 100644 --- a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift +++ b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift @@ -21,14 +21,17 @@ class AuthPayloadBuilderTests: XCTestCase { } func testBuildWithNoValidSessionRecapUrn() throws { - let request = createSampleAuthPayload(resources: [invalidSessionRecapUrn, "other-resource"]) - - XCTAssertThrowsError(try AuthPayloadBuilder.build(payload: request, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods)) { error in - guard let error = error as? SignRecap.Errors else { - return XCTFail("Expected SessionRecap.Errors") - } - XCTAssertEqual(error, SignRecap.Errors.invalidRecapStructure) - } + let originalPayload = createSampleAuthPayload(resources: [invalidSessionRecapUrn, "other-resource"]) + + let supportedChains = [Blockchain("eip155:1")!] + let supportedMethods = ["eth_sendTransaction"] + + // When + let resultPayload = try AuthPayloadBuilder.build(payload: originalPayload, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + + // Then + XCTAssertEqual(resultPayload, originalPayload, "Expected the original payload to be returned when no valid session recap URN is found") + } func testBuildPreservesExtraResources() throws { diff --git a/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift b/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift index f5fe76f8c..cd69c8475 100644 --- a/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift @@ -91,26 +91,4 @@ class SignRecapBuilderTests: XCTestCase { XCTAssertFalse(result.recapData.att?["eip155"]?.keys.contains("request/extraUnsupportedMethod") ?? true, "Result should not contain 'extraUnsupportedMethod'") } - func testSignRecapBuilder_RecapWithNoMethodsIsValid() throws { - // Given a recap with no methods - let recapWithNoMethods: [String: [String: [String: [[String: [String]]]]]] = [ - "att": [ - "eip155": [:] // No methods - ] - ] - let encodedNoMethods = try! JSONEncoder().encode(recapWithNoMethods).base64EncodedString() - let urnWithNoMethods = "urn:recap:\(encodedNoMethods)" - - let requestedChains = ["eip155:1", "eip155:137"] - let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] - let supportedMethods = ["eth_sendTransaction", "personal_sign"] - - // When - let result = try SignRecapBuilder.build(requestedSessionRecap: urnWithNoMethods, requestedChains: requestedChains, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) - - // Then - XCTAssertTrue(result.recapData.att?["eip155"]?.isEmpty ?? false, "Recap should be considered valid even with no methods.") - } - - } diff --git a/Tests/WalletConnectSignTests/SignRecapTests.swift b/Tests/WalletConnectSignTests/SignRecapTests.swift index f5f079c23..9d056e173 100644 --- a/Tests/WalletConnectSignTests/SignRecapTests.swift +++ b/Tests/WalletConnectSignTests/SignRecapTests.swift @@ -28,19 +28,7 @@ class SignRecapTests: XCTestCase { return } - XCTAssertEqual(sessionRecapError, SignRecap.Errors.invalidNamespaceFormat) - } - } - - func testSignRecapInitializationSuccessWithNoMethods() throws { - // Encoded recap: {"att": {"eip155": {}}} - let recapUrn = "urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHt9fX0=" - - do { - let signRecap = try SignRecap(urn: recapUrn) - XCTAssertTrue(signRecap.methods.isEmpty, "Initialization should succeed with no methods.") - } catch { - XCTFail("Initialization should not fail for valid recap URN with no methods.") + XCTAssertEqual(sessionRecapError, SignRecap.Errors.invalidRecapStructure) } } From 24913047ddd13dc40d33b0a4986139206dcaa382 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 15 Feb 2024 10:21:11 +0100 Subject: [PATCH 382/814] add deprecation warnings to Auth Client --- .../Sign/SignClientTests.swift | 13 +--- Sources/Auth/AuthClient.swift | 9 +++ .../Services/App/AuthResponseSubscriber.swift | 16 +--- .../Auth/Services/Wallet/AuthResponder.swift | 28 +++++++ .../Sign/SignClientFactory.swift | 3 +- .../AuthTests/AppRespondSubscriberTests.swift | 75 ------------------- Tests/AuthTests/Mocks/AppMetadata.swift | 14 ---- Tests/AuthTests/Mocks/SignerFactoryMock.swift | 24 ------ Tests/AuthTests/Stubs/AuthRequestParams.swift | 16 ---- Tests/AuthTests/Stubs/MessageSignerMock.swift | 30 -------- .../Stubs/RequestSubscriptionPayload.swift | 13 ---- .../WalletRequestSubscriberTests.swift | 64 ---------------- 12 files changed, 45 insertions(+), 260 deletions(-) delete mode 100644 Tests/AuthTests/AppRespondSubscriberTests.swift delete mode 100644 Tests/AuthTests/Mocks/AppMetadata.swift delete mode 100644 Tests/AuthTests/Mocks/SignerFactoryMock.swift delete mode 100644 Tests/AuthTests/Stubs/AuthRequestParams.swift delete mode 100644 Tests/AuthTests/Stubs/MessageSignerMock.swift delete mode 100644 Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift delete mode 100644 Tests/AuthTests/WalletRequestSubscriberTests.swift diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 500a8e031..06a4e214a 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -918,7 +918,7 @@ final class SignClientTests: XCTestCase { // } func testEIP191SessionAuthenticateSignatureVerificationFailed() async { - let responseExpectation = expectation(description: "error response delivered") + let requestExpectation = expectation(description: "error response delivered") let uri = try! await dapp.authenticate(AuthRequestParams.stub()) try? await walletPairingClient.pair(uri: uri) @@ -931,17 +931,12 @@ final class SignClientTests: XCTestCase { let cacao = try! wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: invalidSignature, account: walletAccount) - _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao]) + await XCTAssertThrowsErrorAsync(try await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao])) + requestExpectation.fulfill() } } .store(in: &publishers) - dapp.authResponsePublisher.sink { (_, result) in - guard case let .failure(error) = result, - error == .signatureVerificationFailed else { XCTFail(); return } - responseExpectation.fulfill() - } - .store(in: &publishers) - await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [requestExpectation], timeout: InputConfig.defaultTimeout) } func testSessionAuthenticateUserRespondError() async { diff --git a/Sources/Auth/AuthClient.swift b/Sources/Auth/AuthClient.swift index 8189bdea0..34cad9e0c 100644 --- a/Sources/Auth/AuthClient.swift +++ b/Sources/Auth/AuthClient.swift @@ -6,6 +6,7 @@ import Combine /// Cannot be instantiated outside of the SDK /// /// Access via `Auth.instance` +@available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") public class AuthClient: AuthClientProtocol { // MARK: - Public Properties @@ -13,6 +14,7 @@ public class AuthClient: AuthClientProtocol { /// Publisher that sends authentication requests /// /// Wallet should subscribe on events in order to receive auth requests. + @available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") public var authRequestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { authRequestPublisherSubject.eraseToAnyPublisher() } @@ -22,11 +24,13 @@ public class AuthClient: AuthClientProtocol { /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. /// /// Emited result may be an error. + @available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } /// Publisher that sends web socket connection status + @available(*, deprecated, message: "Use Web3Wallet interface for managing socket connection status.") public let socketConnectionStatusPublisher: AnyPublisher /// An object that loggs SDK's errors and info messages @@ -67,6 +71,7 @@ public class AuthClient: AuthClientProtocol { /// For a dapp to send an authentication request to a wallet /// - Parameter params: Set of parameters required to request authentication /// - Parameter topic: Pairing topic that wallet already subscribes for + @available(*, deprecated, message: "Use SignClient for sending authentication requests.") public func request(_ params: RequestParams, topic: String) async throws { logger.debug("Requesting Authentication on existing pairing") try pairingRegisterer.validatePairingExistance(topic) @@ -77,22 +82,26 @@ public class AuthClient: AuthClientProtocol { /// - Parameters: /// - requestId: authentication request id /// - signature: CACAO signature of requested message + @available(*, deprecated, message: "Use Web3Wallet interface for responding to authentication requests.") public func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws { try await walletRespondService.respond(requestId: requestId, signature: signature, account: account) } /// For wallet to reject authentication request /// - Parameter requestId: authentication request id + @available(*, deprecated, message: "Use Web3Wallet interface for rejecting authentication requests.") public func reject(requestId: RPCID) async throws { try await walletRespondService.respondError(requestId: requestId) } /// Query pending authentication requests /// - Returns: Pending authentication requests + @available(*, deprecated, message: "Use SignClient for managing pending authentication requests.") public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { return try pendingRequestsProvider.getPendingRequests() } + @available(*, deprecated, message: "Use SignClient or Web3Wallet for message formatting.") public func formatMessage(payload: AuthPayload, address: String) throws -> String { return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(address: address)) } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 42129c514..150b30d04 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -58,7 +58,7 @@ class AuthResponseSubscriber { Task { do { - try await recoverAndVerifySignature(authRequestPayload: payload.request.authPayload, cacaos: cacaos) + try await recoverAndVerifySignature(cacaos: cacaos) } catch { authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) return @@ -71,7 +71,7 @@ class AuthResponseSubscriber { }.store(in: &publishers) } - private func recoverAndVerifySignature(authRequestPayload: AuthPayload, cacaos: [Cacao]) async throws { + private func recoverAndVerifySignature(cacaos: [Cacao]) async throws { try await cacaos.asyncForEach { [unowned self] cacao in guard let account = try? DIDPKH(did: cacao.p.iss).account, @@ -79,17 +79,6 @@ class AuthResponseSubscriber { else { throw AuthError.malformedResponseParams } - -// guard -// let recovered = try? messageFormatter.formatMessage( -// from: authRequestPayload.cacaoPayload(account: account), -// includeRecapInTheStatement: true -// ), -// recovered == message -// else { -// throw AuthError.messageCompromised -// } - do { try await signatureVerifier.verify( signature: cacao.s, @@ -100,7 +89,6 @@ class AuthResponseSubscriber { logger.error("Signature verification failed with: \(error.localizedDescription)") throw AuthError.signatureVerificationFailed } - } } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 1bd6b63c3..7bfa88f11 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -8,6 +8,8 @@ actor AuthResponder { } private let networkingInteractor: NetworkInteracting private let kms: KeyManagementService + private let messageFormatter: SIWECacaoFormatting + private let signatureVerifier: MessageVerifier private let rpcHistory: RPCHistory private let verifyContextStore: CodableStore private let logger: ConsoleLogging @@ -22,6 +24,8 @@ actor AuthResponder { logger: ConsoleLogging, kms: KeyManagementService, rpcHistory: RPCHistory, + signatureVerifier: MessageVerifier, + messageFormatter: SIWECacaoFormatting, verifyContextStore: CodableStore, walletErrorResponder: WalletErrorResponder, pairingRegisterer: PairingRegisterer, @@ -39,9 +43,12 @@ actor AuthResponder { self.metadata = metadata self.sessionStore = sessionStore self.sessionNamespaceBuilder = sessionNamespaceBuilder + self.signatureVerifier = signatureVerifier + self.messageFormatter = messageFormatter } func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { + try await recoverAndVerifySignature(cacaos: auths) let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) let (responseTopic, responseKeys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) @@ -155,6 +162,27 @@ actor AuthResponder { return session.publicRepresentation() } + + private func recoverAndVerifySignature(cacaos: [Cacao]) async throws { + try await cacaos.asyncForEach { [unowned self] cacao in + guard + let account = try? DIDPKH(did: cacao.p.iss).account, + let message = try? messageFormatter.formatMessage(from: cacao.p, includeRecapInTheStatement: true) + else { + throw AuthError.malformedResponseParams + } + do { + try await signatureVerifier.verify( + signature: cacao.s, + message: message, + account: account + ) + } catch { + logger.error("Signature verification failed with: \(error.localizedDescription)") + throw AuthError.signatureVerificationFailed + } + } + } } extension AuthResponder.Errors: LocalizedError { diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 0ec35c127..e20920689 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -101,9 +101,10 @@ public struct SignClientFactory { let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let sessionNameSpaceBuilder = SessionNamespaceBuilder(logger: logger) let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder) + let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) - let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) + let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) diff --git a/Tests/AuthTests/AppRespondSubscriberTests.swift b/Tests/AuthTests/AppRespondSubscriberTests.swift deleted file mode 100644 index 26d7ac29f..000000000 --- a/Tests/AuthTests/AppRespondSubscriberTests.swift +++ /dev/null @@ -1,75 +0,0 @@ -//import Foundation -//import XCTest -//@testable import Auth -//@testable import WalletConnectUtils -//@testable import WalletConnectNetworking -//@testable import WalletConnectKMS -//@testable import TestingUtils -//import JSONRPC -// -//class AppRespondSubscriberTests: XCTestCase { -// -// var networkingInteractor: NetworkingInteractorMock! -// var sut: AppRespondSubscriber! -// var messageFormatter: SIWECacaoFormatter! -// var rpcHistory: RPCHistory! -// let defaultTimeout: TimeInterval = 0.01 -// var messageVerifier: MessageVerifier! -// var pairingStorage: WCPairingStorageMock! -// var pairingRegisterer: PairingRegistererMock! -// -// override func setUp() { -// networkingInteractor = NetworkingInteractorMock() -// messageFormatter = SIWECacaoFormatter() -// messageVerifier = .stub() -// rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: RuntimeKeyValueStorage()) -// pairingStorage = WCPairingStorageMock() -// pairingRegisterer = PairingRegistererMock() -// sut = AppRespondSubscriber( -// networkingInteractor: networkingInteractor, -// logger: ConsoleLoggerMock(), -// rpcHistory: rpcHistory, -// signatureVerifier: messageVerifier, -// pairingRegisterer: pairingRegisterer, -// messageFormatter: messageFormatter) -// } -// -// func testMessageCompromisedFailure() { -// let messageExpectation = expectation(description: "receives response") -// -// // set history record for a request -// let topic = "topic" -// let requestId: RPCID = RPCID(1234) -// -// let params = AuthRequestParams.stub() -// let compromissedParams = AuthRequestParams.stub(nonce: "Compromissed nonce") -// -// XCTAssertNotEqual(params.payloadParams, compromissedParams.payloadParams) -// -// let request = RPCRequest(method: "wc_authRequest", params: AuthRequestParams.stub(), id: requestId.right!) -// try! rpcHistory.set(request, forTopic: topic, emmitedBy: .local) -// -// var messageId: RPCID! -// var result: Result! -// sut.onResponse = { id, r in -// messageId = id -// result = r -// messageExpectation.fulfill() -// } -// -// // subscribe on compromised cacao -// let cacaoHeader = CacaoHeader(t: "caip122") -// let cacaoPayload = try! compromissedParams.payloadParams.cacaoPayload(address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf") -// let cacaoSignature = CacaoSignature(t: .eip191, s: "") -// -// let cacao = Cacao(h: cacaoHeader, p: cacaoPayload, s: cacaoSignature) -// -// let response = RPCResponse(id: requestId, result: cacao) -// networkingInteractor.responsePublisherSubject.send((topic, request, response, Date(), nil)) -// -// wait(for: [messageExpectation], timeout: defaultTimeout) -// XCTAssertTrue(pairingRegisterer.isActivateCalled) -// XCTAssertEqual(result, .failure(AuthError.messageCompromised)) -// XCTAssertEqual(messageId, requestId) -// } -//} diff --git a/Tests/AuthTests/Mocks/AppMetadata.swift b/Tests/AuthTests/Mocks/AppMetadata.swift deleted file mode 100644 index ffa368454..000000000 --- a/Tests/AuthTests/Mocks/AppMetadata.swift +++ /dev/null @@ -1,14 +0,0 @@ -import Foundation -import WalletConnectPairing - -public extension AppMetadata { - static func stub() -> AppMetadata { - AppMetadata( - name: "Wallet Connect", - description: "A protocol to connect blockchain wallets to dapps.", - url: "https://walletconnect.com/", - icons: [], - redirect: AppMetadata.Redirect(native: "", universal: nil) - ) - } -} diff --git a/Tests/AuthTests/Mocks/SignerFactoryMock.swift b/Tests/AuthTests/Mocks/SignerFactoryMock.swift deleted file mode 100644 index f8110b951..000000000 --- a/Tests/AuthTests/Mocks/SignerFactoryMock.swift +++ /dev/null @@ -1,24 +0,0 @@ -import Foundation -import Auth - -struct SignerFactoryMock: SignerFactory { - - func createEthereumSigner() -> EthereumSigner { - return EthereumSignerMock() - } -} - -struct EthereumSignerMock: EthereumSigner { - - func sign(message: Data, with key: Data) throws -> EthereumSignature { - return EthereumSignature(v: 0, r: [], s: []) - } - - func recoverPubKey(signature: EthereumSignature, message: Data) throws -> Data { - return Data() - } - - func keccak256(_ data: Data) -> Data { - return Data() - } -} diff --git a/Tests/AuthTests/Stubs/AuthRequestParams.swift b/Tests/AuthTests/Stubs/AuthRequestParams.swift deleted file mode 100644 index 2e8e30821..000000000 --- a/Tests/AuthTests/Stubs/AuthRequestParams.swift +++ /dev/null @@ -1,16 +0,0 @@ -//@testable import Auth -//import Foundation -//import WalletConnectPairing -// -//extension AuthRequestParams { -// static func stub(nonce: String = "32891756") -> AuthRequestParams { -// let payload = AuthPayload.stub(nonce: nonce) -// return AuthRequestParams(requester: Requester.stub(), payloadParams: payload) -// } -//} -// -//extension AuthRequestParams.Requester { -// static func stub() -> AuthRequestParams.Requester { -// AuthRequestParams.Requester(publicKey: "", metadata: AppMetadata.stub()) -// } -//} diff --git a/Tests/AuthTests/Stubs/MessageSignerMock.swift b/Tests/AuthTests/Stubs/MessageSignerMock.swift deleted file mode 100644 index 45e77cd12..000000000 --- a/Tests/AuthTests/Stubs/MessageSignerMock.swift +++ /dev/null @@ -1,30 +0,0 @@ -import Foundation -@testable import WalletConnectSigner - -extension MessageVerifier { - - static func stub() -> MessageVerifier { - return MessageVerifier( - eip191Verifier: EIP191Verifier(crypto: Crypto()), - eip1271Verifier: EIP1271Verifier( - projectId: "", - httpClient: HTTPNetworkClient(host: ""), - crypto: Crypto() - ) - ) - } - - struct Crypto: CryptoProvider { - func derive(entropy: Data, path: [WalletConnectSigner.DerivationPath]) -> Data { - return Data() - } - - func keccak256(_ data: Data) -> Data { - return Data() - } - - func recoverPubKey(signature: EthereumSignature, message: Data) throws -> Data { - return Data() - } - } -} diff --git a/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift b/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift deleted file mode 100644 index db86a0a4e..000000000 --- a/Tests/AuthTests/Stubs/RequestSubscriptionPayload.swift +++ /dev/null @@ -1,13 +0,0 @@ -//import Foundation -//import JSONRPC -//import WalletConnectNetworking -//@testable import Auth -// -//extension AuthRequestParams { -// static func stub(id: RPCID, iat: String) -> AuthRequestParams { -// let appMetadata = AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) -// let requester = AuthRequestParams.Requester(publicKey: "", metadata: appMetadata) -// let payload = AuthPayload(requestParams: RequestParams.stub(), iat: iat) -// return AuthRequestParams(requester: requester, payloadParams: payload) -// } -//} diff --git a/Tests/AuthTests/WalletRequestSubscriberTests.swift b/Tests/AuthTests/WalletRequestSubscriberTests.swift deleted file mode 100644 index 50b38e863..000000000 --- a/Tests/AuthTests/WalletRequestSubscriberTests.swift +++ /dev/null @@ -1,64 +0,0 @@ -//import Foundation -//import XCTest -//import JSONRPC -//@testable import WalletConnectUtils -//@testable import WalletConnectNetworking -//@testable import Auth -//@testable import WalletConnectKMS -//@testable import TestingUtils -// -//class WalletRequestSubscriberTests: XCTestCase { -// var pairingRegisterer: PairingRegistererMock! -// var sut: WalletRequestSubscriber! -// var messageFormatter: SIWEMessageFormatterMock! -// var verifyContextStore: CodableStore! -// -// let defaultTimeout: TimeInterval = 0.01 -// -// override func setUp() { -// let networkingInteractor = NetworkingInteractorMock() -// pairingRegisterer = PairingRegistererMock() -// messageFormatter = SIWEMessageFormatterMock() -// verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") -// -// let walletErrorResponder = WalletErrorResponder( -// networkingInteractor: networkingInteractor, -// logger: ConsoleLoggerMock(), -// kms: KeyManagementServiceMock(), -// rpcHistory: RPCHistory(keyValueStore: CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "")) -// ) -// sut = WalletRequestSubscriber( -// networkingInteractor: networkingInteractor, -// logger: ConsoleLoggerMock(), -// kms: KeyManagementServiceMock(), -// walletErrorResponder: walletErrorResponder, -// pairingRegisterer: pairingRegisterer, -// verifyClient: VerifyClientMock(), -// verifyContextStore: verifyContextStore -// ) -// } -// -// func testSubscribeRequest() { -// let iat = ISO8601DateFormatter().string(from: Date()) -// let expectedPayload = AuthPayload(requestParams: .stub(), iat: iat) -// let expectedRequestId: RPCID = RPCID(1234) -// let messageExpectation = expectation(description: "receives formatted message") -// -// var requestId: RPCID! -// var requestPayload: AuthPayload! -// sut.onRequest = { result in -// requestId = result.request.id -// requestPayload = result.request.payload -// messageExpectation.fulfill() -// } -// -// let payload = RequestSubscriptionPayload(id: expectedRequestId, topic: "123", request: AuthRequestParams.stub(id: expectedRequestId, iat: iat), decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) -// -// pairingRegisterer.subject.send(payload) -// -// wait(for: [messageExpectation], timeout: defaultTimeout) -// XCTAssertTrue(pairingRegisterer.isReceivedCalled) -// XCTAssertEqual(requestPayload, expectedPayload) -// XCTAssertEqual(requestId, expectedRequestId) -// } -//} From 1a792ffec5f0f6bdf75db0cb3fac6d50d85d7aa5 Mon Sep 17 00:00:00 2001 From: Talha Date: Thu, 15 Feb 2024 23:25:37 -0600 Subject: [PATCH 383/814] replaced all instances of M1 runners with Github M1 runners --- .github/workflows/build_artifacts.yml | 3 +-- .github/workflows/cd.yml | 3 +-- .github/workflows/ci.yml | 6 ++---- .github/workflows/cocoapods.yml | 3 +-- .github/workflows/deploy_pages.yml | 3 +-- .github/workflows/release.yml | 3 +-- 6 files changed, 7 insertions(+), 14 deletions(-) diff --git a/.github/workflows/build_artifacts.yml b/.github/workflows/build_artifacts.yml index 94bff827b..8cfb69080 100644 --- a/.github/workflows/build_artifacts.yml +++ b/.github/workflows/build_artifacts.yml @@ -16,8 +16,7 @@ on: jobs: build: - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge timeout-minutes: 15 steps: diff --git a/.github/workflows/cd.yml b/.github/workflows/cd.yml index 1f26d47f9..6c110f787 100644 --- a/.github/workflows/cd.yml +++ b/.github/workflows/cd.yml @@ -13,8 +13,7 @@ env: PACKAGE_VERSION: ${{ github.event.pull_request.title }} jobs: set-user-agent: - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge steps: - uses: actions/checkout@v2 with: diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index d021cfad9..090b11b3d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -22,8 +22,7 @@ jobs: prepare: needs: authorize - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge steps: - uses: actions/checkout@v3 with: @@ -36,8 +35,7 @@ jobs: test: needs: prepare - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge timeout-minutes: 15 strategy: fail-fast: false diff --git a/.github/workflows/cocoapods.yml b/.github/workflows/cocoapods.yml index 0d533c0c9..3bf3e9a75 100644 --- a/.github/workflows/cocoapods.yml +++ b/.github/workflows/cocoapods.yml @@ -5,8 +5,7 @@ on: types: [ published ] jobs: set-user-agent: - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge steps: - uses: actions/checkout@v2 with: diff --git a/.github/workflows/deploy_pages.yml b/.github/workflows/deploy_pages.yml index 9901d0c0d..77b361056 100644 --- a/.github/workflows/deploy_pages.yml +++ b/.github/workflows/deploy_pages.yml @@ -27,8 +27,7 @@ jobs: environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge steps: - name: Checkout uses: actions/checkout@v3 diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 02513dfa8..19e18a18f 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -13,8 +13,7 @@ on: jobs: build: - runs-on: - group: apple-silicon + runs-on: macos-latest-xlarge steps: - uses: actions/checkout@v3 From 5d9a4127ce2d8b7c478a20a1afb1be1c8278cc1b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Feb 2024 12:55:25 +0100 Subject: [PATCH 384/814] savepoint --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index dce282c07..e68b05d5d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -106,7 +106,12 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! - let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) + do { + let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) + } catch { + await reject() + throw + } let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) From b71581542e6626d13a5677686c9edc8cff3d46f4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 17 Feb 2024 16:40:49 +0100 Subject: [PATCH 385/814] fix build --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index e68b05d5d..96422ee9d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -106,13 +106,13 @@ final class AuthRequestPresenter: ObservableObject { let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! + var supportedAuthPayload: AuthPayload! do { - let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) + supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) } catch { - await reject() - throw + Task { await reject() } + throw error } - let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) let signature = try messageSigner.sign( From 6a1181e5baf93ef8f67b2d78302ddac6328167a7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Feb 2024 10:07:26 +0100 Subject: [PATCH 386/814] fix build --- .../Wallet/SessionProposal/SessionProposalInteractor.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index 998728cb6..7c6fe2cc0 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -40,7 +40,7 @@ final class SessionProposalInteractor { AlertPresenter.present(message: error.localizedDescription, type: .error) return false } - try await Web3Wallet.instance.approve(proposalId: proposal.id, namespaces: sessionNamespaces, sessionProperties: proposal.sessionProperties) + _ = try await Web3Wallet.instance.approve(proposalId: proposal.id, namespaces: sessionNamespaces, sessionProperties: proposal.sessionProperties) if let uri = proposal.proposer.redirect?.native { WalletConnectRouter.goBack(uri: uri) return false @@ -50,7 +50,7 @@ final class SessionProposalInteractor { } func reject(proposal: Session.Proposal, reason: RejectionReason = .userRejected) async throws { - try await Web3Wallet.instance.reject(proposalId: proposal.id, reason: .userRejected) + try await Web3Wallet.instance.rejectSession(proposalId: proposal.id, reason: .userRejected) /* Redirect */ if let uri = proposal.proposer.redirect?.native { WalletConnectRouter.goBack(uri: uri) From 6164a9dbcbe7cfb62c9749284554feb9e5d14875 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Feb 2024 10:33:35 +0100 Subject: [PATCH 387/814] improve update test --- Example/IntegrationTests/Sign/SignClientTests.swift | 8 ++++++-- Example/IntegrationTests/Stubs/Stubs.swift | 4 ++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 56f2c4342..4bc4d2f7c 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -329,10 +329,14 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) dapp.sessionSettlePublisher.sink { [unowned self] settledSession in Task(priority: .high) { - try! await wallet.update(topic: settledSession.topic, namespaces: sessionNamespaces) + let updateNamespace = SessionNamespace.make( + toRespond: ProposalNamespace.stubRequired(chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!]) + ) + try! await wallet.update(topic: settledSession.topic, namespaces: updateNamespace) } }.store(in: &publishers) - dapp.sessionUpdatePublisher.sink { _, _ in + dapp.sessionUpdatePublisher.sink { _, namespace in + XCTAssertEqual(namespace.values.first?.accounts.count, 2) expectation.fulfill() }.store(in: &publishers) let uri = try! await dappPairingClient.create() diff --git a/Example/IntegrationTests/Stubs/Stubs.swift b/Example/IntegrationTests/Stubs/Stubs.swift index 366d8970f..7d8cb9172 100644 --- a/Example/IntegrationTests/Stubs/Stubs.swift +++ b/Example/IntegrationTests/Stubs/Stubs.swift @@ -1,10 +1,10 @@ import WalletConnectSign extension ProposalNamespace { - static func stubRequired() -> [String: ProposalNamespace] { + static func stubRequired(chains: Set = [Blockchain("eip155:1")!]) -> [String: ProposalNamespace] { return [ "eip155": ProposalNamespace( - chains: [Blockchain("eip155:1")!], + chains: chains, methods: ["personal_sign", "eth_sendTransaction"], events: ["any"]) ] From 30db6ce0251addbba0f2afaa018b19d8cace9284 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Feb 2024 11:51:52 +0100 Subject: [PATCH 388/814] unregister push on logout --- .../Client/Wallet/NotifyClient.swift | 1 + Sources/WalletConnectPush/PushClient.swift | 10 +++- .../WalletConnectPush/PushClientFactory.swift | 3 +- .../WalletConnectPush/UnregisterService.swift | 55 +++++++++++++++++++ 4 files changed, 67 insertions(+), 2 deletions(-) create mode 100644 Sources/WalletConnectPush/UnregisterService.swift diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 6b5aa22fc..618515d07 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -106,6 +106,7 @@ public class NotifyClient { try await identityClient.unregister(account: account) notifyWatcherAgreementKeysProvider.removeAgreement(account: account) try notifyStorage.clearDatabase(account: account) + Task { try await pushClient.unregister()} notifyAccountProvider.logout() subscriptionWatcher.stop() } diff --git a/Sources/WalletConnectPush/PushClient.swift b/Sources/WalletConnectPush/PushClient.swift index 2c378b3e6..8d50aff12 100644 --- a/Sources/WalletConnectPush/PushClient.swift +++ b/Sources/WalletConnectPush/PushClient.swift @@ -3,14 +3,18 @@ import Combine public class PushClient: PushClientProtocol { private let registerService: PushRegisterService + private let unregisterService: UnregisterService private let logger: ConsoleLogging public var logsPublisher: AnyPublisher { return logger.logsPublisher } - init(registerService: PushRegisterService, logger: ConsoleLogging) { + init(registerService: PushRegisterService, + logger: ConsoleLogging, + unregisterService: UnregisterService) { self.registerService = registerService + self.unregisterService = unregisterService self.logger = logger } @@ -18,6 +22,10 @@ public class PushClient: PushClientProtocol { try await registerService.register(deviceToken: deviceToken, alwaysRaw: enableEncrypted) } + public func unregister() async throws { + try await unregisterService.unregister() + } + #if DEBUG public func register(deviceToken: String) async throws { try await registerService.register(deviceToken: deviceToken, alwaysRaw: true) diff --git a/Sources/WalletConnectPush/PushClientFactory.swift b/Sources/WalletConnectPush/PushClientFactory.swift index 8a7a871cb..ab1911d95 100644 --- a/Sources/WalletConnectPush/PushClientFactory.swift +++ b/Sources/WalletConnectPush/PushClientFactory.swift @@ -42,7 +42,8 @@ public struct PushClientFactory { let pushAuthenticator = PushAuthenticator(clientIdStorage: clientIdStorage, pushHost: pushHost) let registerService = PushRegisterService(httpClient: httpClient, projectId: projectId, clientIdStorage: clientIdStorage, pushAuthenticator: pushAuthenticator, logger: logger, environment: environment) + let unregisterService = UnregisterService(httpClient: httpClient, projectId: projectId, clientIdStorage: clientIdStorage, pushAuthenticator: pushAuthenticator, logger: logger, pushHost: pushHost, environment: environment) - return PushClient(registerService: registerService, logger: logger) + return PushClient(registerService: registerService, logger: logger, unregisterService: unregisterService) } } diff --git a/Sources/WalletConnectPush/UnregisterService.swift b/Sources/WalletConnectPush/UnregisterService.swift new file mode 100644 index 000000000..653bb6719 --- /dev/null +++ b/Sources/WalletConnectPush/UnregisterService.swift @@ -0,0 +1,55 @@ +import Foundation + +actor UnregisterService { + private let httpClient: HTTPClient + private let projectId: String + private let logger: ConsoleLogging + private let environment: APNSEnvironment + private let pushAuthenticator: PushAuthenticating + private let clientIdStorage: ClientIdStoring + private let pushHost: String + + init(httpClient: HTTPClient, + projectId: String, + clientIdStorage: ClientIdStoring, + pushAuthenticator: PushAuthenticating, + logger: ConsoleLogging, + pushHost: String, + environment: APNSEnvironment) { + self.httpClient = httpClient + self.clientIdStorage = clientIdStorage + self.pushAuthenticator = pushAuthenticator + self.projectId = projectId + self.logger = logger + self.pushHost = pushHost + self.environment = environment + } + + func unregister() async throws { + let pushAuthToken = try pushAuthenticator.createAuthToken() + let clientId = try clientIdStorage.getClientId() + + guard let url = URL(string: "https://\(pushHost)/\(projectId)/clients/\(clientId)") else { + logger.error("Invalid URL") + return + } + + var request = URLRequest(url: url) + request.httpMethod = "DELETE" + request.addValue("\(pushAuthToken)", forHTTPHeaderField: "Authorization") + + do { + let (_, response) = try await URLSession.shared.data(for: request) + + guard let httpResponse = response as? HTTPURLResponse, httpResponse.statusCode == 200 else { + logger.error("Failed to unregister from Push Server") + throw NSError(domain: "UnregisterService", code: 0, userInfo: [NSLocalizedDescriptionKey: "Failed to unregister"]) + } + + logger.debug("Successfully unregistered from Push Server") + } catch { + logger.error("Push Server unregistration error: \(error.localizedDescription)") + throw error + } + } +} From f1c63af7438bc87ee20625e3ce4241f13c547fda Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Feb 2024 13:55:07 +0100 Subject: [PATCH 389/814] fix typo --- Sources/WalletConnectSign/RejectionReason.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/RejectionReason.swift b/Sources/WalletConnectSign/RejectionReason.swift index 6044f6075..df5a6a800 100644 --- a/Sources/WalletConnectSign/RejectionReason.swift +++ b/Sources/WalletConnectSign/RejectionReason.swift @@ -6,7 +6,7 @@ public enum RejectionReason { case unsupportedChains case unsupportedMethods case unsupportedAccounts - case upsupportedEvents + case unsupportedEvents } internal extension RejectionReason { @@ -18,7 +18,7 @@ internal extension RejectionReason { return SignReasonCode.unsupportedChains case .unsupportedMethods: return SignReasonCode.userRejectedMethods - case .upsupportedEvents: + case .unsupportedEvents: return SignReasonCode.userRejectedEvents case .unsupportedAccounts: return SignReasonCode.unsupportedAccounts @@ -36,7 +36,7 @@ public extension RejectionReason { case .requiredMethodsNotSatisfied: self = .unsupportedMethods case .requiredEventsNotSatisfied: - self = .upsupportedEvents + self = .unsupportedEvents case .emptySessionNamespacesForbidden: self = .unsupportedAccounts } From aa4a7a82e2bd84131e6394c96216d4c4468d05d7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Feb 2024 20:26:25 +0100 Subject: [PATCH 390/814] expose cacao at public interface --- .../Auth/Services/App/AuthResponseSubscriber.swift | 6 +++--- Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 150b30d04..5f2dd52f4 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -12,8 +12,8 @@ class AuthResponseSubscriber { private let sessionStore: WCSessionStorage private let kms: KeyManagementServiceProtocol private let sessionNamespaceBuilder: SessionNamespaceBuilder - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result<(Session?, [Cacao]), AuthError>), Never>() + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result<(Session?, [Cacao]), AuthError>), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } @@ -65,7 +65,7 @@ class AuthResponseSubscriber { } let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, authRequestPayload: authRequestPayload) - authResponsePublisherSubject.send((requestId, .success(session))) + authResponsePublisherSubject.send((requestId, .success((session, cacaos)))) } }.store(in: &publishers) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index ace2199b2..8c67a75de 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -109,7 +109,7 @@ public final class SignClient: SignClientProtocol { /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. /// /// Emited result may be an error. - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result<(Session?, [Cacao]), AuthError>), Never> { authResposeSubscriber.authResponsePublisher } //--------------------------------------------------------------------------------- From 9d9909e763744ac2626db9004dce5bfbc2531f7d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Feb 2024 09:41:40 +0100 Subject: [PATCH 391/814] add empty object --- Sources/WalletConnectUtils/SIWE/RecapFactory.swift | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift index 8aacaedc0..695cae0a2 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift @@ -1,13 +1,14 @@ import Foundation +fileprivate struct Empty: Codable { } public class RecapFactory { - static public func createRecap(resource: String, actions: [String]) -> [String: [String: [String: [String]]]] { - var recap: [String: [String: [String: [String]]]] = ["att": [:]] + static public func createRecap(resource: String, actions: [String]) -> [String: [String: [String: [AnyCodable]]]] { + var recap: [String: [String: [String: [AnyCodable]]]] = ["att": [:]] - var resourceRecap: [String: [String]] = [:] + var resourceRecap: [String: [AnyCodable]] = [:] for action in actions { - resourceRecap[action] = [] + resourceRecap[action] = [AnyCodable(Empty())] } recap["att"]![resource] = resourceRecap From 6c7613d59df053c548b0f46947a41b82bdcb9dae Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Feb 2024 12:37:37 +0100 Subject: [PATCH 392/814] fix tests --- Sources/WalletConnectUtils/SIWE/RecapFactory.swift | 2 +- Tests/WalletConnectUtilsTests/RecapFactoryTests.swift | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift index 695cae0a2..f7856de5f 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift @@ -1,7 +1,7 @@ import Foundation -fileprivate struct Empty: Codable { } public class RecapFactory { + struct Empty: Codable { } static public func createRecap(resource: String, actions: [String]) -> [String: [String: [String: [AnyCodable]]]] { var recap: [String: [String: [String: [AnyCodable]]]] = ["att": [:]] diff --git a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift index bbf52403f..f187f0e65 100644 --- a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift @@ -9,11 +9,11 @@ class RecapFactoryTests: XCTestCase { let recap = RecapFactory.createRecap(resource: resource, actions: actions) - let expectedOutput: [String: [String: [String: [String]]]] = [ + let expectedOutput: [String: [String: [String: [AnyCodable]]]] = [ "att": [ "eip155:1": [ - "request/eth_sendTransaction": [], - "request/personal_sign": [] + "request/eth_sendTransaction": [AnyCodable(RecapFactory.Empty())], + "request/personal_sign": [AnyCodable(RecapFactory.Empty())] ] ] ] From 51481644142038eb14a0b519a51d8a56503b494a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Feb 2024 12:38:06 +0100 Subject: [PATCH 393/814] rename object --- Sources/WalletConnectUtils/SIWE/RecapFactory.swift | 4 ++-- Tests/WalletConnectUtilsTests/RecapFactoryTests.swift | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift index f7856de5f..a8eb06134 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapFactory.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapFactory.swift @@ -1,14 +1,14 @@ import Foundation public class RecapFactory { - struct Empty: Codable { } + struct EmptyObject: Codable { } static public func createRecap(resource: String, actions: [String]) -> [String: [String: [String: [AnyCodable]]]] { var recap: [String: [String: [String: [AnyCodable]]]] = ["att": [:]] var resourceRecap: [String: [AnyCodable]] = [:] for action in actions { - resourceRecap[action] = [AnyCodable(Empty())] + resourceRecap[action] = [AnyCodable(EmptyObject())] } recap["att"]![resource] = resourceRecap diff --git a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift index f187f0e65..8460d1296 100644 --- a/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapFactoryTests.swift @@ -12,8 +12,8 @@ class RecapFactoryTests: XCTestCase { let expectedOutput: [String: [String: [String: [AnyCodable]]]] = [ "att": [ "eip155:1": [ - "request/eth_sendTransaction": [AnyCodable(RecapFactory.Empty())], - "request/personal_sign": [AnyCodable(RecapFactory.Empty())] + "request/eth_sendTransaction": [AnyCodable(RecapFactory.EmptyObject())], + "request/personal_sign": [AnyCodable(RecapFactory.EmptyObject())] ] ] ] From 8df761fb5387e9e25826ad60adf1e3e22e3afbea Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Feb 2024 13:13:32 +0100 Subject: [PATCH 394/814] update capbox recap --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index a7d0b03d1..b900d5a19 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -210,7 +210,7 @@ extension AuthRequestParams { exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", requestId: String? = nil, - resources: [String]? = ["urn:recap:ewogICAiYXR0IjogewogICAgICAid2FsbGV0Y29ubmVjdC1ub3RpZnkiOiB7CiAgICAgICAgICJtYW5hZ2UtYWxsLWFwcHMvbm90aWZpY2F0aW9ucyI6IFtdLAogICAgICB9CiAgIH0KfQ==", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] + resources: [String]? = ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20vYWxsLWFwcHMiOnsiY3J1ZC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkL3N1YnNjcmlwdGlvbnMiOlt7fV19fX0K", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] ) -> AuthRequestParams { return AuthRequestParams( domain: domain, From 2dda8080972551da77c5ad1324cec4d45c5a2ff6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Feb 2024 13:21:37 +0100 Subject: [PATCH 395/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 5 ++++- .../Auth/Services/App/AuthResponseSubscriber.swift | 2 +- .../Auth/Services/Wallet/AuthResponder.swift | 2 +- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index b900d5a19..43f2d36f0 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -144,7 +144,10 @@ extension SignPresenter { .receive(on: DispatchQueue.main) .sink { [unowned self] response in switch response.result { - case .success(_): + case .success(let (session, _)): + if session == nil { + AlertPresenter.present(message: "Wallet Succesfully Authenticated", type: .success) + } break case .failure(let error): AlertPresenter.present(message: error.localizedDescription, type: .error) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 5f2dd52f4..24dfc31a4 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -114,7 +114,7 @@ class AuthResponseSubscriber { let relay = RelayProtocolOptions(protocol: "irn", data: nil) guard let sessionNamespaces = try? sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) else { - logger.debug("Failed to create session from recap") + logger.debug("Cacao doesn't contain valid Sign Recap, session won't be created") return nil } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index 7bfa88f11..bec7e6502 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -131,7 +131,7 @@ actor AuthResponder { let relay = RelayProtocolOptions(protocol: "irn", data: nil) guard let sessionNamespaces = try? sessionNamespaceBuilder.buildSessionNamespaces(cacaos: response.cacaos) else { - logger.debug("Failed to create session from recap") + logger.debug("Cacao doesn't contain valid Sign Recap, session won't be created") return nil } From 87644dffafeaef0d444c4a709b5441018c59737d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Feb 2024 13:21:49 +0100 Subject: [PATCH 396/814] fix build --- .../WalletConnectPairing/Services/Wallet/WalletPairService.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index e9dea0198..fec5ff6d6 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -93,6 +93,7 @@ extension WalletPairService.Errors: LocalizedError { switch self { case .pairingAlreadyExist(let topic): return "Pairing with topic (\(topic)) is already active" case .networkNotConnected: return "Pairing failed. You seem to be offline" + case .noPendingRequest: return "No pending requests" } } } From 6c1f139e489c06ced3d6dd3800bb49466f5d7c13 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 12:32:57 +0100 Subject: [PATCH 397/814] discard last pairing commit --- .../Services/Wallet/WalletPairService.swift | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index fec5ff6d6..7c04a0acc 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -4,7 +4,6 @@ actor WalletPairService { enum Errors: Error { case pairingAlreadyExist(topic: String) case networkNotConnected - case noPendingRequest } let networkingInteractor: NetworkInteracting @@ -31,7 +30,7 @@ actor WalletPairService { logger.debug("Pairing with uri: \(uri)") guard try !pairingHasPendingRequest(for: uri.topic) else { logger.debug("Pairing with topic (\(uri.topic)) has pending request") - throw Errors.noPendingRequest + return } let pairing = WCPairing(uri: uri) @@ -93,7 +92,6 @@ extension WalletPairService.Errors: LocalizedError { switch self { case .pairingAlreadyExist(let topic): return "Pairing with topic (\(topic)) is already active" case .networkNotConnected: return "Pairing failed. You seem to be offline" - case .noPendingRequest: return "No pending requests" } } } From 8ad624eb74d8d9d3a215d5b3021f059846e6400f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 12:33:25 +0100 Subject: [PATCH 398/814] do not activate pairing on request received --- .../Auth/Services/Wallet/AuthRequestSubscriber.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index a7ce082d0..ecc44bb78 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -44,7 +44,7 @@ class AuthRequestSubscriber { } if var pairing = pairingStore.getPairing(forTopic: payload.topic) { - pairing.activate() + pairing.receivedRequest() pairingStore.setPairing(pairing) } logger.debug("AuthRequestSubscriber: Received request") From e31e5e4087c3f4a710540cbced8b0d7262d21dcc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 12:43:57 +0100 Subject: [PATCH 399/814] savepoint --- .../WalletConnectNotify/Client/Wallet/NotifyClient.swift | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 618515d07..7da6257da 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -103,10 +103,12 @@ public class NotifyClient { } public func unregister(account: Account) async throws { - try await identityClient.unregister(account: account) + if identityClient.isIdentityRegistered(account: account) { + try await identityClient.unregister(account: account) + } notifyWatcherAgreementKeysProvider.removeAgreement(account: account) try notifyStorage.clearDatabase(account: account) - Task { try await pushClient.unregister()} + try await pushClient.unregister() notifyAccountProvider.logout() subscriptionWatcher.stop() } From 85be3707003551491b357a7a92cbbf8629893dd6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 12:49:39 +0100 Subject: [PATCH 400/814] pairing indempotency for session authenticate --- .../Services/Wallet/WalletPairService.swift | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index 7c04a0acc..2592d010d 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -64,13 +64,14 @@ extension WalletPairService { (record.topic == pairing.topic) ? record.request : nil } - if let pendingRequest = pendingRequests.first { - networkingInteractor.handleHistoryRequest(topic: topic, request: pendingRequest) - return true + + guard !pendingRequests.isEmpty else { return false } + pendingRequests.forEach { request in + networkingInteractor.handleHistoryRequest(topic: topic, request: request) } - return false + return true } - + private func resolveNetworkConnectionStatus() async -> NetworkConnectionStatus { return await withCheckedContinuation { continuation in let cancellable = networkingInteractor.networkConnectionStatusPublisher.sink { value in From 16e5ac76928d63cd0662c47c20d4be4f66e3c81d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 13:19:25 +0100 Subject: [PATCH 401/814] wallet fixes --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 15 ++++++++++----- .../Wallet/Main/MainPresenter.swift | 9 +++++++++ 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 96422ee9d..01813b92f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -16,9 +16,8 @@ final class AuthRequestPresenter: ObservableObject { } func buildFormattedMessages(request: AuthenticationRequest, account: Account) -> [(String, String)] { - request.payload.chains.enumerated().compactMap { index, chain in - guard let blockchain = Blockchain(chain), - let chainAccount = Account(blockchain: blockchain, address: account.address) else { + getCommonAndRequestedChainsIntersection().enumerated().compactMap { index, chain in + guard let chainAccount = Account(blockchain: chain, address: account.address) else { return nil } guard let formattedMessage = try? Web3Wallet.instance.formatAuthMessage(payload: request.payload, account: chainAccount) else { @@ -102,9 +101,9 @@ final class AuthRequestPresenter: ObservableObject { private func buildAuthObjects() throws -> [AuthObject] { var auths = [AuthObject]() - try request.payload.chains.forEach { chain in + try getCommonAndRequestedChainsIntersection().forEach { chain in - let account = Account(blockchain: Blockchain(chain)!, address: importAccount.account.address)! + let account = Account(blockchain: chain, address: importAccount.account.address)! var supportedAuthPayload: AuthPayload! do { @@ -127,6 +126,12 @@ final class AuthRequestPresenter: ObservableObject { return auths } + func getCommonAndRequestedChainsIntersection() -> Set { + let requestedChains: Set = Set(request.payload.chains.compactMap { Blockchain($0) }) + let supportedChains: Set = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + return requestedChains.intersection(supportedChains) + } + func dismiss() { router.dismiss() } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift index f0dd6382a..372a3437d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Main/MainPresenter.swift @@ -1,6 +1,7 @@ import UIKit import Combine import SwiftUI +import WalletConnectUtils final class MainPresenter { private let interactor: MainInteractor @@ -62,6 +63,14 @@ extension MainPresenter { interactor.authenticateRequestPublisher .receive(on: DispatchQueue.main) .sink { [unowned self] result in + let requestedChains: Set = Set(result.request.payload.chains.compactMap { Blockchain($0) }) + let supportedChains: Set = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + // Check if there's an intersection between the requestedChains and supportedChains + let commonChains = requestedChains.intersection(supportedChains) + guard !commonChains.isEmpty else { + AlertPresenter.present(message: "No common chains", type: .error) + return + } router.present(request: result.request, importAccount: importAccount, context: result.context) } .store(in: &disposeBag) From e1dd079762034edaa56d7403b0c10b3180cbf799 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 14:55:15 +0100 Subject: [PATCH 402/814] update tests --- .../xcschemes/CommonsTests.xcscheme | 53 ++++ Package.swift | 3 - .../SubscriptionWatcherTests.swift | 6 +- .../AppPairServiceTests.swift | 2 +- .../ExpirationServiceTests.swift | 2 +- .../Mocks/AuthClientMock.swift | 50 ---- .../Mocks/PairingClientMock.swift | 49 ---- Tests/Web3WalletTests/Mocks/ReasonMock.swift | 12 - .../Mocks/SignClientMock.swift | 201 ------------- Tests/Web3WalletTests/Web3WalletTests.swift | 274 ------------------ 10 files changed, 58 insertions(+), 594 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/CommonsTests.xcscheme delete mode 100644 Tests/Web3WalletTests/Mocks/AuthClientMock.swift delete mode 100644 Tests/Web3WalletTests/Mocks/PairingClientMock.swift delete mode 100644 Tests/Web3WalletTests/Mocks/ReasonMock.swift delete mode 100644 Tests/Web3WalletTests/Mocks/SignClientMock.swift delete mode 100644 Tests/Web3WalletTests/Web3WalletTests.swift diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/CommonsTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/CommonsTests.xcscheme new file mode 100644 index 000000000..141246c9c --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/CommonsTests.xcscheme @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Package.swift b/Package.swift index b5d456d6c..024d7f6e9 100644 --- a/Package.swift +++ b/Package.swift @@ -137,9 +137,6 @@ let package = Package( .testTarget( name: "WalletConnectSignTests", dependencies: ["WalletConnectSign", "WalletConnectUtils", "TestingUtils", "WalletConnectVerify"]), - .testTarget( - name: "Web3WalletTests", - dependencies: ["Web3Wallet", "TestingUtils"]), .testTarget( name: "WalletConnectPairingTests", dependencies: ["WalletConnectPairing", "TestingUtils"]), diff --git a/Tests/NotifyTests/SubscriptionWatcherTests.swift b/Tests/NotifyTests/SubscriptionWatcherTests.swift index a00bd7362..f38a6e28a 100644 --- a/Tests/NotifyTests/SubscriptionWatcherTests.swift +++ b/Tests/NotifyTests/SubscriptionWatcherTests.swift @@ -35,7 +35,7 @@ class SubscriptionWatcherTests: XCTestCase { try await sut.start() - wait(for: [expectation], timeout: 0.5) + await fulfillment(of: [expectation], timeout: 0.5) } @@ -51,7 +51,7 @@ class SubscriptionWatcherTests: XCTestCase { await mockNotificationCenter.post(name: UIApplication.willEnterForegroundNotification) - wait(for: [watchSubscriptionsExpectation], timeout: 0.5) + await fulfillment(of: [watchSubscriptionsExpectation], timeout: 0.5) } func testTimerTriggeringWatchSubscriptionsMultipleTimes() async throws { @@ -66,6 +66,6 @@ class SubscriptionWatcherTests: XCTestCase { try await sut.start() - wait(for: [expectation], timeout: 0.5) + await fulfillment(of: [expectation], timeout: 0.5) } } diff --git a/Tests/WalletConnectPairingTests/AppPairServiceTests.swift b/Tests/WalletConnectPairingTests/AppPairServiceTests.swift index d0cb8f9b9..9839d5192 100644 --- a/Tests/WalletConnectPairingTests/AppPairServiceTests.swift +++ b/Tests/WalletConnectPairingTests/AppPairServiceTests.swift @@ -26,7 +26,7 @@ final class AppPairServiceTests: XCTestCase { } func testCreate() async { - let uri = try! await service.create() + let uri = try! await service.create(supportedMethods: nil) XCTAssert(cryptoMock.hasSymmetricKey(for: uri.topic), "Proposer must store the symmetric key matching the URI.") XCTAssert(storageMock.hasPairing(forTopic: uri.topic), "The engine must store a pairing after creating one") XCTAssert(networkingInteractor.didSubscribe(to: uri.topic), "Proposer must subscribe to pairing topic.") diff --git a/Tests/WalletConnectPairingTests/ExpirationServiceTests.swift b/Tests/WalletConnectPairingTests/ExpirationServiceTests.swift index 79b8b20d6..4adef7cf0 100644 --- a/Tests/WalletConnectPairingTests/ExpirationServiceTests.swift +++ b/Tests/WalletConnectPairingTests/ExpirationServiceTests.swift @@ -30,7 +30,7 @@ final class ExpirationServiceTestsTests: XCTestCase { } func testPairingExpiration() async { - let uri = try! await appPairService.create() + let uri = try! await appPairService.create(supportedMethods: nil) let pairing = storageMock.getPairing(forTopic: uri.topic)! service.setupExpirationHandling() storageMock.onPairingExpiration?(pairing) diff --git a/Tests/Web3WalletTests/Mocks/AuthClientMock.swift b/Tests/Web3WalletTests/Mocks/AuthClientMock.swift deleted file mode 100644 index b7956eeda..000000000 --- a/Tests/Web3WalletTests/Mocks/AuthClientMock.swift +++ /dev/null @@ -1,50 +0,0 @@ -import Foundation -import Combine - -@testable import Auth - -final class AuthClientMock: AuthClientProtocol { - var respondCalled = false - var rejectCalled = false - - private var authRequest: AuthRequest { - let requestParams = RequestParams( - domain: "", - chainId: "", - nonce: "", - aud: "", - nbf: "", - exp: "", - statement: "", - requestId: "", - resources: nil - ) - - return AuthRequest( - id: .left(""), - topic: "", - payload: AuthPayload(requestParams: requestParams, iat: ""), - requester: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) - ) - } - - var authRequestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { - return Result.Publisher((authRequest, nil)).eraseToAnyPublisher() - } - - func formatMessage(payload: AuthPayload, address: String) throws -> String { - return "formatted_message" - } - - func respond(requestId: JSONRPC.RPCID, signature: CacaoSignature, from account: WalletConnectUtils.Account) async throws { - respondCalled = true - } - - func reject(requestId: JSONRPC.RPCID) async throws { - rejectCalled = true - } - - func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { - return [(authRequest, nil)] - } -} diff --git a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift b/Tests/Web3WalletTests/Mocks/PairingClientMock.swift deleted file mode 100644 index 34b78d002..000000000 --- a/Tests/Web3WalletTests/Mocks/PairingClientMock.swift +++ /dev/null @@ -1,49 +0,0 @@ -import Foundation -import Combine - -@testable import WalletConnectPairing - -final class PairingClientMock: PairingClientProtocol { - var pairingStatePublisher: AnyPublisher { - pairingStatePublisherSubject.eraseToAnyPublisher() - } - var pairingStatePublisherSubject = PassthroughSubject() - - var pairingExpirationPublisher: AnyPublisher { - return pairingExpirationPublisherSubject.eraseToAnyPublisher() - } - var pairingExpirationPublisherSubject = PassthroughSubject() - - - var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> { - pairingDeletePublisherSubject.eraseToAnyPublisher() - } - - var pairingDeletePublisherSubject = PassthroughSubject<(code: Int, message: String), Never>() - - - var logsSubject = PassthroughSubject() - - var logsPublisher: AnyPublisher { - return logsSubject.eraseToAnyPublisher() - } - - var pairCalled = false - var disconnectPairingCalled = false - - func pair(uri: WalletConnectUtils.WalletConnectURI) async throws { - pairCalled = true - } - - func disconnect(topic: String) async throws { - disconnectPairingCalled = true - } - - func getPairings() -> [Pairing] { - return [Pairing(WCPairing.stub())] - } - - func register(supportedMethods: [String]) async { - - } -} diff --git a/Tests/Web3WalletTests/Mocks/ReasonMock.swift b/Tests/Web3WalletTests/Mocks/ReasonMock.swift deleted file mode 100644 index 843299215..000000000 --- a/Tests/Web3WalletTests/Mocks/ReasonMock.swift +++ /dev/null @@ -1,12 +0,0 @@ -import Foundation -import WalletConnectSign - -struct ReasonMock: WalletConnectNetworking.Reason { - var code: Int { - return 0 - } - - var message: String { - return "error" - } -} diff --git a/Tests/Web3WalletTests/Mocks/SignClientMock.swift b/Tests/Web3WalletTests/Mocks/SignClientMock.swift deleted file mode 100644 index 06737ca44..000000000 --- a/Tests/Web3WalletTests/Mocks/SignClientMock.swift +++ /dev/null @@ -1,201 +0,0 @@ -import Foundation -import Combine - -@testable import WalletConnectSign - -final class SignClientMock: SignClientProtocol { - var authRequestPublisher: AnyPublisher<(request: WalletConnectSign.AuthenticationRequest, context: WalletConnectSign.VerifyContext?), Never> { - fatalError() - } - - - func approveSessionAuthenticate(requestId: JSONRPC.RPCID, auths: [WalletConnectSign.AuthObject]) async throws { - fatalError() - } - - func makeAuthObject(authPayload: WalletConnectSign.AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> WalletConnectSign.AuthObject { - fatalError() - } - - func formatAuthMessage(payload: WalletConnectSign.AuthPayload, account: WalletConnectUtils.Account) throws -> String { - fatalError() - } - - private var logsSubject = PassthroughSubject() - - var logsPublisher: AnyPublisher { - return logsSubject.eraseToAnyPublisher() - } - var approveCalled = false - var rejectCalled = false - var updateCalled = false - var extendCalled = false - var respondCalled = false - var emitCalled = false - var pairCalled = false - var disconnectCalled = false - var cleanupCalled = false - var connectCalled = false - var requestCalled = false - - private let metadata = AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)) - private let request = WalletConnectSign.Request(id: .left(""), topic: "", method: "", params: AnyCodable(""), chainId: Blockchain("eip155:1")!, expiryTimestamp: nil) - private let response = WalletConnectSign.Response(id: RPCID(1234567890123456789), topic: "", chainId: "", result: .response(AnyCodable(any: ""))) - - var sessionProposalPublisher: AnyPublisher<(proposal: WalletConnectSign.Session.Proposal, context: VerifyContext?), Never> { - let proposer = Participant(publicKey: "", metadata: metadata) - let sessionProposal = WalletConnectSign.SessionProposal( - relays: [], - proposer: proposer, - requiredNamespaces: [:], - optionalNamespaces: nil, - sessionProperties: nil - ).publicRepresentation(pairingTopic: "") - - return Result.Publisher((sessionProposal, nil)) - .eraseToAnyPublisher() - } - - var sessionRequestPublisher: AnyPublisher<(request: WalletConnectSign.Request, context: VerifyContext?), Never> { - return Result.Publisher((request, nil)) - .eraseToAnyPublisher() - } - - var sessionsPublisher: AnyPublisher<[WalletConnectSign.Session], Never> { - return Result.Publisher([WalletConnectSign.Session(topic: "", pairingTopic: "", peer: metadata, requiredNamespaces: [:], namespaces: [:], sessionProperties: nil, expiryDate: Date())]) - .eraseToAnyPublisher() - } - - var socketConnectionStatusPublisher: AnyPublisher { - return Result.Publisher(.connected) - .eraseToAnyPublisher() - } - - var sessionSettlePublisher: AnyPublisher { - return Result.Publisher(Session(topic: "", pairingTopic: "", peer: metadata, requiredNamespaces: [:], namespaces: [:], sessionProperties: nil, expiryDate: Date())) - .eraseToAnyPublisher() - } - - var sessionDeletePublisher: AnyPublisher<(String, WalletConnectNetworking.Reason), Never> { - return Result.Publisher(("topic", ReasonMock())) - .eraseToAnyPublisher() - } - - var pendingProposalsPublisher: AnyPublisher<[(proposal: WalletConnectSign.Session.Proposal, context: WalletConnectSign.VerifyContext?)], Never> { - return Result.Publisher([]) - .eraseToAnyPublisher() - } - - var requestExpirationPublisher: AnyPublisher { - Result.Publisher(request) - .eraseToAnyPublisher() - } - - var sessionEventPublisher: AnyPublisher<(event: WalletConnectSign.Session.Event, sessionTopic: String, chainId: WalletConnectUtils.Blockchain?), Never> { - return Result.Publisher( - ( - WalletConnectSign.Session.Event(name: "chainChanged", data: AnyCodable("event_data")), - "topic", - Blockchain("eip155:1") - ) - ) - .eraseToAnyPublisher() - } - - var sessionProposalExpirationPublisher: AnyPublisher { - fatalError() - } - - var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { - let sessionProposal = Session.Proposal( - id: "", - pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), - requiredNamespaces: [:], - optionalNamespaces: nil, - sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) - ) - - return Result.Publisher((sessionProposal, SignReasonCode.userRejectedChains)) - .eraseToAnyPublisher() - } - - var sessionResponsePublisher: AnyPublisher { - return Result.Publisher(.success(response)) - .eraseToAnyPublisher() - } - - func approve(proposalId: String, namespaces: [String : WalletConnectSign.SessionNamespace], sessionProperties: [String : String]? = nil) async throws { - approveCalled = true - } - - func rejectSession(proposalId: String, reason: WalletConnectSign.RejectionReason) async throws { - rejectCalled = true - } - - func rejectSession(requestId: JSONRPC.RPCID) async throws { - fatalError("TODO") - } - - func respondSessionAuthenticated(requestId: JSONRPC.RPCID, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) async throws { - fatalError("TODO") - } - - func getPendingAuthRequests() throws -> [(WalletConnectSign.AuthenticationRequest, WalletConnectSign.VerifyContext?)] { - fatalError("TODO") - } - - func update(topic: String, namespaces: [String : WalletConnectSign.SessionNamespace]) async throws { - updateCalled = true - } - - func extend(topic: String) async throws { - extendCalled = true - } - - func respond(topic: String, requestId: JSONRPC.RPCID, response: JSONRPC.RPCResult) async throws { - respondCalled = true - } - - func emit(topic: String, event: WalletConnectSign.Session.Event, chainId: WalletConnectUtils.Blockchain) async throws { - emitCalled = true - } - - func pair(uri: WalletConnectUtils.WalletConnectURI) async throws { - pairCalled = true - } - - func disconnect(topic: String) async throws { - disconnectCalled = true - } - - func getSessions() -> [WalletConnectSign.Session] { - return [WalletConnectSign.Session(topic: "", pairingTopic: "", peer: metadata, requiredNamespaces: [:], namespaces: [:], sessionProperties: nil, expiryDate: Date())] - } - - func getPendingProposals(topic: String?) -> [(proposal: WalletConnectSign.Session.Proposal, context: VerifyContext?)] { - return [] - } - - func getPendingRequests(topic: String?) -> [(request: WalletConnectSign.Request, context: WalletConnectSign.VerifyContext?)] { - return [(request, nil)] - } - - func cleanup() async throws { - cleanupCalled = true - } - - func connect( - requiredNamespaces: [String : WalletConnectSign.ProposalNamespace], - optionalNamespaces: [String : WalletConnectSign.ProposalNamespace]?, - sessionProperties: [String : String]?, - topic: String - ) async throws { - connectCalled = true - } - - func request(params: WalletConnectSign.Request) async throws { - requestCalled = true - } -} diff --git a/Tests/Web3WalletTests/Web3WalletTests.swift b/Tests/Web3WalletTests/Web3WalletTests.swift deleted file mode 100644 index 2247b3e87..000000000 --- a/Tests/Web3WalletTests/Web3WalletTests.swift +++ /dev/null @@ -1,274 +0,0 @@ -// -//import XCTest -//import Combine -// -//@testable import Auth -//@testable import Web3Wallet -//@testable import WalletConnectPush -// -//final class Web3WalletTests: XCTestCase { -// var web3WalletClient: Web3WalletClient! -// var authClient: AuthClientMock! -// var signClient: SignClientMock! -// var pairingClient: PairingClientMock! -// var pushClient: PushClientMock! -// -// private var disposeBag = Set() -// -// override func setUp() { -// authClient = AuthClientMock() -// signClient = SignClientMock() -// pairingClient = PairingClientMock() -// pushClient = PushClientMock() -// -// web3WalletClient = Web3WalletClientFactory.create( -// authClient: authClient, -// signClient: signClient, -// pairingClient: pairingClient, -// pushClient: pushClient -// ) -// } -// -// func testSessionRequestCalled() { -// var success = false -// web3WalletClient.sessionRequestPublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testAuthRequestCalled() { -// var success = false -// web3WalletClient.authRequestPublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testSessionProposalCalled() { -// var success = false -// web3WalletClient.sessionProposalPublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testSessionsCalled() { -// var success = false -// web3WalletClient.sessionsPublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testSocketConnectionStatusCalled() { -// var success = false -// web3WalletClient.socketConnectionStatusPublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testSessionSettleCalled() { -// var success = false -// web3WalletClient.sessionSettlePublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testSessionDeleteCalled() { -// var success = false -// web3WalletClient.sessionDeletePublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testSessionResponseCalled() { -// var success = false -// web3WalletClient.sessionResponsePublisher.sink { value in -// success = true -// XCTAssertTrue(true) -// } -// .store(in: &disposeBag) -// -// let expectation = expectation(description: "Fail after 0.1s timeout") -// let result = XCTWaiter.wait(for: [expectation], timeout: 0.1) -// if result == XCTWaiter.Result.timedOut && success == false { -// XCTFail() -// } -// } -// -// func testApproveCalled() async { -// try! await web3WalletClient.approve(proposalId: "", namespaces: [:]) -// XCTAssertTrue(signClient.approveCalled) -// } -// -// func testRejectSessionCalled() async { -// try! await web3WalletClient.reject(proposalId: "", reason: .userRejected) -// XCTAssertTrue(signClient.rejectCalled) -// } -// -// func testRejectAuthRequestCalled() async { -// try! await web3WalletClient.reject(requestId: .left("")) -// XCTAssertTrue(authClient.rejectCalled) -// } -// -// func testUpdateCalled() async { -// try! await web3WalletClient.update(topic: "", namespaces: [:]) -// XCTAssertTrue(signClient.updateCalled) -// } -// -// func testExtendCalled() async { -// try! await web3WalletClient.extend(topic: "") -// XCTAssertTrue(signClient.extendCalled) -// } -// -// func testSignRespondCalled() async { -// try! await web3WalletClient.respond( -// topic: "", -// requestId: .left(""), -// response: RPCResult.response(AnyCodable(true)) -// ) -// XCTAssertTrue(signClient.respondCalled) -// } -// -// func testPairCalled() async { -// try! await web3WalletClient.pair(uri: WalletConnectURI( -// topic: "topic", -// symKey: "symKey", -// relay: RelayProtocolOptions(protocol: "", data: "") -// )) -// XCTAssertTrue(pairingClient.pairCalled) -// } -// -// func testDisconnectPairingCalled() async { -// try! await web3WalletClient.disconnectPairing(topic: "topic") -// XCTAssertTrue(pairingClient.disconnectPairingCalled) -// } -// -// func testDisconnectCalled() async { -// try! await web3WalletClient.disconnect(topic: "") -// XCTAssertTrue(signClient.disconnectCalled) -// } -// -// func testGetSessionsCalledAndNotEmpty() { -// let sessions = web3WalletClient.getSessions() -// XCTAssertEqual(1, sessions.count) -// } -// -// func testFormatMessageCalled() { -// let authPayload = AuthPayload( -// requestParams: RequestParams( -// domain: "service.invalid", -// chainId: "eip155:1", -// nonce: "32891756", -// aud: "https://service.invalid/login", -// nbf: nil, -// exp: nil, -// statement: "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", -// requestId: nil, -// resources: [ -// "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", -// "https://example.com/my-web2-claim.json" -// ] -// ), -// iat: "2021-09-30T16:25:24Z" -// ) -// -// let formattedMessage = try! web3WalletClient.formatMessage( -// payload: authPayload, -// address: "" -// ) -// XCTAssertEqual("formatted_message", formattedMessage) -// } -// -// func testAuthRespondCalled() async { -// let signature = CacaoSignature(t: .eip191, s: "0x438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b") -// let account = Account("eip155:56:0xe5EeF1368781911d265fDB6946613dA61915a501")! -// -// try! await web3WalletClient.respond( -// requestId: .left(""), -// signature: signature, -// from: account -// ) -// XCTAssertTrue(authClient.respondCalled) -// } -// -// func testSignPendingRequestsCalledAndNotEmpty() async { -// let pendingRequests = web3WalletClient.getPendingRequests(topic: "") -// XCTAssertEqual(1, pendingRequests.count) -// } -// -// func testAuthPendingRequestsCalledAndNotEmpty() async { -// let pendingRequests = try! web3WalletClient.getPendingRequests() -// XCTAssertEqual(1, pendingRequests.count) -// } -// -// func testCleanupCalled() async { -// try! await web3WalletClient.cleanup() -// XCTAssertTrue(signClient.cleanupCalled) -// } -// -// func testGetPairingsNotEmpty() async { -// XCTAssertEqual(1, web3WalletClient.getPairings().count) -// } -// -// func testPushClientRegisterCalled() async { -// try! await pushClient.register(deviceToken: Data()) -// XCTAssertTrue(pushClient.registedCalled) -// pushClient.registedCalled = false -// try! await pushClient.register(deviceToken: "") -// XCTAssertTrue(pushClient.registedCalled) -// } -//} From 9c91e40d4b61e48c0f46d9cc34517c693ff27026 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 14:57:26 +0100 Subject: [PATCH 403/814] fix buildAll --- Example/IntegrationTests/Sign/SignClientTests.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 4bc4d2f7c..3d2024a1c 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -871,7 +871,7 @@ final class SignClientTests: XCTestCase { } .store(in: &publishers) dapp.authResponsePublisher.sink { (_, result) in - guard case .success(let session) = result, + guard case .success(let (session, _)) = result, let session = session else { XCTFail(); return } XCTAssertEqual(session.accounts.count, 2) XCTAssertEqual(session.namespaces["eip155"]?.methods.count, 2) @@ -993,7 +993,7 @@ final class SignClientTests: XCTestCase { } .store(in: &publishers) dapp.authResponsePublisher.sink { [unowned self] (_, result) in - guard case .success(let session) = result, + guard case .success(let (session, _)) = result, let session = session else { XCTFail(); return } Task(priority: .high) { let request = try Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: chain) From ff5f12a8b37a7e83ee9763069e5458dfebdc1b34 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Feb 2024 19:53:00 +0100 Subject: [PATCH 404/814] savepoint --- .../IntegrationTests/Sign/SignClientTests.swift | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 3d2024a1c..6911600a0 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -891,8 +891,7 @@ final class SignClientTests: XCTestCase { // let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! // // let responseExpectation = expectation(description: "successful response delivered") -// let uri = try! await dappPairingClient.create() -// try! await dapp.authenticate(RequestParams( +// let uri = try! await dapp.authenticate(AuthRequestParams( // domain: "localhost", // chains: ["eip155:1"], // nonce: "1665443015700", @@ -901,15 +900,17 @@ final class SignClientTests: XCTestCase { // exp: "2022-10-11T23:03:35.700Z", // statement: nil, // requestId: nil, -// resources: nil -// ), topic: uri.topic) +// resources: nil, +// methods: nil +// )) // // try await walletPairingClient.pair(uri: uri) // -// wallet.authRequestPublisher.sink { [unowned self] request in +// wallet.authRequestPublisher.sink { [unowned self] (request, _) in // Task(priority: .high) { // let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) -// try! await wallet.approveSessionAuthenticate(requestId: request.0.id, signature: signature, account: account) +// let cacao = try! wallet.buildSignedAuthObject(authPayload: request.payload, signature: signature, account: walletAccount) +// await XCTAssertThrowsErrorAsync(try await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao])) // } // } // .store(in: &publishers) @@ -918,7 +919,7 @@ final class SignClientTests: XCTestCase { // responseExpectation.fulfill() // } // .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) +// await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) // } func testEIP191SessionAuthenticateSignatureVerificationFailed() async { From b029b594993f070eabd7f4600b40c9f8cafc4639 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Feb 2024 09:31:37 +0100 Subject: [PATCH 405/814] fix testEIP1271SessionAuthenticated --- .../Sign/SignClientTests.swift | 73 ++++++++++--------- .../Cacao/IATProvider.swift | 2 +- 2 files changed, 38 insertions(+), 37 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 6911600a0..79c8e6b04 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -17,7 +17,7 @@ final class SignClientTests: XCTestCase { private var publishers = Set() let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") - let eip1271Signature = "0xc1505719b2504095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" + let eip1271Signature = "0xdeaddeaddead4095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" static private func makeClients(name: String) -> (PairingClient, SignClient) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) @@ -886,41 +886,42 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } -// func testEIP1271SessionAuthenticated() async throws { -// -// let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! -// -// let responseExpectation = expectation(description: "successful response delivered") -// let uri = try! await dapp.authenticate(AuthRequestParams( -// domain: "localhost", -// chains: ["eip155:1"], -// nonce: "1665443015700", -// aud: "http://localhost:3000/", -// nbf: nil, -// exp: "2022-10-11T23:03:35.700Z", -// statement: nil, -// requestId: nil, -// resources: nil, -// methods: nil -// )) -// -// try await walletPairingClient.pair(uri: uri) -// -// wallet.authRequestPublisher.sink { [unowned self] (request, _) in -// Task(priority: .high) { -// let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) -// let cacao = try! wallet.buildSignedAuthObject(authPayload: request.payload, signature: signature, account: walletAccount) -// await XCTAssertThrowsErrorAsync(try await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao])) -// } -// } -// .store(in: &publishers) -// dapp.authResponsePublisher.sink { (_, result) in -// guard case .success = result else { XCTFail(); return } -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } + func testEIP1271SessionAuthenticated() async throws { + + let account = Account(chainIdentifier: "eip155:1", address: "0x6DF3d14554742D67068BB7294C80107a3c655A56")! + let eip1271Signature = "0xb518b65724f224f8b12dedeeb06f8b278eb7d3b42524959bed5d0dfa49801bd776c7ee05de396eadc38ee693c917a04d93b20981d68c4a950cbc42ea7f4264bc1c" + + let responseExpectation = expectation(description: "successful response delivered") + let uri = try! await dapp.authenticate(AuthRequestParams( + domain: "etherscan.io", + chains: ["eip155:1"], + nonce: "DTYxeNr95Ne7Sape5", + aud: "https://etherscan.io/verifiedSignatures#", + nbf: nil, + exp: nil, + statement: "Sign message to verify ownership of the address 0x6DF3d14554742D67068BB7294C80107a3c655A56 on etherscan.io", + requestId: nil, + resources: nil, + methods: nil + )) + + try await walletPairingClient.pair(uri: uri) + + wallet.authRequestPublisher.sink { [unowned self] (request, _) in + Task(priority: .high) { + let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) + let cacao = try! wallet.buildSignedAuthObject(authPayload: request.payload, signature: signature, account: account) + _ = try await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao]) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success = result else { XCTFail(); return } + responseExpectation.fulfill() + } + .store(in: &publishers) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) + } func testEIP191SessionAuthenticateSignatureVerificationFailed() async { let requestExpectation = expectation(description: "error response delivered") diff --git a/Sources/WalletConnectUtils/Cacao/IATProvider.swift b/Sources/WalletConnectUtils/Cacao/IATProvider.swift index 17637c22c..d65fecc56 100644 --- a/Sources/WalletConnectUtils/Cacao/IATProvider.swift +++ b/Sources/WalletConnectUtils/Cacao/IATProvider.swift @@ -16,7 +16,7 @@ public struct DefaultIATProvider: IATProvider { #if DEBUG struct IATProviderMock: IATProvider { var iat: String { - return "2022-10-10T23:03:35.700Z" + return "2024-02-05T13:09:08.427Z" } } #endif From 75355b2db44292e3b8245b6302d70ec241b0ccdc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Feb 2024 12:54:37 +0100 Subject: [PATCH 406/814] savepoint --- .../Auth/Signer/EIP191VerifierTests.swift | 2 + .../IntegrationTests/Push/NotifyTests.swift | 549 +++++++++--------- 2 files changed, 268 insertions(+), 283 deletions(-) diff --git a/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift b/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift index 60d087340..9245780b2 100644 --- a/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift +++ b/Example/IntegrationTests/Auth/Signer/EIP191VerifierTests.swift @@ -14,6 +14,8 @@ class EIP191VerifierTests: XCTestCase { try await verifier.verify(signature: signature, message: message, address: address) } + // passes with https://etherscan.io/verifiedSignatures# + // for testing with etherscan remove prefix func testEtherscanSignature() async throws { let address = "0x6721591d424c18b7173d55895efa1839aa57d9c2" let message = "\u{19}Ethereum Signed Message:\n139[Etherscan.io 12/08/2022 09:26:23] I, hereby verify that I am the owner/creator of the address [0x7e77dcb127f99ece88230a64db8d595f31f1b068]".data(using: .utf8)! diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index f322f4d7a..cbb5f839f 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -1,251 +1,251 @@ -//import Foundation -//import XCTest -//import WalletConnectUtils -//import Web3 -//@testable import WalletConnectKMS -//import WalletConnectRelay -//import Combine -//import WalletConnectNetworking -//import WalletConnectPush -//@testable import WalletConnectNotify -//import WalletConnectIdentity -//import WalletConnectSigner -// -//final class NotifyTests: XCTestCase { -// -// var walletNotifyClientA: NotifyClient! -// -// let gmDappDomain = InputConfig.gmDappHost -// -// var pk: EthereumPrivateKey! -// -// var privateKey: Data { -// return Data(pk.rawPrivateKey) -// } -// -// var account: Account { -// return Account("eip155:1:" + pk.address.hex(eip55: true))! -// } -// -// private var publishers = Set() -// -// func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { -// let keychain = KeychainStorageMock() -// let keyValueStorage = RuntimeKeyValueStorage() -// -// let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) -// let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) -// let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) -// -// let relayClient = RelayClientFactory.create( -// relayHost: InputConfig.relayHost, -// projectId: InputConfig.projectId, -// keyValueStorage: keyValueStorage, -// keychainStorage: keychain, -// socketFactory: DefaultSocketFactory(), -// networkMonitor: NetworkMonitor(), -// logger: relayLogger) -// -// let networkingClient = NetworkingClientFactory.create( -// relayClient: relayClient, -// logger: networkingLogger, -// keychainStorage: keychain, -// keyValueStorage: keyValueStorage, -// kmsLogger: kmsLogger) -// -// let clientId = try! networkingClient.getClientId() -// networkingLogger.debug("My client id is: \(clientId)") -// return (networkingClient, keychain, keyValueStorage) -// } -// -// func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { -// let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) -// let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) -// let pushClient = PushClientFactory.create(projectId: "", -// pushHost: "echo.walletconnect.com", -// keyValueStorage: keyValueStorage, -// keychainStorage: keychain, -// environment: .sandbox) -// let keyserverURL = URL(string: "https://keys.walletconnect.com")! -// let sqlite = try! MemorySqlite() -// // Note:- prod project_id do not exists on staging, we can use gmDappProjectId -// let client = NotifyClientFactory.create(projectId: InputConfig.gmDappProjectId, -// keyserverURL: keyserverURL, -// sqlite: sqlite, -// logger: notifyLogger, -// keychainStorage: keychain, -// groupKeychainStorage: KeychainStorageMock(), -// networkInteractor: networkingInteractor, -// pushClient: pushClient, -// crypto: DefaultCryptoProvider(), -// notifyHost: InputConfig.notifyHost, -// explorerHost: InputConfig.explorerHost) -// return client -// } -// -// override func setUp() { -// pk = try! EthereumPrivateKey() -// walletNotifyClientA = makeWalletClient() -// publishers.removeAll() -// } -// -// func testWalletCreatesSubscription() async throws { -// let expectation = expectation(description: "expects to create notify subscription") -// expectation.assertForOverFulfill = false -// -// var subscription: NotifySubscription? -// -// walletNotifyClientA.subscriptionsPublisher -// .sink { subscriptions in -// subscription = subscriptions.first -// expectation.fulfill() -// }.store(in: &publishers) -// -// try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) -// try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) -// -// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) -// -// if let subscription { -// try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) -// } -// } -// -// func testNotifyWatchSubscriptions() async throws { -// let expectation = expectation(description: "expects client B to receive subscription created by client A") -// expectation.assertForOverFulfill = false -// -// var subscription: NotifySubscription? -// -// let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") -// clientB.subscriptionsPublisher.sink { subscriptions in -// subscription = subscriptions.first -// expectation.fulfill() -// }.store(in: &publishers) -// -// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) -// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) -// try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) -// -// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) -// -// if let subscription { -// try await clientB.deleteSubscription(topic: subscription.topic) -// } -// } -// -// func testNotifySubscriptionChanged() async throws { -// let expectation = expectation(description: "expects client B to receive subscription after both clients are registered and client A creates one") -// expectation.assertForOverFulfill = false -// -// var subscription: NotifySubscription? -// -// let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") -// clientB.subscriptionsPublisher.sink { subscriptions in -// subscription = subscriptions.first -// expectation.fulfill() -// }.store(in: &publishers) -// -// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) -// try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) -// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) -// -// await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) -// -// if let subscription { -// try await clientB.deleteSubscription(topic: subscription.topic) -// } -// } -// -// func testWalletCreatesAndUpdatesSubscription() async throws { -// let created = expectation(description: "Subscription created") -// -// let updated = expectation(description: "Subscription Updated") -// -// var isCreated = false -// var isUpdated = false -// var subscription: NotifySubscription! -// -// walletNotifyClientA.subscriptionsPublisher -// .sink { subscriptions in -// subscription = subscriptions.first -// -// if !isCreated { -// isCreated = true -// created.fulfill() -// } else if !isUpdated { -// isUpdated = true -// updated.fulfill() -// } -// }.store(in: &publishers) -// -// try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) -// try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) -// -// await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) -// -// try await walletNotifyClientA.update(topic: subscription.topic, scope: []) -// -// await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) -// -// let updatedScope = subscription.scope.filter { $0.value.enabled == true } -// XCTAssertTrue(updatedScope.isEmpty) -// -// try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) -// } -// -// func testNotifyServerSubscribeAndNotifies() async throws { -// let subscribeExpectation = expectation(description: "creates notify subscription") -// let messageExpectation = expectation(description: "receives a notify message") -// -// var notifyMessage: NotifyMessage! -// var notifyMessageRecord: NotifyMessageRecord? -// -// var didNotify = false -// walletNotifyClientA.subscriptionsPublisher -// .sink { subscriptions in -// guard -// let subscription = subscriptions.first, -// let scope = subscription.scope.keys.first -// else { return } -// -// let notifier = Publisher() -// if !didNotify { -// didNotify = true -// -// let message = NotifyMessage.stub(type: scope) -// notifyMessage = message -// -// Task(priority: .high) { -// try await notifier.notify(topic: subscription.topic, account: subscription.account, message: message) -// subscribeExpectation.fulfill() -// } -// } -// }.store(in: &publishers) -// -// walletNotifyClientA.messagesPublisher -// .sink { messages in -// guard let newNotifyMessageRecord = messages.first else { return } -// // ID's is not equal because server generates a new one -// XCTAssertEqual(newNotifyMessageRecord.message.title, notifyMessage.title) -// XCTAssertEqual(newNotifyMessageRecord.message.body, notifyMessage.body) -// XCTAssertEqual(newNotifyMessageRecord.message.icon, notifyMessage.icon) -// XCTAssertEqual(newNotifyMessageRecord.message.type, notifyMessage.type) -// notifyMessageRecord = newNotifyMessageRecord -// messageExpectation.fulfill() -// }.store(in: &publishers) -// -// try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) -// try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) -// -// await fulfillment(of: [subscribeExpectation, messageExpectation], timeout: InputConfig.defaultTimeout) -// -// if let notifyMessageRecord { -// try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) -// } -// } +import Foundation +import XCTest +import WalletConnectUtils +import Web3 +@testable import WalletConnectKMS +import WalletConnectRelay +import Combine +import WalletConnectNetworking +import WalletConnectPush +@testable import WalletConnectNotify +import WalletConnectIdentity +import WalletConnectSigner + +final class NotifyTests: XCTestCase { + + var walletNotifyClientA: NotifyClient! + + let gmDappDomain = InputConfig.gmDappHost + + var pk: EthereumPrivateKey! + + var privateKey: Data { + return Data(pk.rawPrivateKey) + } + + var account: Account { + return Account("eip155:1:" + pk.address.hex(eip55: true))! + } + + private var publishers = Set() + + func makeClientDependencies(prefix: String) -> (NetworkInteracting, KeychainStorageProtocol, KeyValueStorage) { + let keychain = KeychainStorageMock() + let keyValueStorage = RuntimeKeyValueStorage() + + let relayLogger = ConsoleLogger(prefix: prefix + " [Relay]", loggingLevel: .debug) + let networkingLogger = ConsoleLogger(prefix: prefix + " [Networking]", loggingLevel: .debug) + let kmsLogger = ConsoleLogger(prefix: prefix + " [KMS]", loggingLevel: .debug) + + let relayClient = RelayClientFactory.create( + relayHost: InputConfig.relayHost, + projectId: InputConfig.projectId, + keyValueStorage: keyValueStorage, + keychainStorage: keychain, + socketFactory: DefaultSocketFactory(), + networkMonitor: NetworkMonitor(), + logger: relayLogger) + + let networkingClient = NetworkingClientFactory.create( + relayClient: relayClient, + logger: networkingLogger, + keychainStorage: keychain, + keyValueStorage: keyValueStorage, + kmsLogger: kmsLogger) + + let clientId = try! networkingClient.getClientId() + networkingLogger.debug("My client id is: \(clientId)") + return (networkingClient, keychain, keyValueStorage) + } + + func makeWalletClient(prefix: String = "🦋 Wallet: ") -> NotifyClient { + let (networkingInteractor, keychain, keyValueStorage) = makeClientDependencies(prefix: prefix) + let notifyLogger = ConsoleLogger(prefix: prefix + " [Notify]", loggingLevel: .debug) + let pushClient = PushClientFactory.create(projectId: "", + pushHost: "echo.walletconnect.com", + keyValueStorage: keyValueStorage, + keychainStorage: keychain, + environment: .sandbox) + let keyserverURL = URL(string: "https://keys.walletconnect.com")! + let sqlite = try! MemorySqlite() + // Note:- prod project_id do not exists on staging, we can use gmDappProjectId + let client = NotifyClientFactory.create(projectId: InputConfig.gmDappProjectId, + keyserverURL: keyserverURL, + sqlite: sqlite, + logger: notifyLogger, + keychainStorage: keychain, + groupKeychainStorage: KeychainStorageMock(), + networkInteractor: networkingInteractor, + pushClient: pushClient, + crypto: DefaultCryptoProvider(), + notifyHost: InputConfig.notifyHost, + explorerHost: InputConfig.explorerHost) + return client + } + + override func setUp() { + pk = try! EthereumPrivateKey() + walletNotifyClientA = makeWalletClient() + publishers.removeAll() + } + + func testWalletCreatesSubscription() async throws { + let expectation = expectation(description: "expects to create notify subscription") + expectation.assertForOverFulfill = false + + var subscription: NotifySubscription? + + walletNotifyClientA.subscriptionsPublisher + .sink { subscriptions in + subscription = subscriptions.first + expectation.fulfill() + }.store(in: &publishers) + + try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) + try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) + + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) + + if let subscription { + try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) + } + } + + func testNotifyWatchSubscriptions() async throws { + let expectation = expectation(description: "expects client B to receive subscription created by client A") + expectation.assertForOverFulfill = false + + var subscription: NotifySubscription? + + let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") + clientB.subscriptionsPublisher.sink { subscriptions in + subscription = subscriptions.first + expectation.fulfill() + }.store(in: &publishers) + + try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) + try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) + try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) + + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) + + if let subscription { + try await clientB.deleteSubscription(topic: subscription.topic) + } + } + + func testNotifySubscriptionChanged() async throws { + let expectation = expectation(description: "expects client B to receive subscription after both clients are registered and client A creates one") + expectation.assertForOverFulfill = false + + var subscription: NotifySubscription? + + let clientB = makeWalletClient(prefix: "👐🏼 Wallet B: ") + clientB.subscriptionsPublisher.sink { subscriptions in + subscription = subscriptions.first + expectation.fulfill() + }.store(in: &publishers) + + try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) + try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) + try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) + + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) + + if let subscription { + try await clientB.deleteSubscription(topic: subscription.topic) + } + } + + func testWalletCreatesAndUpdatesSubscription() async throws { + let created = expectation(description: "Subscription created") + let updated = expectation(description: "Subscription Updated") + + var isCreated = false + var isUpdated = false + var subscription: NotifySubscription! + + walletNotifyClientA.subscriptionsPublisher + .sink { subscriptions in + subscription = subscriptions.first + + if !isCreated { + isCreated = true + created.fulfill() + } else if !isUpdated { + isUpdated = true + updated.fulfill() + } + }.store(in: &publishers) + + try await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) + try await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) + + await fulfillment(of: [created], timeout: InputConfig.defaultTimeout) + + try await walletNotifyClientA.update(topic: subscription.topic, scope: []) + + await fulfillment(of: [updated], timeout: InputConfig.defaultTimeout) + + let updatedScope = subscription.scope.filter { $0.value.enabled == true } + XCTAssertTrue(updatedScope.isEmpty) + + try await walletNotifyClientA.deleteSubscription(topic: subscription.topic) + } + + func testNotifyServerSubscribeAndNotifies() async throws { + let subscribeExpectation = expectation(description: "creates notify subscription") + let messageExpectation = expectation(description: "receives a notify message") + + var notifyMessage: NotifyMessage! + var notifyMessageRecord: NotifyMessageRecord? + + var didNotify = false + walletNotifyClientA.subscriptionsPublisher + .sink { subscriptions in + guard + let subscription = subscriptions.first, + let scope = subscription.scope.keys.first + else { return } + + let notifier = Publisher() + if !didNotify { + didNotify = true + + let message = NotifyMessage.stub(type: scope) + notifyMessage = message + + Task(priority: .high) { + try await notifier.notify(topic: subscription.topic, account: subscription.account, message: message) + subscribeExpectation.fulfill() + } + } + }.store(in: &publishers) + + walletNotifyClientA.messagesPublisher + .sink { messages in + guard let newNotifyMessageRecord = messages.first else { return } + // ID's is not equal because server generates a new one + XCTAssertEqual(newNotifyMessageRecord.message.title, notifyMessage.title) + XCTAssertEqual(newNotifyMessageRecord.message.body, notifyMessage.body) + XCTAssertEqual(newNotifyMessageRecord.message.icon, notifyMessage.icon) + XCTAssertEqual(newNotifyMessageRecord.message.type, notifyMessage.type) + notifyMessageRecord = newNotifyMessageRecord + messageExpectation.fulfill() + }.store(in: &publishers) + + try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) + try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) + + await fulfillment(of: [subscribeExpectation, messageExpectation], timeout: InputConfig.defaultTimeout) + + if let notifyMessageRecord { + try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) + } + } +// // func testFetchHistory() async throws { // let subscribeExpectation = expectation(description: "fetch notify subscription") // let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! @@ -259,7 +259,7 @@ // // try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in // let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") -// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) +// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() // return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) // } // @@ -269,39 +269,22 @@ // XCTAssertTrue(hasMore) // XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) // } -//} -// -// -//private extension NotifyTests { -// func sign(_ message: String) -> CacaoSignature { -// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) -// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) -// } -//} -// -//private extension NotifyClient { -// -// func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { -// let params = try await prepareRegistration(account: account, domain: domain) -// let signature = onSign(params.message) -// try await register(params: params, signature: signature) -// } -//} -//} -// -// -//private extension NotifyTests { -// func sign(_ message: String) -> CacaoSignature { -// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) -// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) -// } -//} -// -//private extension NotifyClient { -// -// func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { -// let params = try await prepareRegistration(account: account, domain: domain) -// let signature = onSign(params.message) -// try await register(params: params, signature: signature) -// } -//} +} + + +private extension NotifyTests { + func sign(_ message: String) -> CacaoSignature { + let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() + return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) + } +} + +private extension NotifyClient { + + func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { + let params = try await prepareRegistration(account: account, domain: domain) + let signature = onSign(params.message) + try await register(params: params, signature: signature) + } +} + From 24e3083dede291faff97178f8540933bfdf6542d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Feb 2024 14:19:52 +0100 Subject: [PATCH 407/814] savepoint --- Sources/HTTPClient/HTTPNetworkClient.swift | 7 +++++++ .../WalletConnectSign/Auth/Services/CacaosProvider.swift | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/Sources/HTTPClient/HTTPNetworkClient.swift b/Sources/HTTPClient/HTTPNetworkClient.swift index a00ca2119..6176d6ac7 100644 --- a/Sources/HTTPClient/HTTPNetworkClient.swift +++ b/Sources/HTTPClient/HTTPNetworkClient.swift @@ -60,8 +60,15 @@ public actor HTTPNetworkClient: HTTPClient { completion(.failure(HTTPError.malformedURL(service))) return } + print("REQUEST") + print(request.description) + if let bodyData = request.httpBody, let bodyString = String(data: bodyData, encoding: .utf8) { + print(bodyString) + } session.dataTask(with: request) { data, response, error in do { + print("RESPONSE") + print(response) try HTTPNetworkClient.validate(response, error) completion(.success(())) } catch { diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift index 5ab42d879..70358d865 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift @@ -4,7 +4,7 @@ import Foundation struct CacaosProvider { public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { let payload = try authPayload.cacaoPayload(account: account) - let header = CacaoHeader(t: "eip4361") + let header = CacaoHeader(t: "caip122") return Cacao(h: header, p: payload, s: signature) } } From 4f61ecc06324f80ed1db0a94ab7c7c41afdf4de7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Feb 2024 14:53:07 +0100 Subject: [PATCH 408/814] fix notify tests --- Sources/HTTPClient/HTTPNetworkClient.swift | 18 ++++++++---------- .../IdentityService.swift | 2 +- 2 files changed, 9 insertions(+), 11 deletions(-) diff --git a/Sources/HTTPClient/HTTPNetworkClient.swift b/Sources/HTTPClient/HTTPNetworkClient.swift index 6176d6ac7..13b491974 100644 --- a/Sources/HTTPClient/HTTPNetworkClient.swift +++ b/Sources/HTTPClient/HTTPNetworkClient.swift @@ -41,9 +41,10 @@ public actor HTTPNetworkClient: HTTPClient { completion(.failure(HTTPError.malformedURL(service))) return } + session.dataTask(with: request) { data, response, error in do { - try HTTPNetworkClient.validate(response, error) + try HTTPNetworkClient.validate(response, error, data: data) guard let validData = data else { throw HTTPError.responseDataNil } @@ -60,16 +61,10 @@ public actor HTTPNetworkClient: HTTPClient { completion(.failure(HTTPError.malformedURL(service))) return } - print("REQUEST") - print(request.description) - if let bodyData = request.httpBody, let bodyString = String(data: bodyData, encoding: .utf8) { - print(bodyString) - } + session.dataTask(with: request) { data, response, error in do { - print("RESPONSE") - print(response) - try HTTPNetworkClient.validate(response, error) + try HTTPNetworkClient.validate(response, error, data: data) completion(.success(())) } catch { completion(.failure(error)) @@ -77,7 +72,7 @@ public actor HTTPNetworkClient: HTTPClient { }.resume() } - private static func validate(_ urlResponse: URLResponse?, _ error: Error?) throws { + private static func validate(_ urlResponse: URLResponse?, _ error: Error?, data: Data?) throws { if let error = (error as? NSError), error.code == -1004 { throw HTTPError.couldNotConnect } @@ -88,6 +83,9 @@ public actor HTTPNetworkClient: HTTPClient { throw HTTPError.noResponse } guard (200..<300) ~= httpResponse.statusCode else { + if let data = data { + print("HTTP error: \(String(decoding: data, as: UTF8.self))") + } throw HTTPError.badStatusCode(httpResponse.statusCode) } } diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index e949f4866..96cd34215 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -58,7 +58,7 @@ actor IdentityService { return identityKey.publicKey.hexRepresentation } - let cacaoHeader = CacaoHeader(t: "caip122") + let cacaoHeader = CacaoHeader(t: "eip4361") let cacao = Cacao(h: cacaoHeader, p: params.payload, s: signature) try await networkService.registerIdentity(cacao: cacao) From e5b9ee64bad244d67d40a9ba082e68096ff6c1be Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Feb 2024 15:32:46 +0100 Subject: [PATCH 409/814] reenable notify tests --- .../IntegrationTests/Push/NotifyTests.swift | 48 +++++++++---------- .../Wallet/WalletRespondService.swift | 2 +- Sources/Auth/Types/AuthPayload.swift | 2 +- .../Auth/Services/CacaosProvider.swift | 2 +- Sources/WalletConnectUtils/Cacao/Cacao.swift | 2 +- .../AuthPayloadBuilderTests.swift | 2 +- 6 files changed, 29 insertions(+), 29 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index cbb5f839f..66718151c 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -245,30 +245,30 @@ final class NotifyTests: XCTestCase { try await walletNotifyClientA.deleteSubscription(topic: notifyMessageRecord.topic) } } -// -// func testFetchHistory() async throws { -// let subscribeExpectation = expectation(description: "fetch notify subscription") -// let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! -// -// var subscription: NotifySubscription! -// walletNotifyClientA.subscriptionsPublisher -// .sink { subscriptions in -// subscription = subscriptions.first -// subscribeExpectation.fulfill() -// }.store(in: &publishers) -// -// try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in -// let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") -// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() -// return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) -// } -// -// await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) -// -// let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) -// XCTAssertTrue(hasMore) -// XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) -// } + + func testFetchHistory() async throws { + let subscribeExpectation = expectation(description: "fetch notify subscription") + let account = Account("eip155:1:0x622b17376F76d72C43527a917f59273247A917b4")! + + var subscription: NotifySubscription! + walletNotifyClientA.subscriptionsPublisher + .sink { subscriptions in + subscription = subscriptions.first + subscribeExpectation.fulfill() + }.store(in: &publishers) + + try await walletNotifyClientA.register(account: account, domain: gmDappDomain) { message in + let privateKey = Data(hex: "c3ff8a0ae33ac5d58e515055c5870fa2f220d070997bd6fd77a5f2c148528ff0") + let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() + return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) + } + + await fulfillment(of: [subscribeExpectation], timeout: InputConfig.defaultTimeout) + + let hasMore = try await walletNotifyClientA.fetchHistory(subscription: subscription, after: nil, limit: 20) + XCTAssertTrue(hasMore) + XCTAssertTrue(walletNotifyClientA.getMessageHistory(topic: subscription.topic).count == 20) + } } diff --git a/Sources/Auth/Services/Wallet/WalletRespondService.swift b/Sources/Auth/Services/Wallet/WalletRespondService.swift index 4470853e4..a06a16027 100644 --- a/Sources/Auth/Services/Wallet/WalletRespondService.swift +++ b/Sources/Auth/Services/Wallet/WalletRespondService.swift @@ -37,7 +37,7 @@ actor WalletRespondService { try kms.setAgreementSecret(keys, topic: topic) - let header = CacaoHeader(t: "caip122") + let header = CacaoHeader(t: "eip4361") let payload = try authRequestParams.payloadParams.cacaoPayload(address: account.address) let responseParams = AuthResponseParams(h: header, p: payload, s: signature) diff --git a/Sources/Auth/Types/AuthPayload.swift b/Sources/Auth/Types/AuthPayload.swift index 9f577bb6e..33ba49756 100644 --- a/Sources/Auth/Types/AuthPayload.swift +++ b/Sources/Auth/Types/AuthPayload.swift @@ -15,7 +15,7 @@ public struct AuthPayload: Codable, Equatable { public let resources: [String]? init(requestParams: RequestParams, iat: String) { - self.type = "caip122" + self.type = "eip4361" self.chainId = requestParams.chainId self.domain = requestParams.domain self.aud = requestParams.aud diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift index 70358d865..5ab42d879 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift @@ -4,7 +4,7 @@ import Foundation struct CacaosProvider { public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { let payload = try authPayload.cacaoPayload(account: account) - let header = CacaoHeader(t: "caip122") + let header = CacaoHeader(t: "eip4361") return Cacao(h: header, p: payload, s: signature) } } diff --git a/Sources/WalletConnectUtils/Cacao/Cacao.swift b/Sources/WalletConnectUtils/Cacao/Cacao.swift index 7a9edf812..16a0bf754 100644 --- a/Sources/WalletConnectUtils/Cacao/Cacao.swift +++ b/Sources/WalletConnectUtils/Cacao/Cacao.swift @@ -21,7 +21,7 @@ extension Cacao { account: Account = Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [String] = ["https://example.com/my-web2-claim.json"] ) -> Cacao { - let header = CacaoHeader(t: "caip122") + let header = CacaoHeader(t: "eip4361") let payload = CacaoPayload( iss: "did:pkh:\(account.absoluteString)", domain: "service.invalid", diff --git a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift index 85aff88b0..fd80fa766 100644 --- a/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift +++ b/Tests/WalletConnectSignTests/AuthPayloadBuilderTests.swift @@ -48,7 +48,7 @@ fileprivate func createSampleAuthPayload(domain: String = "example.com", version: String = "1", nonce: String = "nonce", chains: [String] = ["eip155:1"], - type: String = "caip122", + type: String = "eip4361", iat: String = "now", nbf: String? = nil, exp: String? = nil, From 11c64879c2257efc35648ecdfe96fe91692ecf92 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Feb 2024 15:42:53 +0100 Subject: [PATCH 410/814] fix sign unit test --- .../AuthenticatedSessionRecapFactoryTests.swift | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift index 1b5419be5..fbb9495d9 100644 --- a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift +++ b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift @@ -4,15 +4,11 @@ import XCTest final class AuthenticatedSessionRecapFactoryTests: XCTestCase { func testAuthenticatedSessionRecapFactory() { - // {"att":{"eip155":{"request/eth_sendTransaction":[],"request/personal_sign":[]}}} - let recapUrn1 = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W10sInJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W119fX0=" + // {"att":{"eip155":{"request/eth_sendTransaction":[{}],"request/personal_sign":[{}]}}} + let referenceRecap = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W3t9XSwicmVxdWVzdC9wZXJzb25hbF9zaWduIjpbe31dfX19" - // {"att":{"eip155":{"request/personal_sign":[],"request/eth_sendTransaction":[]}}} - let recapUrn2 = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W10sInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W119fX0=" - - let urns = [recapUrn1, recapUrn2] let recapUrn = try! AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: ["personal_sign", "eth_sendTransaction"]) - XCTAssertTrue(urns.contains(recapUrn)) + XCTAssertEqual(recapUrn, referenceRecap) } } From f95eb88257894ff789f4f98ddb2f38ecce9acb28 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Feb 2024 08:06:09 +0100 Subject: [PATCH 411/814] fix notify test --- Tests/NotifyTests/SubscriptionWatcherTests.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tests/NotifyTests/SubscriptionWatcherTests.swift b/Tests/NotifyTests/SubscriptionWatcherTests.swift index f38a6e28a..93f71057e 100644 --- a/Tests/NotifyTests/SubscriptionWatcherTests.swift +++ b/Tests/NotifyTests/SubscriptionWatcherTests.swift @@ -66,6 +66,6 @@ class SubscriptionWatcherTests: XCTestCase { try await sut.start() - await fulfillment(of: [expectation], timeout: 0.5) + wait(for: [expectation], timeout: 0.5) } } From 7673b47ab9522ffbc62a9634e8b6b58895b8db8b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Feb 2024 12:36:21 +0100 Subject: [PATCH 412/814] fix tests --- .../AuthenticatedSessionRecapFactoryTests.swift | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift index fbb9495d9..f6914597b 100644 --- a/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift +++ b/Tests/WalletConnectSignTests/AuthenticatedSessionRecapFactoryTests.swift @@ -5,10 +5,16 @@ final class AuthenticatedSessionRecapFactoryTests: XCTestCase { func testAuthenticatedSessionRecapFactory() { // {"att":{"eip155":{"request/eth_sendTransaction":[{}],"request/personal_sign":[{}]}}} - let referenceRecap = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W3t9XSwicmVxdWVzdC9wZXJzb25hbF9zaWduIjpbe31dfX19" + let recapUrn1 = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6W3t9XSwicmVxdWVzdC9wZXJzb25hbF9zaWduIjpbe31dfX19" + + + //{"att":{"eip155":{"request/personal_sign":[{}],"request/eth_sendTransaction":[{}]}}} + let recapUrn2 = "urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3QvcGVyc29uYWxfc2lnbiI6W3t9XSwicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjpbe31dfX19" let recapUrn = try! AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: ["personal_sign", "eth_sendTransaction"]) - XCTAssertEqual(recapUrn, referenceRecap) + let urns = [recapUrn1, recapUrn2] + + XCTAssertTrue(urns.contains(recapUrn)) } } From 19095370e494038835a0a9a3c81eafa187a3102e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Feb 2024 12:49:58 +0100 Subject: [PATCH 413/814] add siwe only --- Example/DApp/Modules/Sign/SignPresenter.swift | 19 +++++++++++++++++-- Example/DApp/Modules/Sign/SignView.swift | 12 ++++++++++++ 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 43f2d36f0..0b394f201 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -90,7 +90,21 @@ final class SignPresenter: ObservableObject { } catch { ActivityIndicatorManager.shared.stop() } + } + } + @MainActor + func connectWalletWithSessionAuthenticateSIWEOnly() { + Task { + do { + ActivityIndicatorManager.shared.start() + let uri = try await Sign.instance.authenticate(.stub(methods: nil)) + walletConnectUri = uri + ActivityIndicatorManager.shared.stop() + router.presentNewPairing(walletConnectUri: walletConnectUri!) + } catch { + ActivityIndicatorManager.shared.stop() + } } } @@ -213,7 +227,8 @@ extension AuthRequestParams { exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", requestId: String? = nil, - resources: [String]? = ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20vYWxsLWFwcHMiOnsiY3J1ZC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkL3N1YnNjcmlwdGlvbnMiOlt7fV19fX0K", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"] + resources: [String]? = ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20vYWxsLWFwcHMiOnsiY3J1ZC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkL3N1YnNjcmlwdGlvbnMiOlt7fV19fX0K", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], + methods: [String]? = ["eth_sign", "personal_sign", "eth_sendTransaction"] ) -> AuthRequestParams { return AuthRequestParams( domain: domain, @@ -225,7 +240,7 @@ extension AuthRequestParams { statement: statement, requestId: requestId, resources: resources, - methods: ["eth_sign", "personal_sign", "eth_sendTransaction"] + methods: methods ) } } diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index ef5017ed3..9e7ea99a6 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -56,6 +56,18 @@ struct SignView: View { .cornerRadius(16) } + Button { + presenter.connectWalletWithSessionAuthenticateSIWEOnly() + } label: { + Text("Connect Session Authenticate - SIWE only") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + Button { presenter.connectWalletWithWCM() } label: { From 733be946d0e18589ab0acc4da974c3f50d0b51bc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Feb 2024 08:59:04 +0100 Subject: [PATCH 414/814] add back auth package --- Package.swift | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Package.swift b/Package.swift index 024d7f6e9..41f0e9bbc 100644 --- a/Package.swift +++ b/Package.swift @@ -16,6 +16,9 @@ let package = Package( .library( name: "WalletConnectChat", targets: ["WalletConnectChat"]), + .library( + name: "WalletConnectAuth", + targets: ["Auth"]), .library( name: "Web3Wallet", targets: ["Web3Wallet"]), @@ -60,6 +63,10 @@ let package = Package( name: "WalletConnectChat", dependencies: ["WalletConnectIdentity", "WalletConnectSync"], path: "Sources/Chat"), + .target( + name: "Auth", + dependencies: ["WalletConnectPairing", "WalletConnectSigner", "WalletConnectVerify"], + path: "Sources/Auth"), .target( name: "Web3Wallet", dependencies: ["WalletConnectSign", "WalletConnectPush", "WalletConnectVerify"], From 48228303136da0a57ccfa538be1064d20bf54e8a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Feb 2024 09:40:39 +0100 Subject: [PATCH 415/814] savepoint --- .../Auth/AuthProtocolMethod.swift | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift index bbd0c2c1c..062715de6 100644 --- a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -7,19 +7,3 @@ struct SessionAuthenticatedProtocolMethod: ProtocolMethod { let responseConfig = RelayConfig(tag: 1117, prompt: false, ttl: 3600) } - -struct PairingPingProtocolMethod: ProtocolMethod { - let method: String = "wc_pairingPing" - - let requestConfig = RelayConfig(tag: 1002, prompt: false, ttl: 30) - - let responseConfig = RelayConfig(tag: 1003, prompt: false, ttl: 30) -} - -struct PairingDeleteProtocolMethod: ProtocolMethod { - let method: String = "wc_pairingDelete" - - let requestConfig = RelayConfig(tag: 1000, prompt: false, ttl: 86400) - - let responseConfig = RelayConfig(tag: 1001, prompt: false, ttl: 86400) -} From 29a43ee89fab2568871dcbc25b54725ac439c3c6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Feb 2024 11:26:18 +0100 Subject: [PATCH 416/814] Add AuthResponseTopicResubscriptionService --- .../Services/App/AuthResponseSubscriber.swift | 12 +++- .../App/SessionAuthRequestService.swift | 7 ++- ...thResponseTopicResubscriptionService.swift | 56 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 5 +- .../Sign/SignClientFactory.swift | 11 ++-- .../SignStorageIdentifiers.swift | 1 + 6 files changed, 84 insertions(+), 8 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 24dfc31a4..8c921ae63 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -16,6 +16,7 @@ class AuthResponseSubscriber { public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result<(Session?, [Cacao]), AuthError>), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } + private let authResponseTopicRecordsStore: CodableStore init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -25,7 +26,8 @@ class AuthResponseSubscriber { kms: KeyManagementServiceProtocol, sessionStore: WCSessionStorage, messageFormatter: SIWECacaoFormatting, - sessionNamespaceBuilder: SessionNamespaceBuilder) { + sessionNamespaceBuilder: SessionNamespaceBuilder, + authResponseTopicRecordsStore: CodableStore) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -35,6 +37,7 @@ class AuthResponseSubscriber { self.messageFormatter = messageFormatter self.pairingRegisterer = pairingRegisterer self.sessionNamespaceBuilder = sessionNamespaceBuilder + self.authResponseTopicRecordsStore = authResponseTopicRecordsStore subscribeForResponse() } @@ -43,6 +46,7 @@ class AuthResponseSubscriber { .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) + removeResponseTopicRecord(responseTopic: payload.topic) }.store(in: &publishers) networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) @@ -50,12 +54,12 @@ class AuthResponseSubscriber { let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) + removeResponseTopicRecord(responseTopic: payload.topic) let requestId = payload.id let cacaos = payload.response.cacaos let authRequestPayload = payload.request.authPayload - Task { do { try await recoverAndVerifySignature(cacaos: cacaos) @@ -146,5 +150,9 @@ class AuthResponseSubscriber { return session.publicRepresentation() } + func removeResponseTopicRecord(responseTopic: String) { + authResponseTopicRecordsStore.delete(forKey: responseTopic) + networkingInteractor.unsubscribe(topic: responseTopic) + } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 6bedcac33..8c21fe960 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -9,17 +9,20 @@ actor SessionAuthRequestService { private let kms: KeyManagementService private let logger: ConsoleLogging private let iatProvader: IATProvider + private let authResponseTopicRecordsStore: CodableStore init(networkingInteractor: NetworkInteracting, kms: KeyManagementService, appMetadata: AppMetadata, logger: ConsoleLogging, - iatProvader: IATProvider) { + iatProvader: IATProvider, + authResponseTopicRecordsStore: CodableStore) { self.networkingInteractor = networkingInteractor self.kms = kms self.appMetadata = appMetadata self.logger = logger self.iatProvader = iatProvader + self.authResponseTopicRecordsStore = authResponseTopicRecordsStore } func request(params: AuthRequestParams, topic: String) async throws { @@ -40,6 +43,8 @@ actor SessionAuthRequestService { let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) let sessionAuthenticateRequestParams = SessionAuthenticateRequestParams(requester: requester, authPayload: payload) + let authResponseTopicRecord = AuthResponseTopicRecord(topic: responseTopic, unixTimestamp: sessionAuthenticateRequestParams.expiryTimestamp) + authResponseTopicRecordsStore.set(authResponseTopicRecord, forKey: responseTopic) let request = RPCRequest(method: protocolMethod.method, params: sessionAuthenticateRequestParams) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") diff --git a/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift b/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift new file mode 100644 index 000000000..70424a123 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift @@ -0,0 +1,56 @@ +import Foundation +import Combine + +struct AuthResponseTopicRecord: Codable { + let topic: String + let expiry: Date + + var isExpired: Bool { + expiry < Date() + } + + init(topic: String, unixTimestamp: UInt64) { + self.topic = topic + self.expiry = Date(timeIntervalSince1970: TimeInterval(unixTimestamp)) + } +} + +class AuthResponseTopicResubscriptionService { + private let networkingInteractor: NetworkInteracting + private let logger: ConsoleLogging + private var publishers = [AnyCancellable]() + private let authResponseTopicRecordsStore: CodableStore + + init( + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + authResponseTopicRecordsStore: CodableStore + ) { + self.networkingInteractor = networkingInteractor + self.logger = logger + self.authResponseTopicRecordsStore = authResponseTopicRecordsStore + cleanExpiredRecordsIfNeeded() + setupConnectionSubscriptions() + } + + func setupConnectionSubscriptions() { + networkingInteractor.socketConnectionStatusPublisher + .sink { [unowned self] status in + guard status == .connected else { return } + logger.debug("Resubscribing to auth response topics") + let topics = authResponseTopicRecordsStore.getAll().map{$0.topic} + Task(priority: .high) { + try await networkingInteractor.batchSubscribe(topics: topics) + } + } + .store(in: &publishers) + } + + func cleanExpiredRecordsIfNeeded() { + authResponseTopicRecordsStore.getAll().forEach { record in + if record.isExpired { + authResponseTopicRecordsStore.delete(forKey: record.topic) + } + } + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 8c67a75de..b89cd494b 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -161,6 +161,7 @@ public final class SignClient: SignClientProtocol { private let authResposeSubscriber: AuthResponseSubscriber private let authRequestSubscriber: AuthRequestSubscriber private let authResponder: AuthResponder + private let authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() private let socketConnectionStatusPublisherSubject = PassthroughSubject() @@ -202,7 +203,8 @@ public final class SignClient: SignClientProtocol { pendingRequestsProvider: PendingRequestsProvider, proposalExpiryWatcher: ProposalExpiryWatcher, pendingProposalsProvider: PendingProposalsProvider, - requestsExpiryWatcher: RequestsExpiryWatcher + requestsExpiryWatcher: RequestsExpiryWatcher, + authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService ) { self.logger = logger self.networkingClient = networkingClient @@ -228,6 +230,7 @@ public final class SignClient: SignClientProtocol { self.proposalExpiryWatcher = proposalExpiryWatcher self.pendingProposalsProvider = pendingProposalsProvider self.requestsExpiryWatcher = requestsExpiryWatcher + self.authResponseTopicResubscriptionService = authResponseTopicResubscriptionService setUpConnectionObserving() setUpEnginesCallbacks() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index e20920689..33e8a3628 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -94,18 +94,20 @@ public struct SignClientFactory { //Auth + let authResponseTopicRecordsStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.authResponseTopicRecord.rawValue) let messageFormatter = SIWECacaoFormatter() - let appRequestService = SessionAuthRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider) + let appRequestService = SessionAuthRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore) let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let sessionNameSpaceBuilder = SessionNamespaceBuilder(logger: logger) - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder) - + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore) + let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) + let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) let client = SignClient( @@ -132,7 +134,8 @@ public struct SignClientFactory { pendingRequestsProvider: pendingRequestsProvider, proposalExpiryWatcher: proposalExpiryWatcher, pendingProposalsProvider: pendingProposalsProvider, - requestsExpiryWatcher: requestsExpiryWatcher + requestsExpiryWatcher: requestsExpiryWatcher, + authResponseTopicResubscriptionService: authResponseTopicResubscriptionService ) return client } diff --git a/Sources/WalletConnectSign/SignStorageIdentifiers.swift b/Sources/WalletConnectSign/SignStorageIdentifiers.swift index 8854dd4e8..86c6b5c9a 100644 --- a/Sources/WalletConnectSign/SignStorageIdentifiers.swift +++ b/Sources/WalletConnectSign/SignStorageIdentifiers.swift @@ -5,4 +5,5 @@ enum SignStorageIdentifiers: String { case sessions = "com.walletconnect.sdk.sessionSequences" case proposals = "com.walletconnect.sdk.sessionProposals" case sessionTopicToProposal = "com.walletconnect.sdk.sessionTopicToProposal" + case authResponseTopicRecord = "com.walletconnect.sdk.authResponseTopicRecord" } From 02c9ecf8a5cd461c73ac5fa165d878732982ec8f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Feb 2024 11:37:02 +0100 Subject: [PATCH 417/814] update error logging --- Sources/HTTPClient/HTTPNetworkClient.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/HTTPClient/HTTPNetworkClient.swift b/Sources/HTTPClient/HTTPNetworkClient.swift index 13b491974..a541bfce4 100644 --- a/Sources/HTTPClient/HTTPNetworkClient.swift +++ b/Sources/HTTPClient/HTTPNetworkClient.swift @@ -31,7 +31,7 @@ public actor HTTPNetworkClient: HTTPClient { } } } - + public func updateHost(host: String) async { self.host = host } @@ -41,7 +41,7 @@ public actor HTTPNetworkClient: HTTPClient { completion(.failure(HTTPError.malformedURL(service))) return } - + session.dataTask(with: request) { data, response, error in do { try HTTPNetworkClient.validate(response, error, data: data) @@ -84,7 +84,7 @@ public actor HTTPNetworkClient: HTTPClient { } guard (200..<300) ~= httpResponse.statusCode else { if let data = data { - print("HTTP error: \(String(decoding: data, as: UTF8.self))") + print("HTTP error: \(String(decoding: data, as: UTF8.self)) code: \(httpResponse.statusCode), host: \(httpResponse.url?.host ?? "unknown")") } throw HTTPError.badStatusCode(httpResponse.statusCode) } From fe8bfd66cde487c7dc1e98dc04625d4843185ab0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Feb 2024 11:44:53 +0100 Subject: [PATCH 418/814] savepoint --- Sources/HTTPClient/HTTPNetworkClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/HTTPClient/HTTPNetworkClient.swift b/Sources/HTTPClient/HTTPNetworkClient.swift index a541bfce4..f5552e02d 100644 --- a/Sources/HTTPClient/HTTPNetworkClient.swift +++ b/Sources/HTTPClient/HTTPNetworkClient.swift @@ -84,7 +84,7 @@ public actor HTTPNetworkClient: HTTPClient { } guard (200..<300) ~= httpResponse.statusCode else { if let data = data { - print("HTTP error: \(String(decoding: data, as: UTF8.self)) code: \(httpResponse.statusCode), host: \(httpResponse.url?.host ?? "unknown")") + print("HTTP error: \(String(decoding: data, as: UTF8.self)) code: \(httpResponse.statusCode), host: \(httpResponse.url?.host ?? "unknown"), path: \(httpResponse.url?.path ?? "unknown")") } throw HTTPError.badStatusCode(httpResponse.statusCode) } From 5384070c2bf91971c5080f5cdaadf80c6f450969 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Feb 2024 08:32:35 +0100 Subject: [PATCH 419/814] add notify recap --- Sources/WalletConnectIdentity/IdentityClient.swift | 2 +- Sources/WalletConnectIdentity/IdentityService.swift | 11 +++++++++-- .../Client/Wallet/NotifyClient.swift | 12 +++++++++--- .../WalletConnectUtils/SIWE/SIWECacaoFormatter.swift | 2 +- 4 files changed, 20 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectIdentity/IdentityClient.swift b/Sources/WalletConnectIdentity/IdentityClient.swift index 8958b5112..10b0dc922 100644 --- a/Sources/WalletConnectIdentity/IdentityClient.swift +++ b/Sources/WalletConnectIdentity/IdentityClient.swift @@ -24,7 +24,7 @@ public final class IdentityClient { public func prepareRegistration(account: Account, domain: String, - statement: String, + statement: String? = nil, resources: [String]) async throws -> IdentityRegistrationParams { let registration = try await identityService.prepareRegistration(account: account, domain: domain, statement: statement, resources: resources) diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index 96cd34215..17e86197f 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -27,15 +27,17 @@ actor IdentityService { func prepareRegistration(account: Account, domain: String, - statement: String, + statement: String? = nil, resources: [String]) throws -> IdentityRegistrationParams { let identityKey = SigningPrivateKey() + let uri = buildUri(domain: domain, didKey: identityKey.publicKey.did) + let payload = CacaoPayload( iss: account.did, domain: domain, - aud: identityKey.publicKey.did, + aud: uri, version: getVersion(), nonce: getNonce(), iat: iatProvader.iat, @@ -50,6 +52,11 @@ actor IdentityService { return IdentityRegistrationParams(message: message, payload: payload, privateIdentityKey: identityKey) } + func buildUri(domain: String, didKey: String) -> String { + let identityKey = SigningPrivateKey() + return "\(domain)?walletconnect_identity_token=\(didKey)" + } + // TODO: Verifications func registerIdentity(params: IdentityRegistrationParams, signature: CacaoSignature) async throws -> String { let account = try params.account diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 6b5aa22fc..7aa2b24b0 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -1,6 +1,7 @@ import Foundation import Combine + public class NotifyClient { private var publishers = Set() @@ -87,15 +88,20 @@ public class NotifyClient { self.subscriptionWatcher = subscriptionWatcher } - public func prepareRegistration(account: Account, domain: String, allApps: Bool = true) async throws -> IdentityRegistrationParams { + public func prepareRegistration(account: Account, domain: String) async throws -> IdentityRegistrationParams { return try await identityClient.prepareRegistration( account: account, domain: domain, - statement: makeStatement(allApps: allApps), - resources: [keyserverURL.absoluteString] + resources: [keyserverURL.absoluteString, createAuthorizationRecap()] ) } + /// returns notify recap for all apps + public func createAuthorizationRecap() -> String { + // {"att":{"walletconnect-notify":{"manage/all-apps-notifications":[{}]}}} + "urn:recap:eyJhdHQiOnsid2FsbGV0Y29ubmVjdC1ub3RpZnkiOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0=" + } + public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { try await identityClient.register(params: params, signature: signature) notifyAccountProvider.setAccount(try params.account) diff --git a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift index 4721f69db..1abd44997 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift @@ -5,7 +5,7 @@ public protocol SIWECacaoFormatting { } public extension SIWECacaoFormatting { func formatMessage(from payload: CacaoPayload) throws -> String { - return try formatMessage(from: payload, includeRecapInTheStatement: false) + return try formatMessage(from: payload, includeRecapInTheStatement: true) } } public struct SIWECacaoFormatter: SIWECacaoFormatting { From 15f96c2d9c40ae93336fc0fe6fe8b2cbc0d3bc2f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Feb 2024 08:40:26 +0100 Subject: [PATCH 420/814] savepoint --- Example/IntegrationTests/Push/NotifyTests.swift | 2 +- .../Client/Wallet/NotifyClient.swift | 12 ++++++------ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 66718151c..08369e9cf 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -281,7 +281,7 @@ private extension NotifyTests { private extension NotifyClient { - func register(account: Account, domain: String, isLimited: Bool = false, onSign: @escaping (String) -> CacaoSignature) async throws { + func register(account: Account, domain: String, onSign: @escaping (String) -> CacaoSignature) async throws { let params = try await prepareRegistration(account: account, domain: domain) let signature = onSign(params.message) try await register(params: params, signature: signature) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 7aa2b24b0..761b0c66f 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -96,12 +96,6 @@ public class NotifyClient { ) } - /// returns notify recap for all apps - public func createAuthorizationRecap() -> String { - // {"att":{"walletconnect-notify":{"manage/all-apps-notifications":[{}]}}} - "urn:recap:eyJhdHQiOnsid2FsbGV0Y29ubmVjdC1ub3RpZnkiOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0=" - } - public func register(params: IdentityRegistrationParams, signature: CacaoSignature) async throws { try await identityClient.register(params: params, signature: signature) notifyAccountProvider.setAccount(try params.account) @@ -178,6 +172,12 @@ public class NotifyClient { return messages.count == limit } + + /// returns notify recap for all apps + private func createAuthorizationRecap() -> String { + // {"att":{"walletconnect-notify":{"manage/all-apps-notifications":[{}]}}} + "urn:recap:eyJhdHQiOnsid2FsbGV0Y29ubmVjdC1ub3RpZnkiOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0=" + } } private extension NotifyClient { From 57b8eb991b4bf3ae2ee6cfe19ebf3bab4be0e594 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Feb 2024 08:57:13 +0100 Subject: [PATCH 421/814] savepoint --- Sources/WalletConnectIdentity/IdentityService.swift | 1 - 1 file changed, 1 deletion(-) diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index 17e86197f..efc5ff3b7 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -53,7 +53,6 @@ actor IdentityService { } func buildUri(domain: String, didKey: String) -> String { - let identityKey = SigningPrivateKey() return "\(domain)?walletconnect_identity_token=\(didKey)" } From 9207ff4ddbe51e91100bbcae9fecd106c120d4a9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 10:14:10 +0100 Subject: [PATCH 422/814] rename method --- Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index b89cd494b..e57b62324 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -286,7 +286,7 @@ public final class SignClient: SignClientProtocol { /// For a dApp to propose an authenticated session to a wallet. /// Function will propose a session on existing pairing. - public func sessionAuthenticate( + public func authenticate( _ params: AuthRequestParams, topic: String ) async throws { From bbed8fae9085f8764c6b6ee52055e9202f056d13 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 10:18:48 +0100 Subject: [PATCH 423/814] change relay request ttimeout to 60s --- Sources/WalletConnectRelay/RelayClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 5ff6135fd..e1a1b9197 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -109,7 +109,7 @@ public final class RelayClient { cancellable = requestAcknowledgePublisher .filter { $0 == request.id } .setFailureType(to: RelayError.self) - .timeout(.seconds(10), scheduler: concurrentQueue, customError: { .requestTimeout }) + .timeout(.seconds(60), scheduler: concurrentQueue, customError: { .requestTimeout }) .sink(receiveCompletion: { [unowned self] result in switch result { case .failure(let error): From fa63f25f1fcc1c404b9a02bb2066d5589ed698c6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 10:46:04 +0100 Subject: [PATCH 424/814] change aud to uri --- Example/DApp/Modules/Sign/SignPresenter.swift | 4 +-- .../xcschemes/WalletConnect.xcscheme | 29 ++++++------------ .../Auth/Signer/CacaoSignerTests.swift | 2 +- .../Sign/SignClientTests.swift | 2 +- .../Auth/Types/AuthPayload.swift | 2 +- .../Auth/Types/AuthRequestParams.swift | 10 +++---- .../SubscriptionWatcherTests.swift | 30 +++++++++---------- .../SIWEMessageFormatterTests.swift | 2 +- .../Stub/AuthRequestParams.swift | 26 ---------------- 9 files changed, 35 insertions(+), 72 deletions(-) delete mode 100644 Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 0b394f201..38a2b3f22 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -222,7 +222,7 @@ extension AuthRequestParams { domain: String = "app.web3inbox", chains: [String] = ["eip155:1", "eip155:137"], nonce: String = "32891756", - aud: String = "https://app.web3inbox.com/login", + uri: String = "https://app.web3inbox.com/login", nbf: String? = nil, exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", @@ -234,7 +234,7 @@ extension AuthRequestParams { domain: domain, chains: chains, nonce: nonce, - aud: aud, + uri: uri, nbf: nbf, exp: exp, statement: statement, diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme index b5824ecd8..16ee2100a 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme @@ -178,16 +178,6 @@ - - - - - - - - + + + + diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index 433fa2d52..0591090e8 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -34,7 +34,7 @@ class CacaoSignerTest: XCTestCase { domain: "service.invalid", chains: ["eip155:1"], nonce: "32891756", - aud: "https://service.invalid/login", + uri: "https://service.invalid/login", nbf: nil, exp: nil, statement: "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 79c8e6b04..142260707 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -896,7 +896,7 @@ final class SignClientTests: XCTestCase { domain: "etherscan.io", chains: ["eip155:1"], nonce: "DTYxeNr95Ne7Sape5", - aud: "https://etherscan.io/verifiedSignatures#", + uri: "https://etherscan.io/verifiedSignatures#", nbf: nil, exp: nil, statement: "Sign message to verify ownership of the address 0x6DF3d14554742D67068BB7294C80107a3c655A56 on etherscan.io", diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index f106fff21..6c13e9002 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -47,7 +47,7 @@ public struct AuthPayload: Codable, Equatable { self.type = "eip4361" self.chains = requestParams.chains self.domain = requestParams.domain - self.aud = requestParams.aud + self.aud = requestParams.uri self.version = "1" self.nonce = requestParams.nonce self.iat = iat diff --git a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift index 10577251e..33ead972f 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift @@ -8,7 +8,7 @@ public struct AuthRequestParams { public let domain: String public let chains: [String] public let nonce: String - public let aud: String + public let uri: String public let nbf: String? public let exp: String? public let statement: String? @@ -20,7 +20,7 @@ public struct AuthRequestParams { domain: String, chains: [String], nonce: String, - aud: String, + uri: String, nbf: String?, exp: String?, statement: String?, @@ -31,7 +31,7 @@ public struct AuthRequestParams { self.domain = domain self.chains = chains self.nonce = nonce - self.aud = aud + self.uri = uri self.nbf = nbf self.exp = exp self.statement = statement @@ -51,7 +51,7 @@ extension AuthRequestParams { static func stub(domain: String = "service.invalid", chains: [String] = ["eip155:1"], nonce: String = "32891756", - aud: String = "https://service.invalid/login", + uri: String = "https://service.invalid/login", nbf: String? = nil, exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", @@ -61,7 +61,7 @@ extension AuthRequestParams { return AuthRequestParams(domain: domain, chains: chains, nonce: nonce, - aud: aud, + uri: uri, nbf: nbf, exp: exp, statement: statement, diff --git a/Tests/NotifyTests/SubscriptionWatcherTests.swift b/Tests/NotifyTests/SubscriptionWatcherTests.swift index 93f71057e..473a150d3 100644 --- a/Tests/NotifyTests/SubscriptionWatcherTests.swift +++ b/Tests/NotifyTests/SubscriptionWatcherTests.swift @@ -38,21 +38,21 @@ class SubscriptionWatcherTests: XCTestCase { await fulfillment(of: [expectation], timeout: 0.5) } - - func testWatchAppLifecycleReactsToEnterForegroundNotification() async throws { - let watchSubscriptionsExpectation = XCTestExpectation(description: "Expect watchSubscriptions to be called on app enter foreground") - watchSubscriptionsExpectation.expectedFulfillmentCount = 2 - - mockRequester.onWatchSubscriptions = { - watchSubscriptionsExpectation.fulfill() - } - - try await sut.start() - - await mockNotificationCenter.post(name: UIApplication.willEnterForegroundNotification) - - await fulfillment(of: [watchSubscriptionsExpectation], timeout: 0.5) - } +// +// func testWatchAppLifecycleReactsToEnterForegroundNotification() async throws { +// let watchSubscriptionsExpectation = XCTestExpectation(description: "Expect watchSubscriptions to be called on app enter foreground") +// watchSubscriptionsExpectation.expectedFulfillmentCount = 2 +// +// mockRequester.onWatchSubscriptions = { +// watchSubscriptionsExpectation.fulfill() +// } +// +// try await sut.start() +// +// await mockNotificationCenter.post(name: UIApplication.willEnterForegroundNotification) +// +// await fulfillment(of: [watchSubscriptionsExpectation], timeout: 0.5) +// } func testTimerTriggeringWatchSubscriptionsMultipleTimes() async throws { sut.timerInterval = 0.0001 diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 190980483..57c877fc9 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -179,7 +179,7 @@ class SIWEMessageFormatterTests: XCTestCase { let uri = "https://service.invalid?walletconnect_notify_key=did:key:z6MktW4hKdsvcXgt9wXmYbSD5sH4NCk5GmNZnokP9yh2TeCf" let payload = try AuthPayload.stub( - requestParams: AuthRequestParams.stub(aud: uri, statement: nil,resources: [recap1, recap2]) + requestParams: AuthRequestParams.stub(uri: uri, statement: nil,resources: [recap1, recap2]) ).cacaoPayload(account: Account.stub()) let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) diff --git a/Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift b/Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift deleted file mode 100644 index 11ce6bafc..000000000 --- a/Tests/WalletConnectSignTests/Stub/AuthRequestParams.swift +++ /dev/null @@ -1,26 +0,0 @@ -import Foundation -@testable import WalletConnectSign - -extension AuthRequestParams { - static func stub(domain: String = "service.invalid", - chains: [String] = ["eip155:1"], - nonce: String = "32891756", - aud: String = "https://service.invalid/login", - nbf: String? = nil, - exp: String? = nil, - statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", - requestId: String? = nil, - resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = ["personal_sign"]) -> AuthRequestParams { - return AuthRequestParams(domain: domain, - chains: chains, - nonce: nonce, - aud: aud, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources, - methods: methods) - } -} From a316f0956da9a9cbabf029b4efbe6e22fd8b7078 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 10:46:27 +0100 Subject: [PATCH 425/814] savepoint --- .../SubscriptionWatcherTests.swift | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/Tests/NotifyTests/SubscriptionWatcherTests.swift b/Tests/NotifyTests/SubscriptionWatcherTests.swift index 473a150d3..93f71057e 100644 --- a/Tests/NotifyTests/SubscriptionWatcherTests.swift +++ b/Tests/NotifyTests/SubscriptionWatcherTests.swift @@ -38,21 +38,21 @@ class SubscriptionWatcherTests: XCTestCase { await fulfillment(of: [expectation], timeout: 0.5) } -// -// func testWatchAppLifecycleReactsToEnterForegroundNotification() async throws { -// let watchSubscriptionsExpectation = XCTestExpectation(description: "Expect watchSubscriptions to be called on app enter foreground") -// watchSubscriptionsExpectation.expectedFulfillmentCount = 2 -// -// mockRequester.onWatchSubscriptions = { -// watchSubscriptionsExpectation.fulfill() -// } -// -// try await sut.start() -// -// await mockNotificationCenter.post(name: UIApplication.willEnterForegroundNotification) -// -// await fulfillment(of: [watchSubscriptionsExpectation], timeout: 0.5) -// } + + func testWatchAppLifecycleReactsToEnterForegroundNotification() async throws { + let watchSubscriptionsExpectation = XCTestExpectation(description: "Expect watchSubscriptions to be called on app enter foreground") + watchSubscriptionsExpectation.expectedFulfillmentCount = 2 + + mockRequester.onWatchSubscriptions = { + watchSubscriptionsExpectation.fulfill() + } + + try await sut.start() + + await mockNotificationCenter.post(name: UIApplication.willEnterForegroundNotification) + + await fulfillment(of: [watchSubscriptionsExpectation], timeout: 0.5) + } func testTimerTriggeringWatchSubscriptionsMultipleTimes() async throws { sut.timerInterval = 0.0001 From 922b62e4f2386f5e35986988cfccd1234edd0349 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 11:18:53 +0100 Subject: [PATCH 426/814] fix relay tests --- Sources/WalletConnectRelay/RelayClient.swift | 4 ++-- Tests/RelayerTests/Mocks/DispatcherMock.swift | 11 +++++++++++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index e1a1b9197..5772b9297 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -102,8 +102,8 @@ public final class RelayClient { logger.debug("[Publish] Sending payload on topic: \(topic)") - try await dispatcher.protectedSend(message) - + Task {try await dispatcher.protectedSend(message)} +x§ return try await withUnsafeThrowingContinuation { continuation in var cancellable: AnyCancellable? cancellable = requestAcknowledgePublisher diff --git a/Tests/RelayerTests/Mocks/DispatcherMock.swift b/Tests/RelayerTests/Mocks/DispatcherMock.swift index 869e3a0f9..2e12b6ab2 100644 --- a/Tests/RelayerTests/Mocks/DispatcherMock.swift +++ b/Tests/RelayerTests/Mocks/DispatcherMock.swift @@ -37,6 +37,17 @@ class DispatcherMock: Dispatching { func send(_ string: String, completion: @escaping (Error?) -> Void) { sent = true lastMessage = string + + usleep(20) + if let data = string.data(using: .utf8), + let request = try? JSONDecoder().decode(RPCRequest.self, from: data) { + // Simulate the response + let response = RPCResponse(matchingRequest: request, result: (AnyCodable(true))) + // Trigger the onMessage with the response to simulate an instant acknowledgment + if let jsonResponse = try? response.asJSONEncodedString() { + self.onMessage?(jsonResponse) + } + } } func send(_ string: String) async throws { send(string, completion: { _ in }) From 656c090008a1948765a3e8a6c836fd78ed407054 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 11:21:03 +0100 Subject: [PATCH 427/814] fix --- Sources/WalletConnectRelay/RelayClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 5772b9297..c3146adc3 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -103,7 +103,7 @@ public final class RelayClient { logger.debug("[Publish] Sending payload on topic: \(topic)") Task {try await dispatcher.protectedSend(message)} -x§ + return try await withUnsafeThrowingContinuation { continuation in var cancellable: AnyCancellable? cancellable = requestAcknowledgePublisher From b0158bb805631699ba6fecc2877d1286cbd0c81c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 12:20:21 +0100 Subject: [PATCH 428/814] add ttl param --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- .../Auth/AuthProtocolMethod.swift | 8 ++++++++ .../App/SessionAuthRequestService.swift | 4 ++-- .../Auth/Types/AuthRequestParams.swift | 20 ++++++++++++++++--- .../SessionAuthenticateRequestParams.swift | 2 +- 5 files changed, 29 insertions(+), 7 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 38a2b3f22..832850a7f 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -230,7 +230,7 @@ extension AuthRequestParams { resources: [String]? = ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20vYWxsLWFwcHMiOnsiY3J1ZC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkL3N1YnNjcmlwdGlvbnMiOlt7fV19fX0K", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], methods: [String]? = ["eth_sign", "personal_sign", "eth_sendTransaction"] ) -> AuthRequestParams { - return AuthRequestParams( + return try! AuthRequestParams( domain: domain, chains: chains, nonce: nonce, diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift index 062715de6..6005e63e5 100644 --- a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift @@ -6,4 +6,12 @@ struct SessionAuthenticatedProtocolMethod: ProtocolMethod { let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 3600) let responseConfig = RelayConfig(tag: 1117, prompt: false, ttl: 3600) + + + static let defaultTtl: TimeInterval = 3600 + private let ttl: Int + + init(ttl: TimeInterval = Self.defaultTtl) { + self.ttl = Int(ttl) + } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index 8c21fe960..b26a40f0e 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -29,7 +29,7 @@ actor SessionAuthRequestService { var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() - let protocolMethod = SessionAuthenticatedProtocolMethod() + let protocolMethod = SessionAuthenticatedProtocolMethod(ttl: params.ttl) guard let chainNamespace = Blockchain(params.chains.first!)?.namespace, chainNamespace == "eip155" else { @@ -42,7 +42,7 @@ actor SessionAuthRequestService { } let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) - let sessionAuthenticateRequestParams = SessionAuthenticateRequestParams(requester: requester, authPayload: payload) + let sessionAuthenticateRequestParams = SessionAuthenticateRequestParams(requester: requester, authPayload: payload, ttl: params.ttl) let authResponseTopicRecord = AuthResponseTopicRecord(topic: responseTopic, unixTimestamp: sessionAuthenticateRequestParams.expiryTimestamp) authResponseTopicRecordsStore.set(authResponseTopicRecord, forKey: responseTopic) let request = RPCRequest(method: protocolMethod.method, params: sessionAuthenticateRequestParams) diff --git a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift index 33ead972f..7b4c2a7fd 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift @@ -5,6 +5,9 @@ import Foundation /// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-74.md /// https://eips.ethereum.org/EIPS/eip-4361 public struct AuthRequestParams { + public enum Errors: Error { + case invalidTtl + } public let domain: String public let chains: [String] public let nonce: String @@ -15,6 +18,11 @@ public struct AuthRequestParams { public let requestId: String? public var resources: [String]? public let methods: [String]? + public let ttl: TimeInterval + + // TTL bounds + static let minTtl: TimeInterval = 300 // 5 minutes + static let maxTtl: TimeInterval = 604800 // 7 days public init( domain: String, @@ -26,8 +34,13 @@ public struct AuthRequestParams { statement: String?, requestId: String?, resources: [String]?, - methods: [String]? - ) { + methods: [String]?, + ttl: TimeInterval = 3600 + ) throws { + guard ttl >= Request.minTtl && ttl <= Request.maxTtl else { + throw Errors.invalidTtl + } + self.domain = domain self.chains = chains self.nonce = nonce @@ -38,6 +51,7 @@ public struct AuthRequestParams { self.requestId = requestId self.resources = resources self.methods = methods + self.ttl = ttl } mutating func addResource(resource: String) { @@ -58,7 +72,7 @@ extension AuthRequestParams { requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> AuthRequestParams { - return AuthRequestParams(domain: domain, + return try! AuthRequestParams(domain: domain, chains: chains, nonce: nonce, uri: uri, diff --git a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift index 170cfe3fc..f1044eb35 100644 --- a/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/ProtocolRPCParams/SessionAuthenticateRequestParams.swift @@ -7,7 +7,7 @@ struct SessionAuthenticateRequestParams: Codable, Equatable, Expirable { let authPayload: AuthPayload let expiryTimestamp: UInt64 - init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval = 3600) { + init(requester: Participant, authPayload: AuthPayload, ttl: TimeInterval) { self.requester = requester self.authPayload = authPayload self.expiryTimestamp = UInt64(Date().timeIntervalSince1970) + UInt64(ttl) From 3da2c4b34cd81d943ee4d1a03aab27f17360bdc6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 12:43:34 +0100 Subject: [PATCH 429/814] update requested methods --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 832850a7f..d49943356 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -228,7 +228,7 @@ extension AuthRequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", requestId: String? = nil, resources: [String]? = ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20vYWxsLWFwcHMiOnsiY3J1ZC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkL3N1YnNjcmlwdGlvbnMiOlt7fV19fX0K", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = ["eth_sign", "personal_sign", "eth_sendTransaction"] + methods: [String]? = ["personal_sign", "eth_sendTransaction"] ) -> AuthRequestParams { return try! AuthRequestParams( domain: domain, From 30cb2f74cbb57f8a5fb7ea78250182bc004f2342 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Feb 2024 14:33:00 +0100 Subject: [PATCH 430/814] fix build --- Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index 0591090e8..90a17b00e 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -30,7 +30,7 @@ class CacaoSignerTest: XCTestCase { - https://example.com/my-web2-claim.json """ - let payload = AuthPayload(requestParams: AuthRequestParams( + let payload = try! AuthPayload(requestParams: AuthRequestParams( domain: "service.invalid", chains: ["eip155:1"], nonce: "32891756", From 29c1317525eaf1b08b7a376e89e0ead67b8bba0b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 1 Mar 2024 11:23:11 +0100 Subject: [PATCH 431/814] fix bug --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- .../WalletConnectSign/Auth/Types/AuthRequestParams.swift | 6 +++++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index d49943356..f26dd3423 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -227,7 +227,7 @@ extension AuthRequestParams { exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", requestId: String? = nil, - resources: [String]? = ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20vYWxsLWFwcHMiOnsiY3J1ZC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkL3N1YnNjcmlwdGlvbnMiOlt7fV19fX0K", "ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], + resources: [String]? = nil, methods: [String]? = ["personal_sign", "eth_sendTransaction"] ) -> AuthRequestParams { return try! AuthRequestParams( diff --git a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift index 7b4c2a7fd..2556c997e 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift @@ -55,7 +55,11 @@ public struct AuthRequestParams { } mutating func addResource(resource: String) { - resources?.append(resource) + if resources != nil { + resources?.append(resource) + } else { + resources = [resource] + } } } From 3b54d71cb4d92d655ad40dd20514e98b085e28c3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 3 Mar 2024 11:38:28 +0100 Subject: [PATCH 432/814] add testFalbackForm_2_5_DappToSessionProposeOnWallet --- .../Sign/SignClientTests.swift | 26 +++++++++++++++++++ .../Services/App/AuthResponseSubscriber.swift | 3 ++- 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 142260707..59b5afa59 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1031,4 +1031,30 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } + func testFalbackForm_2_5_DappToSessionProposeOnWallet() async throws { + + let fallbackExpectation = expectation(description: "fallback to wc_sessionPropose") + let requiredNamespaces = ProposalNamespace.stubRequired() + let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) + + + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in + Task(priority: .high) { + do { _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } + } + }.store(in: &publishers) + + dapp.sessionSettlePublisher.sink { settledSession in + Task(priority: .high) { + fallbackExpectation.fulfill() + } + }.store(in: &publishers) + + let uri = try await dapp.authenticate(AuthRequestParams.stub()) + let uriStringWithoutMethods = uri.absoluteString.replacingOccurrences(of: "&methods=wc_sessionAuthenticate", with: "") + let uriWithoutMethods = try WalletConnectURI(uriString: uriStringWithoutMethods) + try await walletPairingClient.pair(uri: uriWithoutMethods) + await fulfillment(of: [fallbackExpectation], timeout: InputConfig.defaultTimeout) + } + } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 8c921ae63..7b04e6387 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -46,7 +46,8 @@ class AuthResponseSubscriber { .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) - removeResponseTopicRecord(responseTopic: payload.topic) + +// removeResponseTopicRecord(responseTopic: payload.topic) }.store(in: &publishers) networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) From cc40fec56a0f45c81d6ce5ecf8083301df6dea89 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 3 Mar 2024 11:49:18 +0100 Subject: [PATCH 433/814] savepoint --- .../Auth/Services/App/AuthResponseSubscriber.swift | 4 +--- .../Services/AuthResponseTopicResubscriptionService.swift | 1 - 2 files changed, 1 insertion(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 7b04e6387..8a533f9be 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -45,9 +45,7 @@ class AuthResponseSubscriber { networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } - authResponsePublisherSubject.send((payload.id, .failure(error))) - -// removeResponseTopicRecord(responseTopic: payload.topic) + authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) diff --git a/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift b/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift index 70424a123..4d8af4005 100644 --- a/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift @@ -37,7 +37,6 @@ class AuthResponseTopicResubscriptionService { networkingInteractor.socketConnectionStatusPublisher .sink { [unowned self] status in guard status == .connected else { return } - logger.debug("Resubscribing to auth response topics") let topics = authResponseTopicRecordsStore.getAll().map{$0.topic} Task(priority: .high) { try await networkingInteractor.batchSubscribe(topics: topics) From ded5546634c8e92f2b04acca837c1c1d304cdcc5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 3 Mar 2024 11:57:41 +0100 Subject: [PATCH 434/814] not dismiss qr code on session propose response error --- Example/DApp/Modules/Sign/SignPresenter.swift | 1 - 1 file changed, 1 deletion(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index f26dd3423..656a5be23 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -166,7 +166,6 @@ extension SignPresenter { case .failure(let error): AlertPresenter.present(message: error.localizedDescription, type: .error) } - router.dismiss() Task(priority: .high) { ActivityIndicatorManager.shared.stop() } } .store(in: &subscriptions) From 31f448bbe75b35ade700f275c63b6ee6469f6d58 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 5 Mar 2024 11:00:21 +0100 Subject: [PATCH 435/814] add events to 2_5 session --- Example/DApp/SceneDelegate.swift | 1 + .../xcshareddata/swiftpm/Package.resolved | 23 +++++++++++++------ .../Services/SessionNamespaceBuilder.swift | 3 ++- .../Sign/SignClientFactory.swift | 2 +- .../Sign/SignClientProtocol.swift | 1 + 5 files changed, 21 insertions(+), 9 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 6b0a185b9..31506580a 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -48,6 +48,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { metadata: metadata ) + Sign.instance.logger.setLogging(level: .debug) Sign.instance.logsPublisher.sink { log in switch log { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 07a8aa9dd..8dfaa517a 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -15,8 +15,8 @@ "repositoryURL": "https://github.com/krzyzanowskim/CryptoSwift.git", "state": { "branch": null, - "revision": "db51c407d3be4a051484a141bf0bff36c43d3b1e", - "version": "1.8.0" + "revision": "7892a123f7e8d0fe62f9f03728b17bbd4f94df5c", + "version": "1.8.1" } }, { @@ -33,7 +33,7 @@ "repositoryURL": "https://github.com/mixpanel/mixpanel-swift", "state": { "branch": "master", - "revision": "c6336881a077d283db6f6d6e2f242977250230bd", + "revision": "9438b4a5f76bf2108b09f8fed1abbad8f353e1a2", "version": null } }, @@ -69,8 +69,8 @@ "repositoryURL": "https://github.com/getsentry/sentry-cocoa.git", "state": { "branch": null, - "revision": "74cf23b2946c92550fb1185612077151497e648e", - "version": "8.17.1" + "revision": "38f4f70d07117b9f958a76b1bff278c2f29ffe0e", + "version": "8.21.0" } }, { @@ -163,6 +163,15 @@ "version": "1.1.0" } }, + { + "package": "CoinbaseWalletSDK", + "repositoryURL": "https://github.com/coinbase/wallet-mobile-sdk.git", + "state": { + "branch": null, + "revision": "b0641bab0832108bf573923f7a47d2fc22875aba", + "version": "1.1.0" + } + }, { "package": "Web3", "repositoryURL": "https://github.com/WalletConnect/Web3.swift", @@ -177,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "296b2b72c116807a862e4c08ecf0a78ff044f87a", - "version": "1.0.16" + "revision": "2b377bdb52a3eeadb488301a13f1545a1777c2e2", + "version": "1.2.0" } } ] diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 3581d07c5..967715cbb 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -37,12 +37,13 @@ class SessionNamespaceBuilder { let accountsSet = Set(accounts) let methods = firstRecapResource.methods let chains = firstRecapResource.chains + let events: Set = ["chainChanged", "accountsChanged"] guard !chains.isEmpty else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - let sessionNamespace = SessionNamespace(chains: chains, accounts: accountsSet, methods: methods, events: []) + let sessionNamespace = SessionNamespace(chains: chains, accounts: accountsSet, methods: methods, events: events) return [chainsNamespace: sessionNamespace] } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 33e8a3628..c55c29467 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -19,7 +19,7 @@ public struct SignClientFactory { networkingClient: NetworkingInteractor, groupIdentifier: String ) -> SignClient { - let logger = ConsoleLogger(prefix: "📝", loggingLevel: .debug) + let logger = ConsoleLogger(prefix: "📝", loggingLevel: .off) guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 1e9ab5ce6..9073fe4e6 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -2,6 +2,7 @@ import Foundation import Combine public protocol SignClientProtocol { + var logger: ConsoleLogging { get } var sessionProposalPublisher: AnyPublisher<(proposal: Session.Proposal, context: VerifyContext?), Never> { get } var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { get } var sessionsPublisher: AnyPublisher<[Session], Never> { get } From 1c264513341ceb2eea73ba93663fc50d40cbe5aa Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Mar 2024 08:35:08 +0100 Subject: [PATCH 436/814] savepoint --- Example/ExampleApp.xcodeproj/project.pbxproj | 42 ++++++++------------ 1 file changed, 17 insertions(+), 25 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index f2580ff57..54c032e5e 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -9,6 +9,7 @@ /* Begin PBXBuildFile section */ 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */; }; 7694A5262874296A0001257E /* RegistryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7694A5252874296A0001257E /* RegistryTests.swift */; }; + 842B1D102B972814007F1EF8 /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D0F2B972814007F1EF8 /* Web3Modal */; settings = {ATTRIBUTES = (Required, ); }; }; 84310D05298BC980000C15B6 /* MainInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84310D04298BC980000C15B6 /* MainInteractor.swift */; }; 8439CB89293F658E00F2F2E2 /* PushMessage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8439CB88293F658E00F2F2E2 /* PushMessage.swift */; }; 844749F629B9E5B9005F520B /* RelayClientEndToEndTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 844749F529B9E5B9005F520B /* RelayClientEndToEndTests.swift */; }; @@ -218,7 +219,6 @@ A5E22D242840C8DB00E36487 /* SafariEngine.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D232840C8DB00E36487 /* SafariEngine.swift */; }; A5E22D2C2840EAC300E36487 /* XCUIElement.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D2B2840EAC300E36487 /* XCUIElement.swift */; }; A5E776BA29F4362D00172091 /* AlertError.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E776B929F4362D00172091 /* AlertError.swift */; }; - A5F1526F2ACDC46B00D745A6 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = A5F1526E2ACDC46B00D745A6 /* Web3ModalUI */; }; A74D32BA2A1E25AD00CB8536 /* QueryParameters.swift in Sources */ = {isa = PBXBuildFile; fileRef = A74D32B92A1E25AD00CB8536 /* QueryParameters.swift */; }; C5133A78294125CC00A8314C /* Web3 in Frameworks */ = {isa = PBXBuildFile; productRef = C5133A77294125CC00A8314C /* Web3 */; }; C53AA4362941251C008EA57C /* DefaultSignerFactory.swift in Sources */ = {isa = PBXBuildFile; fileRef = A59CF4F5292F83D50031A42F /* DefaultSignerFactory.swift */; }; @@ -275,7 +275,6 @@ C56EE28E293F5757004840D1 /* ApplicationConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE284293F5757004840D1 /* ApplicationConfigurator.swift */; }; C56EE28F293F5757004840D1 /* MigrationConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE283293F5757004840D1 /* MigrationConfigurator.swift */; }; C56EE2A3293F6BAF004840D1 /* UIPasteboardWrapper.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE2A2293F6BAF004840D1 /* UIPasteboardWrapper.swift */; }; - C579FEB62AFA86CD008855EB /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = C579FEB52AFA86CD008855EB /* Web3Modal */; }; C579FEBA2AFCDFA6008855EB /* ConnectedSheetView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C579FEB92AFCDFA6008855EB /* ConnectedSheetView.swift */; }; C58099352A543CD000AB58F5 /* BlinkAnimation.swift in Sources */ = {isa = PBXBuildFile; fileRef = C58099342A543CD000AB58F5 /* BlinkAnimation.swift */; }; C5B2F6F629705293000DBA0E /* SessionRequestModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5B2F6F12970511B000DBA0E /* SessionRequestModule.swift */; }; @@ -697,7 +696,7 @@ buildActionMask = 2147483647; files = ( 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */, - C579FEB62AFA86CD008855EB /* Web3Modal in Frameworks */, + 842B1D102B972814007F1EF8 /* Web3Modal in Frameworks */, C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */, A5B6C0F12A6EAB0800927332 /* WalletConnectNotify in Frameworks */, A54195A52934E83F0035AD19 /* Web3 in Frameworks */, @@ -767,7 +766,6 @@ C5B2F7052970573D000DBA0E /* SolanaSwift in Frameworks */, 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */, C55D349929630D440004314A /* Web3Wallet in Frameworks */, - A5F1526F2ACDC46B00D745A6 /* Web3ModalUI in Frameworks */, C56EE255293F569A004840D1 /* Starscream in Frameworks */, 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */, A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */, @@ -1950,9 +1948,9 @@ A5B6C0F02A6EAB0800927332 /* WalletConnectNotify */, 84943C7A2A9BA206007EBAC2 /* Mixpanel */, C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, - C579FEB52AFA86CD008855EB /* Web3Modal */, CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */, 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, + 842B1D0F2B972814007F1EF8 /* Web3Modal */, ); productName = DApp; productReference = 84CE641C27981DED00142511 /* DApp.app */; @@ -2077,7 +2075,6 @@ A5B6C0F42A6EAB2800927332 /* WalletConnectNotify */, 84943C7C2A9BA328007EBAC2 /* Mixpanel */, A59D25ED2AB3672700D7EA3A /* AsyncButton */, - A5F1526E2ACDC46B00D745A6 /* Web3ModalUI */, C54C248F2AEB1B5600DA4BF6 /* WalletConnectRouter */, 84AEC2532B4D43CD00E27A5B /* SwiftMessages */, ); @@ -2157,8 +2154,8 @@ A561C7FE29DF32CE00DF540D /* XCRemoteSwiftPackageReference "HDWallet" */, 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */, 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */, - A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */, 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */, + 842B1D0E2B9727CF007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */, ); productRefGroup = 764E1D3D26F8D3FC00A1FB15 /* Products */; projectDirPath = ""; @@ -3266,6 +3263,14 @@ /* End XCConfigurationList section */ /* Begin XCRemoteSwiftPackageReference section */ + 842B1D0E2B9727CF007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { + isa = XCRemoteSwiftPackageReference; + repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; + requirement = { + kind = upToNextMajorVersion; + minimumVersion = 1.2.0; + }; + }; 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */ = { isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/getsentry/sentry-cocoa.git"; @@ -3330,17 +3335,14 @@ version = 3.1.2; }; }; - A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { - isa = XCRemoteSwiftPackageReference; - repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; - requirement = { - kind = upToNextMajorVersion; - minimumVersion = 1.0.15; - }; - }; /* End XCRemoteSwiftPackageReference section */ /* Begin XCSwiftPackageProductDependency section */ + 842B1D0F2B972814007F1EF8 /* Web3Modal */ = { + isa = XCSwiftPackageProductDependency; + package = 842B1D0E2B9727CF007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3Modal; + }; 844749FC29B9E6B2005F520B /* WalletConnectNetworking */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectNetworking; @@ -3493,11 +3495,6 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnectChat; }; - A5F1526E2ACDC46B00D745A6 /* Web3ModalUI */ = { - isa = XCSwiftPackageProductDependency; - package = A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3ModalUI; - }; C5133A77294125CC00A8314C /* Web3 */ = { isa = XCSwiftPackageProductDependency; package = A5AE354528A1A2AC0059AE8A /* XCRemoteSwiftPackageReference "Web3" */; @@ -3516,11 +3513,6 @@ package = A5D85224286333D500DAF5C3 /* XCRemoteSwiftPackageReference "Starscream" */; productName = Starscream; }; - C579FEB52AFA86CD008855EB /* Web3Modal */ = { - isa = XCSwiftPackageProductDependency; - package = A5F1526D2ACDC46B00D745A6 /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3Modal; - }; C5B2F7042970573D000DBA0E /* SolanaSwift */ = { isa = XCSwiftPackageProductDependency; package = A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */; From 7d1cfbda05a73d9c6bd5c895f2da16bfb67eb854 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Mar 2024 12:04:06 +0100 Subject: [PATCH 437/814] savepoint --- Example/ExampleApp.xcodeproj/project.pbxproj | 16 ++++------------ .../xcshareddata/swiftpm/Package.resolved | 10 +++++----- 2 files changed, 9 insertions(+), 17 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 54c032e5e..370a198a4 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -9,7 +9,6 @@ /* Begin PBXBuildFile section */ 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */; }; 7694A5262874296A0001257E /* RegistryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7694A5252874296A0001257E /* RegistryTests.swift */; }; - 842B1D102B972814007F1EF8 /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D0F2B972814007F1EF8 /* Web3Modal */; settings = {ATTRIBUTES = (Required, ); }; }; 84310D05298BC980000C15B6 /* MainInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84310D04298BC980000C15B6 /* MainInteractor.swift */; }; 8439CB89293F658E00F2F2E2 /* PushMessage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8439CB88293F658E00F2F2E2 /* PushMessage.swift */; }; 844749F629B9E5B9005F520B /* RelayClientEndToEndTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 844749F529B9E5B9005F520B /* RelayClientEndToEndTests.swift */; }; @@ -696,7 +695,6 @@ buildActionMask = 2147483647; files = ( 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */, - 842B1D102B972814007F1EF8 /* Web3Modal in Frameworks */, C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */, A5B6C0F12A6EAB0800927332 /* WalletConnectNotify in Frameworks */, A54195A52934E83F0035AD19 /* Web3 in Frameworks */, @@ -1950,7 +1948,6 @@ C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */, 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, - 842B1D0F2B972814007F1EF8 /* Web3Modal */, ); productName = DApp; productReference = 84CE641C27981DED00142511 /* DApp.app */; @@ -2155,7 +2152,7 @@ 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */, 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */, 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */, - 842B1D0E2B9727CF007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */, + 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */, ); productRefGroup = 764E1D3D26F8D3FC00A1FB15 /* Products */; projectDirPath = ""; @@ -3263,12 +3260,12 @@ /* End XCConfigurationList section */ /* Begin XCRemoteSwiftPackageReference section */ - 842B1D0E2B9727CF007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { + 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { - kind = upToNextMajorVersion; - minimumVersion = 1.2.0; + kind = revision; + revision = f7050eb6979a8822a214cb710e68e827895647c7; }; }; 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */ = { @@ -3338,11 +3335,6 @@ /* End XCRemoteSwiftPackageReference section */ /* Begin XCSwiftPackageProductDependency section */ - 842B1D0F2B972814007F1EF8 /* Web3Modal */ = { - isa = XCSwiftPackageProductDependency; - package = 842B1D0E2B9727CF007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3Modal; - }; 844749FC29B9E6B2005F520B /* WalletConnectNetworking */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectNetworking; diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 8dfaa517a..f1ba94a49 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -165,11 +165,11 @@ }, { "package": "CoinbaseWalletSDK", - "repositoryURL": "https://github.com/coinbase/wallet-mobile-sdk.git", + "repositoryURL": "https://github.com/WalletConnect/wallet-mobile-sdk", "state": { "branch": null, - "revision": "b0641bab0832108bf573923f7a47d2fc22875aba", - "version": "1.1.0" + "revision": "b6dfb7d6b8447c7c5b238a10443a1ac28223f38f", + "version": "1.0.0" } }, { @@ -186,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "2b377bdb52a3eeadb488301a13f1545a1777c2e2", - "version": "1.2.0" + "revision": "f7050eb6979a8822a214cb710e68e827895647c7", + "version": null } } ] From c0091e0f6f75c5da2e93f9c4b8edc9615a941f3e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Mar 2024 12:33:43 +0100 Subject: [PATCH 438/814] upgrade w3m --- Example/ExampleApp.xcodeproj/project.pbxproj | 28 +++++++++++++++++-- .../xcshareddata/swiftpm/Package.resolved | 4 +-- 2 files changed, 28 insertions(+), 4 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 370a198a4..ee3931981 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -9,6 +9,9 @@ /* Begin PBXBuildFile section */ 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */; }; 7694A5262874296A0001257E /* RegistryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7694A5252874296A0001257E /* RegistryTests.swift */; }; + 842B1D132B988BC5007F1EF8 /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D122B988BC5007F1EF8 /* Web3Modal */; }; + 842B1D152B988BC5007F1EF8 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D142B988BC5007F1EF8 /* Web3ModalUI */; }; + 842B1D172B988BF0007F1EF8 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D162B988BF0007F1EF8 /* Web3ModalUI */; }; 84310D05298BC980000C15B6 /* MainInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84310D04298BC980000C15B6 /* MainInteractor.swift */; }; 8439CB89293F658E00F2F2E2 /* PushMessage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8439CB88293F658E00F2F2E2 /* PushMessage.swift */; }; 844749F629B9E5B9005F520B /* RelayClientEndToEndTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 844749F529B9E5B9005F520B /* RelayClientEndToEndTests.swift */; }; @@ -695,11 +698,13 @@ buildActionMask = 2147483647; files = ( 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */, + 842B1D132B988BC5007F1EF8 /* Web3Modal in Frameworks */, C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */, A5B6C0F12A6EAB0800927332 /* WalletConnectNotify in Frameworks */, A54195A52934E83F0035AD19 /* Web3 in Frameworks */, 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */, A5D85228286333E300DAF5C3 /* Starscream in Frameworks */, + 842B1D152B988BC5007F1EF8 /* Web3ModalUI in Frameworks */, 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */, 84943C7B2A9BA206007EBAC2 /* Mixpanel in Frameworks */, A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */, @@ -765,6 +770,7 @@ 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */, C55D349929630D440004314A /* Web3Wallet in Frameworks */, C56EE255293F569A004840D1 /* Starscream in Frameworks */, + 842B1D172B988BF0007F1EF8 /* Web3ModalUI in Frameworks */, 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */, A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */, C54C24902AEB1B5600DA4BF6 /* WalletConnectRouter in Frameworks */, @@ -1948,6 +1954,8 @@ C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */, 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, + 842B1D122B988BC5007F1EF8 /* Web3Modal */, + 842B1D142B988BC5007F1EF8 /* Web3ModalUI */, ); productName = DApp; productReference = 84CE641C27981DED00142511 /* DApp.app */; @@ -2074,6 +2082,7 @@ A59D25ED2AB3672700D7EA3A /* AsyncButton */, C54C248F2AEB1B5600DA4BF6 /* WalletConnectRouter */, 84AEC2532B4D43CD00E27A5B /* SwiftMessages */, + 842B1D162B988BF0007F1EF8 /* Web3ModalUI */, ); productName = ChatWallet; productReference = C56EE21B293F55ED004840D1 /* WalletApp.app */; @@ -3264,8 +3273,8 @@ isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { - kind = revision; - revision = f7050eb6979a8822a214cb710e68e827895647c7; + kind = upToNextMajorVersion; + minimumVersion = 1.0.0; }; }; 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */ = { @@ -3335,6 +3344,21 @@ /* End XCRemoteSwiftPackageReference section */ /* Begin XCSwiftPackageProductDependency section */ + 842B1D122B988BC5007F1EF8 /* Web3Modal */ = { + isa = XCSwiftPackageProductDependency; + package = 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3Modal; + }; + 842B1D142B988BC5007F1EF8 /* Web3ModalUI */ = { + isa = XCSwiftPackageProductDependency; + package = 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3ModalUI; + }; + 842B1D162B988BF0007F1EF8 /* Web3ModalUI */ = { + isa = XCSwiftPackageProductDependency; + package = 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3ModalUI; + }; 844749FC29B9E6B2005F520B /* WalletConnectNetworking */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectNetworking; diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index f1ba94a49..9c85155e8 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "f7050eb6979a8822a214cb710e68e827895647c7", - "version": null + "revision": "4f2f4ca6497b7335a53c7b5c4fb3db554e0351ba", + "version": "1.3.0" } } ] From 18317df74f24bd8942cee3ca5dafc60033577373 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Mar 2024 12:47:51 +0100 Subject: [PATCH 439/814] disable analytics --- Example/DApp/SceneDelegate.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 31506580a..9b23a6e93 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -67,6 +67,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { } }.store(in: &publishers) + Web3Modal.instance.disableAnalytics() setupWindow(scene: scene) } From 580e24648501db4eea989a6d55106473965f4f8d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 6 Mar 2024 12:56:10 +0100 Subject: [PATCH 440/814] fix sign tests --- .../SessionNamespaceBuilderTests.swift | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index 3000d64fe..2fcde6eb5 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -46,7 +46,7 @@ class SessionNamespaceBuilderTests: XCTestCase { Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! ]), methods: Set(["personal_sign", "eth_signTypedData", "eth_sign"]), - events: Set([]) + events: Set(["chainChanged", "accountsChanged"]) ) let cacaos = [ @@ -56,6 +56,7 @@ class SessionNamespaceBuilderTests: XCTestCase { do { let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: cacaos) + XCTAssertTrue(namespaces.first!.value.events.isSuperset(of: ["chainChanged", "accountsChanged"]), "Contains required events") XCTAssertEqual(namespaces.count, 1, "There should be one namespace") XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") } catch { @@ -71,7 +72,7 @@ class SessionNamespaceBuilderTests: XCTestCase { Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! ]), methods: ["personal_sign", "eth_signTypedData", "eth_sign"], - events: [] + events: ["chainChanged", "accountsChanged"] ) let cacao = Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: ["urn:recap:eyJh", recapUrn, "urn:recap:eyJh"]) From 8ee5270e63d644b6ba3a4e2cf74ec7b84374a1c3 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 7 Mar 2024 12:01:09 +0000 Subject: [PATCH 441/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 10f769c2c..eca36dd02 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.13.0"} +{"version": "1.14.0"} From 0455fa6adc6208c0826f8264682cb95256c6f12c Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 7 Mar 2024 12:14:33 +0000 Subject: [PATCH 442/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index eca36dd02..f16cdd865 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.14.0"} +{"version": "Set User Agent"} From d35999f1a6653d2ec8fc4fe42c630a58f0066fb1 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 7 Mar 2024 12:14:59 +0000 Subject: [PATCH 443/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index f16cdd865..eca36dd02 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "Set User Agent"} +{"version": "1.14.0"} From 47746a83e5184e059000fd537125d07d1004ac0d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 8 Mar 2024 13:00:08 +0100 Subject: [PATCH 444/814] update capbox --- Sources/WalletConnectIdentity/IdentityService.swift | 2 +- Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index efc5ff3b7..dde7af412 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -53,7 +53,7 @@ actor IdentityService { } func buildUri(domain: String, didKey: String) -> String { - return "\(domain)?walletconnect_identity_token=\(didKey)" + return "\(domain)?walletconnect_identity_key=\(didKey)" } // TODO: Verifications diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 761b0c66f..f143b91cd 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -175,8 +175,8 @@ public class NotifyClient { /// returns notify recap for all apps private func createAuthorizationRecap() -> String { - // {"att":{"walletconnect-notify":{"manage/all-apps-notifications":[{}]}}} - "urn:recap:eyJhdHQiOnsid2FsbGV0Y29ubmVjdC1ub3RpZnkiOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0=" + // {"att":{"https://notify.walletconnect.com":{"manage/all-apps-notifications":[{}]}}} + "urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20iOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0=" } } From 343942ec038e1d5d23d7b377811369c57e22bbab Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 13:56:57 +0100 Subject: [PATCH 445/814] add recap merging service --- .../IntegrationTests/Push/NotifyTests.swift | 4 +- .../Client/Wallet/NotifyClient.swift | 2 +- .../SIWE/RecapStatementBuilder.swift | 29 +++--- .../SIWE/RecapUrnMergingService.swift | 44 +++++++++ .../WalletConnectUtils/SIWE/SIWEMessage.swift | 4 +- .../SIWEMessageFormatterTests.swift | 2 +- .../RecapStatementBuilderTests.swift | 95 +------------------ .../RecapUrnMergingServiceTests.swift | 67 +++++++++++++ 8 files changed, 134 insertions(+), 113 deletions(-) create mode 100644 Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift create mode 100644 Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index 08369e9cf..f16e5550f 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -124,9 +124,9 @@ final class NotifyTests: XCTestCase { expectation.fulfill() }.store(in: &publishers) - try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) + try! await walletNotifyClientA.register(account: account, domain: "https://\(gmDappDomain)", onSign: sign) try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) + try! await clientB.register(account: account, domain: "https://\(gmDappDomain)", onSign: sign) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index f143b91cd..7664d62f4 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -176,7 +176,7 @@ public class NotifyClient { /// returns notify recap for all apps private func createAuthorizationRecap() -> String { // {"att":{"https://notify.walletconnect.com":{"manage/all-apps-notifications":[{}]}}} - "urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20iOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0=" + "urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20iOnsibWFuYWdlL2FsbC1hcHBzLW5vdGlmaWNhdGlvbnMiOlt7fV19fX0" } } diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index e3561c644..663589e1d 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -28,7 +28,7 @@ struct RecapUrn { } } -struct RecapData: Decodable { +struct RecapData: Codable { var att: [String: [String: [AnyCodable]]]? var prf: [String]? } @@ -36,18 +36,16 @@ struct RecapData: Decodable { struct RecapStatementBuilder { enum Errors: Error { case noActionsAuthorized - case emptyRecapsForbidden } - static func buildRecapStatement(recapUrns: [RecapUrn]) throws -> String { - guard recapUrns.count > 0 else { throw Errors.emptyRecapsForbidden } - var statementParts: [String] = [] - var actionCounter = 1 + static func buildRecapStatement(recapUrn: RecapUrn) throws -> String { + var statementParts: [String] = [] + var actionCounter = 1 - recapUrns.forEach { urn in - let decodedRecap = urn.recapData + // Processing only the last URN. + let decodedRecap = recapUrn.recapData - guard let attValue = decodedRecap.att else { return } + guard let attValue = decodedRecap.att else { throw Errors.noActionsAuthorized } let sortedResourceKeys = attValue.keys.sorted() @@ -67,13 +65,12 @@ struct RecapStatementBuilder { actionCounter += 1 } } - } - if statementParts.isEmpty { - throw Errors.noActionsAuthorized - } else { - let formattedStatement = statementParts.joined(separator: ". ") - return "I further authorize the stated URI to perform the following actions on my behalf: \(formattedStatement)." + if statementParts.isEmpty { + throw Errors.noActionsAuthorized + } else { + let formattedStatement = statementParts.joined(separator: ". ") + return "I further authorize the stated URI to perform the following actions on my behalf: \(formattedStatement)." + } } - } } diff --git a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift new file mode 100644 index 000000000..b19a0c8d4 --- /dev/null +++ b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift @@ -0,0 +1,44 @@ +import Foundation + +class RecapUrnMergingService { + enum Errors: Error { + case emptyRecapUrns + case encodingFailed + } + + static func merge(recapUrns: [RecapUrn]) throws -> RecapUrn { + guard !recapUrns.isEmpty else { + throw Errors.emptyRecapUrns + } + + if recapUrns.count == 1 { + return recapUrns.first! + } + + var mergedAtt: [String: [String: [AnyCodable]]] = [:] + + for recapUrn in recapUrns { + guard let att = recapUrn.recapData.att else { continue } + for (key, value) in att { + if var existingValue = mergedAtt[key] { + for (actionKey, actionValue) in value { + existingValue[actionKey] = (existingValue[actionKey] ?? []) + actionValue + } + mergedAtt[key] = existingValue + } else { + mergedAtt[key] = value + } + } + } + + // Assuming RecapData can be encoded back to JSON and then to a Base64 string + let mergedData = RecapData(att: mergedAtt, prf: nil) + guard let jsonData = try? JSONEncoder().encode(mergedData), + let jsonBase64 = jsonData.base64EncodedString().addingPercentEncoding(withAllowedCharacters: .urlHostAllowed) else { + throw Errors.encodingFailed + } + + let mergedUrnString = "urn:recap:\(jsonBase64)" + return try RecapUrn(urn: mergedUrnString) + } +} diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index 6d1d2a936..d95860abc 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -47,9 +47,9 @@ public struct SIWEMessage: Equatable { private func getStatementLine() throws -> String { if let recaps = resources?.compactMap({ try? RecapUrn(urn: $0) }), - !recaps.isEmpty { + let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recaps) { do { - let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrns: recaps) + let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrn: mergedRecap) if let statement = statement { return "\n\(statement) \(recapStatement)" } else { diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 57c877fc9..3b3a96e81 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -149,7 +149,7 @@ class SIWEMessageFormatterTests: XCTestCase { let payload = try AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil,resources: [validRecapUrn]) ).cacaoPayload(account: Account.stub()) - +x let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) XCTAssertEqual(message, expectedMessage) } diff --git a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift index b5cf40478..66fe838f1 100644 --- a/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapStatementBuilderTests.swift @@ -17,7 +17,7 @@ class RecapStatementBuilderTests: XCTestCase { let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." - let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrn: urn) XCTAssertEqual(recapStatement, expectedStatement) } @@ -36,98 +36,11 @@ class RecapStatementBuilderTests: XCTestCase { let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'." - let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrn: urn) XCTAssertEqual(recapStatement, expectedStatement) } - func testMultipleRecaps() { - // First recap structure - let decodedRecap1: [String: [String: [String: [String]]]] = [ - "att": [ - "eip155": [ - "request/eth_sendTransaction": [], - "request/personal_sign": [] - ] - ] - ] - - // Second recap structure, as provided - let decodedRecap2: [String: [String: [String: [String]]]] = [ - "att": [ - "https://example.com/pictures/": [ - "crud/delete": [], - "crud/update": [], - "other/action": [] - ] - ] - ] - - // Encoding both recaps - let encoded1 = try! JSONEncoder().encode(decodedRecap1).base64EncodedString() - let encoded2 = try! JSONEncoder().encode(decodedRecap2).base64EncodedString() - - // Creating URNs - let urn1 = try! RecapUrn(urn: "urn:recap:\(encoded1)") - let urn2 = try! RecapUrn(urn: "urn:recap:\(encoded2)") - - // Expected statement combining both recaps - let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'delete', 'update' for 'https://example.com/pictures/'. (3) 'other': 'action' for 'https://example.com/pictures/'." - - // Generating the recap statement from both URNs - let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn1, urn2]) - - // Asserting the generated statement against the expected statement - XCTAssertEqual(recapStatement, expectedStatement) - } - - func testRecapNotifyAndSign() throws { - let notifyRecapJson = """ - { - "att":{ - "https://notify.walletconnect.com/all-apps":{ - "crud/notifications": [{}], - "crud/subscriptions": [{}] - } - } - } - """ - - let signRecapJson = """ - { - "att":{ - "eip155":{ - "request/eth_sendTransaction": [{}], - "request/personal_sign": [{}] - } - } - } - """ - - // Correctly constructing Data from JSON strings - guard let notifyRecapData = notifyRecapJson.data(using: .utf8), - let signRecapData = signRecapJson.data(using: .utf8) else { - XCTFail("Failed to create Data from JSON strings") - return - } - - let encodedNotify = notifyRecapData.base64EncodedString() - let encodedSign = signRecapData.base64EncodedString() - - let urn1 = try RecapUrn(urn: "urn:recap:\(encodedSign)") - let urn2 = try RecapUrn(urn: "urn:recap:\(encodedNotify)") - - let expectedStatement = """ - I further authorize the stated URI to perform the following actions on my behalf: (1) 'request': 'eth_sendTransaction', 'personal_sign' for 'eip155'. (2) 'crud': 'notifications', 'subscriptions' for 'https://notify.walletconnect.com/all-apps'. - """ - - // Generating the recap statement from both URNs, with 'sign' recap first - let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrns: [urn1, urn2]) - - // Asserting the generated statement against the expected statement - XCTAssertEqual(recapStatement, expectedStatement) - - } func testComplexRecap() { @@ -166,7 +79,7 @@ class RecapStatementBuilderTests: XCTestCase { let expectedStatement = "I further authorize the stated URI to perform the following actions on my behalf: (1) 'crud': 'delete', 'update' for 'https://example.com/pictures/'. (2) 'other': 'action' for 'https://example.com/pictures/'. (3) 'msg': 'receive', 'send' for 'mailto:username@example.com'." - let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrns: [urn]) + let recapStatement = try! RecapStatementBuilder.buildRecapStatement(recapUrn: urn) // Asserting the generated statement against the expected statement XCTAssertEqual(recapStatement, expectedStatement) @@ -183,7 +96,7 @@ class RecapStatementBuilderTests: XCTestCase { let urn = try! RecapUrn(urn: "urn:recap:\(encoded)") // Assert that building a statement with no actions throws an error - XCTAssertThrowsError(try RecapStatementBuilder.buildRecapStatement(recapUrns: [urn])) { error in + XCTAssertThrowsError(try RecapStatementBuilder.buildRecapStatement(recapUrn: urn)) { error in XCTAssertEqual(error as? RecapStatementBuilder.Errors, RecapStatementBuilder.Errors.noActionsAuthorized) } } diff --git a/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift b/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift new file mode 100644 index 000000000..719cf7a45 --- /dev/null +++ b/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift @@ -0,0 +1,67 @@ +import XCTest +@testable import WalletConnectUtils + +class RecapUrnMergingTests: XCTestCase { + func testMergeRecapUrns() throws { + // Encode your test data to Base64 + let notifyRecapJson = """ + { + "att":{ + "https://notify.walletconnect.com/all-apps":{ + "crud/notifications": [{}], + "crud/subscriptions": [{}] + } + } + } + """ + let signRecapJson = """ + { + "att":{ + "eip155":{ + "request/eth_sendTransaction": [{}], + "request/personal_sign": [{}] + } + } + } + """ + + guard let notifyBase64 = notifyRecapJson.data(using: .utf8)?.base64EncodedString(), + let signBase64 = signRecapJson.data(using: .utf8)?.base64EncodedString() else { + XCTFail("Failed to encode JSON strings to Base64") + return + } + + // Create URNs from Base64 encoded strings + let urn1 = try RecapUrn(urn: "urn:recap:\(notifyBase64)") + let urn2 = try RecapUrn(urn: "urn:recap:\(signBase64)") + + // Merge the URNs using your merging logic + let mergedRecap = try RecapUrnMergingService.merge(recapUrns: [urn1, urn2]) + + // Define the expected merged structure + let expectedMergeJson = """ + { + "att":{ + "https://notify.walletconnect.com/all-apps":{ + "crud/notifications": [{}], + "crud/subscriptions": [{}] + }, + "eip155":{ + "request/eth_sendTransaction": [{}], + "request/personal_sign": [{}] + } + } + } + """ + + // Convert expected JSON to `RecapData` + let expectedMergeData = expectedMergeJson.data(using: .utf8)! + let expectedMergeRecap = try! JSONDecoder().decode(RecapData.self, from: expectedMergeData) + + // Perform your assertions + XCTAssertEqual(mergedRecap.recapData.att?.count, expectedMergeRecap.att?.count) + for (key, value) in mergedRecap.recapData.att ?? [:] { + XCTAssertEqual(value.keys.sorted(), expectedMergeRecap.att?[key]?.keys.sorted()) + } + } +} From 207e41d4b8aef4bb6826ef4534f66b7ca64859e0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 14:22:50 +0100 Subject: [PATCH 446/814] Add SiweMessageFormatter --- .../Auth/Services/CacaosBuilder.swift | 25 +++++++ .../Auth/Services/CacaosProvider.swift | 10 --- .../Auth/Types/AuthPayload.swift | 16 ----- .../WalletConnectSign/Sign/SignClient.swift | 2 +- .../SIWE/SIWECacaoFormatter.swift | 2 +- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 70 +++++++------------ .../SIWEMessageFormatterTests.swift | 2 +- 7 files changed, 52 insertions(+), 75 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift delete mode 100644 Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift new file mode 100644 index 000000000..e5654af23 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift @@ -0,0 +1,25 @@ + +import Foundation + +struct CacaosBuilder { + public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { + let statement = + + let cacaoPayload = CacaoPayload( + iss: account.did, + domain: authPayload.domain, + aud: authPayload.aud, + version: authPayload.version, + nonce: authPayload.nonce, + iat: authPayload.iat, + nbf: authPayload.nbf, + exp: authPayload.exp, + statement: statement, + requestId: authPayload.requestId, + resources: authPayload.resources + ) + let header = CacaoHeader(t: "eip4361") + return Cacao(h: header, p: cacaoPayload, s: signature) + } + +} diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift b/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift deleted file mode 100644 index 5ab42d879..000000000 --- a/Sources/WalletConnectSign/Auth/Services/CacaosProvider.swift +++ /dev/null @@ -1,10 +0,0 @@ - -import Foundation - -struct CacaosProvider { - public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { - let payload = try authPayload.cacaoPayload(account: account) - let header = CacaoHeader(t: "eip4361") - return Cacao(h: header, p: payload, s: signature) - } -} diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index 6c13e9002..8edab5317 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -57,20 +57,4 @@ public struct AuthPayload: Codable, Equatable { self.requestId = requestParams.requestId self.resources = requestParams.resources } - - func cacaoPayload(account: Account) throws -> CacaoPayload { - return CacaoPayload( - iss: account.did, - domain: domain, - aud: aud, - version: version, - nonce: nonce, - iat: iat, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources - ) - } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index e57b62324..8eb664fdd 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -352,7 +352,7 @@ public final class SignClient: SignClientProtocol { } public func buildSignedAuthObject(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { - try CacaosProvider().makeCacao(authPayload: authPayload, signature: signature, account: account) + try CacaosBuilder().makeCacao(authPayload: authPayload, signature: signature, account: account) } public func buildAuthPayload(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { diff --git a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift index 1abd44997..280b4f045 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift @@ -28,7 +28,7 @@ public struct SIWECacaoFormatter: SIWECacaoFormatting { requestId: payload.requestId, resources: payload.resources ) - return try message.formatted() + return try SiweMessageFormatter.format(message) } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index d95860abc..a366acd8c 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -28,29 +28,32 @@ public struct SIWEMessage: Equatable { self.requestId = requestId self.resources = resources } +} - public func formatted() throws -> String { +import Foundation - let statementLine = try getStatementLine() +public class SiweMessageFormatter { + public static func format(_ message: SIWEMessage) throws -> String { + let statementLine = try getStatementLine(for: message) return """ - \(domain) wants you to sign in with your Ethereum account: - \(address) + \(message.domain) wants you to sign in with your Ethereum account: + \(message.address) \(statementLine) - URI: \(uri) - Version: \(version) - Chain ID: \(chainId) - Nonce: \(nonce) - Issued At: \(iat)\(expLine)\(nbfLine)\(requestIdLine)\(resourcesSection) + URI: \(message.uri) + Version: \(message.version) + Chain ID: \(message.chainId) + Nonce: \(message.nonce) + Issued At: \(message.iat)\(getExpLine(for: message))\(getNbfLine(for: message))\(getRequestIdLine(for: message))\(getResourcesSection(for: message)) """ } - private func getStatementLine() throws -> String { - if let recaps = resources?.compactMap({ try? RecapUrn(urn: $0) }), + private static func getStatementLine(for message: SIWEMessage) throws -> String { + if let recaps = message.resources?.compactMap({ try? RecapUrn(urn: $0) }), let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recaps) { do { let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrn: mergedRecap) - if let statement = statement { + if let statement = message.statement { return "\n\(statement) \(recapStatement)" } else { return "\n\(recapStatement)" @@ -59,53 +62,28 @@ public struct SIWEMessage: Equatable { throw error } } else { - guard let statement = statement else { return "" } + guard let statement = message.statement else { return "" } return "\n\(statement)" } - - } - - - - private func decodeUrnToJson(urn: String) -> [String: [String: [String: [String]]]]? { - // Check if the URN is in the correct format - guard urn.starts(with: "urn:recap:") else { return nil } - - // Extract the Base64 encoded JSON part from the URN - let base64EncodedJson = urn.replacingOccurrences(of: "urn:recap:", with: "") - - // Decode the Base64 encoded JSON - guard let jsonData = Data(base64Encoded: base64EncodedJson) else { return nil } - - // Deserialize the JSON data into the desired dictionary - do { - let decodedDictionary = try JSONDecoder().decode([String: [String: [String: [String]]]].self, from: jsonData) - return decodedDictionary - } catch { - return nil - } } -} - -private extension SIWEMessage { - var expLine: String { - guard let exp = exp else { return "" } + private static func getExpLine(for message: SIWEMessage) -> String { + guard let exp = message.exp else { return "" } return "\nExpiration Time: \(exp)" } - var nbfLine: String { - guard let nbf = nbf else { return "" } + private static func getNbfLine(for message: SIWEMessage) -> String { + guard let nbf = message.nbf else { return "" } return "\nNot Before: \(nbf)" } - var requestIdLine: String { - guard let requestId = requestId else { return "" } + private static func getRequestIdLine(for message: SIWEMessage) -> String { + guard let requestId = message.requestId else { return "" } return "\nRequest ID: \(requestId)" } - var resourcesSection: String { - guard let resources = resources else { return "" } + private static func getResourcesSection(for message: SIWEMessage) -> String { + guard let resources = message.resources else { return "" } return resources.reduce("\nResources:") { $0 + "\n- \($1)" } } } diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift index 3b3a96e81..57c877fc9 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift @@ -149,7 +149,7 @@ class SIWEMessageFormatterTests: XCTestCase { let payload = try AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil,resources: [validRecapUrn]) ).cacaoPayload(account: Account.stub()) -x + let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) XCTAssertEqual(message, expectedMessage) } From 83b4b8601505cd5d8ed3fb803c3a65d79181efb4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 15:28:20 +0100 Subject: [PATCH 447/814] update siwe formatting --- .../Auth/Signer/CacaoSignerTests.swift | 2 +- .../IntegrationTests/Chat/RegistryTests.swift | 2 +- .../IdentityClientFactory.swift | 2 +- .../IdentityService.swift | 4 +- .../Services/App/AuthResponseSubscriber.swift | 4 +- .../Auth/Services/CacaosBuilder.swift | 20 ++++-- .../Auth/Services/Wallet/AuthResponder.swift | 4 +- .../WalletConnectSign/Sign/SignClient.swift | 2 +- .../Sign/SignClientFactory.swift | 2 +- .../Signer/MessageSigner.swift | 4 +- .../SIWE/RecapStatementBuilder.swift | 6 +- .../SIWE/RecapUrnMergingService.swift | 6 +- ...ft => SIWEFromCacaoPayloadFormatter.swift} | 8 +-- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 57 --------------- .../SIWE/SiweMessageFormatter.swift | 45 ++++++++++++ .../SIWE/SiweStatementBuilder.swift | 22 ++++++ ... SIWEFromCacaoPayloadFormatterTests.swift} | 72 ++++++++++--------- 17 files changed, 145 insertions(+), 117 deletions(-) rename Sources/WalletConnectUtils/SIWE/{SIWECacaoFormatter.swift => SIWEFromCacaoPayloadFormatter.swift} (81%) create mode 100644 Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift create mode 100644 Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift rename Tests/WalletConnectSignTests/{SIWEMessageFormatterTests.swift => SIWEFromCacaoPayloadFormatterTests.swift} (76%) diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index 90a17b00e..d7634155f 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -51,7 +51,7 @@ class CacaoSignerTest: XCTestCase { func testCacaoSign() throws { let account = Account("eip155:1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2")! let cacaoPayload = try payload.cacaoPayload(account: account) - let formatted = try SIWECacaoFormatter().formatMessage(from: cacaoPayload) + let formatted = try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) XCTAssertEqual(formatted, message) XCTAssertEqual(try signer.sign(payload: cacaoPayload, privateKey: privateKey, type: .eip191), signature) } diff --git a/Example/IntegrationTests/Chat/RegistryTests.swift b/Example/IntegrationTests/Chat/RegistryTests.swift index 0c659241f..178c63be4 100644 --- a/Example/IntegrationTests/Chat/RegistryTests.swift +++ b/Example/IntegrationTests/Chat/RegistryTests.swift @@ -27,7 +27,7 @@ final class RegistryTests: XCTestCase { storage: storage, networkService: identityNetworkService, iatProvader: DefaultIATProvider(), - messageFormatter: SIWECacaoFormatter() + messageFormatter: SIWEFromCacaoPayloadFormatter() ) signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() } diff --git a/Sources/WalletConnectIdentity/IdentityClientFactory.swift b/Sources/WalletConnectIdentity/IdentityClientFactory.swift index 236a939f7..57720a4f8 100644 --- a/Sources/WalletConnectIdentity/IdentityClientFactory.swift +++ b/Sources/WalletConnectIdentity/IdentityClientFactory.swift @@ -11,7 +11,7 @@ public final class IdentityClientFactory { let httpService = HTTPNetworkClient(host: keyserver.host!) let identityStorage = IdentityStorage(keychain: keychain) let identityNetworkService = IdentityNetworkService(httpService: httpService) - let identityService = IdentityService(keyserverURL: keyserver, kms: kms, storage: identityStorage, networkService: identityNetworkService, iatProvader: DefaultIATProvider(), messageFormatter: SIWECacaoFormatter()) + let identityService = IdentityService(keyserverURL: keyserver, kms: kms, storage: identityStorage, networkService: identityNetworkService, iatProvader: DefaultIATProvider(), messageFormatter: SIWEFromCacaoPayloadFormatter()) return IdentityClient( identityService: identityService, identityStorage: identityStorage, diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index dde7af412..9483a9545 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -7,7 +7,7 @@ actor IdentityService { private let storage: IdentityStorage private let networkService: IdentityNetworking private let iatProvader: IATProvider - private let messageFormatter: SIWECacaoFormatting + private let messageFormatter: SIWEFromCacaoFormatting init( keyserverURL: URL, @@ -15,7 +15,7 @@ actor IdentityService { storage: IdentityStorage, networkService: IdentityNetworking, iatProvader: IATProvider, - messageFormatter: SIWECacaoFormatting + messageFormatter: SIWEFromCacaoFormatting ) { self.keyserverURL = keyserverURL self.kms = kms diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 8a533f9be..a57be3a44 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -6,7 +6,7 @@ class AuthResponseSubscriber { private let logger: ConsoleLogging private let rpcHistory: RPCHistory private let signatureVerifier: MessageVerifier - private let messageFormatter: SIWECacaoFormatting + private let messageFormatter: SIWEFromCacaoFormatting private let pairingRegisterer: PairingRegisterer private var publishers = [AnyCancellable]() private let sessionStore: WCSessionStorage @@ -25,7 +25,7 @@ class AuthResponseSubscriber { pairingRegisterer: PairingRegisterer, kms: KeyManagementServiceProtocol, sessionStore: WCSessionStorage, - messageFormatter: SIWECacaoFormatting, + messageFormatter: SIWEFromCacaoFormatting, sessionNamespaceBuilder: SessionNamespaceBuilder, authResponseTopicRecordsStore: CodableStore) { self.networkingInteractor = networkingInteractor diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift index e5654af23..5b8d34d10 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift @@ -1,11 +1,23 @@ import Foundation +import WalletConnectUtils struct CacaosBuilder { - public func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { - let statement = + public static func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: authPayload, account: account) + let header = CacaoHeader(t: "eip4361") + return Cacao(h: header, p: cacaoPayload, s: signature) + } + +} + +struct CacaoPayloadBuilder { + public static func makeCacaoPayload(authPayload: AuthPayload, account: WalletConnectUtils.Account) throws -> CacaoPayload { + let recapUrns = authPayload.resources?.compactMap { try? RecapUrn(urn: $0)} ?? [] - let cacaoPayload = CacaoPayload( + let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) + let statement = try SiweStatementBuilder.buildSiweStatement(statement: authPayload.statement, mergedRecapUrn: mergedRecap) + return CacaoPayload( iss: account.did, domain: authPayload.domain, aud: authPayload.aud, @@ -18,8 +30,6 @@ struct CacaosBuilder { requestId: authPayload.requestId, resources: authPayload.resources ) - let header = CacaoHeader(t: "eip4361") - return Cacao(h: header, p: cacaoPayload, s: signature) } } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift index bec7e6502..3d9ae4304 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift @@ -8,7 +8,7 @@ actor AuthResponder { } private let networkingInteractor: NetworkInteracting private let kms: KeyManagementService - private let messageFormatter: SIWECacaoFormatting + private let messageFormatter: SIWEFromCacaoFormatting private let signatureVerifier: MessageVerifier private let rpcHistory: RPCHistory private let verifyContextStore: CodableStore @@ -25,7 +25,7 @@ actor AuthResponder { kms: KeyManagementService, rpcHistory: RPCHistory, signatureVerifier: MessageVerifier, - messageFormatter: SIWECacaoFormatting, + messageFormatter: SIWEFromCacaoFormatting, verifyContextStore: CodableStore, walletErrorResponder: WalletErrorResponder, pairingRegisterer: PairingRegisterer, diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 8eb664fdd..9b4b4d311 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -348,7 +348,7 @@ public final class SignClient: SignClientProtocol { } public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { - return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(account: account), includeRecapInTheStatement: true) + return try SIWEFromCacaoPayloadFormatter().formatMessage(from: payload.cacaoPayload(account: account), includeRecapInTheStatement: true) } public func buildSignedAuthObject(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index c55c29467..e07c86816 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -95,7 +95,7 @@ public struct SignClientFactory { //Auth let authResponseTopicRecordsStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.authResponseTopicRecord.rawValue) - let messageFormatter = SIWECacaoFormatter() + let messageFormatter = SIWEFromCacaoPayloadFormatter() let appRequestService = SessionAuthRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore) let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) diff --git a/Sources/WalletConnectSigner/Signer/MessageSigner.swift b/Sources/WalletConnectSigner/Signer/MessageSigner.swift index b1c8efc4c..fed68c3e2 100644 --- a/Sources/WalletConnectSigner/Signer/MessageSigner.swift +++ b/Sources/WalletConnectSigner/Signer/MessageSigner.swift @@ -7,9 +7,9 @@ public struct MessageSigner { } private let signer: EthereumSigner - private let messageFormatter: SIWECacaoFormatting + private let messageFormatter: SIWEFromCacaoFormatting - init(signer: EthereumSigner, messageFormatter: SIWECacaoFormatting) { + init(signer: EthereumSigner, messageFormatter: SIWEFromCacaoFormatting) { self.signer = signer self.messageFormatter = messageFormatter } diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 663589e1d..8b4d122ef 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -1,6 +1,6 @@ import Foundation -struct RecapUrn { +public struct RecapUrn { enum Errors: Error { case invalidUrn case invalidPayload @@ -10,7 +10,7 @@ struct RecapUrn { let urn: String let recapData: RecapData - init(urn: String) throws { + public init(urn: String) throws { guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } let components = urn.components(separatedBy: ":") @@ -28,7 +28,7 @@ struct RecapUrn { } } -struct RecapData: Codable { +public struct RecapData: Codable { var att: [String: [String: [AnyCodable]]]? var prf: [String]? } diff --git a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift index b19a0c8d4..9fc6662d6 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift @@ -1,12 +1,12 @@ import Foundation -class RecapUrnMergingService { - enum Errors: Error { +public class RecapUrnMergingService { + public enum Errors: Error { case emptyRecapUrns case encodingFailed } - static func merge(recapUrns: [RecapUrn]) throws -> RecapUrn { + public static func merge(recapUrns: [RecapUrn]) throws -> RecapUrn { guard !recapUrns.isEmpty else { throw Errors.emptyRecapUrns } diff --git a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift similarity index 81% rename from Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift rename to Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift index 280b4f045..8f6ffbf0f 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWECacaoFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift @@ -1,14 +1,14 @@ import Foundation -public protocol SIWECacaoFormatting { +public protocol SIWEFromCacaoFormatting { func formatMessage(from payload: CacaoPayload, includeRecapInTheStatement: Bool) throws -> String } -public extension SIWECacaoFormatting { +public extension SIWEFromCacaoFormatting { func formatMessage(from payload: CacaoPayload) throws -> String { return try formatMessage(from: payload, includeRecapInTheStatement: true) } } -public struct SIWECacaoFormatter: SIWECacaoFormatting { +public struct SIWEFromCacaoPayloadFormatter: SIWEFromCacaoFormatting { public init() { } @@ -28,7 +28,7 @@ public struct SIWECacaoFormatter: SIWECacaoFormatting { requestId: payload.requestId, resources: payload.resources ) - return try SiweMessageFormatter.format(message) + return try SiweMessageFormatter.format(siwe: message) } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift index a366acd8c..88cf98c27 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift @@ -30,60 +30,3 @@ public struct SIWEMessage: Equatable { } } -import Foundation - -public class SiweMessageFormatter { - public static func format(_ message: SIWEMessage) throws -> String { - let statementLine = try getStatementLine(for: message) - return """ - \(message.domain) wants you to sign in with your Ethereum account: - \(message.address) - \(statementLine) - - URI: \(message.uri) - Version: \(message.version) - Chain ID: \(message.chainId) - Nonce: \(message.nonce) - Issued At: \(message.iat)\(getExpLine(for: message))\(getNbfLine(for: message))\(getRequestIdLine(for: message))\(getResourcesSection(for: message)) - """ - } - - private static func getStatementLine(for message: SIWEMessage) throws -> String { - if let recaps = message.resources?.compactMap({ try? RecapUrn(urn: $0) }), - let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recaps) { - do { - let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrn: mergedRecap) - if let statement = message.statement { - return "\n\(statement) \(recapStatement)" - } else { - return "\n\(recapStatement)" - } - } catch { - throw error - } - } else { - guard let statement = message.statement else { return "" } - return "\n\(statement)" - } - } - - private static func getExpLine(for message: SIWEMessage) -> String { - guard let exp = message.exp else { return "" } - return "\nExpiration Time: \(exp)" - } - - private static func getNbfLine(for message: SIWEMessage) -> String { - guard let nbf = message.nbf else { return "" } - return "\nNot Before: \(nbf)" - } - - private static func getRequestIdLine(for message: SIWEMessage) -> String { - guard let requestId = message.requestId else { return "" } - return "\nRequest ID: \(requestId)" - } - - private static func getResourcesSection(for message: SIWEMessage) -> String { - guard let resources = message.resources else { return "" } - return resources.reduce("\nResources:") { $0 + "\n- \($1)" } - } -} diff --git a/Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift b/Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift new file mode 100644 index 000000000..2f9cb3d52 --- /dev/null +++ b/Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift @@ -0,0 +1,45 @@ +import Foundation + +public class SiweMessageFormatter { + public static func format(siwe: SIWEMessage) throws -> String { + let recapUrns = siwe.resources?.compactMap { try? RecapUrn(urn: $0)} ?? [] + + let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) + let statementLine = try SiweStatementBuilder.buildSiweStatement(statement: siwe.statement, mergedRecapUrn: mergedRecap) + return """ + \(siwe.domain) wants you to sign in with your Ethereum account: + \(siwe.address) + \(statementLine) + + URI: \(siwe.uri) + Version: \(siwe.version) + Chain ID: \(siwe.chainId) + Nonce: \(siwe.nonce) + Issued At: \(siwe.iat)\(siwe.expLine)\(siwe.nbfLine)\(siwe.requestIdLine)\(siwe.resourcesSection) + """ + } +} + +private extension SIWEMessage { + + var expLine: String { + guard let exp = exp else { return "" } + return "\nExpiration Time: \(exp)" + } + + var nbfLine: String { + guard let nbf = nbf else { return "" } + return "\nNot Before: \(nbf)" + } + + var requestIdLine: String { + guard let requestId = requestId else { return "" } + return "\nRequest ID: \(requestId)" + } + + var resourcesSection: String { + guard let resources = resources else { return "" } + let resourcesList = resources.reduce("") { $0 + "\n- \($1)" } + return resources.isEmpty ? "" : "\nResources:" + resourcesList + } +} diff --git a/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift new file mode 100644 index 000000000..bfdcfb923 --- /dev/null +++ b/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift @@ -0,0 +1,22 @@ + +import Foundation + +public class SiweStatementBuilder { + public static func buildSiweStatement(statement: String?, mergedRecapUrn: RecapUrn?) throws -> String { + var finalStatement = statement ?? "" + + if let mergedRecapUrn = mergedRecapUrn { + // Generate recap statement from the merged RecapUrn + let recapStatement = try RecapStatementBuilder.buildRecapStatement(recapUrn: mergedRecapUrn) + // Append recap statement to the original statement, if it exists + if !finalStatement.isEmpty { + finalStatement += " \(recapStatement)" + } else { + finalStatement = recapStatement + } + } + + return finalStatement.isEmpty ? "" : "\n\(finalStatement)" + } +} + diff --git a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift similarity index 76% rename from Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift rename to Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift index 57c877fc9..f84fd03c5 100644 --- a/Tests/WalletConnectSignTests/SIWEMessageFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift @@ -3,12 +3,12 @@ import Foundation @testable import WalletConnectSign import XCTest -class SIWEMessageFormatterTests: XCTestCase { - var sut: SIWECacaoFormatter! +class SIWEFromCacaoPayloadFormatterTests: XCTestCase { + var sut: SIWEFromCacaoPayloadFormatter! let address = "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" override func setUp() { - sut = SIWECacaoFormatter() + sut = SIWEFromCacaoPayloadFormatter() } func testFormatMessage() throws { @@ -28,7 +28,8 @@ class SIWEMessageFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let message = try sut.formatMessage(from: AuthPayload.stub().cacaoPayload(account: Account.stub())) + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload(authPayload: AuthPayload.stub(), account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } @@ -48,11 +49,12 @@ class SIWEMessageFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let message = try sut.formatMessage( - from: AuthPayload.stub( + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil) - ).cacaoPayload(account: Account.stub()) - ) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } @@ -70,10 +72,12 @@ class SIWEMessageFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let message = try sut.formatMessage( - from: AuthPayload.stub( - requestParams: AuthRequestParams.stub(resources: nil)).cacaoPayload(account: Account.stub()) - ) + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( + requestParams: AuthRequestParams.stub(resources: nil) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } @@ -90,10 +94,12 @@ class SIWEMessageFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let message = try sut.formatMessage( - from: AuthPayload.stub( - requestParams: AuthRequestParams.stub(statement: nil, resources: nil)).cacaoPayload(account: Account.stub()) - ) + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( + requestParams: AuthRequestParams.stub(statement: nil, resources: nil) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } @@ -117,12 +123,13 @@ class SIWEMessageFormatterTests: XCTestCase { """ + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( + requestParams: AuthRequestParams.stub(resources: [validRecapUrn]) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) - let payload = try AuthPayload.stub( - requestParams: AuthRequestParams.stub(resources: [validRecapUrn]) - ).cacaoPayload(account: Account.stub()) - - let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) XCTAssertEqual(message, expectedMessage) } @@ -145,12 +152,12 @@ class SIWEMessageFormatterTests: XCTestCase { - urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ== """ - - let payload = try AuthPayload.stub( - requestParams: AuthRequestParams.stub(statement: nil,resources: [validRecapUrn]) - ).cacaoPayload(account: Account.stub()) - - let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( + requestParams: AuthRequestParams.stub(statement: nil, resources: [validRecapUrn]) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } @@ -178,11 +185,12 @@ class SIWEMessageFormatterTests: XCTestCase { let uri = "https://service.invalid?walletconnect_notify_key=did:key:z6MktW4hKdsvcXgt9wXmYbSD5sH4NCk5GmNZnokP9yh2TeCf" - let payload = try AuthPayload.stub( - requestParams: AuthRequestParams.stub(uri: uri, statement: nil,resources: [recap1, recap2]) - ).cacaoPayload(account: Account.stub()) - - let message = try sut.formatMessage(from: payload, includeRecapInTheStatement: true) + let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( + requestParams: AuthRequestParams.stub(statement: nil, resources: [recap1, recap2]) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } } From a640357b12b7c0e33daacb38e42f14699fbe977a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 15:36:36 +0100 Subject: [PATCH 448/814] fix sign build --- Sources/WalletConnectSign/Sign/SignClient.swift | 5 +++-- .../Signer/MessageSignerFactory.swift | 2 +- .../SIWEFromCacaoPayloadFormatterTests.swift | 14 +++++++------- .../Stub/SIWEMessageFormatterMock.swift | 2 +- 4 files changed, 12 insertions(+), 11 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 9b4b4d311..b0fe8caf7 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -348,11 +348,12 @@ public final class SignClient: SignClientProtocol { } public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { - return try SIWEFromCacaoPayloadFormatter().formatMessage(from: payload.cacaoPayload(account: account), includeRecapInTheStatement: true) + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: payload, account: account) + return try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) } public func buildSignedAuthObject(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { - try CacaosBuilder().makeCacao(authPayload: authPayload, signature: signature, account: account) + try CacaosBuilder.makeCacao(authPayload: authPayload, signature: signature, account: account) } public func buildAuthPayload(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { diff --git a/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift b/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift index 0506e6fa1..5fc0a5eb4 100644 --- a/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift +++ b/Sources/WalletConnectSigner/Signer/MessageSignerFactory.swift @@ -11,7 +11,7 @@ public struct MessageSignerFactory { public func create() -> MessageSigner { return MessageSigner( signer: signerFactory.createEthereumSigner(), - messageFormatter: SIWECacaoFormatter() + messageFormatter: SIWEFromCacaoPayloadFormatter() ) } } diff --git a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift index f84fd03c5..fb9532440 100644 --- a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift @@ -28,7 +28,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload(authPayload: AuthPayload.stub(), account: Account.stub()) + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: AuthPayload.stub(), account: Account.stub()) let message = try sut.formatMessage(from: cacaoPayload) XCTAssertEqual(message, expectedMessage) } @@ -49,7 +49,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { - ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/ - https://example.com/my-web2-claim.json """ - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil) ), @@ -72,7 +72,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(resources: nil) ), @@ -94,7 +94,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z """ - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil, resources: nil) ), @@ -123,7 +123,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { """ - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(resources: [validRecapUrn]) ), @@ -152,7 +152,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { - urn:recap:eyJhdHQiOiB7ImVpcDE1NSI6IHsicmVxdWVzdC9ldGhfc2VuZFRyYW5zYWN0aW9uIjogW10sICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbXX19fQ== """ - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil, resources: [validRecapUrn]) ), @@ -185,7 +185,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { let uri = "https://service.invalid?walletconnect_notify_key=did:key:z6MktW4hKdsvcXgt9wXmYbSD5sH4NCk5GmNZnokP9yh2TeCf" - let cacaoPayload = CacaoPayloadBuilder.makeCacaoPayload( + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( requestParams: AuthRequestParams.stub(statement: nil, resources: [recap1, recap2]) ), diff --git a/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift index 3fd5658aa..c18bb9b89 100644 --- a/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift +++ b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift @@ -1,7 +1,7 @@ import Foundation @testable import WalletConnectUtils -class SIWEMessageFormatterMock: SIWECacaoFormatting { +class SIWEMessageFormatterMock: SIWEFromCacaoFormatting { func formatMessage(from payload: WalletConnectUtils.CacaoPayload, includeRecapInTheStatement: Bool) throws -> String { fatalError() } From d5e5fa2e3eb5903f363658f82aba5d20df2bde30 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 17:23:35 +0100 Subject: [PATCH 449/814] savepoint --- .../IntegrationTests.xctestplan | 1 - .../Auth/Signer/CacaoSignerTests.swift | 2 +- .../Auth/Services/CacaosBuilder.swift | 21 ++++++- .../SIWE/RecapStatementBuilder.swift | 4 +- .../SIWE/RecapUrnMergingService.swift | 21 ++++++- .../SIWE/SIWEFromCacaoPayloadFormatter.swift | 61 +++++++++++++------ .../SIWE/SiweMessageFormatter.swift | 45 -------------- .../SIWE/SiweStatementBuilder.swift | 2 +- .../SIWEFromCacaoPayloadFormatterTests.swift | 5 +- 9 files changed, 86 insertions(+), 76 deletions(-) delete mode 100644 Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift diff --git a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan index 955607e33..40b79df1d 100644 --- a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan +++ b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan @@ -58,7 +58,6 @@ "ChatTests", "ENSResolverTests", "HistoryTests", - "SignClientTests\/testEIP1271SessionAuthenticated()", "SyncDerivationServiceTests", "SyncTests" ], diff --git a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift index d7634155f..c35cd57d5 100644 --- a/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift +++ b/Example/IntegrationTests/Auth/Signer/CacaoSignerTests.swift @@ -50,7 +50,7 @@ class CacaoSignerTest: XCTestCase { func testCacaoSign() throws { let account = Account("eip155:1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2")! - let cacaoPayload = try payload.cacaoPayload(account: account) + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: payload, account: account) let formatted = try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) XCTAssertEqual(formatted, message) XCTAssertEqual(try signer.sign(payload: cacaoPayload, privateKey: privateKey, type: .eip191), signature) diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift index 5b8d34d10..5a97e8e9c 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift @@ -16,7 +16,23 @@ struct CacaoPayloadBuilder { let recapUrns = authPayload.resources?.compactMap { try? RecapUrn(urn: $0)} ?? [] let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) - let statement = try SiweStatementBuilder.buildSiweStatement(statement: authPayload.statement, mergedRecapUrn: mergedRecap) + var statement: String? + if let mergedRecapUrn = mergedRecap { + // If there's a merged recap, generate its statement + statement = try SiweStatementBuilder.buildSiweStatement(statement: authPayload.statement, mergedRecapUrn: mergedRecapUrn) + } else { + // If no merged recap, use the original statement + statement = authPayload.statement + } + + // Filter out any resources starting with "urn:recap:", then if mergedRecap exists, add its URN as the last element + var resources = authPayload.resources?.filter { !$0.starts(with: "urn:recap:") } ?? [] + if let mergedRecapUrn = mergedRecap { + // Assuming RecapUrn can be converted back to its string representation + let mergedRecapUrnString = mergedRecapUrn.urn + resources.append(mergedRecapUrnString) + } + return CacaoPayload( iss: account.did, domain: authPayload.domain, @@ -28,8 +44,7 @@ struct CacaoPayloadBuilder { exp: authPayload.exp, statement: statement, requestId: authPayload.requestId, - resources: authPayload.resources + resources: resources ) } - } diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index 8b4d122ef..dcf404ef5 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -7,8 +7,8 @@ public struct RecapUrn { case invalidJsonStructure } - let urn: String - let recapData: RecapData + public let urn: String + public let recapData: RecapData public init(urn: String) throws { guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } diff --git a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift index 9fc6662d6..02c7452d8 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift @@ -11,12 +11,14 @@ public class RecapUrnMergingService { throw Errors.emptyRecapUrns } + // If there's only one URN, return it directly. if recapUrns.count == 1 { return recapUrns.first! } var mergedAtt: [String: [String: [AnyCodable]]] = [:] + // Aggregate all actions under their respective keys for recapUrn in recapUrns { guard let att = recapUrn.recapData.att else { continue } for (key, value) in att { @@ -31,9 +33,22 @@ public class RecapUrnMergingService { } } - // Assuming RecapData can be encoded back to JSON and then to a Base64 string - let mergedData = RecapData(att: mergedAtt, prf: nil) - guard let jsonData = try? JSONEncoder().encode(mergedData), + // Sort and then ensure actions are also sorted, if necessary. + let sortedMergedAtt = mergedAtt + .sorted { $0.key < $1.key } + .reduce(into: [String: [String: [AnyCodable]]]()) { (result, pair) in + let (resource, actions) = pair + let sortedActions = actions + .sorted { $0.key < $1.key } + .reduce(into: [String: [AnyCodable]]()) { (actionsResult, actionPair) in + actionsResult[actionPair.key] = actionPair.value + } + result[resource] = sortedActions + } + + let encoder = JSONEncoder() + encoder.outputFormatting = [.sortedKeys] + guard let jsonData = try? encoder.encode(RecapData(att: sortedMergedAtt, prf: nil)), let jsonBase64 = jsonData.base64EncodedString().addingPercentEncoding(withAllowedCharacters: .urlHostAllowed) else { throw Errors.encodingFailed } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift index 8f6ffbf0f..4851966a6 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift @@ -8,27 +8,54 @@ public extension SIWEFromCacaoFormatting { return try formatMessage(from: payload, includeRecapInTheStatement: true) } } + + public struct SIWEFromCacaoPayloadFormatter: SIWEFromCacaoFormatting { - public init() { } + public init() {} public func formatMessage(from payload: CacaoPayload, includeRecapInTheStatement: Bool) throws -> String { let iss = try DIDPKH(did: payload.iss) - let message = SIWEMessage( - domain: payload.domain, - uri: payload.aud, - address: iss.account.address, - version: payload.version, - nonce: payload.nonce, - chainId: iss.account.reference, - iat: payload.iat, - nbf: payload.nbf, - exp: payload.exp, - statement: payload.statement, - requestId: payload.requestId, - resources: payload.resources - ) - return try SiweMessageFormatter.format(siwe: message) + let address = iss.account.address + let chainId = iss.account.reference + + // Directly use the statement from payload, add a newline if it exists + let statementLine = payload.statement.flatMap { "\n\($0)" } ?? "" + + // Format the message with all details + let formattedMessage = """ + \(payload.domain) wants you to sign in with your Ethereum account: + \(address) + \(statementLine) + + URI: \(payload.aud) + Version: \(payload.version) + Chain ID: \(chainId) + Nonce: \(payload.nonce) + Issued At: \(payload.iat)\(formatExpLine(exp: payload.exp))\(formatNbfLine(nbf: payload.nbf))\(formatRequestIdLine(requestId: payload.requestId))\(formatResourcesSection(resources: payload.resources)) + """ + return formattedMessage + } + + // Helper methods for formatting individual parts of the message + private func formatExpLine(exp: String?) -> String { + guard let exp = exp else { return "" } + return "\nExpiration Time: \(exp)" + } + + private func formatNbfLine(nbf: String?) -> String { + guard let nbf = nbf else { return "" } + return "\nNot Before: \(nbf)" } -} + private func formatRequestIdLine(requestId: String?) -> String { + guard let requestId = requestId else { return "" } + return "\nRequest ID: \(requestId)" + } + + private func formatResourcesSection(resources: [String]?) -> String { + guard let resources = resources else { return "" } + let resourcesList = resources.reduce("") { $0 + "\n- \($1)" } + return resources.isEmpty ? "" : "\nResources:" + resourcesList + } +} diff --git a/Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift b/Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift deleted file mode 100644 index 2f9cb3d52..000000000 --- a/Sources/WalletConnectUtils/SIWE/SiweMessageFormatter.swift +++ /dev/null @@ -1,45 +0,0 @@ -import Foundation - -public class SiweMessageFormatter { - public static func format(siwe: SIWEMessage) throws -> String { - let recapUrns = siwe.resources?.compactMap { try? RecapUrn(urn: $0)} ?? [] - - let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) - let statementLine = try SiweStatementBuilder.buildSiweStatement(statement: siwe.statement, mergedRecapUrn: mergedRecap) - return """ - \(siwe.domain) wants you to sign in with your Ethereum account: - \(siwe.address) - \(statementLine) - - URI: \(siwe.uri) - Version: \(siwe.version) - Chain ID: \(siwe.chainId) - Nonce: \(siwe.nonce) - Issued At: \(siwe.iat)\(siwe.expLine)\(siwe.nbfLine)\(siwe.requestIdLine)\(siwe.resourcesSection) - """ - } -} - -private extension SIWEMessage { - - var expLine: String { - guard let exp = exp else { return "" } - return "\nExpiration Time: \(exp)" - } - - var nbfLine: String { - guard let nbf = nbf else { return "" } - return "\nNot Before: \(nbf)" - } - - var requestIdLine: String { - guard let requestId = requestId else { return "" } - return "\nRequest ID: \(requestId)" - } - - var resourcesSection: String { - guard let resources = resources else { return "" } - let resourcesList = resources.reduce("") { $0 + "\n- \($1)" } - return resources.isEmpty ? "" : "\nResources:" + resourcesList - } -} diff --git a/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift index bfdcfb923..fceed8b05 100644 --- a/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/SiweStatementBuilder.swift @@ -16,7 +16,7 @@ public class SiweStatementBuilder { } } - return finalStatement.isEmpty ? "" : "\n\(finalStatement)" + return finalStatement.isEmpty ? "" : "\(finalStatement)" } } diff --git a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift index fb9532440..d36d02e43 100644 --- a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift @@ -179,15 +179,14 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { Nonce: 32891756 Issued At: 2021-09-30T16:25:24Z Resources: - - urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJlaXAxNTUiOnsKICAgICAgICAgInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6IFt7fV0sCiAgICAgICAgICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbe31dCiAgICAgIH0KICAgfQp9 - - urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJodHRwczovL25vdGlmeS53YWxsZXRjb25uZWN0LmNvbS9hbGwtYXBwcyI6ewogICAgICAgICAiY3J1ZC9ub3RpZmljYXRpb25zIjogW3t9XSwKICAgICAgICAgImNydWQvc3Vic2NyaXB0aW9ucyI6IFt7fV0KICAgICAgfQogICB9Cn0= + - urn:recap:eyJhdHQiOnsiZWlwMTU1Ijp7InJlcXVlc3RcL2V0aF9zZW5kVHJhbnNhY3Rpb24iOlt7fV0sInJlcXVlc3RcL3BlcnNvbmFsX3NpZ24iOlt7fV19LCJodHRwczpcL1wvbm90aWZ5LndhbGxldGNvbm5lY3QuY29tXC9hbGwtYXBwcyI6eyJjcnVkXC9ub3RpZmljYXRpb25zIjpbe31dLCJjcnVkXC9zdWJzY3JpcHRpb25zIjpbe31dfX19 """ let uri = "https://service.invalid?walletconnect_notify_key=did:key:z6MktW4hKdsvcXgt9wXmYbSD5sH4NCk5GmNZnokP9yh2TeCf" let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( authPayload: AuthPayload.stub( - requestParams: AuthRequestParams.stub(statement: nil, resources: [recap1, recap2]) + requestParams: AuthRequestParams.stub(uri: uri, statement: nil, resources: [recap1, recap2]) ), account: Account.stub()) let message = try sut.formatMessage(from: cacaoPayload) From 50dbfb57e7c88f14f152c0afc579faff709b1c08 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 17:27:52 +0100 Subject: [PATCH 450/814] savepoint --- .../SIWE/RecapStatementBuilder.swift | 33 ---------- .../WalletConnectUtils/SIWE/RecapUrn.swift | 63 +++++++++++++++++++ .../SIWEFromCacaoPayloadFormatterTests.swift | 2 +- .../RecapUrnTests.swift | 2 +- 4 files changed, 65 insertions(+), 35 deletions(-) create mode 100644 Sources/WalletConnectUtils/SIWE/RecapUrn.swift diff --git a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift index dcf404ef5..859a01521 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapStatementBuilder.swift @@ -1,38 +1,5 @@ import Foundation -public struct RecapUrn { - enum Errors: Error { - case invalidUrn - case invalidPayload - case invalidJsonStructure - } - - public let urn: String - public let recapData: RecapData - - public init(urn: String) throws { - guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } - - let components = urn.components(separatedBy: ":") - guard components.count > 2, let jsonData = Data(base64Encoded: components.dropFirst(2).joined(separator: ":")) else { - throw Errors.invalidPayload - } - - do { - self.recapData = try JSONDecoder().decode(RecapData.self, from: jsonData) - } catch { - throw Errors.invalidJsonStructure - } - - self.urn = urn - } -} - -public struct RecapData: Codable { - var att: [String: [String: [AnyCodable]]]? - var prf: [String]? -} - struct RecapStatementBuilder { enum Errors: Error { case noActionsAuthorized diff --git a/Sources/WalletConnectUtils/SIWE/RecapUrn.swift b/Sources/WalletConnectUtils/SIWE/RecapUrn.swift new file mode 100644 index 000000000..64d1068d3 --- /dev/null +++ b/Sources/WalletConnectUtils/SIWE/RecapUrn.swift @@ -0,0 +1,63 @@ +import Foundation + +public struct RecapData: Codable { + var att: [String: [String: [AnyCodable]]]? + var prf: [String]? +} + +public struct RecapUrn { + enum Errors: Error { + case invalidUrn + case invalidPayload + case invalidJsonStructure + } + + public let urn: String + public let recapData: RecapData + + public init(urn: String) throws { + guard urn.hasPrefix("urn:recap") else { throw Errors.invalidUrn } + + let components = urn.components(separatedBy: ":") + guard components.count > 2 else { + throw Errors.invalidPayload + } + + let base64urlEncodedPayload = components.dropFirst(2).joined(separator: ":") + guard let jsonData = Data(base64urlEncoded: base64urlEncodedPayload) else { + throw Errors.invalidPayload + } + + do { + self.recapData = try JSONDecoder().decode(RecapData.self, from: jsonData) + } catch { + throw Errors.invalidJsonStructure + } + + self.urn = urn + } +} + +extension Data { + /// Initializes a Data object with a base64url encoded String. + init?(base64urlEncoded: String) { + var base64 = base64urlEncoded + .replacingOccurrences(of: "-", with: "+") + .replacingOccurrences(of: "_", with: "/") + + // Add padding if necessary + while base64.count % 4 != 0 { + base64 += "=" + } + + self.init(base64Encoded: base64) + } + + /// Returns a base64url encoded String. + func base64urlEncodedString() -> String { + return self.base64EncodedString() + .replacingOccurrences(of: "+", with: "-") + .replacingOccurrences(of: "/", with: "_") + .trimmingCharacters(in: ["="]) // Remove any padding + } +} diff --git a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift index d36d02e43..d5ad69c69 100644 --- a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift @@ -164,7 +164,7 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { func testWithSignAndNotifyRecaps() throws { let recap1 = "urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJlaXAxNTUiOnsKICAgICAgICAgInJlcXVlc3QvZXRoX3NlbmRUcmFuc2FjdGlvbiI6IFt7fV0sCiAgICAgICAgICJyZXF1ZXN0L3BlcnNvbmFsX3NpZ24iOiBbe31dCiAgICAgIH0KICAgfQp9" - let recap2 = "urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJodHRwczovL25vdGlmeS53YWxsZXRjb25uZWN0LmNvbS9hbGwtYXBwcyI6ewogICAgICAgICAiY3J1ZC9ub3RpZmljYXRpb25zIjogW3t9XSwKICAgICAgICAgImNydWQvc3Vic2NyaXB0aW9ucyI6IFt7fV0KICAgICAgfQogICB9Cn0=" + let recap2 = "urn:recap:ewogICAiYXR0Ijp7CiAgICAgICJodHRwczovL25vdGlmeS53YWxsZXRjb25uZWN0LmNvbS9hbGwtYXBwcyI6ewogICAgICAgICAiY3J1ZC9ub3RpZmljYXRpb25zIjogW3t9XSwKICAgICAgICAgImNydWQvc3Vic2NyaXB0aW9ucyI6IFt7fV0KICAgICAgfQogICB9Cn0" let expectedMessage = """ diff --git a/Tests/WalletConnectUtilsTests/RecapUrnTests.swift b/Tests/WalletConnectUtilsTests/RecapUrnTests.swift index 08e098a3b..9d7b87a49 100644 --- a/Tests/WalletConnectUtilsTests/RecapUrnTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapUrnTests.swift @@ -14,7 +14,7 @@ class RecapUrnTests: XCTestCase { let invalidPayloadUrn = "urn:recap:invalidPayload" XCTAssertThrowsError(try RecapUrn(urn: invalidPayloadUrn)) { error in - XCTAssertEqual(error as? RecapUrn.Errors, RecapUrn.Errors.invalidPayload) + XCTAssertEqual(error as? RecapUrn.Errors, RecapUrn.Errors.invalidJsonStructure) } } From bdf280dc12d83d262298d51d0edc7acc3cef7cb1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sun, 10 Mar 2024 17:52:20 +0100 Subject: [PATCH 451/814] fix notify tests --- Example/IntegrationTests/Push/NotifyTests.swift | 6 +++--- .../WalletConnectIdentity/IdentityService.swift | 14 +++++++++++++- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/Example/IntegrationTests/Push/NotifyTests.swift b/Example/IntegrationTests/Push/NotifyTests.swift index f16e5550f..2b08baca7 100644 --- a/Example/IntegrationTests/Push/NotifyTests.swift +++ b/Example/IntegrationTests/Push/NotifyTests.swift @@ -124,9 +124,9 @@ final class NotifyTests: XCTestCase { expectation.fulfill() }.store(in: &publishers) - try! await walletNotifyClientA.register(account: account, domain: "https://\(gmDappDomain)", onSign: sign) + try! await walletNotifyClientA.register(account: account, domain: gmDappDomain, onSign: sign) try! await walletNotifyClientA.subscribe(appDomain: gmDappDomain, account: account) - try! await clientB.register(account: account, domain: "https://\(gmDappDomain)", onSign: sign) + try! await clientB.register(account: account, domain: gmDappDomain, onSign: sign) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) @@ -282,7 +282,7 @@ private extension NotifyTests { private extension NotifyClient { func register(account: Account, domain: String, onSign: @escaping (String) -> CacaoSignature) async throws { - let params = try await prepareRegistration(account: account, domain: domain) + let params = try await prepareRegistration(account: account, domain: "https://\(domain)") let signature = onSign(params.message) try await register(params: params, signature: signature) } diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index 9483a9545..0e58ecab9 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -34,6 +34,18 @@ actor IdentityService { let uri = buildUri(domain: domain, didKey: identityKey.publicKey.did) + let recapUrns = resources.compactMap { try? RecapUrn(urn: $0)} + + let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) + var payloadStatement: String? + if let mergedRecapUrn = mergedRecap { + // If there's a merged recap, generate its statement + payloadStatement = try SiweStatementBuilder.buildSiweStatement(statement: statement, mergedRecapUrn: mergedRecapUrn) + } else { + // If no merged recap, use the original statement + payloadStatement = statement + } + let payload = CacaoPayload( iss: account.did, domain: domain, @@ -42,7 +54,7 @@ actor IdentityService { nonce: getNonce(), iat: iatProvader.iat, nbf: nil, exp: nil, - statement: statement, + statement: payloadStatement, requestId: nil, resources: resources ) From 7c8f162c34e557ac56cce56bc1989d150b6c4e5a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Mar 2024 09:26:26 +0100 Subject: [PATCH 452/814] savepoint --- Example/ExampleApp.xcodeproj/project.pbxproj | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index ee3931981..65b54643f 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -2897,11 +2897,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = PNDecryptionService/PNDecryptionServiceRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 7; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = PNDecryptionService/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = PNDecryptionService; @@ -2916,7 +2914,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp.PNDecryptionService; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp.PNDecryptionService"; SKIP_INSTALL = YES; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; @@ -3115,12 +3112,10 @@ ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = WalletApp/WalletAppRelease.entitlements; - CODE_SIGN_IDENTITY = "Apple Distribution"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_IDENTITY = "Apple Development"; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 7; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = WalletApp/Other/Info.plist; @@ -3139,7 +3134,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; From d52a98671e7232d4b153d6c8e00d68e1aae589bd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Mar 2024 15:33:42 +0100 Subject: [PATCH 453/814] savepoint --- .../WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift index 1db2dc9b5..19685d83a 100644 --- a/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthPayloadBuilder.swift @@ -6,12 +6,13 @@ public struct AuthPayloadBuilder { public static func build(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload { // Attempt to find a valid session recap URN from the resources - guard let existingSessionRecapUrn = payload.resources?.first(where: { (try? SignRecap(urn: $0)) != nil }) else { + guard let recap = payload.resources?.last, + let _ = try? SignRecap(urn: recap) else { return payload } // Use SessionRecapBuilder to create a new session recap based on the existing valid URN - let newSessionRecap = try SignRecapBuilder.build(requestedSessionRecap: existingSessionRecapUrn, requestedChains: payload.chains, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) + let newSessionRecap = try SignRecapBuilder.build(requestedSessionRecap: recap, requestedChains: payload.chains, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) // Encode the new session recap to its URN format let newSessionRecapUrn = newSessionRecap.urn From 5bcb2e8346f122cb87a8bb80425731e45feb79f6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Mar 2024 15:43:29 +0100 Subject: [PATCH 454/814] fix recap --- Sources/WalletConnectIdentity/IdentityService.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectIdentity/IdentityService.swift b/Sources/WalletConnectIdentity/IdentityService.swift index 0e58ecab9..179ee478f 100644 --- a/Sources/WalletConnectIdentity/IdentityService.swift +++ b/Sources/WalletConnectIdentity/IdentityService.swift @@ -65,7 +65,7 @@ actor IdentityService { } func buildUri(domain: String, didKey: String) -> String { - return "\(domain)?walletconnect_identity_key=\(didKey)" + return "bundleid://\(domain)?walletconnect_identity_key=\(didKey)" } // TODO: Verifications From 1b1cb91679d846d1dda2c369e7b8c012bbd19374 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Mar 2024 15:47:30 +0100 Subject: [PATCH 455/814] savepoint --- .../Stub/SIWEMessageFormatterMock.swift | 15 --------------- 1 file changed, 15 deletions(-) delete mode 100644 Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift diff --git a/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift b/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift deleted file mode 100644 index c18bb9b89..000000000 --- a/Tests/WalletConnectSignTests/Stub/SIWEMessageFormatterMock.swift +++ /dev/null @@ -1,15 +0,0 @@ -import Foundation -@testable import WalletConnectUtils - -class SIWEMessageFormatterMock: SIWEFromCacaoFormatting { - func formatMessage(from payload: WalletConnectUtils.CacaoPayload, includeRecapInTheStatement: Bool) throws -> String { - fatalError() - } - - - var formattedMessage: String! - - func formatMessages(from payload: CacaoPayload) throws -> String { - return formattedMessage - } -} From 3e0260727f4a002e0a82478e5dea1f2d76fa82b3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 11 Mar 2024 15:55:05 +0100 Subject: [PATCH 456/814] fix missing resources in siwe --- .../SIWE/SIWEFromCacaoPayloadFormatter.swift | 5 ++- .../WalletConnectUtils/SIWE/SIWEMessage.swift | 32 ------------------- 2 files changed, 2 insertions(+), 35 deletions(-) delete mode 100644 Sources/WalletConnectUtils/SIWE/SIWEMessage.swift diff --git a/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift index 4851966a6..c26be1ee1 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift @@ -54,8 +54,7 @@ public struct SIWEFromCacaoPayloadFormatter: SIWEFromCacaoFormatting { } private func formatResourcesSection(resources: [String]?) -> String { - guard let resources = resources else { return "" } - let resourcesList = resources.reduce("") { $0 + "\n- \($1)" } - return resources.isEmpty ? "" : "\nResources:" + resourcesList + let resourcesList = resources?.reduce("") { $0 + "\n- \($1)" } ?? "" + return "\nResources:" + resourcesList } } diff --git a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift b/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift deleted file mode 100644 index 88cf98c27..000000000 --- a/Sources/WalletConnectUtils/SIWE/SIWEMessage.swift +++ /dev/null @@ -1,32 +0,0 @@ -import Foundation - -public struct SIWEMessage: Equatable { - public let domain: String - public let uri: String // aud - public let address: String - public let version: String - public let nonce: String - public let chainId: String - public let iat: String - public let nbf: String? - public let exp: String? - public let statement: String? - public let requestId: String? - public let resources: [String]? - - public init(domain: String, uri: String, address: String, version: String, nonce: String, chainId: String, iat: String, nbf: String?, exp: String?, statement: String?, requestId: String?, resources: [String]?) { - self.domain = domain - self.uri = uri - self.address = address - self.version = version - self.nonce = nonce - self.chainId = chainId - self.iat = iat - self.nbf = nbf - self.exp = exp - self.statement = statement - self.requestId = requestId - self.resources = resources - } -} - From 2d45e2de4c4f1107c021f3ecf1f6177ed6fc53ef Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 08:38:59 +0100 Subject: [PATCH 457/814] fix recap encoding issue --- Sources/WalletConnectSign/Auth/Services/SignRecap.swift | 2 +- Sources/WalletConnectUtils/SIWE/RecapUrn.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift index 973378553..bcda4fdba 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift @@ -20,7 +20,7 @@ struct SignRecap { } let base64Part = urn.dropFirst("urn:recap:".count) - guard let jsonData = Data(base64Encoded: String(base64Part)), + guard let jsonData = Data(base64urlEncoded: String(base64Part)), let decodedData = try? JSONDecoder().decode(RecapData.self, from: jsonData) else { throw Errors.invalidRecapStructure } diff --git a/Sources/WalletConnectUtils/SIWE/RecapUrn.swift b/Sources/WalletConnectUtils/SIWE/RecapUrn.swift index 64d1068d3..161c80530 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapUrn.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapUrn.swift @@ -38,7 +38,7 @@ public struct RecapUrn { } } -extension Data { +public extension Data { /// Initializes a Data object with a base64url encoded String. init?(base64urlEncoded: String) { var base64 = base64urlEncoded From febad38754b7052dc8fa6a846eba6f38e9d4a906 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 08:57:07 +0100 Subject: [PATCH 458/814] savepoint --- .../Auth/Services/App/AuthResponseSubscriber.swift | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index a57be3a44..e223dd142 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -57,7 +57,6 @@ class AuthResponseSubscriber { let requestId = payload.id let cacaos = payload.response.cacaos - let authRequestPayload = payload.request.authPayload Task { do { @@ -66,7 +65,7 @@ class AuthResponseSubscriber { authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) return } - let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, authRequestPayload: authRequestPayload) + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) authResponsePublisherSubject.send((requestId, .success((session, cacaos)))) } @@ -98,8 +97,7 @@ class AuthResponseSubscriber { private func createSession( from response: SessionAuthenticateResponseParams, selfParticipant: Participant, - pairingTopic: String, - authRequestPayload: AuthPayload + pairingTopic: String ) throws -> Session? { let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) From a5851020bc3fbc491a354b88a92112e7c9fb4c80 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 10:22:50 +0100 Subject: [PATCH 459/814] savepoint --- .../Auth/Services/CacaosBuilder.swift | 28 ++++++++++--------- .../SIWE/SIWEFromCacaoPayloadFormatter.swift | 5 ++-- .../SIWEFromCacaoPayloadFormatterTests.swift | 24 ++++++++++++++++ 3 files changed, 42 insertions(+), 15 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift index 5a97e8e9c..572eba175 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift @@ -13,24 +13,24 @@ struct CacaosBuilder { struct CacaoPayloadBuilder { public static func makeCacaoPayload(authPayload: AuthPayload, account: WalletConnectUtils.Account) throws -> CacaoPayload { - let recapUrns = authPayload.resources?.compactMap { try? RecapUrn(urn: $0)} ?? [] + var mergedRecap: RecapUrn? + var resources: [String]? = nil - let mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) - var statement: String? + if let recapUrns = authPayload.resources?.compactMap({ try? RecapUrn(urn: $0) }), !recapUrns.isEmpty { + mergedRecap = try? RecapUrnMergingService.merge(recapUrns: recapUrns) + } + + var statement: String? = authPayload.statement if let mergedRecapUrn = mergedRecap { - // If there's a merged recap, generate its statement statement = try SiweStatementBuilder.buildSiweStatement(statement: authPayload.statement, mergedRecapUrn: mergedRecapUrn) - } else { - // If no merged recap, use the original statement - statement = authPayload.statement } - // Filter out any resources starting with "urn:recap:", then if mergedRecap exists, add its URN as the last element - var resources = authPayload.resources?.filter { !$0.starts(with: "urn:recap:") } ?? [] - if let mergedRecapUrn = mergedRecap { - // Assuming RecapUrn can be converted back to its string representation - let mergedRecapUrnString = mergedRecapUrn.urn - resources.append(mergedRecapUrnString) + // Initialize resources with the filtered list only if authPayload.resources was not nil + if authPayload.resources != nil { + resources = authPayload.resources?.filter { !$0.starts(with: "urn:recap:") } + if let mergedRecapUrnString = mergedRecap?.urn { + resources?.append(mergedRecapUrnString) + } } return CacaoPayload( @@ -48,3 +48,5 @@ struct CacaoPayloadBuilder { ) } } + + diff --git a/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift index c26be1ee1..70a7f2dec 100644 --- a/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift +++ b/Sources/WalletConnectUtils/SIWE/SIWEFromCacaoPayloadFormatter.swift @@ -54,7 +54,8 @@ public struct SIWEFromCacaoPayloadFormatter: SIWEFromCacaoFormatting { } private func formatResourcesSection(resources: [String]?) -> String { - let resourcesList = resources?.reduce("") { $0 + "\n- \($1)" } ?? "" - return "\nResources:" + resourcesList + guard let resources = resources else { return "" } + let resourcesList = resources.reduce("") { $0 + "\n- \($1)" } + return resources.isEmpty ? "\nResources:" : "\nResources:" + resourcesList } } diff --git a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift index d5ad69c69..53773cbb2 100644 --- a/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift +++ b/Tests/WalletConnectSignTests/SIWEFromCacaoPayloadFormatterTests.swift @@ -81,6 +81,30 @@ class SIWEFromCacaoPayloadFormatterTests: XCTestCase { XCTAssertEqual(message, expectedMessage) } + func testResourcesEmptyArray() throws { + let expectedMessage = + """ + service.invalid wants you to sign in with your Ethereum account: + 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 + + I accept the ServiceOrg Terms of Service: https://service.invalid/tos + + URI: https://service.invalid/login + Version: 1 + Chain ID: 1 + Nonce: 32891756 + Issued At: 2021-09-30T16:25:24Z + Resources: + """ + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload( + authPayload: AuthPayload.stub( + requestParams: AuthRequestParams.stub(resources: []) + ), + account: Account.stub()) + let message = try sut.formatMessage(from: cacaoPayload) + XCTAssertEqual(message, expectedMessage) + } + func testNilAllOptionalParams() throws { let expectedMessage = """ From fcb0c26dce9ea69b36207a3bebc12ed4196ddb66 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 10:50:59 +0100 Subject: [PATCH 460/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 656a5be23..a02612d54 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -83,7 +83,7 @@ final class SignPresenter: ObservableObject { Task { do { ActivityIndicatorManager.shared.start() - let uri = try await Sign.instance.authenticate(.stub()) + let uri = try await Sign.instance.authenticate(.stub(resources: ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20iOnsibWFuYWdlL3BhbmNha2Vzd2FwLmNvbS1ub3RpZmljYXRpb25zIjpbe31dfX19"])) walletConnectUri = uri ActivityIndicatorManager.shared.stop() router.presentNewPairing(walletConnectUri: walletConnectUri!) From 87209e054b77375fc4601a4119bb970249c96009 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 11:00:51 +0100 Subject: [PATCH 461/814] fix auth build --- Sources/Auth/AuthClient.swift | 2 +- Sources/Auth/AuthClientFactory.swift | 2 +- Sources/Auth/Services/App/AppRespondSubscriber.swift | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/Auth/AuthClient.swift b/Sources/Auth/AuthClient.swift index 34cad9e0c..d1e34537d 100644 --- a/Sources/Auth/AuthClient.swift +++ b/Sources/Auth/AuthClient.swift @@ -103,7 +103,7 @@ public class AuthClient: AuthClientProtocol { @available(*, deprecated, message: "Use SignClient or Web3Wallet for message formatting.") public func formatMessage(payload: AuthPayload, address: String) throws -> String { - return try SIWECacaoFormatter().formatMessage(from: payload.cacaoPayload(address: address)) + return try SIWEFromCacaoPayloadFormatter().formatMessage(from: payload.cacaoPayload(address: address)) } private func setUpPublishers() { diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index c2748c5bd..ae73f8d7e 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -42,7 +42,7 @@ public struct AuthClientFactory { ) -> AuthClient { let kms = KeyManagementService(keychain: keychainStorage) let history = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) - let messageFormatter = SIWECacaoFormatter() + let messageFormatter = SIWEFromCacaoPayloadFormatter() let appRequestService = AppRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider) let verifyClient = VerifyClientFactory.create() let verifyContextStore = CodableStore(defaults: keyValueStorage, identifier: VerifyStorageIdentifiers.context.rawValue) diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift index 0973e1cf1..25c7917e0 100644 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/Auth/Services/App/AppRespondSubscriber.swift @@ -6,7 +6,7 @@ class AppRespondSubscriber { private let logger: ConsoleLogging private let rpcHistory: RPCHistory private let signatureVerifier: MessageVerifier - private let messageFormatter: SIWECacaoFormatting + private let messageFormatter: SIWEFromCacaoPayloadFormatter private let pairingRegisterer: PairingRegisterer private var publishers = [AnyCancellable]() @@ -17,7 +17,7 @@ class AppRespondSubscriber { rpcHistory: RPCHistory, signatureVerifier: MessageVerifier, pairingRegisterer: PairingRegisterer, - messageFormatter: SIWECacaoFormatting) { + messageFormatter: SIWEFromCacaoPayloadFormatter) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory From f5c67e61ad78720241b8eb864191903dc6dcd291 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 11:37:32 +0100 Subject: [PATCH 462/814] remove unused files --- Example/ExampleApp.xcodeproj/project.pbxproj | 20 -- Example/IntegrationTests/Auth/AuthTests.swift | 212 ------------------ Example/IntegrationTests/Chat/ChatTests.swift | 169 -------------- .../IntegrationTests/Chat/RegistryTests.swift | 64 ------ 4 files changed, 465 deletions(-) delete mode 100644 Example/IntegrationTests/Auth/AuthTests.swift delete mode 100644 Example/IntegrationTests/Chat/ChatTests.swift delete mode 100644 Example/IntegrationTests/Chat/RegistryTests.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 65b54643f..9f5e8dba5 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -8,7 +8,6 @@ /* Begin PBXBuildFile section */ 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */; }; - 7694A5262874296A0001257E /* RegistryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7694A5252874296A0001257E /* RegistryTests.swift */; }; 842B1D132B988BC5007F1EF8 /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D122B988BC5007F1EF8 /* Web3Modal */; }; 842B1D152B988BC5007F1EF8 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D142B988BC5007F1EF8 /* Web3ModalUI */; }; 842B1D172B988BF0007F1EF8 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D162B988BF0007F1EF8 /* Web3ModalUI */; }; @@ -56,7 +55,6 @@ 84CE642B27981DF000142511 /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 84CE642927981DF000142511 /* LaunchScreen.storyboard */; }; 84CEC64628D89D6B00D081A8 /* PairingTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CEC64528D89D6B00D081A8 /* PairingTests.swift */; }; 84D093EB2B4EA6CB005B1925 /* ActivityIndicatorManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */; }; - 84D2A66628A4F51E0088AE09 /* AuthTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84D2A66528A4F51E0088AE09 /* AuthTests.swift */; }; 84DB38F32983CDAE00BFEE37 /* PushRegisterer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */; }; 84E6B84A29787A8000428BAF /* NotificationService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84E6B84929787A8000428BAF /* NotificationService.swift */; }; 84E6B84E29787A8000428BAF /* PNDecryptionService.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 84E6B84729787A8000428BAF /* PNDecryptionService.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; }; @@ -211,7 +209,6 @@ A5E03DFD286465D100888481 /* Stubs.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E03DFC286465D100888481 /* Stubs.swift */; }; A5E03DFF2864662500888481 /* WalletConnect in Frameworks */ = {isa = PBXBuildFile; productRef = A5E03DFE2864662500888481 /* WalletConnect */; }; A5E03E01286466EA00888481 /* WalletConnectChat in Frameworks */ = {isa = PBXBuildFile; productRef = A5E03E00286466EA00888481 /* WalletConnectChat */; }; - A5E03E03286466F400888481 /* ChatTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E03E02286466F400888481 /* ChatTests.swift */; }; A5E03E1128646F8000888481 /* KeychainStorageMock.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E03E1028646F8000888481 /* KeychainStorageMock.swift */; }; A5E22D1A2840C62A00E36487 /* Engine.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D192840C62A00E36487 /* Engine.swift */; }; A5E22D1C2840C85D00E36487 /* App.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D1B2840C85D00E36487 /* App.swift */; }; @@ -397,7 +394,6 @@ 764E1D5526F8DADE00A1FB15 /* WalletConnectSwiftV2 */ = {isa = PBXFileReference; lastKnownFileType = folder; name = WalletConnectSwiftV2; path = ..; sourceTree = ""; }; 764E1D5626F8DB6000A1FB15 /* WalletConnectSwiftV2 */ = {isa = PBXFileReference; lastKnownFileType = folder; name = WalletConnectSwiftV2; path = ..; sourceTree = ""; }; 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = EthSendTransaction.swift; sourceTree = ""; }; - 7694A5252874296A0001257E /* RegistryTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RegistryTests.swift; sourceTree = ""; }; 84310D04298BC980000C15B6 /* MainInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainInteractor.swift; sourceTree = ""; }; 8439CB88293F658E00F2F2E2 /* PushMessage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PushMessage.swift; sourceTree = ""; }; 844749F329B9E5B9005F520B /* RelayIntegrationTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = RelayIntegrationTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; @@ -438,7 +434,6 @@ 84CE6453279FFE1100142511 /* Wallet.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = Wallet.entitlements; sourceTree = ""; }; 84CEC64528D89D6B00D081A8 /* PairingTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PairingTests.swift; sourceTree = ""; }; 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActivityIndicatorManager.swift; sourceTree = ""; }; - 84D2A66528A4F51E0088AE09 /* AuthTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthTests.swift; sourceTree = ""; }; 84D72FC62B4692770057EAF3 /* DApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DApp.entitlements; sourceTree = ""; }; 84DB38F029828A7C00BFEE37 /* WalletApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletApp.entitlements; sourceTree = ""; }; 84DB38F129828A7F00BFEE37 /* PNDecryptionService.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = PNDecryptionService.entitlements; sourceTree = ""; }; @@ -569,7 +564,6 @@ A5E03DED286464DB00888481 /* IntegrationTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = IntegrationTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; A5E03DF9286465C700888481 /* SignClientTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SignClientTests.swift; sourceTree = ""; }; A5E03DFC286465D100888481 /* Stubs.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Stubs.swift; sourceTree = ""; }; - A5E03E02286466F400888481 /* ChatTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatTests.swift; sourceTree = ""; }; A5E03E1028646F8000888481 /* KeychainStorageMock.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = KeychainStorageMock.swift; sourceTree = ""; }; A5E22D192840C62A00E36487 /* Engine.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Engine.swift; sourceTree = ""; }; A5E22D1B2840C85D00E36487 /* App.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = App.swift; sourceTree = ""; }; @@ -981,7 +975,6 @@ children = ( A58A1ECA29BF457800A82A20 /* ENS */, A54195992934BFDD0035AD19 /* Signer */, - 84D2A66528A4F51E0088AE09 /* AuthTests.swift */, ); path = Auth; sourceTree = ""; @@ -1462,21 +1455,11 @@ 84CEC64728D8A98900D081A8 /* Pairing */, A5E03E0A28646A8A00888481 /* Stubs */, A5E03E0928646A8100888481 /* Sign */, - A5E03E0828646A7B00888481 /* Chat */, 84D2A66728A4F5260088AE09 /* Auth */, ); path = IntegrationTests; sourceTree = ""; }; - A5E03E0828646A7B00888481 /* Chat */ = { - isa = PBXGroup; - children = ( - A5E03E02286466F400888481 /* ChatTests.swift */, - 7694A5252874296A0001257E /* RegistryTests.swift */, - ); - path = Chat; - sourceTree = ""; - }; A5E03E0928646A8100888481 /* Sign */ = { isa = PBXGroup; children = ( @@ -2414,12 +2397,9 @@ A541959E2934BFEF0035AD19 /* CacaoSignerTests.swift in Sources */, A59CF4F6292F83D50031A42F /* DefaultSignerFactory.swift in Sources */, 847F08012A25DBFF00B2A5A4 /* XPlatformW3WTests.swift in Sources */, - A5E03E03286466F400888481 /* ChatTests.swift in Sources */, 849D7A93292E2169006A2BD4 /* NotifyTests.swift in Sources */, 845B8D8C2934B36C0084A966 /* Account.swift in Sources */, - 84D2A66628A4F51E0088AE09 /* AuthTests.swift in Sources */, 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */, - 7694A5262874296A0001257E /* RegistryTests.swift in Sources */, A541959F2934BFEF0035AD19 /* SignerTests.swift in Sources */, A58A1ECC29BF458600A82A20 /* ENSResolverTests.swift in Sources */, A5E03DFA286465C700888481 /* SignClientTests.swift in Sources */, diff --git a/Example/IntegrationTests/Auth/AuthTests.swift b/Example/IntegrationTests/Auth/AuthTests.swift deleted file mode 100644 index aed8cba64..000000000 --- a/Example/IntegrationTests/Auth/AuthTests.swift +++ /dev/null @@ -1,212 +0,0 @@ -// -//import Foundation -//import XCTest -//@testable import WalletConnectUtils -//@testable import WalletConnectKMS -//import WalletConnectRelay -//import Combine -//@testable import Auth -//import WalletConnectPairing -//import WalletConnectNetworking -//import WalletConnectVerify -// -//final class AuthTests: XCTestCase { -// var appPairingClient: PairingClient! -// var walletPairingClient: PairingClient! -// -// var appAuthClient: AuthClient! -// var walletAuthClient: AuthClient! -// -// let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! -// let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") -// let eip1271Signature = "0xc1505719b2504095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" -// private var publishers = [AnyCancellable]() -// -// override func setUp() { -// setupClients() -// } -// -// private func setupClients(iatProvider: IATProvider = DefaultIATProvider()) { -// (appPairingClient, appAuthClient) = makeClients(prefix: "🤖 App", iatProvider: iatProvider) -// (walletPairingClient, walletAuthClient) = makeClients(prefix: "🐶 Wallet", iatProvider: iatProvider) -// } -// -// func makeClients(prefix: String, iatProvider: IATProvider) -> (PairingClient, AuthClient) { -// let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) -// let keyValueStorage = RuntimeKeyValueStorage() -// let keychain = KeychainStorageMock() -// let relayClient = RelayClientFactory.create( -// relayHost: InputConfig.relayHost, -// projectId: InputConfig.projectId, -// keyValueStorage: keyValueStorage, -// keychainStorage: keychain, -// socketFactory: DefaultSocketFactory(), -// networkMonitor: NetworkMonitor(), -// logger: logger) -// -// let networkingClient = NetworkingClientFactory.create( -// relayClient: relayClient, -// logger: logger, -// keychainStorage: keychain, -// keyValueStorage: keyValueStorage) -// -// let pairingClient = PairingClientFactory.create( -// logger: logger, -// keyValueStorage: keyValueStorage, -// keychainStorage: keychain, -// networkingClient: networkingClient) -// -// let authClient = AuthClientFactory.create( -// metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), -// projectId: InputConfig.projectId, -// crypto: DefaultCryptoProvider(), -// logger: logger, -// keyValueStorage: keyValueStorage, -// keychainStorage: keychain, -// networkingClient: networkingClient, -// pairingRegisterer: pairingClient, -// iatProvider: iatProvider) -// -// let clientId = try! networkingClient.getClientId() -// logger.debug("My client id is: \(clientId)") -// -// return (pairingClient, authClient) -// } -// -// func testRequest() async { -// let requestExpectation = expectation(description: "request delivered to wallet") -// let uri = try! await appPairingClient.create() -// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// walletAuthClient.authRequestPublisher.sink { _ in -// requestExpectation.fulfill() -// }.store(in: &publishers) -// wait(for: [requestExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testEIP191RespondSuccess() async { -// let responseExpectation = expectation(description: "successful response delivered") -// let uri = try! await appPairingClient.create() -// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// walletAuthClient.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// let signerFactory = DefaultSignerFactory() -// let signer = MessageSignerFactory(signerFactory: signerFactory).create(projectId: InputConfig.projectId) -// let payload = try! request.0.payload.cacaoPayload(address: walletAccount.address) -// let signature = try! signer.sign(payload: payload, privateKey: prvKey, type: .eip191) -// try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: walletAccount) -// } -// } -// .store(in: &publishers) -// appAuthClient.authResponsePublisher.sink { (_, result) in -// guard case .success = result else { XCTFail(); return } -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testEIP1271RespondSuccess() async { -// setupClients(iatProvider: IATProviderMock()) -// -// let account = Account(chainIdentifier: "eip155:1", address: "0x2faf83c542b68f1b4cdc0e770e8cb9f567b08f71")! -// -// let responseExpectation = expectation(description: "successful response delivered") -// let uri = try! await appPairingClient.create() -// try! await appAuthClient.request(RequestParams( -// domain: "localhost", -// chainId: "eip155:1", -// nonce: "1665443015700", -// aud: "http://localhost:3000/", -// nbf: nil, -// exp: "2022-10-11T23:03:35.700Z", -// statement: nil, -// requestId: nil, -// resources: nil -// ), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// walletAuthClient.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) -// try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: account) -// } -// } -// .store(in: &publishers) -// appAuthClient.authResponsePublisher.sink { (_, result) in -// guard case .success = result else { XCTFail(); return } -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testEIP191RespondError() async { -// let responseExpectation = expectation(description: "error response delivered") -// let uri = try! await appPairingClient.create() -// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// walletAuthClient.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) -// try! await walletAuthClient.respond(requestId: request.0.id, signature: signature, from: walletAccount) -// } -// } -// .store(in: &publishers) -// appAuthClient.authResponsePublisher.sink { (_, result) in -// guard case let .failure(error) = result, error == .signatureVerificationFailed else { XCTFail(); return } -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testUserRespondError() async { -// let responseExpectation = expectation(description: "error response delivered") -// let uri = try! await appPairingClient.create() -// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// walletAuthClient.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// try! await walletAuthClient.reject(requestId: request.0.id) -// } -// } -// .store(in: &publishers) -// appAuthClient.authResponsePublisher.sink { (_, result) in -// guard case .failure(let error) = result else { XCTFail(); return } -// XCTAssertEqual(error, .userRejeted) -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testRespondSignatureVerificationFailed() async { -// let responseExpectation = expectation(description: "invalid signature response delivered") -// let uri = try! await appPairingClient.create() -// try! await appAuthClient.request(RequestParams.stub(), topic: uri.topic) -// -// try? await walletPairingClient.pair(uri: uri) -// walletAuthClient.authRequestPublisher.sink { [unowned self] request in -// Task(priority: .high) { -// let invalidSignature = "438effc459956b57fcd9f3dac6c675f9cee88abf21acab7305e8e32aa0303a883b06dcbd956279a7a2ca21ffa882ff55cc22e8ab8ec0f3fe90ab45f306938cfa1b" -// let cacaoSignature = CacaoSignature(t: .eip191, s: invalidSignature) -// try! await walletAuthClient.respond(requestId: request.0.id, signature: cacaoSignature, from: walletAccount) -// } -// } -// .store(in: &publishers) -// appAuthClient.authResponsePublisher.sink { (_, result) in -// guard case .failure(let error) = result else { XCTFail(); return } -// XCTAssertEqual(error, .signatureVerificationFailed) -// responseExpectation.fulfill() -// } -// .store(in: &publishers) -// wait(for: [responseExpectation], timeout: InputConfig.defaultTimeout) -// } -//} -//>>>>>>> bd8835437254fb808be3ac89fdcff43fa13c3b87 diff --git a/Example/IntegrationTests/Chat/ChatTests.swift b/Example/IntegrationTests/Chat/ChatTests.swift deleted file mode 100644 index 09c96faf0..000000000 --- a/Example/IntegrationTests/Chat/ChatTests.swift +++ /dev/null @@ -1,169 +0,0 @@ -// -//import Foundation -//import XCTest -//@testable import WalletConnectChat -//import WalletConnectUtils -//@testable import WalletConnectKMS -//@testable import WalletConnectSync -//import WalletConnectRelay -//import Combine -//import Web3 -// -//final class ChatTests: XCTestCase { -// var invitee1: ChatClient! -// var inviter1: ChatClient! -// var invitee2: ChatClient! -// var inviter2: ChatClient! -// private var publishers = [AnyCancellable]() -// -// var inviteeAccount: Account { -// return Account("eip155:1:" + pk1.address.hex(eip55: true))! -// } -// -// var inviterAccount: Account { -// return Account("eip155:1:" + pk2.address.hex(eip55: true))! -// } -// -// let pk1 = try! EthereumPrivateKey() -// let pk2 = try! EthereumPrivateKey() -// -// var privateKey1: Data { -// return Data(pk1.rawPrivateKey) -// } -// var privateKey2: Data { -// return Data(pk2.rawPrivateKey) -// } -// -// override func setUp() async throws { -// invitee1 = makeClient(prefix: "🦖 Invitee", account: inviteeAccount) -// inviter1 = makeClient(prefix: "🍄 Inviter", account: inviterAccount) -// -// try await invitee1.register(account: inviteeAccount, domain: "") { message in -// return self.sign(message, privateKey: self.privateKey1) -// } -// try await inviter1.register(account: inviterAccount, domain: "") { message in -// return self.sign(message, privateKey: self.privateKey2) -// } -// } -// -// func makeClient(prefix: String, account: Account) -> ChatClient { -// let keyserverURL = URL(string: "https://keys.walletconnect.com")! -// let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) -// let keyValueStorage = RuntimeKeyValueStorage() -// let keychain = KeychainStorageMock() -// let relayClient = RelayClientFactory.create( -// relayHost: InputConfig.relayHost, -// projectId: InputConfig.projectId, -// keyValueStorage: keyValueStorage, -// keychainStorage: keychain, -// socketFactory: DefaultSocketFactory(), -// networkMonitor: NetworkMonitor(), -// logger: logger) -// -// let networkingInteractor = NetworkingClientFactory.create( -// relayClient: relayClient, -// logger: logger, -// keychainStorage: keychain, -// keyValueStorage: keyValueStorage) -// -// let syncClient = SyncClientFactory.create( -// networkInteractor: networkingInteractor, -// bip44: DefaultBIP44Provider(), -// keychain: keychain -// ) -// -// let clientId = try! networkingInteractor.getClientId() -// logger.debug("My client id is: \(clientId)") -// -// return ChatClientFactory.create(keyserverURL: keyserverURL, relayClient: relayClient, networkingInteractor: networkingInteractor, keychain: keychain, logger: logger, storage: keyValueStorage, syncClient: syncClient) -// } -// -// func testInvite() async throws { -// let inviteExpectation = expectation(description: "invitation expectation") -// inviteExpectation.expectedFulfillmentCount = 2 -// -// invitee1.newReceivedInvitePublisher.sink { _ in -// inviteExpectation.fulfill() -// }.store(in: &publishers) -// -// inviter1.newSentInvitePublisher.sink { _ in -// inviteExpectation.fulfill() -// }.store(in: &publishers) -// -// let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) -// let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) -// _ = try await inviter1.invite(invite: invite) -// -// wait(for: [inviteExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testAcceptAndCreateNewThread() async throws { -// let newThreadInviterExpectation = expectation(description: "new thread on inviting client expectation") -// let newThreadinviteeExpectation = expectation(description: "new thread on invitee client expectation") -// -// invitee1.newReceivedInvitePublisher.sink { [unowned self] invite in -// Task { try! await invitee1.accept(inviteId: invite.id) } -// }.store(in: &publishers) -// -// invitee1.newThreadPublisher.sink { _ in -// newThreadinviteeExpectation.fulfill() -// }.store(in: &publishers) -// -// inviter1.newThreadPublisher.sink { _ in -// newThreadInviterExpectation.fulfill() -// }.store(in: &publishers) -// -// let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) -// let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) -// try await inviter1.invite(invite: invite) -// -// wait(for: [newThreadinviteeExpectation, newThreadInviterExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// func testMessage() async throws { -// let messageExpectation = expectation(description: "message received") -// messageExpectation.expectedFulfillmentCount = 4 -// -// invitee1.newReceivedInvitePublisher.sink { [unowned self] invite in -// Task { try! await invitee1.accept(inviteId: invite.id) } -// }.store(in: &publishers) -// -// invitee1.newThreadPublisher.sink { [unowned self] thread in -// Task { try! await invitee1.message(topic: thread.topic, message: "message1") } -// }.store(in: &publishers) -// -// inviter1.newThreadPublisher.sink { [unowned self] thread in -// Task { try! await inviter1.message(topic: thread.topic, message: "message2") } -// }.store(in: &publishers) -// -// inviter1.newMessagePublisher.sink { message in -// if message.authorAccount == self.inviterAccount { -// XCTAssertEqual(message.message, "message2") -// } else { -// XCTAssertEqual(message.message, "message1") -// } -// messageExpectation.fulfill() -// }.store(in: &publishers) -// -// invitee1.newMessagePublisher.sink { message in -// if message.authorAccount == self.inviteeAccount { -// XCTAssertEqual(message.message, "message1") -// } else { -// XCTAssertEqual(message.message, "message2") -// } -// messageExpectation.fulfill() -// }.store(in: &publishers) -// -// let inviteePublicKey = try await inviter1.resolve(account: inviteeAccount) -// let invite = Invite(message: "", inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) -// try await inviter1.invite(invite: invite) -// -// wait(for: [messageExpectation], timeout: InputConfig.defaultTimeout) -// } -// -// private func sign(_ message: String, privateKey: Data) -> SigningResult { -// let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create(projectId: InputConfig.projectId) -// return .signed(try! signer.sign(message: message, privateKey: privateKey, type: .eip191)) -// } -//} -//>>>>>>> bd8835437254fb808be3ac89fdcff43fa13c3b87 diff --git a/Example/IntegrationTests/Chat/RegistryTests.swift b/Example/IntegrationTests/Chat/RegistryTests.swift deleted file mode 100644 index 178c63be4..000000000 --- a/Example/IntegrationTests/Chat/RegistryTests.swift +++ /dev/null @@ -1,64 +0,0 @@ -import XCTest -import WalletConnectNetworking -import WalletConnectKMS -import WalletConnectUtils -@testable import WalletConnectChat -@testable import WalletConnectIdentity - -final class RegistryTests: XCTestCase { - - let account = Account("eip155:1:0x15bca56b6e2728aec2532df9d436bd1600e86688")! - let privateKey = Data(hex: "305c6cde3846927892cd32762f6120539f3ec74c9e3a16b9b798b1e85351ae2a") - - var sut: IdentityService! - var storage: IdentityStorage! - var signer: MessageSigner! - - override func setUp() { - let keyserverURL = URL(string: "https://keys.walletconnect.com")! - let httpService = HTTPNetworkClient(host: keyserverURL.host!) - let identityNetworkService = IdentityNetworkService(httpService: httpService) - let keychain = KeychainStorageMock() - let ksm = KeyManagementService(keychain: keychain) - storage = IdentityStorage(keychain: keychain) - sut = IdentityService ( - keyserverURL: keyserverURL, - kms: ksm, - storage: storage, - networkService: identityNetworkService, - iatProvader: DefaultIATProvider(), - messageFormatter: SIWEFromCacaoPayloadFormatter() - ) - signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() - } - -// func testRegisterIdentityAndInviteKey() async throws { -// let publicKey = try await sut.registerIdentity(account: account, onSign: onSign) -// -// let iss = DIDKey(rawData: Data(hex: publicKey)).did(variant: .ED25519) -// let resolvedAccount = try await sut.resolveIdentity(iss: iss) -// XCTAssertEqual(resolvedAccount, account) -// -// let recovered = try storage.getIdentityKey(for: account).publicKey.hexRepresentation -// XCTAssertEqual(publicKey, recovered) -// -// let inviteKey = try await sut.registerInvite(account: account) -// -// let recoveredKey = try storage.getInviteKey(for: account) -// XCTAssertEqual(inviteKey, recoveredKey) -// -// let resolvedKey = try await sut.resolveInvite(account: account) -// XCTAssertEqual(inviteKey.did, resolvedKey) -// -// _ = try await sut.goPrivate(account: account) -// try await sut.unregister(account: account, onSign: onSign) -// } -} - -private extension RegistryTests { - - func onSign(_ message: String) -> SigningResult { - let signature = try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - return .signed(signature) - } -} From 5b1563a99ba9272e56e55d7a365cda6e2dd1b7b2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 15:05:13 +0100 Subject: [PATCH 463/814] fix signclient tests --- Example/IntegrationTests/Sign/SignClientTests.swift | 9 +++++++-- .../WalletConnectSign/Engine/Common/SessionEngine.swift | 1 - 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 59b5afa59..a6327897c 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -196,7 +196,9 @@ final class SignClientTests: XCTestCase { let requestParams = [EthSendTransaction.stub()] let responseParams = "0xdeadbeef" let chain = Blockchain("eip155:1")! - + + // sleep is needed as emitRequestIfPending() will be called on client init and then on request itself, second request would be debouced + sleep(1) wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { do { @@ -247,6 +249,8 @@ final class SignClientTests: XCTestCase { let chain = Blockchain("eip155:1")! + // sleep is needed as emitRequestIfPending() will be called on client init and then on request itself, second request would be debouced + sleep(1) wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in Task(priority: .high) { try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) @@ -973,7 +977,8 @@ final class SignClientTests: XCTestCase { let requestParams = [EthSendTransaction.stub()] let responseParams = "0xdeadbeef" let chain = Blockchain("eip155:1")! - + // sleep is needed as emitRequestIfPending() will be called on client init and then on request itself, second request would be debouced + sleep(1) wallet.authRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 82b1d0a53..435f34f98 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -52,7 +52,6 @@ final class SessionEngine { setupUpdateSubscriptions() setupExpirationSubscriptions() DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in - guard let self = self else {return} sessionRequestsProvider.emitRequestIfPending() } } From 21ca87604499ad0ed6ea94bf469fe5e023e32406 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 15:10:14 +0100 Subject: [PATCH 464/814] update solana caip --- .../Contents.json | 0 .../solana (1).png | Bin Example/DApp/Modules/Sign/SignInteractor.swift | 2 +- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- Example/IntegrationTests/Sign/SignClientTests.swift | 6 +++--- .../AutoNamespacesValidationTests.swift | 10 +++++----- 6 files changed, 10 insertions(+), 10 deletions(-) rename Example/DApp/Assets.xcassets/{solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ.imageset => solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset}/Contents.json (100%) rename Example/DApp/Assets.xcassets/{solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ.imageset => solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset}/solana (1).png (100%) diff --git a/Example/DApp/Assets.xcassets/solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ.imageset/Contents.json b/Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/Contents.json similarity index 100% rename from Example/DApp/Assets.xcassets/solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ.imageset/Contents.json rename to Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/Contents.json diff --git a/Example/DApp/Assets.xcassets/solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ.imageset/solana (1).png b/Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/solana (1).png similarity index 100% rename from Example/DApp/Assets.xcassets/solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ.imageset/solana (1).png rename to Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/solana (1).png diff --git a/Example/DApp/Modules/Sign/SignInteractor.swift b/Example/DApp/Modules/Sign/SignInteractor.swift index 8fa7d0e2b..29c1e3dba 100644 --- a/Example/DApp/Modules/Sign/SignInteractor.swift +++ b/Example/DApp/Modules/Sign/SignInteractor.swift @@ -20,7 +20,7 @@ enum Proposal { static let optionalNamespaces: [String: ProposalNamespace] = [ "solana": ProposalNamespace( chains: [ - Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")! + Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")! ], methods: [ "solana_signMessage", diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index a02612d54..402e6e5b8 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -16,7 +16,7 @@ final class SignPresenter: ObservableObject { let chains = [ Chain(name: "Ethereum", id: "eip155:1"), Chain(name: "Polygon", id: "eip155:137"), - Chain(name: "Solana", id: "solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ") + Chain(name: "Solana", id: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp") ] private let interactor: SignInteractor diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index a6327897c..1d68f9305 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -459,7 +459,7 @@ final class SignClientTests: XCTestCase { events: ["any"] ), "solana": ProposalNamespace( - chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], + chains: [Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!], methods: ["solana_signMessage"], events: ["any"] ) @@ -481,12 +481,12 @@ final class SignClientTests: XCTestCase { Blockchain("eip155:137")!, Blockchain("eip155:1")!, Blockchain("eip155:5")!, - Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")! + Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")! ], methods: ["personal_sign", "eth_sendTransaction", "solana_signMessage"], events: ["any"], accounts: [ - Account(blockchain: Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!, address: "4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!, + Account(blockchain: Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, address: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, Account(blockchain: Blockchain("eip155:1")!, address: "0x00")!, Account(blockchain: Blockchain("eip155:137")!, address: "0x00")!, Account(blockchain: Blockchain("eip155:5")!, address: "0x00")! diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index f7c65f72d..f0c0a9fc3 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -803,7 +803,7 @@ final class AutoNamespacesValidationTests: XCTestCase { func testAutoNamespacesDifferentChainEmptyOptinalEvents() { let accounts = [ Account(blockchain: Blockchain("eip155:1")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")!, - Account(blockchain: Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!, address: "4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")! + Account(blockchain: Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, address: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")! ] let requiredNamespaces = [ "eip155": ProposalNamespace( @@ -818,7 +818,7 @@ final class AutoNamespacesValidationTests: XCTestCase { events: [] ), "solana": ProposalNamespace( - chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], + chains: [Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!], methods: ["solana_signMessage"], events: [] ) @@ -827,7 +827,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let sessionNamespaces = try! AutoNamespaces.build( sessionProposal: sessionProposal, - chains: [Blockchain("eip155:1")!, Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], + chains: [Blockchain("eip155:1")!, Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!], methods: ["personal_sign", "eth_sendTransaction", "eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "solana_signMessage", "solana_signMessage"], events: ["chainChanged", "accountsChanged"], accounts: accounts @@ -842,9 +842,9 @@ final class AutoNamespacesValidationTests: XCTestCase { events: ["chainChanged", "accountsChanged"] ), "solana": SessionNamespace( - chains: [Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!], + chains: [Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!], accounts: Set([ - Account(blockchain: Blockchain("solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!, address: "4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ")!, + Account(blockchain: Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, address: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, ]), methods: ["solana_signMessage"], events: [] From 453eacad2cdf907c0071efb2e5a34bda23c78160 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 12 Mar 2024 15:19:22 +0100 Subject: [PATCH 465/814] remove trash --- .../Contents.json | 0 .../solana (1).png | Bin Tests/ChatTests/RegistryServiceTests.swift | 106 ------------------ 3 files changed, 106 deletions(-) rename Example/DApp/Assets.xcassets/{solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset => solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset}/Contents.json (100%) rename Example/DApp/Assets.xcassets/{solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset => solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset}/solana (1).png (100%) delete mode 100644 Tests/ChatTests/RegistryServiceTests.swift diff --git a/Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/Contents.json b/Example/DApp/Assets.xcassets/solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/Contents.json similarity index 100% rename from Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/Contents.json rename to Example/DApp/Assets.xcassets/solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/Contents.json diff --git a/Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/solana (1).png b/Example/DApp/Assets.xcassets/solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/solana (1).png similarity index 100% rename from Example/DApp/Assets.xcassets/solana: 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/solana (1).png rename to Example/DApp/Assets.xcassets/solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.imageset/solana (1).png diff --git a/Tests/ChatTests/RegistryServiceTests.swift b/Tests/ChatTests/RegistryServiceTests.swift deleted file mode 100644 index 8f6cb51b7..000000000 --- a/Tests/ChatTests/RegistryServiceTests.swift +++ /dev/null @@ -1,106 +0,0 @@ -import Foundation -import XCTest -@testable import WalletConnectChat -import WalletConnectUtils -import WalletConnectNetworking -import WalletConnectKMS -@testable import TestingUtils -@testable import WalletConnectIdentity - -final class RegistryServiceTests: XCTestCase { - var resubscriptionService: ResubscriptionService! - var identityClient: IdentityClient! - var identityStorage: IdentityStorage! - var networkService: IdentityNetwotkServiceMock! - var networkingInteractor: NetworkingInteractorMock! - var kms: KeyManagementServiceMock! - - let account = Account("eip155:1:0x1AAe9864337E821f2F86b5D27468C59AA333C877")! - let privateKey = "4dc0055d1831f7df8d855fc8cd9118f4a85ddc05395104c4cb0831a6752621a8" - - let cacaoStub: Cacao = { - return Cacao(h: .init(t: ""), p: .init(iss: "", domain: "", aud: "", version: "", nonce: "", iat: "", nbf: "", exp: nil, statement: nil, requestId: nil, resources: nil), s: .init(t: .eip191, s: "")) - }() - - let inviteKeyStub = "62720d14643acf0f7dd87513b079502f56be414a2f2ea4719342cf088c794173" - - override func setUp() { - networkingInteractor = NetworkingInteractorMock() - kms = KeyManagementServiceMock() - identityStorage = IdentityStorage(keychain: KeychainStorageMock()) - networkService = IdentityNetwotkServiceMock(cacao: cacaoStub, inviteKey: inviteKeyStub) - - let identitySevice = IdentityService( - keyserverURL: URL(string: "https://www.url.com")!, - kms: kms, - storage: identityStorage, - networkService: networkService, - iatProvader: DefaultIATProvider(), - messageFormatter: SIWECacaoFormatter() - ) - identityClient = IdentityClient(identityService: identitySevice, identityStorage: identityStorage, logger: ConsoleLoggerMock()) - - resubscriptionService = ResubscriptionService(networkingInteractor: networkingInteractor, kms: kms, logger: ConsoleLoggerMock()) - } - -// func testRegister() async throws { -// let pubKey = try await identityClient.register(account: account, onSign: onSign) -// -// XCTAssertTrue(networkService.callRegisterIdentity) -// -// let identityKey = try identityStorage.getIdentityKey(for: account) -// XCTAssertEqual(identityKey.publicKey.hexRepresentation, pubKey) -// } - -// func testGoPublic() async throws { -// XCTAssertTrue(networkingInteractor.subscriptions.isEmpty) -// -// _ = try await identityClient.register(account: account, onSign: onSign) -// let inviteKey = try await identityClient.goPublic(account: account) -// try await resubscriptionService.subscribeForInvites(inviteKey: inviteKey) -// -// XCTAssertNoThrow(try identityStorage.getInviteKey(for: account)) -// XCTAssertTrue(networkService.callRegisterInvite) -// -// XCTAssertEqual(networkingInteractor.subscriptions.count, 1) -// XCTAssertNotNil(kms.getPublicKey(for: networkingInteractor.subscriptions[0])) -// } - -// func testUnregister() async throws { -// XCTAssertThrowsError(try identityStorage.getIdentityKey(for: account)) -// -// _ = try await identityClient.register(account: account, onSign: onSign) -// XCTAssertNoThrow(try identityStorage.getIdentityKey(for: account)) -// -// try await identityClient.unregister(account: account, onSign: onSign) -// XCTAssertThrowsError(try identityStorage.getIdentityKey(for: account)) -// XCTAssertTrue(networkService.callRemoveIdentity) -// } - - func testGoPrivate() async throws { - let invitePubKey = try AgreementPublicKey(hex: inviteKeyStub) - try identityStorage.saveInviteKey(invitePubKey, for: account) - - let identityKey = SigningPrivateKey() - try identityStorage.saveIdentityKey(identityKey, for: account) - - let topic = invitePubKey.rawRepresentation.sha256().toHexString() - try await networkingInteractor.subscribe(topic: topic) - - let inviteKey = try await identityClient.goPrivate(account: account) - resubscriptionService.unsubscribeFromInvites(inviteKey: inviteKey) - - XCTAssertThrowsError(try identityStorage.getInviteKey(for: account)) - XCTAssertTrue(networkingInteractor.unsubscriptions.contains(topic)) - } - - func testResolve() async throws { - let inviteKey = try await identityClient.resolveInvite(account: account) - - XCTAssertEqual(inviteKey, inviteKeyStub) - } - - private func onSign(_ message: String) -> SigningResult { - return .signed(CacaoSignature(t: .eip191, s: "")) - } -} From 4da0bd9808a0aac201b236ad1e6bfa5a267acb70 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 13 Mar 2024 13:44:37 +0100 Subject: [PATCH 466/814] fix siwe fallback --- Example/DApp/Modules/Sign/SignInteractor.swift | 13 +++++++++++-- Example/DApp/Modules/Sign/SignPresenter.swift | 4 ++-- .../Auth/Services/ProposalNamespaceBuilder.swift | 7 +++++-- 3 files changed, 18 insertions(+), 6 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignInteractor.swift b/Example/DApp/Modules/Sign/SignInteractor.swift index 29c1e3dba..8c35d79c1 100644 --- a/Example/DApp/Modules/Sign/SignInteractor.swift +++ b/Example/DApp/Modules/Sign/SignInteractor.swift @@ -6,8 +6,7 @@ enum Proposal { static let requiredNamespaces: [String: ProposalNamespace] = [ "eip155": ProposalNamespace( chains: [ - Blockchain("eip155:1")!, - Blockchain("eip155:137")! + Blockchain("eip155:1")! ], methods: [ "eth_sendTransaction", @@ -26,6 +25,16 @@ enum Proposal { "solana_signMessage", "solana_signTransaction" ], events: [] + ), + "eip155": ProposalNamespace( + chains: [ + Blockchain("eip155:137")! + ], + methods: [ + "eth_sendTransaction", + "personal_sign", + "eth_signTypedData" + ], events: [] ) ] } diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 402e6e5b8..a4e58c95a 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -83,7 +83,7 @@ final class SignPresenter: ObservableObject { Task { do { ActivityIndicatorManager.shared.start() - let uri = try await Sign.instance.authenticate(.stub(resources: ["urn:recap:eyJhdHQiOnsiaHR0cHM6Ly9ub3RpZnkud2FsbGV0Y29ubmVjdC5jb20iOnsibWFuYWdlL3BhbmNha2Vzd2FwLmNvbS1ub3RpZmljYXRpb25zIjpbe31dfX19"])) + let uri = try await Sign.instance.authenticate(.stub()) walletConnectUri = uri ActivityIndicatorManager.shared.stop() router.presentNewPairing(walletConnectUri: walletConnectUri!) @@ -98,7 +98,7 @@ final class SignPresenter: ObservableObject { Task { do { ActivityIndicatorManager.shared.start() - let uri = try await Sign.instance.authenticate(.stub(methods: nil)) + let uri = try await Sign.instance.authenticate(.stub(methods: ["personal_sign"])) walletConnectUri = uri ActivityIndicatorManager.shared.stop() router.presentNewPairing(walletConnectUri: walletConnectUri!) diff --git a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift index eb11fc983..3c4ca0861 100644 --- a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift @@ -9,16 +9,19 @@ struct ProposalNamespaceBuilder { } static func buildNamespace(from params: AuthRequestParams) throws -> [String: ProposalNamespace] { + var methods = Set(params.methods ?? []) + if methods.isEmpty { + methods = ["personal_sign"] + } let chains: Set = Set(params.chains.compactMap { Blockchain($0) }) guard chains.allSatisfy({$0.namespace == "eip155"}) else { throw Errors.unsupportedChain } - let methods = Set(params.methods ?? []) return [ "eip155": ProposalNamespace( chains: chains, methods: methods, - events: [] + events: ["chainChanged", "accountsChanged"] )] } } From 8b6aac5dfb5405e333f71c81eae263b41116f61e Mon Sep 17 00:00:00 2001 From: llbartekll Date: Wed, 13 Mar 2024 12:54:35 +0000 Subject: [PATCH 467/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index eca36dd02..25d66792e 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.14.0"} +{"version": "1.15.0"} From 89f412d2a3df2bcb30f761557035e3252e4e9ae7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 15 Mar 2024 09:37:15 +0100 Subject: [PATCH 468/814] fallback if auth request not integrated --- .../Sign/SignClientTests.swift | 24 +++++++++++++++ .../Client/Wallet/NotifyClient.swift | 11 ------- .../Engine/Common/ApproveEngine.swift | 7 +++-- .../AuthRequestSubscribersTracking.swift | 29 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 13 +++++++-- .../Sign/SignClientFactory.swift | 7 +++-- 6 files changed, 74 insertions(+), 17 deletions(-) create mode 100644 Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 1d68f9305..82dac015b 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1062,4 +1062,28 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [fallbackExpectation], timeout: InputConfig.defaultTimeout) } + + func testFallbackToSessionProposeIfWalletIsNotSubscribingSessionAuthenticate() async throws { + let responseExpectation = expectation(description: "successful response delivered") + + let requiredNamespaces = ProposalNamespace.stubRequired() + let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) + + wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in + Task(priority: .high) { + do { _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) } catch { XCTFail("\(error)") } + } + }.store(in: &publishers) + + dapp.sessionSettlePublisher.sink { settledSession in + Task(priority: .high) { + responseExpectation.fulfill() + } + }.store(in: &publishers) + + let uri = try await dapp.authenticate(AuthRequestParams.stub()) + try await walletPairingClient.pair(uri: uri) + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift index 7664d62f4..6042e0366 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyClient.swift @@ -180,17 +180,6 @@ public class NotifyClient { } } -private extension NotifyClient { - - func makeStatement(allApps: Bool) -> String { - switch allApps { - case false: - return "I further authorize this app to send me notifications. Read more at https://walletconnect.com/notifications" - case true: - return "I further authorize this app to view and manage my notifications for ALL apps. Read more at https://walletconnect.com/notifications" - } - } -} #if targetEnvironment(simulator) extension NotifyClient { diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 33c951dc0..e2dc938ac 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -29,6 +29,7 @@ final class ApproveEngine { private let kms: KeyManagementServiceProtocol private let logger: ConsoleLogging private let rpcHistory: RPCHistory + private let authRequestSubscribersTracking: AuthRequestSubscribersTracking private var publishers = Set() @@ -44,7 +45,8 @@ final class ApproveEngine { pairingStore: WCPairingStorage, sessionStore: WCSessionStorage, verifyClient: VerifyClientProtocol, - rpcHistory: RPCHistory + rpcHistory: RPCHistory, + authRequestSubscribersTracking: AuthRequestSubscribersTracking ) { self.networkingInteractor = networkingInteractor self.proposalPayloadsStore = proposalPayloadsStore @@ -58,6 +60,7 @@ final class ApproveEngine { self.sessionStore = sessionStore self.verifyClient = verifyClient self.rpcHistory = rpcHistory + self.authRequestSubscribersTracking = authRequestSubscribersTracking setupRequestSubscriptions() setupResponseSubscriptions() @@ -217,7 +220,7 @@ private extension ApproveEngine { guard let pairing = pairingStore.getPairing(forTopic: payload.topic) else { return } if let methods = pairing.methods, methods.flatMap({ $0 }) - .contains(SessionAuthenticatedProtocolMethod().method) { + .contains(SessionAuthenticatedProtocolMethod().method), authRequestSubscribersTracking.hasSubscribers() { logger.debug("Ignoring Session Proposal") // respond with an error? return diff --git a/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift b/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift new file mode 100644 index 000000000..338dc6c4f --- /dev/null +++ b/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift @@ -0,0 +1,29 @@ +import Foundation + +class AuthRequestSubscribersTracking { + private var subscribersCount: Int = 0 + private let serialQueue = DispatchQueue(label: "com.walletconnect.AuthRequestSubscribersTrackingQueue") + private let logger: ConsoleLogging + + init(logger: ConsoleLogging) { + self.logger = logger + } + + func increment() { + serialQueue.sync { + subscribersCount += 1 + logger.debug("Incremented subscriber count: \(subscribersCount)") + } + } + + func decrement() { + serialQueue.sync { + subscribersCount = max(0, subscribersCount - 1) + logger.debug("Decremented subscriber count: \(subscribersCount)") + } + } + + func hasSubscribers() -> Bool { + return serialQueue.sync { subscribersCount > 0 } + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index b0fe8caf7..116a9d11c 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -101,7 +101,13 @@ public final class SignClient: SignClientProtocol { /// /// Wallet should subscribe on events in order to receive auth requests. public var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { - authRequestPublisherSubject.eraseToAnyPublisher() + return authRequestPublisherSubject + .handleEvents(receiveSubscription: { [unowned self] _ in + authRequestSubscribersTracking.increment() + }, receiveCancel: { [unowned self] in + authRequestSubscribersTracking.decrement() + }) + .eraseToAnyPublisher() } /// Publisher that sends authentication responses @@ -175,6 +181,7 @@ public final class SignClient: SignClientProtocol { private let pingResponsePublisherSubject = PassthroughSubject() private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() + private let authRequestSubscribersTracking: AuthRequestSubscribersTracking private var publishers = Set() @@ -204,7 +211,8 @@ public final class SignClient: SignClientProtocol { proposalExpiryWatcher: ProposalExpiryWatcher, pendingProposalsProvider: PendingProposalsProvider, requestsExpiryWatcher: RequestsExpiryWatcher, - authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService + authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService, + authRequestSubscribersTracking: AuthRequestSubscribersTracking ) { self.logger = logger self.networkingClient = networkingClient @@ -231,6 +239,7 @@ public final class SignClient: SignClientProtocol { self.pendingProposalsProvider = pendingProposalsProvider self.requestsExpiryWatcher = requestsExpiryWatcher self.authResponseTopicResubscriptionService = authResponseTopicResubscriptionService + self.authRequestSubscribersTracking = authRequestSubscribersTracking setUpConnectionObserving() setUpEnginesCallbacks() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index e07c86816..bfbdcc6b9 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -68,6 +68,7 @@ public struct SignClientFactory { let sessionExtendRequestSubscriber = SessionExtendRequestSubscriber(networkingInteractor: networkingClient, sessionStore: sessionStore, logger: logger) let sessionExtendResponseSubscriber = SessionExtendResponseSubscriber(networkingInteractor: networkingClient, sessionStore: sessionStore, logger: logger) let sessionTopicToProposal = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: SignStorageIdentifiers.sessionTopicToProposal.rawValue) + let authRequestSubscribersTracking = AuthRequestSubscribersTracking(logger: logger) let approveEngine = ApproveEngine( networkingInteractor: networkingClient, proposalPayloadsStore: proposalPayloadsStore, @@ -80,7 +81,8 @@ public struct SignClientFactory { pairingStore: pairingStore, sessionStore: sessionStore, verifyClient: verifyClient, - rpcHistory: rpcHistory + rpcHistory: rpcHistory, + authRequestSubscribersTracking: authRequestSubscribersTracking ) let cleanupService = SignCleanupService(pairingStore: pairingStore, sessionStore: sessionStore, kms: kms, sessionTopicToProposal: sessionTopicToProposal, networkInteractor: networkingClient, rpcHistory: rpcHistory) let deleteSessionService = DeleteSessionService(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) @@ -135,7 +137,8 @@ public struct SignClientFactory { proposalExpiryWatcher: proposalExpiryWatcher, pendingProposalsProvider: pendingProposalsProvider, requestsExpiryWatcher: requestsExpiryWatcher, - authResponseTopicResubscriptionService: authResponseTopicResubscriptionService + authResponseTopicResubscriptionService: authResponseTopicResubscriptionService, + authRequestSubscribersTracking: authRequestSubscribersTracking ) return client } From 2bf8e6195a9add272c14bc148f7f424032a146a9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 15 Mar 2024 09:54:06 +0100 Subject: [PATCH 469/814] savepoint --- .../IntegrationTests/Sign/SignClientTests.swift | 14 +++++++------- .../Common/AuthRequestSubscribersTracking.swift | 1 + Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- .../Sign/SignClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 5 files changed, 11 insertions(+), 10 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 82dac015b..e67e77973 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -776,7 +776,7 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticated() async throws { let responseExpectation = expectation(description: "successful response delivered") - wallet.authRequestPublisher.sink { [unowned self] (request, _) in + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() @@ -811,7 +811,7 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticateEmptyMethods() async throws { let responseExpectation = expectation(description: "successful response delivered") - wallet.authRequestPublisher.sink { [unowned self] (request, _) in + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() @@ -846,7 +846,7 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticatedMultiCacao() async throws { let responseExpectation = expectation(description: "successful response delivered") - wallet.authRequestPublisher.sink { [unowned self] (request, _) in + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() @@ -911,7 +911,7 @@ final class SignClientTests: XCTestCase { try await walletPairingClient.pair(uri: uri) - wallet.authRequestPublisher.sink { [unowned self] (request, _) in + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signature = CacaoSignature(t: .eip1271, s: eip1271Signature) let cacao = try! wallet.buildSignedAuthObject(authPayload: request.payload, signature: signature, account: account) @@ -932,7 +932,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dapp.authenticate(AuthRequestParams.stub()) try? await walletPairingClient.pair(uri: uri) - wallet.authRequestPublisher.sink { [unowned self] (request, _) in + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let invalidSignature = CacaoSignature(t: .eip1271, s: eip1271Signature) @@ -954,7 +954,7 @@ final class SignClientTests: XCTestCase { let uri = try! await dapp.authenticate(AuthRequestParams.stub()) try? await walletPairingClient.pair(uri: uri) - wallet.authRequestPublisher.sink { [unowned self] request in + wallet.authenticateRequestPublisher.sink { [unowned self] request in Task(priority: .high) { try! await wallet.rejectSession(requestId: request.0.id) } @@ -979,7 +979,7 @@ final class SignClientTests: XCTestCase { let chain = Blockchain("eip155:1")! // sleep is needed as emitRequestIfPending() will be called on client init and then on request itself, second request would be debouced sleep(1) - wallet.authRequestPublisher.sink { [unowned self] (request, _) in + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() diff --git a/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift b/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift index 338dc6c4f..650029c7c 100644 --- a/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift +++ b/Sources/WalletConnectSign/Engine/Common/AuthRequestSubscribersTracking.swift @@ -1,5 +1,6 @@ import Foundation +// purpose of this class is to allow fallback to session propose in case wallet did not subscribe to authenticateRequestPublisher and dapp request wc_sessionAuthenticate class AuthRequestSubscribersTracking { private var subscribersCount: Int = 0 private let serialQueue = DispatchQueue(label: "com.walletconnect.AuthRequestSubscribersTrackingQueue") diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 116a9d11c..64ed1a1f7 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -100,7 +100,7 @@ public final class SignClient: SignClientProtocol { /// Publisher that sends authentication requests /// /// Wallet should subscribe on events in order to receive auth requests. - public var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { + public var authenticateRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { return authRequestPublisherSubject .handleEvents(receiveSubscription: { [unowned self] _ in authRequestSubscribersTracking.increment() diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 9073fe4e6..1947e298c 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -12,7 +12,7 @@ public protocol SignClientProtocol { var sessionResponsePublisher: AnyPublisher { get } var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { get } var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> { get } - var authRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { get } + var authenticateRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { get } var logsPublisher: AnyPublisher {get} var sessionProposalExpirationPublisher: AnyPublisher { get } var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { get } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 8853f8cde..bde5bc345 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -27,7 +27,7 @@ public class Web3WalletClient { /// /// Wallet should subscribe on events in order to receive auth requests. public var authenticateRequestPublisher: AnyPublisher<(request: AuthenticationRequest, context: VerifyContext?), Never> { - signClient.authRequestPublisher.eraseToAnyPublisher() + signClient.authenticateRequestPublisher.eraseToAnyPublisher() } /// Publisher that sends sessions on every sessions update From 9a2b9eb4b2939eef18d0969d9f978da8a211a322 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 15 Mar 2024 12:21:09 +0100 Subject: [PATCH 470/814] fix tests --- Tests/WalletConnectSignTests/AppProposalServiceTests.swift | 3 ++- Tests/WalletConnectSignTests/ApproveEngineTests.swift | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index 71b50a9ca..18a392325 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -77,7 +77,8 @@ final class AppProposalServiceTests: XCTestCase { pairingStore: storageMock, sessionStore: WCSessionStorageMock(), verifyClient: VerifyClientMock(), - rpcHistory: history + rpcHistory: history, + authRequestSubscribersTracking: AuthRequestSubscribersTracking(logger: logger) ) } diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index 63bf4ce0d..585f7e4be 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -51,7 +51,8 @@ final class ApproveEngineTests: XCTestCase { pairingStore: pairingStorageMock, sessionStore: sessionStorageMock, verifyClient: VerifyClientMock(), - rpcHistory: history + rpcHistory: history, + authRequestSubscribersTracking: AuthRequestSubscribersTracking(logger: ConsoleLoggerMock()) ) } From 2f8e32d4570abf6a0681d5d34d52271f57d6d4d4 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Fri, 15 Mar 2024 12:23:03 +0000 Subject: [PATCH 471/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 25d66792e..77e713b60 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.15.0"} +{"version": "1.16.0"} From 33af170a11954b846ab2490eca9eff4c0230c8fd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 15 Mar 2024 14:48:36 +0100 Subject: [PATCH 472/814] savepoint --- .../Services/ProposalNamespaceBuilder.swift | 2 +- .../Auth/Services/SignRecap.swift | 4 +- Sources/WalletConnectSign/Namespace.swift | 63 ++++++++++++++----- .../SessionNamespaceBuilderTests.swift | 4 +- 4 files changed, 53 insertions(+), 20 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift index 3c4ca0861..5a3faa1fc 100644 --- a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift @@ -13,7 +13,7 @@ struct ProposalNamespaceBuilder { if methods.isEmpty { methods = ["personal_sign"] } - let chains: Set = Set(params.chains.compactMap { Blockchain($0) }) + let chains: [Blockchain] = params.chains.compactMap { Blockchain($0) } guard chains.allSatisfy({$0.namespace == "eip155"}) else { throw Errors.unsupportedChain } diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift index bcda4fdba..8c0b53b9c 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecap.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecap.swift @@ -40,7 +40,7 @@ struct SignRecap { .filter { $0.hasPrefix("request/") } .map { String($0.dropFirst("request/".count)) }) } - var chains: Set { + var chains: [Blockchain] { guard let eip155Actions = recapData.att?["eip155"] else { return [] } // Attempt to find and decode the first action's chain array from AnyCodable @@ -49,7 +49,7 @@ struct SignRecap { let firstActionValue = firstActionValues.first, let dict = try? firstActionValue.get([String:[String]].self), let chainsArray = dict["chains"]{ - return Set(chainsArray.compactMap(Blockchain.init)) + return chainsArray.compactMap(Blockchain.init) } return [] diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index af84a5fb4..8349f46b9 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -24,12 +24,11 @@ public enum AutoNamespacesError: Error, LocalizedError { } public struct ProposalNamespace: Equatable, Codable { - - public let chains: Set? + public let chains: [Blockchain]? public let methods: Set public let events: Set - public init(chains: Set? = nil, methods: Set, events: Set) { + public init(chains: [Blockchain]? = nil, methods: Set, events: Set) { self.chains = chains self.methods = methods self.events = events @@ -37,19 +36,19 @@ public struct ProposalNamespace: Equatable, Codable { } public struct SessionNamespace: Equatable, Codable { - public var chains: Set? + public var chains: [Blockchain]? public var accounts: Set public var methods: Set public var events: Set - public init(chains: Set? = nil, accounts: Set, methods: Set, events: Set) { + public init(chains: [Blockchain]? = nil, accounts: Set, methods: Set, events: Set) { self.chains = chains self.accounts = accounts self.methods = methods self.events = events } - static func accountsAreCompliant(_ accounts: Set, toChains chains: Set) -> Bool { + static func accountsAreCompliant(_ accounts: Set, toChains chains: [Blockchain]) -> Bool { for chain in chains { guard accounts.contains(where: { $0.blockchain == chain }) else { return false @@ -59,6 +58,7 @@ public struct SessionNamespace: Equatable, Codable { } } + enum Namespace { static func validate(_ namespaces: [String: ProposalNamespace]) throws { @@ -116,7 +116,7 @@ enum Namespace { if requiredNamespaces[network] == nil { requiredNamespaces[network] = proposalNamespace } else { - let unionChains = requiredNamespaces[network]?.chains!.union(proposalNamespace.chains ?? []) + let unionChains = requiredNamespaces[network]?.chains!.orderedUnion(proposalNamespace.chains ?? []) let unionMethods = requiredNamespaces[network]?.methods.union(proposalNamespace.methods) let unionEvents = requiredNamespaces[network]?.events.union(proposalNamespace.events) @@ -197,7 +197,7 @@ public enum AutoNamespaces { } let availableAccountsBlockchains = accounts.map { $0.blockchain } - guard !sessionChains.intersection(Set(availableAccountsBlockchains)).isEmpty else { + guard !sessionChains.intersection(availableAccountsBlockchains).isEmpty else { throw AutoNamespacesError.requiredAccountsNotSatisfied } @@ -211,7 +211,7 @@ public enum AutoNamespaces { if sessionNamespaces[caip2Namespace] == nil { sessionNamespaces[caip2Namespace] = sessionNamespace } else { - let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).union(sessionNamespace.chains ?? []) + let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[caip2Namespace]?.chains = unionChains let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.union(sessionNamespace.accounts) sessionNamespaces[caip2Namespace]?.accounts = unionAccounts ?? [] @@ -245,7 +245,7 @@ public enum AutoNamespaces { } let sessionNamespace = SessionNamespace( - chains: Set([Blockchain(namespace: network, reference: chain)!]), + chains: [Blockchain(namespace: network, reference: chain)!], accounts: Set(accounts).filter { $0.blockchain == Blockchain(namespace: network, reference: chain)! }, methods: sessionMethods, events: sessionEvents @@ -254,7 +254,7 @@ public enum AutoNamespaces { if sessionNamespaces[network] == nil { sessionNamespaces[network] = sessionNamespace } else { - let unionChains = (sessionNamespaces[network]?.chains ?? []).union(sessionNamespace.chains ?? []) + let unionChains = (sessionNamespaces[network]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[network]?.chains = unionChains let unionAccounts = sessionNamespaces[network]?.accounts.union(sessionNamespace.accounts) sessionNamespaces[network]?.accounts = unionAccounts ?? [] @@ -272,7 +272,7 @@ public enum AutoNamespaces { let proposalNamespace = $0.value if let proposalChains = proposalNamespace.chains { - let sessionChains = Set(proposalChains).intersection(Set(chains)) + let sessionChains = proposalChains.intersection(chains) guard !sessionChains.isEmpty else { return } @@ -294,7 +294,7 @@ public enum AutoNamespaces { if sessionNamespaces[caip2Namespace] == nil { sessionNamespaces[caip2Namespace] = sessionNamespace } else { - let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).union(sessionNamespace.chains ?? []) + let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[caip2Namespace]?.chains = unionChains let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.union(sessionNamespace.accounts) sessionNamespaces[caip2Namespace]?.accounts = unionAccounts ?? [] @@ -320,7 +320,7 @@ public enum AutoNamespaces { let sessionEvents = Set(proposalNamespace.events).intersection(Set(events)) let sessionNamespace = SessionNamespace( - chains: Set([Blockchain(namespace: network, reference: chain)!]), + chains: [Blockchain(namespace: network, reference: chain)!], accounts: Set(accounts).filter { $0.blockchain == Blockchain(namespace: network, reference: chain)! }, methods: sessionMethods, events: sessionEvents @@ -329,7 +329,7 @@ public enum AutoNamespaces { if sessionNamespaces[network] == nil { sessionNamespaces[network] = sessionNamespace } else { - let unionChains = (sessionNamespaces[network]?.chains ?? []).union(sessionNamespace.chains ?? []) + let unionChains = (sessionNamespaces[network]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[network]?.chains = unionChains let unionAccounts = sessionNamespaces[network]?.accounts.union(sessionNamespace.accounts) sessionNamespaces[network]?.accounts = unionAccounts ?? [] @@ -346,3 +346,36 @@ public enum AutoNamespaces { return sessionNamespaces } } + + +extension Array where Element: Hashable { + + // Checks if the current array is a subset of the provided array. + func isSubset(of other: [Element]) -> Bool { + let otherSet = Set(other) + for element in self { + if !otherSet.contains(element) { + return false + } + } + return true + } + + // Returns the intersection of the current array and the provided array. + // Elements are returned in the order they appear in the current array. + func intersection(_ other: [Element]) -> [Element] { + let otherSet = Set(other) + return self.filter { otherSet.contains($0) } + } + + // Returns the ordered union of the current array and the provided array. + // Elements from the current array are prioritized, and the order is preserved. + func orderedUnion(_ other: [Element]) -> [Element] { + var combined = self + let selfSet = Set(self) + for element in other where !selfSet.contains(element) { + combined.append(element) + } + return combined + } +} diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index 2fcde6eb5..116af8abe 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -40,7 +40,7 @@ class SessionNamespaceBuilderTests: XCTestCase { func testBuildSessionNamespaces_ValidCacaos_ReturnsExpectedNamespace() { let expectedSessionNamespace = SessionNamespace( - chains: Set([Blockchain("eip155:1")!, Blockchain("eip155:137")!]), + chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], accounts: Set([ Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! @@ -67,7 +67,7 @@ class SessionNamespaceBuilderTests: XCTestCase { func testMutlipleRecapsInCacaoWhereOnlyOneIsSessionRecap() { let expectedSessionNamespace = SessionNamespace( - chains: Set([Blockchain("eip155:1")!, Blockchain("eip155:137")!]), + chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], accounts: Set([ Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! ]), From 1fce1cf56e6c731239cc623541ec9900f0d7ec19 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 10:01:51 +0100 Subject: [PATCH 473/814] savepoint --- Sources/WalletConnectSign/Namespace.swift | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 8349f46b9..ade22b0ac 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -224,7 +224,7 @@ public enum AutoNamespaces { if let network = $0.key.components(separatedBy: ":").first, let chain = $0.key.components(separatedBy: ":").last { - let sessionChains = Set([Blockchain(namespace: network, reference: chain)]).intersection(Set(chains)) + let sessionChains = [Blockchain(namespace: network, reference: chain)].intersection(chains) guard !sessionChains.isEmpty else { throw AutoNamespacesError.requiredChainsNotSatisfied } @@ -240,7 +240,7 @@ public enum AutoNamespaces { } let availableAccountsBlockchains = accounts.map { $0.blockchain } - guard !sessionChains.intersection(Set(availableAccountsBlockchains)).isEmpty else { + guard !sessionChains.intersection(availableAccountsBlockchains).isEmpty else { throw AutoNamespacesError.requiredAccountsNotSatisfied } @@ -273,6 +273,8 @@ public enum AutoNamespaces { if let proposalChains = proposalNamespace.chains { let sessionChains = proposalChains.intersection(chains) + print("session chains: \(sessionChains)") + print("proposal chains: \(proposalChains)") guard !sessionChains.isEmpty else { return } @@ -295,6 +297,9 @@ public enum AutoNamespaces { sessionNamespaces[caip2Namespace] = sessionNamespace } else { let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) + print("caip2namespace chains: \(sessionNamespaces[caip2Namespace]?.chains)") + print("sessionNamespace.chains \(sessionNamespace.chains)") + print("union chains: \(unionChains)") sessionNamespaces[caip2Namespace]?.chains = unionChains let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.union(sessionNamespace.accounts) sessionNamespaces[caip2Namespace]?.accounts = unionAccounts ?? [] @@ -307,11 +312,13 @@ public enum AutoNamespaces { if let network = $0.key.components(separatedBy: ":").first, let chain = $0.key.components(separatedBy: ":").last { - let sessionChains = Set([Blockchain(namespace: network, reference: chain)]).intersection(Set(chains)) + let sessionChains = [Blockchain(namespace: network, reference: chain)].intersection(chains) guard !sessionChains.isEmpty else { return } - + + print("session chains: \(sessionChains)") + let sessionMethods = Set(proposalNamespace.methods).intersection(Set(methods)) guard !sessionMethods.isEmpty else { return From 2629394ee23fe75d3bfddb56243ec5ebe8fa3f84 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 11:00:09 +0100 Subject: [PATCH 474/814] fix tests --- .../SessionProposalInteractor.swift | 4 +- .../SessionProposal/SessionProposalView.swift | 2 +- Sources/WalletConnectSign/Namespace.swift | 2 +- .../AutoNamespacesValidationTests.swift | 66 ++++++------------- 4 files changed, 23 insertions(+), 51 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift index 7c6fe2cc0..ceeef4bc2 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalInteractor.swift @@ -9,9 +9,9 @@ final class SessionProposalInteractor { let supportedMethods = Set(proposal.requiredNamespaces.flatMap { $0.value.methods } + (proposal.optionalNamespaces?.flatMap { $0.value.methods } ?? [])) let supportedEvents = Set(proposal.requiredNamespaces.flatMap { $0.value.events } + (proposal.optionalNamespaces?.flatMap { $0.value.events } ?? [])) - let supportedRequiredChains = proposal.requiredNamespaces["eip155"]?.chains + let supportedRequiredChains = proposal.requiredNamespaces["eip155"]?.chains ?? [] let supportedOptionalChains = proposal.optionalNamespaces?["eip155"]?.chains ?? [] - var supportedChains = (supportedRequiredChains ?? []).union(supportedOptionalChains) + var supportedChains = supportedRequiredChains + supportedOptionalChains let supportedAccounts = Array(supportedChains).map { Account(blockchain: $0, address: account.address)! } diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift index 02f4b0401..62dec77ae 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionProposal/SessionProposalView.swift @@ -168,7 +168,7 @@ struct SessionProposalView: View { private func sessionProposalView(namespaces: ProposalNamespace) -> some View { VStack { VStack(alignment: .leading) { - TagsView(items: Array(namespaces.chains ?? Set())) { + TagsView(items: Array(namespaces.chains ?? [])) { Text($0.absoluteString.uppercased()) .font(.system(size: 15, weight: .semibold, design: .rounded)) .foregroundColor(.whiteBackground) diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index ade22b0ac..7e439a03d 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -250,7 +250,7 @@ public enum AutoNamespaces { methods: sessionMethods, events: sessionEvents ) - + print("$0 \($0)") if sessionNamespaces[network] == nil { sessionNamespaces[network] = sessionNamespace } else { diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index f0c0a9fc3..618580e58 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -122,12 +122,10 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:2")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")!, Account(blockchain: Blockchain("eip155:3")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] + let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -167,22 +165,15 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:4")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) ] let optionalNamespaces = [ "eip155": ProposalNamespace( - chains: [Blockchain("eip155:3")!], - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:4": ProposalNamespace( + chains: [Blockchain("eip155:3")!, Blockchain("eip155:4")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -213,11 +204,8 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:2")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -260,11 +248,8 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:4")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -306,11 +291,8 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:2")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -348,11 +330,8 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:2")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -391,11 +370,8 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:4")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -652,14 +628,10 @@ final class AutoNamespacesValidationTests: XCTestCase { Account(blockchain: Blockchain("eip155:2")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! ] let requiredNamespaces = [ - "eip155:1": ProposalNamespace( - methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ), - "eip155:2": ProposalNamespace( + "eip155": ProposalNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], methods: ["personal_sign", "eth_sendTransaction"], - events: ["chainChanged"] - ) + events: ["chainChanged", "accountsChanged"]) ] let optionalNamespaces = [ "eip155": ProposalNamespace( From 591b5d0dbabbde7c875ba21be91d2c5e3c736189 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 11:09:29 +0100 Subject: [PATCH 475/814] accounts as array --- .../Services/SessionNamespaceBuilder.swift | 2 +- Sources/WalletConnectSign/Namespace.swift | 20 ++++----- .../AutoNamespacesValidationTests.swift | 44 +++++++++---------- .../SessionNamespaceBuilderTests.swift | 8 ++-- 4 files changed, 37 insertions(+), 37 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 967715cbb..ddb897788 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -34,7 +34,7 @@ class SessionNamespaceBuilder { } let accounts = cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account } - let accountsSet = Set(accounts) + let accountsSet = accounts let methods = firstRecapResource.methods let chains = firstRecapResource.chains let events: Set = ["chainChanged", "accountsChanged"] diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 7e439a03d..9b115d436 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -37,18 +37,18 @@ public struct ProposalNamespace: Equatable, Codable { public struct SessionNamespace: Equatable, Codable { public var chains: [Blockchain]? - public var accounts: Set + public var accounts: [Account] public var methods: Set public var events: Set - public init(chains: [Blockchain]? = nil, accounts: Set, methods: Set, events: Set) { + public init(chains: [Blockchain]? = nil, accounts: [Account], methods: Set, events: Set) { self.chains = chains self.accounts = accounts self.methods = methods self.events = events } - static func accountsAreCompliant(_ accounts: Set, toChains chains: [Blockchain]) -> Bool { + static func accountsAreCompliant(_ accounts: [Account], toChains chains: [Blockchain]) -> Bool { for chain in chains { guard accounts.contains(where: { $0.blockchain == chain }) else { return false @@ -203,7 +203,7 @@ public enum AutoNamespaces { let sessionNamespace = SessionNamespace( chains: sessionChains, - accounts: Set(accounts).filter { sessionChains.contains($0.blockchain) }, + accounts: accounts.filter { sessionChains.contains($0.blockchain) }, methods: sessionMethods, events: sessionEvents ) @@ -213,7 +213,7 @@ public enum AutoNamespaces { } else { let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[caip2Namespace]?.chains = unionChains - let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.union(sessionNamespace.accounts) + let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.orderedUnion(sessionNamespace.accounts) sessionNamespaces[caip2Namespace]?.accounts = unionAccounts ?? [] let unionMethods = sessionNamespaces[caip2Namespace]?.methods.union(sessionNamespace.methods) sessionNamespaces[caip2Namespace]?.methods = unionMethods ?? [] @@ -256,7 +256,7 @@ public enum AutoNamespaces { } else { let unionChains = (sessionNamespaces[network]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[network]?.chains = unionChains - let unionAccounts = sessionNamespaces[network]?.accounts.union(sessionNamespace.accounts) + let unionAccounts = sessionNamespaces[network]?.accounts.orderedUnion(sessionNamespace.accounts) sessionNamespaces[network]?.accounts = unionAccounts ?? [] let unionMethods = sessionNamespaces[network]?.methods.union(sessionNamespace.methods) sessionNamespaces[network]?.methods = unionMethods ?? [] @@ -288,7 +288,7 @@ public enum AutoNamespaces { let sessionNamespace = SessionNamespace( chains: sessionChains, - accounts: Set(accounts).filter { sessionChains.contains($0.blockchain) }, + accounts: accounts.filter { sessionChains.contains($0.blockchain) }, methods: sessionMethods, events: sessionEvents ) @@ -301,7 +301,7 @@ public enum AutoNamespaces { print("sessionNamespace.chains \(sessionNamespace.chains)") print("union chains: \(unionChains)") sessionNamespaces[caip2Namespace]?.chains = unionChains - let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.union(sessionNamespace.accounts) + let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.orderedUnion(sessionNamespace.accounts) sessionNamespaces[caip2Namespace]?.accounts = unionAccounts ?? [] let unionMethods = sessionNamespaces[caip2Namespace]?.methods.union(sessionNamespace.methods) sessionNamespaces[caip2Namespace]?.methods = unionMethods ?? [] @@ -328,7 +328,7 @@ public enum AutoNamespaces { let sessionNamespace = SessionNamespace( chains: [Blockchain(namespace: network, reference: chain)!], - accounts: Set(accounts).filter { $0.blockchain == Blockchain(namespace: network, reference: chain)! }, + accounts: accounts.filter { $0.blockchain == Blockchain(namespace: network, reference: chain)! }, methods: sessionMethods, events: sessionEvents ) @@ -338,7 +338,7 @@ public enum AutoNamespaces { } else { let unionChains = (sessionNamespaces[network]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) sessionNamespaces[network]?.chains = unionChains - let unionAccounts = sessionNamespaces[network]?.accounts.union(sessionNamespace.accounts) + let unionAccounts = sessionNamespaces[network]?.accounts.orderedUnion(sessionNamespace.accounts) sessionNamespaces[network]?.accounts = unionAccounts ?? [] let unionMethods = sessionNamespaces[network]?.methods.union(sessionNamespace.methods) sessionNamespaces[network]?.methods = unionMethods ?? [] diff --git a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift index 618580e58..d9b0f4acd 100644 --- a/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift +++ b/Tests/WalletConnectSignTests/AutoNamespacesValidationTests.swift @@ -30,7 +30,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -70,7 +70,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -108,7 +108,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -149,7 +149,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -190,7 +190,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:3")!, Blockchain("eip155:4")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -233,7 +233,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -277,7 +277,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!, Blockchain("eip155:4")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction"], events: ["chainChanged"] ) @@ -316,7 +316,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction", "eth_signTransaction"], events: ["chainChanged"] ) @@ -355,7 +355,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction", "eth_signTransaction"], events: ["chainChanged", "accountsChanged"] ) @@ -443,10 +443,10 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:2")!], - accounts: Set([ + accounts: [ Account(blockchain: Blockchain("eip155:1")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")!, Account(blockchain: Blockchain("eip155:2")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! - ]), + ], methods: ["personal_sign", "eth_sendTransaction", "eth_signTransaction"], events: ["chainChanged", "accountsChanged"] ), @@ -682,9 +682,9 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!], - accounts: Set([ + accounts: [ Account(blockchain: Blockchain("eip155:1")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! - ]), + ], methods: ["eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "personal_sign", "eth_sendTransaction"], events: ["chainChanged", "accountsChanged"] ) @@ -722,9 +722,9 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!], - accounts: Set([ + accounts: [ Account(blockchain: Blockchain("eip155:1")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! - ]), + ], methods: ["eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "personal_sign", "eth_sendTransaction"], events: ["chainChanged", "accountsChanged"] ) @@ -762,9 +762,9 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!], - accounts: Set([ + accounts: [ Account(blockchain: Blockchain("eip155:1")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! - ]), + ], methods: ["eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "personal_sign", "eth_sendTransaction"], events: [] ) @@ -807,17 +807,17 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!], - accounts: Set([ + accounts: [ Account(blockchain: Blockchain("eip155:1")!, address: "0x57f48fAFeC1d76B27e3f29b8d277b6218CDE6092")! - ]), + ], methods: ["eth_signTypedData_v4", "eth_signTransaction", "eth_signTypedData", "eth_sign", "personal_sign", "eth_sendTransaction"], events: ["chainChanged", "accountsChanged"] ), "solana": SessionNamespace( chains: [Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!], - accounts: Set([ + accounts: [ Account(blockchain: Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, address: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")!, - ]), + ], methods: ["solana_signMessage"], events: [] ) @@ -928,7 +928,7 @@ final class AutoNamespacesValidationTests: XCTestCase { let expectedNamespaces: [String: SessionNamespace] = [ "eip155": SessionNamespace( chains: [Blockchain("eip155:1")!], - accounts: Set(accounts), + accounts: accounts, methods: ["personal_sign", "eth_sendTransaction", "eth_sign"], events: ["chainChanged", "accountsChanged"] ) diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index 116af8abe..21928efc4 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -41,10 +41,10 @@ class SessionNamespaceBuilderTests: XCTestCase { func testBuildSessionNamespaces_ValidCacaos_ReturnsExpectedNamespace() { let expectedSessionNamespace = SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], - accounts: Set([ + accounts: [ Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! - ]), + ], methods: Set(["personal_sign", "eth_signTypedData", "eth_sign"]), events: Set(["chainChanged", "accountsChanged"]) ) @@ -68,9 +68,9 @@ class SessionNamespaceBuilderTests: XCTestCase { func testMutlipleRecapsInCacaoWhereOnlyOneIsSessionRecap() { let expectedSessionNamespace = SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], - accounts: Set([ + accounts: [ Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! - ]), + ], methods: ["personal_sign", "eth_signTypedData", "eth_sign"], events: ["chainChanged", "accountsChanged"] ) From 6e40168444de8ba0e42123bd8f0cc6cc07d9a205 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 11:17:08 +0100 Subject: [PATCH 476/814] savepoint --- Sources/WalletConnectSign/Namespace.swift | 24 ++--------------------- 1 file changed, 2 insertions(+), 22 deletions(-) diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index 9b115d436..e9889b2dd 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -182,7 +182,7 @@ public enum AutoNamespaces { if let proposalChains = proposalNamespace.chains { let sessionChains = proposalChains - guard !sessionChains.isEmpty && proposalChains.isSubset(of: chains) else { + guard !sessionChains.isEmpty && Set(proposalChains).isSubset(of: chains) else { throw AutoNamespacesError.requiredChainsNotSatisfied } @@ -250,7 +250,6 @@ public enum AutoNamespaces { methods: sessionMethods, events: sessionEvents ) - print("$0 \($0)") if sessionNamespaces[network] == nil { sessionNamespaces[network] = sessionNamespace } else { @@ -273,8 +272,6 @@ public enum AutoNamespaces { if let proposalChains = proposalNamespace.chains { let sessionChains = proposalChains.intersection(chains) - print("session chains: \(sessionChains)") - print("proposal chains: \(proposalChains)") guard !sessionChains.isEmpty else { return } @@ -297,9 +294,6 @@ public enum AutoNamespaces { sessionNamespaces[caip2Namespace] = sessionNamespace } else { let unionChains = (sessionNamespaces[caip2Namespace]?.chains ?? []).orderedUnion(sessionNamespace.chains ?? []) - print("caip2namespace chains: \(sessionNamespaces[caip2Namespace]?.chains)") - print("sessionNamespace.chains \(sessionNamespace.chains)") - print("union chains: \(unionChains)") sessionNamespaces[caip2Namespace]?.chains = unionChains let unionAccounts = sessionNamespaces[caip2Namespace]?.accounts.orderedUnion(sessionNamespace.accounts) sessionNamespaces[caip2Namespace]?.accounts = unionAccounts ?? [] @@ -317,8 +311,6 @@ public enum AutoNamespaces { return } - print("session chains: \(sessionChains)") - let sessionMethods = Set(proposalNamespace.methods).intersection(Set(methods)) guard !sessionMethods.isEmpty else { return @@ -355,19 +347,7 @@ public enum AutoNamespaces { } -extension Array where Element: Hashable { - - // Checks if the current array is a subset of the provided array. - func isSubset(of other: [Element]) -> Bool { - let otherSet = Set(other) - for element in self { - if !otherSet.contains(element) { - return false - } - } - return true - } - +fileprivate extension Array where Element: Hashable { // Returns the intersection of the current array and the provided array. // Elements are returned in the order they appear in the current array. func intersection(_ other: [Element]) -> [Element] { From 31333adc9a5f5eca61a2eb16b98072009c15502b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 11:33:56 +0100 Subject: [PATCH 477/814] rename auth errors --- Sources/Auth/AuthClient.swift | 4 ++-- Sources/Auth/Services/App/AppRespondSubscriber.swift | 4 ++-- Sources/Auth/Services/Wallet/WalletErrorResponder.swift | 2 +- Sources/Auth/Services/Wallet/WalletRespondService.swift | 2 +- Sources/Auth/Types/Errors/AuthError.swift | 4 ++-- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Sources/Auth/AuthClient.swift b/Sources/Auth/AuthClient.swift index d1e34537d..8efd60dad 100644 --- a/Sources/Auth/AuthClient.swift +++ b/Sources/Auth/AuthClient.swift @@ -25,7 +25,7 @@ public class AuthClient: AuthClientProtocol { /// /// Emited result may be an error. @available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { authResponsePublisherSubject.eraseToAnyPublisher() } @@ -40,7 +40,7 @@ public class AuthClient: AuthClientProtocol { private let pairingRegisterer: PairingRegisterer - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() + private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthRequest, context: VerifyContext?), Never>() private let appRequestService: AppRequestService private let appRespondSubscriber: AppRespondSubscriber diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift index 25c7917e0..fe1d07287 100644 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/Auth/Services/App/AppRespondSubscriber.swift @@ -10,7 +10,7 @@ class AppRespondSubscriber { private let pairingRegisterer: PairingRegisterer private var publishers = [AnyCancellable]() - var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? + var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -30,7 +30,7 @@ class AppRespondSubscriber { private func subscribeForResponse() { networkingInteractor.responseErrorSubscription(on: AuthRequestProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in - guard let error = AuthError(code: payload.error.code) else { return } + guard let error = AuthErrors(code: payload.error.code) else { return } onResponse?(payload.id, .failure(error)) }.store(in: &publishers) diff --git a/Sources/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/Auth/Services/Wallet/WalletErrorResponder.swift index 597185480..f6047f016 100644 --- a/Sources/Auth/Services/Wallet/WalletErrorResponder.swift +++ b/Sources/Auth/Services/Wallet/WalletErrorResponder.swift @@ -21,7 +21,7 @@ actor WalletErrorResponder { self.rpcHistory = rpcHistory } - func respondError(_ error: AuthError, requestId: RPCID) async throws { + func respondError(_ error: AuthErrors, requestId: RPCID) async throws { let authRequestParams = try getAuthRequestParams(requestId: requestId) let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) diff --git a/Sources/Auth/Services/Wallet/WalletRespondService.swift b/Sources/Auth/Services/Wallet/WalletRespondService.swift index a06a16027..3735ce663 100644 --- a/Sources/Auth/Services/Wallet/WalletRespondService.swift +++ b/Sources/Auth/Services/Wallet/WalletRespondService.swift @@ -53,7 +53,7 @@ actor WalletRespondService { } func respondError(requestId: RPCID) async throws { - try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + try await walletErrorResponder.respondError(AuthErrors.userRejeted, requestId: requestId) verifyContextStore.delete(forKey: requestId.string) } diff --git a/Sources/Auth/Types/Errors/AuthError.swift b/Sources/Auth/Types/Errors/AuthError.swift index cf4accb16..9cfda6bd1 100644 --- a/Sources/Auth/Types/Errors/AuthError.swift +++ b/Sources/Auth/Types/Errors/AuthError.swift @@ -1,7 +1,7 @@ import Foundation /// Authentication error -public enum AuthError: Codable, Equatable, Error { +public enum AuthErrors: Codable, Equatable, Error { case methodUnsupported case userDisconnected case userRejeted @@ -11,7 +11,7 @@ public enum AuthError: Codable, Equatable, Error { case signatureVerificationFailed } -extension AuthError: Reason { +extension AuthErrors: Reason { init?(code: Int) { switch code { From e601c4c2bc47e02571e6900f1bfde2d42372ef42 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 13:23:25 +0100 Subject: [PATCH 478/814] savepoint --- Sources/WalletConnectModal/WalletConnectModal.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectModal/WalletConnectModal.swift b/Sources/WalletConnectModal/WalletConnectModal.swift index c74e5c884..3bdafbea8 100644 --- a/Sources/WalletConnectModal/WalletConnectModal.swift +++ b/Sources/WalletConnectModal/WalletConnectModal.swift @@ -153,7 +153,7 @@ public struct SessionParams { public static let `default`: Self = { let methods: Set = ["eth_sendTransaction", "personal_sign", "eth_signTypedData"] let events: Set = ["chainChanged", "accountsChanged"] - let blockchains: Set = [Blockchain("eip155:1")!] + let blockchains = [Blockchain("eip155:1")!] let namespaces: [String: ProposalNamespace] = [ "eip155": ProposalNamespace( chains: blockchains, From ee49c5b1cbc2b7626c23c6a34558c5fcd1bdd44c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 14:52:09 +0100 Subject: [PATCH 479/814] resolve w3m dependency issues --- Example/DApp/SceneDelegate.swift | 1 + Example/ExampleApp.xcodeproj/project.pbxproj | 66 +++++++++---------- .../xcshareddata/swiftpm/Package.resolved | 4 +- 3 files changed, 36 insertions(+), 35 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 9b23a6e93..c8abceae9 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -31,6 +31,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { Web3Modal.configure( projectId: InputConfig.projectId, metadata: metadata, + crypto: DefaultCryptoProvider(), customWallets: [ .init( id: "swift-sample", diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 9f5e8dba5..ec7366b09 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -8,9 +8,6 @@ /* Begin PBXBuildFile section */ 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 767DC83428997F8E00080FA9 /* EthSendTransaction.swift */; }; - 842B1D132B988BC5007F1EF8 /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D122B988BC5007F1EF8 /* Web3Modal */; }; - 842B1D152B988BC5007F1EF8 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D142B988BC5007F1EF8 /* Web3ModalUI */; }; - 842B1D172B988BF0007F1EF8 /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 842B1D162B988BF0007F1EF8 /* Web3ModalUI */; }; 84310D05298BC980000C15B6 /* MainInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84310D04298BC980000C15B6 /* MainInteractor.swift */; }; 8439CB89293F658E00F2F2E2 /* PushMessage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8439CB88293F658E00F2F2E2 /* PushMessage.swift */; }; 844749F629B9E5B9005F520B /* RelayClientEndToEndTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 844749F529B9E5B9005F520B /* RelayClientEndToEndTests.swift */; }; @@ -58,6 +55,9 @@ 84DB38F32983CDAE00BFEE37 /* PushRegisterer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */; }; 84E6B84A29787A8000428BAF /* NotificationService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84E6B84929787A8000428BAF /* NotificationService.swift */; }; 84E6B84E29787A8000428BAF /* PNDecryptionService.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 84E6B84729787A8000428BAF /* PNDecryptionService.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; }; + 84F391FA2BA87CEB00FDC20A /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 84F391F92BA87CEB00FDC20A /* Web3ModalUI */; }; + 84F3EFC52BA87C09005FCFAE /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 84F3EFC42BA87C09005FCFAE /* Web3Modal */; }; + 84F3EFC72BA87C09005FCFAE /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 84F3EFC62BA87C09005FCFAE /* Web3ModalUI */; }; 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84FE684528ACDB4700C893FF /* RequestParams.swift */; }; A507BE1A29E8032E0038EF70 /* EIP55Tests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A507BE1929E8032E0038EF70 /* EIP55Tests.swift */; }; A50B6A362B06683800162B01 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE25D293F56D6004840D1 /* InputConfig.swift */; }; @@ -692,13 +692,13 @@ buildActionMask = 2147483647; files = ( 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */, - 842B1D132B988BC5007F1EF8 /* Web3Modal in Frameworks */, + 84F3EFC52BA87C09005FCFAE /* Web3Modal in Frameworks */, C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */, A5B6C0F12A6EAB0800927332 /* WalletConnectNotify in Frameworks */, A54195A52934E83F0035AD19 /* Web3 in Frameworks */, 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */, A5D85228286333E300DAF5C3 /* Starscream in Frameworks */, - 842B1D152B988BC5007F1EF8 /* Web3ModalUI in Frameworks */, + 84F3EFC72BA87C09005FCFAE /* Web3ModalUI in Frameworks */, 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */, 84943C7B2A9BA206007EBAC2 /* Mixpanel in Frameworks */, A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */, @@ -764,7 +764,7 @@ 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */, C55D349929630D440004314A /* Web3Wallet in Frameworks */, C56EE255293F569A004840D1 /* Starscream in Frameworks */, - 842B1D172B988BF0007F1EF8 /* Web3ModalUI in Frameworks */, + 84F391FA2BA87CEB00FDC20A /* Web3ModalUI in Frameworks */, 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */, A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */, C54C24902AEB1B5600DA4BF6 /* WalletConnectRouter in Frameworks */, @@ -1937,8 +1937,8 @@ C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */, 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, - 842B1D122B988BC5007F1EF8 /* Web3Modal */, - 842B1D142B988BC5007F1EF8 /* Web3ModalUI */, + 84F3EFC42BA87C09005FCFAE /* Web3Modal */, + 84F3EFC62BA87C09005FCFAE /* Web3ModalUI */, ); productName = DApp; productReference = 84CE641C27981DED00142511 /* DApp.app */; @@ -2065,7 +2065,7 @@ A59D25ED2AB3672700D7EA3A /* AsyncButton */, C54C248F2AEB1B5600DA4BF6 /* WalletConnectRouter */, 84AEC2532B4D43CD00E27A5B /* SwiftMessages */, - 842B1D162B988BF0007F1EF8 /* Web3ModalUI */, + 84F391F92BA87CEB00FDC20A /* Web3ModalUI */, ); productName = ChatWallet; productReference = C56EE21B293F55ED004840D1 /* WalletApp.app */; @@ -2144,7 +2144,7 @@ 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */, 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */, 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */, - 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */, + 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */, ); productRefGroup = 764E1D3D26F8D3FC00A1FB15 /* Products */; projectDirPath = ""; @@ -3243,14 +3243,6 @@ /* End XCConfigurationList section */ /* Begin XCRemoteSwiftPackageReference section */ - 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { - isa = XCRemoteSwiftPackageReference; - repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; - requirement = { - kind = upToNextMajorVersion; - minimumVersion = 1.0.0; - }; - }; 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */ = { isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/getsentry/sentry-cocoa.git"; @@ -3275,6 +3267,14 @@ minimumVersion = 9.0.9; }; }; + 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { + isa = XCRemoteSwiftPackageReference; + repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; + requirement = { + kind = revision; + revision = c73ce390bc249af155b7320346b7045e53b89866; + }; + }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/flypaper0/solana-swift"; @@ -3318,21 +3318,6 @@ /* End XCRemoteSwiftPackageReference section */ /* Begin XCSwiftPackageProductDependency section */ - 842B1D122B988BC5007F1EF8 /* Web3Modal */ = { - isa = XCSwiftPackageProductDependency; - package = 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3Modal; - }; - 842B1D142B988BC5007F1EF8 /* Web3ModalUI */ = { - isa = XCSwiftPackageProductDependency; - package = 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3ModalUI; - }; - 842B1D162B988BF0007F1EF8 /* Web3ModalUI */ = { - isa = XCSwiftPackageProductDependency; - package = 842B1D112B987D40007F1EF8 /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3ModalUI; - }; 844749FC29B9E6B2005F520B /* WalletConnectNetworking */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectNetworking; @@ -3380,6 +3365,21 @@ package = 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */; productName = SwiftMessages; }; + 84F391F92BA87CEB00FDC20A /* Web3ModalUI */ = { + isa = XCSwiftPackageProductDependency; + package = 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3ModalUI; + }; + 84F3EFC42BA87C09005FCFAE /* Web3Modal */ = { + isa = XCSwiftPackageProductDependency; + package = 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3Modal; + }; + 84F3EFC62BA87C09005FCFAE /* Web3ModalUI */ = { + isa = XCSwiftPackageProductDependency; + package = 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */; + productName = Web3ModalUI; + }; A54195A42934E83F0035AD19 /* Web3 */ = { isa = XCSwiftPackageProductDependency; package = A5AE354528A1A2AC0059AE8A /* XCRemoteSwiftPackageReference "Web3" */; diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 9c85155e8..84752135e 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "4f2f4ca6497b7335a53c7b5c4fb3db554e0351ba", - "version": "1.3.0" + "revision": "c73ce390bc249af155b7320346b7045e53b89866", + "version": null } } ] From f5499fd02a4871fcd8a7e109cd626dd0524b9131 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 14:56:19 +0100 Subject: [PATCH 480/814] fix integration tests build --- Example/IntegrationTests/Stubs/Stubs.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/IntegrationTests/Stubs/Stubs.swift b/Example/IntegrationTests/Stubs/Stubs.swift index 7d8cb9172..ac61de16c 100644 --- a/Example/IntegrationTests/Stubs/Stubs.swift +++ b/Example/IntegrationTests/Stubs/Stubs.swift @@ -1,7 +1,7 @@ import WalletConnectSign extension ProposalNamespace { - static func stubRequired(chains: Set = [Blockchain("eip155:1")!]) -> [String: ProposalNamespace] { + static func stubRequired(chains: [Blockchain] = [Blockchain("eip155:1")!]) -> [String: ProposalNamespace] { return [ "eip155": ProposalNamespace( chains: chains, @@ -15,7 +15,7 @@ extension SessionNamespace { static func make(toRespond namespaces: [String: ProposalNamespace]) -> [String: SessionNamespace] { return namespaces.mapValues { proposalNamespace in SessionNamespace( - accounts: Set(proposalNamespace.chains!.map { Account(blockchain: $0, address: "0x00")! }), + accounts: proposalNamespace.chains!.map { Account(blockchain: $0, address: "0x00")! }, methods: proposalNamespace.methods, events: proposalNamespace.events ) From 83d967399fa65144e394b2d8100272403da76099 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 18 Mar 2024 15:48:39 +0100 Subject: [PATCH 481/814] remove duplicates --- Sources/WalletConnectSign/Namespace.swift | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Sources/WalletConnectSign/Namespace.swift b/Sources/WalletConnectSign/Namespace.swift index e9889b2dd..a20f02fae 100644 --- a/Sources/WalletConnectSign/Namespace.swift +++ b/Sources/WalletConnectSign/Namespace.swift @@ -175,6 +175,8 @@ public enum AutoNamespaces { ) throws -> [String: SessionNamespace] { var sessionNamespaces = [String: SessionNamespace]() + let chains = chains.removeDuplicates() + let accounts = accounts.removeDuplicates() try sessionProposal.requiredNamespaces.forEach { let caip2Namespace = $0.key let proposalNamespace = $0.value @@ -365,4 +367,19 @@ fileprivate extension Array where Element: Hashable { } return combined } + + func removeDuplicates() -> [Element] { + var uniqueElements = [Element]() + var seenElements = Set() + + for element in self { + if !seenElements.contains(element) { + uniqueElements.append(element) + seenElements.insert(element) + } + } + + return uniqueElements + } + } From 4bf498e9543028a0a9d6d7b958bb816d42f18de1 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Tue, 19 Mar 2024 06:40:19 +0000 Subject: [PATCH 482/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 77e713b60..8c3caff7b 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.16.0"} +{"version": "1.17.0"} From 73f2956ce152d2971c79c9fc26846b2477a2dea1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 19 Mar 2024 12:46:57 +0100 Subject: [PATCH 483/814] remoremove import --- Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift | 2 -- .../Auth/Services/ProposalNamespaceBuilder.swift | 1 - Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift | 1 - 3 files changed, 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift index 572eba175..ab3a54fb8 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift @@ -1,6 +1,4 @@ - import Foundation -import WalletConnectUtils struct CacaosBuilder { public static func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { diff --git a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift index 5a3faa1fc..b18f5c297 100644 --- a/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/ProposalNamespaceBuilder.swift @@ -1,4 +1,3 @@ -// import Foundation diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift index 6ce80bb80..fc008a98d 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift @@ -1,6 +1,5 @@ import Foundation - struct SignRecapBuilder { enum BuilderError: Error { From a70a304c13be07cbb0a45ccf53734b278c90a5bf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 19 Mar 2024 12:56:15 +0100 Subject: [PATCH 484/814] rename file --- Sources/Auth/Types/Errors/{AuthError.swift => AuthErrors.swift} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename Sources/Auth/Types/Errors/{AuthError.swift => AuthErrors.swift} (100%) diff --git a/Sources/Auth/Types/Errors/AuthError.swift b/Sources/Auth/Types/Errors/AuthErrors.swift similarity index 100% rename from Sources/Auth/Types/Errors/AuthError.swift rename to Sources/Auth/Types/Errors/AuthErrors.swift From 65bb5c3a76f1d9ccf1e930b91dd1c763f3073911 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 19 Mar 2024 13:56:10 +0100 Subject: [PATCH 485/814] savepoint --- Sources/Auth/AuthClient.swift | 6 +++--- Sources/Auth/AuthClientFactory.swift | 4 ++-- Sources/Auth/AuthClientProtocol.swift | 2 +- Sources/Auth/AuthDecryptionService.swift | 4 ++-- Sources/Auth/Services/App/AppRequestService.swift | 6 +++--- Sources/Auth/Services/App/AppRespondSubscriber.swift | 4 ++-- ...ovider.swift => Auth_PendingRequestsProvider.swift} | 4 ++-- ...Responder.swift => Auth_WalletErrorResponder.swift} | 8 ++++---- .../Auth/Services/Wallet/WalletRequestSubscriber.swift | 6 +++--- .../Auth/Services/Wallet/WalletRespondService.swift | 10 +++++----- .../{AuthPayload.swift => AuthPayloadStruct.swift} | 4 ++-- .../{RespondParams.swift => AuthRespondParams.swift} | 2 +- ...uthRequestParams.swift => Auth_RequestParams.swift} | 6 +++--- Sources/Auth/Types/Public/AuthRequest.swift | 2 +- ....swift => SessionAuthenticatedProtocolMethod.swift} | 0 .../Auth/Types/AuthRequestParams.swift | 6 +++--- 16 files changed, 37 insertions(+), 37 deletions(-) rename Sources/Auth/Services/Wallet/{PendingRequestsProvider.swift => Auth_PendingRequestsProvider.swift} (91%) rename Sources/Auth/Services/Wallet/{WalletErrorResponder.swift => Auth_WalletErrorResponder.swift} (90%) rename Sources/Auth/Types/{AuthPayload.swift => AuthPayloadStruct.swift} (94%) rename Sources/Auth/Types/{RespondParams.swift => AuthRespondParams.swift} (81%) rename Sources/Auth/Types/ProtocolRPCParams/{AuthRequestParams.swift => Auth_RequestParams.swift} (63%) rename Sources/WalletConnectSign/Auth/{AuthProtocolMethod.swift => SessionAuthenticatedProtocolMethod.swift} (100%) diff --git a/Sources/Auth/AuthClient.swift b/Sources/Auth/AuthClient.swift index 8efd60dad..d9551bdde 100644 --- a/Sources/Auth/AuthClient.swift +++ b/Sources/Auth/AuthClient.swift @@ -46,13 +46,13 @@ public class AuthClient: AuthClientProtocol { private let appRespondSubscriber: AppRespondSubscriber private let walletRequestSubscriber: WalletRequestSubscriber private let walletRespondService: WalletRespondService - private let pendingRequestsProvider: PendingRequestsProvider + private let pendingRequestsProvider: Auth_PendingRequestsProvider init(appRequestService: AppRequestService, appRespondSubscriber: AppRespondSubscriber, walletRequestSubscriber: WalletRequestSubscriber, walletRespondService: WalletRespondService, - pendingRequestsProvider: PendingRequestsProvider, + pendingRequestsProvider: Auth_PendingRequestsProvider, logger: ConsoleLogging, socketConnectionStatusPublisher: AnyPublisher, pairingRegisterer: PairingRegisterer @@ -102,7 +102,7 @@ public class AuthClient: AuthClientProtocol { } @available(*, deprecated, message: "Use SignClient or Web3Wallet for message formatting.") - public func formatMessage(payload: AuthPayload, address: String) throws -> String { + public func formatMessage(payload: AuthPayloadStruct, address: String) throws -> String { return try SIWEFromCacaoPayloadFormatter().formatMessage(from: payload.cacaoPayload(address: address)) } diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift index ae73f8d7e..59b902602 100644 --- a/Sources/Auth/AuthClientFactory.swift +++ b/Sources/Auth/AuthClientFactory.swift @@ -49,10 +49,10 @@ public struct AuthClientFactory { let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: history, signatureVerifier: signatureVerifier, pairingRegisterer: pairingRegisterer, messageFormatter: messageFormatter) - let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history) + let walletErrorResponder = Auth_WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history) let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer, verifyClient: verifyClient, verifyContextStore: verifyContextStore) let walletRespondService = WalletRespondService(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer) - let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: history, verifyContextStore: verifyContextStore) + let pendingRequestsProvider = Auth_PendingRequestsProvider(rpcHistory: history, verifyContextStore: verifyContextStore) return AuthClient( appRequestService: appRequestService, diff --git a/Sources/Auth/AuthClientProtocol.swift b/Sources/Auth/AuthClientProtocol.swift index 23d5cd55c..d74cdbb7f 100644 --- a/Sources/Auth/AuthClientProtocol.swift +++ b/Sources/Auth/AuthClientProtocol.swift @@ -4,7 +4,7 @@ import Combine public protocol AuthClientProtocol { var authRequestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { get } - func formatMessage(payload: AuthPayload, address: String) throws -> String + func formatMessage(payload: AuthPayloadStruct, address: String) throws -> String func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws func reject(requestId: RPCID) async throws func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] diff --git a/Sources/Auth/AuthDecryptionService.swift b/Sources/Auth/AuthDecryptionService.swift index 9c2c55d61..11e9a2fbd 100644 --- a/Sources/Auth/AuthDecryptionService.swift +++ b/Sources/Auth/AuthDecryptionService.swift @@ -21,7 +21,7 @@ public class AuthDecryptionService { public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthRequest { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) setPairingMetadata(rpcRequest: rpcRequest, topic: topic) - if let params = try rpcRequest.params?.get(AuthRequestParams.self), + if let params = try rpcRequest.params?.get(Auth_RequestParams.self), let id = rpcRequest.id { let authRequest = AuthRequest(id: id, topic: topic, payload: params.payloadParams, requester: params.requester.metadata) return authRequest @@ -37,7 +37,7 @@ public class AuthDecryptionService { private func setPairingMetadata(rpcRequest: RPCRequest, topic: String) { guard var pairing = pairingStorage.getPairing(forTopic: topic), pairing.peerMetadata == nil, - let peerMetadata = try? rpcRequest.params?.get(AuthRequestParams.self).requester.metadata + let peerMetadata = try? rpcRequest.params?.get(Auth_RequestParams.self).requester.metadata else { return } pairing.updatePeerMetadata(peerMetadata) diff --git a/Sources/Auth/Services/App/AppRequestService.swift b/Sources/Auth/Services/App/AppRequestService.swift index afc45eac9..325c515b5 100644 --- a/Sources/Auth/Services/App/AppRequestService.swift +++ b/Sources/Auth/Services/App/AppRequestService.swift @@ -22,9 +22,9 @@ actor AppRequestService { func request(params: RequestParams, topic: String) async throws { let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() - let requester = AuthRequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) - let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) - let params = AuthRequestParams(requester: requester, payloadParams: payload) + let requester = Auth_RequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) + let payload = AuthPayloadStruct(requestParams: params, iat: iatProvader.iat) + let params = Auth_RequestParams(requester: requester, payloadParams: payload) let request = RPCRequest(method: "wc_authRequest", params: params) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift index fe1d07287..e7036bf5e 100644 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/Auth/Services/App/AppRespondSubscriber.swift @@ -29,13 +29,13 @@ class AppRespondSubscriber { private func subscribeForResponse() { networkingInteractor.responseErrorSubscription(on: AuthRequestProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthErrors(code: payload.error.code) else { return } onResponse?(payload.id, .failure(error)) }.store(in: &publishers) networkingInteractor.responseSubscription(on: AuthRequestProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + .sink { [unowned self] (payload: ResponseSubscriptionPayload) in pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) diff --git a/Sources/Auth/Services/Wallet/PendingRequestsProvider.swift b/Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift similarity index 91% rename from Sources/Auth/Services/Wallet/PendingRequestsProvider.swift rename to Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift index c824760b9..f646835e4 100644 --- a/Sources/Auth/Services/Wallet/PendingRequestsProvider.swift +++ b/Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift @@ -1,6 +1,6 @@ import Foundation -class PendingRequestsProvider { +class Auth_PendingRequestsProvider { private let rpcHistory: RPCHistory private let verifyContextStore: CodableStore @@ -16,7 +16,7 @@ class PendingRequestsProvider { let pendingRequests: [AuthRequest] = rpcHistory.getPending() .filter {$0.request.method == "wc_authRequest"} .compactMap { - guard let params = try? $0.request.params?.get(AuthRequestParams.self) else { return nil } + guard let params = try? $0.request.params?.get(Auth_RequestParams.self) else { return nil } return AuthRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams, requester: params.requester.metadata) } diff --git a/Sources/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift similarity index 90% rename from Sources/Auth/Services/Wallet/WalletErrorResponder.swift rename to Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift index f6047f016..895f41d9d 100644 --- a/Sources/Auth/Services/Wallet/WalletErrorResponder.swift +++ b/Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift @@ -1,6 +1,6 @@ import Foundation -actor WalletErrorResponder { +actor Auth_WalletErrorResponder { enum Errors: Error { case recordForIdNotFound case malformedAuthRequestParams @@ -31,17 +31,17 @@ actor WalletErrorResponder { try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: AuthRequestProtocolMethod(), reason: error, envelopeType: envelopeType) } - private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { + private func getAuthRequestParams(requestId: RPCID) throws -> Auth_RequestParams { guard let request = rpcHistory.get(recordId: requestId)?.request else { throw Errors.recordForIdNotFound } - guard let authRequestParams = try request.params?.get(AuthRequestParams.self) + guard let authRequestParams = try request.params?.get(Auth_RequestParams.self) else { throw Errors.malformedAuthRequestParams } return authRequestParams } - private func generateAgreementKeys(requestParams: AuthRequestParams) throws -> (topic: String, keys: AgreementKeys) { + private func generateAgreementKeys(requestParams: Auth_RequestParams) throws -> (topic: String, keys: AgreementKeys) { let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) let topic = peerPubKey.rawRepresentation.sha256().toHexString() let selfPubKey = try kms.createX25519KeyPair() diff --git a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift index 95d71799e..7270871d7 100644 --- a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift @@ -6,7 +6,7 @@ class WalletRequestSubscriber { private let logger: ConsoleLogging private let kms: KeyManagementServiceProtocol private var publishers = [AnyCancellable]() - private let walletErrorResponder: WalletErrorResponder + private let walletErrorResponder: Auth_WalletErrorResponder private let pairingRegisterer: PairingRegisterer private let verifyClient: VerifyClientProtocol private let verifyContextStore: CodableStore @@ -17,7 +17,7 @@ class WalletRequestSubscriber { networkingInteractor: NetworkInteracting, logger: ConsoleLogging, kms: KeyManagementServiceProtocol, - walletErrorResponder: WalletErrorResponder, + walletErrorResponder: Auth_WalletErrorResponder, pairingRegisterer: PairingRegisterer, verifyClient: VerifyClientProtocol, verifyContextStore: CodableStore @@ -34,7 +34,7 @@ class WalletRequestSubscriber { private func subscribeForRequest() { pairingRegisterer.register(method: AuthRequestProtocolMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in + .sink { [unowned self] (payload: RequestSubscriptionPayload) in logger.debug("WalletRequestSubscriber: Received request") pairingRegisterer.setReceived(pairingTopic: payload.topic) diff --git a/Sources/Auth/Services/Wallet/WalletRespondService.swift b/Sources/Auth/Services/Wallet/WalletRespondService.swift index 3735ce663..529ef2a79 100644 --- a/Sources/Auth/Services/Wallet/WalletRespondService.swift +++ b/Sources/Auth/Services/Wallet/WalletRespondService.swift @@ -10,7 +10,7 @@ actor WalletRespondService { private let rpcHistory: RPCHistory private let verifyContextStore: CodableStore private let logger: ConsoleLogging - private let walletErrorResponder: WalletErrorResponder + private let walletErrorResponder: Auth_WalletErrorResponder private let pairingRegisterer: PairingRegisterer init( @@ -19,7 +19,7 @@ actor WalletRespondService { kms: KeyManagementService, rpcHistory: RPCHistory, verifyContextStore: CodableStore, - walletErrorResponder: WalletErrorResponder, + walletErrorResponder: Auth_WalletErrorResponder, pairingRegisterer: PairingRegisterer ) { self.networkingInteractor = networkingInteractor @@ -57,17 +57,17 @@ actor WalletRespondService { verifyContextStore.delete(forKey: requestId.string) } - private func getAuthRequestParams(requestId: RPCID) throws -> AuthRequestParams { + private func getAuthRequestParams(requestId: RPCID) throws -> Auth_RequestParams { guard let request = rpcHistory.get(recordId: requestId)?.request else { throw Errors.recordForIdNotFound } - guard let authRequestParams = try request.params?.get(AuthRequestParams.self) + guard let authRequestParams = try request.params?.get(Auth_RequestParams.self) else { throw Errors.malformedAuthRequestParams } return authRequestParams } - private func generateAgreementKeys(requestParams: AuthRequestParams) throws -> (topic: String, keys: AgreementKeys) { + private func generateAgreementKeys(requestParams: Auth_RequestParams) throws -> (topic: String, keys: AgreementKeys) { let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) let topic = peerPubKey.rawRepresentation.sha256().toHexString() let selfPubKey = try kms.createX25519KeyPair() diff --git a/Sources/Auth/Types/AuthPayload.swift b/Sources/Auth/Types/AuthPayloadStruct.swift similarity index 94% rename from Sources/Auth/Types/AuthPayload.swift rename to Sources/Auth/Types/AuthPayloadStruct.swift index 33ba49756..b7a1494c4 100644 --- a/Sources/Auth/Types/AuthPayload.swift +++ b/Sources/Auth/Types/AuthPayloadStruct.swift @@ -1,6 +1,6 @@ import Foundation -public struct AuthPayload: Codable, Equatable { +public struct AuthPayloadStruct: Codable, Equatable { public let domain: String public let aud: String public let version: String @@ -51,7 +51,7 @@ public struct AuthPayload: Codable, Equatable { } } -private extension AuthPayload { +private extension AuthPayloadStruct { enum Errors: Error { case invalidChainID diff --git a/Sources/Auth/Types/RespondParams.swift b/Sources/Auth/Types/AuthRespondParams.swift similarity index 81% rename from Sources/Auth/Types/RespondParams.swift rename to Sources/Auth/Types/AuthRespondParams.swift index f7c4a4af8..fce3414eb 100644 --- a/Sources/Auth/Types/RespondParams.swift +++ b/Sources/Auth/Types/AuthRespondParams.swift @@ -1,6 +1,6 @@ import Foundation -public struct RespondParams: Equatable { +public struct AuthRespondParams: Equatable { let id: RPCID let signature: CacaoSignature diff --git a/Sources/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift b/Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift similarity index 63% rename from Sources/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift rename to Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift index 427b29303..4a72728ed 100644 --- a/Sources/Auth/Types/ProtocolRPCParams/AuthRequestParams.swift +++ b/Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift @@ -1,12 +1,12 @@ import Foundation /// wc_authRequest RPC method request param -struct AuthRequestParams: Codable, Equatable { +struct Auth_RequestParams: Codable, Equatable { let requester: Requester - let payloadParams: AuthPayload + let payloadParams: AuthPayloadStruct } -extension AuthRequestParams { +extension Auth_RequestParams { struct Requester: Codable, Equatable { let publicKey: String let metadata: AppMetadata diff --git a/Sources/Auth/Types/Public/AuthRequest.swift b/Sources/Auth/Types/Public/AuthRequest.swift index e796d75cf..63e553cc5 100644 --- a/Sources/Auth/Types/Public/AuthRequest.swift +++ b/Sources/Auth/Types/Public/AuthRequest.swift @@ -3,6 +3,6 @@ import Foundation public struct AuthRequest: Equatable, Codable { public let id: RPCID public let topic: String - public let payload: AuthPayload + public let payload: AuthPayloadStruct public let requester: AppMetadata } diff --git a/Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift b/Sources/WalletConnectSign/Auth/SessionAuthenticatedProtocolMethod.swift similarity index 100% rename from Sources/WalletConnectSign/Auth/AuthProtocolMethod.swift rename to Sources/WalletConnectSign/Auth/SessionAuthenticatedProtocolMethod.swift diff --git a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift index 2556c997e..5b4c49edc 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift @@ -65,7 +65,7 @@ public struct AuthRequestParams { #if DEBUG -extension AuthRequestParams { +extension Auth_RequestParams { static func stub(domain: String = "service.invalid", chains: [String] = ["eip155:1"], nonce: String = "32891756", @@ -75,8 +75,8 @@ extension AuthRequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> AuthRequestParams { - return try! AuthRequestParams(domain: domain, + methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> Auth_RequestParams { + return try! Auth_RequestParams(domain: domain, chains: chains, nonce: nonce, uri: uri, From f8a6fd81fc499f946c1b09e8459bc83618a91a87 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 19 Mar 2024 14:00:32 +0100 Subject: [PATCH 486/814] savepoint --- Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift | 4 ++-- .../WalletConnectSign/Auth/Types/AuthRequestParams.swift | 6 +++--- Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift index ab3a54fb8..02889c9a1 100644 --- a/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/CacaosBuilder.swift @@ -1,7 +1,7 @@ import Foundation struct CacaosBuilder { - public static func makeCacao(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: WalletConnectUtils.Account) throws -> Cacao { + public static func makeCacao(authPayload: AuthPayload, signature: CacaoSignature, account: Account) throws -> Cacao { let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: authPayload, account: account) let header = CacaoHeader(t: "eip4361") return Cacao(h: header, p: cacaoPayload, s: signature) @@ -10,7 +10,7 @@ struct CacaosBuilder { } struct CacaoPayloadBuilder { - public static func makeCacaoPayload(authPayload: AuthPayload, account: WalletConnectUtils.Account) throws -> CacaoPayload { + public static func makeCacaoPayload(authPayload: AuthPayload, account: Account) throws -> CacaoPayload { var mergedRecap: RecapUrn? var resources: [String]? = nil diff --git a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift index 5b4c49edc..2556c997e 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthRequestParams.swift @@ -65,7 +65,7 @@ public struct AuthRequestParams { #if DEBUG -extension Auth_RequestParams { +extension AuthRequestParams { static func stub(domain: String = "service.invalid", chains: [String] = ["eip155:1"], nonce: String = "32891756", @@ -75,8 +75,8 @@ extension Auth_RequestParams { statement: String? = "I accept the ServiceOrg Terms of Service: https://service.invalid/tos", requestId: String? = nil, resources: [String]? = ["ipfs://bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq/", "https://example.com/my-web2-claim.json"], - methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> Auth_RequestParams { - return try! Auth_RequestParams(domain: domain, + methods: [String]? = ["personal_sign", "eth_sendTransaction"]) -> AuthRequestParams { + return try! AuthRequestParams(domain: domain, chains: chains, nonce: nonce, uri: uri, diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 1947e298c..4cb030cd4 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -36,7 +36,7 @@ public protocol SignClientProtocol { func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] - func getPendingAuthRequests() throws -> [(WalletConnectSign.AuthenticationRequest, VerifyContext?)] + func getPendingAuthRequests() throws -> [(AuthenticationRequest, VerifyContext?)] func getPendingProposals(topic: String?) -> [(proposal: Session.Proposal, context: VerifyContext?)] } From 185f34fc7c7a6e7d0adf307f6b6fd1ff4ca63d18 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 19 Mar 2024 14:02:23 +0100 Subject: [PATCH 487/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 64ed1a1f7..9bc4c4db5 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -361,7 +361,7 @@ public final class SignClient: SignClientProtocol { return try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) } - public func buildSignedAuthObject(authPayload: AuthPayload, signature: WalletConnectUtils.CacaoSignature, account: Account) throws -> AuthObject { + public func buildSignedAuthObject(authPayload: AuthPayload, signature: CacaoSignature, account: Account) throws -> AuthObject { try CacaosBuilder.makeCacao(authPayload: authPayload, signature: signature, account: account) } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index bde5bc345..5cc7b864f 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -197,7 +197,7 @@ public class Web3WalletClient { signClient.getSessions() } - public func formatAuthMessage(payload: WalletConnectSign.AuthPayload, account: Account) throws -> String { + public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { try signClient.formatAuthMessage(payload: payload, account: account) } From 8114d7466acbcca081b02b44fceb1c4da6bd86d7 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Tue, 19 Mar 2024 13:31:43 +0000 Subject: [PATCH 488/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 8c3caff7b..617b2b368 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.17.0"} +{"version": "1.18.0"} From a9300441ae7adfdefe68e37bc78a0a1c77dcd35c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 20 Mar 2024 09:49:01 +0100 Subject: [PATCH 489/814] add dependency to podspec --- WalletConnectSwiftV2.podspec | 1 + 1 file changed, 1 insertion(+) diff --git a/WalletConnectSwiftV2.podspec b/WalletConnectSwiftV2.podspec index 5a294b701..e6b1e4cf7 100644 --- a/WalletConnectSwiftV2.podspec +++ b/WalletConnectSwiftV2.podspec @@ -85,6 +85,7 @@ Pod::Spec.new do |spec| spec.subspec 'WalletConnectSign' do |ss| ss.source_files = 'Sources/WalletConnectSign/**/*.{h,m,swift}' ss.dependency 'WalletConnectSwiftV2/WalletConnectPairing' + ss.dependency 'WalletConnectSwiftV2/WalletConnectSigner' ss.dependency 'WalletConnectSwiftV2/WalletConnectVerify' end From b4635e38d2cebb9ce7f3df1972af0b086624ec4e Mon Sep 17 00:00:00 2001 From: llbartekll Date: Wed, 20 Mar 2024 10:22:33 +0000 Subject: [PATCH 490/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 617b2b368..01b85dcdc 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.0"} +{"version": "1.18.1"} From 7990cddbaa7d3efadebc579b2a0672f39ffbae58 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 25 Mar 2024 15:30:17 +0100 Subject: [PATCH 491/814] add privacy info manifest file --- Sources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Sources/PrivacyInfo.xcprivacy diff --git a/Sources/PrivacyInfo.xcprivacy b/Sources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + From aa873baf9cc3ce423533c27d191833a6f5cc04d1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 25 Mar 2024 15:39:10 +0100 Subject: [PATCH 492/814] remove trash --- .../xcschemes/WalletConnectHistory.xcscheme | 66 ------- Example/ExampleApp.xcodeproj/project.pbxproj | 30 ---- .../xcschemes/WalletConnectChat.xcscheme | 77 --------- .../xcschemes/WalletConnectSync.xcscheme | 67 -------- .../xcshareddata/xcschemes/Web3Inbox.xcscheme | 67 -------- .../Sync/SyncDerivationServiceTests.swift | 26 --- Example/IntegrationTests/Sync/SyncTests.swift | 161 ------------------ Package.swift | 16 -- 8 files changed, 510 deletions(-) delete mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/WalletConnectHistory.xcscheme delete mode 100644 Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectChat.xcscheme delete mode 100644 Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectSync.xcscheme delete mode 100644 Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Web3Inbox.xcscheme delete mode 100644 Example/IntegrationTests/Sync/SyncDerivationServiceTests.swift delete mode 100644 Example/IntegrationTests/Sync/SyncTests.swift diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectHistory.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectHistory.xcscheme deleted file mode 100644 index 4311c49f7..000000000 --- a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectHistory.xcscheme +++ /dev/null @@ -1,66 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index ec7366b09..467cfbd55 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -91,8 +91,6 @@ A54195A12934BFEF0035AD19 /* EIP191VerifierTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959D2934BFEF0035AD19 /* EIP191VerifierTests.swift */; }; A54195A52934E83F0035AD19 /* Web3 in Frameworks */ = {isa = PBXBuildFile; productRef = A54195A42934E83F0035AD19 /* Web3 */; }; A561C80029DF32CE00DF540D /* HDWalletKit in Frameworks */ = {isa = PBXBuildFile; productRef = A561C7FF29DF32CE00DF540D /* HDWalletKit */; }; - A561C80329DFCCDC00DF540D /* SyncTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A561C80229DFCCDC00DF540D /* SyncTests.swift */; }; - A561C80529DFCD4500DF540D /* WalletConnectSync in Frameworks */ = {isa = PBXBuildFile; productRef = A561C80429DFCD4500DF540D /* WalletConnectSync */; }; A5629AA92876A23100094373 /* ChatService.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AA82876A23100094373 /* ChatService.swift */; }; A5629ABD2876CBC000094373 /* ChatListModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AB82876CBC000094373 /* ChatListModule.swift */; }; A5629ABE2876CBC000094373 /* ChatListPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AB92876CBC000094373 /* ChatListPresenter.swift */; }; @@ -114,7 +112,6 @@ A5629AEA2877F2D600094373 /* WalletConnectChat in Frameworks */ = {isa = PBXBuildFile; productRef = A5629AE92877F2D600094373 /* WalletConnectChat */; }; A5629AF22877F75100094373 /* Starscream in Frameworks */ = {isa = PBXBuildFile; productRef = A5629AF12877F75100094373 /* Starscream */; }; A56AC8F22AD88A5A001C8FAA /* Sequence.swift in Sources */ = {isa = PBXBuildFile; fileRef = A56AC8F12AD88A5A001C8FAA /* Sequence.swift */; }; - A573C53729EC34A600E3CBFD /* SyncDerivationServiceTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A573C53629EC34A600E3CBFD /* SyncDerivationServiceTests.swift */; }; A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */ = {isa = PBXBuildFile; productRef = A573C53829EC365000E3CBFD /* HDWalletKit */; }; A573C53B29EC365800E3CBFD /* HDWalletKit in Frameworks */ = {isa = PBXBuildFile; productRef = A573C53A29EC365800E3CBFD /* HDWalletKit */; }; A573C53D29EC366500E3CBFD /* HDWalletKit in Frameworks */ = {isa = PBXBuildFile; productRef = A573C53C29EC366500E3CBFD /* HDWalletKit */; }; @@ -208,7 +205,6 @@ A5E03DFA286465C700888481 /* SignClientTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E03DF9286465C700888481 /* SignClientTests.swift */; }; A5E03DFD286465D100888481 /* Stubs.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E03DFC286465D100888481 /* Stubs.swift */; }; A5E03DFF2864662500888481 /* WalletConnect in Frameworks */ = {isa = PBXBuildFile; productRef = A5E03DFE2864662500888481 /* WalletConnect */; }; - A5E03E01286466EA00888481 /* WalletConnectChat in Frameworks */ = {isa = PBXBuildFile; productRef = A5E03E00286466EA00888481 /* WalletConnectChat */; }; A5E03E1128646F8000888481 /* KeychainStorageMock.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E03E1028646F8000888481 /* KeychainStorageMock.swift */; }; A5E22D1A2840C62A00E36487 /* Engine.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D192840C62A00E36487 /* Engine.swift */; }; A5E22D1C2840C85D00E36487 /* App.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D1B2840C85D00E36487 /* App.swift */; }; @@ -470,7 +466,6 @@ A541959B2934BFEF0035AD19 /* SignerTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SignerTests.swift; sourceTree = ""; }; A541959C2934BFEF0035AD19 /* EIP1271VerifierTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = EIP1271VerifierTests.swift; sourceTree = ""; }; A541959D2934BFEF0035AD19 /* EIP191VerifierTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = EIP191VerifierTests.swift; sourceTree = ""; }; - A561C80229DFCCDC00DF540D /* SyncTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SyncTests.swift; sourceTree = ""; }; A5629AA82876A23100094373 /* ChatService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatService.swift; sourceTree = ""; }; A5629AB82876CBC000094373 /* ChatListModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListModule.swift; sourceTree = ""; }; A5629AB92876CBC000094373 /* ChatListPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListPresenter.swift; sourceTree = ""; }; @@ -491,7 +486,6 @@ A5629AE728772A0100094373 /* InviteViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteViewModel.swift; sourceTree = ""; }; A5629AEF2877F73000094373 /* DefaultSocketFactory.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DefaultSocketFactory.swift; sourceTree = ""; }; A56AC8F12AD88A5A001C8FAA /* Sequence.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Sequence.swift; sourceTree = ""; }; - A573C53629EC34A600E3CBFD /* SyncDerivationServiceTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SyncDerivationServiceTests.swift; sourceTree = ""; }; A57879702A4EDC8100F8D10B /* TextFieldView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TextFieldView.swift; sourceTree = ""; }; A578FA312873036400AA7720 /* InputView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputView.swift; sourceTree = ""; }; A578FA34287304A300AA7720 /* Color.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Color.swift; sourceTree = ""; }; @@ -743,13 +737,11 @@ buildActionMask = 2147483647; files = ( A5E03DFF2864662500888481 /* WalletConnect in Frameworks */, - A561C80529DFCD4500DF540D /* WalletConnectSync in Frameworks */, A5E03DF52864651200888481 /* Starscream in Frameworks */, A5C8BE85292FE20B006CC85C /* Web3 in Frameworks */, C5DD5BE1294E09E3008FD3A4 /* Web3Wallet in Frameworks */, A5B6C0F32A6EAB1700927332 /* WalletConnectNotify in Frameworks */, A573C53B29EC365800E3CBFD /* HDWalletKit in Frameworks */, - A5E03E01286466EA00888481 /* WalletConnectChat in Frameworks */, ); runOnlyForDeploymentPostprocessing = 0; }; @@ -1034,15 +1026,6 @@ path = Signer; sourceTree = ""; }; - A561C80129DFCCD300DF540D /* Sync */ = { - isa = PBXGroup; - children = ( - A561C80229DFCCDC00DF540D /* SyncTests.swift */, - A573C53629EC34A600E3CBFD /* SyncDerivationServiceTests.swift */, - ); - path = Sync; - sourceTree = ""; - }; A5629AA42876A19D00094373 /* DomainLayer */ = { isa = PBXGroup; children = ( @@ -1450,7 +1433,6 @@ isa = PBXGroup; children = ( 847F07FE2A25DBC700B2A5A4 /* XPlatform */, - A561C80129DFCCD300DF540D /* Sync */, 849D7A91292E2115006A2BD4 /* Push */, 84CEC64728D8A98900D081A8 /* Pairing */, A5E03E0A28646A8A00888481 /* Stubs */, @@ -2027,10 +2009,8 @@ packageProductDependencies = ( A5E03DF42864651200888481 /* Starscream */, A5E03DFE2864662500888481 /* WalletConnect */, - A5E03E00286466EA00888481 /* WalletConnectChat */, A5C8BE84292FE20B006CC85C /* Web3 */, C5DD5BE0294E09E3008FD3A4 /* Web3Wallet */, - A561C80429DFCD4500DF540D /* WalletConnectSync */, A573C53A29EC365800E3CBFD /* HDWalletKit */, A5B6C0F22A6EAB1700927332 /* WalletConnectNotify */, ); @@ -2387,10 +2367,8 @@ buildActionMask = 2147483647; files = ( A51606F92A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, - A573C53729EC34A600E3CBFD /* SyncDerivationServiceTests.swift in Sources */, A5A0843E29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, 84CEC64628D89D6B00D081A8 /* PairingTests.swift in Sources */, - A561C80329DFCCDC00DF540D /* SyncTests.swift in Sources */, 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */, 8439CB89293F658E00F2F2E2 /* PushMessage.swift in Sources */, A518B31428E33A6500A2CE93 /* InputConfig.swift in Sources */, @@ -3390,10 +3368,6 @@ package = A561C7FE29DF32CE00DF540D /* XCRemoteSwiftPackageReference "HDWallet" */; productName = HDWalletKit; }; - A561C80429DFCD4500DF540D /* WalletConnectSync */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectSync; - }; A5629AE92877F2D600094373 /* WalletConnectChat */ = { isa = XCSwiftPackageProductDependency; productName = WalletConnectChat; @@ -3481,10 +3455,6 @@ isa = XCSwiftPackageProductDependency; productName = WalletConnect; }; - A5E03E00286466EA00888481 /* WalletConnectChat */ = { - isa = XCSwiftPackageProductDependency; - productName = WalletConnectChat; - }; C5133A77294125CC00A8314C /* Web3 */ = { isa = XCSwiftPackageProductDependency; package = A5AE354528A1A2AC0059AE8A /* XCRemoteSwiftPackageReference "Web3" */; diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectChat.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectChat.xcscheme deleted file mode 100644 index ae2c82e99..000000000 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectChat.xcscheme +++ /dev/null @@ -1,77 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectSync.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectSync.xcscheme deleted file mode 100644 index 4b58c89d1..000000000 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectSync.xcscheme +++ /dev/null @@ -1,67 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Web3Inbox.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Web3Inbox.xcscheme deleted file mode 100644 index ae55238ff..000000000 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Web3Inbox.xcscheme +++ /dev/null @@ -1,67 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/IntegrationTests/Sync/SyncDerivationServiceTests.swift b/Example/IntegrationTests/Sync/SyncDerivationServiceTests.swift deleted file mode 100644 index 549ed6929..000000000 --- a/Example/IntegrationTests/Sync/SyncDerivationServiceTests.swift +++ /dev/null @@ -1,26 +0,0 @@ -import Foundation -import XCTest -@testable import WalletConnectSync -@testable import WalletConnectSigner - -class SyncDerivationServiceTests: XCTestCase { - - func testDerivation() throws { - let account = Account("eip155:1:0x1FF34C90a0850Fe7227fcFA642688b9712477482")! - let signature = "0xc91265eadb1473d90f8d49d31b7016feb7f7761a2a986ca2146a4b8964f3357569869680154927596a5829ceea925f4196b8a853a29c2c1d5915832fc9f1c6a01c" - let keychain = KeychainStorageMock() - let syncStorage = SyncSignatureStore(keychain: keychain) - let kms = KeyManagementService(keychain: keychain) - let derivationService = SyncDerivationService( - syncStorage: syncStorage, - bip44: DefaultBIP44Provider(), - kms: kms - ) - - try syncStorage.saveSignature(signature, for: account) - - let topic = try derivationService.deriveTopic(account: account, store: "my-user-profile") - - XCTAssertEqual(topic, "741f8902d339c4c16f33fa598a6598b63e5ed125d761374511b2e06562b033eb") - } -} diff --git a/Example/IntegrationTests/Sync/SyncTests.swift b/Example/IntegrationTests/Sync/SyncTests.swift deleted file mode 100644 index 6b03e8ad1..000000000 --- a/Example/IntegrationTests/Sync/SyncTests.swift +++ /dev/null @@ -1,161 +0,0 @@ -import Foundation -import Combine -import XCTest -import Web3 -@testable import WalletConnectSync -@testable import WalletConnectSigner - -final class SyncTests: XCTestCase { - - struct TestObject: DatabaseObject { - let id: String - let value: String - - var databaseId: String { - return id - } - } - - var publishers = Set() - - var client1: SyncClient! - var client2: SyncClient! - - var indexStore1: SyncIndexStore! - var indexStore2: SyncIndexStore! - - var syncStore1: SyncStore! - var syncStore2: SyncStore! - - var signer: MessageSigner! - - let storeName = "SyncTests_store" - - var account: Account { - return Account("eip155:1:" + pk.address.hex(eip55: true))! - } - - let pk = try! EthereumPrivateKey() - - var privateKey: Data { - return Data(pk.rawPrivateKey) - } - - override func setUp() async throws { - indexStore1 = makeIndexStore() - indexStore2 = makeIndexStore() - client1 = makeClient(indexStore: indexStore1, suffix: "❤️") - client2 = makeClient(indexStore: indexStore2, suffix: "💜") - syncStore1 = makeSyncStore(client: client1, indexStore: indexStore1) - syncStore2 = makeSyncStore(client: client2, indexStore: indexStore2) - signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() - } - - func makeClient(indexStore: SyncIndexStore, suffix: String) -> SyncClient { - let syncSignatureStore = SyncSignatureStore(keychain: KeychainStorageMock()) - let keychain = KeychainStorageMock() - let kms = KeyManagementService(keychain: keychain) - let derivationService = SyncDerivationService(syncStorage: syncSignatureStore, bip44: DefaultBIP44Provider(), kms: kms) - let logger = ConsoleLogger(prefix: suffix, loggingLevel: .debug) - let relayClient = RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: RuntimeKeyValueStorage(), - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - networkMonitor: NetworkMonitor(), - logger: logger) - let networkingInteractor = NetworkingClientFactory.create( - relayClient: relayClient, - logger: logger, - keychainStorage: keychain, - keyValueStorage: RuntimeKeyValueStorage()) - let historyStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "historyStore") - let syncHistoryStore = SyncHistoryStore(store: historyStore) - let syncService = SyncService(networkInteractor: networkingInteractor, derivationService: derivationService, signatureStore: syncSignatureStore, indexStore: indexStore, historyStore: syncHistoryStore, logger: logger) - return SyncClient(syncService: syncService, syncSignatureStore: syncSignatureStore) - } - - func makeIndexStore() -> SyncIndexStore { - let store = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "indexStore") - return SyncIndexStore(store: store) - } - - func makeSyncStore(client: SyncClient, indexStore: SyncIndexStore) -> SyncStore { - let objectStore = KeyedDatabase(storage: RuntimeKeyValueStorage(), identifier: "objectStore") - return SyncStore(name: storeName, syncClient: client, indexStore: indexStore, objectStore: objectStore) - } - - func testSync() async throws { - let setExpectation = expectation(description: "syncSetTest") - let delExpectation = expectation(description: "syncDelTest") - let uptExpectation = expectation(description: "syncUptTest") - - let object = TestObject(id: "id-1", value: "value-1") - let updated = TestObject(id: "id-1", value: "value-2") - - syncStore1.syncUpdatePublisher.sink { (_, _, update) in - switch update { - case .set: - XCTFail() - case .delete: - delExpectation.fulfill() - case .update: - XCTFail() - } - }.store(in: &publishers) - - syncStore2.syncUpdatePublisher.sink { (_, _, update) in - switch update { - case .set: - setExpectation.fulfill() - case .delete: - XCTFail() - case .update: - uptExpectation.fulfill() - } - }.store(in: &publishers) - - // Configure clients - - try await registerClient(client: client1) - try await registerClient(client: client2) - - // Testing SyncStore `set` - - try await syncStore1.set(object: object, for: account) - - wait(for: [setExpectation], timeout: InputConfig.defaultTimeout) - - XCTAssertEqual(try syncStore1.getAll(for: account), [object]) - XCTAssertEqual(try syncStore2.getAll(for: account), [object]) - - // Testing SyncStore `update` - - try await syncStore1.set(object: updated, for: account) - - wait(for: [uptExpectation], timeout: InputConfig.defaultTimeout) - - XCTAssertEqual(try syncStore1.getAll(for: account), [updated]) - XCTAssertEqual(try syncStore2.getAll(for: account), [updated]) - - // Testing SyncStore `delete` - - try await syncStore2.delete(id: object.id, for: account) - - wait(for: [delExpectation], timeout: InputConfig.defaultTimeout) - - XCTAssertEqual(try syncStore1.getAll(for: account), []) - XCTAssertEqual(try syncStore2.getAll(for: account), []) - } - - private func registerClient(client: SyncClient) async throws { - let message = client.getMessage(account: account) - - let signature = try signer.sign(message: message, privateKey: privateKey, type: .eip191) - - try await client.register(account: account, signature: signature) - try await client.create(account: account, store: storeName) - try await client.subscribe(account: account, store: storeName) - } -} diff --git a/Package.swift b/Package.swift index 41f0e9bbc..ac3eeb9e0 100644 --- a/Package.swift +++ b/Package.swift @@ -13,9 +13,6 @@ let package = Package( .library( name: "WalletConnect", targets: ["WalletConnectSign"]), - .library( - name: "WalletConnectChat", - targets: ["WalletConnectChat"]), .library( name: "WalletConnectAuth", targets: ["Auth"]), @@ -37,9 +34,6 @@ let package = Package( .library( name: "WalletConnectNetworking", targets: ["WalletConnectNetworking"]), - .library( - name: "WalletConnectSync", - targets: ["WalletConnectSync"]), .library( name: "WalletConnectVerify", targets: ["WalletConnectVerify"]), @@ -59,10 +53,6 @@ let package = Package( name: "WalletConnectSign", dependencies: ["WalletConnectPairing", "WalletConnectVerify", "WalletConnectSigner"], path: "Sources/WalletConnectSign"), - .target( - name: "WalletConnectChat", - dependencies: ["WalletConnectIdentity", "WalletConnectSync"], - path: "Sources/Chat"), .target( name: "Auth", dependencies: ["WalletConnectPairing", "WalletConnectSigner", "WalletConnectVerify"], @@ -138,18 +128,12 @@ let package = Package( .copy("Resources/Assets.xcassets") ] ), - .target( - name: "WalletConnectSync", - dependencies: ["WalletConnectSigner"]), .testTarget( name: "WalletConnectSignTests", dependencies: ["WalletConnectSign", "WalletConnectUtils", "TestingUtils", "WalletConnectVerify"]), .testTarget( name: "WalletConnectPairingTests", dependencies: ["WalletConnectPairing", "TestingUtils"]), - .testTarget( - name: "ChatTests", - dependencies: ["WalletConnectChat", "WalletConnectUtils", "TestingUtils"]), .testTarget( name: "NotifyTests", dependencies: ["WalletConnectNotify", "TestingUtils"]), From ae70dd6a9f5aa2ef4b263d6e0b9f7881cfecfaa3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 25 Mar 2024 16:15:02 +0100 Subject: [PATCH 493/814] add more manifest files --- .../Resources}/PrivacyInfo.xcprivacy | 0 .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ 3 files changed, 88 insertions(+) rename Sources/{ => WalletConnectRelay/Resources}/PrivacyInfo.xcprivacy (100%) create mode 100644 Sources/WalletConnectSign/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/Web3Wallet/Resources/PrivacyInfo.xcprivacy diff --git a/Sources/PrivacyInfo.xcprivacy b/Sources/WalletConnectRelay/Resources/PrivacyInfo.xcprivacy similarity index 100% rename from Sources/PrivacyInfo.xcprivacy rename to Sources/WalletConnectRelay/Resources/PrivacyInfo.xcprivacy diff --git a/Sources/WalletConnectSign/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectSign/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectSign/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/Web3Wallet/Resources/PrivacyInfo.xcprivacy b/Sources/Web3Wallet/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/Web3Wallet/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + From bcf93054f97277de376a0c332d4a045c716681f3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 25 Mar 2024 16:20:03 +0100 Subject: [PATCH 494/814] add PrivacyInfo.xcprivacy to package resources --- Package.swift | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/Package.swift b/Package.swift index ac3eeb9e0..636d7255a 100644 --- a/Package.swift +++ b/Package.swift @@ -52,7 +52,8 @@ let package = Package( .target( name: "WalletConnectSign", dependencies: ["WalletConnectPairing", "WalletConnectVerify", "WalletConnectSigner"], - path: "Sources/WalletConnectSign"), + path: "Sources/WalletConnectSign", + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "Auth", dependencies: ["WalletConnectPairing", "WalletConnectSigner", "WalletConnectVerify"], @@ -60,7 +61,8 @@ let package = Package( .target( name: "Web3Wallet", dependencies: ["WalletConnectSign", "WalletConnectPush", "WalletConnectVerify"], - path: "Sources/Web3Wallet"), + path: "Sources/Web3Wallet", + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectNotify", dependencies: ["WalletConnectPairing", "WalletConnectIdentity", "WalletConnectPush", "WalletConnectSigner", "Database"], @@ -73,7 +75,7 @@ let package = Package( name: "WalletConnectRelay", dependencies: ["WalletConnectJWT"], path: "Sources/WalletConnectRelay", - resources: [.copy("PackageConfig.json")]), + resources: [.copy("PackageConfig.json"), .process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectKMS", dependencies: ["WalletConnectUtils"], From bae4deedf1502bb2b22a0bdd71f05ca87cfb71f6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 26 Mar 2024 08:48:56 +0100 Subject: [PATCH 495/814] add more manifest files --- Package.swift | 18 +++++--- .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ .../Resources/PrivacyInfo.xcprivacy | 44 +++++++++++++++++++ 8 files changed, 320 insertions(+), 6 deletions(-) create mode 100644 Sources/WalletConnectIdentity/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/WalletConnectModal/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/WalletConnectNetworking/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/WalletConnectNotify/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/WalletConnectPairing/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/WalletConnectPush/Resources/PrivacyInfo.xcprivacy create mode 100644 Sources/WalletConnectVerify/Resources/PrivacyInfo.xcprivacy diff --git a/Package.swift b/Package.swift index 636d7255a..b255c6b99 100644 --- a/Package.swift +++ b/Package.swift @@ -66,11 +66,13 @@ let package = Package( .target( name: "WalletConnectNotify", dependencies: ["WalletConnectPairing", "WalletConnectIdentity", "WalletConnectPush", "WalletConnectSigner", "Database"], - path: "Sources/WalletConnectNotify"), + path: "Sources/WalletConnectNotify", + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectPush", dependencies: ["WalletConnectNetworking", "WalletConnectJWT"], - path: "Sources/WalletConnectPush"), + path: "Sources/WalletConnectPush", + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectRelay", dependencies: ["WalletConnectJWT"], @@ -82,7 +84,8 @@ let package = Package( path: "Sources/WalletConnectKMS"), .target( name: "WalletConnectPairing", - dependencies: ["WalletConnectNetworking"]), + dependencies: ["WalletConnectNetworking"], + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectSigner", dependencies: ["WalletConnectNetworking"]), @@ -91,7 +94,8 @@ let package = Package( dependencies: ["WalletConnectKMS"]), .target( name: "WalletConnectIdentity", - dependencies: ["WalletConnectNetworking"]), + dependencies: ["WalletConnectNetworking"], + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectUtils", dependencies: ["JSONRPC"]), @@ -117,7 +121,8 @@ let package = Package( path: "Sources/WalletConnectRouter/Router"), .target( name: "WalletConnectVerify", - dependencies: ["WalletConnectUtils", "WalletConnectNetworking"]), + dependencies: ["WalletConnectUtils", "WalletConnectNetworking"], + resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "Database", dependencies: ["WalletConnectUtils"]), @@ -127,7 +132,8 @@ let package = Package( exclude: ["Secrets/secrets.json.sample"], resources: [ .copy("Secrets/secrets.json"), - .copy("Resources/Assets.xcassets") + .copy("Resources/Assets.xcassets"), + .process("Resources/PrivacyInfo.xcprivacy"), ] ), .testTarget( diff --git a/Sources/WalletConnectIdentity/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectIdentity/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectIdentity/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/WalletConnectModal/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectModal/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectModal/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/WalletConnectNetworking/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectNetworking/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectNetworking/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/WalletConnectNotify/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectNotify/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectNotify/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/WalletConnectPairing/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectPairing/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectPairing/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/WalletConnectPush/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectPush/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectPush/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + diff --git a/Sources/WalletConnectVerify/Resources/PrivacyInfo.xcprivacy b/Sources/WalletConnectVerify/Resources/PrivacyInfo.xcprivacy new file mode 100644 index 000000000..b7158a51b --- /dev/null +++ b/Sources/WalletConnectVerify/Resources/PrivacyInfo.xcprivacy @@ -0,0 +1,44 @@ + + + + + NSPrivacyCollectedDataTypes + + + NSPrivacyCollectedDataType + + NSPrivacyCollectedDataTypeLinked + + NSPrivacyCollectedDataTypeTracking + + NSPrivacyCollectedDataTypePurposes + + + + + + NSPrivacyTracking + + NSPrivacyTrackingDomains + + NSPrivacyAccessedAPITypes + + + NSPrivacyAccessedAPIType + NSPrivacyAccessedAPICategoryUserDefaults + NSPrivacyAccessedAPITypeReasons + + 1C8F.1 + + + + NSPrivacyAccessedAPIType + + NSPrivacyAccessedAPITypeReasons + + 0A2A.1 + + + + + From 39c28ea7cb72320ef72d1312d0be6a597a2e9794 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Tue, 26 Mar 2024 10:01:28 +0000 Subject: [PATCH 496/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 01b85dcdc..e7257d299 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.1"} +{"version": "1.18.2"} From c4ae4ad827f378f287d355bb384da6b4b973c3a8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 26 Mar 2024 15:19:04 +0100 Subject: [PATCH 497/814] savepoint --- .../Serialiser/Envelope.swift | 2 + .../Serialiser/Serializer.swift | 8 ++ .../Auth/Link/LinkAuthRequester.swift | 90 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 7 ++ 4 files changed, 107 insertions(+) create mode 100644 Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index ce123ed0d..4f08cdeb8 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -59,6 +59,8 @@ public extension Envelope { /// type 1 = tp + pk + iv + ct + tag case type1(pubKey: Data) + + var representingByte: UInt8 { switch self { case .type0: diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index aed1406bd..6dbfb6c89 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -57,6 +57,14 @@ public class Serializer: Serializing { return Envelope(type: envelopeType, sealbox: sealbox).serialised() } + public func serialize(encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String { + let messageJson = try JSONEncoder().encode(encodable) + + let encoded = messageJson.base64EncodedString() + return Envelope(type: envelopeType, sealbox: sealbox).serialised() + } + + /// Deserializes and decrypts an object /// - Parameters: /// - topic: Topic that is associated with a symetric key for decrypting particular codable object diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift new file mode 100644 index 000000000..58a67a5eb --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -0,0 +1,90 @@ + +import Foundation + +actor LinkAuthRequester { + enum Errors: Error { + case invalidChain + } + private let appMetadata: AppMetadata + private let kms: KeyManagementService + private let logger: ConsoleLogging + private let iatProvader: IATProvider + private let authResponseTopicRecordsStore: CodableStore + + init(kms: KeyManagementService, + appMetadata: AppMetadata, + logger: ConsoleLogging, + iatProvader: IATProvider, + authResponseTopicRecordsStore: CodableStore) { + self.kms = kms + self.appMetadata = appMetadata + self.logger = logger + self.iatProvader = iatProvader + self.authResponseTopicRecordsStore = authResponseTopicRecordsStore + } + + func request(params: AuthRequestParams, walletUniversalLink: String) async throws { + + + var params = params + let pubKey = try kms.createX25519KeyPair() + let responseTopic = pubKey.rawRepresentation.sha256().toHexString() + let protocolMethod = SessionAuthenticatedProtocolMethod(ttl: params.ttl) + guard let chainNamespace = Blockchain(params.chains.first!)?.namespace, + chainNamespace == "eip155" + else { + throw Errors.invalidChain + } + if let methods = params.methods, + !methods.isEmpty { + let namespaceRecap = try createRecapUrn(methods: methods) + params.addResource(resource: namespaceRecap) + } + let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) + let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) + + + + let sessionAuthenticateRequestParams = SessionAuthenticateRequestParams(requester: requester, authPayload: payload, ttl: params.ttl) + let authResponseTopicRecord = AuthResponseTopicRecord(topic: responseTopic, unixTimestamp: sessionAuthenticateRequestParams.expiryTimestamp) + authResponseTopicRecordsStore.set(authResponseTopicRecord, forKey: responseTopic) + let request = RPCRequest(method: protocolMethod.method, params: sessionAuthenticateRequestParams) + try kms.setPublicKey(publicKey: pubKey, for: responseTopic) + + + + + logger.debug("LinkAuthRequester: sending request") + + } + + private func createRecapUrn(methods: [String]) throws -> String { + try AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: methods) + } +} + + +class LinkTransportInteractor { + private let serializer: Serializing + private let logger: ConsoleLogging + + init(serializer: Serializing, logger: ConsoleLogging) { + self.serializer = serializer + self.logger = logger + } + + func request(request: RPCRequest, walletUniversalLink: String) async throws { + + let message = try serializer.serialize(topic: <#T##String#>, encodable: request, envelopeType: <#T##Envelope.EnvelopeType#>) + + guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } + + + + components.queryItems = [URLQueryItem(name: "wc_envelope", value: base64EncodedRequest)] + + guard let finalURL = components.url else { throw URLError(.badURL) } + + UIApplication.shared.open(finalURL) + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 9bc4c4db5..e146ae68f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -333,6 +333,13 @@ public final class SignClient: SignClientProtocol { return pairingURI } + public func authenticateLinkMode( + _ params: AuthRequestParams, + walletUniversalLink: String + ) async throws { + + } + /// For a wallet to respond on authentication request From 0dbb3e8ac1c2c53583b37ba3aa739eac65e2fb8a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 26 Mar 2024 16:36:59 +0100 Subject: [PATCH 498/814] Add LinkTransportInteractor and type2 envelope --- .../WalletConnectKMS/Serialiser/Envelope.swift | 14 +++++++++++--- .../Serialiser/Serializer.swift | 18 ++++++++++++------ .../Serialiser/Serializing.swift | 1 + .../Auth/Link/LinkAuthRequester.swift | 12 ++++++------ 4 files changed, 30 insertions(+), 15 deletions(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index 4f08cdeb8..ecd1ad0b2 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -15,7 +15,7 @@ public struct Envelope: Equatable { /// pk = public key (32 bytes) /// iv = initialization vector (12 bytes) /// ct = ciphertext (N bytes) - /// sealbox = iv + ct + tag + /// sealbox: in case of envelope type 0 and 1: = iv + ct + tag, in case of type 2 - raw data representation of a json object /// type0: tp + sealbox /// type1: tp + pk + sealbox init(_ base64encoded: String) throws { @@ -31,7 +31,11 @@ public struct Envelope: Equatable { let pubKey = envelopeData.subdata(in: 1..<33) self.type = .type1(pubKey: pubKey) self.sealbox = envelopeData.subdata(in: 33.. String { - let messageJson = try JSONEncoder().encode(encodable) - - let encoded = messageJson.base64EncodedString() - return Envelope(type: envelopeType, sealbox: sealbox).serialised() + /// Serializes envelope type 2 + public func serializeEnvelopeType2(encodable: Encodable) throws -> String { + let messageData = try JSONEncoder().encode(encodable) + return Envelope(type: .type2, sealbox: messageData).serialised() } @@ -78,6 +77,9 @@ public class Serializer: Serializing { return (deserialisedType.object, nil, deserialisedType.data) case .type1(let peerPubKey): return try handleType1Envelope(topic, peerPubKey: peerPubKey, sealbox: envelope.sealbox) + case .type2: + let decodedType: T = try handleType2Envelope(envelope: envelope) + return (decodedType, nil, Data()) } } @@ -98,7 +100,7 @@ public class Serializer: Serializing { throw error } } - + private func handleType1Envelope(_ topic: String, peerPubKey: Data, sealbox: Data) throws -> (T, String, Data) { guard let selfPubKey = kms.getPublicKey(for: topic) else { @@ -114,6 +116,10 @@ public class Serializer: Serializing { return (decodedType.object, derivedTopic, decodedType.data) } + private func handleType2Envelope(envelope: Envelope) throws -> T { + try JSONDecoder().decode(T.self, from: envelope.sealbox) + } + private func decode(sealbox: Data, symmetricKey: Data) throws -> (T, Data) { var decryptedData = Data() print(T.self) diff --git a/Sources/WalletConnectKMS/Serialiser/Serializing.swift b/Sources/WalletConnectKMS/Serialiser/Serializing.swift index c9fc25cd2..416888083 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializing.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializing.swift @@ -4,6 +4,7 @@ import Combine public protocol Serializing { var logsPublisher: AnyPublisher {get} func setLogging(level: LoggingLevel) + func serializeEnvelopeType2(encodable: Encodable) throws -> String func serialize(topic: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key func deserialize(topic: String, encodedEnvelope: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 58a67a5eb..220c5ac09 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -63,7 +63,8 @@ actor LinkAuthRequester { } } - +#if os(iOS) +import UIKit class LinkTransportInteractor { private let serializer: Serializing private let logger: ConsoleLogging @@ -75,16 +76,15 @@ class LinkTransportInteractor { func request(request: RPCRequest, walletUniversalLink: String) async throws { - let message = try serializer.serialize(topic: <#T##String#>, encodable: request, envelopeType: <#T##Envelope.EnvelopeType#>) + let envelope = try serializer.serializeEnvelopeType2(encodable: request) guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } - - - components.queryItems = [URLQueryItem(name: "wc_envelope", value: base64EncodedRequest)] + components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] guard let finalURL = components.url else { throw URLError(.badURL) } - UIApplication.shared.open(finalURL) + await UIApplication.shared.open(finalURL) } } +#endif From 70d753d0163fc09c2471b438847d9a4421c87304 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 27 Mar 2024 09:45:34 +0100 Subject: [PATCH 499/814] savepoint --- .../Auth/Link/LinkAuthRequester.swift | 14 ++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 19 +++++++++++++++++-- 2 files changed, 31 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 220c5ac09..5affbcce0 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -88,3 +88,17 @@ class LinkTransportInteractor { } } #endif + +actor EnvelopeHandler { + private let serializer: Serializing + private let logger: ConsoleLogging + + init(serializer: Serializing, logger: ConsoleLogging) { + self.serializer = serializer + self.logger = logger + } + + func handleEnvelope(_ envelope: String) { + serializer.tryDeserialize(topic: <#T##String#>, encodedEnvelope: <#T##String#>) + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index e146ae68f..6ce971f7d 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -7,9 +7,10 @@ import Combine /// /// Access via `Sign.instance` public final class SignClient: SignClientProtocol { - + enum Errors: Error { case sessionForTopicNotFound + case linkModeUnsupported } // MARK: - Public Properties @@ -183,6 +184,10 @@ public final class SignClient: SignClientProtocol { private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private let authRequestSubscribersTracking: AuthRequestSubscribersTracking + + // Link Model + private let linkAuthRequester: LinkAuthRequester? + private var publishers = Set() // MARK: - Initialization @@ -212,7 +217,8 @@ public final class SignClient: SignClientProtocol { pendingProposalsProvider: PendingProposalsProvider, requestsExpiryWatcher: RequestsExpiryWatcher, authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService, - authRequestSubscribersTracking: AuthRequestSubscribersTracking + authRequestSubscribersTracking: AuthRequestSubscribersTracking, + linkAuthRequester: LinkAuthRequester ) { self.logger = logger self.networkingClient = networkingClient @@ -240,6 +246,7 @@ public final class SignClient: SignClientProtocol { self.requestsExpiryWatcher = requestsExpiryWatcher self.authResponseTopicResubscriptionService = authResponseTopicResubscriptionService self.authRequestSubscribersTracking = authRequestSubscribersTracking + self.linkAuthRequester = linkAuthRequester setUpConnectionObserving() setUpEnginesCallbacks() @@ -333,10 +340,18 @@ public final class SignClient: SignClientProtocol { return pairingURI } + // Link mode public func authenticateLinkMode( _ params: AuthRequestParams, walletUniversalLink: String ) async throws { + guard let linkAuthRequester = linkAuthRequester else { + throw Errors.linkModeUnsupported + } + try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) + } + + public func handleWCEnvelope(_ envelope: String) { } From fa331e2b2ef442e60dbdd6223f7706d768bc9bb2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 27 Mar 2024 11:52:03 +0100 Subject: [PATCH 500/814] savepoint --- .../Auth/Link/LinkAuthRequestSubscriber.swift | 33 ++++++++++ .../Auth/Link/LinkAuthRequester.swift | 60 ++++++++++++++++++- .../WalletConnectSign/Sign/SignClient.swift | 5 +- .../Sign/SignClientFactory.swift | 8 ++- 4 files changed, 101 insertions(+), 5 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift new file mode 100644 index 000000000..a4ea1b456 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -0,0 +1,33 @@ +import Foundation +import Combine + +class LinkAuthRequestSubscriber { + private let logger: ConsoleLogging + private let kms: KeyManagementServiceProtocol + private var publishers = [AnyCancellable]() + private let envelopesDispatcher: EnvelopesDispatcher + + var onRequest: (((request: AuthenticationRequest, context: VerifyContext?)) -> Void)? + + init( + logger: ConsoleLogging, + kms: KeyManagementServiceProtocol, + envelopesDispatcher: EnvelopesDispatcher + ) { + self.logger = logger + self.kms = kms + self.envelopesDispatcher = envelopesDispatcher + subscribeForRequest() + } + + private func subscribeForRequest() { + + envelopesDispatcher.requestSubscription(on: SessionAuthenticatedProtocolMethod().method) + .sink { [unowned self] (payload: RequestSubscriptionPayload) in + + print(payload) + }.store(in: &publishers) + + } + +} diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 5affbcce0..48df99786 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -89,16 +89,70 @@ class LinkTransportInteractor { } #endif -actor EnvelopeHandler { + + +import Combine +class EnvelopesDispatcher { private let serializer: Serializing private let logger: ConsoleLogging + private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest), Never>() + private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() + + public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest), Never> { + requestPublisherSubject.eraseToAnyPublisher() + } + + private var responsePublisher: AnyPublisher<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never> { + responsePublisherSubject.eraseToAnyPublisher() + } + init(serializer: Serializing, logger: ConsoleLogging) { self.serializer = serializer self.logger = logger } - func handleEnvelope(_ envelope: String) { - serializer.tryDeserialize(topic: <#T##String#>, encodedEnvelope: <#T##String#>) + func dispatchEnvelope(_ envelope: String, topic: String) { + manageSubscription(topic, envelope) + } + + + public func requestSubscription(on method: String) -> AnyPublisher, Never> { + return requestPublisher + .filter { rpcRequest in + return rpcRequest.request.method == method + } + .compactMap { [weak self] topic, rpcRequest in + do { + guard let id = rpcRequest.id, let request = try rpcRequest.params?.get(RequestParams.self) else { + return nil + } + return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) + } catch { + self?.logger.debug(error) + } + return nil + } + + .eraseToAnyPublisher() + } + + private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { + if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { + handleRequest(topic: topic, request: deserializedJsonRpcRequest) + } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { +// handleResponse(topic: topic, response: response, publishedAt: publishedAt, derivedTopic: derivedTopic) + } else { + logger.debug("Networking Interactor - Received unknown object type from networking relay") + } + } + + private func handleRequest(topic: String, request: RPCRequest) { + do { +// try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote) + requestPublisherSubject.send((topic, request)) + } catch { + logger.debug(error) + } } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 6ce971f7d..c28534525 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -187,6 +187,7 @@ public final class SignClient: SignClientProtocol { // Link Model private let linkAuthRequester: LinkAuthRequester? + private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber? private var publishers = Set() @@ -218,7 +219,8 @@ public final class SignClient: SignClientProtocol { requestsExpiryWatcher: RequestsExpiryWatcher, authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService, authRequestSubscribersTracking: AuthRequestSubscribersTracking, - linkAuthRequester: LinkAuthRequester + linkAuthRequester: LinkAuthRequester, + linkAuthRequestSubscriber: LinkAuthRequestSubscriber ) { self.logger = logger self.networkingClient = networkingClient @@ -247,6 +249,7 @@ public final class SignClient: SignClientProtocol { self.authResponseTopicResubscriptionService = authResponseTopicResubscriptionService self.authRequestSubscribersTracking = authRequestSubscribersTracking self.linkAuthRequester = linkAuthRequester + self.linkAuthRequestSubscriber = linkAuthRequestSubscriber setUpConnectionObserving() setUpEnginesCallbacks() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index bfbdcc6b9..0511c1e7f 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -111,7 +111,11 @@ public struct SignClientFactory { let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) + let serializer = Serializer(kms: kms, logger: logger) + let envelopesDispatcher = EnvelopesDispatcher(serializer: serializer, logger: logger) + let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore) + let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: envelopesDispatcher) let client = SignClient( logger: logger, networkingClient: networkingClient, @@ -138,7 +142,9 @@ public struct SignClientFactory { pendingProposalsProvider: pendingProposalsProvider, requestsExpiryWatcher: requestsExpiryWatcher, authResponseTopicResubscriptionService: authResponseTopicResubscriptionService, - authRequestSubscribersTracking: authRequestSubscribersTracking + authRequestSubscribersTracking: authRequestSubscribersTracking, + linkAuthRequester: linkAuthRequester, + linkAuthRequestSubscriber: linkAuthRequestSubscriber ) return client } From 89ff584af915428e1814479f549e7d9fe72a9115 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 27 Mar 2024 15:10:51 +0100 Subject: [PATCH 501/814] fix type2 envelope, add tests --- .../xcschemes/WalletConnectKMSTests.xcscheme | 54 +++++++++++++++++++ .../Sign/SignClientTests.swift | 38 +++++++++++++ .../Serialiser/Envelope.swift | 2 +- .../Serialiser/Serializer.swift | 11 +++- .../Auth/Link/LinkAuthRequestSubscriber.swift | 4 +- .../Auth/Link/LinkAuthRequester.swift | 52 +++++++++--------- .../WalletConnectSign/Sign/SignClient.swift | 15 +++--- .../Sign/SignClientFactory.swift | 8 +-- .../SerialiserTests.swift | 20 +++++++ 9 files changed, 164 insertions(+), 40 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/WalletConnectKMSTests.xcscheme diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectKMSTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectKMSTests.xcscheme new file mode 100644 index 000000000..524c3cb72 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/WalletConnectKMSTests.xcscheme @@ -0,0 +1,54 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index e67e77973..c7ef6f3c4 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1086,4 +1086,42 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } + // Link Mode + + func testLinkAuthRequest() async throws { + let responseExpectation = expectation(description: "successful response delivered") + + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in + print("💯💯💯💯💯💯💯💯💯💯") +// Task(priority: .high) { +// let signerFactory = DefaultSignerFactory() +// let signer = MessageSignerFactory(signerFactory: signerFactory).create() +// +// let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) +// +// let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) +// +// let signature = try signer.sign( +// message: siweMessage, +// privateKey: prvKey, +// type: .eip191) +// +// let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) +// +// _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) +// } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success = result else { XCTFail(); return } + responseExpectation.fulfill() + } + .store(in: &publishers) + + + let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: "") + try await wallet.dispatchEnvelope(requestEnvelope, topic: "") + await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) + } + } diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index ecd1ad0b2..0048c5bf0 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -33,7 +33,7 @@ public struct Envelope: Equatable { self.sealbox = envelopeData.subdata(in: 33..(envelope: Envelope) throws -> T { - try JSONDecoder().decode(T.self, from: envelope.sealbox) + do { + let deserialised = try JSONDecoder().decode(T.self, from: envelope.sealbox) + return deserialised + } catch { + print(error) + throw error + } } private func decode(sealbox: Data, symmetricKey: Data) throws -> (T, Data) { diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift index a4ea1b456..fe9a6fd7e 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -5,14 +5,14 @@ class LinkAuthRequestSubscriber { private let logger: ConsoleLogging private let kms: KeyManagementServiceProtocol private var publishers = [AnyCancellable]() - private let envelopesDispatcher: EnvelopesDispatcher + private let envelopesDispatcher: LinkEnvelopesDispatcher var onRequest: (((request: AuthenticationRequest, context: VerifyContext?)) -> Void)? init( logger: ConsoleLogging, kms: KeyManagementServiceProtocol, - envelopesDispatcher: EnvelopesDispatcher + envelopesDispatcher: LinkEnvelopesDispatcher ) { self.logger = logger self.kms = kms diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 48df99786..e7f68ff98 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -10,22 +10,26 @@ actor LinkAuthRequester { private let logger: ConsoleLogging private let iatProvader: IATProvider private let authResponseTopicRecordsStore: CodableStore + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher init(kms: KeyManagementService, appMetadata: AppMetadata, logger: ConsoleLogging, iatProvader: IATProvider, - authResponseTopicRecordsStore: CodableStore) { + authResponseTopicRecordsStore: CodableStore, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher) { self.kms = kms self.appMetadata = appMetadata self.logger = logger self.iatProvader = iatProvader self.authResponseTopicRecordsStore = authResponseTopicRecordsStore + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher } - func request(params: AuthRequestParams, walletUniversalLink: String) async throws { + func request(params: AuthRequestParams, walletUniversalLink: String) async throws -> String { + print("LinkAuthRequester: creating request") var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() @@ -56,6 +60,8 @@ actor LinkAuthRequester { logger.debug("LinkAuthRequester: sending request") + return try await linkEnvelopesDispatcher.request(request: request, walletUniversalLink: walletUniversalLink) + } private func createRecapUrn(methods: [String]) throws -> String { @@ -65,34 +71,10 @@ actor LinkAuthRequester { #if os(iOS) import UIKit -class LinkTransportInteractor { - private let serializer: Serializing - private let logger: ConsoleLogging - - init(serializer: Serializing, logger: ConsoleLogging) { - self.serializer = serializer - self.logger = logger - } - - func request(request: RPCRequest, walletUniversalLink: String) async throws { - - let envelope = try serializer.serializeEnvelopeType2(encodable: request) - - guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } - - components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] - - guard let finalURL = components.url else { throw URLError(.badURL) } - - await UIApplication.shared.open(finalURL) - } -} -#endif - import Combine -class EnvelopesDispatcher { +class LinkEnvelopesDispatcher { private let serializer: Serializing private let logger: ConsoleLogging @@ -116,6 +98,21 @@ class EnvelopesDispatcher { manageSubscription(topic, envelope) } + func request(request: RPCRequest, walletUniversalLink: String) async throws -> String { + + let envelope = try serializer.serializeEnvelopeType2(encodable: request) + + guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } + + components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] + + guard let finalURL = components.url else { throw URLError(.badURL) } + + +// await UIApplication.shared.open(finalURL) + return finalURL.absoluteString + } + public func requestSubscription(on method: String) -> AnyPublisher, Never> { return requestPublisher @@ -156,3 +153,4 @@ class EnvelopesDispatcher { } } } +#endif diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index c28534525..2fe687aa2 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -188,6 +188,7 @@ public final class SignClient: SignClientProtocol { // Link Model private let linkAuthRequester: LinkAuthRequester? private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber? + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private var publishers = Set() @@ -220,7 +221,8 @@ public final class SignClient: SignClientProtocol { authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService, authRequestSubscribersTracking: AuthRequestSubscribersTracking, linkAuthRequester: LinkAuthRequester, - linkAuthRequestSubscriber: LinkAuthRequestSubscriber + linkAuthRequestSubscriber: LinkAuthRequestSubscriber, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher ) { self.logger = logger self.networkingClient = networkingClient @@ -250,6 +252,7 @@ public final class SignClient: SignClientProtocol { self.authRequestSubscribersTracking = authRequestSubscribersTracking self.linkAuthRequester = linkAuthRequester self.linkAuthRequestSubscriber = linkAuthRequestSubscriber + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher setUpConnectionObserving() setUpEnginesCallbacks() @@ -344,18 +347,18 @@ public final class SignClient: SignClientProtocol { } // Link mode - public func authenticateLinkMode( + @discardableResult public func authenticateLinkMode( _ params: AuthRequestParams, walletUniversalLink: String - ) async throws { + ) async throws -> String { guard let linkAuthRequester = linkAuthRequester else { throw Errors.linkModeUnsupported } - try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) + return try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) } - public func handleWCEnvelope(_ envelope: String) { - + public func dispatchEnvelope(_ envelope: String, topic: String) { + linkEnvelopesDispatcher.dispatchEnvelope(envelope, topic: topic) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 0511c1e7f..bf92e2645 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -113,8 +113,9 @@ public struct SignClientFactory { let serializer = Serializer(kms: kms, logger: logger) - let envelopesDispatcher = EnvelopesDispatcher(serializer: serializer, logger: logger) - let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore) + let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger) + let envelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger) + let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: envelopesDispatcher) let client = SignClient( logger: logger, @@ -144,7 +145,8 @@ public struct SignClientFactory { authResponseTopicResubscriptionService: authResponseTopicResubscriptionService, authRequestSubscribersTracking: authRequestSubscribersTracking, linkAuthRequester: linkAuthRequester, - linkAuthRequestSubscriber: linkAuthRequestSubscriber + linkAuthRequestSubscriber: linkAuthRequestSubscriber, + linkEnvelopesDispatcher: linkEnvelopesDispatcher ) return client } diff --git a/Tests/WalletConnectKMSTests/SerialiserTests.swift b/Tests/WalletConnectKMSTests/SerialiserTests.swift index bf36da69d..3280e65aa 100644 --- a/Tests/WalletConnectKMSTests/SerialiserTests.swift +++ b/Tests/WalletConnectKMSTests/SerialiserTests.swift @@ -42,4 +42,24 @@ final class SerializerTests: XCTestCase { let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, encodedEnvelope: serializedMessage)! XCTAssertEqual(messageToSerialize, deserializedMessage) } + + func testSerializeDeserializeType2Envelope() { + + let messageToSerialize = "todo - change for request object" + + // Serialize the sample object with Type 2 envelope + guard let serializedMessage = try? mySerializer.serializeEnvelopeType2(encodable: messageToSerialize) else { + XCTFail("Serialization failed for Type 2 envelope.") + return + } + + // Deserialize the serialized message back into the original object + guard let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: "", encodedEnvelope: serializedMessage) else { + XCTFail("Deserialization failed for Type 2 envelope.") + return + } + + XCTAssertEqual(messageToSerialize, deserializedMessage) + } + } From 2cacba82a8bf75ca560563fc66785369c6d45889 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 27 Mar 2024 15:39:38 +0100 Subject: [PATCH 502/814] deserialise type2 envelope in integ test --- .../Auth/Link/LinkAuthRequester.swift | 16 ++++++++++++++-- Sources/WalletConnectSign/Sign/SignClient.swift | 4 ++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index e7f68ff98..744a967ac 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -75,6 +75,9 @@ import UIKit import Combine class LinkEnvelopesDispatcher { + enum Errors: Error { + case invalidURL + } private let serializer: Serializing private let logger: ConsoleLogging @@ -94,8 +97,17 @@ class LinkEnvelopesDispatcher { self.logger = logger } - func dispatchEnvelope(_ envelope: String, topic: String) { - manageSubscription(topic, envelope) + func dispatchEnvelope(_ envelope: String, topic: String) throws { + guard let envelopeURL = URL(string: envelope) else { + throw Errors.invalidURL + } + + // Use URLComponents to parse the URL for query items + guard let components = URLComponents(url: envelopeURL, resolvingAgainstBaseURL: true), + let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { + throw Errors.invalidURL + } + manageSubscription(topic, wcEnvelope) } func request(request: RPCRequest, walletUniversalLink: String) async throws -> String { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 2fe687aa2..7e0e3d804 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -357,8 +357,8 @@ public final class SignClient: SignClientProtocol { return try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) } - public func dispatchEnvelope(_ envelope: String, topic: String) { - linkEnvelopesDispatcher.dispatchEnvelope(envelope, topic: topic) + public func dispatchEnvelope(_ envelope: String, topic: String) throws { + try linkEnvelopesDispatcher.dispatchEnvelope(envelope, topic: topic) } From de9a79061d0a6db7076adbbb239c89f21c6b7e8b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 08:44:58 +0100 Subject: [PATCH 503/814] fix multiple instances of envelope dispatcher --- .../WalletConnectSign/Auth/Link/LinkAuthRequester.swift | 7 +++++++ Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 3 +-- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 744a967ac..bf9954976 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -80,6 +80,8 @@ class LinkEnvelopesDispatcher { } private let serializer: Serializing private let logger: ConsoleLogging + private var publishers = Set() + private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest), Never>() private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() @@ -95,6 +97,11 @@ class LinkEnvelopesDispatcher { init(serializer: Serializing, logger: ConsoleLogging) { self.serializer = serializer self.logger = logger + + requestPublisher.sink { (topic: String, request: RPCRequest) in + print(request) +//todo to remove this subscription and publisheers + }.store(in: &publishers) } func dispatchEnvelope(_ envelope: String, topic: String) throws { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 7e0e3d804..ec4bab273 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -187,7 +187,7 @@ public final class SignClient: SignClientProtocol { // Link Model private let linkAuthRequester: LinkAuthRequester? - private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber? + private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private var publishers = Set() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index bf92e2645..da4f5a76f 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -114,9 +114,8 @@ public struct SignClientFactory { let serializer = Serializer(kms: kms, logger: logger) let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger) - let envelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger) let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) - let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: envelopesDispatcher) + let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher) let client = SignClient( logger: logger, networkingClient: networkingClient, From 07b6cd277feac421e485f154ac8a8f269a893bd2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 08:57:59 +0100 Subject: [PATCH 504/814] authenticateRequestPublisher connected --- .../Auth/Link/LinkAuthRequestSubscriber.swift | 13 ++++++++++++- Sources/WalletConnectSign/Sign/SignClient.swift | 3 +++ 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift index fe9a6fd7e..f8f651ee7 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -25,7 +25,18 @@ class LinkAuthRequestSubscriber { envelopesDispatcher.requestSubscription(on: SessionAuthenticatedProtocolMethod().method) .sink { [unowned self] (payload: RequestSubscriptionPayload) in - print(payload) + logger.debug("LinkAuthRequestSubscriber: Received request") + + + let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.authPayload, requester: payload.request.requester.metadata) + + + // TODO fix verify context + + let verifyContext = VerifyContext(origin: "", validation: .valid) + + onRequest?((request, verifyContext)) + }.store(in: &publishers) } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index ec4bab273..83c4534b5 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -568,6 +568,9 @@ public final class SignClient: SignClientProtocol { authRequestSubscriber.onRequest = { [unowned self] request in authRequestPublisherSubject.send(request) } + linkAuthRequestSubscriber.onRequest = { [unowned self] request in + authRequestPublisherSubject.send(request) + } } private func setUpConnectionObserving() { From 135c60b33770f0d83ecb342f395c50b48ca85180 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 10:11:11 +0100 Subject: [PATCH 505/814] savepoint --- .../Sign/SignClientTests.swift | 37 +++--- .../NetworkingInteractor.swift | 4 +- Sources/WalletConnectRelay/RelayClient.swift | 2 +- ...ApproveSessionAuthenticateDispatcher.swift | 25 +++++ .../Auth/Link/LinkAuthRequestSubscriber.swift | 2 +- .../Auth/Link/LinkAuthRequester.swift | 105 ----------------- .../Auth/Link/LinkEnvelopesDispatcher.swift | 106 ++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 2 +- .../Sign/SignClientFactory.swift | 2 +- .../RPCHistory/RPCHistory.swift | 9 +- 10 files changed, 162 insertions(+), 132 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift create mode 100644 Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index c7ef6f3c4..820957194 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1003,7 +1003,7 @@ final class SignClientTests: XCTestCase { guard case .success(let (session, _)) = result, let session = session else { XCTFail(); return } Task(priority: .high) { - let request = try Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: chain) + let request = try Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: Blockchain("eip155:1")!) try await dapp.request(params: request) } } @@ -1092,24 +1092,23 @@ final class SignClientTests: XCTestCase { let responseExpectation = expectation(description: "successful response delivered") wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in - print("💯💯💯💯💯💯💯💯💯💯") -// Task(priority: .high) { -// let signerFactory = DefaultSignerFactory() -// let signer = MessageSignerFactory(signerFactory: signerFactory).create() -// -// let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) -// -// let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) -// -// let signature = try signer.sign( -// message: siweMessage, -// privateKey: prvKey, -// type: .eip191) -// -// let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) -// -// _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) -// } + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create() + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) + + let signature = try signer.sign( + message: siweMessage, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) + + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + } } .store(in: &publishers) dapp.authResponsePublisher.sink { (_, result) in diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index d086b8db8..a8ad1b80a 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -201,7 +201,7 @@ public class NetworkingInteractor: NetworkInteracting { } public func request(_ request: RPCRequest, topic: String, protocolMethod: ProtocolMethod, envelopeType: Envelope.EnvelopeType) async throws { - try rpcHistory.set(request, forTopic: topic, emmitedBy: .local) + try rpcHistory.set(request, forTopic: topic, emmitedBy: .local, transportType: .relay) do { let message = try serializer.serialize(topic: topic, encodable: request, envelopeType: envelopeType) @@ -257,7 +257,7 @@ public class NetworkingInteractor: NetworkInteracting { private func handleRequest(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?) { do { - try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote) + try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote, transportType: .relay) requestPublisherSubject.send((topic, request, decryptedPayload, publishedAt, derivedTopic)) } catch { logger.debug(error) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index c3146adc3..503be7a14 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -223,7 +223,7 @@ public final class RelayClient { if let params = try? request.params?.get(Subscription.Params.self) { do { try acknowledgeRequest(request) - try rpcHistory.set(request, forTopic: params.data.topic, emmitedBy: .remote) + try rpcHistory.set(request, forTopic: params.data.topic, emmitedBy: .remote, transportType: .relay) logger.debug("received message: \(params.data.message) on topic: \(params.data.topic)") messagePublisherSubject.send((params.data.topic, params.data.message, params.data.publishedAt)) } catch { diff --git a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift new file mode 100644 index 000000000..a175f7be8 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift @@ -0,0 +1,25 @@ +//import Foundation +// +//actor ApproveSessionAuthenticateDispatcher { +// +// +// private let authResponder: AuthResponder +// private let logger: ConsoleLogging +// private let rpcHistory: RPCHistory +// +// init( +// authResponder: AuthResponder, +// logger: ConsoleLogging, +// rpcHistory: RPCHistory +// ) { +// self.authResponder = authResponder +// self.logger = logger +// self.rpcHistory = rpcHistory +// } +// +// public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { +// +// +// try await authResponder.respond(requestId: requestId, auths: auths) +// } +//} diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift index f8f651ee7..c78762090 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -34,7 +34,7 @@ class LinkAuthRequestSubscriber { // TODO fix verify context let verifyContext = VerifyContext(origin: "", validation: .valid) - + onRequest?((request, verifyContext)) }.store(in: &publishers) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index bf9954976..fef0cdfb5 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -68,108 +68,3 @@ actor LinkAuthRequester { try AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: methods) } } - -#if os(iOS) -import UIKit - - -import Combine -class LinkEnvelopesDispatcher { - enum Errors: Error { - case invalidURL - } - private let serializer: Serializing - private let logger: ConsoleLogging - private var publishers = Set() - - - private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest), Never>() - private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() - - public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest), Never> { - requestPublisherSubject.eraseToAnyPublisher() - } - - private var responsePublisher: AnyPublisher<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never> { - responsePublisherSubject.eraseToAnyPublisher() - } - - init(serializer: Serializing, logger: ConsoleLogging) { - self.serializer = serializer - self.logger = logger - - requestPublisher.sink { (topic: String, request: RPCRequest) in - print(request) -//todo to remove this subscription and publisheers - }.store(in: &publishers) - } - - func dispatchEnvelope(_ envelope: String, topic: String) throws { - guard let envelopeURL = URL(string: envelope) else { - throw Errors.invalidURL - } - - // Use URLComponents to parse the URL for query items - guard let components = URLComponents(url: envelopeURL, resolvingAgainstBaseURL: true), - let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { - throw Errors.invalidURL - } - manageSubscription(topic, wcEnvelope) - } - - func request(request: RPCRequest, walletUniversalLink: String) async throws -> String { - - let envelope = try serializer.serializeEnvelopeType2(encodable: request) - - guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } - - components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] - - guard let finalURL = components.url else { throw URLError(.badURL) } - - -// await UIApplication.shared.open(finalURL) - return finalURL.absoluteString - } - - - public func requestSubscription(on method: String) -> AnyPublisher, Never> { - return requestPublisher - .filter { rpcRequest in - return rpcRequest.request.method == method - } - .compactMap { [weak self] topic, rpcRequest in - do { - guard let id = rpcRequest.id, let request = try rpcRequest.params?.get(RequestParams.self) else { - return nil - } - return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) - } catch { - self?.logger.debug(error) - } - return nil - } - - .eraseToAnyPublisher() - } - - private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { - if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { - handleRequest(topic: topic, request: deserializedJsonRpcRequest) - } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { -// handleResponse(topic: topic, response: response, publishedAt: publishedAt, derivedTopic: derivedTopic) - } else { - logger.debug("Networking Interactor - Received unknown object type from networking relay") - } - } - - private func handleRequest(topic: String, request: RPCRequest) { - do { -// try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote) - requestPublisherSubject.send((topic, request)) - } catch { - logger.debug(error) - } - } -} -#endif diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift new file mode 100644 index 000000000..395e36b13 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -0,0 +1,106 @@ + +#if os(iOS) +import UIKit + + +import Combine +class LinkEnvelopesDispatcher { + enum Errors: Error { + case invalidURL + } + private let serializer: Serializing + private let logger: ConsoleLogging + private var publishers = Set() + private let rpcHistory: RPCHistory + + + private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest), Never>() + private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() + + public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest), Never> { + requestPublisherSubject.eraseToAnyPublisher() + } + + private var responsePublisher: AnyPublisher<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never> { + responsePublisherSubject.eraseToAnyPublisher() + } + + init( + serializer: Serializing, + logger: ConsoleLogging, + rpcHistory: RPCHistory + ) { + self.serializer = serializer + self.logger = logger + self.rpcHistory = rpcHistory + } + + func dispatchEnvelope(_ envelope: String, topic: String) throws { + guard let envelopeURL = URL(string: envelope) else { + throw Errors.invalidURL + } + + // Use URLComponents to parse the URL for query items + guard let components = URLComponents(url: envelopeURL, resolvingAgainstBaseURL: true), + let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { + throw Errors.invalidURL + } + manageSubscription(topic, wcEnvelope) + } + + func request(request: RPCRequest, walletUniversalLink: String) async throws -> String { + + let envelope = try serializer.serializeEnvelopeType2(encodable: request) + + guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } + + components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] + + guard let finalURL = components.url else { throw URLError(.badURL) } + + +// await UIApplication.shared.open(finalURL) + return finalURL.absoluteString + } + + + public func requestSubscription(on method: String) -> AnyPublisher, Never> { + return requestPublisher + .filter { rpcRequest in + return rpcRequest.request.method == method + } + .compactMap { [weak self] topic, rpcRequest in + do { + guard let id = rpcRequest.id, let request = try rpcRequest.params?.get(RequestParams.self) else { + return nil + } + return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) + } catch { + self?.logger.debug(error) + } + return nil + } + + .eraseToAnyPublisher() + } + + private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { + if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { + handleRequest(topic: topic, request: deserializedJsonRpcRequest) + } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { +// handleResponse(topic: topic, response: response, publishedAt: publishedAt, derivedTopic: derivedTopic) + } else { + logger.debug("Networking Interactor - Received unknown object type from networking relay") + } + } + + private func handleRequest(topic: String, request: RPCRequest) { + do { + try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote, transportType: .linkMode) + requestPublisherSubject.send((topic, request)) + } catch { + logger.debug(error) + } + } +} +#endif diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 83c4534b5..c0f5c047f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -185,7 +185,7 @@ public final class SignClient: SignClientProtocol { private let authRequestSubscribersTracking: AuthRequestSubscribersTracking - // Link Model + // Link Mode private let linkAuthRequester: LinkAuthRequester? private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index da4f5a76f..9cbafec80 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -113,7 +113,7 @@ public struct SignClientFactory { let serializer = Serializer(kms: kms, logger: logger) - let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger) + let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger, rpcHistory: rpcHistory) let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher) let client = SignClient( diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index ff6bda280..c5a9741a9 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -7,12 +7,17 @@ public final class RPCHistory { case local case remote } + public enum TransportType: Codable { + case relay + case linkMode + } public let id: RPCID public let topic: String let origin: Origin public let request: RPCRequest public let response: RPCResponse? public var timestamp: Date? + public let transportType: TransportType } enum HistoryError: Error, LocalizedError { @@ -50,14 +55,14 @@ public final class RPCHistory { try? storage.get(key: recordId.string) } - public func set(_ request: RPCRequest, forTopic topic: String, emmitedBy origin: Record.Origin, time: TimeProvider = DefaultTimeProvider()) throws { + public func set(_ request: RPCRequest, forTopic topic: String, emmitedBy origin: Record.Origin, time: TimeProvider = DefaultTimeProvider(), transportType: RPCHistory.Record.TransportType) throws { guard let id = request.id else { throw HistoryError.unidentifiedRequest } guard get(recordId: id) == nil else { throw HistoryError.requestDuplicateNotAllowed } - let record = Record(id: id, topic: topic, origin: origin, request: request, response: nil, timestamp: time.currentDate) + let record = Record(id: id, topic: topic, origin: origin, request: request, response: nil, timestamp: time.currentDate, transportType: transportType) storage.set(record, forKey: "\(record.id)") } From ffdc0673605f5a6987de4b50aa8f3cd0c5c98353 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 11:32:23 +0100 Subject: [PATCH 506/814] savepoint --- .../Sign/SignClientTests.swift | 69 +++++++++++++++++++ .../Services/SessionNamespaceBuilder.swift | 22 ++++-- .../SessionNamespaceBuilderTests.swift | 27 +++++++- 3 files changed, 111 insertions(+), 7 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index e67e77973..c695a9365 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1036,6 +1036,75 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } + + func testSessionRequestOnAuthenticatedSessionForAChainNotIncludedInCacao() async throws { + let requestExpectation = expectation(description: "Wallet expects to receive a request") + let responseExpectation = expectation(description: "Dapp expects to receive a response") + + let requestMethod = "eth_sendTransaction" + let requestParams = [EthSendTransaction.stub()] + let responseParams = "0xdeadbeef" + let chain = Blockchain("eip155:1")! + // sleep is needed as emitRequestIfPending() will be called on client init and then on request itself, second request would be debouced + sleep(1) + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create() + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_sendTransaction", "personal_sign"]) + + let signingAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: signingAccount) + + let signature = try! signer.sign( + message: siweMessage, + privateKey: prvKey, + type: .eip191) + + let cacao = try! wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) + + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [cacao]) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { [unowned self] (_, result) in + guard case .success(let (session, _)) = result, + let session = session else { XCTFail(); return } + Task(priority: .high) { + let request = try Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: Blockchain("eip155:137")!) + try await dapp.request(params: request) + } + } + .store(in: &publishers) + + wallet.sessionRequestPublisher.sink { [unowned self] (sessionRequest, _) in + let receivedParams = try! sessionRequest.params.get([EthSendTransaction].self) + XCTAssertEqual(receivedParams, requestParams) + XCTAssertEqual(sessionRequest.method, requestMethod) + requestExpectation.fulfill() + Task(priority: .high) { + try await wallet.respond(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(AnyCodable(responseParams))) + } + }.store(in: &publishers) + + dapp.sessionResponsePublisher.sink { response in + switch response.result { + case .response(let response): + XCTAssertEqual(try! response.get(String.self), responseParams) + case .error: + XCTFail() + } + responseExpectation.fulfill() + }.store(in: &publishers) + + + let uri = try await dapp.authenticate(AuthRequestParams.stub(chains: ["eip155:1", "eip155:137"])) + + try await walletPairingClient.pair(uri: uri) + await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) + } + func testFalbackForm_2_5_DappToSessionProposeOnWallet() async throws { let fallbackExpectation = expectation(description: "fallback to wc_sessionPropose") diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index ddb897788..3e1931910 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -33,17 +33,27 @@ class SessionNamespaceBuilder { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - let accounts = cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account } - let accountsSet = accounts - let methods = firstRecapResource.methods let chains = firstRecapResource.chains - let events: Set = ["chainChanged", "accountsChanged"] - guard !chains.isEmpty else { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - let sessionNamespace = SessionNamespace(chains: chains, accounts: accountsSet, methods: methods, events: events) + let addresses = Set(cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account.address }) + var accounts = [Account]() + + for address in addresses { + for chain in chains { + if let account = Account(blockchain: chain, address: address) { + accounts.append(account) + } + } + } + + let methods = firstRecapResource.methods + let events: Set = ["chainChanged", "accountsChanged"] + + let sessionNamespace = SessionNamespace(chains: chains, accounts: accounts, methods: methods, events: events) return [chainsNamespace: sessionNamespace] } + } diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index 21928efc4..269732c3b 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -37,6 +37,30 @@ class SessionNamespaceBuilderTests: XCTestCase { super.tearDown() } + func testBuildSessionNamespaces_ValidOneCacao_ReturnsExpectedNamespaceWithMultipleAccounts() { + let expectedSessionNamespace = SessionNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], + accounts: [ + Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, + Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! + ], + methods: Set(["personal_sign", "eth_signTypedData", "eth_sign"]), + events: Set(["chainChanged", "accountsChanged"]) + ) + + let cacaos = [ + Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]), + ] + + do { + let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: cacaos) + XCTAssertTrue(namespaces.first!.value.events.isSuperset(of: ["chainChanged", "accountsChanged"]), "Contains required events") + XCTAssertEqual(namespaces.count, 1, "There should be one namespace") + XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") + } catch { + XCTFail("Expected successful namespace creation, but received error: \(error)") + } + } func testBuildSessionNamespaces_ValidCacaos_ReturnsExpectedNamespace() { let expectedSessionNamespace = SessionNamespace( @@ -69,7 +93,8 @@ class SessionNamespaceBuilderTests: XCTestCase { let expectedSessionNamespace = SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], accounts: [ - Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! + Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, + Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! ], methods: ["personal_sign", "eth_signTypedData", "eth_sign"], events: ["chainChanged", "accountsChanged"] From c00980277b2f58aaa037320dc1088ba4acfb1803 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 11:40:44 +0100 Subject: [PATCH 507/814] add test --- .../SessionNamespaceBuilderTests.swift | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index 269732c3b..d441cafb1 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -62,6 +62,34 @@ class SessionNamespaceBuilderTests: XCTestCase { } } + func testBuildSessionNamespaces_ValidOneCacaos_ReturnsExpectedNamespaceWithMultipleAccountsForDifferentAddresses() { + let expectedSessionNamespace = SessionNamespace( + chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], + accounts: [ + Account("eip155:1:0x990a10343Bcdebe21283c7172d67a9a113E819X5")!, + Account("eip155:137:0x990a10343Bcdebe21283c7172d67a9a113E819X5")!, + Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, + Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! + ], + methods: Set(["personal_sign", "eth_signTypedData", "eth_sign"]), + events: Set(["chainChanged", "accountsChanged"]) + ) + + let cacaos = [ + Cacao.stub(account: Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, resources: [recapUrn]), + Cacao.stub(account: Account("eip155:1:0x990a10343Bcdebe21283c7172d67a9a113E819X5")!, resources: [recapUrn]) + ] + + do { + let namespaces = try sessionNamespaceBuilder.buildSessionNamespaces(cacaos: cacaos) + XCTAssertTrue(namespaces.first!.value.events.isSuperset(of: ["chainChanged", "accountsChanged"]), "Contains required events") + XCTAssertEqual(namespaces.count, 1, "There should be one namespace") + XCTAssertEqual(expectedSessionNamespace, namespaces.first!.value, "The namespace is equal to the expected one") + } catch { + XCTFail("Expected successful namespace creation, but received error: \(error)") + } + } + func testBuildSessionNamespaces_ValidCacaos_ReturnsExpectedNamespace() { let expectedSessionNamespace = SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], From bf8e7d95ffc49a7f1b17dfa40459d660fef6c535 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 28 Mar 2024 10:59:56 +0000 Subject: [PATCH 508/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index e7257d299..b14d280bf 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.2"} +{"version": "1.18.3"} From ae416f60485ba5eb474ad1b517ebaa13095381af Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 12:26:02 +0100 Subject: [PATCH 509/814] update sample app --- .../AuthRequest/AuthRequestPresenter.swift | 54 ++++++++++++++++ .../Wallet/AuthRequest/AuthRequestView.swift | 62 ++++++++++++++----- 2 files changed, 101 insertions(+), 15 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 01813b92f..8b8626aa0 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -5,6 +5,9 @@ import Web3Wallet import WalletConnectRouter final class AuthRequestPresenter: ObservableObject { + enum Errors: Error { + case noCommonChains + } private let router: AuthRequestRouter let importAccount: ImportAccount @@ -73,6 +76,30 @@ final class AuthRequestPresenter: ObservableObject { } } + @MainActor + func signOne() async { + do { + ActivityIndicatorManager.shared.start() + + let auths = try buildOneAuthObject() + + _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) + ActivityIndicatorManager.shared.stop() + + /* Redirect */ + if let uri = request.requester.redirect?.native { + WalletConnectRouter.goBack(uri: uri) + router.dismiss() + } else { + showSignedSheet.toggle() + } + + } catch { + ActivityIndicatorManager.shared.stop() + AlertPresenter.present(message: error.localizedDescription, type: .error) + } + } + @MainActor func reject() async { ActivityIndicatorManager.shared.start() @@ -99,6 +126,33 @@ final class AuthRequestPresenter: ObservableObject { } private func buildAuthObjects() throws -> [AuthObject] { + + guard let chain = getCommonAndRequestedChainsIntersection().first else { + throw Errors.noCommonChains + } + + let account = Account(blockchain: chain, address: importAccount.account.address)! + + var supportedAuthPayload: AuthPayload! + do { + supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) + } catch { + Task { await reject() } + throw error + } + let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) + + let signature = try messageSigner.sign( + message: SIWEmessages, + privateKey: Data(hex: importAccount.privateKey), + type: .eip191) + + let auth = try Web3Wallet.instance.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: account) + + return [auth] + } + + private func buildOneAuthObject() throws -> [AuthObject] { var auths = [AuthObject]() try getCommonAndRequestedChainsIntersection().forEach { chain in diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift index e2b81cd20..73ce87bc6 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift @@ -93,20 +93,8 @@ struct AuthRequestView: View { } } - if case .scam = presenter.validationStatus { - VStack(spacing: 20) { - declineButton() - allowButton() - } - .padding(.top, 25) - } else { - HStack { - declineButton() - allowButton() - } - .padding(.top, 25) - } - + buttonGroup() + } .padding(20) @@ -241,7 +229,7 @@ struct AuthRequestView: View { presenter.approve() } } label: { - Text(presenter.validationStatus == .scam ? "Proceed anyway" : "Allow") + Text(presenter.validationStatus == .scam ? "Proceed anyway" : "Sign Multi") .frame(maxWidth: .infinity) .foregroundColor(presenter.validationStatus == .scam ? .grey50 : .white) .font(.system(size: 20, weight: .semibold, design: .rounded)) @@ -265,6 +253,50 @@ struct AuthRequestView: View { } .shadow(color: .white.opacity(0.25), radius: 8, y: 2) } + + private func signOneButton() -> some View { + Button { + Task(priority: .userInitiated) { + await presenter.signOne() + } + } label: { + Text("Sign One") + .frame(maxWidth: .infinity) + .foregroundColor(.white) + .font(.system(size: 20, weight: .semibold, design: .rounded)) + .padding(.vertical, 11) + .background( + LinearGradient( + gradient: Gradient(colors: [.blue, .purple]), // Example gradient, adjust as needed + startPoint: .top, endPoint: .bottom + ) + ) + .cornerRadius(20) + } + .shadow(color: .white.opacity(0.25), radius: 8, y: 2) + } + + // Adjusted layout to include the signOneButton + private func buttonGroup() -> some View { + Group { + if case .scam = presenter.validationStatus { + VStack(spacing: 20) { + declineButton() + signOneButton() // Place the "Sign One" button between "Decline" and "Allow" + allowButton() + } + .padding(.top, 25) + } else { + HStack { + declineButton() + signOneButton() // Include the "Sign One" button in the horizontal stack + allowButton() + } + .padding(.top, 25) + } + } + } + } #if DEBUG From 45bdb0670c01ae3dd1da8756ac2d415b76d5295b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 13:06:11 +0100 Subject: [PATCH 510/814] update --- .../AuthRequest/AuthRequestPresenter.swift | 51 ++++++------------- 1 file changed, 15 insertions(+), 36 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 8b8626aa0..131546b82 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -125,30 +125,26 @@ final class AuthRequestPresenter: ObservableObject { router.dismiss() } - private func buildAuthObjects() throws -> [AuthObject] { - - guard let chain = getCommonAndRequestedChainsIntersection().first else { - throw Errors.noCommonChains - } - + private func createAuthObjectForChain(chain: Blockchain) throws -> AuthObject { let account = Account(blockchain: chain, address: importAccount.account.address)! - var supportedAuthPayload: AuthPayload! - do { - supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) - } catch { - Task { await reject() } - throw error - } + let supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) + let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) - let signature = try messageSigner.sign( - message: SIWEmessages, - privateKey: Data(hex: importAccount.privateKey), - type: .eip191) + let signature = try messageSigner.sign(message: SIWEmessages, privateKey: Data(hex: importAccount.privateKey), type: .eip191) let auth = try Web3Wallet.instance.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: account) + return auth + } + + private func buildAuthObjects() throws -> [AuthObject] { + guard let chain = getCommonAndRequestedChainsIntersection().first else { + throw Errors.noCommonChains + } + + let auth = try createAuthObjectForChain(chain: chain) return [auth] } @@ -156,30 +152,13 @@ final class AuthRequestPresenter: ObservableObject { var auths = [AuthObject]() try getCommonAndRequestedChainsIntersection().forEach { chain in - - let account = Account(blockchain: chain, address: importAccount.account.address)! - - var supportedAuthPayload: AuthPayload! - do { - supportedAuthPayload = try Web3Wallet.instance.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!, Blockchain("eip155:69")!], supportedMethods: ["personal_sign", "eth_sendTransaction"]) - } catch { - Task { await reject() } - throw error - } - let SIWEmessages = try Web3Wallet.instance.formatAuthMessage(payload: supportedAuthPayload, account: account) - - let signature = try messageSigner.sign( - message: SIWEmessages, - privateKey: Data(hex: importAccount.privateKey), - type: .eip191) - - let auth = try Web3Wallet.instance.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: account) - + let auth = try createAuthObjectForChain(chain: chain) auths.append(auth) } return auths } + func getCommonAndRequestedChainsIntersection() -> Set { let requestedChains: Set = Set(request.payload.chains.compactMap { Blockchain($0) }) let supportedChains: Set = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] From 80d7eebb9e22dea46a7d389d15aad9f418bd5db6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 28 Mar 2024 14:48:08 +0100 Subject: [PATCH 511/814] fix addresses order --- .../Auth/Services/SessionNamespaceBuilder.swift | 15 ++++++++++++++- .../SessionNamespaceBuilderTests.swift | 6 +++--- 2 files changed, 17 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift index 3e1931910..343a66934 100644 --- a/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SessionNamespaceBuilder.swift @@ -38,7 +38,7 @@ class SessionNamespaceBuilder { throw Errors.cannotCreateSessionNamespaceFromTheRecap } - let addresses = Set(cacaos.compactMap { try? DIDPKH(did: $0.p.iss).account.address }) + let addresses = getUniqueAddresses(from: cacaos) var accounts = [Account]() for address in addresses { @@ -56,4 +56,17 @@ class SessionNamespaceBuilder { return [chainsNamespace: sessionNamespace] } + func getUniqueAddresses(from cacaos: [Cacao]) -> [String] { + var seenAddresses = Set() + var uniqueAddresses = [String]() + + for cacao in cacaos { + if let address = try? DIDPKH(did: cacao.p.iss).account.address, !seenAddresses.contains(address) { + uniqueAddresses.append(address) + seenAddresses.insert(address) + } + } + return uniqueAddresses + } + } diff --git a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift index d441cafb1..aadfd436c 100644 --- a/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SessionNamespaceBuilderTests.swift @@ -66,10 +66,10 @@ class SessionNamespaceBuilderTests: XCTestCase { let expectedSessionNamespace = SessionNamespace( chains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], accounts: [ - Account("eip155:1:0x990a10343Bcdebe21283c7172d67a9a113E819X5")!, - Account("eip155:137:0x990a10343Bcdebe21283c7172d67a9a113E819X5")!, Account("eip155:1:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, - Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")! + Account("eip155:137:0x000a10343Bcdebe21283c7172d67a9a113E819C5")!, + Account("eip155:1:0x990a10343Bcdebe21283c7172d67a9a113E819X5")!, + Account("eip155:137:0x990a10343Bcdebe21283c7172d67a9a113E819X5")! ], methods: Set(["personal_sign", "eth_signTypedData", "eth_sign"]), events: Set(["chainChanged", "accountsChanged"]) From f09dc2a60f14c631c3ce71ca83721cabb29d206c Mon Sep 17 00:00:00 2001 From: llbartekll Date: Fri, 29 Mar 2024 07:35:03 +0000 Subject: [PATCH 512/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index b14d280bf..2c162848f 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.3"} +{"version": "1.18.4"} From 62416a7bd391478b88d82be45e486933c3e9c121 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 29 Mar 2024 14:13:23 +0100 Subject: [PATCH 513/814] savepoint --- .../Serialiser/Serializer.swift | 26 ++++-- .../Serialiser/Serializing.swift | 5 +- ...ApproveSessionAuthenticateDispatcher.swift | 60 +++++++------ .../ApproveSessionAuthenticateUtil.swift} | 90 ++++--------------- .../Auth/Link/LinkAuthRequester.swift | 4 +- .../Auth/Link/LinkEnvelopesDispatcher.swift | 41 +++++++-- .../LinkSessionAuthenticateResponder.swift | 76 ++++++++++++++++ .../Wallet/SessionAuthenticateResponder.swift | 87 ++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 4 +- .../Sign/SignClientFactory.swift | 2 +- 10 files changed, 273 insertions(+), 122 deletions(-) rename Sources/WalletConnectSign/Auth/{Services/Wallet/AuthResponder.swift => Link/ApproveSessionAuthenticateUtil.swift} (55%) create mode 100644 Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift create mode 100644 Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index 3a59cdb6a..a725e50e8 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -7,6 +7,7 @@ public class Serializer: Serializing { case symmetricKeyForTopicNotFound(String) case publicKeyForTopicNotFound case invalidType2Envelope + case topicNotFound var description: String { switch self { @@ -16,6 +17,8 @@ public class Serializer: Serializing { return "Error: Public key for topic was not found." case .invalidType2Envelope: return "Error: Invalid type 2 envelope." + case .topicNotFound: + return "Error: Topic not found." } } } @@ -49,7 +52,15 @@ public class Serializer: Serializing { /// - encodable: Object to encrypt and serialize /// - envelopeType: type of envelope /// - Returns: Serialized String - public func serialize(topic: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String { + public func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String { + if envelopeType == .type2 { + return try serializeEnvelopeType2(encodable: encodable) + } + guard let topic = topic else { + let error = Errors.topicNotFound + logger.error("\(error)") + throw error + } let messageJson = try encodable.json() guard let symmetricKey = kms.getSymmetricKeyRepresentable(for: topic) else { let error = Errors.symmetricKeyForTopicNotFound(topic) @@ -60,13 +71,6 @@ public class Serializer: Serializing { return Envelope(type: envelopeType, sealbox: sealbox).serialised() } - /// Serializes envelope type 2 - public func serializeEnvelopeType2(encodable: Encodable) throws -> String { - let messageData = try JSONEncoder().encode(encodable) - return Envelope(type: .type2, sealbox: messageData).serialised() - } - - /// Deserializes and decrypts an object /// - Parameters: /// - topic: Topic that is associated with a symetric key for decrypting particular codable object @@ -104,6 +108,12 @@ public class Serializer: Serializing { } } + /// Serializes envelope type 2 + private func serializeEnvelopeType2(encodable: Encodable) throws -> String { + let messageData = try JSONEncoder().encode(encodable) + return Envelope(type: .type2, sealbox: messageData).serialised() + } + private func handleType1Envelope(_ topic: String, peerPubKey: Data, sealbox: Data) throws -> (T, String, Data) { guard let selfPubKey = kms.getPublicKey(for: topic) else { diff --git a/Sources/WalletConnectKMS/Serialiser/Serializing.swift b/Sources/WalletConnectKMS/Serialiser/Serializing.swift index 416888083..7bc5088eb 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializing.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializing.swift @@ -4,8 +4,7 @@ import Combine public protocol Serializing { var logsPublisher: AnyPublisher {get} func setLogging(level: LoggingLevel) - func serializeEnvelopeType2(encodable: Encodable) throws -> String - func serialize(topic: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String + func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key func deserialize(topic: String, encodedEnvelope: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) } @@ -16,7 +15,7 @@ public extension Serializing { return try? deserialize(topic: topic, encodedEnvelope: encodedEnvelope) } - func serialize(topic: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType = .type0) throws -> String { + func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType = .type0) throws -> String { try serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) } } diff --git a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift index a175f7be8..441bfdc1b 100644 --- a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift @@ -1,25 +1,35 @@ -//import Foundation -// -//actor ApproveSessionAuthenticateDispatcher { -// -// -// private let authResponder: AuthResponder -// private let logger: ConsoleLogging -// private let rpcHistory: RPCHistory -// -// init( -// authResponder: AuthResponder, -// logger: ConsoleLogging, -// rpcHistory: RPCHistory -// ) { -// self.authResponder = authResponder -// self.logger = logger -// self.rpcHistory = rpcHistory -// } -// -// public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { -// -// -// try await authResponder.respond(requestId: requestId, auths: auths) -// } -//} +import Foundation + +actor ApproveSessionAuthenticateDispatcher { + + private let relaySessionAuthenticateResponder: SessionAuthenticateResponder + private let linkSessionAuthenticateResponder: LinkSessionAuthenticateResponder + private let logger: ConsoleLogging + private let util: ApproveSessionAuthenticateUtil + + init( + relaySessionAuthenticateResponder: SessionAuthenticateResponder, + logger: ConsoleLogging, + rpcHistory: RPCHistory, + approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, + linkSessionAuthenticateResponder: LinkSessionAuthenticateResponder + ) { + self.relaySessionAuthenticateResponder = relaySessionAuthenticateResponder + self.logger = logger + self.util = approveSessionAuthenticateUtil + self.linkSessionAuthenticateResponder = linkSessionAuthenticateResponder + } + + public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { + + let transportType = try util.getHistoryRecord(requestId: requestId).transportType + + switch transportType { + + case .relay: + return try await relaySessionAuthenticateResponder.respond(requestId: requestId, auths: auths) + case .linkMode: + return try await linkSessionAuthenticateResponder.respond(requestId: requestId, auths: auths) + } + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift similarity index 55% rename from Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift rename to Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index 3d9ae4304..d1b273df8 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -1,101 +1,39 @@ import Foundation -import Combine -actor AuthResponder { +class ApproveSessionAuthenticateUtil { enum Errors: Error { case recordForIdNotFound case malformedAuthRequestParams } - private let networkingInteractor: NetworkInteracting + private let kms: KeyManagementService private let messageFormatter: SIWEFromCacaoFormatting private let signatureVerifier: MessageVerifier private let rpcHistory: RPCHistory - private let verifyContextStore: CodableStore private let logger: ConsoleLogging - private let walletErrorResponder: WalletErrorResponder - private let pairingRegisterer: PairingRegisterer - private let metadata: AppMetadata private let sessionStore: WCSessionStorage private let sessionNamespaceBuilder: SessionNamespaceBuilder init( - networkingInteractor: NetworkInteracting, logger: ConsoleLogging, kms: KeyManagementService, rpcHistory: RPCHistory, signatureVerifier: MessageVerifier, messageFormatter: SIWEFromCacaoFormatting, - verifyContextStore: CodableStore, - walletErrorResponder: WalletErrorResponder, - pairingRegisterer: PairingRegisterer, - metadata: AppMetadata, sessionStore: WCSessionStorage, sessionNamespaceBuilder: SessionNamespaceBuilder ) { - self.networkingInteractor = networkingInteractor self.logger = logger self.kms = kms self.rpcHistory = rpcHistory - self.verifyContextStore = verifyContextStore - self.walletErrorResponder = walletErrorResponder - self.pairingRegisterer = pairingRegisterer - self.metadata = metadata self.sessionStore = sessionStore self.sessionNamespaceBuilder = sessionNamespaceBuilder self.signatureVerifier = signatureVerifier self.messageFormatter = messageFormatter } - func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { - try await recoverAndVerifySignature(cacaos: auths) - let (sessionAuthenticateRequestParams, pairingTopic) = try getsessionAuthenticateRequestParams(requestId: requestId) - let (responseTopic, responseKeys) = try generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) - - - try kms.setAgreementSecret(responseKeys, topic: responseTopic) - - let peerParticipant = sessionAuthenticateRequestParams.requester - - let sessionSelfPubKey = try kms.createX25519KeyPair() - let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation - let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) - - let sessionTopic = sessionKeys.derivedTopic() - try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) - - let selfParticipant = Participant(publicKey: sessionSelfPubKeyHex, metadata: metadata) - let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) - - let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: responseTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) - - - let session = try createSession( - response: responseParams, - pairingTopic: pairingTopic, - request: sessionAuthenticateRequestParams, - sessionTopic: sessionTopic - ) - - pairingRegisterer.activate( - pairingTopic: pairingTopic, - peerMetadata: sessionAuthenticateRequestParams.requester.metadata - ) - - verifyContextStore.delete(forKey: requestId.string) - - return session - } - - func respondError(requestId: RPCID) async throws { - try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) - verifyContextStore.delete(forKey: requestId.string) - } - - private func getsessionAuthenticateRequestParams(requestId: RPCID) throws -> (request: SessionAuthenticateRequestParams, topic: String) { - guard let record = rpcHistory.get(recordId: requestId) - else { throw Errors.recordForIdNotFound } + func getsessionAuthenticateRequestParams(requestId: RPCID) throws -> (request: SessionAuthenticateRequestParams, topic: String) { + let record = try getHistoryRecord(requestId: requestId) let request = record.request guard let authRequestParams = try request.params?.get(SessionAuthenticateRequestParams.self) @@ -104,7 +42,14 @@ actor AuthResponder { return (request: authRequestParams, topic: record.topic) } - private func generateAgreementKeys(requestParams: SessionAuthenticateRequestParams) throws -> (topic: String, keys: AgreementKeys) { + func getHistoryRecord(requestId: RPCID) throws -> RPCHistory.Record { + guard let record = rpcHistory.get(recordId: requestId) + else { throw Errors.recordForIdNotFound } + return record + } + + + func generateAgreementKeys(requestParams: SessionAuthenticateRequestParams) throws -> (topic: String, keys: AgreementKeys) { let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) let topic = peerPubKey.rawRepresentation.sha256().toHexString() let selfPubKey = try kms.createX25519KeyPair() @@ -113,7 +58,7 @@ actor AuthResponder { } - private func createSession( + func createSession( response: SessionAuthenticateResponseParams, pairingTopic: String, request: SessionAuthenticateRequestParams, @@ -155,15 +100,11 @@ actor AuthResponder { ) sessionStore.setSession(session) - Task { - logger.debug("subscribing to session topic: \(sessionTopic)") - try await networkingInteractor.subscribe(topic: sessionTopic) - } return session.publicRepresentation() } - private func recoverAndVerifySignature(cacaos: [Cacao]) async throws { + func recoverAndVerifySignature(cacaos: [Cacao]) async throws { try await cacaos.asyncForEach { [unowned self] cacao in guard let account = try? DIDPKH(did: cacao.p.iss).account, @@ -184,8 +125,7 @@ actor AuthResponder { } } } - -extension AuthResponder.Errors: LocalizedError { +extension ApproveSessionAuthenticateUtil.Errors: LocalizedError { public var errorDescription: String? { switch self { case .recordForIdNotFound: diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index fef0cdfb5..362a2671f 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -60,7 +60,9 @@ actor LinkAuthRequester { logger.debug("LinkAuthRequester: sending request") - return try await linkEnvelopesDispatcher.request(request: request, walletUniversalLink: walletUniversalLink) + + + return try await linkEnvelopesDispatcher.request(topic: UUID().uuidString,request: request, peerUniversalLink: walletUniversalLink, envelopeType: .type2) } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 395e36b13..29974302b 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -48,21 +48,48 @@ class LinkEnvelopesDispatcher { manageSubscription(topic, wcEnvelope) } - func request(request: RPCRequest, walletUniversalLink: String) async throws -> String { + func request(topic: String, request: RPCRequest, peerUniversalLink: String, envelopeType: Envelope.EnvelopeType) async throws -> String { - let envelope = try serializer.serializeEnvelopeType2(encodable: request) + try rpcHistory.set(request, forTopic: topic, emmitedBy: .local, transportType: .relay) - guard var components = URLComponents(string: walletUniversalLink) else { throw URLError(.badURL) } + var envelopeUrl: URL! + do { + envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: request, envelopeType: envelopeType, topic: topic) - components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] + // await UIApplication.shared.open(finalURL) + } catch { + if let id = request.id { + rpcHistory.delete(id: id) + } + throw error + } - guard let finalURL = components.url else { throw URLError(.badURL) } + return envelopeUrl.absoluteString + } + + func respond(topic: String, response: RPCResponse, peerUniversalLink: String, envelopeType: Envelope.EnvelopeType) async throws -> String { + try rpcHistory.validate(response) + let envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: response, envelopeType: envelopeType, topic: topic) + + // await UIApplication.shared.open(finalURL) + try rpcHistory.resolve(response) -// await UIApplication.shared.open(finalURL) - return finalURL.absoluteString + return envelopeUrl.absoluteString } + private func serializeAndCreateUrl(peerUniversalLink: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType, topic: String?) throws -> URL { + let envelope = try serializer.serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) + + guard var components = URLComponents(string: peerUniversalLink) else { throw URLError(.badURL) } + + components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] + + guard let finalURL = components.url else { throw URLError(.badURL) } + return finalURL + } + + public func requestSubscription(on method: String) -> AnyPublisher, Never> { return requestPublisher diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift new file mode 100644 index 000000000..949336edc --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -0,0 +1,76 @@ +import Foundation +import Combine + +actor LinkSessionAuthenticateResponder { + enum Errors: Error { + case missingPeerUniversalLink + } + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let kms: KeyManagementService + private let logger: ConsoleLogging + private let walletErrorResponder: WalletErrorResponder + private let metadata: AppMetadata + private let util: ApproveSessionAuthenticateUtil + + init( + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + logger: ConsoleLogging, + kms: KeyManagementService, + walletErrorResponder: WalletErrorResponder, + metadata: AppMetadata, + approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil + ) { + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.logger = logger + self.kms = kms + self.walletErrorResponder = walletErrorResponder + self.metadata = metadata + self.util = approveSessionAuthenticateUtil + } + + func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { + try await util.recoverAndVerifySignature(cacaos: auths) + let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) + let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + + let peerParticipant = sessionAuthenticateRequestParams.requester + guard let peerUniversalLink = peerParticipant.metadata.redirect?.universal else { + throw Errors.missingPeerUniversalLink + } + + try kms.setAgreementSecret(responseKeys, topic: responseTopic) + + + let sessionSelfPubKey = try kms.createX25519KeyPair() + let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation + let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) + + let sessionTopic = sessionKeys.derivedTopic() + try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) + + let selfParticipant = Participant(publicKey: sessionSelfPubKeyHex, metadata: metadata) + let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) + + let response = RPCResponse(id: requestId, result: responseParams) + + + let url = try await linkEnvelopesDispatcher.respond(topic: responseTopic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) + + + let session = try util.createSession( + response: responseParams, + pairingTopic: pairingTopic, + request: sessionAuthenticateRequestParams, + sessionTopic: sessionTopic + ) + + return session + } + + func respondError(requestId: RPCID) async throws { + try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + } + +} + + diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift new file mode 100644 index 000000000..eccd5ed11 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -0,0 +1,87 @@ +import Foundation +import Combine + +actor SessionAuthenticateResponder { + + private let networkingInteractor: NetworkInteracting + private let kms: KeyManagementService + private let verifyContextStore: CodableStore + private let logger: ConsoleLogging + private let walletErrorResponder: WalletErrorResponder + private let pairingRegisterer: PairingRegisterer + private let metadata: AppMetadata + private let util: ApproveSessionAuthenticateUtil + + init( + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging, + kms: KeyManagementService, + verifyContextStore: CodableStore, + walletErrorResponder: WalletErrorResponder, + pairingRegisterer: PairingRegisterer, + metadata: AppMetadata, + approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil + ) { + self.networkingInteractor = networkingInteractor + self.logger = logger + self.kms = kms + self.verifyContextStore = verifyContextStore + self.walletErrorResponder = walletErrorResponder + self.pairingRegisterer = pairingRegisterer + self.metadata = metadata + self.util = approveSessionAuthenticateUtil + } + + func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { + try await util.recoverAndVerifySignature(cacaos: auths) + let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) + let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + + + try kms.setAgreementSecret(responseKeys, topic: responseTopic) + + let peerParticipant = sessionAuthenticateRequestParams.requester + + let sessionSelfPubKey = try kms.createX25519KeyPair() + let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation + let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) + + let sessionTopic = sessionKeys.derivedTopic() + try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) + + let selfParticipant = Participant(publicKey: sessionSelfPubKeyHex, metadata: metadata) + let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) + + let response = RPCResponse(id: requestId, result: responseParams) + try await networkingInteractor.respond(topic: responseTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) + + + let session = try util.createSession( + response: responseParams, + pairingTopic: pairingTopic, + request: sessionAuthenticateRequestParams, + sessionTopic: sessionTopic + ) + + Task { + logger.debug("subscribing to session topic: \(sessionTopic)") + try await networkingInteractor.subscribe(topic: sessionTopic) + } + + pairingRegisterer.activate( + pairingTopic: pairingTopic, + peerMetadata: sessionAuthenticateRequestParams.requester.metadata + ) + + verifyContextStore.delete(forKey: requestId.string) + + return session + } + + func respondError(requestId: RPCID) async throws { + try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + verifyContextStore.delete(forKey: requestId.string) + } +} + + diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index c0f5c047f..3202fb40d 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -167,7 +167,7 @@ public final class SignClient: SignClientProtocol { private let appRequestService: SessionAuthRequestService private let authResposeSubscriber: AuthResponseSubscriber private let authRequestSubscriber: AuthRequestSubscriber - private let authResponder: AuthResponder + private let authResponder: SessionAuthenticateResponder private let authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() @@ -213,7 +213,7 @@ public final class SignClient: SignClientProtocol { appRequestService: SessionAuthRequestService, appRespondSubscriber: AuthResponseSubscriber, authRequestSubscriber: AuthRequestSubscriber, - authResponder: AuthResponder, + authResponder: SessionAuthenticateResponder, pendingRequestsProvider: PendingRequestsProvider, proposalExpiryWatcher: ProposalExpiryWatcher, pendingProposalsProvider: PendingProposalsProvider, diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 9cbafec80..c0d6e78e2 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -107,7 +107,7 @@ public struct SignClientFactory { let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) - let authResponder = AuthResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) + let authResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) From 6ee08c98bbb6113b34d732473c088110f115d4a9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 29 Mar 2024 14:24:08 +0100 Subject: [PATCH 514/814] fix unit tests build --- ...ApproveSessionAuthenticateDispatcher.swift | 2 +- .../LinkSessionAuthenticateResponder.swift | 6 ++---- .../Sign/SignClientFactory.swift | 5 ++++- .../RPCHistory/RPCHistory.swift | 2 +- .../SerialiserTests.swift | 2 +- .../WalletPairServiceTests.swift | 2 +- .../RPCHistoryTests.swift | 20 +++++++++---------- 7 files changed, 20 insertions(+), 19 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift index 441bfdc1b..4dd3d8b18 100644 --- a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift @@ -26,7 +26,7 @@ actor ApproveSessionAuthenticateDispatcher { switch transportType { - case .relay: + case .relay, .none: return try await relaySessionAuthenticateResponder.respond(requestId: requestId, auths: auths) case .linkMode: return try await linkSessionAuthenticateResponder.respond(requestId: requestId, auths: auths) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index 949336edc..e96df6daf 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -8,7 +8,6 @@ actor LinkSessionAuthenticateResponder { private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let kms: KeyManagementService private let logger: ConsoleLogging - private let walletErrorResponder: WalletErrorResponder private let metadata: AppMetadata private let util: ApproveSessionAuthenticateUtil @@ -16,14 +15,12 @@ actor LinkSessionAuthenticateResponder { linkEnvelopesDispatcher: LinkEnvelopesDispatcher, logger: ConsoleLogging, kms: KeyManagementService, - walletErrorResponder: WalletErrorResponder, metadata: AppMetadata, approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil ) { self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.logger = logger self.kms = kms - self.walletErrorResponder = walletErrorResponder self.metadata = metadata self.util = approveSessionAuthenticateUtil } @@ -68,7 +65,8 @@ actor LinkSessionAuthenticateResponder { } func respondError(requestId: RPCID) async throws { - try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + + //TODO } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index c0d6e78e2..fcf14e9c6 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -107,7 +107,10 @@ public struct SignClientFactory { let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) - let authResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) + + let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) + + let authResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index c5a9741a9..1d941956e 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -17,7 +17,7 @@ public final class RPCHistory { public let request: RPCRequest public let response: RPCResponse? public var timestamp: Date? - public let transportType: TransportType + public let transportType: TransportType? } enum HistoryError: Error, LocalizedError { diff --git a/Tests/WalletConnectKMSTests/SerialiserTests.swift b/Tests/WalletConnectKMSTests/SerialiserTests.swift index 3280e65aa..ca0aff3b2 100644 --- a/Tests/WalletConnectKMSTests/SerialiserTests.swift +++ b/Tests/WalletConnectKMSTests/SerialiserTests.swift @@ -48,7 +48,7 @@ final class SerializerTests: XCTestCase { let messageToSerialize = "todo - change for request object" // Serialize the sample object with Type 2 envelope - guard let serializedMessage = try? mySerializer.serializeEnvelopeType2(encodable: messageToSerialize) else { + guard let serializedMessage = try? mySerializer.serialize(topic: "", encodable: messageToSerialize, envelopeType: .type2) else { XCTFail("Serialization failed for Type 2 envelope.") return } diff --git a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift index 5483d669c..6def56757 100644 --- a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift +++ b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift @@ -35,7 +35,7 @@ final class WalletPairServiceTestsTests: XCTestCase { var pairing = storageMock.getPairing(forTopic: uri.topic) pairing?.receivedRequest() storageMock.setPairing(pairing!) - try! rpcHistory.set(rpcRequest, forTopic: uri.topic, emmitedBy: .local) + try! rpcHistory.set(rpcRequest, forTopic: uri.topic, emmitedBy: .local, transportType: .relay) try! await service.pair(uri) XCTAssertTrue(networkingInteractor.didCallHandleHistoryRequest) diff --git a/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift b/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift index b4023eaff..d94ce541f 100644 --- a/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift +++ b/Tests/WalletConnectUtilsTests/RPCHistoryTests.swift @@ -20,7 +20,7 @@ final class RPCHistoryTests: XCTestCase { func testRoundTrip() throws { let request = RPCRequest.stub() - try sut.set(request, forTopic: String.randomTopic(), emmitedBy: .local) + try sut.set(request, forTopic: String.randomTopic(), emmitedBy: .local, transportType: .relay) let record = sut.get(recordId: request.id!) XCTAssertNil(record?.response) XCTAssertEqual(record?.request, request) @@ -31,8 +31,8 @@ final class RPCHistoryTests: XCTestCase { let requestB = RPCRequest.stub() let responseA = RPCResponse(matchingRequest: requestA, result: true) let responseB = RPCResponse(matchingRequest: requestB, error: .internalError) - try sut.set(requestA, forTopic: String.randomTopic(), emmitedBy: .remote) - try sut.set(requestB, forTopic: String.randomTopic(), emmitedBy: .local) + try sut.set(requestA, forTopic: String.randomTopic(), emmitedBy: .remote, transportType: .relay) + try sut.set(requestB, forTopic: String.randomTopic(), emmitedBy: .local, transportType: .relay) try sut.resolve(responseA) try sut.resolve(responseB) XCTAssertNil(sut.get(recordId: requestA.id!)) @@ -42,7 +42,7 @@ final class RPCHistoryTests: XCTestCase { func testDelete() throws { let requests = (1...5).map { _ in RPCRequest.stub() } let topic = String.randomTopic() - try requests.forEach { try sut.set($0, forTopic: topic, emmitedBy: .local) } + try requests.forEach { try sut.set($0, forTopic: topic, emmitedBy: .local, transportType: .relay) } sut.deleteAll(forTopic: topic) requests.forEach { XCTAssertNil(sut.get(recordId: $0.id!)) @@ -55,7 +55,7 @@ final class RPCHistoryTests: XCTestCase { let expectedError = RPCHistory.HistoryError.unidentifiedRequest let request = RPCRequest.notification(method: "notify") - XCTAssertThrowsError(try sut.set(request, forTopic: String.randomTopic(), emmitedBy: .local)) { error in + XCTAssertThrowsError(try sut.set(request, forTopic: String.randomTopic(), emmitedBy: .local, transportType: .relay)) { error in XCTAssertEqual(expectedError, error as? RPCHistory.HistoryError) } } @@ -68,8 +68,8 @@ final class RPCHistoryTests: XCTestCase { let requestB = RPCRequest.stub(method: "method-2", id: id) let topic = String.randomTopic() - try sut.set(requestA, forTopic: topic, emmitedBy: .local) - XCTAssertThrowsError(try sut.set(requestB, forTopic: topic, emmitedBy: .local)) { error in + try sut.set(requestA, forTopic: topic, emmitedBy: .local, transportType: .relay) + XCTAssertThrowsError(try sut.set(requestB, forTopic: topic, emmitedBy: .local, transportType: .relay)) { error in XCTAssertEqual(expectedError, error as? RPCHistory.HistoryError) } } @@ -99,7 +99,7 @@ final class RPCHistoryTests: XCTestCase { let responseA = RPCResponse(matchingRequest: request, result: true) let responseB = RPCResponse(matchingRequest: request, result: false) - try sut.set(request, forTopic: String.randomTopic(), emmitedBy: .local) + try sut.set(request, forTopic: String.randomTopic(), emmitedBy: .local, transportType: .relay) try sut.resolve(responseA) XCTAssertThrowsError(try sut.resolve(responseB)) { error in XCTAssertEqual(expectedError, error as? RPCHistory.HistoryError) @@ -113,8 +113,8 @@ final class RPCHistoryTests: XCTestCase { let time1 = TestTimeProvider(currentDate: .distantPast) let time2 = TestTimeProvider(currentDate: Date()) - try sut.set(request1, forTopic: .randomTopic(), emmitedBy: .local, time: time1) - try sut.set(request2, forTopic: .randomTopic(), emmitedBy: .local, time: time2) + try sut.set(request1, forTopic: .randomTopic(), emmitedBy: .local, time: time1, transportType: .relay) + try sut.set(request2, forTopic: .randomTopic(), emmitedBy: .local, time: time2, transportType: .relay) XCTAssertEqual(sut.get(recordId: request1.id!)?.request, request1) XCTAssertEqual(sut.get(recordId: request2.id!)?.request, request2) From 331e66192839b5c8701038a6dc9e5860a0bc4161 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 29 Mar 2024 14:51:37 +0100 Subject: [PATCH 515/814] fix tests that are failing due to summer time change --- .../ControllerSessionStateMachineTests.swift | 2 +- Tests/WalletConnectSignTests/Helpers/TimeTraveler.swift | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/Tests/WalletConnectSignTests/ControllerSessionStateMachineTests.swift b/Tests/WalletConnectSignTests/ControllerSessionStateMachineTests.swift index f2a2a1772..e985daa78 100644 --- a/Tests/WalletConnectSignTests/ControllerSessionStateMachineTests.swift +++ b/Tests/WalletConnectSignTests/ControllerSessionStateMachineTests.swift @@ -70,7 +70,7 @@ class ControllerSessionStateMachineTests: XCTestCase { let twoDays = 2*Time.day await XCTAssertNoThrowAsync(try await sessionExtendRequester.extend(topic: session.topic, by: Int64(twoDays))) let extendedSession = storageMock.getAll().first {$0.topic == session.topic}! - XCTAssertEqual(extendedSession.expiryDate.timeIntervalSinceReferenceDate, TimeTraveler.dateByAdding(days: 2).timeIntervalSinceReferenceDate, accuracy: 1) + XCTAssertEqual(extendedSession.expiryDate.timeIntervalSince1970, TimeTraveler.dateByAdding(days: 2).timeIntervalSince1970, accuracy: 1) } func testUpdateExpiryTtlTooHigh() async { diff --git a/Tests/WalletConnectSignTests/Helpers/TimeTraveler.swift b/Tests/WalletConnectSignTests/Helpers/TimeTraveler.swift index 1b66229ae..dbab49ad0 100644 --- a/Tests/WalletConnectSignTests/Helpers/TimeTraveler.swift +++ b/Tests/WalletConnectSignTests/Helpers/TimeTraveler.swift @@ -12,7 +12,9 @@ final class TimeTraveler { referenceDate = referenceDate.addingTimeInterval(timeInterval) } - static func dateByAdding(days: Int) -> Date { - Calendar.current.date(byAdding: .day, value: days, to: Date())! + static func dateByAdding(days: Int, to date: Date = Date(), in timeZone: TimeZone = TimeZone(secondsFromGMT: 0)!) -> Date { + var calendar = Calendar.current + calendar.timeZone = timeZone + return calendar.date(byAdding: .day, value: days, to: date)! } } From 378244d32533f7c4150117676266afe6e51a2b0f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Apr 2024 09:49:44 +0200 Subject: [PATCH 516/814] savepoint --- .../IntegrationTests/Sign/SignClientTests.swift | 5 +++-- .../ApproveSessionAuthenticateDispatcher.swift | 17 +++++++++++++++-- .../Auth/Link/LinkAuthRequester.swift | 2 -- .../Link/LinkSessionAuthenticateResponder.swift | 4 ++-- Sources/WalletConnectSign/Sign/SignClient.swift | 17 ++++++++++++----- .../Sign/SignClientFactory.swift | 11 +++++++++-- 6 files changed, 41 insertions(+), 15 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 820957194..bc503280d 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -46,7 +46,7 @@ final class SignClientTests: XCTestCase { networkingClient: networkingClient ) let client = SignClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), + metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: UUID().uuidString)), logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychain, @@ -1107,7 +1107,8 @@ final class SignClientTests: XCTestCase { let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) - _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + let (_, approveEnvelope) = try! await wallet.approveSessionAuthenticateLinkMode(requestId: request.id, auths: [auth]) + dapp.dispatchEnvelope(approveEnvelope, topic: <#T##String#>) } } .store(in: &publishers) diff --git a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift index 4dd3d8b18..f6c348d32 100644 --- a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift @@ -20,16 +20,29 @@ actor ApproveSessionAuthenticateDispatcher { self.linkSessionAuthenticateResponder = linkSessionAuthenticateResponder } - public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { + public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String?) { let transportType = try util.getHistoryRecord(requestId: requestId).transportType switch transportType { case .relay, .none: - return try await relaySessionAuthenticateResponder.respond(requestId: requestId, auths: auths) + let session = try await relaySessionAuthenticateResponder.respond(requestId: requestId, auths: auths) + return (session, nil) case .linkMode: return try await linkSessionAuthenticateResponder.respond(requestId: requestId, auths: auths) } } + + func respondError(requestId: RPCID) async throws { + let transportType = try util.getHistoryRecord(requestId: requestId).transportType + + switch transportType { + + case .relay, .none: + return try await relaySessionAuthenticateResponder.respondError(requestId: requestId) + case .linkMode: + return try await linkSessionAuthenticateResponder.respondError(requestId: requestId) + } + } } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 362a2671f..8c4ad229b 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -28,8 +28,6 @@ actor LinkAuthRequester { func request(params: AuthRequestParams, walletUniversalLink: String) async throws -> String { - - print("LinkAuthRequester: creating request") var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index e96df6daf..7752c25d0 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -25,7 +25,7 @@ actor LinkSessionAuthenticateResponder { self.util = approveSessionAuthenticateUtil } - func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { + func respond(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String) { try await util.recoverAndVerifySignature(cacaos: auths) let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) @@ -61,7 +61,7 @@ actor LinkSessionAuthenticateResponder { sessionTopic: sessionTopic ) - return session + return (session, url) } func respondError(requestId: RPCID) async throws { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 3202fb40d..8d47805da 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -167,7 +167,7 @@ public final class SignClient: SignClientProtocol { private let appRequestService: SessionAuthRequestService private let authResposeSubscriber: AuthResponseSubscriber private let authRequestSubscriber: AuthRequestSubscriber - private let authResponder: SessionAuthenticateResponder + private let approveSessionAuthenticateDispatcher: ApproveSessionAuthenticateDispatcher private let authResponseTopicResubscriptionService: AuthResponseTopicResubscriptionService private let sessionProposalPublisherSubject = PassthroughSubject<(proposal: Session.Proposal, context: VerifyContext?), Never>() @@ -213,7 +213,7 @@ public final class SignClient: SignClientProtocol { appRequestService: SessionAuthRequestService, appRespondSubscriber: AuthResponseSubscriber, authRequestSubscriber: AuthRequestSubscriber, - authResponder: SessionAuthenticateResponder, + approveSessionAuthenticateDispatcher: ApproveSessionAuthenticateDispatcher, pendingRequestsProvider: PendingRequestsProvider, proposalExpiryWatcher: ProposalExpiryWatcher, pendingProposalsProvider: PendingProposalsProvider, @@ -242,7 +242,7 @@ public final class SignClient: SignClientProtocol { self.pairingClient = pairingClient self.appRequestService = appRequestService self.authRequestSubscriber = authRequestSubscriber - self.authResponder = authResponder + self.approveSessionAuthenticateDispatcher = approveSessionAuthenticateDispatcher self.authResposeSubscriber = appRespondSubscriber self.pendingRequestsProvider = pendingRequestsProvider self.proposalExpiryWatcher = proposalExpiryWatcher @@ -368,13 +368,20 @@ public final class SignClient: SignClientProtocol { /// - requestId: authentication request id /// - signature: CACAO signature of requested message public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { - try await authResponder.respond(requestId: requestId, auths: auths) + let (session, universalLink) = try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) + return session } + #if DEBUG + func approveSessionAuthenticateLinkMode(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String?) { + return try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) + } + #endif + /// For wallet to reject authentication request /// - Parameter requestId: authentication request id public func rejectSession(requestId: RPCID) async throws { - try await authResponder.respondError(requestId: requestId) + try await approveSessionAuthenticateDispatcher.respondError(requestId: requestId) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index fcf14e9c6..bb888da0f 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -110,7 +110,7 @@ public struct SignClientFactory { let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) - let authResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) + let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) @@ -119,6 +119,13 @@ public struct SignClientFactory { let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger, rpcHistory: rpcHistory) let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher) + + let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) + + let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) + + let approveSessionAuthenticateDispatcher = ApproveSessionAuthenticateDispatcher(relaySessionAuthenticateResponder: relaySessionAuthenticateResponder, logger: logger, rpcHistory: rpcHistory, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, linkSessionAuthenticateResponder: linkSessionAuthenticateResponder) + let client = SignClient( logger: logger, networkingClient: networkingClient, @@ -139,7 +146,7 @@ public struct SignClientFactory { appRequestService: appRequestService, appRespondSubscriber: appRespondSubscriber, authRequestSubscriber: authRequestSubscriber, - authResponder: authResponder, + approveSessionAuthenticateDispatcher: approveSessionAuthenticateDispatcher, pendingRequestsProvider: pendingRequestsProvider, proposalExpiryWatcher: proposalExpiryWatcher, pendingProposalsProvider: pendingProposalsProvider, From 119e247a96941f9963bcb296539c8edd9e7f6dc0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Apr 2024 13:36:21 +0200 Subject: [PATCH 517/814] savepoint --- .../Sign/SignClientTests.swift | 4 ++-- .../Auth/Link/LinkEnvelopesDispatcher.swift | 19 ++++++++++--------- .../WalletConnectSign/Sign/SignClient.swift | 9 +++++---- .../RPCHistory/RPCHistory.swift | 5 +++-- 4 files changed, 20 insertions(+), 17 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index bc503280d..8aadee8d2 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1108,7 +1108,7 @@ final class SignClientTests: XCTestCase { let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) let (_, approveEnvelope) = try! await wallet.approveSessionAuthenticateLinkMode(requestId: request.id, auths: [auth]) - dapp.dispatchEnvelope(approveEnvelope, topic: <#T##String#>) + try dapp.dispatchEnvelope(approveEnvelope) } } .store(in: &publishers) @@ -1120,7 +1120,7 @@ final class SignClientTests: XCTestCase { let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: "") - try await wallet.dispatchEnvelope(requestEnvelope, topic: "") + try wallet.dispatchEnvelope(requestEnvelope) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 29974302b..3ab6ef585 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -7,6 +7,7 @@ import Combine class LinkEnvelopesDispatcher { enum Errors: Error { case invalidURL + case envelopeNotFound } private let serializer: Serializing private let logger: ConsoleLogging @@ -35,16 +36,16 @@ class LinkEnvelopesDispatcher { self.rpcHistory = rpcHistory } - func dispatchEnvelope(_ envelope: String, topic: String) throws { - guard let envelopeURL = URL(string: envelope) else { + func dispatchEnvelope(_ envelope: String) throws { + guard let envelopeURL = URL(string: envelope), + let components = URLComponents(url: envelopeURL, resolvingAgainstBaseURL: true) else { throw Errors.invalidURL } - // Use URLComponents to parse the URL for query items - guard let components = URLComponents(url: envelopeURL, resolvingAgainstBaseURL: true), - let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { - throw Errors.invalidURL + guard let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { + throw Errors.envelopeNotFound } + let topic = components.queryItems?.first(where: { $0.name == "topic" })?.value manageSubscription(topic, wcEnvelope) } @@ -78,12 +79,12 @@ class LinkEnvelopesDispatcher { return envelopeUrl.absoluteString } - private func serializeAndCreateUrl(peerUniversalLink: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType, topic: String?) throws -> URL { + private func serializeAndCreateUrl(peerUniversalLink: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType, topic: String) throws -> URL { let envelope = try serializer.serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) guard var components = URLComponents(string: peerUniversalLink) else { throw URLError(.badURL) } - components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope)] + components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope), URLQueryItem(name: "topic", value: topic)] guard let finalURL = components.url else { throw URLError(.badURL) } return finalURL @@ -111,7 +112,7 @@ class LinkEnvelopesDispatcher { .eraseToAnyPublisher() } - private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { + private func manageSubscription(_ topic: String?, _ encodedEnvelope: String) { if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { handleRequest(topic: topic, request: deserializedJsonRpcRequest) } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 8d47805da..0fd06461f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -357,8 +357,8 @@ public final class SignClient: SignClientProtocol { return try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) } - public func dispatchEnvelope(_ envelope: String, topic: String) throws { - try linkEnvelopesDispatcher.dispatchEnvelope(envelope, topic: topic) + public func dispatchEnvelope(_ envelope: String) throws { + try linkEnvelopesDispatcher.dispatchEnvelope(envelope) } @@ -373,8 +373,9 @@ public final class SignClient: SignClientProtocol { } #if DEBUG - func approveSessionAuthenticateLinkMode(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String?) { - return try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) + func approveSessionAuthenticateLinkMode(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String) { + let (session, envelope) = try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) + return (session, envelope!) } #endif diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 1d941956e..f194f0738 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -12,7 +12,7 @@ public final class RPCHistory { case linkMode } public let id: RPCID - public let topic: String + public let topic: String? let origin: Origin public let request: RPCRequest public let response: RPCResponse? @@ -89,7 +89,8 @@ public final class RPCHistory { public func deleteAll(forTopics topics: [String]){ storage.getAll().forEach { record in - if topics.contains(record.topic) { + guard let topic = record.topic else { return } + if topics.contains(topic) { storage.delete(forKey: "\(record.id)") } } From 75a3a772f98d991ec6d54d8512a5a03c714f9a7a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Apr 2024 14:00:47 +0200 Subject: [PATCH 518/814] savepoint --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 7 +++++-- Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift | 5 ++--- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 3ab6ef585..e2090edff 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -8,6 +8,7 @@ class LinkEnvelopesDispatcher { enum Errors: Error { case invalidURL case envelopeNotFound + case topicNotFound } private let serializer: Serializing private let logger: ConsoleLogging @@ -45,7 +46,9 @@ class LinkEnvelopesDispatcher { guard let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { throw Errors.envelopeNotFound } - let topic = components.queryItems?.first(where: { $0.name == "topic" })?.value + guard let topic = components.queryItems?.first(where: { $0.name == "topic" })?.value else { + throw Errors.topicNotFound + } manageSubscription(topic, wcEnvelope) } @@ -112,7 +115,7 @@ class LinkEnvelopesDispatcher { .eraseToAnyPublisher() } - private func manageSubscription(_ topic: String?, _ encodedEnvelope: String) { + private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { handleRequest(topic: topic, request: deserializedJsonRpcRequest) } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index f194f0738..1d941956e 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -12,7 +12,7 @@ public final class RPCHistory { case linkMode } public let id: RPCID - public let topic: String? + public let topic: String let origin: Origin public let request: RPCRequest public let response: RPCResponse? @@ -89,8 +89,7 @@ public final class RPCHistory { public func deleteAll(forTopics topics: [String]){ storage.getAll().forEach { record in - guard let topic = record.topic else { return } - if topics.contains(topic) { + if topics.contains(record.topic) { storage.delete(forKey: "\(record.id)") } } From a9520421a3b1486c100480a6940eb69471401784 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Apr 2024 14:31:54 +0200 Subject: [PATCH 519/814] savepoint --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 15 ++++++++++++--- .../Link/LinkSessionAuthenticateResponder.swift | 1 + .../Services/App/AuthResponseSubscriber.swift | 1 + 3 files changed, 14 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index e2090edff..322c52fd4 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -17,13 +17,13 @@ class LinkEnvelopesDispatcher { private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest), Never>() - private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() + private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse), Never>() public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest), Never> { requestPublisherSubject.eraseToAnyPublisher() } - private var responsePublisher: AnyPublisher<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never> { + private var responsePublisher: AnyPublisher<(topic: String, request: RPCRequest, response: RPCResponse), Never> { responsePublisherSubject.eraseToAnyPublisher() } @@ -119,7 +119,7 @@ class LinkEnvelopesDispatcher { if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { handleRequest(topic: topic, request: deserializedJsonRpcRequest) } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { -// handleResponse(topic: topic, response: response, publishedAt: publishedAt, derivedTopic: derivedTopic) + handleResponse(topic: topic, response: response) } else { logger.debug("Networking Interactor - Received unknown object type from networking relay") } @@ -133,5 +133,14 @@ class LinkEnvelopesDispatcher { logger.debug(error) } } + + private func handleResponse(topic: String, response: RPCResponse) { + do { + let record = try rpcHistory.resolve(response) + responsePublisherSubject.send((topic, record.request, response)) + } catch { + logger.debug("Handle json rpc response error: \(error)") + } + } } #endif diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index 7752c25d0..232bd5781 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -26,6 +26,7 @@ actor LinkSessionAuthenticateResponder { } func respond(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String) { + logger.debug("responding session authenticate") try await util.recoverAndVerifySignature(cacaos: auths) let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index e223dd142..e6264ad7a 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -3,6 +3,7 @@ import Combine class AuthResponseSubscriber { private let networkingInteractor: NetworkInteracting + private let private let logger: ConsoleLogging private let rpcHistory: RPCHistory private let signatureVerifier: MessageVerifier From c3c1e24c3281d39586e623286b4079845c5f11b0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Apr 2024 14:44:52 +0200 Subject: [PATCH 520/814] pass first integration test --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 17 +++++++++- .../Services/App/AuthResponseSubscriber.swift | 33 +++++++++++++++++-- .../Sign/SignClientFactory.swift | 11 ++++--- 3 files changed, 53 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 322c52fd4..224f5b369 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -115,10 +115,25 @@ class LinkEnvelopesDispatcher { .eraseToAnyPublisher() } + public func responseSubscription(on request: ProtocolMethod) -> AnyPublisher, Never> { + return responsePublisher + .filter { rpcRequest in + return rpcRequest.request.method == request.method + } + .compactMap { topic, rpcRequest, rpcResponse in + guard + let id = rpcRequest.id, + let request = try? rpcRequest.params?.get(Request.self), + let response = try? rpcResponse.result?.get(Response.self) else { return nil } + return ResponseSubscriptionPayload(id: id, topic: topic, request: request, response: response, publishedAt: Date(), derivedTopic: nil) + } + .eraseToAnyPublisher() + } + private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { handleRequest(topic: topic, request: deserializedJsonRpcRequest) - } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { + } else if let (response, _, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { handleResponse(topic: topic, response: response) } else { logger.debug("Networking Interactor - Received unknown object type from networking relay") diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index e6264ad7a..b5d7e7bf5 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -3,7 +3,7 @@ import Combine class AuthResponseSubscriber { private let networkingInteractor: NetworkInteracting - private let + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let logger: ConsoleLogging private let rpcHistory: RPCHistory private let signatureVerifier: MessageVerifier @@ -28,7 +28,8 @@ class AuthResponseSubscriber { sessionStore: WCSessionStorage, messageFormatter: SIWEFromCacaoFormatting, sessionNamespaceBuilder: SessionNamespaceBuilder, - authResponseTopicRecordsStore: CodableStore) { + authResponseTopicRecordsStore: CodableStore, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -39,7 +40,9 @@ class AuthResponseSubscriber { self.pairingRegisterer = pairingRegisterer self.sessionNamespaceBuilder = sessionNamespaceBuilder self.authResponseTopicRecordsStore = authResponseTopicRecordsStore + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher subscribeForResponse() + subscribeForLinkResonse() } private func subscribeForResponse() { @@ -74,6 +77,32 @@ class AuthResponseSubscriber { }.store(in: &publishers) } + private func subscribeForLinkResonse() { + linkEnvelopesDispatcher.responseSubscription(on: SessionAuthenticatedProtocolMethod()) + .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + + let pairingTopic = payload.topic + pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) + removeResponseTopicRecord(responseTopic: payload.topic) + + let requestId = payload.id + let cacaos = payload.response.cacaos + + Task { + do { + try await recoverAndVerifySignature(cacaos: cacaos) + } catch { + authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) + return + } + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) + + authResponsePublisherSubject.send((requestId, .success((session, cacaos)))) + } + + }.store(in: &publishers) + } + private func recoverAndVerifySignature(cacaos: [Cacao]) async throws { try await cacaos.asyncForEach { [unowned self] cacao in guard diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index bb888da0f..709c4965d 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -103,20 +103,21 @@ public struct SignClientFactory { let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) let signatureVerifier = messageVerifierFactory.create(projectId: projectId) let sessionNameSpaceBuilder = SessionNamespaceBuilder(logger: logger) - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore) + + let serializer = Serializer(kms: kms, logger: logger) + + let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger, rpcHistory: rpcHistory) + + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) - let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) - let serializer = Serializer(kms: kms, logger: logger) - - let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger, rpcHistory: rpcHistory) let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher) From bad4b99e4b0ca187cdd794330ad110b4ae4ec19c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Apr 2024 12:48:50 +0200 Subject: [PATCH 521/814] savepoint --- Example/DApp/AppDelegate.swift | 11 +++++++++++ Example/DApp/DAppRelease.entitlements | 12 ++++++++++++ Example/DApp/Modules/Sign/SignPresenter.swift | 12 ++++++++++++ Example/DApp/Modules/Sign/SignView.swift | 13 +++++++++++++ Example/DApp/SceneDelegate.swift | 13 ++++++++++++- Example/ExampleApp.xcodeproj/project.pbxproj | 4 +++- .../WalletApp/ApplicationLayer/SceneDelegate.swift | 10 ++++++++++ Example/WalletApp/WalletApp.entitlements | 4 ++++ Example/WalletApp/WalletAppRelease.entitlements | 6 ++++++ Sources/WalletConnectKMS/Serialiser/Envelope.swift | 5 +++-- .../WalletConnectKMS/Serialiser/Serializer.swift | 3 ++- .../Auth/Link/LinkEnvelopesDispatcher.swift | 14 ++++++++------ Tests/WalletConnectKMSTests/EnvelopeTests.swift | 7 +++++++ 13 files changed, 103 insertions(+), 11 deletions(-) create mode 100644 Example/DApp/DAppRelease.entitlements diff --git a/Example/DApp/AppDelegate.swift b/Example/DApp/AppDelegate.swift index 1bccf58bf..ccfb15c17 100644 --- a/Example/DApp/AppDelegate.swift +++ b/Example/DApp/AppDelegate.swift @@ -1,4 +1,5 @@ import UIKit +import WalletConnectSign @main class AppDelegate: UIResponder, UIApplicationDelegate { @@ -15,6 +16,16 @@ class AppDelegate: UIResponder, UIApplicationDelegate { return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role) } + func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([any UIUserActivityRestoring]?) -> Void) async -> Bool { + guard let url = userActivity.webpageURL, + let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { + return true + } + try! Sign.instance.dispatchEnvelope(url.absoluteString) + + return true + } + func application(_ application: UIApplication, didDiscardSceneSessions sceneSessions: Set) { // Called when the user discards a scene session. // If any sessions were discarded while the application was not running, this will be called shortly after application:didFinishLaunchingWithOptions. diff --git a/Example/DApp/DAppRelease.entitlements b/Example/DApp/DAppRelease.entitlements new file mode 100644 index 000000000..3a11207e5 --- /dev/null +++ b/Example/DApp/DAppRelease.entitlements @@ -0,0 +1,12 @@ + + + + + com.apple.developer.associated-domains + + com.apple.security.application-groups + + group.com.walletconnect.dapp + + + diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index a4e58c95a..43253e8d5 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -108,6 +108,18 @@ final class SignPresenter: ObservableObject { } } + @MainActor + func connectWalletWithSessionAuthenticateLinkMode() { + + Task { + do { + try await Sign.instance.authenticateLinkMode(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://walletconnect.com") + } catch { + AlertPresenter.present(message: error.localizedDescription, type: .error) + } + } + } + func disconnect() { if let session { Task { @MainActor in diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index 9e7ea99a6..04b4036dd 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -20,6 +20,19 @@ struct SignView: View { VStack(spacing: 10) { + + Button { + presenter.connectWalletWithSessionAuthenticateLinkMode() + } label: { + Text("1-Click Auth with Link Mode") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + Button { presenter.connectWalletWithW3M() } label: { diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index c8abceae9..a318e05a6 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -12,6 +12,17 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { private let app = Application() + + func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { + guard let url = userActivity.webpageURL, + let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { + return + } + try! Sign.instance.dispatchEnvelope(url.absoluteString) + + } + + func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { Networking.configure( groupIdentifier: "group.com.walletconnect.dapp", @@ -25,7 +36,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { description: "WalletConnect DApp sample", url: "wallet.connect", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: nil) + redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "www.walletconnect.com/dapp") ) Web3Modal.configure( diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 467cfbd55..f2bc0a4e4 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -437,6 +437,7 @@ 84E6B84729787A8000428BAF /* PNDecryptionService.appex */ = {isa = PBXFileReference; explicitFileType = "wrapper.app-extension"; includeInIndex = 0; path = PNDecryptionService.appex; sourceTree = BUILT_PRODUCTS_DIR; }; 84E6B84929787A8000428BAF /* NotificationService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotificationService.swift; sourceTree = ""; }; 84E6B84B29787A8000428BAF /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; + 84F1CD392BBD414000D2A6E2 /* DAppRelease.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DAppRelease.entitlements; sourceTree = ""; }; 84F568C1279582D200D0A289 /* Signer.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Signer.swift; sourceTree = ""; }; 84F568C32795832A00D0A289 /* EthereumTransaction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = EthereumTransaction.swift; sourceTree = ""; }; 84FE684528ACDB4700C893FF /* RequestParams.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RequestParams.swift; sourceTree = ""; }; @@ -941,6 +942,7 @@ 84CE641D27981DED00142511 /* DApp */ = { isa = PBXGroup; children = ( + 84F1CD392BBD414000D2A6E2 /* DAppRelease.entitlements */, 84D72FC62B4692770057EAF3 /* DApp.entitlements */, C5BE01E02AF692F80064FC88 /* ApplicationLayer */, C5BE02202AF7DDE70064FC88 /* Modules */, @@ -2789,7 +2791,7 @@ ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; - CODE_SIGN_ENTITLEMENTS = DApp/DApp.entitlements; + CODE_SIGN_ENTITLEMENTS = DApp/DAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 18; diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index bbc62c70f..35be7ccc4 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -1,6 +1,7 @@ import SafariServices import UIKit import Web3Wallet +import WalletConnectSign final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificationCenterDelegate { var window: UIWindow? @@ -16,6 +17,15 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio ] } + func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { + guard let url = userActivity.webpageURL, + let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { + return + } + try! Sign.instance.dispatchEnvelope(url.absoluteString) + + } + func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration { let sceneConfig = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role) sceneConfig.delegateClass = SceneDelegate.self diff --git a/Example/WalletApp/WalletApp.entitlements b/Example/WalletApp/WalletApp.entitlements index 46de0afbc..247b8f47a 100644 --- a/Example/WalletApp/WalletApp.entitlements +++ b/Example/WalletApp/WalletApp.entitlements @@ -4,6 +4,10 @@ aps-environment development + com.apple.developer.associated-domains + + applinks:walletconnect.com + com.apple.developer.usernotifications.communication com.apple.security.application-groups diff --git a/Example/WalletApp/WalletAppRelease.entitlements b/Example/WalletApp/WalletAppRelease.entitlements index 7028e40d9..b646bb057 100644 --- a/Example/WalletApp/WalletAppRelease.entitlements +++ b/Example/WalletApp/WalletAppRelease.entitlements @@ -4,6 +4,12 @@ aps-environment production + com.apple.developer.associated-domains + + applinks:walletconnect.com + applinks:https://walletconnect.com + applinks:www.walletconnect.com + com.apple.developer.usernotifications.communication com.apple.security.application-groups diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index 0048c5bf0..140bdc1d4 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -19,9 +19,10 @@ public struct Envelope: Equatable { /// type0: tp + sealbox /// type1: tp + pk + sealbox init(_ base64encoded: String) throws { - guard let envelopeData = Data(base64Encoded: base64encoded) else { + guard let envelopeData = Data(base64Encoded: base64encoded) ?? Data(base64url: base64encoded) else { throw Errors.malformedEnvelope } + let envelopeTypeByte = envelopeData.subdata(in: 0..<1).first if envelopeTypeByte == 0 { self.type = .type0 @@ -52,7 +53,7 @@ public struct Envelope: Equatable { case .type1(let pubKey): return (type.representingByte.data + pubKey + sealbox).base64EncodedString() case .type2: - return (type.representingByte.data + sealbox).base64EncodedString() + return (type.representingByte.data + sealbox).base64urlEncodedString() } } diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index a725e50e8..1b047932b 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -111,7 +111,8 @@ public class Serializer: Serializing { /// Serializes envelope type 2 private func serializeEnvelopeType2(encodable: Encodable) throws -> String { let messageData = try JSONEncoder().encode(encodable) - return Envelope(type: .type2, sealbox: messageData).serialised() + let envelope = Envelope(type: .type2, sealbox: messageData) + return envelope.serialised() } private func handleType1Envelope(_ topic: String, peerPubKey: Data, sealbox: Data) throws -> (T, String, Data) { diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 224f5b369..d76493138 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -56,11 +56,13 @@ class LinkEnvelopesDispatcher { try rpcHistory.set(request, forTopic: topic, emmitedBy: .local, transportType: .relay) - var envelopeUrl: URL! + let envelopeUrl: URL do { envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: request, envelopeType: envelopeType, topic: topic) - // await UIApplication.shared.open(finalURL) + DispatchQueue.main.async { + UIApplication.shared.open(envelopeUrl) + } } catch { if let id = request.id { rpcHistory.delete(id: id) @@ -68,15 +70,15 @@ class LinkEnvelopesDispatcher { throw error } - return envelopeUrl.absoluteString } func respond(topic: String, response: RPCResponse, peerUniversalLink: String, envelopeType: Envelope.EnvelopeType) async throws -> String { try rpcHistory.validate(response) let envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: response, envelopeType: envelopeType, topic: topic) - - // await UIApplication.shared.open(finalURL) + DispatchQueue.main.async { + UIApplication.shared.open(envelopeUrl) + } try rpcHistory.resolve(response) return envelopeUrl.absoluteString @@ -136,7 +138,7 @@ class LinkEnvelopesDispatcher { } else if let (response, _, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { handleResponse(topic: topic, response: response) } else { - logger.debug("Networking Interactor - Received unknown object type from networking relay") + logger.debug("Link Dispatcher - Received unknown object type from networking relay") } } diff --git a/Tests/WalletConnectKMSTests/EnvelopeTests.swift b/Tests/WalletConnectKMSTests/EnvelopeTests.swift index 13aa81647..3002c0cf1 100644 --- a/Tests/WalletConnectKMSTests/EnvelopeTests.swift +++ b/Tests/WalletConnectKMSTests/EnvelopeTests.swift @@ -12,4 +12,11 @@ final class EnvelopeTests: XCTestCase { XCTAssertEqual(envelope, deserialised) } + func testDeserialise() { + let serialised = "AnsibWV0aG9kIjoid2Nfc2Vzc2lvbkF1dGhlbnRpY2F0ZSIsImlkIjoxNzEyMjIwNjg1NjM1MzAzLCJqc29ucnBjIjoiMi4wIiwicGFyYW1zIjp7ImV4cGlyeVRpbWVzdGFtcCI6MTcxMjIyNDI4NSwiYXV0aFBheWxvYWQiOnsidHlwZSI6ImVpcDQzNjEiLCJzdGF0ZW1lbnQiOiJJIGFjY2VwdCB0aGUgU2VydmljZU9yZyBUZXJtcyBvZiBTZXJ2aWNlOiBodHRwczpcL1wvYXBwLndlYjNpbmJveC5jb21cL3RvcyIsImNoYWlucyI6WyJlaXAxNTU6MSIsImVpcDE1NToxMzciXSwicmVzb3VyY2VzIjpbInVybjpyZWNhcDpleUpoZEhRaU9uc2laV2x3TVRVMUlqcDdJbkpsY1hWbGMzUXZjR1Z5YzI5dVlXeGZjMmxuYmlJNlczdDlYWDE5ZlE9PSJdLCJkb21haW4iOiJhcHAud2ViM2luYm94IiwidmVyc2lvbiI6IjEiLCJhdWQiOiJodHRwczpcL1wvYXBwLndlYjNpbmJveC5jb21cL2xvZ2luIiwibm9uY2UiOiIzMjg5MTc1NiIsImlhdCI6IjIwMjQtMDQtMDRUMDg6NTE6MjVaIn0sInJlcXVlc3RlciI6eyJwdWJsaWNLZXkiOiIxOWYzNmY1N2M1NjYxNDY4ODk0NmU3MzliNzY4NmE2ZmE1OGNiZWFmOGQ3MzZmM2EzZDI2NjVlM2NlYmE4ZDQ5IiwibWV0YWRhdGEiOnsicmVkaXJlY3QiOnsibmF0aXZlIjoid2NkYXBwOlwvXC8iLCJ1bml2ZXJzYWwiOiJ3d3cud2FsbGV0Y29ubmVjdC5jb21cL2RhcHAifSwiaWNvbnMiOlsiaHR0cHM6XC9cL2F2YXRhcnMuZ2l0aHVidXNlcmNvbnRlbnQuY29tXC91XC8zNzc4NDg4NiJdLCJkZXNjcmlwdGlvbiI6IldhbGxldENvbm5lY3QgREFwcCBzYW1wbGUiLCJ1cmwiOiJ3YWxsZXQuY29ubmVjdCIsIm5hbWUiOiJTd2lmdCBEYXBwIn19fX0" + + let deserialised = try! Envelope(serialised) + XCTAssertEqual(deserialised.type, .type2) + } + } From 73a08a82e7a0488fdd1d687599e88b6ca88d6eaf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Apr 2024 13:36:05 +0200 Subject: [PATCH 522/814] savepoint --- Example/DApp/DApp.entitlements | 5 +++++ Example/DApp/DAppRelease.entitlements | 5 ++++- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- Example/DApp/SceneDelegate.swift | 6 +++++- .../ApplicationLayer/ConfigurationService.swift | 4 ++-- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 12 ++++++------ Example/WalletApp/WalletAppRelease.entitlements | 2 -- Sources/WalletConnectKMS/Serialiser/Envelope.swift | 4 ++-- 8 files changed, 25 insertions(+), 15 deletions(-) diff --git a/Example/DApp/DApp.entitlements b/Example/DApp/DApp.entitlements index 3396b33e2..1df7fdf23 100644 --- a/Example/DApp/DApp.entitlements +++ b/Example/DApp/DApp.entitlements @@ -2,6 +2,11 @@ + com.apple.developer.associated-domains + + applinks:walletconnect.com + applinks:www.walletconnect.com + com.apple.security.application-groups group.com.walletconnect.dapp diff --git a/Example/DApp/DAppRelease.entitlements b/Example/DApp/DAppRelease.entitlements index 3a11207e5..1df7fdf23 100644 --- a/Example/DApp/DAppRelease.entitlements +++ b/Example/DApp/DAppRelease.entitlements @@ -3,7 +3,10 @@ com.apple.developer.associated-domains - + + applinks:walletconnect.com + applinks:www.walletconnect.com + com.apple.security.application-groups group.com.walletconnect.dapp diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 43253e8d5..da00bd6ce 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -113,7 +113,7 @@ final class SignPresenter: ObservableObject { Task { do { - try await Sign.instance.authenticateLinkMode(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://walletconnect.com") + try await Sign.instance.authenticateLinkMode(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://walletconnect.com/wallet") } catch { AlertPresenter.present(message: error.localizedDescription, type: .error) } diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index a318e05a6..9bf514182 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -18,7 +18,11 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { return } - try! Sign.instance.dispatchEnvelope(url.absoluteString) + do { + try Sign.instance.dispatchEnvelope(url.absoluteString) + } catch { + print("🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨") + } } diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 51d1f0c28..702de6e78 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: nil) + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "www.walletconnect.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) @@ -81,7 +81,7 @@ final class ConfigurationService { do { let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") let signature = importAccount.onSign(message: params.message) - try await Notify.instance.register(params: params, signature: signature) +// try await Notify.instance.register(params: params, signature: signature) } catch { DispatchQueue.main.async { let logMessage = LogMessage(message: "Push Server registration failed with: \(error.localizedDescription)") diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 01813b92f..a6cb1effa 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -60,12 +60,12 @@ final class AuthRequestPresenter: ObservableObject { ActivityIndicatorManager.shared.stop() /* Redirect */ - if let uri = request.requester.redirect?.native { - WalletConnectRouter.goBack(uri: uri) - router.dismiss() - } else { - showSignedSheet.toggle() - } +// if let uri = request.requester.redirect?.native { +// WalletConnectRouter.goBack(uri: uri) +// router.dismiss() +// } else { +// showSignedSheet.toggle() +// } } catch { ActivityIndicatorManager.shared.stop() diff --git a/Example/WalletApp/WalletAppRelease.entitlements b/Example/WalletApp/WalletAppRelease.entitlements index b646bb057..8dd42e4bc 100644 --- a/Example/WalletApp/WalletAppRelease.entitlements +++ b/Example/WalletApp/WalletAppRelease.entitlements @@ -7,8 +7,6 @@ com.apple.developer.associated-domains applinks:walletconnect.com - applinks:https://walletconnect.com - applinks:www.walletconnect.com com.apple.developer.usernotifications.communication diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index 140bdc1d4..13d36021f 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -49,9 +49,9 @@ public struct Envelope: Equatable { func serialised() -> String { switch type { case .type0: - return (type.representingByte.data + sealbox).base64EncodedString() + return (type.representingByte.data + sealbox).base64urlEncodedString() case .type1(let pubKey): - return (type.representingByte.data + pubKey + sealbox).base64EncodedString() + return (type.representingByte.data + pubKey + sealbox).base64urlEncodedString() case .type2: return (type.representingByte.data + sealbox).base64urlEncodedString() } From f9ee474bc84c2004a78b5336b4b2460f3d7048a9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Apr 2024 13:50:15 +0200 Subject: [PATCH 523/814] savepoint --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index f22dcfa95..2765f348e 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -57,7 +57,7 @@ final class AuthRequestPresenter: ObservableObject { do { ActivityIndicatorManager.shared.start() - let auths = try buildAuthObjects() + let auths = try buildOneAuthObject() _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) ActivityIndicatorManager.shared.stop() From bc0ddec3944b702039525a022b92826d05701e6f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Apr 2024 08:05:32 +0200 Subject: [PATCH 524/814] successfully transport response --- Example/DApp/SceneDelegate.swift | 2 +- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 7 +++++-- Example/WalletApp/WalletApp.entitlements | 1 + Example/WalletApp/WalletAppRelease.entitlements | 1 + 4 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 9bf514182..3830d710a 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -40,7 +40,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { description: "WalletConnect DApp sample", url: "wallet.connect", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "www.walletconnect.com/dapp") + redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://www.walletconnect.com/dapp") ) Web3Modal.configure( diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 35be7ccc4..bc148975c 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -22,8 +22,11 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { return } - try! Sign.instance.dispatchEnvelope(url.absoluteString) - + do { + try Sign.instance.dispatchEnvelope(url.absoluteString) + } catch { + print("🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨") + } } func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration { diff --git a/Example/WalletApp/WalletApp.entitlements b/Example/WalletApp/WalletApp.entitlements index 247b8f47a..50ae16704 100644 --- a/Example/WalletApp/WalletApp.entitlements +++ b/Example/WalletApp/WalletApp.entitlements @@ -7,6 +7,7 @@ com.apple.developer.associated-domains applinks:walletconnect.com + applinks:www.walletconnect.com com.apple.developer.usernotifications.communication diff --git a/Example/WalletApp/WalletAppRelease.entitlements b/Example/WalletApp/WalletAppRelease.entitlements index 8dd42e4bc..3cf0aee3e 100644 --- a/Example/WalletApp/WalletAppRelease.entitlements +++ b/Example/WalletApp/WalletAppRelease.entitlements @@ -7,6 +7,7 @@ com.apple.developer.associated-domains applinks:walletconnect.com + applinks:www.walletconnect.com com.apple.developer.usernotifications.communication From c45c03bb4d4f93d57ba0b7dfc17d1f401d3fcaec Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Apr 2024 10:36:56 +0200 Subject: [PATCH 525/814] turn off notify --- .../ApplicationLayer/ConfigurationService.swift | 4 ++-- .../Wallet/PushMessages/SubscriptionPresenter.swift | 12 ++++++------ 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 702de6e78..30643bdb6 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -79,8 +79,8 @@ final class ConfigurationService { Task { do { - let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") - let signature = importAccount.onSign(message: params.message) + // let params = try await Notify.instance.prepareRegistration(account: importAccount.account, domain: "com.walletconnect") + // let signature = importAccount.onSign(message: params.message) // try await Notify.instance.register(params: params, signature: signature) } catch { DispatchQueue.main.async { diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift index 2f9bb1a21..78ec0b532 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift @@ -38,12 +38,12 @@ final class SubscriptionPresenter: ObservableObject { } private func setUpMessagesRefresh() { - Timer.publish(every: 10.0, on: .main, in: .default) - .autoconnect() - .sink(receiveValue: { [weak self] _ in - guard let self = self else { return } - self.pushMessages = self.interactor.getPushMessages() - }).store(in: &disposeBag) +// Timer.publish(every: 10.0, on: .main, in: .default) +// .autoconnect() +// .sink(receiveValue: { [weak self] _ in +// guard let self = self else { return } +// self.pushMessages = self.interactor.getPushMessages() +// }).store(in: &disposeBag) } func deletePushMessage(at indexSet: IndexSet) { From 3bf55dd9f7ed1e61deff916959b661f118bae0d1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Apr 2024 12:55:07 +0200 Subject: [PATCH 526/814] savepoint --- Example/WalletApp/ApplicationLayer/ConfigurationService.swift | 2 +- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 30643bdb6..e11004c95 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "www.walletconnect.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://www.walletconnect.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 2765f348e..c72cc3ae3 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -61,7 +61,7 @@ final class AuthRequestPresenter: ObservableObject { _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) ActivityIndicatorManager.shared.stop() - + router.dismiss() /* Redirect */ // if let uri = request.requester.redirect?.native { // WalletConnectRouter.goBack(uri: uri) From 1ab1591009d31b0fdb43ff912999c531b9004e2c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Apr 2024 13:43:34 +0200 Subject: [PATCH 527/814] Add tryDeserializeRequestOrResponse to the serialiser --- .../Serialiser/Serializer.swift | 5 +- .../Serialiser/Serializing.swift | 20 ++++++- .../SerialiserTests.swift | 57 +++++++++++++++++++ 3 files changed, 78 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index 1b047932b..ed48947fc 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -25,7 +25,7 @@ public class Serializer: Serializing { private let kms: KeyManagementServiceProtocol private let codec: Codec - private let logger: ConsoleLogging + public let logger: ConsoleLogging public var logsPublisher: AnyPublisher { logger.logsPublisher.eraseToAnyPublisher() } @@ -149,8 +149,7 @@ public class Serializer: Serializing { return (decodedType, decryptedData) } catch { let str = String(decoding: decryptedData, as: UTF8.self) - print(str) - logger.error("Failed to decode with error: \(error)") + logger.debug(str) throw error } } diff --git a/Sources/WalletConnectKMS/Serialiser/Serializing.swift b/Sources/WalletConnectKMS/Serialiser/Serializing.swift index 7bc5088eb..0a7658755 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializing.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializing.swift @@ -3,7 +3,8 @@ import Combine public protocol Serializing { var logsPublisher: AnyPublisher {get} - func setLogging(level: LoggingLevel) + var logger: ConsoleLogging {get} + func setLogging(level: LoggingLevel) func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key func deserialize(topic: String, encodedEnvelope: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) @@ -18,4 +19,21 @@ public extension Serializing { func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType = .type0) throws -> String { try serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) } + + func tryDeserializeRequestOrResponse(topic: String, encodedEnvelope: String) -> Either? { + // Attempt to deserialize RPCRequest + if let result = try? deserialize(topic: topic, encodedEnvelope: encodedEnvelope) as (RPCRequest, derivedTopic: String?, decryptedPayload: Data) { + return .left(result.0) + } + + // Attempt to deserialize RPCResponse + if let result = try? deserialize(topic: topic, encodedEnvelope: encodedEnvelope) as (RPCResponse, derivedTopic: String?, decryptedPayload: Data) { + return .right(result.0) + } + + // If both attempts fail, log an error and return nil + logger.error("Failed to deserialize both request and response for topic: \(topic)") + return nil + } + } diff --git a/Tests/WalletConnectKMSTests/SerialiserTests.swift b/Tests/WalletConnectKMSTests/SerialiserTests.swift index ca0aff3b2..c7187522f 100644 --- a/Tests/WalletConnectKMSTests/SerialiserTests.swift +++ b/Tests/WalletConnectKMSTests/SerialiserTests.swift @@ -62,4 +62,61 @@ final class SerializerTests: XCTestCase { XCTAssertEqual(messageToSerialize, deserializedMessage) } + func testDeserializeRequestSuccessfully() { + // Using a dictionary as params to adhere to the non-primitive requirement + struct TestType: Codable { + let string: String + } + let testType = TestType(string: "") + let anyCodableParams = AnyCodable(testType) + + let request = RPCRequest(method: "testMethod", params: anyCodableParams, id: 123) + let topic = TopicGenerator().topic + _ = try! myKms.createSymmetricKey(topic) + let serialized = try! mySerializer.serialize(topic: topic, encodable: request, envelopeType: .type0) + + if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: serialized) { + switch result { + case .left(let deserializedRequest): + XCTAssertEqual(deserializedRequest.method, request.method) + XCTAssertEqual(deserializedRequest.id, request.id) + // You'll need to compare the params more thoroughly in practice. + default: + XCTFail("Deserialization should have succeeded with RPCRequest") + } + } else { + XCTFail("Deserialization failed") + } + } + + + func testDeserializeResponseSuccessfully() { + let response = RPCResponse(id: 123, result: "testResult") + let topic = TopicGenerator().topic + _ = try! myKms.createSymmetricKey(topic) + let serialized = try! mySerializer.serialize(topic: topic, encodable: response, envelopeType: .type0) + + if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: serialized) { + switch result { + case .right(let deserializedResponse): + XCTAssertEqual(deserializedResponse, response) + default: + XCTFail("Deserialization should have succeeded with RPCResponse") + } + } else { + XCTFail("Deserialization failed") + } + } + + func testDeserializeFailure() { + let invalidData = "invalidData" + let topic = TopicGenerator().topic + _ = try! myKms.createSymmetricKey(topic) + // Assuming serialize can accept invalidData for the purpose of this test + let serialized = try! mySerializer.serialize(topic: topic, encodable: invalidData, envelopeType: .type0) + + let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: serialized) + XCTAssertNil(result, "Deserialization should fail for invalid data") + } + } From 892369e64bacd727160471cde47bcaf122dbaf2a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Apr 2024 13:43:51 +0200 Subject: [PATCH 528/814] integrate tryDeserializeRequestOrResponse in LinkDispatcher --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index d76493138..af766f332 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -133,10 +133,13 @@ class LinkEnvelopesDispatcher { } private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { - if let (deserializedJsonRpcRequest, _, _): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { - handleRequest(topic: topic, request: deserializedJsonRpcRequest) - } else if let (response, _, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { - handleResponse(topic: topic, response: response) + if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: encodedEnvelope) { + switch result { + case .left(let request): + handleRequest(topic: topic, request: request) + case .right(let response): + handleResponse(topic: topic, response: response) + } } else { logger.debug("Link Dispatcher - Received unknown object type from networking relay") } From 8bb4f6729646fd4f7e36ac931308d57b601bd40d Mon Sep 17 00:00:00 2001 From: Paul <515868+eyeamera@users.noreply.github.com> Date: Tue, 9 Apr 2024 09:50:08 -0400 Subject: [PATCH 529/814] Fix import issue with WalletConnectUtils The following compilation error occurs when installed via cocoapods with DEBUG enabled. ``` 37 | ) 38 | let signature = CacaoSignature( > 39 | t: WalletConnectUtils.CacaoSignatureType.eip191, | ^ cannot find 'WalletConnectUtils' in scope 40 | s: "invalid_signature", 41 | m: nil 42 | ) ``` --- Sources/WalletConnectUtils/Cacao/Cacao.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectUtils/Cacao/Cacao.swift b/Sources/WalletConnectUtils/Cacao/Cacao.swift index 16a0bf754..8e174c074 100644 --- a/Sources/WalletConnectUtils/Cacao/Cacao.swift +++ b/Sources/WalletConnectUtils/Cacao/Cacao.swift @@ -36,7 +36,7 @@ extension Cacao { resources: resources ) let signature = CacaoSignature( - t: WalletConnectUtils.CacaoSignatureType.eip191, + t: CacaoSignatureType.eip191, s: "invalid_signature", m: nil ) From 805f7d1a3be57dc2ef353933b4b3efdb8c8714b9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Apr 2024 13:57:05 +0200 Subject: [PATCH 530/814] savepoint --- Sources/WalletConnectRelay/RelayClient.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index c3146adc3..e1a1b9197 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -102,7 +102,7 @@ public final class RelayClient { logger.debug("[Publish] Sending payload on topic: \(topic)") - Task {try await dispatcher.protectedSend(message)} + try await dispatcher.protectedSend(message) return try await withUnsafeThrowingContinuation { continuation in var cancellable: AnyCancellable? From 2fcde83908ded2c7543f6a2a004285acc1f1c60e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Apr 2024 14:52:01 +0200 Subject: [PATCH 531/814] refactor dispatcher --- Sources/WalletConnectRelay/Dispatching.swift | 46 ++++++------------- .../RelayClientFactory.swift | 26 +++++++++-- .../WalletConnectRelay/RelayURLFactory.swift | 13 ++++-- .../AutomaticSocketConnectionHandler.swift | 4 ++ .../ManualSocketConnectionHandler.swift | 7 +++ .../SocketConnectionHandler.swift | 1 + .../SocketUrlFallbackHandler.swift | 32 +++++++++++++ 7 files changed, 91 insertions(+), 38 deletions(-) create mode 100644 Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 7d13bc39f..10ab43fd5 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -16,16 +16,14 @@ final class Dispatcher: NSObject, Dispatching { var onMessage: ((String) -> Void)? var socket: WebSocketConnecting var socketConnectionHandler: SocketConnectionHandler - + var socketUrlFallbackHandler: SocketUrlFallbackHandler + private let relayUrlFactory: RelayUrlFactory private let networkMonitor: NetworkMonitoring private let logger: ConsoleLogging private let defaultTimeout: Int = 5 - /// The property is used to determine whether relay.walletconnect.org will be used - /// in case relay.walletconnect.com doesn't respond for some reason (most likely due to being blocked in the user's location). - private var fallback = false - + private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) var socketConnectionStatusPublisher: AnyPublisher { @@ -42,25 +40,19 @@ final class Dispatcher: NSObject, Dispatching { socketFactory: WebSocketFactory, relayUrlFactory: RelayUrlFactory, networkMonitor: NetworkMonitoring, - socketConnectionType: SocketConnectionType, - logger: ConsoleLogging + socket: WebSocketConnecting, + logger: ConsoleLogging, + socketUrlFallbackHandler: SocketUrlFallbackHandler, + socketConnectionHandler:SocketConnectionHandler ) { + self.socketConnectionHandler = socketConnectionHandler self.relayUrlFactory = relayUrlFactory self.networkMonitor = networkMonitor self.logger = logger - - let socket = socketFactory.create(with: relayUrlFactory.create(fallback: fallback)) - socket.request.addValue(EnvironmentInfo.userAgent, forHTTPHeaderField: "User-Agent") - if let bundleId = Bundle.main.bundleIdentifier { - socket.request.addValue(bundleId, forHTTPHeaderField: "Origin") - } + self.socket = socket - - switch socketConnectionType { - case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket) - case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket) - } - + self.socketUrlFallbackHandler = socketUrlFallbackHandler + super.init() setUpWebSocketSession() setUpSocketConnectionObserving() @@ -91,7 +83,7 @@ final class Dispatcher: NSObject, Dispatching { case .failure(let error): cancellable?.cancel() if !socket.isConnected { - handleFallbackIfNeeded(error: error) + socketUrlFallbackHandler.handleFallbackIfNeeded(error: error) } completion(error) case .finished: break @@ -101,6 +93,7 @@ final class Dispatcher: NSObject, Dispatching { send(string, completion: completion) }) } + func protectedSend(_ string: String) async throws { return try await withCheckedThrowingContinuation { continuation in @@ -138,19 +131,8 @@ extension Dispatcher { socket.onDisconnect = { [unowned self] error in self.socketConnectionStatusPublisherSubject.send(.disconnected) if error != nil { - self.socket.request.url = relayUrlFactory.create(fallback: fallback) - } - Task(priority: .high) { - await self.socketConnectionHandler.handleDisconnection() + self.socket.request.url = relayUrlFactory.create() } - } - } - - private func handleFallbackIfNeeded(error: NetworkError) { - if error == .connectionFailed && socket.request.url?.host == NetworkConstants.defaultUrl { - logger.debug("[WebSocket] - Fallback to \(NetworkConstants.fallbackUrl)") - fallback = true - socket.request.url = relayUrlFactory.create(fallback: fallback) Task(priority: .high) { await self.socketConnectionHandler.handleDisconnection() } diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index b59a50d29..f6eda742b 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -56,13 +56,33 @@ public struct RelayClientFactory { projectId: projectId, socketAuthenticator: socketAuthenticator ) + let socket = socketFactory.create(with: relayUrlFactory.create()) + socket.request.addValue(EnvironmentInfo.userAgent, forHTTPHeaderField: "User-Agent") + if let bundleId = Bundle.main.bundleIdentifier { + socket.request.addValue(bundleId, forHTTPHeaderField: "Origin") + } + var socketConnectionHandler: SocketConnectionHandler! + switch socketConnectionType { + case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket) + case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket) + } + + let socketFallbackHandler = SocketUrlFallbackHandler( + relayUrlFactory: relayUrlFactory, + logger: logger, + socketConnectionHandler: socketConnectionHandler, + socket: socket, + networkMonitor: networkMonitor + ) let dispatcher = Dispatcher( socketFactory: socketFactory, - relayUrlFactory: relayUrlFactory, + relayUrlFactory: relayUrlFactory, networkMonitor: networkMonitor, - socketConnectionType: socketConnectionType, - logger: logger + socket: socket, + logger: logger, + socketUrlFallbackHandler: socketFallbackHandler, + socketConnectionHandler: socketConnectionHandler ) let rpcHistory = RPCHistoryFactory.createForRelay(keyValueStorage: keyValueStorage) diff --git a/Sources/WalletConnectRelay/RelayURLFactory.swift b/Sources/WalletConnectRelay/RelayURLFactory.swift index ff99759c0..20290fd24 100644 --- a/Sources/WalletConnectRelay/RelayURLFactory.swift +++ b/Sources/WalletConnectRelay/RelayURLFactory.swift @@ -1,10 +1,13 @@ import Foundation -struct RelayUrlFactory { +class RelayUrlFactory { private let relayHost: String private let projectId: String private let socketAuthenticator: ClientIdAuthenticating - + /// The property is used to determine whether relay.walletconnect.org will be used + /// in case relay.walletconnect.com doesn't respond for some reason (most likely due to being blocked in the user's location). + private var fallback: Bool = false + init( relayHost: String, projectId: String, @@ -15,7 +18,11 @@ struct RelayUrlFactory { self.socketAuthenticator = socketAuthenticator } - func create(fallback: Bool) -> URL { + func setFallback() { + self.fallback = true + } + + func create() -> URL { var components = URLComponents() components.scheme = "wss" components.host = fallback ? NetworkConstants.fallbackUrl : relayHost diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 99c61c61c..adb0d3929 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -73,6 +73,10 @@ class AutomaticSocketConnectionHandler { // MARK: - SocketConnectionHandler extension AutomaticSocketConnectionHandler: SocketConnectionHandler { + func tryReconect() async { + guard await appStateObserver.currentState == .foreground else { return } + reconnectIfNeeded() + } func handleConnect() throws { throw Errors.manualSocketConnectionForbidden diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index 7f145d1c5..2198c9e12 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -1,6 +1,7 @@ import Foundation class ManualSocketConnectionHandler: SocketConnectionHandler { + var socket: WebSocketConnecting init(socket: WebSocketConnecting) { @@ -19,4 +20,10 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { // No operation // ManualSocketConnectionHandler does not support reconnection logic } + + func tryReconect() async { + if !socket.isConnected { + socket.connect() + } + } } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift index 4ac3046dd..91284893b 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift @@ -4,4 +4,5 @@ protocol SocketConnectionHandler { func handleConnect() throws func handleDisconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws func handleDisconnection() async + func tryReconect() async } diff --git a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift new file mode 100644 index 000000000..0db60b2f4 --- /dev/null +++ b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift @@ -0,0 +1,32 @@ +import Foundation + +class SocketUrlFallbackHandler { + private let relayUrlFactory: RelayUrlFactory + private var logger: ConsoleLogging + private var socketConnectionHandler: SocketConnectionHandler + private var socket: WebSocketConnecting + private let networkMonitor: NetworkMonitoring + + init(relayUrlFactory: RelayUrlFactory, + logger: ConsoleLogging, + socketConnectionHandler: SocketConnectionHandler, + socket: WebSocketConnecting, + networkMonitor: NetworkMonitoring) { + self.relayUrlFactory = relayUrlFactory + self.logger = logger + self.socketConnectionHandler = socketConnectionHandler + self.socket = socket + self.networkMonitor = networkMonitor + } + + func handleFallbackIfNeeded(error: NetworkError) { + if error == .connectionFailed && socket.request.url?.host == NetworkConstants.defaultUrl { + logger.debug("[WebSocket] - Fallback to \(NetworkConstants.fallbackUrl)") + relayUrlFactory.setFallback() + socket.request.url = relayUrlFactory.create() + Task(priority: .high) { + await self.socketConnectionHandler.tryReconect() + } + } + } +} From 2942f0132d1ec5243a96b669b54afadfc1cfffec Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 12 Apr 2024 08:34:43 +0200 Subject: [PATCH 532/814] savepoint --- Sources/WalletConnectRelay/Dispatching.swift | 1 + 1 file changed, 1 insertion(+) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 10ab43fd5..2d18d1fdd 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -109,6 +109,7 @@ final class Dispatcher: NSObject, Dispatching { func connect() throws { try socketConnectionHandler.handleConnect() + start counting for fallback on first connect attempt } func disconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws { From 0311d6784cf9ea8960db59537e3367b0be93e6f1 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Fri, 12 Apr 2024 09:21:48 +0000 Subject: [PATCH 533/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 2c162848f..21ba9ac25 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.4"} +{"version": "1.18.5"} From 5e7e8333fe33e07009a7311bd7758650dca45d99 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 09:30:55 +0400 Subject: [PATCH 534/814] add LinkSessionRequestSubscriber --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 6 ++ .../Link/LinkSessionRequestSubscriber.swift | 80 +++++++++++++++++++ .../Engine/Common/SessionEngine.swift | 1 - ...ApproveSessionAuthenticateDispatcher.swift | 0 4 files changed, 86 insertions(+), 1 deletion(-) create mode 100644 Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift rename Sources/WalletConnectSign/{Auth => LinkAndRelayDispatchers}/ApproveSessionAuthenticateDispatcher.swift (100%) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index af766f332..9b1e46477 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -84,6 +84,12 @@ class LinkEnvelopesDispatcher { return envelopeUrl.absoluteString } + public func respondError(topic: String, requestId: RPCID, peerUniversalLink: String, reason: Reason, envelopeType: Envelope.EnvelopeType) async throws { + let error = JSONRPCError(code: reason.code, message: reason.message) + let response = RPCResponse(id: requestId, error: error) + try await respond(topic: topic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: envelopeType) + } + private func serializeAndCreateUrl(peerUniversalLink: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType, topic: String) throws -> URL { let envelope = try serializer.serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift new file mode 100644 index 000000000..98be79da0 --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift @@ -0,0 +1,80 @@ +import Foundation +import Combine + +class LinkSessionRequestSubscriber { + + private let sessionRequestsProvider: SessionRequestsProvider + private let sessionStore: WCSessionStorage + private var publishers = [AnyCancellable]() + private let logger: ConsoleLogging + private let envelopesDispatcher: LinkEnvelopesDispatcher + + init( + sessionRequestsProvider: SessionRequestsProvider, + sessionStore: WCSessionStorage, + logger: ConsoleLogging, + envelopesDispatcher: LinkEnvelopesDispatcher + ) { + self.sessionRequestsProvider = sessionRequestsProvider + self.sessionStore = sessionStore + self.logger = logger + self.envelopesDispatcher = envelopesDispatcher + } + + var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { + return sessionRequestsProvider.sessionRequestPublisher + } + + func setupRequestSubscriptions() { + envelopesDispatcher.requestSubscription(on: SessionRequestProtocolMethod().method) + .sink { [unowned self] (payload: RequestSubscriptionPayload) in + Task(priority: .high) { + onSessionRequest(payload: payload) + } + }.store(in: &publishers) + } + + func onSessionRequest(payload: RequestSubscriptionPayload) { + logger.debug("Received session request") + let protocolMethod = SessionRequestProtocolMethod() + let topic = payload.topic + let request = Request( + id: payload.id, + topic: payload.topic, + method: payload.request.request.method, + params: payload.request.request.params, + chainId: payload.request.chainId, + expiryTimestamp: payload.request.request.expiryTimestamp + ) + guard let session = sessionStore.getSession(forTopic: topic) else { + logger.debug("Session for topic not found") + return + } + guard let peerUniversalLink = session.peerParticipant.metadata.redirect?.universal else { + logger.debug("Peer universal link not found") + return + } + guard session.hasNamespace(for: request.chainId) else { + return respondError(payload: payload, reason: .unauthorizedChain, peerUniversalLink: peerUniversalLink) + } + guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + return respondError(payload: payload, reason: .unauthorizedMethod(request.method), peerUniversalLink: peerUniversalLink) + } + guard !request.isExpired() else { + return respondError(payload: payload, reason: .sessionRequestExpired, peerUniversalLink: peerUniversalLink) + } + + sessionRequestsProvider.emitRequestIfPending() + } + + func respondError(payload: SubscriptionPayload, reason: SignReasonCode, peerUniversalLink: String) { + Task(priority: .high) { + do { + + try await envelopesDispatcher.respondError(topic: payload.topic, requestId: payload.id, peerUniversalLink: peerUniversalLink, reason: reason, envelopeType: .type0) + } catch { + logger.error("Respond Error failed with: \(error.localizedDescription)") + } + } + } +} diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 435f34f98..42a577091 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -8,7 +8,6 @@ final class SessionEngine { var onSessionsUpdate: (([Session]) -> Void)? var onSessionResponse: ((Response) -> Void)? - var onSessionRejected: ((String, SessionType.Reason) -> Void)? var onSessionDelete: ((String, SessionType.Reason) -> Void)? var onEventReceived: ((String, Session.Event, Blockchain?) -> Void)? diff --git a/Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift similarity index 100% rename from Sources/WalletConnectSign/Auth/ApproveSessionAuthenticateDispatcher.swift rename to Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift From c6306b217d5917486204d15eb47caf03d4593223 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 10:48:37 +0400 Subject: [PATCH 535/814] add SessionRequestDispatcher --- .../SessionRequestDispatcher.swift | 109 ++++++++++++++++++ .../Types/Session/WCSession.swift | 9 +- 2 files changed, 117 insertions(+), 1 deletion(-) create mode 100644 Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift new file mode 100644 index 000000000..7d11f3e51 --- /dev/null +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -0,0 +1,109 @@ + +import Foundation + +class SessionRequestDispatcher { + private let relaySessionRequester: SessionRequester + private let linkSessionRequester: LinkSessionRequester + private let logger: ConsoleLogging + private let sessionStore: WCSessionStorage + + init( + relaySessionRequester: SessionRequester, + linkSessionRequester: LinkSessionRequester, + logger: ConsoleLogging, + sessionStore: WCSessionStorage + ) { + self.relaySessionRequester = relaySessionRequester + self.linkSessionRequester = linkSessionRequester + self.logger = logger + self.sessionStore = sessionStore + } + + public func request(_ request: Request) async throws -> (String?) { + + guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { + logger.debug("Could not find session for topic \(request.topic)") + throw WalletConnectError.noSessionMatchingTopic(request.topic) + } + let transportType = session.transportType + + switch transportType { + case .relay: + try await relaySessionRequester.request(request) + return nil + case .linkMode: + return try await linkSessionRequester.request(request) + } + } +} + + +class SessionRequester { + private let sessionStore: WCSessionStorage + private let networkingInteractor: NetworkInteracting + private let logger: ConsoleLogging + + init( + sessionStore: WCSessionStorage, + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging + ) { + self.sessionStore = sessionStore + self.networkingInteractor = networkingInteractor + self.logger = logger + } + + func request(_ request: Request) async throws { + logger.debug("will request on session topic: \(request.topic)") + guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { + logger.debug("Could not find session for topic \(request.topic)") + return + } + guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + logger.debug("Invalid namespaces") + throw WalletConnectError.invalidPermissions + } + let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) + let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) + let ttl = try request.calculateTtl() + let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) + let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) + try await networkingInteractor.request(rpcRequest, topic: request.topic, protocolMethod: SessionRequestProtocolMethod()) + } +} + +class LinkSessionRequester { + private let sessionStore: WCSessionStorage + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let logger: ConsoleLogging + + init( + sessionStore: WCSessionStorage, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + logger: ConsoleLogging + ) { + self.sessionStore = sessionStore + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.logger = logger + } + + func request(_ request: Request) async throws -> String? { + logger.debug("will request on session topic: \(request.topic)") + guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { + logger.debug("Could not find session for topic \(request.topic)") + throw WalletConnectError.noSessionMatchingTopic(request.topic) + } + guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + logger.debug("Invalid namespaces") + throw WalletConnectError.invalidPermissions + } + // it's safe to force unwrap because redirect was used during session creation before + let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! + let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) + let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) + let ttl = try request.calculateTtl() + let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) + let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) + return try await linkEnvelopesDispatcher.request(topic: session.topic, request: rpcRequest, peerUniversalLink: peerUniversalLink, envelopeType: .type0) + } +} diff --git a/Sources/WalletConnectSign/Types/Session/WCSession.swift b/Sources/WalletConnectSign/Types/Session/WCSession.swift index a24b13691..886f39e8a 100644 --- a/Sources/WalletConnectSign/Types/Session/WCSession.swift +++ b/Sources/WalletConnectSign/Types/Session/WCSession.swift @@ -1,6 +1,10 @@ import Foundation struct WCSession: SequenceObject, Equatable { + public enum TransportType: Codable { + case relay + case linkMode + } enum Error: Swift.Error { case controllerNotSet case unsatisfiedUpdateNamespaceRequirement @@ -12,6 +16,7 @@ struct WCSession: SequenceObject, Equatable { let selfParticipant: Participant let peerParticipant: Participant let controller: AgreementPeer + let transportType: TransportType private(set) var acknowledged: Bool private(set) var expiryDate: Date @@ -182,7 +187,7 @@ struct WCSession: SequenceObject, Equatable { extension WCSession { enum CodingKeys: String, CodingKey { - case topic, pairingTopic, relay, selfParticipant, peerParticipant, expiryDate, acknowledged, controller, namespaces, timestamp, requiredNamespaces, sessionProperties + case topic, pairingTopic, relay, selfParticipant, peerParticipant, expiryDate, acknowledged, controller, namespaces, timestamp, requiredNamespaces, sessionProperties, transportType } init(from decoder: Decoder) throws { @@ -199,6 +204,7 @@ extension WCSession { self.timestamp = try container.decode(Date.self, forKey: .timestamp) self.requiredNamespaces = try container.decode([String: ProposalNamespace].self, forKey: .requiredNamespaces) self.pairingTopic = try container.decode(String.self, forKey: .pairingTopic) + self.transportType = (try? container.decode(TransportType.self, forKey: .transportType)) ?? .relay } func encode(to encoder: Encoder) throws { @@ -215,5 +221,6 @@ extension WCSession { try container.encode(expiryDate, forKey: .expiryDate) try container.encode(timestamp, forKey: .timestamp) try container.encode(requiredNamespaces, forKey: .requiredNamespaces) + try container.encode(transportType, forKey: .transportType) } } From e62c0dcb406585fedab9ebda00f47b294d97e6e1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 10:54:36 +0400 Subject: [PATCH 536/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 7 +++++-- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 7 ++++++- Sources/WalletConnectSign/Types/Session/WCSession.swift | 9 +++++++-- 3 files changed, 18 insertions(+), 5 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 0fd06461f..cc15e32fe 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -189,6 +189,7 @@ public final class SignClient: SignClientProtocol { private let linkAuthRequester: LinkAuthRequester? private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let sessionRequestDispatcher: SessionRequestDispatcher private var publishers = Set() @@ -222,7 +223,8 @@ public final class SignClient: SignClientProtocol { authRequestSubscribersTracking: AuthRequestSubscribersTracking, linkAuthRequester: LinkAuthRequester, linkAuthRequestSubscriber: LinkAuthRequestSubscriber, - linkEnvelopesDispatcher: LinkEnvelopesDispatcher + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + sessionRequestDispatcher: SessionRequestDispatcher ) { self.logger = logger self.networkingClient = networkingClient @@ -253,6 +255,7 @@ public final class SignClient: SignClientProtocol { self.linkAuthRequester = linkAuthRequester self.linkAuthRequestSubscriber = linkAuthRequestSubscriber self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.sessionRequestDispatcher = sessionRequestDispatcher setUpConnectionObserving() setUpEnginesCallbacks() @@ -445,7 +448,7 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - params: Parameters defining request and related session public func request(params: Request) async throws { - try await sessionEngine.request(params) + try await sessionRequestDispatcher.request(params) } /// For the wallet to respond on pending dApp's JSON-RPC request diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 709c4965d..486e732e2 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -127,6 +127,10 @@ public struct SignClientFactory { let approveSessionAuthenticateDispatcher = ApproveSessionAuthenticateDispatcher(relaySessionAuthenticateResponder: relaySessionAuthenticateResponder, logger: logger, rpcHistory: rpcHistory, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, linkSessionAuthenticateResponder: linkSessionAuthenticateResponder) + let relaySessionRequester = SessionRequester(sessionStore: sessionStore, networkingInteractor: networkingClient, logger: logger) + + let linkSessionRequester = LinkSessionRequester(sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger) + let sessionRequestDispatcher = SessionRequestDispatcher(relaySessionRequester: relaySessionRequester, linkSessionRequester: linkSessionRequester, logger: logger, sessionStore: sessionStore) let client = SignClient( logger: logger, networkingClient: networkingClient, @@ -156,7 +160,8 @@ public struct SignClientFactory { authRequestSubscribersTracking: authRequestSubscribersTracking, linkAuthRequester: linkAuthRequester, linkAuthRequestSubscriber: linkAuthRequestSubscriber, - linkEnvelopesDispatcher: linkEnvelopesDispatcher + linkEnvelopesDispatcher: linkEnvelopesDispatcher, + sessionRequestDispatcher: sessionRequestDispatcher ) return client } diff --git a/Sources/WalletConnectSign/Types/Session/WCSession.swift b/Sources/WalletConnectSign/Types/Session/WCSession.swift index 886f39e8a..fbca74d2b 100644 --- a/Sources/WalletConnectSign/Types/Session/WCSession.swift +++ b/Sources/WalletConnectSign/Types/Session/WCSession.swift @@ -40,7 +40,9 @@ struct WCSession: SequenceObject, Equatable { peerParticipant: Participant, settleParams: SessionType.SettleParams, requiredNamespaces: [String: ProposalNamespace], - acknowledged: Bool) { + acknowledged: Bool, + transportType: TransportType + ) { self.topic = topic self.pairingTopic = pairingTopic self.timestamp = timestamp @@ -53,6 +55,7 @@ struct WCSession: SequenceObject, Equatable { self.requiredNamespaces = requiredNamespaces self.acknowledged = acknowledged self.expiryDate = Date(timeIntervalSince1970: TimeInterval(settleParams.expiry)) + self.transportType = transportType } #if DEBUG @@ -70,7 +73,8 @@ struct WCSession: SequenceObject, Equatable { events: Set, accounts: Set, acknowledged: Bool, - expiryTimestamp: Int64 + expiryTimestamp: Int64, + transportType: TransportType ) { self.topic = topic self.pairingTopic = pairingTopic @@ -84,6 +88,7 @@ struct WCSession: SequenceObject, Equatable { self.requiredNamespaces = requiredNamespaces self.acknowledged = acknowledged self.expiryDate = Date(timeIntervalSince1970: TimeInterval(expiryTimestamp)) + self.transportType = transportType } #endif From 4ece6aec3e77a8c52e42a4ae1061588f01826d6e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 11:06:59 +0400 Subject: [PATCH 537/814] savepoint --- .../Auth/Link/ApproveSessionAuthenticateUtil.swift | 6 ++++-- .../Auth/Link/LinkSessionAuthenticateResponder.swift | 3 ++- .../Auth/Services/App/AuthResponseSubscriber.swift | 10 ++++++---- .../Services/Wallet/SessionAuthenticateResponder.swift | 3 ++- .../Engine/Common/ApproveEngine.swift | 6 ++++-- 5 files changed, 18 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index d1b273df8..e0b94949f 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -62,7 +62,8 @@ class ApproveSessionAuthenticateUtil { response: SessionAuthenticateResponseParams, pairingTopic: String, request: SessionAuthenticateRequestParams, - sessionTopic: String + sessionTopic: String, + transportType: WCSession.TransportType ) throws -> Session? { @@ -96,7 +97,8 @@ class ApproveSessionAuthenticateUtil { peerParticipant: peerParticipant, settleParams: settleParams, requiredNamespaces: [:], - acknowledged: true + acknowledged: true, + transportType: transportType ) sessionStore.setSession(session) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index 232bd5781..173fc4869 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -59,7 +59,8 @@ actor LinkSessionAuthenticateResponder { response: responseParams, pairingTopic: pairingTopic, request: sessionAuthenticateRequestParams, - sessionTopic: sessionTopic + sessionTopic: sessionTopic, + transportType: .linkMode ) return (session, url) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index b5d7e7bf5..d6b39f0bb 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -69,7 +69,7 @@ class AuthResponseSubscriber { authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) return } - let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, transportType: .relay) authResponsePublisherSubject.send((requestId, .success((session, cacaos)))) } @@ -95,7 +95,7 @@ class AuthResponseSubscriber { authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) return } - let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic) + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, transportType: .linkMode) authResponsePublisherSubject.send((requestId, .success((session, cacaos)))) } @@ -127,7 +127,8 @@ class AuthResponseSubscriber { private func createSession( from response: SessionAuthenticateResponseParams, selfParticipant: Participant, - pairingTopic: String + pairingTopic: String, + transportType: WCSession.TransportType ) throws -> Session? { let selfPublicKey = try AgreementPublicKey(hex: selfParticipant.publicKey) @@ -165,7 +166,8 @@ class AuthResponseSubscriber { peerParticipant: response.responder, settleParams: settleParams, requiredNamespaces: [:], - acknowledged: true + acknowledged: true, + transportType: transportType ) sessionStore.setSession(session) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index eccd5ed11..90033bc59 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -60,7 +60,8 @@ actor SessionAuthenticateResponder { response: responseParams, pairingTopic: pairingTopic, request: sessionAuthenticateRequestParams, - sessionTopic: sessionTopic + sessionTopic: sessionTopic, + transportType: .relay ) Task { diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index e2dc938ac..3d0d9727b 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -193,7 +193,8 @@ final class ApproveEngine { peerParticipant: proposal.proposer, settleParams: settleParams, requiredNamespaces: proposal.requiredNamespaces, - acknowledged: false + acknowledged: false, + transportType: .relay ) logger.debug("Sending session settle request") @@ -415,7 +416,8 @@ private extension ApproveEngine { peerParticipant: params.controller, settleParams: params, requiredNamespaces: proposedNamespaces, - acknowledged: true + acknowledged: true, + transportType: .relay ) sessionStore.setSession(session) From 2216faea5faac6434abc986b98f5a2e7eddc4130 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 11:44:11 +0400 Subject: [PATCH 538/814] add sessionResponderDispatcher --- .../Link/LinkSessionRequestSubscriber.swift | 4 +- .../Engine/Common/SessionEngine.swift | 55 ------ .../SessionResponderDispatcher.swift | 159 ++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 10 +- .../Sign/SignClientFactory.swift | 10 +- 5 files changed, 178 insertions(+), 60 deletions(-) create mode 100644 Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift index 98be79da0..23cc924b6 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift @@ -19,13 +19,14 @@ class LinkSessionRequestSubscriber { self.sessionStore = sessionStore self.logger = logger self.envelopesDispatcher = envelopesDispatcher + setupRequestSubscription() } var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { return sessionRequestsProvider.sessionRequestPublisher } - func setupRequestSubscriptions() { + func setupRequestSubscription() { envelopesDispatcher.requestSubscription(on: SessionRequestProtocolMethod().method) .sink { [unowned self] (payload: RequestSubscriptionPayload) in Task(priority: .high) { @@ -36,7 +37,6 @@ class LinkSessionRequestSubscriber { func onSessionRequest(payload: RequestSubscriptionPayload) { logger.debug("Received session request") - let protocolMethod = SessionRequestProtocolMethod() let topic = payload.topic let request = Request( id: payload.id, diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 42a577091..1f3c26d8e 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -63,54 +63,6 @@ final class SessionEngine { sessionStore.getAll().map { $0.publicRepresentation() } } - func request(_ request: Request) async throws { - logger.debug("will request on session topic: \(request.topic)") - guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { - logger.debug("Could not find session for topic \(request.topic)") - return - } - guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { - logger.debug("Invalid namespaces") - throw WalletConnectError.invalidPermissions - } - let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) - let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) - let ttl = try request.calculateTtl() - let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) - let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) - try await networkingInteractor.request(rpcRequest, topic: request.topic, protocolMethod: SessionRequestProtocolMethod()) - } - - func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws { - guard sessionStore.hasSession(forTopic: topic) else { - throw WalletConnectError.noSessionMatchingTopic(topic) - } - - let protocolMethod = SessionRequestProtocolMethod() - - guard sessionRequestNotExpired(requestId: requestId) else { - try await networkingInteractor.respondError( - topic: topic, - requestId: requestId, - protocolMethod: protocolMethod, - reason: SignReasonCode.sessionRequestExpired - ) - verifyContextStore.delete(forKey: requestId.string) - throw Errors.sessionRequestExpired - } - - try await networkingInteractor.respond( - topic: topic, - response: RPCResponse(id: requestId, outcome: response), - protocolMethod: protocolMethod - ) - verifyContextStore.delete(forKey: requestId.string) - DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in - guard let self = self else {return} - sessionRequestsProvider.emitRequestIfPending() - } - } - func emit(topic: String, event: SessionType.EventParams.Event, chainId: Blockchain) async throws { let protocolMethod = SessionEventProtocolMethod() guard let session = sessionStore.getSession(forTopic: topic) else { @@ -203,13 +155,6 @@ private extension SessionEngine { } } - func sessionRequestNotExpired(requestId: RPCID) -> Bool { - guard let request = historyService.getSessionRequest(id: requestId)?.request - else { return false } - - return !request.isExpired() - } - func respondError(payload: SubscriptionPayload, reason: SignReasonCode, protocolMethod: ProtocolMethod) { Task(priority: .high) { do { diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift new file mode 100644 index 000000000..0ad256caa --- /dev/null +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift @@ -0,0 +1,159 @@ + +import Foundation + +class SessionResponderDispatcher { + private let relaySessionResponder: SessionResponder + private let linkSessionResponder: LinkSessionResponder + private let logger: ConsoleLogging + private let sessionStore: WCSessionStorage + + init( + relaySessionResponder: SessionResponder, + linkSessionResponder: LinkSessionResponder, + logger: ConsoleLogging, + sessionStore: WCSessionStorage + ) { + self.relaySessionResponder = relaySessionResponder + self.linkSessionResponder = linkSessionResponder + self.logger = logger + self.sessionStore = sessionStore + } + + func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String? { + + guard let session = sessionStore.getSession(forTopic: topic), session.acknowledged else { + logger.debug("Could not find session for topic \(topic)") + throw WalletConnectError.noSessionMatchingTopic(topic) + } + let transportType = session.transportType + + switch transportType { + case .relay: + try await relaySessionResponder.respondSessionRequest(topic: topic, requestId: requestId, response: response) + return nil + case .linkMode: + return try await linkSessionResponder.respondSessionRequest(topic: topic, requestId: requestId, response: response) + } + } +} + +class SessionResponder { + enum Errors: Error { + case sessionRequestExpired + } + private let logger: ConsoleLogging + private let sessionStore: WCSessionStorage + private let networkingInteractor: NetworkInteracting + private let verifyContextStore: CodableStore + private let sessionRequestsProvider: SessionRequestsProvider + private let historyService: HistoryService + + init(logger: ConsoleLogging, sessionStore: WCSessionStorage, networkingInteractor: NetworkInteracting, verifyContextStore: CodableStore, sessionRequestsProvider: SessionRequestsProvider, historyService: HistoryService) { + self.logger = logger + self.sessionStore = sessionStore + self.networkingInteractor = networkingInteractor + self.verifyContextStore = verifyContextStore + self.sessionRequestsProvider = sessionRequestsProvider + self.historyService = historyService + } + + func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws { + guard sessionStore.hasSession(forTopic: topic) else { + throw WalletConnectError.noSessionMatchingTopic(topic) + } + + let protocolMethod = SessionRequestProtocolMethod() + + guard sessionRequestNotExpired(requestId: requestId) else { + try await networkingInteractor.respondError( + topic: topic, + requestId: requestId, + protocolMethod: protocolMethod, + reason: SignReasonCode.sessionRequestExpired + ) + verifyContextStore.delete(forKey: requestId.string) + throw Errors.sessionRequestExpired + } + + try await networkingInteractor.respond( + topic: topic, + response: RPCResponse(id: requestId, outcome: response), + protocolMethod: protocolMethod + ) + verifyContextStore.delete(forKey: requestId.string) + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in + guard let self = self else {return} + sessionRequestsProvider.emitRequestIfPending() + } + } + + private func sessionRequestNotExpired(requestId: RPCID) -> Bool { + guard let request = historyService.getSessionRequest(id: requestId)?.request + else { return false } + + return !request.isExpired() + } +} + +class LinkSessionResponder { + enum Errors: Error { + case sessionRequestExpired + } + private let logger: ConsoleLogging + private let sessionStore: WCSessionStorage + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let sessionRequestsProvider: SessionRequestsProvider + private let historyService: HistoryService + + init( + logger: ConsoleLogging, + sessionStore: WCSessionStorage, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + sessionRequestsProvider: SessionRequestsProvider, + historyService: HistoryService + ) { + self.logger = logger + self.sessionStore = sessionStore + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.sessionRequestsProvider = sessionRequestsProvider + self.historyService = historyService + } + + func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String { + guard let session = sessionStore.getSession(forTopic: topic) else { + throw WalletConnectError.noSessionMatchingTopic(topic) + } + + let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! + + guard sessionRequestNotExpired(requestId: requestId) else { + try await linkEnvelopesDispatcher.respondError( + topic: topic, + requestId: requestId, + peerUniversalLink: peerUniversalLink, + reason: SignReasonCode.sessionRequestExpired, + envelopeType: .type0 + ) + throw Errors.sessionRequestExpired + } + + let responseEnvelope = try await linkEnvelopesDispatcher.respond( + topic: topic, + response: RPCResponse(id: requestId, outcome: response), + peerUniversalLink: peerUniversalLink, + envelopeType: .type0 + ) + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in + guard let self = self else {return} + sessionRequestsProvider.emitRequestIfPending() + } + return responseEnvelope + } + + private func sessionRequestNotExpired(requestId: RPCID) -> Bool { + guard let request = historyService.getSessionRequest(id: requestId)?.request + else { return false } + + return !request.isExpired() + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index cc15e32fe..4880670ab 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -190,6 +190,8 @@ public final class SignClient: SignClientProtocol { private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let sessionRequestDispatcher: SessionRequestDispatcher + private let linkSessionRequestSubscriber: LinkSessionRequestSubscriber + private let sessionResponderDispatcher: SessionResponderDispatcher private var publishers = Set() @@ -224,7 +226,9 @@ public final class SignClient: SignClientProtocol { linkAuthRequester: LinkAuthRequester, linkAuthRequestSubscriber: LinkAuthRequestSubscriber, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, - sessionRequestDispatcher: SessionRequestDispatcher + sessionRequestDispatcher: SessionRequestDispatcher, + linkSessionRequestSubscriber: LinkSessionRequestSubscriber, + sessionResponderDispatcher: SessionResponderDispatcher ) { self.logger = logger self.networkingClient = networkingClient @@ -256,6 +260,8 @@ public final class SignClient: SignClientProtocol { self.linkAuthRequestSubscriber = linkAuthRequestSubscriber self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.sessionRequestDispatcher = sessionRequestDispatcher + self.linkSessionRequestSubscriber = linkSessionRequestSubscriber + self.sessionResponderDispatcher = sessionResponderDispatcher setUpConnectionObserving() setUpEnginesCallbacks() @@ -457,7 +463,7 @@ public final class SignClient: SignClientProtocol { /// - requestId: RPC request ID /// - response: Your JSON RPC response or an error. public func respond(topic: String, requestId: RPCID, response: RPCResult) async throws { - try await sessionEngine.respondSessionRequest(topic: topic, requestId: requestId, response: response) + try await sessionResponderDispatcher.respondSessionRequest(topic: topic, requestId: requestId, response: response) } /// Ping method allows to check if peer client is online and is subscribing for given topic diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 486e732e2..cbe62865e 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -131,6 +131,12 @@ public struct SignClientFactory { let linkSessionRequester = LinkSessionRequester(sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger) let sessionRequestDispatcher = SessionRequestDispatcher(relaySessionRequester: relaySessionRequester, linkSessionRequester: linkSessionRequester, logger: logger, sessionStore: sessionStore) + let linkSessionRequestSubscriber = LinkSessionRequestSubscriber(sessionRequestsProvider: sessionRequestsProvider, sessionStore: sessionStore, logger: logger, envelopesDispatcher: linkEnvelopesDispatcher) + + let relaySessionResponder = SessionResponder(logger: logger, sessionStore: sessionStore, networkingInteractor: networkingClient, verifyContextStore: verifyContextStore, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService) + let linkSessionResponder = LinkSessionResponder(logger: logger, sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService) + let sessionResponderDispatcher = SessionResponderDispatcher(relaySessionResponder: relaySessionResponder, linkSessionResponder: linkSessionResponder, logger: logger, sessionStore: sessionStore) + let client = SignClient( logger: logger, networkingClient: networkingClient, @@ -161,7 +167,9 @@ public struct SignClientFactory { linkAuthRequester: linkAuthRequester, linkAuthRequestSubscriber: linkAuthRequestSubscriber, linkEnvelopesDispatcher: linkEnvelopesDispatcher, - sessionRequestDispatcher: sessionRequestDispatcher + sessionRequestDispatcher: sessionRequestDispatcher, + linkSessionRequestSubscriber: linkSessionRequestSubscriber, + sessionResponderDispatcher: sessionResponderDispatcher ) return client } From 383e659c5a945899bac865e24be0ba2abc85e141 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 11:57:07 +0400 Subject: [PATCH 539/814] savepoint --- ...LinkSessionRequestResponseSubscriber.swift | 29 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 10 +++++-- .../Sign/SignClientFactory.swift | 4 ++- 3 files changed, 40 insertions(+), 3 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift new file mode 100644 index 000000000..213f6282f --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift @@ -0,0 +1,29 @@ + +import Foundation +import Combine + +class LinkSessionRequestResponseSubscriber { + private var publishers = [AnyCancellable]() + private let envelopesDispatcher: LinkEnvelopesDispatcher + + var onSessionResponse: ((Response) -> Void)? + + init(envelopesDispatcher: LinkEnvelopesDispatcher) { + self.envelopesDispatcher = envelopesDispatcher + setupRequestSubscription() + } + + func setupRequestSubscription() { + envelopesDispatcher.responseSubscription(on: SessionRequestProtocolMethod()) + .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + Task(priority: .high) { + onSessionResponse?(Response( + id: payload.id, + topic: payload.topic, + chainId: payload.request.chainId.absoluteString, + result: .response(payload.response) + )) + } + }.store(in: &publishers) + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 4880670ab..91c2cc919 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -192,6 +192,7 @@ public final class SignClient: SignClientProtocol { private let sessionRequestDispatcher: SessionRequestDispatcher private let linkSessionRequestSubscriber: LinkSessionRequestSubscriber private let sessionResponderDispatcher: SessionResponderDispatcher + private let linkSessionRequestResponseSubscriber: LinkSessionRequestResponseSubscriber private var publishers = Set() @@ -228,7 +229,8 @@ public final class SignClient: SignClientProtocol { linkEnvelopesDispatcher: LinkEnvelopesDispatcher, sessionRequestDispatcher: SessionRequestDispatcher, linkSessionRequestSubscriber: LinkSessionRequestSubscriber, - sessionResponderDispatcher: SessionResponderDispatcher + sessionResponderDispatcher: SessionResponderDispatcher, + linkSessionRequestResponseSubscriber: LinkSessionRequestResponseSubscriber ) { self.logger = logger self.networkingClient = networkingClient @@ -262,7 +264,8 @@ public final class SignClient: SignClientProtocol { self.sessionRequestDispatcher = sessionRequestDispatcher self.linkSessionRequestSubscriber = linkSessionRequestSubscriber self.sessionResponderDispatcher = sessionResponderDispatcher - + self.linkSessionRequestResponseSubscriber = linkSessionRequestResponseSubscriber + setUpConnectionObserving() setUpEnginesCallbacks() } @@ -588,6 +591,9 @@ public final class SignClient: SignClientProtocol { linkAuthRequestSubscriber.onRequest = { [unowned self] request in authRequestPublisherSubject.send(request) } + linkSessionRequestResponseSubscriber.onSessionResponse = { [unowned self] response in + sessionResponsePublisherSubject.send(response) + } } private func setUpConnectionObserving() { diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index cbe62865e..8bd1217b1 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -136,6 +136,7 @@ public struct SignClientFactory { let relaySessionResponder = SessionResponder(logger: logger, sessionStore: sessionStore, networkingInteractor: networkingClient, verifyContextStore: verifyContextStore, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService) let linkSessionResponder = LinkSessionResponder(logger: logger, sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService) let sessionResponderDispatcher = SessionResponderDispatcher(relaySessionResponder: relaySessionResponder, linkSessionResponder: linkSessionResponder, logger: logger, sessionStore: sessionStore) + let linkSessionRequestResponseSubscriber = LinkSessionRequestResponseSubscriber(envelopesDispatcher: linkEnvelopesDispatcher) let client = SignClient( logger: logger, @@ -169,7 +170,8 @@ public struct SignClientFactory { linkEnvelopesDispatcher: linkEnvelopesDispatcher, sessionRequestDispatcher: sessionRequestDispatcher, linkSessionRequestSubscriber: linkSessionRequestSubscriber, - sessionResponderDispatcher: sessionResponderDispatcher + sessionResponderDispatcher: sessionResponderDispatcher, + linkSessionRequestResponseSubscriber: linkSessionRequestResponseSubscriber ) return client } From 7effce279f87548776d4873339ff33f4a6d73d37 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 12:04:30 +0400 Subject: [PATCH 540/814] savepoint --- Sources/WalletConnectKMS/Serialiser/Serializer.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index ed48947fc..2e2e21960 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -98,7 +98,7 @@ public class Serializer: Serializing { return decoded } catch { - logger.error("\(error)") + logger.debug("\(error)") throw error } } else { From 799889106a2fd51d49205bbefa98f66a3986d8df Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 14:23:38 +0400 Subject: [PATCH 541/814] savepoint --- .../Serialiser/Serializer.swift | 2 +- .../Auth/Link/LinkEnvelopesDispatcher.swift | 16 ++++-- .../LinkSessionAuthenticateResponder.swift | 8 +-- .../Services/App/AuthResponseSubscriber.swift | 6 +++ .../Auth/Types/Errors/AuthError.swift | 8 ++- ...ApproveSessionAuthenticateDispatcher.swift | 8 +-- .../WalletErrorResponder.swift | 54 +++++++++++++++++-- .../Sign/SignClientFactory.swift | 4 +- 8 files changed, 87 insertions(+), 19 deletions(-) rename Sources/WalletConnectSign/{Auth/Services/Wallet => LinkAndRelayDispatchers}/WalletErrorResponder.swift (50%) diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index 2e2e21960..6d0968d92 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -135,7 +135,7 @@ public class Serializer: Serializing { let deserialised = try JSONDecoder().decode(T.self, from: envelope.sealbox) return deserialised } catch { - print(error) + logger.error(error) throw error } } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 9b1e46477..bc239fe17 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -84,10 +84,10 @@ class LinkEnvelopesDispatcher { return envelopeUrl.absoluteString } - public func respondError(topic: String, requestId: RPCID, peerUniversalLink: String, reason: Reason, envelopeType: Envelope.EnvelopeType) async throws { + public func respondError(topic: String, requestId: RPCID, peerUniversalLink: String, reason: Reason, envelopeType: Envelope.EnvelopeType) async throws -> String { let error = JSONRPCError(code: reason.code, message: reason.message) let response = RPCResponse(id: requestId, error: error) - try await respond(topic: topic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: envelopeType) + return try await respond(topic: topic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: envelopeType) } private func serializeAndCreateUrl(peerUniversalLink: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType, topic: String) throws -> URL { @@ -101,8 +101,6 @@ class LinkEnvelopesDispatcher { return finalURL } - - public func requestSubscription(on method: String) -> AnyPublisher, Never> { return requestPublisher .filter { rpcRequest in @@ -138,6 +136,16 @@ class LinkEnvelopesDispatcher { .eraseToAnyPublisher() } + public func responseErrorSubscription(on request: ProtocolMethod) -> AnyPublisher, Never> { + return responsePublisher + .filter { $0.request.method == request.method } + .compactMap { topic, rpcRequest, rpcResponse in + guard let id = rpcResponse.id, let request = try? rpcRequest.params?.get(Request.self), let error = rpcResponse.error else { return nil } + return ResponseSubscriptionErrorPayload(id: id, topic: topic, request: request, error: error) + } + .eraseToAnyPublisher() + } + private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: encodedEnvelope) { switch result { diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index 173fc4869..e6116d4ef 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -10,19 +10,22 @@ actor LinkSessionAuthenticateResponder { private let logger: ConsoleLogging private let metadata: AppMetadata private let util: ApproveSessionAuthenticateUtil + private let walletErrorResponder: WalletErrorResponder init( linkEnvelopesDispatcher: LinkEnvelopesDispatcher, logger: ConsoleLogging, kms: KeyManagementService, metadata: AppMetadata, - approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil + approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, + walletErrorResponder: WalletErrorResponder ) { self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.logger = logger self.kms = kms self.metadata = metadata self.util = approveSessionAuthenticateUtil + self.walletErrorResponder = walletErrorResponder } func respond(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String) { @@ -67,8 +70,7 @@ actor LinkSessionAuthenticateResponder { } func respondError(requestId: RPCID) async throws { - - //TODO + try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index d6b39f0bb..6a422df14 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -78,6 +78,12 @@ class AuthResponseSubscriber { } private func subscribeForLinkResonse() { + linkEnvelopesDispatcher.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) + .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + guard let error = AuthError(code: payload.error.code) else { return } + authResponsePublisherSubject.send((payload.id, .failure(error))) + }.store(in: &publishers) + linkEnvelopesDispatcher.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in diff --git a/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift b/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift index cf4accb16..715e0cd77 100644 --- a/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift +++ b/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift @@ -1,7 +1,7 @@ import Foundation /// Authentication error -public enum AuthError: Codable, Equatable, Error { +public enum AuthError: Codable, Equatable, Error, LocalizedError { case methodUnsupported case userDisconnected case userRejeted @@ -56,7 +56,7 @@ extension AuthError: Reason { case .methodUnsupported: return "Method Unsupported" case .userRejeted: - return "Auth request rejected by user" + return "Auth request rejected by the user" case .malformedResponseParams: return "Response params malformed" case .malformedRequestParams: @@ -69,4 +69,8 @@ extension AuthError: Reason { return "User Disconnected" } } + + public var errorDescription: String? { + return message + } } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift index f6c348d32..042f95f91 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift @@ -2,7 +2,7 @@ import Foundation actor ApproveSessionAuthenticateDispatcher { - private let relaySessionAuthenticateResponder: SessionAuthenticateResponder + private let sessionAuthenticateResponder: SessionAuthenticateResponder private let linkSessionAuthenticateResponder: LinkSessionAuthenticateResponder private let logger: ConsoleLogging private let util: ApproveSessionAuthenticateUtil @@ -14,7 +14,7 @@ actor ApproveSessionAuthenticateDispatcher { approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, linkSessionAuthenticateResponder: LinkSessionAuthenticateResponder ) { - self.relaySessionAuthenticateResponder = relaySessionAuthenticateResponder + self.sessionAuthenticateResponder = relaySessionAuthenticateResponder self.logger = logger self.util = approveSessionAuthenticateUtil self.linkSessionAuthenticateResponder = linkSessionAuthenticateResponder @@ -27,7 +27,7 @@ actor ApproveSessionAuthenticateDispatcher { switch transportType { case .relay, .none: - let session = try await relaySessionAuthenticateResponder.respond(requestId: requestId, auths: auths) + let session = try await sessionAuthenticateResponder.respond(requestId: requestId, auths: auths) return (session, nil) case .linkMode: return try await linkSessionAuthenticateResponder.respond(requestId: requestId, auths: auths) @@ -40,7 +40,7 @@ actor ApproveSessionAuthenticateDispatcher { switch transportType { case .relay, .none: - return try await relaySessionAuthenticateResponder.respondError(requestId: requestId) + return try await sessionAuthenticateResponder.respondError(requestId: requestId) case .linkMode: return try await linkSessionAuthenticateResponder.respondError(requestId: requestId) } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift similarity index 50% rename from Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift rename to Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index ee7d314de..d23f6e940 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -4,33 +4,79 @@ actor WalletErrorResponder { enum Errors: Error { case recordForIdNotFound case malformedAuthRequestParams + case peerUniversalLinkNotFound } private let networkingInteractor: NetworkInteracting private let kms: KeyManagementServiceProtocol private let rpcHistory: RPCHistory private let logger: ConsoleLogging + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, kms: KeyManagementServiceProtocol, - rpcHistory: RPCHistory) { + rpcHistory: RPCHistory, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher) { self.networkingInteractor = networkingInteractor self.logger = logger self.kms = kms self.rpcHistory = rpcHistory + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher } - func respondError(_ error: AuthError, requestId: RPCID) async throws { + + func respondError(_ error: AuthError, requestId: RPCID) async throws -> String? { + + let transportType = try getHistoryRecord(requestId: requestId).transportType + let authRequestParams = try getAuthRequestParams(requestId: requestId) let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) try kms.setAgreementSecret(keys, topic: topic) - let envelopeType = Envelope.EnvelopeType.type1(pubKey: keys.publicKey.rawRepresentation) + let type1EnvelopeKey = keys.publicKey.rawRepresentation + switch transportType { + case .relay, .none: + try await respondErrorRelay(error, requestId: requestId, topic: topic, type1EnvelopeKey: type1EnvelopeKey) + return nil + case .linkMode: + return try await respondErrorLinkMode(error, requestId: requestId, topic: topic, type1EnvelopeKey: type1EnvelopeKey) + } + } + + private func respondErrorRelay(_ error: AuthError, requestId: RPCID, topic: String, type1EnvelopeKey: Data) async throws { + let envelopeType = Envelope.EnvelopeType.type1(pubKey: type1EnvelopeKey) try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: SessionAuthenticatedProtocolMethod(), reason: error, envelopeType: envelopeType) } + private func respondErrorLinkMode(_ error: AuthError, requestId: RPCID, topic: String, type1EnvelopeKey: Data) async throws -> String { + let (sessionAuthenticateRequestParams, _) = try getsessionAuthenticateRequestParams(requestId: requestId) + + guard let peerUniversalLink = sessionAuthenticateRequestParams.requester.metadata.redirect?.universal else { + throw Errors.peerUniversalLinkNotFound + } + + return try await linkEnvelopesDispatcher.respondError(topic: topic, requestId: requestId, peerUniversalLink: peerUniversalLink, reason: error, envelopeType: .type1(pubKey: type1EnvelopeKey)) + + } + + func getsessionAuthenticateRequestParams(requestId: RPCID) throws -> (request: SessionAuthenticateRequestParams, topic: String) { + let record = try getHistoryRecord(requestId: requestId) + + let request = record.request + guard let authRequestParams = try request.params?.get(SessionAuthenticateRequestParams.self) + else { throw Errors.malformedAuthRequestParams } + + return (request: authRequestParams, topic: record.topic) + } + + func getHistoryRecord(requestId: RPCID) throws -> RPCHistory.Record { + guard let record = rpcHistory.get(recordId: requestId) + else { throw Errors.recordForIdNotFound } + return record + } + private func getAuthRequestParams(requestId: RPCID) throws -> SessionAuthenticateRequestParams { guard let request = rpcHistory.get(recordId: requestId)?.request else { throw Errors.recordForIdNotFound } @@ -58,6 +104,8 @@ extension WalletErrorResponder.Errors: LocalizedError { return NSLocalizedString("The record for the specified ID was not found.", comment: "Record Not Found Error") case .malformedAuthRequestParams: return NSLocalizedString("The authentication request parameters are malformed.", comment: "Malformed Auth Request Params Error") + case .peerUniversalLinkNotFound: + return NSLocalizedString("The peer's universal link was not found.", comment: "Peer Universal Link Not Found Error") } } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 8bd1217b1..6ea2fcbde 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -110,7 +110,7 @@ public struct SignClientFactory { let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) - let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory) + let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) @@ -123,7 +123,7 @@ public struct SignClientFactory { let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) - let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) + let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder) let approveSessionAuthenticateDispatcher = ApproveSessionAuthenticateDispatcher(relaySessionAuthenticateResponder: relaySessionAuthenticateResponder, logger: logger, rpcHistory: rpcHistory, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, linkSessionAuthenticateResponder: linkSessionAuthenticateResponder) From fce42b662cd366c37cca120d99793b50f75e08c6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Apr 2024 17:14:21 +0400 Subject: [PATCH 542/814] handle error response --- .../Link/LinkSessionRequestResponseSubscriber.swift | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift index 213f6282f..e0581269a 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift @@ -14,6 +14,17 @@ class LinkSessionRequestResponseSubscriber { } func setupRequestSubscription() { + envelopesDispatcher.responseErrorSubscription(on: SessionRequestProtocolMethod()) + .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + onSessionResponse?(Response( + id: payload.id, + topic: payload.topic, + chainId: payload.request.chainId.absoluteString, + result: .error(payload.error) + )) + } + .store(in: &publishers) + envelopesDispatcher.responseSubscription(on: SessionRequestProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in Task(priority: .high) { From 241242c9bf9084e0e12913e0ead151a20f6b0fa5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Apr 2024 14:15:53 +0400 Subject: [PATCH 543/814] savepoint --- .../Serialiser/Envelope.swift | 88 +++++++++++++------ .../Serialiser/Serializer.swift | 8 +- .../Serialiser/Serializing.swift | 12 +-- .../Auth/Link/LinkEnvelopesDispatcher.swift | 2 +- 4 files changed, 73 insertions(+), 37 deletions(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index 13d36021f..8167242af 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -2,7 +2,11 @@ import Foundation /// A type representing envelope with it's serialization policy public struct Envelope: Equatable { - enum Errors: String, Error { + public enum CodingType { + case base64Encoded(String) + case base64UrlEncoded(String) + } + public enum Errors: String, Error { case malformedEnvelope case unsupportedEnvelopeType } @@ -15,32 +19,29 @@ public struct Envelope: Equatable { /// pk = public key (32 bytes) /// iv = initialization vector (12 bytes) /// ct = ciphertext (N bytes) - /// sealbox: in case of envelope type 0 and 1: = iv + ct + tag, in case of type 2 - raw data representation of a json object + /// sealbox: in case of envelope type 0, 1, 3 and 4: = iv + ct + tag, in case of type 2 - raw data representation of a json object /// type0: tp + sealbox /// type1: tp + pk + sealbox - init(_ base64encoded: String) throws { - guard let envelopeData = Data(base64Encoded: base64encoded) ?? Data(base64url: base64encoded) else { - throw Errors.malformedEnvelope + init(_ codingType: CodingType) throws { + var envelopeData: Data! + switch codingType { + case .base64Encoded(let encodedString): + envelopeData = Data(base64Encoded: encodedString) + case .base64UrlEncoded(let encodedString): + envelopeData = Data(base64url: encodedString) } + guard let envelopeData = envelopeData else { throw Errors.malformedEnvelope } - let envelopeTypeByte = envelopeData.subdata(in: 0..<1).first - if envelopeTypeByte == 0 { - self.type = .type0 - self.sealbox = envelopeData.subdata(in: 1.. 33 else {throw Errors.malformedEnvelope} - let pubKey = envelopeData.subdata(in: 1..<33) - self.type = .type1(pubKey: pubKey) - self.sealbox = envelopeData.subdata(in: 33..= 33 ? envelopeData.subdata(in: 1..<33) : nil + self.type = try EnvelopeType(representingByte: envelopeTypeByte, pubKey: pubKey) + + let startIndex = (envelopeTypeByte == 1 || envelopeTypeByte == 4) ? 33 : 1 + self.sealbox = envelopeData.subdata(in: startIndex.. String { switch type { case .type0: - return (type.representingByte.data + sealbox).base64urlEncodedString() + return (type.representingByte.data + sealbox).base64EncodedString() case .type1(let pubKey): - return (type.representingByte.data + pubKey + sealbox).base64urlEncodedString() + return (type.representingByte.data + pubKey + sealbox).base64EncodedString() case .type2: return (type.representingByte.data + sealbox).base64urlEncodedString() + case .type3: + return (type.representingByte.data + sealbox).base64urlEncodedString() + case .type4(pubKey: let pubKey): + return (type.representingByte.data + pubKey + sealbox).base64urlEncodedString() } } @@ -61,12 +66,16 @@ public struct Envelope: Equatable { public extension Envelope { enum EnvelopeType: Equatable { - /// type 0 = tp + iv + ct + tag + /// type 0 = tp + iv + ct + tag - base64encoded case type0 - /// type 1 = tp + pk + iv + ct + tag + /// type 1 = tp + pk + iv + ct + tag - base64encoded case type1(pubKey: Data) - + /// type 2 = tp + base64urlEncoded unencrypted string case type2 + /// type 0 = tp + iv + ct + tag - base64urlEncoded + case type3 + /// type 1 = tp + pk + iv + ct + tag - base64urlEncoded + case type4(pubKey: Data) var representingByte: UInt8 { switch self { @@ -76,6 +85,33 @@ public extension Envelope { return 1 case .type2: return 2 + case .type3: + return 3 + case .type4: + return 4 + } + } + + init(representingByte: UInt8, pubKey: Data?) throws { + switch representingByte { + case 0: + self = .type0 + case 1: + guard let key = pubKey, key.count == 32 else { + throw Envelope.Errors.malformedEnvelope + } + self = .type1(pubKey: key) + case 2: + self = .type2 + case 3: + self = .type3 + case 4: + guard let key = pubKey, key.count == 32 else { + throw Envelope.Errors.malformedEnvelope + } + self = .type4(pubKey: key) + default: + throw Envelope.Errors.unsupportedEnvelopeType } } } diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index 6d0968d92..c8b73e415 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -76,13 +76,13 @@ public class Serializer: Serializing { /// - topic: Topic that is associated with a symetric key for decrypting particular codable object /// - encodedEnvelope: Envelope to deserialize and decrypt /// - Returns: Deserialized object - public func deserialize(topic: String, encodedEnvelope: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) { - let envelope = try Envelope(encodedEnvelope) + public func deserialize(topic: String, codingType: Envelope.CodingType) throws -> (T, derivedTopic: String?, decryptedPayload: Data) { + let envelope = try Envelope(codingType) switch envelope.type { - case .type0: + case .type0, .type3: let deserialisedType: (object: T, data: Data) = try handleType0Envelope(topic, envelope) return (deserialisedType.object, nil, deserialisedType.data) - case .type1(let peerPubKey): + case .type1(let peerPubKey), .type4(let peerPubKey): return try handleType1Envelope(topic, peerPubKey: peerPubKey, sealbox: envelope.sealbox) case .type2: let decodedType: T = try handleType2Envelope(envelope: envelope) diff --git a/Sources/WalletConnectKMS/Serialiser/Serializing.swift b/Sources/WalletConnectKMS/Serialiser/Serializing.swift index 0a7658755..255c7cfa6 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializing.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializing.swift @@ -7,27 +7,27 @@ public protocol Serializing { func setLogging(level: LoggingLevel) func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key - func deserialize(topic: String, encodedEnvelope: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) + func deserialize(topic: String, codingType: Envelope.CodingType) throws -> (T, derivedTopic: String?, decryptedPayload: Data) } public extension Serializing { /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key - func tryDeserialize(topic: String, encodedEnvelope: String) -> (T, derivedTopic: String?, decryptedPayload: Data)? { - return try? deserialize(topic: topic, encodedEnvelope: encodedEnvelope) + func tryDeserialize(topic: String, codingType: Envelope.CodingType) -> (T, derivedTopic: String?, decryptedPayload: Data)? { + return try? deserialize(topic: topic, codingType: codingType) } func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType = .type0) throws -> String { try serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) } - func tryDeserializeRequestOrResponse(topic: String, encodedEnvelope: String) -> Either? { + func tryDeserializeRequestOrResponse(topic: String, codingType: Envelope.CodingType) -> Either? { // Attempt to deserialize RPCRequest - if let result = try? deserialize(topic: topic, encodedEnvelope: encodedEnvelope) as (RPCRequest, derivedTopic: String?, decryptedPayload: Data) { + if let result = try? deserialize(topic: topic, codingType: codingType) as (RPCRequest, derivedTopic: String?, decryptedPayload: Data) { return .left(result.0) } // Attempt to deserialize RPCResponse - if let result = try? deserialize(topic: topic, encodedEnvelope: encodedEnvelope) as (RPCResponse, derivedTopic: String?, decryptedPayload: Data) { + if let result = try? deserialize(topic: topic, codingType: codingType) as (RPCResponse, derivedTopic: String?, decryptedPayload: Data) { return .right(result.0) } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index bc239fe17..af424c7e7 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -147,7 +147,7 @@ class LinkEnvelopesDispatcher { } private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { - if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: encodedEnvelope) { + if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64UrlEncoded(encodedEnvelope)) { switch result { case .left(let request): handleRequest(topic: topic, request: request) From 5f641a9654b972de5febaab7e9f9902e4fd648c9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Apr 2024 14:33:59 +0400 Subject: [PATCH 544/814] savepoint --- Sources/WalletConnectKMS/Serialiser/Serializing.swift | 6 +++--- .../NetworkingInteractor.swift | 11 +++++++---- .../Client/Wallet/NotifyDecryptionService.swift | 2 +- .../Auth/Link/LinkEnvelopesDispatcher.swift | 10 +++++----- Sources/WalletConnectSign/SignDecryptionService.swift | 6 +++--- 5 files changed, 19 insertions(+), 16 deletions(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Serializing.swift b/Sources/WalletConnectKMS/Serialiser/Serializing.swift index 255c7cfa6..ce622f51b 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializing.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializing.swift @@ -20,15 +20,15 @@ public extension Serializing { try serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) } - func tryDeserializeRequestOrResponse(topic: String, codingType: Envelope.CodingType) -> Either? { + func tryDeserializeRequestOrResponse(topic: String, codingType: Envelope.CodingType) -> Either<(request: RPCRequest, derivedTopic: String?, decryptedPayload: Data), (response: RPCResponse, derivedTopic: String?, decryptedPayload: Data)>? { // Attempt to deserialize RPCRequest if let result = try? deserialize(topic: topic, codingType: codingType) as (RPCRequest, derivedTopic: String?, decryptedPayload: Data) { - return .left(result.0) + return .left(result) } // Attempt to deserialize RPCResponse if let result = try? deserialize(topic: topic, codingType: codingType) as (RPCResponse, derivedTopic: String?, decryptedPayload: Data) { - return .right(result.0) + return .right(result) } // If both attempts fail, log an error and return nil diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index a8ad1b80a..7ee808246 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -242,10 +242,13 @@ public class NetworkingInteractor: NetworkInteracting { } private func manageSubscription(_ topic: String, _ encodedEnvelope: String, _ publishedAt: Date) { - if let (deserializedJsonRpcRequest, derivedTopic, decryptedPayload): (RPCRequest, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { - handleRequest(topic: topic, request: deserializedJsonRpcRequest, decryptedPayload: decryptedPayload, publishedAt: publishedAt, derivedTopic: derivedTopic) - } else if let (response, derivedTopic, _): (RPCResponse, String?, Data) = serializer.tryDeserialize(topic: topic, encodedEnvelope: encodedEnvelope) { - handleResponse(topic: topic, response: response, publishedAt: publishedAt, derivedTopic: derivedTopic) + if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(encodedEnvelope)) { + switch result { + case .left(let result): + handleRequest(topic: topic, request: result.request, decryptedPayload: result.decryptedPayload, publishedAt: publishedAt, derivedTopic: result.derivedTopic) + case .right(let result): + handleResponse(topic: topic, response: result.response, publishedAt: publishedAt, derivedTopic: result.derivedTopic) + } } else { logger.debug("Networking Interactor - Received unknown object type from networking relay") } diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift index e53b53042..402f08060 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift @@ -28,7 +28,7 @@ public class NotifyDecryptionService { } public func decryptMessage(topic: String, ciphertext: String) throws -> (NotifyMessage, NotifySubscription, Account) { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) guard let params = rpcRequest.params else { throw Errors.malformedNotifyMessage } let wrapper = try params.get(NotifyMessagePayload.Wrapper.self) let (messagePayload, _) = try NotifyMessagePayload.decodeAndVerify(from: wrapper) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index af424c7e7..4f6aec53c 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -149,13 +149,13 @@ class LinkEnvelopesDispatcher { private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64UrlEncoded(encodedEnvelope)) { switch result { - case .left(let request): - handleRequest(topic: topic, request: request) - case .right(let response): - handleResponse(topic: topic, response: response) + case .left(let result): + handleRequest(topic: topic, request: result.request) + case .right(let result): + handleResponse(topic: topic, response: result.response) } } else { - logger.debug("Link Dispatcher - Received unknown object type from networking relay") + logger.debug("Link Dispatcher - Received unknown object type to dispatch") } } diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index 6fe1a8686..d22611b80 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -21,7 +21,7 @@ public class SignDecryptionService { } public func decryptProposal(topic: String, ciphertext: String) throws -> Session.Proposal { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) if let proposal = try rpcRequest.params?.get(SessionType.ProposeParams.self) { return proposal.publicRepresentation(pairingTopic: topic) } else { @@ -30,7 +30,7 @@ public class SignDecryptionService { } public func decryptRequest(topic: String, ciphertext: String) throws -> Request { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) if let request = try rpcRequest.params?.get(SessionType.RequestParams.self), let rpcId = rpcRequest.id{ let request = Request( @@ -49,7 +49,7 @@ public class SignDecryptionService { } public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthenticationRequest { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) setPairingMetadata(rpcRequest: rpcRequest, topic: topic) if let params = try rpcRequest.params?.get(SessionAuthenticateRequestParams.self), let id = rpcRequest.id { From 6acbcba8bc865a6029a16c3f056a5dfc0febc5c0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Apr 2024 15:47:33 +0400 Subject: [PATCH 545/814] savepoint --- Sources/Auth/AuthDecryptionService.swift | 2 +- .../WalletConnectKMSTests/EnvelopeTests.swift | 4 ++-- .../SerialiserTests.swift | 22 +++++++++---------- .../Stub/Session+Stub.swift | 3 ++- 4 files changed, 16 insertions(+), 15 deletions(-) diff --git a/Sources/Auth/AuthDecryptionService.swift b/Sources/Auth/AuthDecryptionService.swift index 11e9a2fbd..49f9b34d2 100644 --- a/Sources/Auth/AuthDecryptionService.swift +++ b/Sources/Auth/AuthDecryptionService.swift @@ -19,7 +19,7 @@ public class AuthDecryptionService { } public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthRequest { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, encodedEnvelope: ciphertext) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) setPairingMetadata(rpcRequest: rpcRequest, topic: topic) if let params = try rpcRequest.params?.get(Auth_RequestParams.self), let id = rpcRequest.id { diff --git a/Tests/WalletConnectKMSTests/EnvelopeTests.swift b/Tests/WalletConnectKMSTests/EnvelopeTests.swift index 3002c0cf1..80449160c 100644 --- a/Tests/WalletConnectKMSTests/EnvelopeTests.swift +++ b/Tests/WalletConnectKMSTests/EnvelopeTests.swift @@ -8,14 +8,14 @@ final class EnvelopeTests: XCTestCase { func testSerialisation() { let envelope = Envelope(type: .type1(pubKey: pubKey), sealbox: sealbox) let serialised = envelope.serialised() - let deserialised = try! Envelope(serialised) + let deserialised = try! Envelope(.base64Encoded(serialised)) XCTAssertEqual(envelope, deserialised) } func testDeserialise() { let serialised = "AnsibWV0aG9kIjoid2Nfc2Vzc2lvbkF1dGhlbnRpY2F0ZSIsImlkIjoxNzEyMjIwNjg1NjM1MzAzLCJqc29ucnBjIjoiMi4wIiwicGFyYW1zIjp7ImV4cGlyeVRpbWVzdGFtcCI6MTcxMjIyNDI4NSwiYXV0aFBheWxvYWQiOnsidHlwZSI6ImVpcDQzNjEiLCJzdGF0ZW1lbnQiOiJJIGFjY2VwdCB0aGUgU2VydmljZU9yZyBUZXJtcyBvZiBTZXJ2aWNlOiBodHRwczpcL1wvYXBwLndlYjNpbmJveC5jb21cL3RvcyIsImNoYWlucyI6WyJlaXAxNTU6MSIsImVpcDE1NToxMzciXSwicmVzb3VyY2VzIjpbInVybjpyZWNhcDpleUpoZEhRaU9uc2laV2x3TVRVMUlqcDdJbkpsY1hWbGMzUXZjR1Z5YzI5dVlXeGZjMmxuYmlJNlczdDlYWDE5ZlE9PSJdLCJkb21haW4iOiJhcHAud2ViM2luYm94IiwidmVyc2lvbiI6IjEiLCJhdWQiOiJodHRwczpcL1wvYXBwLndlYjNpbmJveC5jb21cL2xvZ2luIiwibm9uY2UiOiIzMjg5MTc1NiIsImlhdCI6IjIwMjQtMDQtMDRUMDg6NTE6MjVaIn0sInJlcXVlc3RlciI6eyJwdWJsaWNLZXkiOiIxOWYzNmY1N2M1NjYxNDY4ODk0NmU3MzliNzY4NmE2ZmE1OGNiZWFmOGQ3MzZmM2EzZDI2NjVlM2NlYmE4ZDQ5IiwibWV0YWRhdGEiOnsicmVkaXJlY3QiOnsibmF0aXZlIjoid2NkYXBwOlwvXC8iLCJ1bml2ZXJzYWwiOiJ3d3cud2FsbGV0Y29ubmVjdC5jb21cL2RhcHAifSwiaWNvbnMiOlsiaHR0cHM6XC9cL2F2YXRhcnMuZ2l0aHVidXNlcmNvbnRlbnQuY29tXC91XC8zNzc4NDg4NiJdLCJkZXNjcmlwdGlvbiI6IldhbGxldENvbm5lY3QgREFwcCBzYW1wbGUiLCJ1cmwiOiJ3YWxsZXQuY29ubmVjdCIsIm5hbWUiOiJTd2lmdCBEYXBwIn19fX0" - let deserialised = try! Envelope(serialised) + let deserialised = try! Envelope(.base64UrlEncoded(serialised)) XCTAssertEqual(deserialised.type, .type2) } diff --git a/Tests/WalletConnectKMSTests/SerialiserTests.swift b/Tests/WalletConnectKMSTests/SerialiserTests.swift index c7187522f..96cbe7f22 100644 --- a/Tests/WalletConnectKMSTests/SerialiserTests.swift +++ b/Tests/WalletConnectKMSTests/SerialiserTests.swift @@ -23,7 +23,7 @@ final class SerializerTests: XCTestCase { _ = try! myKms.createSymmetricKey(topic) let messageToSerialize = "todo - change for request object" let serializedMessage = try! mySerializer.serialize(topic: topic, encodable: messageToSerialize, envelopeType: .type0) - let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, encodedEnvelope: serializedMessage)! + let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, codingType: .base64Encoded(serializedMessage))! XCTAssertEqual(messageToSerialize, deserializedMessage) } @@ -39,7 +39,7 @@ final class SerializerTests: XCTestCase { let serializedMessage = try! peerSerializer.serialize(topic: topic, encodable: messageToSerialize, envelopeType: .type1(pubKey: peerPubKey.rawRepresentation)) print(agreementKeys.sharedKey.hexRepresentation) // -----------Me Deserialising ------------------- - let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, encodedEnvelope: serializedMessage)! + let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, codingType: .base64Encoded(serializedMessage))! XCTAssertEqual(messageToSerialize, deserializedMessage) } @@ -54,7 +54,7 @@ final class SerializerTests: XCTestCase { } // Deserialize the serialized message back into the original object - guard let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: "", encodedEnvelope: serializedMessage) else { + guard let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: "", codingType: .base64UrlEncoded(serializedMessage)) else { XCTFail("Deserialization failed for Type 2 envelope.") return } @@ -75,11 +75,11 @@ final class SerializerTests: XCTestCase { _ = try! myKms.createSymmetricKey(topic) let serialized = try! mySerializer.serialize(topic: topic, encodable: request, envelopeType: .type0) - if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: serialized) { + if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(serialized)) { switch result { - case .left(let deserializedRequest): - XCTAssertEqual(deserializedRequest.method, request.method) - XCTAssertEqual(deserializedRequest.id, request.id) + case .left(let result): + XCTAssertEqual(result.request.method, request.method) + XCTAssertEqual(result.request.id, request.id) // You'll need to compare the params more thoroughly in practice. default: XCTFail("Deserialization should have succeeded with RPCRequest") @@ -96,10 +96,10 @@ final class SerializerTests: XCTestCase { _ = try! myKms.createSymmetricKey(topic) let serialized = try! mySerializer.serialize(topic: topic, encodable: response, envelopeType: .type0) - if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: serialized) { + if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(serialized)) { switch result { - case .right(let deserializedResponse): - XCTAssertEqual(deserializedResponse, response) + case .right(let result): + XCTAssertEqual(result.response, response) default: XCTFail("Deserialization should have succeeded with RPCResponse") } @@ -115,7 +115,7 @@ final class SerializerTests: XCTestCase { // Assuming serialize can accept invalidData for the purpose of this test let serialized = try! mySerializer.serialize(topic: topic, encodable: invalidData, envelopeType: .type0) - let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, encodedEnvelope: serialized) + let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(serialized)) XCTAssertNil(result, "Deserialization should fail for invalid data") } diff --git a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift index f9ea60bfb..4e332022d 100644 --- a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift +++ b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift @@ -31,7 +31,8 @@ extension WCSession { events: [], accounts: Account.stubSet(), acknowledged: acknowledged, - expiryTimestamp: Int64(expiryDate.timeIntervalSince1970)) + expiryTimestamp: Int64(expiryDate.timeIntervalSince1970), + transportType: .relay) } } From 6c13a191e7a7d786185dea91192ef2463a1aab56 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Apr 2024 11:19:14 +0400 Subject: [PATCH 546/814] add testLinkSessionRequest --- .../Sign/SignClientTests.swift | 76 +++++++++++++++++++ .../SessionRequestDispatcher.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 21 ++++- 3 files changed, 95 insertions(+), 4 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index d7854ffff..2d4ed0a23 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1193,4 +1193,80 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } + func testLinkSessionRequest() async throws { + let requestExpectation = expectation(description: "Wallet expects to receive a request") + let responseExpectation = expectation(description: "Dapp expects to receive a response") + + let requestMethod = "personal_sign" + let requestParams = [EthSendTransaction.stub()] + let responseParams = "0xdeadbeef" + + let semaphore = DispatchSemaphore(value: 0) + + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in + semaphore.wait() + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create() + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) + + let signature = try signer.sign( + message: siweMessage, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) + + let (_, approveEnvelope) = try! await wallet.approveSessionAuthenticateLinkMode(requestId: request.id, auths: [auth]) + try dapp.dispatchEnvelope(approveEnvelope) + semaphore.signal() + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { [unowned self] (_, result) in + semaphore.wait() + guard case .success(let (session, _)) = result, + let session = session else { XCTFail(); return } + Task(priority: .high) { + let request = try! Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: Blockchain("eip155:1")!) + let requestEnvelope = try! await dapp.requestLinkMode(params: request)! + try! wallet.dispatchEnvelope(requestEnvelope) + semaphore.signal() + } + } + .store(in: &publishers) + + wallet.sessionRequestPublisher.sink { [unowned self] (sessionRequest, _) in + semaphore.wait() + let receivedParams = try! sessionRequest.params.get([EthSendTransaction].self) + XCTAssertEqual(receivedParams, requestParams) + XCTAssertEqual(sessionRequest.method, requestMethod) + requestExpectation.fulfill() + Task(priority: .high) { + let envelope = try! await wallet.respondLinkMode(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(AnyCodable(responseParams)))! + try! dapp.dispatchEnvelope(envelope) + } + semaphore.signal() + }.store(in: &publishers) + + dapp.sessionResponsePublisher.sink { response in + semaphore.wait() + switch response.result { + case .response(let response): + XCTAssertEqual(try! response.get(String.self), responseParams) + case .error: + XCTFail() + } + responseExpectation.fulfill() + }.store(in: &publishers) + semaphore.signal() + + let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: "") + try wallet.dispatchEnvelope(requestEnvelope) + + await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) + } } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift index 7d11f3e51..4822e8704 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -19,7 +19,7 @@ class SessionRequestDispatcher { self.sessionStore = sessionStore } - public func request(_ request: Request) async throws -> (String?) { + public func request(_ request: Request) async throws -> String? { guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { logger.debug("Could not find session for topic \(request.topic)") diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 91c2cc919..9f567f4a7 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -380,10 +380,11 @@ public final class SignClient: SignClientProtocol { /// - requestId: authentication request id /// - signature: CACAO signature of requested message public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> Session? { - let (session, universalLink) = try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) + let (session, _) = try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) return session } + /// the function returns envelope for link mode testing #if DEBUG func approveSessionAuthenticateLinkMode(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String) { let (session, envelope) = try await approveSessionAuthenticateDispatcher.approveSessionAuthenticate(requestId: requestId, auths: auths) @@ -457,17 +458,31 @@ public final class SignClient: SignClientProtocol { /// - Parameters: /// - params: Parameters defining request and related session public func request(params: Request) async throws { - try await sessionRequestDispatcher.request(params) + _ = try await sessionRequestDispatcher.request(params) } + /// the function returns envelope for link mode testing +#if DEBUG + public func requestLinkMode(params: Request) async throws -> String? { + return try await sessionRequestDispatcher.request(params) + } +#endif + /// For the wallet to respond on pending dApp's JSON-RPC request /// - Parameters: /// - topic: Topic of the session for which the request was received. /// - requestId: RPC request ID /// - response: Your JSON RPC response or an error. public func respond(topic: String, requestId: RPCID, response: RPCResult) async throws { - try await sessionResponderDispatcher.respondSessionRequest(topic: topic, requestId: requestId, response: response) + _ = try await sessionResponderDispatcher.respondSessionRequest(topic: topic, requestId: requestId, response: response) } + /// the function returns envelope for link mode testing + +#if DEBUG + public func respondLinkMode(topic: String, requestId: RPCID, response: RPCResult) async throws -> String? { + return try await sessionResponderDispatcher.respondSessionRequest(topic: topic, requestId: requestId, response: response) + } +#endif /// Ping method allows to check if peer client is online and is subscribing for given topic /// From 04902904ca2673bc465df6d06a0bc7287c9b8348 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Apr 2024 15:11:46 +0400 Subject: [PATCH 547/814] savepoint --- .../ApplicationLayer/ConfigurationService.swift | 1 + .../WalletApp/ApplicationLayer/SceneDelegate.swift | 1 + .../Auth/Link/ApproveSessionAuthenticateUtil.swift | 9 ++++++++- .../Auth/Link/LinkSessionRequestSubscriber.swift | 4 ++++ .../Wallet/SessionAuthenticateResponder.swift | 5 ----- .../Sign/SessionRequestsProvider.swift | 14 +++++++++++--- Sources/WalletConnectSign/Sign/SignClient.swift | 4 ++++ .../WalletConnectSign/Sign/SignClientFactory.swift | 2 +- 8 files changed, 30 insertions(+), 10 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index e11004c95..9346c2867 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -32,6 +32,7 @@ final class ConfigurationService { ) Notify.instance.setLogging(level: .debug) + Sign.instance.setLogging(level: .debug) if let clientId = try? Networking.interactor.getClientId() { LoggingService.instance.setUpUser(account: importAccount.account.absoluteString, clientId: clientId) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index bc148975c..b97acfb75 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -23,6 +23,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio return } do { + print("🔵🔵🔵🔵🔵🔵🔵\(url.absoluteString)") try Sign.instance.dispatchEnvelope(url.absoluteString) } catch { print("🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨") diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index e0b94949f..241adab79 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -9,6 +9,7 @@ class ApproveSessionAuthenticateUtil { private let kms: KeyManagementService private let messageFormatter: SIWEFromCacaoFormatting private let signatureVerifier: MessageVerifier + private let networkingInteractor: NetworkInteracting private let rpcHistory: RPCHistory private let logger: ConsoleLogging private let sessionStore: WCSessionStorage @@ -21,7 +22,8 @@ class ApproveSessionAuthenticateUtil { signatureVerifier: MessageVerifier, messageFormatter: SIWEFromCacaoFormatting, sessionStore: WCSessionStorage, - sessionNamespaceBuilder: SessionNamespaceBuilder + sessionNamespaceBuilder: SessionNamespaceBuilder, + networkingInteractor: NetworkInteracting ) { self.logger = logger self.kms = kms @@ -30,6 +32,7 @@ class ApproveSessionAuthenticateUtil { self.sessionNamespaceBuilder = sessionNamespaceBuilder self.signatureVerifier = signatureVerifier self.messageFormatter = messageFormatter + self.networkingInteractor = networkingInteractor } func getsessionAuthenticateRequestParams(requestId: RPCID) throws -> (request: SessionAuthenticateRequestParams, topic: String) { @@ -102,6 +105,10 @@ class ApproveSessionAuthenticateUtil { ) sessionStore.setSession(session) + Task { + logger.debug("subscribing to session topic: \(sessionTopic)") + try await networkingInteractor.subscribe(topic: sessionTopic) + } return session.publicRepresentation() } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift index 23cc924b6..3a235d35d 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift @@ -55,15 +55,19 @@ class LinkSessionRequestSubscriber { return } guard session.hasNamespace(for: request.chainId) else { + logger.debug("Session does not have namespace for chainId") return respondError(payload: payload, reason: .unauthorizedChain, peerUniversalLink: peerUniversalLink) } guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + logger.debug("Session does not have permission for method") return respondError(payload: payload, reason: .unauthorizedMethod(request.method), peerUniversalLink: peerUniversalLink) } guard !request.isExpired() else { + logger.debug("Request is expired") return respondError(payload: payload, reason: .sessionRequestExpired, peerUniversalLink: peerUniversalLink) } + logger.debug("will emit request") sessionRequestsProvider.emitRequestIfPending() } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index 90033bc59..2f5a6123c 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -64,11 +64,6 @@ actor SessionAuthenticateResponder { transportType: .relay ) - Task { - logger.debug("subscribing to session topic: \(sessionTopic)") - try await networkingInteractor.subscribe(topic: sessionTopic) - } - pairingRegisterer.activate( pairingTopic: pairingTopic, peerMetadata: sessionAuthenticateRequestParams.requester.metadata diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index 89c8e9e79..2b1a4afda 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -5,7 +5,7 @@ class SessionRequestsProvider { private let historyService: HistoryService private var sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() private var lastEmitTime: Date? - private let debounceInterval: TimeInterval = 1 + private let debounceInterval: TimeInterval = 0.4 public var sessionRequestPublisher: AnyPublisher<(request: Request, context: VerifyContext?), Never> { sessionRequestPublisherSubject.eraseToAnyPublisher() @@ -17,8 +17,16 @@ class SessionRequestsProvider { func emitRequestIfPending() { let now = Date() - if let lastEmitTime = lastEmitTime, now.timeIntervalSince(lastEmitTime) < debounceInterval { - return + if let lastEmitTime = lastEmitTime { + // Check if the time interval since 'lastEmitTime' is less than 'debounceInterval' + if now.timeIntervalSince(lastEmitTime) < debounceInterval { + // print("🚨 Debounce interval not yet elapsed since last emit.") + return + } else { + // print("✅ Enough time has elapsed since last emit.") + } + } else { + // print("⚠️ 'lastEmitTime' is nil. Proceeding with operation.") } self.lastEmitTime = now diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 9f567f4a7..51362e951 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -558,6 +558,10 @@ public final class SignClient: SignClientProtocol { } #endif + public func setLogging(level: LoggingLevel) { + logger.setLogging(level: level) + } + // MARK: - Private private func setUpEnginesCallbacks() { diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 6ea2fcbde..3bda8436d 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -113,7 +113,7 @@ public struct SignClientFactory { let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) - let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder) + let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder, networkingInteractor: networkingClient) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) From 813904f72d5ff63828b0e56bcb238d0dcde9a895 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 25 Apr 2024 09:32:15 +0400 Subject: [PATCH 548/814] update encoding --- .../AuthRequest/AuthRequestPresenter.swift | 18 +++++++++--------- .../Auth/Services/SignRecapBuilder.swift | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 131546b82..542593811 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -140,15 +140,6 @@ final class AuthRequestPresenter: ObservableObject { } private func buildAuthObjects() throws -> [AuthObject] { - guard let chain = getCommonAndRequestedChainsIntersection().first else { - throw Errors.noCommonChains - } - - let auth = try createAuthObjectForChain(chain: chain) - return [auth] - } - - private func buildOneAuthObject() throws -> [AuthObject] { var auths = [AuthObject]() try getCommonAndRequestedChainsIntersection().forEach { chain in @@ -158,6 +149,15 @@ final class AuthRequestPresenter: ObservableObject { return auths } + private func buildOneAuthObject() throws -> [AuthObject] { + guard let chain = getCommonAndRequestedChainsIntersection().first else { + throw Errors.noCommonChains + } + + let auth = try createAuthObjectForChain(chain: chain) + return [auth] + } + func getCommonAndRequestedChainsIntersection() -> Set { let requestedChains: Set = Set(request.payload.chains.compactMap { Blockchain($0) }) diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift index fc008a98d..8d7b0ee63 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift @@ -45,7 +45,7 @@ struct SignRecapBuilder { guard let jsonData = try? encoder.encode(modifiedRecapData) else { throw SignRecap.Errors.invalidRecapStructure } - let jsonBase64String = jsonData.base64EncodedString() + let jsonBase64String = jsonData.base64urlEncodedString() let modifiedUrn = "urn:recap:\(jsonBase64String)" return try SignRecap(urn: modifiedUrn) From f65d041ffe337d809c1af3d4962ddabf0a7724ee Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 25 Apr 2024 09:47:07 +0400 Subject: [PATCH 549/814] update encoding --- .../Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift index bbc717920..683416d14 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift @@ -7,7 +7,7 @@ class AuthenticatedSessionRecapUrnFactory { let jsonEncoder = JSONEncoder() jsonEncoder.outputFormatting = .withoutEscapingSlashes let jsonData = try jsonEncoder.encode(recap) - let base64Encoded = jsonData.base64EncodedString() + let base64Encoded = jsonData.base64urlEncodedString() let urn = "urn:recap:\(base64Encoded)" return urn } From 08b6d19ac0f44a2bc0d361b611c69bf6c0534bbe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 25 Apr 2024 11:22:55 +0400 Subject: [PATCH 550/814] retain additional attributes in sign recap --- .../AuthenticatedSessionRecapUrnFactory.swift | 4 +-- .../Auth/Services/SignRecapBuilder.swift | 20 +++++++------- .../SIWE/RecapUrnMergingService.swift | 2 +- .../SignRecapBuilderTests.swift | 27 +++++++++++++++++++ .../RecapUrnMergingServiceTests.swift | 4 +-- 5 files changed, 41 insertions(+), 16 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift index 683416d14..478f3580d 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticatedSessionRecapUrnFactory.swift @@ -7,8 +7,8 @@ class AuthenticatedSessionRecapUrnFactory { let jsonEncoder = JSONEncoder() jsonEncoder.outputFormatting = .withoutEscapingSlashes let jsonData = try jsonEncoder.encode(recap) - let base64Encoded = jsonData.base64urlEncodedString() - let urn = "urn:recap:\(base64Encoded)" + let base64urlEncoded = jsonData.base64urlEncodedString() + let urn = "urn:recap:\(base64urlEncoded)" return urn } } diff --git a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift index 8d7b0ee63..2814591ec 100644 --- a/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift +++ b/Sources/WalletConnectSign/Auth/Services/SignRecapBuilder.swift @@ -17,27 +17,24 @@ struct SignRecapBuilder { throw BuilderError.nonEVMChainNamespace } - // Convert supportedEVMChains to string array for intersection let supportedChainStrings = supportedEVMChains.map { $0.absoluteString } - - // Find intersection of requestedChains and supportedEVMChains strings let commonChains = requestedChains.filter(supportedChainStrings.contains) guard !commonChains.isEmpty else { throw BuilderError.noCommonChains } let requestedRecap = try SignRecap(urn: urn) + var filteredActions = requestedRecap.recapData.att ?? [:] - var filteredActions: [String: [String: [AnyCodable]]] = [:] - - if let eip155Actions = requestedRecap.recapData.att?["eip155"] { + if let eip155Actions = filteredActions["eip155"] { + var newEip155Actions: [String: [AnyCodable]] = [:] for method in supportedMethods { let actionKey = "request/\(method)" - if eip155Actions.keys.contains(actionKey) { - // Use only common chains for each supported method - filteredActions["eip155", default: [:]][actionKey] = [AnyCodable(["chains": commonChains])] + if let actions = eip155Actions[actionKey] { + newEip155Actions[actionKey] = [AnyCodable(["chains": commonChains])] } } + filteredActions["eip155"] = newEip155Actions } let modifiedRecapData = SignRecap.RecapData(att: filteredActions, prf: requestedRecap.recapData.prf) @@ -45,9 +42,10 @@ struct SignRecapBuilder { guard let jsonData = try? encoder.encode(modifiedRecapData) else { throw SignRecap.Errors.invalidRecapStructure } - let jsonBase64String = jsonData.base64urlEncodedString() + let jsonBase64urlString = jsonData.base64urlEncodedString() - let modifiedUrn = "urn:recap:\(jsonBase64String)" + let modifiedUrn = "urn:recap:\(jsonBase64urlString)" return try SignRecap(urn: modifiedUrn) } + } diff --git a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift index 02c7452d8..86e1e3523 100644 --- a/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift +++ b/Sources/WalletConnectUtils/SIWE/RecapUrnMergingService.swift @@ -49,7 +49,7 @@ public class RecapUrnMergingService { let encoder = JSONEncoder() encoder.outputFormatting = [.sortedKeys] guard let jsonData = try? encoder.encode(RecapData(att: sortedMergedAtt, prf: nil)), - let jsonBase64 = jsonData.base64EncodedString().addingPercentEncoding(withAllowedCharacters: .urlHostAllowed) else { + let jsonBase64 = jsonData.base64urlEncodedString().addingPercentEncoding(withAllowedCharacters: .urlHostAllowed) else { throw Errors.encodingFailed } diff --git a/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift b/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift index cd69c8475..8d002196e 100644 --- a/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift +++ b/Tests/WalletConnectSignTests/SignRecapBuilderTests.swift @@ -91,4 +91,31 @@ class SignRecapBuilderTests: XCTestCase { XCTAssertFalse(result.recapData.att?["eip155"]?.keys.contains("request/extraUnsupportedMethod") ?? true, "Result should not contain 'extraUnsupportedMethod'") } + func testSessionRecapBuilder_RetainsAdditionalAttributes() throws { + // Given + let requestedRecap: [String: [String: [String: [[String: [String]]]]]] = [ + "att": [ + "eip155": [ + "request/eth_sendTransaction": [[:]], + "request/personal_sign": [[:]] + ], + "https://notify.walletconnect.com": [ + "manage/all-apps-notifications": [[:]] + ] + ] + ] + let encoded = try! JSONEncoder().encode(requestedRecap).base64EncodedString() + let urn = "urn:recap:\(encoded)" + + let supportedChains = [Blockchain("eip155:1")!, Blockchain("eip155:137")!] + let supportedMethods = ["eth_sendTransaction", "personal_sign"] + let requestedChains = ["eip155:1", "eip155:137"] + + // When + let result = try SignRecapBuilder.build(requestedSessionRecap: urn, requestedChains: requestedChains, supportedEVMChains: supportedChains, supportedMethods: supportedMethods) + + // Then + XCTAssertNotNil(result.recapData.att?["eip155"], "EIP155 namespace should be present") + XCTAssertNotNil(result.recapData.att?["https://notify.walletconnect.com"], "https://notify.walletconnect.com namespace should be retained") + } } diff --git a/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift b/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift index 719cf7a45..ead98da62 100644 --- a/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift +++ b/Tests/WalletConnectUtilsTests/RecapUrnMergingServiceTests.swift @@ -25,8 +25,8 @@ class RecapUrnMergingTests: XCTestCase { } """ - guard let notifyBase64 = notifyRecapJson.data(using: .utf8)?.base64EncodedString(), - let signBase64 = signRecapJson.data(using: .utf8)?.base64EncodedString() else { + guard let notifyBase64 = notifyRecapJson.data(using: .utf8)?.base64urlEncodedString(), + let signBase64 = signRecapJson.data(using: .utf8)?.base64urlEncodedString() else { XCTFail("Failed to encode JSON strings to Base64") return } From 30d95424d15a6d2d052a017cdca91e273687cc36 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 25 Apr 2024 10:11:13 +0000 Subject: [PATCH 551/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 21ba9ac25..c4ccda17c 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.5"} +{"version": "1.18.6"} From cc211b098cbaed6b3c85c443df6f9ff022bc23a7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Apr 2024 16:43:48 +0100 Subject: [PATCH 552/814] savepoint --- Sources/WalletConnectRelay/Dispatching.swift | 15 +++++++++++- .../SocketUrlFallbackHandler.swift | 23 ++++++++++--------- 2 files changed, 26 insertions(+), 12 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 2d18d1fdd..070e0fd64 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -108,10 +108,23 @@ final class Dispatcher: NSObject, Dispatching { } func connect() throws { + // Attempt to handle connection try socketConnectionHandler.handleConnect() - start counting for fallback on first connect attempt + + // Start a timer for the fallback mechanism + let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) + timer.schedule(deadline: .now() + .seconds(defaultTimeout)) + timer.setEventHandler { [unowned self] in + if !self.socket.isConnected { + self.logger.debug("Connection timed out, initiating fallback...") + self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) + } + timer.cancel() + } + timer.resume() } + func disconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws { try socketConnectionHandler.handleDisconnect(closeCode: closeCode) } diff --git a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift index 0db60b2f4..46d1ed5a0 100644 --- a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift +++ b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift @@ -7,17 +7,18 @@ class SocketUrlFallbackHandler { private var socket: WebSocketConnecting private let networkMonitor: NetworkMonitoring - init(relayUrlFactory: RelayUrlFactory, - logger: ConsoleLogging, - socketConnectionHandler: SocketConnectionHandler, - socket: WebSocketConnecting, - networkMonitor: NetworkMonitoring) { - self.relayUrlFactory = relayUrlFactory - self.logger = logger - self.socketConnectionHandler = socketConnectionHandler - self.socket = socket - self.networkMonitor = networkMonitor - } + init( + relayUrlFactory: RelayUrlFactory, + logger: ConsoleLogging, + socketConnectionHandler: SocketConnectionHandler, + socket: WebSocketConnecting, + networkMonitor: NetworkMonitoring) { + self.relayUrlFactory = relayUrlFactory + self.logger = logger + self.socketConnectionHandler = socketConnectionHandler + self.socket = socket + self.networkMonitor = networkMonitor + } func handleFallbackIfNeeded(error: NetworkError) { if error == .connectionFailed && socket.request.url?.host == NetworkConstants.defaultUrl { From ed0ca50323ef1a85cfb7524f4d84bebe1353ce50 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 2 May 2024 11:15:17 +0100 Subject: [PATCH 553/814] savepoint --- Sources/WalletConnectRelay/Dispatching.swift | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 070e0fd64..f52192cb5 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -76,6 +76,7 @@ final class Dispatcher: NSObject, Dispatching { var cancellable: AnyCancellable? cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) .filter { $0.0 == .connected && $0.1 == .connected } + .first() .setFailureType(to: NetworkError.self) .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) .sink(receiveCompletion: { [unowned self] result in @@ -96,12 +97,16 @@ final class Dispatcher: NSObject, Dispatching { func protectedSend(_ string: String) async throws { + var isResumed = false return try await withCheckedThrowingContinuation { continuation in protectedSend(string) { error in - if let error = error { - continuation.resume(throwing: error) - } else { - continuation.resume(returning: ()) + if !isResumed { + if let error = error { + continuation.resume(throwing: error) + } else { + continuation.resume(returning: ()) + } + isResumed = true } } } From d705ce2604c0b0127de2c5a1b204016b76331e8d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 2 May 2024 13:32:54 +0100 Subject: [PATCH 554/814] savepoint --- Sources/WalletConnectRelay/Dispatching.swift | 23 ++----------- .../RelayClientFactory.swift | 13 +++---- .../AutomaticSocketConnectionHandler.swift | 34 ++++++++++++++++++- .../ManualSocketConnectionHandler.swift | 29 +++++++++++++--- .../SocketUrlFallbackHandler.swift | 8 ++--- 5 files changed, 67 insertions(+), 40 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index f52192cb5..32fac0135 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -16,14 +16,12 @@ final class Dispatcher: NSObject, Dispatching { var onMessage: ((String) -> Void)? var socket: WebSocketConnecting var socketConnectionHandler: SocketConnectionHandler - var socketUrlFallbackHandler: SocketUrlFallbackHandler + private let defaultTimeout: Int = 5 private let relayUrlFactory: RelayUrlFactory private let networkMonitor: NetworkMonitoring private let logger: ConsoleLogging - private let defaultTimeout: Int = 5 - private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) var socketConnectionStatusPublisher: AnyPublisher { @@ -42,8 +40,7 @@ final class Dispatcher: NSObject, Dispatching { networkMonitor: NetworkMonitoring, socket: WebSocketConnecting, logger: ConsoleLogging, - socketUrlFallbackHandler: SocketUrlFallbackHandler, - socketConnectionHandler:SocketConnectionHandler + socketConnectionHandler: SocketConnectionHandler ) { self.socketConnectionHandler = socketConnectionHandler self.relayUrlFactory = relayUrlFactory @@ -51,7 +48,6 @@ final class Dispatcher: NSObject, Dispatching { self.logger = logger self.socket = socket - self.socketUrlFallbackHandler = socketUrlFallbackHandler super.init() setUpWebSocketSession() @@ -83,9 +79,6 @@ final class Dispatcher: NSObject, Dispatching { switch result { case .failure(let error): cancellable?.cancel() - if !socket.isConnected { - socketUrlFallbackHandler.handleFallbackIfNeeded(error: error) - } completion(error) case .finished: break } @@ -115,18 +108,6 @@ final class Dispatcher: NSObject, Dispatching { func connect() throws { // Attempt to handle connection try socketConnectionHandler.handleConnect() - - // Start a timer for the fallback mechanism - let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) - timer.schedule(deadline: .now() + .seconds(defaultTimeout)) - timer.setEventHandler { [unowned self] in - if !self.socket.isConnected { - self.logger.debug("Connection timed out, initiating fallback...") - self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) - } - timer.cancel() - } - timer.resume() } diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index f6eda742b..3a4097336 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -61,19 +61,17 @@ public struct RelayClientFactory { if let bundleId = Bundle.main.bundleIdentifier { socket.request.addValue(bundleId, forHTTPHeaderField: "Origin") } - var socketConnectionHandler: SocketConnectionHandler! - switch socketConnectionType { - case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket) - case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket) - } - let socketFallbackHandler = SocketUrlFallbackHandler( relayUrlFactory: relayUrlFactory, logger: logger, - socketConnectionHandler: socketConnectionHandler, socket: socket, networkMonitor: networkMonitor ) + var socketConnectionHandler: SocketConnectionHandler! + switch socketConnectionType { + case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger, socketUrlFallbackHandler: socketFallbackHandler) + case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket, logger: logger, socketUrlFallbackHandler: socketFallbackHandler) + } let dispatcher = Dispatcher( socketFactory: socketFactory, @@ -81,7 +79,6 @@ public struct RelayClientFactory { networkMonitor: networkMonitor, socket: socket, logger: logger, - socketUrlFallbackHandler: socketFallbackHandler, socketConnectionHandler: socketConnectionHandler ) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index adb0d3929..f7fe3ad99 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -14,24 +14,56 @@ class AutomaticSocketConnectionHandler { private let appStateObserver: AppStateObserving private let networkMonitor: NetworkMonitoring private let backgroundTaskRegistrar: BackgroundTaskRegistering + private let defaultTimeout: Int = 5 + private let logger: ConsoleLogging + private var socketUrlFallbackHandler: SocketUrlFallbackHandler private var publishers = Set() + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", attributes: .concurrent) init( socket: WebSocketConnecting, networkMonitor: NetworkMonitoring = NetworkMonitor(), appStateObserver: AppStateObserving = AppStateObserver(), - backgroundTaskRegistrar: BackgroundTaskRegistering = BackgroundTaskRegistrar() + backgroundTaskRegistrar: BackgroundTaskRegistering = BackgroundTaskRegistrar(), + logger: ConsoleLogging, + socketUrlFallbackHandler: SocketUrlFallbackHandler ) { self.appStateObserver = appStateObserver self.socket = socket self.networkMonitor = networkMonitor self.backgroundTaskRegistrar = backgroundTaskRegistrar + self.logger = logger + self.socketUrlFallbackHandler = socketUrlFallbackHandler setUpStateObserving() setUpNetworkMonitoring() + socketUrlFallbackHandler.onTryReconnect = { [unowned self] in + Task(priority: .high) { + await tryReconect() + } + } + + connect() + + } + + func connect() { + // Attempt to handle connection socket.connect() + + // Start a timer for the fallback mechanism + let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) + timer.schedule(deadline: .now() + .seconds(defaultTimeout)) + timer.setEventHandler { [unowned self] in + if !self.socket.isConnected { + self.logger.debug("Connection timed out, initiating fallback...") + self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) + } + timer.cancel() + } + timer.resume() } private func setUpStateObserving() { diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index 2198c9e12..3a1b70aec 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -2,14 +2,35 @@ import Foundation class ManualSocketConnectionHandler: SocketConnectionHandler { - var socket: WebSocketConnecting + private let socket: WebSocketConnecting + private let logger: ConsoleLogging + private let defaultTimeout: Int = 5 + private var socketUrlFallbackHandler: SocketUrlFallbackHandler + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.manual_socket_connection", attributes: .concurrent) - init(socket: WebSocketConnecting) { - self.socket = socket - } + + init( + socket: WebSocketConnecting, + logger: ConsoleLogging, + socketUrlFallbackHandler: SocketUrlFallbackHandler) { + self.socket = socket + self.logger = logger + self.socketUrlFallbackHandler = socketUrlFallbackHandler + } func handleConnect() throws { socket.connect() + // Start a timer for the fallback mechanism + let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) + timer.schedule(deadline: .now() + .seconds(defaultTimeout)) + timer.setEventHandler { [unowned self] in + if !self.socket.isConnected { + self.logger.debug("Connection timed out, initiating fallback...") + self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) + } + timer.cancel() + } + timer.resume() } func handleDisconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws { diff --git a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift index 46d1ed5a0..dea30eecd 100644 --- a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift +++ b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift @@ -3,19 +3,17 @@ import Foundation class SocketUrlFallbackHandler { private let relayUrlFactory: RelayUrlFactory private var logger: ConsoleLogging - private var socketConnectionHandler: SocketConnectionHandler private var socket: WebSocketConnecting private let networkMonitor: NetworkMonitoring + var onTryReconnect: (()->())? init( relayUrlFactory: RelayUrlFactory, logger: ConsoleLogging, - socketConnectionHandler: SocketConnectionHandler, socket: WebSocketConnecting, networkMonitor: NetworkMonitoring) { self.relayUrlFactory = relayUrlFactory self.logger = logger - self.socketConnectionHandler = socketConnectionHandler self.socket = socket self.networkMonitor = networkMonitor } @@ -25,9 +23,7 @@ class SocketUrlFallbackHandler { logger.debug("[WebSocket] - Fallback to \(NetworkConstants.fallbackUrl)") relayUrlFactory.setFallback() socket.request.url = relayUrlFactory.create() - Task(priority: .high) { - await self.socketConnectionHandler.tryReconect() - } + onTryReconnect?() } } } From 1d127e4ed813b97f4cb02197576170b2ec3b9900 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 2 May 2024 13:39:28 +0100 Subject: [PATCH 555/814] savepoint --- Example/DApp/SceneDelegate.swift | 1 + .../ManualSocketConnectionHandler.swift | 7 ++++++- 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index c8abceae9..56cb86c11 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -50,6 +50,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) Sign.instance.logger.setLogging(level: .debug) + Networking.instance.setLogging(level: .debug) Sign.instance.logsPublisher.sink { log in switch log { diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index 3a1b70aec..c81082ebc 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -8,7 +8,6 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { private var socketUrlFallbackHandler: SocketUrlFallbackHandler private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.manual_socket_connection", attributes: .concurrent) - init( socket: WebSocketConnecting, logger: ConsoleLogging, @@ -16,6 +15,12 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { self.socket = socket self.logger = logger self.socketUrlFallbackHandler = socketUrlFallbackHandler + + socketUrlFallbackHandler.onTryReconnect = { [unowned self] in + Task(priority: .high) { + await tryReconect() + } + } } func handleConnect() throws { From 369917d899de3a0fd16483a93108e2a78312d36f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 2 May 2024 16:48:12 +0100 Subject: [PATCH 556/814] fix unit tests --- ...utomaticSocketConnectionHandlerTests.swift | 20 ++++++++++++++++++- Tests/RelayerTests/DispatcherTests.swift | 9 ++++++--- .../ManualSocketConnectionHandlerTests.swift | 18 ++++++++++++++++- Tests/RelayerTests/RelayClientTests.swift | 11 ---------- 4 files changed, 42 insertions(+), 16 deletions(-) diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index 12f7c1d94..b29a830ba 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -13,12 +13,30 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { webSocketSession = WebSocketMock() networkMonitor = NetworkMonitoringMock() appStateObserver = AppStateObserverMock() + let webSocket = WebSocketMock() + + let defaults = RuntimeKeyValueStorage() + let logger = ConsoleLoggerMock() + let keychainStorageMock = DispatcherKeychainStorageMock() + let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychainStorageMock, logger: logger) + + + let socketAuthenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) + let relayUrlFactory = RelayUrlFactory( + relayHost: "relay.walletconnect.com", + projectId: "1012db890cf3cfb0c1cdc929add657ba", + socketAuthenticator: socketAuthenticator + ) backgroundTaskRegistrar = BackgroundTaskRegistrarMock() + let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: ConsoleLoggerMock(), socket: webSocket, networkMonitor: networkMonitor) sut = AutomaticSocketConnectionHandler( socket: webSocketSession, networkMonitor: networkMonitor, appStateObserver: appStateObserver, - backgroundTaskRegistrar: backgroundTaskRegistrar) + backgroundTaskRegistrar: backgroundTaskRegistrar, + logger: ConsoleLoggerMock(), + socketUrlFallbackHandler: socketUrlFallbackHandler + ) } func testConnectsOnConnectionSatisfied() { diff --git a/Tests/RelayerTests/DispatcherTests.swift b/Tests/RelayerTests/DispatcherTests.swift index 331bd640d..4a58cfd97 100644 --- a/Tests/RelayerTests/DispatcherTests.swift +++ b/Tests/RelayerTests/DispatcherTests.swift @@ -5,7 +5,7 @@ import Combine import TestingUtils import Combine -private class DispatcherKeychainStorageMock: KeychainStorageProtocol { +class DispatcherKeychainStorageMock: KeychainStorageProtocol { func add(_ item: T, forKey key: String) throws where T : WalletConnectKMS.GenericPasswordConvertible {} func read(key: String) throws -> T where T : WalletConnectKMS.GenericPasswordConvertible { return try T(rawRepresentation: Data()) @@ -71,12 +71,15 @@ final class DispatcherTests: XCTestCase { projectId: "1012db890cf3cfb0c1cdc929add657ba", socketAuthenticator: socketAuthenticator ) + let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: logger, socket: webSocket, networkMonitor: networkMonitor) + let socketConnectionHandler = ManualSocketConnectionHandler(socket: webSocket, logger: logger, socketUrlFallbackHandler: socketUrlFallbackHandler) sut = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: relayUrlFactory, networkMonitor: networkMonitor, - socketConnectionType: .manual, - logger: ConsoleLoggerMock() + socket: webSocket, + logger: ConsoleLoggerMock(), + socketConnectionHandler: socketConnectionHandler ) } diff --git a/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift b/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift index 0b809b918..6f8a939cb 100644 --- a/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift @@ -8,7 +8,23 @@ final class ManualSocketConnectionHandlerTests: XCTestCase { var networkMonitor: NetworkMonitoringMock! override func setUp() { socket = WebSocketMock() - sut = ManualSocketConnectionHandler(socket: socket) + + let defaults = RuntimeKeyValueStorage() + let logger = ConsoleLoggerMock() + let networkMonitor = NetworkMonitoringMock() + let keychainStorageMock = DispatcherKeychainStorageMock() + let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychainStorageMock, logger: logger) + + + let socketAuthenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) + let relayUrlFactory = RelayUrlFactory( + relayHost: "relay.walletconnect.com", + projectId: "1012db890cf3cfb0c1cdc929add657ba", + socketAuthenticator: socketAuthenticator + ) + let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: ConsoleLoggerMock(), socket: socket, networkMonitor: networkMonitor) + + sut = ManualSocketConnectionHandler(socket: socket, logger: ConsoleLoggerMock(), socketUrlFallbackHandler: socketUrlFallbackHandler) } func testHandleDisconnect() { diff --git a/Tests/RelayerTests/RelayClientTests.swift b/Tests/RelayerTests/RelayClientTests.swift index 5905e6e70..6442757cb 100644 --- a/Tests/RelayerTests/RelayClientTests.swift +++ b/Tests/RelayerTests/RelayClientTests.swift @@ -48,12 +48,6 @@ final class RelayClientTests: XCTestCase { XCTAssertNotNil(request) } - func testPublishRequest() async { - try? await sut.publish(topic: "", payload: "{}", tag: 0, prompt: false, ttl: 60) - let request = dispatcher.getLastRequestSent() - XCTAssertNotNil(request) - } - func testUnsubscribeRequest() { let topic = String.randomTopic() sut.subscriptions[topic] = "" @@ -77,11 +71,6 @@ final class RelayClientTests: XCTestCase { waitForExpectations(timeout: 0.1, handler: nil) } - func testSendOnPublish() async { - try? await sut.publish(topic: "", payload: "", tag: 0, prompt: false, ttl: 60) - XCTAssertTrue(dispatcher.sent) - } - func testSendOnSubscribe() async { try? await sut.subscribe(topic: "") XCTAssertTrue(dispatcher.sent) From fd02b0a3810285c48bc1fcbcfb303ba37b9aef37 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 2 May 2024 16:56:42 +0100 Subject: [PATCH 557/814] fix relay tests --- .../RelayClientEndToEndTests.swift | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index 3ac8d75b7..eef6758de 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -42,15 +42,26 @@ final class RelayClientEndToEndTests: XCTestCase { projectId: InputConfig.projectId, socketAuthenticator: socketAuthenticator ) - let socket = WebSocket(url: urlFactory.create(fallback: false)) + let socket = WebSocket(url: urlFactory.create()) let webSocketFactory = WebSocketFactoryMock(webSocket: socket) let networkMonitor = NetworkMonitor() + + let relayUrlFactory = RelayUrlFactory( + relayHost: "relay.walletconnect.com", + projectId: "1012db890cf3cfb0c1cdc929add657ba", + socketAuthenticator: socketAuthenticator + ) + + let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: logger, socket: socket, networkMonitor: networkMonitor) + + let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger, socketUrlFallbackHandler: socketUrlFallbackHandler) let dispatcher = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: urlFactory, networkMonitor: networkMonitor, - socketConnectionType: .manual, - logger: logger + socket: socket, + logger: logger, + socketConnectionHandler: socketConnectionHandler ) let keychain = KeychainStorageMock() let relayClient = RelayClientFactory.create( From 590394ca8778f5f569fef5188b25bdce7f2ec7ed Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 3 May 2024 10:24:12 +0100 Subject: [PATCH 558/814] fix continuation being missused --- Sources/WalletConnectRelay/Dispatching.swift | 1 - .../AutomaticSocketConnectionHandler.swift | 6 +++++- .../ManualSocketConnectionHandler.swift | 6 +++++- 3 files changed, 10 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 32fac0135..a5c47ea17 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -72,7 +72,6 @@ final class Dispatcher: NSObject, Dispatching { var cancellable: AnyCancellable? cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) .filter { $0.0 == .connected && $0.1 == .connected } - .first() .setFailureType(to: NetworkError.self) .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) .sink(receiveCompletion: { [unowned self] result in diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index f7fe3ad99..eb070ec0f 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -56,7 +56,11 @@ class AutomaticSocketConnectionHandler { // Start a timer for the fallback mechanism let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) timer.schedule(deadline: .now() + .seconds(defaultTimeout)) - timer.setEventHandler { [unowned self] in + timer.setEventHandler { [weak self] in + guard let self = self else { + timer.cancel() + return + } if !self.socket.isConnected { self.logger.debug("Connection timed out, initiating fallback...") self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index c81082ebc..d0589ca9e 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -28,7 +28,11 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { // Start a timer for the fallback mechanism let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) timer.schedule(deadline: .now() + .seconds(defaultTimeout)) - timer.setEventHandler { [unowned self] in + timer.setEventHandler { [weak self] in + guard let self = self else { + timer.cancel() + return + } if !self.socket.isConnected { self.logger.debug("Connection timed out, initiating fallback...") self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) From 4169e4b34a05dd2c411788eb18ea50e74aae7420 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Fri, 3 May 2024 09:39:18 +0000 Subject: [PATCH 559/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index c4ccda17c..42dfeb72c 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.6"} +{"version": "1.18.7"} From 01a73dd2d0f8a216c20e7d4c7680f73c99e95d4d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 4 May 2024 08:55:25 +0400 Subject: [PATCH 560/814] savepoint --- Example/DApp/DApp.entitlements | 1 - Example/DApp/SceneDelegate.swift | 2 +- Example/WalletApp/WalletApp.entitlements | 1 - 3 files changed, 1 insertion(+), 3 deletions(-) diff --git a/Example/DApp/DApp.entitlements b/Example/DApp/DApp.entitlements index 1df7fdf23..b71e26ead 100644 --- a/Example/DApp/DApp.entitlements +++ b/Example/DApp/DApp.entitlements @@ -5,7 +5,6 @@ com.apple.developer.associated-domains applinks:walletconnect.com - applinks:www.walletconnect.com com.apple.security.application-groups diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 4314f9d1f..1c495d40d 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -40,7 +40,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { description: "WalletConnect DApp sample", url: "wallet.connect", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://www.walletconnect.com/dapp") + redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://walletconnect.com/dapp") ) Web3Modal.configure( diff --git a/Example/WalletApp/WalletApp.entitlements b/Example/WalletApp/WalletApp.entitlements index 50ae16704..247b8f47a 100644 --- a/Example/WalletApp/WalletApp.entitlements +++ b/Example/WalletApp/WalletApp.entitlements @@ -7,7 +7,6 @@ com.apple.developer.associated-domains applinks:walletconnect.com - applinks:www.walletconnect.com com.apple.developer.usernotifications.communication From e79e576c777da9312a0cfbc9e5bac6af69a66015 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 May 2024 10:08:55 +0300 Subject: [PATCH 561/814] display hex encoded request --- .../SessionRequestPresenter.swift | 22 ++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index a9e9efa10..6c03cd51f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -11,13 +11,21 @@ final class SessionRequestPresenter: ObservableObject { let sessionRequest: Request let session: Session? let validationStatus: VerifyContext.ValidationStatus? - + var message: String { - let message = try? sessionRequest.params.get([String].self) - let decryptedMessage = message.map { String(data: Data(hex: $0.first ?? ""), encoding: .utf8) } - return (decryptedMessage ?? String(describing: sessionRequest.params.value)) ?? String(describing: sessionRequest.params.value) + guard let messages = try? sessionRequest.params.get([String].self), + let firstMessage = messages.first else { + return String(describing: sessionRequest.params.value) + } + + if isValidHexadecimal(firstMessage) { + let data = Data(hex: firstMessage) + return String(data: data, encoding: .utf8) ?? firstMessage + } else { + return firstMessage + } } - + @Published var showError = false @Published var errorMessage = "Error" @Published var showSignedSheet = false @@ -40,6 +48,10 @@ final class SessionRequestPresenter: ObservableObject { self.validationStatus = context?.validation } + private func isValidHexadecimal(_ string: String) -> Bool { + return string.range(of: "^[0-9a-fA-F]+$", options: .regularExpression) != nil + } + @MainActor func onApprove() async throws { do { From 7506d25fc73301ab36d066e2fe27542d6336dfdc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 May 2024 10:30:03 +0300 Subject: [PATCH 562/814] fix the display --- .../SessionRequestPresenter.swift | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift index 6c03cd51f..74e141979 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/SessionRequest/SessionRequestPresenter.swift @@ -11,21 +11,21 @@ final class SessionRequestPresenter: ObservableObject { let sessionRequest: Request let session: Session? let validationStatus: VerifyContext.ValidationStatus? - + var message: String { guard let messages = try? sessionRequest.params.get([String].self), let firstMessage = messages.first else { return String(describing: sessionRequest.params.value) } - if isValidHexadecimal(firstMessage) { - let data = Data(hex: firstMessage) - return String(data: data, encoding: .utf8) ?? firstMessage - } else { - return firstMessage - } + // Attempt to decode the message if it's hex-encoded + let decodedMessage = String(data: Data(hex: firstMessage), encoding: .utf8) + + // Return the decoded message if available, else return the original message + return decodedMessage?.isEmpty == false ? decodedMessage! : firstMessage } + @Published var showError = false @Published var errorMessage = "Error" @Published var showSignedSheet = false @@ -48,10 +48,6 @@ final class SessionRequestPresenter: ObservableObject { self.validationStatus = context?.validation } - private func isValidHexadecimal(_ string: String) -> Bool { - return string.range(of: "^[0-9a-fA-F]+$", options: .regularExpression) != nil - } - @MainActor func onApprove() async throws { do { From 6e06989fcd0747337c914a520108ddc5b2b68b2a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 6 May 2024 13:55:37 +0300 Subject: [PATCH 563/814] fix ethers signing --- Example/Shared/Signer/ETHSigner.swift | 28 ++++++++++++++++++--------- 1 file changed, 19 insertions(+), 9 deletions(-) diff --git a/Example/Shared/Signer/ETHSigner.swift b/Example/Shared/Signer/ETHSigner.swift index dfe84420b..232dcffc2 100644 --- a/Example/Shared/Signer/ETHSigner.swift +++ b/Example/Shared/Signer/ETHSigner.swift @@ -3,7 +3,6 @@ import Commons import Web3 struct ETHSigner { - private let importAccount: ImportAccount init(importAccount: ImportAccount) { @@ -21,8 +20,21 @@ struct ETHSigner { func personalSign(_ params: AnyCodable) -> AnyCodable { let params = try! params.get([String].self) let messageToSign = params[0] - let dataToHash = dataToHash(messageToSign) - let (v, r, s) = try! privateKey.sign(message: .init(hex: dataToHash.toHexString())) + + // Determine if the message is hex-encoded or plain text + let dataToSign: Bytes + if messageToSign.hasPrefix("0x") { + // Hex-encoded message, remove "0x" and convert + let messageData = Data(hex: String(messageToSign.dropFirst(2))) + dataToSign = dataToHash(messageData) + } else { + // Plain text message, convert directly to data + let messageData = Data(messageToSign.utf8) + dataToSign = dataToHash(messageData) + } + + // Sign the data + let (v, r, s) = try! privateKey.sign(message: .init(Data(dataToSign))) let result = "0x" + r.toHexString() + s.toHexString() + String(v + 27, radix: 16) return AnyCodable(result) } @@ -45,12 +57,10 @@ struct ETHSigner { return AnyCodable(result) } - private func dataToHash(_ message: String) -> Bytes { + private func dataToHash(_ data: Data) -> Bytes { let prefix = "\u{19}Ethereum Signed Message:\n" - let messageData = Data(hex: message) - let prefixData = (prefix + String(messageData.count)).data(using: .utf8)! - let prefixedMessageData = prefixData + messageData - let dataToHash: Bytes = .init(hex: prefixedMessageData.toHexString()) - return dataToHash + let prefixData = (prefix + String(data.count)).data(using: .utf8)! + let prefixedMessageData = prefixData + data + return .init(hex: prefixedMessageData.toHexString()) } } From 5e3aeaafe457d784af77824d54198f766dd96fb2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 7 May 2024 16:21:10 +0300 Subject: [PATCH 564/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- Example/DApp/SceneDelegate.swift | 2 +- Example/WalletApp/WalletApp.entitlements | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index da00bd6ce..dba7a45c1 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -113,7 +113,7 @@ final class SignPresenter: ObservableObject { Task { do { - try await Sign.instance.authenticateLinkMode(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://walletconnect.com/wallet") + try await Sign.instance.authenticateLinkMode(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://lab.web3modal.com/wallet") } catch { AlertPresenter.present(message: error.localizedDescription, type: .error) } diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 1c495d40d..ad5ee5166 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -40,7 +40,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { description: "WalletConnect DApp sample", url: "wallet.connect", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://walletconnect.com/dapp") + redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp") ) Web3Modal.configure( diff --git a/Example/WalletApp/WalletApp.entitlements b/Example/WalletApp/WalletApp.entitlements index 247b8f47a..bea343a64 100644 --- a/Example/WalletApp/WalletApp.entitlements +++ b/Example/WalletApp/WalletApp.entitlements @@ -6,7 +6,7 @@ development com.apple.developer.associated-domains - applinks:walletconnect.com + applinks:lab.web3modal.com com.apple.developer.usernotifications.communication From 09d5842002f30f14f5751b12a73c02e81e4d66e5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 8 May 2024 09:44:09 +0300 Subject: [PATCH 565/814] savepoint --- Example/DApp/DApp.entitlements | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/DApp/DApp.entitlements b/Example/DApp/DApp.entitlements index b71e26ead..787b67d9b 100644 --- a/Example/DApp/DApp.entitlements +++ b/Example/DApp/DApp.entitlements @@ -4,7 +4,7 @@ com.apple.developer.associated-domains - applinks:walletconnect.com + applinks:lab.web3modal.com com.apple.security.application-groups From db910fc48d532ac317fac1e92e38e8b762c8017a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 13 May 2024 13:07:19 +0300 Subject: [PATCH 566/814] savepoint --- Example/DApp/DAppRelease.entitlements | 3 +-- Example/ExampleApp.xcodeproj/project.pbxproj | 4 ++-- Example/WalletApp/ApplicationLayer/ConfigurationService.swift | 2 +- Example/WalletApp/WalletAppRelease.entitlements | 3 +-- 4 files changed, 5 insertions(+), 7 deletions(-) diff --git a/Example/DApp/DAppRelease.entitlements b/Example/DApp/DAppRelease.entitlements index 1df7fdf23..787b67d9b 100644 --- a/Example/DApp/DAppRelease.entitlements +++ b/Example/DApp/DAppRelease.entitlements @@ -4,8 +4,7 @@ com.apple.developer.associated-domains - applinks:walletconnect.com - applinks:www.walletconnect.com + applinks:lab.web3modal.com com.apple.security.application-groups diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index f2bc0a4e4..4550f7cbd 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3038,7 +3038,7 @@ CODE_SIGN_ENTITLEMENTS = WalletApp/WalletApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 164; DEVELOPMENT_TEAM = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; @@ -3074,7 +3074,7 @@ CODE_SIGN_ENTITLEMENTS = WalletApp/WalletAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 164; DEVELOPMENT_TEAM = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 9346c2867..ce77eeba5 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://www.walletconnect.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://www.lab.web3modal.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Example/WalletApp/WalletAppRelease.entitlements b/Example/WalletApp/WalletAppRelease.entitlements index 3cf0aee3e..88b3048b4 100644 --- a/Example/WalletApp/WalletAppRelease.entitlements +++ b/Example/WalletApp/WalletAppRelease.entitlements @@ -6,8 +6,7 @@ production com.apple.developer.associated-domains - applinks:walletconnect.com - applinks:www.walletconnect.com + applinks:lab.web3modal.com com.apple.developer.usernotifications.communication From a8485eaf5d60383c44343d72e31957c6cc72e03c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 13 May 2024 13:17:26 +0300 Subject: [PATCH 567/814] savepoint --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index 99cc1d4d1..bc16c21c8 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -57,7 +57,7 @@ final class AuthRequestPresenter: ObservableObject { do { ActivityIndicatorManager.shared.start() - let auths = try buildOneAuthObject() + let auths = try buildAuthObjects() _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) ActivityIndicatorManager.shared.stop() From 4f7b2f8f718419e07b970cbfcd3a8c05dfc25f0d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 13 May 2024 16:57:15 +0300 Subject: [PATCH 568/814] savepoint --- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index b97acfb75..49301762c 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -42,16 +42,23 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio window = UIWindow(windowScene: windowScene) window?.makeKeyAndVisible() + + if let url = connectionOptions.userActivities.first?.webpageURL { + print(url) + try! Sign.instance.dispatchEnvelope(url.absoluteString) + } + configurators.configure() + do { let uri = try WalletConnectURI(connectionOptions: connectionOptions) app.uri = uri } catch { print("Error initializing WalletConnectURI: \(error.localizedDescription)") + } app.requestSent = (connectionOptions.urlContexts.first?.url.absoluteString.replacingOccurrences(of: "walletapp://wc?", with: "") == "requestSent") - configurators.configure() UNUserNotificationCenter.current().delegate = self } From ff7d865d41a6ba9b37313471d90c171d0be7c2b9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 13 May 2024 17:00:22 +0300 Subject: [PATCH 569/814] handle link mode on wallet launch --- .../WalletApp/ApplicationLayer/SceneDelegate.swift | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 49301762c..c3f73e399 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -42,19 +42,20 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio window = UIWindow(windowScene: windowScene) window?.makeKeyAndVisible() - - if let url = connectionOptions.userActivities.first?.webpageURL { - print(url) - try! Sign.instance.dispatchEnvelope(url.absoluteString) - } configurators.configure() + + do { let uri = try WalletConnectURI(connectionOptions: connectionOptions) app.uri = uri } catch { + if let url = connectionOptions.userActivities.first?.webpageURL { + do { + try! Sign.instance.dispatchEnvelope(url.absoluteString) + } + } print("Error initializing WalletConnectURI: \(error.localizedDescription)") - } app.requestSent = (connectionOptions.urlContexts.first?.url.absoluteString.replacingOccurrences(of: "walletapp://wc?", with: "") == "requestSent") From 44d39d9a97188ffa795cdfe03b3d2f7bc17b1973 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 15 May 2024 09:10:01 +0300 Subject: [PATCH 570/814] savepoint --- .../ApplicationLayer/SceneDelegate.swift | 24 +++++++++++-------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index c3f73e399..373dff502 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -39,32 +39,36 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { guard let windowScene = (scene as? UIWindowScene) else { return } + // Setup the window window = UIWindow(windowScene: windowScene) window?.makeKeyAndVisible() - configurators.configure() - + // Notification center delegate setup + UNUserNotificationCenter.current().delegate = self + app.requestSent = (connectionOptions.urlContexts.first?.url.absoluteString.replacingOccurrences(of: "walletapp://wc?", with: "") == "requestSent") + // Process connection options do { + // Attempt to initialize WalletConnectURI from connection options let uri = try WalletConnectURI(connectionOptions: connectionOptions) app.uri = uri } catch { + print("Error initializing WalletConnectURI: \(error.localizedDescription)") + // Try to handle link mode in case where WalletConnectURI initialization fails if let url = connectionOptions.userActivities.first?.webpageURL { + configurators.configure() // Ensure configurators are set up before dispatching do { - try! Sign.instance.dispatchEnvelope(url.absoluteString) + try Sign.instance.dispatchEnvelope(url.absoluteString) + } catch { + print("Error dispatching envelope: \(error.localizedDescription)") } + return } - print("Error initializing WalletConnectURI: \(error.localizedDescription)") } - - app.requestSent = (connectionOptions.urlContexts.first?.url.absoluteString.replacingOccurrences(of: "walletapp://wc?", with: "") == "requestSent") - - - UNUserNotificationCenter.current().delegate = self + configurators.configure() } - func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { guard let context = URLContexts.first else { return } From a10a77bdcdb3ac7fa9ba50785c34e180ed25f5cf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 15 May 2024 10:00:09 +0300 Subject: [PATCH 571/814] fix crash: configure w3w client in the scene delegate --- .../ApplicationLayer/SceneDelegate.swift | 20 +++++++++++++++++++ .../Wallet/Settings/SettingsPresenter.swift | 2 +- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 373dff502..4673b1134 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -46,6 +46,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio // Notification center delegate setup UNUserNotificationCenter.current().delegate = self + configureWeb3WalletClientIfNeeded() app.requestSent = (connectionOptions.urlContexts.first?.url.absoluteString.replacingOccurrences(of: "walletapp://wc?", with: "") == "requestSent") // Process connection options @@ -110,4 +111,23 @@ private extension SceneDelegate { window?.rootViewController?.topController.present(safari, animated: true) } } + + func configureWeb3WalletClientIfNeeded() { + Networking.configure( + groupIdentifier: "group.com.walletconnect.sdk", + projectId: InputConfig.projectId, + socketFactory: DefaultSocketFactory() + ) + + let metadata = AppMetadata( + name: "Example Wallet", + description: "wallet description", + url: "example.wallet", + icons: ["https://avatars.githubusercontent.com/u/37784886"], + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://www.lab.web3modal.com/wallet") + ) + + Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) + + } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift index 163799e3c..87a048768 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/Settings/SettingsPresenter.swift @@ -45,7 +45,7 @@ final class SettingsPresenter: ObservableObject { func logoutPressed() async throws { guard let account = accountStorage.importAccount?.account else { return } - try await interactor.notifyUnregister(account: account) + try? await interactor.notifyUnregister(account: account) accountStorage.importAccount = nil try await Web3Wallet.instance.cleanup() UserDefaults.standard.set(nil, forKey: "deviceToken") From 0391948e295ef6bad14af8c73e4fcddf54fe0cd5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 15 May 2024 12:14:30 +0300 Subject: [PATCH 572/814] Add invalid requests sanitiser --- .../Engine/Common/SessionEngine.swift | 14 +++- .../Services/HistoryService.swift | 18 ++++- .../Services/InvalidRequestsSanitiser.swift | 20 ++++++ .../Sign/SignClientFactory.swift | 3 +- .../RPCHistory/RPCHistory.swift | 16 ++++- .../InvalidRequestsSanitiserTests.swift | 69 +++++++++++++++++++ .../SessionEngineTests.swift | 32 ++++----- 7 files changed, 149 insertions(+), 23 deletions(-) create mode 100644 Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift create mode 100644 Tests/WalletConnectSignTests/InvalidRequestsSanitiserTests.swift diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 435f34f98..5477f86a9 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -26,6 +26,7 @@ final class SessionEngine { private var publishers = [AnyCancellable]() private let logger: ConsoleLogging private let sessionRequestsProvider: SessionRequestsProvider + private let invalidRequestsSanitiser: InvalidRequestsSanitiser init( networkingInteractor: NetworkInteracting, @@ -35,7 +36,8 @@ final class SessionEngine { kms: KeyManagementServiceProtocol, sessionStore: WCSessionStorage, logger: ConsoleLogging, - sessionRequestsProvider: SessionRequestsProvider + sessionRequestsProvider: SessionRequestsProvider, + invalidRequestsSanitiser: InvalidRequestsSanitiser ) { self.networkingInteractor = networkingInteractor self.historyService = historyService @@ -45,6 +47,7 @@ final class SessionEngine { self.sessionStore = sessionStore self.logger = logger self.sessionRequestsProvider = sessionRequestsProvider + self.invalidRequestsSanitiser = invalidRequestsSanitiser setupConnectionSubscriptions() setupRequestSubscriptions() @@ -52,8 +55,15 @@ final class SessionEngine { setupUpdateSubscriptions() setupExpirationSubscriptions() DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in - sessionRequestsProvider.emitRequestIfPending() + self?.sessionRequestsProvider.emitRequestIfPending() } + + removeInvalidSessionRequests() + } + + private func removeInvalidSessionRequests() { + let sessionTopics = Set(sessionStore.getAll().map {$0.topic}) + invalidRequestsSanitiser.removeInvalidSessionRequests(validSessionTopics: sessionTopics) } func hasSession(for topic: String) -> Bool { diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index 6a3b8a01b..ddb44c1ab 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -1,6 +1,10 @@ import Foundation -final class HistoryService { +protocol HistoryServiceProtocol { + func getPendingRequests() -> [(request: Request, context: VerifyContext?)] +} + +final class HistoryService: HistoryServiceProtocol { private let history: RPCHistory private let verifyContextStore: CodableStore @@ -25,6 +29,8 @@ final class HistoryService { getPendingRequestsSortedByTimestamp() } + + func getPendingRequestsSortedByTimestamp() -> [(request: Request, context: VerifyContext?)] { let requests = history.getPending() .compactMap { mapRequestRecord($0) } @@ -80,3 +86,13 @@ private extension HistoryService { return (mappedRequest, record.id, record.timestamp) } } + +#if DEBUG +class MockHistoryService: HistoryServiceProtocol { + var pendingRequests: [(request: Request, context: VerifyContext?)] = [] + + func getPendingRequests() -> [(request: Request, context: VerifyContext?)] { + return pendingRequests + } +} +#endif diff --git a/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift b/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift new file mode 100644 index 000000000..1ffc40dd7 --- /dev/null +++ b/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift @@ -0,0 +1,20 @@ + +import Foundation + +class InvalidRequestsSanitiser { + let historyService: HistoryServiceProtocol + private let history: RPCHistoryProtocol + + init(historyService: HistoryServiceProtocol, history: RPCHistoryProtocol) { + self.historyService = historyService + self.history = history + } + + func removeInvalidSessionRequests(validSessionTopics: Set) { + let pendingRequests = historyService.getPendingRequests() + let invalidTopics = Set(pendingRequests.map { $0.request.topic }).subtracting(validSessionTopics) + if !invalidTopics.isEmpty { + history.deleteAll(forTopics: Array(invalidTopics)) + } + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index bfbdcc6b9..33143fb43 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -61,7 +61,8 @@ public struct SignClientFactory { let historyService = HistoryService(history: rpcHistory, verifyContextStore: verifyContextStore) let verifyClient = VerifyClientFactory.create() let sessionRequestsProvider = SessionRequestsProvider(historyService: historyService) - let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: verifyClient, kms: kms, sessionStore: sessionStore, logger: logger, sessionRequestsProvider: sessionRequestsProvider) + let invalidRequestsSanitiser = InvalidRequestsSanitiser(historyService: historyService, history: rpcHistory) + let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: verifyClient, kms: kms, sessionStore: sessionStore, logger: logger, sessionRequestsProvider: sessionRequestsProvider, invalidRequestsSanitiser: invalidRequestsSanitiser) let nonControllerSessionStateMachine = NonControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let controllerSessionStateMachine = ControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let sessionExtendRequester = SessionExtendRequester(sessionStore: sessionStore, networkingInteractor: networkingClient) diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index ff6bda280..7060c89ae 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -1,6 +1,10 @@ import Foundation -public final class RPCHistory { +public protocol RPCHistoryProtocol { + func deleteAll(forTopics topics: [String]) +} + +public final class RPCHistory: RPCHistoryProtocol { public struct Record: Codable { public enum Origin: String, Codable { @@ -144,3 +148,13 @@ extension RPCHistory { } } } + +#if DEBUG +class MockRPCHistory: RPCHistoryProtocol { + var deletedTopics: [String] = [] + + func deleteAll(forTopics topics: [String]) { + deletedTopics.append(contentsOf: topics) + } +} +#endif diff --git a/Tests/WalletConnectSignTests/InvalidRequestsSanitiserTests.swift b/Tests/WalletConnectSignTests/InvalidRequestsSanitiserTests.swift new file mode 100644 index 000000000..dda89b064 --- /dev/null +++ b/Tests/WalletConnectSignTests/InvalidRequestsSanitiserTests.swift @@ -0,0 +1,69 @@ +import XCTest +@testable import WalletConnectSign +@testable import WalletConnectUtils + +class InvalidRequestsSanitiserTests: XCTestCase { + var sanitiser: InvalidRequestsSanitiser! + var mockHistoryService: MockHistoryService! + var mockRPCHistory: MockRPCHistory! + + override func setUp() { + super.setUp() + mockHistoryService = MockHistoryService() + mockRPCHistory = MockRPCHistory() + sanitiser = InvalidRequestsSanitiser(historyService: mockHistoryService, history: mockRPCHistory) + } + + override func tearDown() { + sanitiser = nil + mockHistoryService = nil + mockRPCHistory = nil + super.tearDown() + } + + func testRemoveInvalidSessionRequests_noPendingRequests() { + let validSessionTopics: Set = ["validTopic1", "validTopic2"] + + sanitiser.removeInvalidSessionRequests(validSessionTopics: validSessionTopics) + + XCTAssertTrue(mockRPCHistory.deletedTopics.isEmpty) + } + + func testRemoveInvalidSessionRequests_allRequestsValid() { + let validSessionTopics: Set = ["validTopic1", "validTopic2"] + mockHistoryService.pendingRequests = [ + (request: try! Request(topic: "validTopic1", method: "method1", params: AnyCodable("params1"), chainId: Blockchain("eip155:1")!), context: nil), + (request: try! Request(topic: "validTopic2", method: "method2", params: AnyCodable("params2"), chainId: Blockchain("eip155:1")!), context: nil) + ] + + sanitiser.removeInvalidSessionRequests(validSessionTopics: validSessionTopics) + + XCTAssertTrue(mockRPCHistory.deletedTopics.isEmpty) + } + + func testRemoveInvalidSessionRequests_someRequestsInvalid() { + let validSessionTopics: Set = ["validTopic1", "validTopic2"] + mockHistoryService.pendingRequests = [ + (request: try! Request(topic: "validTopic1", method: "method1", params: AnyCodable("params1"), chainId: Blockchain("eip155:1")!), context: nil), + (request: try! Request(topic: "invalidTopic1", method: "method2", params: AnyCodable("params2"), chainId: Blockchain("eip155:1")!), context: nil), + (request: try! Request(topic: "invalidTopic2", method: "method3", params: AnyCodable("params3"), chainId: Blockchain("eip155:1")!), context: nil) + ] + + sanitiser.removeInvalidSessionRequests(validSessionTopics: validSessionTopics) + + XCTAssertEqual(mockRPCHistory.deletedTopics.sorted(), ["invalidTopic1", "invalidTopic2"]) + } + + func testRemoveInvalidSessionRequests_withEmptyValidSessionTopics() { + let validSessionTopics: Set = [] + + mockHistoryService.pendingRequests = [ + (request: try! Request(topic: "invalidTopic1", method: "method1", params: AnyCodable("params1"), chainId: Blockchain("eip155:1")!), context: nil), + (request: try! Request(topic: "invalidTopic2", method: "method2", params: AnyCodable("params2"), chainId: Blockchain("eip155:1")!), context: nil) + ] + + sanitiser.removeInvalidSessionRequests(validSessionTopics: validSessionTopics) + + XCTAssertEqual(mockRPCHistory.deletedTopics.sorted(), ["invalidTopic1", "invalidTopic2"]) + } +} diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index e3a42232e..a6854c5bc 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -13,33 +13,29 @@ final class SessionEngineTests: XCTestCase { override func setUp() { networkingInteractor = NetworkingInteractorMock() sessionStorage = WCSessionStorageMock() + let defaults = RuntimeKeyValueStorage() + let rpcHistory = RPCHistory( + keyValueStore: .init( + defaults: defaults, + identifier: "" + ) + ) verifyContextStore = CodableStore(defaults: RuntimeKeyValueStorage(), identifier: "") + let historyService = HistoryService( + history: rpcHistory, + verifyContextStore: verifyContextStore + ) engine = SessionEngine( networkingInteractor: networkingInteractor, - historyService: HistoryService( - history: RPCHistory( - keyValueStore: .init( - defaults: RuntimeKeyValueStorage(), - identifier: "" - ) - ), - verifyContextStore: verifyContextStore - ), + historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: VerifyClientMock(), kms: KeyManagementServiceMock(), sessionStore: sessionStorage, logger: ConsoleLoggerMock(), sessionRequestsProvider: SessionRequestsProvider( - historyService: HistoryService( - history: RPCHistory( - keyValueStore: .init( - defaults: RuntimeKeyValueStorage(), - identifier: "" - ) - ), - verifyContextStore: verifyContextStore - )) + historyService: historyService), + invalidRequestsSanitiser: InvalidRequestsSanitiser(historyService: historyService, history: rpcHistory) ) } From e4812ac720924688baa6a9580e5c4190672a660f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 15 May 2024 14:26:12 +0300 Subject: [PATCH 573/814] Update Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift Co-authored-by: Jack Pooley <169029079+jackpooleywc@users.noreply.github.com> --- .../WalletConnectSign/Services/InvalidRequestsSanitiser.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift b/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift index 1ffc40dd7..f68800f0e 100644 --- a/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift +++ b/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift @@ -1,7 +1,7 @@ import Foundation -class InvalidRequestsSanitiser { +final class InvalidRequestsSanitiser { let historyService: HistoryServiceProtocol private let history: RPCHistoryProtocol From a07eb760d6618131fe5f6083e3bee569d643ecb7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 15 May 2024 14:26:23 +0300 Subject: [PATCH 574/814] Update Sources/WalletConnectSign/Engine/Common/SessionEngine.swift Co-authored-by: Jack Pooley <169029079+jackpooleywc@users.noreply.github.com> --- Sources/WalletConnectSign/Engine/Common/SessionEngine.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 5477f86a9..08cd1d0f6 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -62,7 +62,7 @@ final class SessionEngine { } private func removeInvalidSessionRequests() { - let sessionTopics = Set(sessionStore.getAll().map {$0.topic}) + let sessionTopics = Set(sessionStore.getAll().map(\.topic)) invalidRequestsSanitiser.removeInvalidSessionRequests(validSessionTopics: sessionTopics) } From bc231c8d9fb541c4ef1ec96c8832acef48ec39d7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 15 May 2024 14:29:09 +0300 Subject: [PATCH 575/814] update --- .../WalletConnectSign/Services/InvalidRequestsSanitiser.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift b/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift index f68800f0e..31793769b 100644 --- a/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift +++ b/Sources/WalletConnectSign/Services/InvalidRequestsSanitiser.swift @@ -2,7 +2,7 @@ import Foundation final class InvalidRequestsSanitiser { - let historyService: HistoryServiceProtocol + private let historyService: HistoryServiceProtocol private let history: RPCHistoryProtocol init(historyService: HistoryServiceProtocol, history: RPCHistoryProtocol) { From 787c8a96cf34cd920393d4f5d5008223fc810f75 Mon Sep 17 00:00:00 2001 From: Jack Pooley <169029079+jackpooleywc@users.noreply.github.com> Date: Thu, 16 May 2024 12:46:45 +0200 Subject: [PATCH 576/814] Remove pending requests on session expiration --- .../Engine/Common/SessionEngine.swift | 5 ++- .../Services/HistoryService.swift | 39 +++++++++++++--- .../Sign/SessionRequestsProvider.swift | 4 +- .../RPCHistory/RPCHistory.swift | 7 +++ .../SessionEngineTests.swift | 45 ++++++++++++++++++- 5 files changed, 89 insertions(+), 11 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 08cd1d0f6..48964f333 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -19,7 +19,7 @@ final class SessionEngine { private let sessionStore: WCSessionStorage private let networkingInteractor: NetworkInteracting - private let historyService: HistoryService + private let historyService: HistoryServiceProtocol private let verifyContextStore: CodableStore private let verifyClient: VerifyClientProtocol private let kms: KeyManagementServiceProtocol @@ -30,7 +30,7 @@ final class SessionEngine { init( networkingInteractor: NetworkInteracting, - historyService: HistoryService, + historyService: HistoryServiceProtocol, verifyContextStore: CodableStore, verifyClient: VerifyClientProtocol, kms: KeyManagementServiceProtocol, @@ -202,6 +202,7 @@ private extension SessionEngine { func setupExpirationSubscriptions() { sessionStore.onSessionExpiration = { [weak self] session in + self?.historyService.removePendingRequest(topic: session.topic) self?.kms.deletePrivateKey(for: session.selfParticipant.publicKey) self?.kms.deleteAgreementSecret(for: session.topic) } diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index ddb44c1ab..c3ac80a3a 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -1,7 +1,14 @@ import Foundation protocol HistoryServiceProtocol { + + func getSessionRequest(id: RPCID) -> (request: Request, context: VerifyContext?)? + + func removePendingRequest(topic: String) + func getPendingRequests() -> [(request: Request, context: VerifyContext?)] + + func getPendingRequestsSortedByTimestamp() -> [(request: Request, context: VerifyContext?)] } final class HistoryService: HistoryServiceProtocol { @@ -16,21 +23,25 @@ final class HistoryService: HistoryServiceProtocol { self.history = history self.verifyContextStore = verifyContextStore } - - public func getSessionRequest(id: RPCID) -> (request: Request, context: VerifyContext?)? { + + func getSessionRequest(id: RPCID) -> (request: Request, context: VerifyContext?)? { guard let record = history.get(recordId: id) else { return nil } guard let (request, recordId, _) = mapRequestRecord(record) else { return nil } return (request, try? verifyContextStore.get(key: recordId.string)) } + + func removePendingRequest(topic: String) { + DispatchQueue.global(qos: .background).async { [unowned self] in + history.deleteAll(forTopic: topic) + } + } func getPendingRequests() -> [(request: Request, context: VerifyContext?)] { getPendingRequestsSortedByTimestamp() } - - func getPendingRequestsSortedByTimestamp() -> [(request: Request, context: VerifyContext?)] { let requests = history.getPending() .compactMap { mapRequestRecord($0) } @@ -88,11 +99,27 @@ private extension HistoryService { } #if DEBUG -class MockHistoryService: HistoryServiceProtocol { +final class MockHistoryService: HistoryServiceProtocol { + + var removePendingRequestCalled: (String) -> Void = { _ in } + var pendingRequests: [(request: Request, context: VerifyContext?)] = [] + func removePendingRequest(topic: String) { + pendingRequests.removeAll(where: { $0.request.topic == topic }) + removePendingRequestCalled(topic) + } + + func getSessionRequest(id: JSONRPC.RPCID) -> (request: Request, context: VerifyContext?)? { + fatalError("Unimplemented") + } + func getPendingRequests() -> [(request: Request, context: VerifyContext?)] { - return pendingRequests + pendingRequests + } + + func getPendingRequestsSortedByTimestamp() -> [(request: Request, context: VerifyContext?)] { + fatalError("Unimplemented") } } #endif diff --git a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift index 89c8e9e79..3afa8290e 100644 --- a/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift +++ b/Sources/WalletConnectSign/Sign/SessionRequestsProvider.swift @@ -2,7 +2,7 @@ import Combine import Foundation class SessionRequestsProvider { - private let historyService: HistoryService + private let historyService: HistoryServiceProtocol private var sessionRequestPublisherSubject = PassthroughSubject<(request: Request, context: VerifyContext?), Never>() private var lastEmitTime: Date? private let debounceInterval: TimeInterval = 1 @@ -11,7 +11,7 @@ class SessionRequestsProvider { sessionRequestPublisherSubject.eraseToAnyPublisher() } - init(historyService: HistoryService) { + init(historyService: HistoryServiceProtocol) { self.historyService = historyService } diff --git a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift index 7060c89ae..cd3b6265c 100644 --- a/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift +++ b/Sources/WalletConnectUtils/RPCHistory/RPCHistory.swift @@ -1,6 +1,9 @@ import Foundation public protocol RPCHistoryProtocol { + + func deleteAll(forTopic topic: String) + func deleteAll(forTopics topics: [String]) } @@ -152,6 +155,10 @@ extension RPCHistory { #if DEBUG class MockRPCHistory: RPCHistoryProtocol { var deletedTopics: [String] = [] + + func deleteAll(forTopic topic: String) { + deletedTopics.append(topic) + } func deleteAll(forTopics topics: [String]) { deletedTopics.append(contentsOf: topics) diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index a6854c5bc..0f2828805 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -8,13 +8,14 @@ final class SessionEngineTests: XCTestCase { var networkingInteractor: NetworkingInteractorMock! var sessionStorage: WCSessionStorageMock! var verifyContextStore: CodableStore! + var rpcHistory: RPCHistory! var engine: SessionEngine! override func setUp() { networkingInteractor = NetworkingInteractorMock() sessionStorage = WCSessionStorageMock() let defaults = RuntimeKeyValueStorage() - let rpcHistory = RPCHistory( + rpcHistory = RPCHistory( keyValueStore: .init( defaults: defaults, identifier: "" @@ -62,4 +63,46 @@ final class SessionEngineTests: XCTestCase { wait(for: [expectation], timeout: 0.5) } + + func testRemovePendingRequestsOnSessionExpiration() { + let expectation = expectation( + description: "Remove pending requests on session expiration" + ) + + let historyService = MockHistoryService() + + engine = SessionEngine( + networkingInteractor: networkingInteractor, + historyService: historyService, + verifyContextStore: verifyContextStore, + verifyClient: VerifyClientMock(), + kms: KeyManagementServiceMock(), + sessionStore: sessionStorage, + logger: ConsoleLoggerMock(), + sessionRequestsProvider: SessionRequestsProvider( + historyService: historyService), + invalidRequestsSanitiser: InvalidRequestsSanitiser( + historyService: historyService, + history: rpcHistory + ) + ) + + let expectedTopic = "topic" + + let session = WCSession.stub( + topic: expectedTopic, + namespaces: SessionNamespace.stubDictionary() + ) + + sessionStorage.setSession(session) + + historyService.removePendingRequestCalled = { topic in + XCTAssertEqual(topic, expectedTopic) + expectation.fulfill() + } + + sessionStorage.onSessionExpiration!(session) + + wait(for: [expectation], timeout: 0.5) + } } From 5338c2615b14ba85b6520c9e9ea928ee532ba0de Mon Sep 17 00:00:00 2001 From: jackpooleywc Date: Fri, 17 May 2024 07:22:53 +0000 Subject: [PATCH 577/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 42dfeb72c..66c4ff16d 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.7"} +{"version": "1.18.8"} From 4384fe40dc9756afe4b829068605331b2bc5e99e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 17 May 2024 12:25:02 +0300 Subject: [PATCH 578/814] remove type3 an4 envelopes --- .../Serialiser/Envelope.swift | 39 +++++-------------- .../Serialiser/Serializer.swift | 18 ++++----- .../Serialiser/Serializing.swift | 18 ++++----- .../NetworkingInteractor.swift | 2 +- .../Wallet/NotifyDecryptionService.swift | 2 +- .../Auth/Link/LinkEnvelopesDispatcher.swift | 6 +-- .../SignDecryptionService.swift | 6 +-- 7 files changed, 36 insertions(+), 55 deletions(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index 8167242af..ad4554c4c 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -2,9 +2,9 @@ import Foundation /// A type representing envelope with it's serialization policy public struct Envelope: Equatable { - public enum CodingType { - case base64Encoded(String) - case base64UrlEncoded(String) + public enum CodingType: Equatable, Codable { + case base64Encoded + case base64UrlEncoded } public enum Errors: String, Error { case malformedEnvelope @@ -22,13 +22,13 @@ public struct Envelope: Equatable { /// sealbox: in case of envelope type 0, 1, 3 and 4: = iv + ct + tag, in case of type 2 - raw data representation of a json object /// type0: tp + sealbox /// type1: tp + pk + sealbox - init(_ codingType: CodingType) throws { + init(_ codingType: CodingType, envelopeString: String) throws { var envelopeData: Data! switch codingType { - case .base64Encoded(let encodedString): - envelopeData = Data(base64Encoded: encodedString) - case .base64UrlEncoded(let encodedString): - envelopeData = Data(base64url: encodedString) + case .base64Encoded: + envelopeData = Data(base64Encoded: envelopeString) + case .base64UrlEncoded: + envelopeData = Data(base64url: envelopeString) } guard let envelopeData = envelopeData else { throw Errors.malformedEnvelope } @@ -42,7 +42,7 @@ public struct Envelope: Equatable { } - init(type: EnvelopeType, sealbox: Data) { + init(type: EnvelopeType, sealbox: Data, codingType: CodingType) { self.type = type self.sealbox = sealbox } @@ -55,10 +55,6 @@ public struct Envelope: Equatable { return (type.representingByte.data + pubKey + sealbox).base64EncodedString() case .type2: return (type.representingByte.data + sealbox).base64urlEncodedString() - case .type3: - return (type.representingByte.data + sealbox).base64urlEncodedString() - case .type4(pubKey: let pubKey): - return (type.representingByte.data + pubKey + sealbox).base64urlEncodedString() } } @@ -66,16 +62,12 @@ public struct Envelope: Equatable { public extension Envelope { enum EnvelopeType: Equatable { - /// type 0 = tp + iv + ct + tag - base64encoded + /// type 0 = tp + iv + ct + tag case type0 /// type 1 = tp + pk + iv + ct + tag - base64encoded case type1(pubKey: Data) /// type 2 = tp + base64urlEncoded unencrypted string case type2 - /// type 0 = tp + iv + ct + tag - base64urlEncoded - case type3 - /// type 1 = tp + pk + iv + ct + tag - base64urlEncoded - case type4(pubKey: Data) var representingByte: UInt8 { switch self { @@ -85,10 +77,6 @@ public extension Envelope { return 1 case .type2: return 2 - case .type3: - return 3 - case .type4: - return 4 } } @@ -103,13 +91,6 @@ public extension Envelope { self = .type1(pubKey: key) case 2: self = .type2 - case 3: - self = .type3 - case 4: - guard let key = pubKey, key.count == 32 else { - throw Envelope.Errors.malformedEnvelope - } - self = .type4(pubKey: key) default: throw Envelope.Errors.unsupportedEnvelopeType } diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index c8b73e415..59303e204 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -52,9 +52,9 @@ public class Serializer: Serializing { /// - encodable: Object to encrypt and serialize /// - envelopeType: type of envelope /// - Returns: Serialized String - public func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String { + public func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType, codingType: Envelope.CodingType) throws -> String { if envelopeType == .type2 { - return try serializeEnvelopeType2(encodable: encodable) + return try serializeEnvelopeType2(encodable: encodable, codingType: codingType) } guard let topic = topic else { let error = Errors.topicNotFound @@ -68,7 +68,7 @@ public class Serializer: Serializing { throw error } let sealbox = try codec.encode(plaintext: messageJson, symmetricKey: symmetricKey) - return Envelope(type: envelopeType, sealbox: sealbox).serialised() + return Envelope(type: envelopeType, sealbox: sealbox, codingType: codingType).serialised() } /// Deserializes and decrypts an object @@ -76,13 +76,13 @@ public class Serializer: Serializing { /// - topic: Topic that is associated with a symetric key for decrypting particular codable object /// - encodedEnvelope: Envelope to deserialize and decrypt /// - Returns: Deserialized object - public func deserialize(topic: String, codingType: Envelope.CodingType) throws -> (T, derivedTopic: String?, decryptedPayload: Data) { - let envelope = try Envelope(codingType) + public func deserialize(topic: String, codingType: Envelope.CodingType, envelopeString: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) { + let envelope = try Envelope(codingType, envelopeString: envelopeString) switch envelope.type { - case .type0, .type3: + case .type0: let deserialisedType: (object: T, data: Data) = try handleType0Envelope(topic, envelope) return (deserialisedType.object, nil, deserialisedType.data) - case .type1(let peerPubKey), .type4(let peerPubKey): + case .type1(let peerPubKey): return try handleType1Envelope(topic, peerPubKey: peerPubKey, sealbox: envelope.sealbox) case .type2: let decodedType: T = try handleType2Envelope(envelope: envelope) @@ -109,9 +109,9 @@ public class Serializer: Serializing { } /// Serializes envelope type 2 - private func serializeEnvelopeType2(encodable: Encodable) throws -> String { + private func serializeEnvelopeType2(encodable: Encodable, codingType: Envelope.CodingType) throws -> String { let messageData = try JSONEncoder().encode(encodable) - let envelope = Envelope(type: .type2, sealbox: messageData) + let envelope = Envelope(type: .type2, sealbox: messageData, codingType: codingType) return envelope.serialised() } diff --git a/Sources/WalletConnectKMS/Serialiser/Serializing.swift b/Sources/WalletConnectKMS/Serialiser/Serializing.swift index ce622f51b..6fac46076 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializing.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializing.swift @@ -5,29 +5,29 @@ public protocol Serializing { var logsPublisher: AnyPublisher {get} var logger: ConsoleLogging {get} func setLogging(level: LoggingLevel) - func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType) throws -> String + func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType, codingType: Envelope.CodingType) throws -> String /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key - func deserialize(topic: String, codingType: Envelope.CodingType) throws -> (T, derivedTopic: String?, decryptedPayload: Data) + func deserialize(topic: String, codingType: Envelope.CodingType, envelopeString: String) throws -> (T, derivedTopic: String?, decryptedPayload: Data) } public extension Serializing { /// - derivedTopic: topic derived from symmetric key as a result of key exchange if peers has sent envelope(type1) prefixed with it's public key - func tryDeserialize(topic: String, codingType: Envelope.CodingType) -> (T, derivedTopic: String?, decryptedPayload: Data)? { - return try? deserialize(topic: topic, codingType: codingType) + func tryDeserialize(topic: String, codingType: Envelope.CodingType, envelopeString: String) -> (T, derivedTopic: String?, decryptedPayload: Data)? { + return try? deserialize(topic: topic, codingType: codingType, envelopeString: envelopeString) } - func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType = .type0) throws -> String { - try serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) + func serialize(topic: String?, encodable: Encodable, envelopeType: Envelope.EnvelopeType = .type0, codingType: Envelope.CodingType = .base64Encoded) throws -> String { + try serialize(topic: topic, encodable: encodable, envelopeType: envelopeType, codingType: codingType) } - func tryDeserializeRequestOrResponse(topic: String, codingType: Envelope.CodingType) -> Either<(request: RPCRequest, derivedTopic: String?, decryptedPayload: Data), (response: RPCResponse, derivedTopic: String?, decryptedPayload: Data)>? { + func tryDeserializeRequestOrResponse(topic: String, codingType: Envelope.CodingType, envelopeString: String) -> Either<(request: RPCRequest, derivedTopic: String?, decryptedPayload: Data), (response: RPCResponse, derivedTopic: String?, decryptedPayload: Data)>? { // Attempt to deserialize RPCRequest - if let result = try? deserialize(topic: topic, codingType: codingType) as (RPCRequest, derivedTopic: String?, decryptedPayload: Data) { + if let result = try? deserialize(topic: topic, codingType: codingType, envelopeString: envelopeString) as (RPCRequest, derivedTopic: String?, decryptedPayload: Data) { return .left(result) } // Attempt to deserialize RPCResponse - if let result = try? deserialize(topic: topic, codingType: codingType) as (RPCResponse, derivedTopic: String?, decryptedPayload: Data) { + if let result = try? deserialize(topic: topic, codingType: codingType, envelopeString: envelopeString) as (RPCResponse, derivedTopic: String?, decryptedPayload: Data) { return .right(result) } diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index 7ee808246..847606edd 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -242,7 +242,7 @@ public class NetworkingInteractor: NetworkInteracting { } private func manageSubscription(_ topic: String, _ encodedEnvelope: String, _ publishedAt: Date) { - if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(encodedEnvelope)) { + if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded, envelopeString: encodedEnvelope) { switch result { case .left(let result): handleRequest(topic: topic, request: result.request, decryptedPayload: result.decryptedPayload, publishedAt: publishedAt, derivedTopic: result.derivedTopic) diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift index 402f08060..2ae46882c 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyDecryptionService.swift @@ -28,7 +28,7 @@ public class NotifyDecryptionService { } public func decryptMessage(topic: String, ciphertext: String) throws -> (NotifyMessage, NotifySubscription, Account) { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded, envelopeString: ciphertext) guard let params = rpcRequest.params else { throw Errors.malformedNotifyMessage } let wrapper = try params.get(NotifyMessagePayload.Wrapper.self) let (messagePayload, _) = try NotifyMessagePayload.decodeAndVerify(from: wrapper) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 4f6aec53c..ed51a015c 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -49,7 +49,7 @@ class LinkEnvelopesDispatcher { guard let topic = components.queryItems?.first(where: { $0.name == "topic" })?.value else { throw Errors.topicNotFound } - manageSubscription(topic, wcEnvelope) + manageEnvelope(topic, wcEnvelope) } func request(topic: String, request: RPCRequest, peerUniversalLink: String, envelopeType: Envelope.EnvelopeType) async throws -> String { @@ -146,8 +146,8 @@ class LinkEnvelopesDispatcher { .eraseToAnyPublisher() } - private func manageSubscription(_ topic: String, _ encodedEnvelope: String) { - if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64UrlEncoded(encodedEnvelope)) { + private func manageEnvelope(_ topic: String, _ encodedEnvelope: String) { + if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64UrlEncoded, envelopeString: encodedEnvelope) { switch result { case .left(let result): handleRequest(topic: topic, request: result.request) diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index d22611b80..a0b8f649a 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -21,7 +21,7 @@ public class SignDecryptionService { } public func decryptProposal(topic: String, ciphertext: String) throws -> Session.Proposal { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded, envelopeString: ciphertext) if let proposal = try rpcRequest.params?.get(SessionType.ProposeParams.self) { return proposal.publicRepresentation(pairingTopic: topic) } else { @@ -30,7 +30,7 @@ public class SignDecryptionService { } public func decryptRequest(topic: String, ciphertext: String) throws -> Request { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded, envelopeString: ciphertext) if let request = try rpcRequest.params?.get(SessionType.RequestParams.self), let rpcId = rpcRequest.id{ let request = Request( @@ -49,7 +49,7 @@ public class SignDecryptionService { } public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthenticationRequest { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) + let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded, envelopeString: ciphertext) setPairingMetadata(rpcRequest: rpcRequest, topic: topic) if let params = try rpcRequest.params?.get(SessionAuthenticateRequestParams.self), let id = rpcRequest.id { From 7313b174fcf458e14112c5ddacc5258216f4d380 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 20 May 2024 13:05:00 +0200 Subject: [PATCH 579/814] savepoint --- .../Sign/SessionAccount/SessionAccountPresenter.swift | 6 +++--- .../ApplicationLayer/ConfigurationService.swift | 2 +- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 10 ++++++++-- .../Auth/Link/LinkEnvelopesDispatcher.swift | 4 ++-- 4 files changed, 14 insertions(+), 8 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 31920ce46..625e0c858 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -53,9 +53,9 @@ final class SessionAccountPresenter: ObservableObject { lastRequest = request ActivityIndicatorManager.shared.stop() requesting = true - DispatchQueue.main.async { [weak self] in - self?.openWallet() - } +// DispatchQueue.main.async { [weak self] in +// self?.openWallet() +// } } catch { ActivityIndicatorManager.shared.stop() requesting = false diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index ce77eeba5..d023873d5 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://www.lab.web3modal.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 4673b1134..3c04f761c 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -72,6 +72,8 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { guard let context = URLContexts.first else { return } + + let url = context.url do { let uri = try WalletConnectURI(urlContext: context) @@ -82,7 +84,11 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio if case WalletConnectURI.Errors.expired = error { AlertPresenter.present(message: error.localizedDescription, type: .error) } else { - print("Error initializing WalletConnectURI: \(error.localizedDescription)") + do { + try Sign.instance.dispatchEnvelope(url.absoluteString) + } catch { + print(error) + } } } } @@ -124,7 +130,7 @@ private extension SceneDelegate { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://www.lab.web3modal.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index ed51a015c..edf97f1d9 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -61,7 +61,7 @@ class LinkEnvelopesDispatcher { envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: request, envelopeType: envelopeType, topic: topic) DispatchQueue.main.async { - UIApplication.shared.open(envelopeUrl) + UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) } } catch { if let id = request.id { @@ -77,7 +77,7 @@ class LinkEnvelopesDispatcher { try rpcHistory.validate(response) let envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: response, envelopeType: envelopeType, topic: topic) DispatchQueue.main.async { - UIApplication.shared.open(envelopeUrl) + UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true) } try rpcHistory.resolve(response) From ca89dd2d859fd4417bcd8e08121985f42590bb85 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 20 May 2024 14:22:35 +0200 Subject: [PATCH 580/814] savepoint --- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 6 +++--- .../Auth/Link/LinkEnvelopesDispatcher.swift | 2 +- Sources/WalletConnectSign/Sign/SignClientProtocol.swift | 1 + Sources/Web3Wallet/Web3WalletClient.swift | 4 ++++ 4 files changed, 9 insertions(+), 4 deletions(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 3c04f761c..67ebba1ee 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -24,7 +24,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio } do { print("🔵🔵🔵🔵🔵🔵🔵\(url.absoluteString)") - try Sign.instance.dispatchEnvelope(url.absoluteString) + try Web3Wallet.instance.dispatchEnvelope(url.absoluteString) } catch { print("🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨") } @@ -60,7 +60,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio if let url = connectionOptions.userActivities.first?.webpageURL { configurators.configure() // Ensure configurators are set up before dispatching do { - try Sign.instance.dispatchEnvelope(url.absoluteString) + try Web3Wallet.instance.dispatchEnvelope(url.absoluteString) } catch { print("Error dispatching envelope: \(error.localizedDescription)") } @@ -85,7 +85,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio AlertPresenter.present(message: error.localizedDescription, type: .error) } else { do { - try Sign.instance.dispatchEnvelope(url.absoluteString) + try Web3Wallet.instance.dispatchEnvelope(url.absoluteString) } catch { print(error) } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index edf97f1d9..695e1d8c8 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -77,7 +77,7 @@ class LinkEnvelopesDispatcher { try rpcHistory.validate(response) let envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: response, envelopeType: envelopeType, topic: topic) DispatchQueue.main.async { - UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true) + UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) } try rpcHistory.resolve(response) diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 4cb030cd4..292579f16 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -33,6 +33,7 @@ public protocol SignClientProtocol { func getSessions() -> [Session] func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String func buildAuthPayload(payload: AuthPayload, supportedEVMChains: [Blockchain], supportedMethods: [String]) throws -> AuthPayload + func dispatchEnvelope(_ envelope: String) throws func cleanup() async throws func getPendingRequests(topic: String?) -> [(request: Request, context: VerifyContext?)] diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 5cc7b864f..1ca6727d2 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -244,6 +244,10 @@ public class Web3WalletClient { try signClient.buildAuthPayload(payload: payload, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) } + public func dispatchEnvelope(_ envelope: String) throws { + try signClient.dispatchEnvelope(envelope) + } + public func register(deviceToken: Data, enableEncrypted: Bool = false) async throws { try await pushClient.register(deviceToken: deviceToken, enableEncrypted: enableEncrypted) } From 3c2963e7bb8ca275aea6658706766a8b38d7067e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 22 May 2024 09:02:29 +0200 Subject: [PATCH 581/814] add integration tests, introduce linkMode in metadata --- .../Sign/SignClientTests.swift | 86 +++++++++++++++++-- .../Types/AppMetadata.swift | 14 ++- .../Auth/Link/LinkAuthRequester.swift | 17 ++-- .../Services/App/AuthResponseSubscriber.swift | 9 +- .../WalletConnectSign/Sign/SignClient.swift | 11 ++- .../Sign/SignClientFactory.swift | 6 +- .../SignStorageIdentifiers.swift | 1 + 7 files changed, 116 insertions(+), 28 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 2d4ed0a23..81311e332 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -14,12 +14,15 @@ final class SignClientTests: XCTestCase { var dappPairingClient: PairingClient! var wallet: SignClient! var walletPairingClient: PairingClient! + var dappKeyValueStorage: RuntimeKeyValueStorage! private var publishers = Set() let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") let eip1271Signature = "0xdeaddeaddead4095116db01baaf276361efd3a73c28cf8cc28dabefa945b8d536011289ac0a3b048600c1e692ff173ca944246cf7ceb319ac2262d27b395c82b1c" + let walletLinkModeUniversalLink = "https://test" - static private func makeClients(name: String) -> (PairingClient, SignClient) { + + static private func makeClients(name: String, linkModeUniversalLink: String? = nil) -> (PairingClient, SignClient, RuntimeKeyValueStorage) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() @@ -45,8 +48,10 @@ final class SignClientTests: XCTestCase { keychainStorage: keychain, networkingClient: networkingClient ) + let metadata = AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: UUID().uuidString, linkMode: linkModeUniversalLink)) + let client = SignClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: UUID().uuidString)), + metadata: metadata, logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychain, @@ -60,12 +65,12 @@ final class SignClientTests: XCTestCase { let clientId = try! networkingClient.getClientId() logger.debug("My client id is: \(clientId)") - return (pairingClient, client) + return (pairingClient, client, keyValueStorage) } override func setUp() async throws { - (dappPairingClient, dapp) = Self.makeClients(name: "🍏Dapp") - (walletPairingClient, wallet) = Self.makeClients(name: "🍎Wallet") + (dappPairingClient, dapp, dappKeyValueStorage) = Self.makeClients(name: "🍏Dapp") + (walletPairingClient, wallet, _) = Self.makeClients(name: "🍎Wallet", linkModeUniversalLink: walletLinkModeUniversalLink) } override func tearDown() { @@ -1160,6 +1165,11 @@ final class SignClientTests: XCTestCase { func testLinkAuthRequest() async throws { let responseExpectation = expectation(description: "successful response delivered") + // Set Wallet's universal link in dapp storage to mock wallet proof on link mode support + let walletUniversalLink = "https://test" + let dappLinkModeLinksStore = CodableStore(defaults: dappKeyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) + dappLinkModeLinksStore.set(true, forKey: walletUniversalLink) + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { let signerFactory = DefaultSignerFactory() @@ -1188,7 +1198,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: "") + let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: walletUniversalLink) try wallet.dispatchEnvelope(requestEnvelope) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -1203,6 +1213,11 @@ final class SignClientTests: XCTestCase { let semaphore = DispatchSemaphore(value: 0) + // Set Wallet's universal link in dapp storage to mock wallet proof on link mode support + let walletUniversalLink = "https://test" + let dappLinkModeLinksStore = CodableStore(defaults: dappKeyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) + dappLinkModeLinksStore.set(true, forKey: walletUniversalLink) + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in semaphore.wait() Task(priority: .high) { @@ -1264,9 +1279,66 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) semaphore.signal() - let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: "") + let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: walletUniversalLink) try wallet.dispatchEnvelope(requestEnvelope) await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } + + func testLinkModeFailsWhenDappDoesNotHaveProofThatWalletSupportsLinkMode() async throws { + // ensure link mode fails before the upgrade + do { + try await self.dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: self.walletLinkModeUniversalLink) + XCTFail("Expected error but got success.") + } catch { + if let authError = error as? LinkAuthRequester.Errors, authError == .walletLinkSupportNotProven { + } else { + XCTFail("Unexpected error: \(error)") + } + } + } + + + func testUpgradeFromRelayToLinkMode() async throws { + let linkModeUpgradeExpectation = expectation(description: "successful upgraded to link mode") + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create() + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) + + let signature = try signer.sign( + message: siweMessage, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) + + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { (_, result) in + guard case .success = result else { XCTFail(); return } + + + Task { [unowned self] in + try! await self.dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: self.walletLinkModeUniversalLink) + linkModeUpgradeExpectation.fulfill() + } + } + .store(in: &publishers) + + + let uri = try await dapp.authenticate(AuthRequestParams.stub(), walletUniversalLink: walletLinkModeUniversalLink) + try await walletPairingClient.pair(uri: uri) + await fulfillment(of: [linkModeUpgradeExpectation], timeout: InputConfig.defaultTimeout) + } + + func testUpgradeSessionToLinkModeAndSendRequestOverLinkMode() async throws { + + } } diff --git a/Sources/WalletConnectPairing/Types/AppMetadata.swift b/Sources/WalletConnectPairing/Types/AppMetadata.swift index 0ab317f12..71efccc85 100644 --- a/Sources/WalletConnectPairing/Types/AppMetadata.swift +++ b/Sources/WalletConnectPairing/Types/AppMetadata.swift @@ -12,22 +12,28 @@ import Foundation public struct AppMetadata: Codable, Equatable { public struct Redirect: Codable, Equatable { + enum Errors: Error { + case invalidLinkModeUniversalLink + } /// Native deeplink URL string. public let native: String? /// Universal link URL string. public let universal: String? + public let linkMode: String? + /** Creates a new Redirect object with the specified information. - parameters: - - native: Native deeplink URL string. - - universal: Universal link URL string. + - native: Native deeplink URL string. + - universal: Universal link URL string. */ - public init(native: String, universal: String?) { + public init(native: String, universal: String?, linkMode: String? = nil) { self.native = native self.universal = universal + self.linkMode = linkMode } } @@ -79,7 +85,7 @@ public extension AppMetadata { description: "A protocol to connect blockchain wallets to dapps.", url: "https://walletconnect.com/", icons: [], - redirect: AppMetadata.Redirect(native: "", universal: nil) + redirect: try! AppMetadata.Redirect(native: "", universal: nil, linkMode: nil) ) } } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 8c4ad229b..d7dc9358f 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -2,8 +2,9 @@ import Foundation actor LinkAuthRequester { - enum Errors: Error { + public enum Errors: Error { case invalidChain + case walletLinkSupportNotProven } private let appMetadata: AppMetadata private let kms: KeyManagementService @@ -11,23 +12,28 @@ actor LinkAuthRequester { private let iatProvader: IATProvider private let authResponseTopicRecordsStore: CodableStore private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let linkModeLinksStore: CodableStore init(kms: KeyManagementService, appMetadata: AppMetadata, logger: ConsoleLogging, iatProvader: IATProvider, authResponseTopicRecordsStore: CodableStore, - linkEnvelopesDispatcher: LinkEnvelopesDispatcher) { + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + linkModeLinksStore: CodableStore) { self.kms = kms self.appMetadata = appMetadata self.logger = logger self.iatProvader = iatProvader self.authResponseTopicRecordsStore = authResponseTopicRecordsStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.linkModeLinksStore = linkModeLinksStore } func request(params: AuthRequestParams, walletUniversalLink: String) async throws -> String { + guard try linkModeLinksStore.get(key: walletUniversalLink) != nil else { throw Errors.walletLinkSupportNotProven } + var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() @@ -53,12 +59,7 @@ actor LinkAuthRequester { let request = RPCRequest(method: protocolMethod.method, params: sessionAuthenticateRequestParams) try kms.setPublicKey(publicKey: pubKey, for: responseTopic) - - - - logger.debug("LinkAuthRequester: sending request") - - + logger.debug("LinkAuthRequester: sending request") return try await linkEnvelopesDispatcher.request(topic: UUID().uuidString,request: request, peerUniversalLink: walletUniversalLink, envelopeType: .type2) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 6a422df14..577e835d0 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -18,6 +18,7 @@ class AuthResponseSubscriber { authResponsePublisherSubject.eraseToAnyPublisher() } private let authResponseTopicRecordsStore: CodableStore + private let linkModeLinksStore: CodableStore init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -29,7 +30,8 @@ class AuthResponseSubscriber { messageFormatter: SIWEFromCacaoFormatting, sessionNamespaceBuilder: SessionNamespaceBuilder, authResponseTopicRecordsStore: CodableStore, - linkEnvelopesDispatcher: LinkEnvelopesDispatcher) { + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + linkModeLinksStore: CodableStore) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -41,6 +43,7 @@ class AuthResponseSubscriber { self.sessionNamespaceBuilder = sessionNamespaceBuilder self.authResponseTopicRecordsStore = authResponseTopicRecordsStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.linkModeLinksStore = linkModeLinksStore subscribeForResponse() subscribeForLinkResonse() } @@ -55,6 +58,10 @@ class AuthResponseSubscriber { networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + if let linkModeLink = payload.response.responder.metadata.redirect?.linkMode { + linkModeLinksStore.set(true, forKey: linkModeLink) + } + let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) removeResponseTopicRecord(responseTopic: payload.topic) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 51362e951..e57901683 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -10,7 +10,6 @@ public final class SignClient: SignClientProtocol { enum Errors: Error { case sessionForTopicNotFound - case linkModeUnsupported } // MARK: - Public Properties @@ -186,7 +185,7 @@ public final class SignClient: SignClientProtocol { // Link Mode - private let linkAuthRequester: LinkAuthRequester? + private let linkAuthRequester: LinkAuthRequester private let linkAuthRequestSubscriber: LinkAuthRequestSubscriber private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let sessionRequestDispatcher: SessionRequestDispatcher @@ -341,8 +340,11 @@ public final class SignClient: SignClientProtocol { /// For a dApp to propose an authenticated session to a wallet. public func authenticate( - _ params: AuthRequestParams + _ params: AuthRequestParams, + walletUniversalLink: String? = nil ) async throws -> WalletConnectURI { + + let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: pairingURI.topic) @@ -363,9 +365,6 @@ public final class SignClient: SignClientProtocol { _ params: AuthRequestParams, walletUniversalLink: String ) async throws -> String { - guard let linkAuthRequester = linkAuthRequester else { - throw Errors.linkModeUnsupported - } return try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 3bda8436d..5396c4316 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -108,7 +108,9 @@ public struct SignClientFactory { let linkEnvelopesDispatcher = LinkEnvelopesDispatcher(serializer: serializer, logger: logger, rpcHistory: rpcHistory) - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) + let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) + + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) @@ -118,7 +120,7 @@ public struct SignClientFactory { let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) - let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher) + let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher) let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) diff --git a/Sources/WalletConnectSign/SignStorageIdentifiers.swift b/Sources/WalletConnectSign/SignStorageIdentifiers.swift index 86c6b5c9a..d49f7065b 100644 --- a/Sources/WalletConnectSign/SignStorageIdentifiers.swift +++ b/Sources/WalletConnectSign/SignStorageIdentifiers.swift @@ -6,4 +6,5 @@ enum SignStorageIdentifiers: String { case proposals = "com.walletconnect.sdk.sessionProposals" case sessionTopicToProposal = "com.walletconnect.sdk.sessionTopicToProposal" case authResponseTopicRecord = "com.walletconnect.sdk.authResponseTopicRecord" + case linkModeLinks = "com.walletconnect.sdk.linkModeLinks" } From 81ac80c4d633f9d9482bbc515bf3fe340685e24f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 22 May 2024 12:11:37 +0200 Subject: [PATCH 582/814] add AuthenticateTransportTypeSwitcher --- .../Sign/SignClientTests.swift | 3 +- .../Services/App/AuthResponseSubscriber.swift | 29 ++++++-- .../AuthenticateTransportTypeSwitcher.swift | 69 +++++++++++++++++++ .../WalletConnectSign/Sign/SignClient.swift | 8 ++- 4 files changed, 101 insertions(+), 8 deletions(-) create mode 100644 Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 81311e332..62cf7c7f8 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1339,6 +1339,7 @@ final class SignClientTests: XCTestCase { } func testUpgradeSessionToLinkModeAndSendRequestOverLinkMode() async throws { - + fatalError() + add walidation for linkmode property in metadata } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 577e835d0..8c763033f 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -19,6 +19,7 @@ class AuthResponseSubscriber { } private let authResponseTopicRecordsStore: CodableStore private let linkModeLinksStore: CodableStore + private let linkModeTransportTypeUpgradeStore: CodableStore init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -31,7 +32,8 @@ class AuthResponseSubscriber { sessionNamespaceBuilder: SessionNamespaceBuilder, authResponseTopicRecordsStore: CodableStore, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, - linkModeLinksStore: CodableStore) { + linkModeLinksStore: CodableStore, + linkModeTransportTypeUpgradeStore: CodableStore) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -44,6 +46,7 @@ class AuthResponseSubscriber { self.authResponseTopicRecordsStore = authResponseTopicRecordsStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.linkModeLinksStore = linkModeLinksStore + self.linkModeTransportTypeUpgradeStore = linkModeTransportTypeUpgradeStore subscribeForResponse() subscribeForLinkResonse() } @@ -51,6 +54,7 @@ class AuthResponseSubscriber { private func subscribeForResponse() { networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + linkModeTransportTypeUpgradeStore.delete(forKey: payload.id.string) guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) @@ -58,10 +62,10 @@ class AuthResponseSubscriber { networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - if let linkModeLink = payload.response.responder.metadata.redirect?.linkMode { - linkModeLinksStore.set(true, forKey: linkModeLink) - } - + let transportType = getTransportTypeUpgradeIfPossible(metadata: payload.response.responder.metadata, requestId: payload.id) + + linkModeTransportTypeUpgradeStore.delete(forKey: payload.id.string) + let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) removeResponseTopicRecord(responseTopic: payload.topic) @@ -76,7 +80,7 @@ class AuthResponseSubscriber { authResponsePublisherSubject.send((requestId, .failure(error as! AuthError))) return } - let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, transportType: .relay) + let session = try createSession(from: payload.response, selfParticipant: payload.request.requester, pairingTopic: pairingTopic, transportType: transportType) authResponsePublisherSubject.send((requestId, .success((session, cacaos)))) } @@ -137,6 +141,19 @@ class AuthResponseSubscriber { } } + private func getTransportTypeUpgradeIfPossible(metadata: AppMetadata, requestId: RPCID) -> WCSession.TransportType { +// upgrade to link mode only if dapp requested universallink because dapp may not be prepared for handling a response - add this to doc] + // remove record + + if let linkModeLink = metadata.redirect?.linkMode, + let _ = try? linkModeTransportTypeUpgradeStore.get(key: requestId.string) { + linkModeLinksStore.set(true, forKey: linkModeLink) + return .linkMode + } else { + return .relay + } + } + private func createSession( from response: SessionAuthenticateResponseParams, selfParticipant: Participant, diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift new file mode 100644 index 000000000..d9b85208f --- /dev/null +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift @@ -0,0 +1,69 @@ +import Foundation + +class AuthenticateTransportTypeSwitcher { + public enum Errors: Error { + case badUniversalLink + } + + private let linkModeTransportTypeUpgradeStore: CodableStore + private let linkAuthRequester: LinkAuthRequester + private let pairingClient: PairingClient + private let logger: ConsoleLogging + private let appRequestService: SessionAuthRequestService + private let appProposeService: AppProposeService + + init(linkModeTransportTypeUpgradeStore: CodableStore, + linkAuthRequester: LinkAuthRequester, + pairingClient: PairingClient, + logger: ConsoleLogging, + appRequestService: SessionAuthRequestService, + appProposeService: AppProposeService) { + self.linkModeTransportTypeUpgradeStore = linkModeTransportTypeUpgradeStore + self.linkAuthRequester = linkAuthRequester + self.pairingClient = pairingClient + self.logger = logger + self.appRequestService = appRequestService + self.appProposeService = appProposeService + } + + func authenticate( + _ params: AuthRequestParams, + walletUniversalLink: String? = nil + ) async throws -> WalletConnectURI? { + + if let walletUniversalLink = walletUniversalLink, + !walletUniversalLink.starts(with: "https://") { + throw Errors.badUniversalLink + } + + do { + if let walletUniversalLink = walletUniversalLink { + let _ = try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) + return nil + } + } catch { + guard case LinkAuthRequester.Errors.walletLinkSupportNotProven = error else { + throw error + } + // Continue with relay if the error is walletLinkSupportNotProven + } + + if let walletUniversalLink = walletUniversalLink { + linkModeTransportTypeUpgradeStore.set(true, forKey: walletUniversalLink) + } + + let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) + logger.debug("Requesting Authentication on existing pairing") + try await appRequestService.request(params: params, topic: pairingURI.topic) + + let namespaces = try ProposalNamespaceBuilder.buildNamespace(from: params) + try await appProposeService.propose( + pairingTopic: pairingURI.topic, + namespaces: [:], + optionalNamespaces: namespaces, + sessionProperties: nil, + relay: RelayProtocolOptions(protocol: "irn", data: nil) + ) + return pairingURI + } +} diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index e57901683..a25af5353 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -342,8 +342,13 @@ public final class SignClient: SignClientProtocol { public func authenticate( _ params: AuthRequestParams, walletUniversalLink: String? = nil - ) async throws -> WalletConnectURI { + ) async throws -> WalletConnectURI? { + + return authenticateTransportTypeSwitcher.authenticate(params, walletUniversalLink) + if walletUniversalLink != nil && walletLinkSupportNotProven { + linkModeTransportTypeUpgradeStore che + } let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) logger.debug("Requesting Authentication on existing pairing") @@ -360,6 +365,7 @@ public final class SignClient: SignClientProtocol { return pairingURI } + // Link mode @discardableResult public func authenticateLinkMode( _ params: AuthRequestParams, From 45a66bd09ebddda488e51862dcedc21b251d6730 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 22 May 2024 15:04:13 +0200 Subject: [PATCH 583/814] fix build --- .../Types/AppMetadata.swift | 2 +- .../WalletConnectSign/Sign/SignClient.swift | 28 ++++--------------- .../Sign/SignClientFactory.swift | 9 ++++-- .../SignStorageIdentifiers.swift | 1 + 4 files changed, 15 insertions(+), 25 deletions(-) diff --git a/Sources/WalletConnectPairing/Types/AppMetadata.swift b/Sources/WalletConnectPairing/Types/AppMetadata.swift index 71efccc85..25ada49cb 100644 --- a/Sources/WalletConnectPairing/Types/AppMetadata.swift +++ b/Sources/WalletConnectPairing/Types/AppMetadata.swift @@ -85,7 +85,7 @@ public extension AppMetadata { description: "A protocol to connect blockchain wallets to dapps.", url: "https://walletconnect.com/", icons: [], - redirect: try! AppMetadata.Redirect(native: "", universal: nil, linkMode: nil) + redirect: AppMetadata.Redirect(native: "", universal: nil, linkMode: nil) ) } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index a25af5353..02ee023f4 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -182,6 +182,7 @@ public final class SignClient: SignClientProtocol { private let sessionsPublisherSubject = PassthroughSubject<[Session], Never>() private var authRequestPublisherSubject = PassthroughSubject<(request: AuthenticationRequest, context: VerifyContext?), Never>() private let authRequestSubscribersTracking: AuthRequestSubscribersTracking + private let authenticateTransportTypeSwitcher: AuthenticateTransportTypeSwitcher // Link Mode @@ -229,7 +230,8 @@ public final class SignClient: SignClientProtocol { sessionRequestDispatcher: SessionRequestDispatcher, linkSessionRequestSubscriber: LinkSessionRequestSubscriber, sessionResponderDispatcher: SessionResponderDispatcher, - linkSessionRequestResponseSubscriber: LinkSessionRequestResponseSubscriber + linkSessionRequestResponseSubscriber: LinkSessionRequestResponseSubscriber, + authenticateTransportTypeSwitcher: AuthenticateTransportTypeSwitcher ) { self.logger = logger self.networkingClient = networkingClient @@ -264,7 +266,8 @@ public final class SignClient: SignClientProtocol { self.linkSessionRequestSubscriber = linkSessionRequestSubscriber self.sessionResponderDispatcher = sessionResponderDispatcher self.linkSessionRequestResponseSubscriber = linkSessionRequestResponseSubscriber - + self.authenticateTransportTypeSwitcher = authenticateTransportTypeSwitcher + setUpConnectionObserving() setUpEnginesCallbacks() } @@ -343,26 +346,7 @@ public final class SignClient: SignClientProtocol { _ params: AuthRequestParams, walletUniversalLink: String? = nil ) async throws -> WalletConnectURI? { - - return authenticateTransportTypeSwitcher.authenticate(params, walletUniversalLink) - - if walletUniversalLink != nil && walletLinkSupportNotProven { - linkModeTransportTypeUpgradeStore che - } - - let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) - logger.debug("Requesting Authentication on existing pairing") - try await appRequestService.request(params: params, topic: pairingURI.topic) - - let namespaces = try ProposalNamespaceBuilder.buildNamespace(from: params) - try await appProposeService.propose( - pairingTopic: pairingURI.topic, - namespaces: [:], - optionalNamespaces: namespaces, - sessionProperties: nil, - relay: RelayProtocolOptions(protocol: "irn", data: nil) - ) - return pairingURI + return try await authenticateTransportTypeSwitcher.authenticate(params, walletUniversalLink: walletUniversalLink) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 5396c4316..c70338945 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -110,7 +110,9 @@ public struct SignClientFactory { let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) + let linkModeTransportTypeUpgradeStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeTransportTypeUpgradeStore.rawValue) + + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, linkModeTransportTypeUpgradeStore: linkModeTransportTypeUpgradeStore) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) @@ -140,6 +142,8 @@ public struct SignClientFactory { let sessionResponderDispatcher = SessionResponderDispatcher(relaySessionResponder: relaySessionResponder, linkSessionResponder: linkSessionResponder, logger: logger, sessionStore: sessionStore) let linkSessionRequestResponseSubscriber = LinkSessionRequestResponseSubscriber(envelopesDispatcher: linkEnvelopesDispatcher) + let authenticateTransportTypeSwitcher = AuthenticateTransportTypeSwitcher(linkModeTransportTypeUpgradeStore: linkModeTransportTypeUpgradeStore, linkAuthRequester: linkAuthRequester, pairingClient: pairingClient, logger: logger, appRequestService: appRequestService, appProposeService: appProposerService) + let client = SignClient( logger: logger, networkingClient: networkingClient, @@ -173,7 +177,8 @@ public struct SignClientFactory { sessionRequestDispatcher: sessionRequestDispatcher, linkSessionRequestSubscriber: linkSessionRequestSubscriber, sessionResponderDispatcher: sessionResponderDispatcher, - linkSessionRequestResponseSubscriber: linkSessionRequestResponseSubscriber + linkSessionRequestResponseSubscriber: linkSessionRequestResponseSubscriber, + authenticateTransportTypeSwitcher: authenticateTransportTypeSwitcher ) return client } diff --git a/Sources/WalletConnectSign/SignStorageIdentifiers.swift b/Sources/WalletConnectSign/SignStorageIdentifiers.swift index d49f7065b..7537bde16 100644 --- a/Sources/WalletConnectSign/SignStorageIdentifiers.swift +++ b/Sources/WalletConnectSign/SignStorageIdentifiers.swift @@ -7,4 +7,5 @@ enum SignStorageIdentifiers: String { case sessionTopicToProposal = "com.walletconnect.sdk.sessionTopicToProposal" case authResponseTopicRecord = "com.walletconnect.sdk.authResponseTopicRecord" case linkModeLinks = "com.walletconnect.sdk.linkModeLinks" + case linkModeTransportTypeUpgradeStore = "com.walletconnect.sdk.linkModeTransportTypeUpgradeStore" } From 780cb2c3ab521016a769fbb117600b375a01d82b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 22 May 2024 15:31:55 +0200 Subject: [PATCH 584/814] use linkMode property for link mode --- .../Link/LinkSessionAuthenticateResponder.swift | 2 +- .../Auth/Link/LinkSessionRequestSubscriber.swift | 2 +- .../Services/App/AuthResponseSubscriber.swift | 11 ++++------- .../App/AuthenticateTransportTypeSwitcher.swift | 9 +-------- Sources/WalletConnectSign/Auth/SignConfig.swift | 1 + .../SessionRequestDispatcher.swift | 2 +- .../SessionResponderDispatcher.swift | 2 +- .../WalletErrorResponder.swift | 2 +- Sources/WalletConnectSign/Sign/Sign.swift | 8 ++++---- .../Sign/SignClientFactory.swift | 15 ++++++++------- .../SignStorageIdentifiers.swift | 1 - 11 files changed, 23 insertions(+), 32 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index e6116d4ef..6fb240dd7 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -35,7 +35,7 @@ actor LinkSessionAuthenticateResponder { let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) let peerParticipant = sessionAuthenticateRequestParams.requester - guard let peerUniversalLink = peerParticipant.metadata.redirect?.universal else { + guard let peerUniversalLink = peerParticipant.metadata.redirect?.linkMode else { throw Errors.missingPeerUniversalLink } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift index 3a235d35d..8730268cd 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift @@ -50,7 +50,7 @@ class LinkSessionRequestSubscriber { logger.debug("Session for topic not found") return } - guard let peerUniversalLink = session.peerParticipant.metadata.redirect?.universal else { + guard let peerUniversalLink = session.peerParticipant.metadata.redirect?.linkMode else { logger.debug("Peer universal link not found") return } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 8c763033f..4ca753333 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -19,7 +19,7 @@ class AuthResponseSubscriber { } private let authResponseTopicRecordsStore: CodableStore private let linkModeLinksStore: CodableStore - private let linkModeTransportTypeUpgradeStore: CodableStore + private let supportLinkMode: Bool init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -33,7 +33,7 @@ class AuthResponseSubscriber { authResponseTopicRecordsStore: CodableStore, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, linkModeLinksStore: CodableStore, - linkModeTransportTypeUpgradeStore: CodableStore) { + supportLinkMode: Bool) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -46,7 +46,7 @@ class AuthResponseSubscriber { self.authResponseTopicRecordsStore = authResponseTopicRecordsStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.linkModeLinksStore = linkModeLinksStore - self.linkModeTransportTypeUpgradeStore = linkModeTransportTypeUpgradeStore + self.supportLinkMode = supportLinkMode subscribeForResponse() subscribeForLinkResonse() } @@ -54,7 +54,6 @@ class AuthResponseSubscriber { private func subscribeForResponse() { networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in - linkModeTransportTypeUpgradeStore.delete(forKey: payload.id.string) guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) @@ -64,8 +63,6 @@ class AuthResponseSubscriber { let transportType = getTransportTypeUpgradeIfPossible(metadata: payload.response.responder.metadata, requestId: payload.id) - linkModeTransportTypeUpgradeStore.delete(forKey: payload.id.string) - let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) removeResponseTopicRecord(responseTopic: payload.topic) @@ -146,7 +143,7 @@ class AuthResponseSubscriber { // remove record if let linkModeLink = metadata.redirect?.linkMode, - let _ = try? linkModeTransportTypeUpgradeStore.get(key: requestId.string) { + supportLinkMode { linkModeLinksStore.set(true, forKey: linkModeLink) return .linkMode } else { diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift index d9b85208f..30223401b 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift @@ -5,20 +5,17 @@ class AuthenticateTransportTypeSwitcher { case badUniversalLink } - private let linkModeTransportTypeUpgradeStore: CodableStore private let linkAuthRequester: LinkAuthRequester private let pairingClient: PairingClient private let logger: ConsoleLogging private let appRequestService: SessionAuthRequestService private let appProposeService: AppProposeService - init(linkModeTransportTypeUpgradeStore: CodableStore, - linkAuthRequester: LinkAuthRequester, + init(linkAuthRequester: LinkAuthRequester, pairingClient: PairingClient, logger: ConsoleLogging, appRequestService: SessionAuthRequestService, appProposeService: AppProposeService) { - self.linkModeTransportTypeUpgradeStore = linkModeTransportTypeUpgradeStore self.linkAuthRequester = linkAuthRequester self.pairingClient = pairingClient self.logger = logger @@ -48,10 +45,6 @@ class AuthenticateTransportTypeSwitcher { // Continue with relay if the error is walletLinkSupportNotProven } - if let walletUniversalLink = walletUniversalLink { - linkModeTransportTypeUpgradeStore.set(true, forKey: walletUniversalLink) - } - let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: pairingURI.topic) diff --git a/Sources/WalletConnectSign/Auth/SignConfig.swift b/Sources/WalletConnectSign/Auth/SignConfig.swift index 7419f0f9b..367c48175 100644 --- a/Sources/WalletConnectSign/Auth/SignConfig.swift +++ b/Sources/WalletConnectSign/Auth/SignConfig.swift @@ -3,5 +3,6 @@ import Foundation extension Sign { struct Config { let crypto: CryptoProvider + let supportLinkMode: Bool } } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift index 4822e8704..ff33fbf63 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -98,7 +98,7 @@ class LinkSessionRequester { throw WalletConnectError.invalidPermissions } // it's safe to force unwrap because redirect was used during session creation before - let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! + let peerUniversalLink = session.peerParticipant.metadata.redirect!.linkMode! let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) let ttl = try request.calculateTtl() diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift index 0ad256caa..f50a2d292 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift @@ -124,7 +124,7 @@ class LinkSessionResponder { throw WalletConnectError.noSessionMatchingTopic(topic) } - let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! + let peerUniversalLink = session.peerParticipant.metadata.redirect!.linkMode! guard sessionRequestNotExpired(requestId: requestId) else { try await linkEnvelopesDispatcher.respondError( diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index d23f6e940..ec77c0386 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -53,7 +53,7 @@ actor WalletErrorResponder { private func respondErrorLinkMode(_ error: AuthError, requestId: RPCID, topic: String, type1EnvelopeKey: Data) async throws -> String { let (sessionAuthenticateRequestParams, _) = try getsessionAuthenticateRequestParams(requestId: requestId) - guard let peerUniversalLink = sessionAuthenticateRequestParams.requester.metadata.redirect?.universal else { + guard let peerUniversalLink = sessionAuthenticateRequestParams.requester.metadata.redirect?.linkMode else { throw Errors.peerUniversalLinkNotFound } diff --git a/Sources/WalletConnectSign/Sign/Sign.swift b/Sources/WalletConnectSign/Sign/Sign.swift index 32e4edc29..2ce580204 100644 --- a/Sources/WalletConnectSign/Sign/Sign.swift +++ b/Sources/WalletConnectSign/Sign/Sign.swift @@ -29,8 +29,8 @@ public class Sign { projectId: Networking.projectId, crypto: config.crypto, networkingClient: Networking.interactor, - groupIdentifier: Networking.groupIdentifier - + groupIdentifier: Networking.groupIdentifier, + supportLinkMode: config.supportLinkMode ) }() @@ -41,8 +41,8 @@ public class Sign { /// Sign instance config method /// - Parameters: /// - metadata: App metadata - static public func configure(crypto: CryptoProvider) { - Sign.config = Sign.Config(crypto: crypto) + static public func configure(crypto: CryptoProvider, supportLinkMode: Bool = false) { + Sign.config = Sign.Config(crypto: crypto, supportLinkMode: supportLinkMode) } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index c70338945..e66101df0 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -17,7 +17,8 @@ public struct SignClientFactory { projectId: String, crypto: CryptoProvider, networkingClient: NetworkingInteractor, - groupIdentifier: String + groupIdentifier: String, + supportLinkMode: Bool ) -> SignClient { let logger = ConsoleLogger(prefix: "📝", loggingLevel: .off) @@ -37,7 +38,8 @@ public struct SignClientFactory { networkingClient: networkingClient, iatProvider: iatProvider, projectId: projectId, - crypto: crypto + crypto: crypto, + supportLinkMode: supportLinkMode ) } @@ -50,7 +52,8 @@ public struct SignClientFactory { networkingClient: NetworkingInteractor, iatProvider: IATProvider, projectId: String, - crypto: CryptoProvider + crypto: CryptoProvider, + supportLinkMode:Bool ) -> SignClient { let kms = KeyManagementService(keychain: keychainStorage) let rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) @@ -110,9 +113,7 @@ public struct SignClientFactory { let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) - let linkModeTransportTypeUpgradeStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeTransportTypeUpgradeStore.rawValue) - - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, linkModeTransportTypeUpgradeStore: linkModeTransportTypeUpgradeStore) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, supportLinkMode: supportLinkMode) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) @@ -142,7 +143,7 @@ public struct SignClientFactory { let sessionResponderDispatcher = SessionResponderDispatcher(relaySessionResponder: relaySessionResponder, linkSessionResponder: linkSessionResponder, logger: logger, sessionStore: sessionStore) let linkSessionRequestResponseSubscriber = LinkSessionRequestResponseSubscriber(envelopesDispatcher: linkEnvelopesDispatcher) - let authenticateTransportTypeSwitcher = AuthenticateTransportTypeSwitcher(linkModeTransportTypeUpgradeStore: linkModeTransportTypeUpgradeStore, linkAuthRequester: linkAuthRequester, pairingClient: pairingClient, logger: logger, appRequestService: appRequestService, appProposeService: appProposerService) + let authenticateTransportTypeSwitcher = AuthenticateTransportTypeSwitcher(linkAuthRequester: linkAuthRequester, pairingClient: pairingClient, logger: logger, appRequestService: appRequestService, appProposeService: appProposerService) let client = SignClient( logger: logger, diff --git a/Sources/WalletConnectSign/SignStorageIdentifiers.swift b/Sources/WalletConnectSign/SignStorageIdentifiers.swift index 7537bde16..d49f7065b 100644 --- a/Sources/WalletConnectSign/SignStorageIdentifiers.swift +++ b/Sources/WalletConnectSign/SignStorageIdentifiers.swift @@ -7,5 +7,4 @@ enum SignStorageIdentifiers: String { case sessionTopicToProposal = "com.walletconnect.sdk.sessionTopicToProposal" case authResponseTopicRecord = "com.walletconnect.sdk.authResponseTopicRecord" case linkModeLinks = "com.walletconnect.sdk.linkModeLinks" - case linkModeTransportTypeUpgradeStore = "com.walletconnect.sdk.linkModeTransportTypeUpgradeStore" } From 03d6c5e32bdf9f64d249acdc6d53e603f0ba97e3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 May 2024 08:26:31 +0200 Subject: [PATCH 585/814] update tests, add relay blockPublishing --- Example/DApp/SceneDelegate.swift | 4 +- .../IntegrationTests.xctestplan | 1 + .../Sign/SignClientTests.swift | 114 ++++++++++++---- .../Web3Wallet/XPlatformW3WTests.swift | 3 +- .../ConfigurationService.swift | 2 +- .../ApplicationLayer/SceneDelegate.swift | 2 +- Sources/WalletConnectRelay/RelayClient.swift | 9 ++ .../LinkSessionAuthenticateResponder.swift | 2 +- .../NonControllerSessionStateMachine.swift | 0 .../ControllerSessionStateMachine.swift | 0 .../Engine/Wallet/SessionResponder.swift | 60 +++++++++ ...ApproveSessionAuthenticateDispatcher.swift | 5 +- .../LinkSessionResponder.swift | 67 ++++++++++ .../SessionRequestDispatcher.swift | 2 +- .../SessionResponderDispatcher.swift | 122 +----------------- 15 files changed, 241 insertions(+), 152 deletions(-) rename Sources/WalletConnectSign/Engine/{NonController => Dapp}/NonControllerSessionStateMachine.swift (100%) rename Sources/WalletConnectSign/Engine/{Controller => Wallet}/ControllerSessionStateMachine.swift (100%) create mode 100644 Sources/WalletConnectSign/Engine/Wallet/SessionResponder.swift create mode 100644 Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index ad5ee5166..9bf9fba79 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -33,14 +33,14 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) - Sign.configure(crypto: DefaultCryptoProvider()) + Sign.configure(crypto: DefaultCryptoProvider(), supportLinkMode: true) let metadata = AppMetadata( name: "Swift Dapp", description: "WalletConnect DApp sample", url: "wallet.connect", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp") + redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: "https://lab.web3modal.com/dapp") ) Web3Modal.configure( diff --git a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan index 40b79df1d..3a1311643 100644 --- a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan +++ b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan @@ -54,6 +54,7 @@ { "parallelizable" : true, "skippedTests" : [ + "AuthTests", "AuthTests\/testEIP1271RespondSuccess()", "ChatTests", "ENSResolverTests", diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 62cf7c7f8..cf474452e 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -15,6 +15,8 @@ final class SignClientTests: XCTestCase { var wallet: SignClient! var walletPairingClient: PairingClient! var dappKeyValueStorage: RuntimeKeyValueStorage! + var dappRelayClient: RelayClient! + var walletRelayClient: RelayClient! private var publishers = Set() let walletAccount = Account(chainIdentifier: "eip155:1", address: "0x724d0D2DaD3fbB0C168f947B87Fa5DBe36F1A8bf")! let prvKey = Data(hex: "462c1dad6832d7d96ccf87bd6a686a4110e114aaaebd5512e552c0e3a87b480f") @@ -22,7 +24,7 @@ final class SignClientTests: XCTestCase { let walletLinkModeUniversalLink = "https://test" - static private func makeClients(name: String, linkModeUniversalLink: String? = nil) -> (PairingClient, SignClient, RuntimeKeyValueStorage) { + static private func makeClients(name: String, linkModeUniversalLink: String? = nil, supportLinkMode: Bool = false) -> (PairingClient, SignClient, RuntimeKeyValueStorage, RelayClient) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() @@ -59,18 +61,25 @@ final class SignClientTests: XCTestCase { networkingClient: networkingClient, iatProvider: IATProviderMock(), projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider() + crypto: DefaultCryptoProvider(), + supportLinkMode: supportLinkMode ) let clientId = try! networkingClient.getClientId() logger.debug("My client id is: \(clientId)") - return (pairingClient, client, keyValueStorage) + return (pairingClient, client, keyValueStorage, relayClient) } override func setUp() async throws { - (dappPairingClient, dapp, dappKeyValueStorage) = Self.makeClients(name: "🍏Dapp") - (walletPairingClient, wallet, _) = Self.makeClients(name: "🍎Wallet", linkModeUniversalLink: walletLinkModeUniversalLink) + (dappPairingClient, dapp, dappKeyValueStorage, dappRelayClient) = Self.makeClients(name: "🍏Dapp") + (walletPairingClient, wallet, _, walletRelayClient) = Self.makeClients(name: "🍎Wallet", linkModeUniversalLink: walletLinkModeUniversalLink) + } + + func setUpDappForLinkMode() async throws { + try await tearDown() + (dappPairingClient, dapp, dappKeyValueStorage, dappRelayClient) = Self.makeClients(name: "🍏Dapp", supportLinkMode: true) + (walletPairingClient, wallet, _, walletRelayClient) = Self.makeClients(name: "🍎Wallet", linkModeUniversalLink: walletLinkModeUniversalLink) } override func tearDown() { @@ -808,7 +817,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub()) + let uri = try await dapp.authenticate(AuthRequestParams.stub())! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -843,7 +852,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub(methods: nil)) + let uri = try await dapp.authenticate(AuthRequestParams.stub(methods: nil))! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -890,7 +899,7 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub(chains: ["eip155:1", "eip155:137"])) + let uri = try await dapp.authenticate(AuthRequestParams.stub(chains: ["eip155:1", "eip155:137"]))! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -912,7 +921,7 @@ final class SignClientTests: XCTestCase { requestId: nil, resources: nil, methods: nil - )) + ))! try await walletPairingClient.pair(uri: uri) @@ -934,7 +943,7 @@ final class SignClientTests: XCTestCase { func testEIP191SessionAuthenticateSignatureVerificationFailed() async { let requestExpectation = expectation(description: "error response delivered") - let uri = try! await dapp.authenticate(AuthRequestParams.stub()) + let uri = try! await dapp.authenticate(AuthRequestParams.stub())! try? await walletPairingClient.pair(uri: uri) wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in @@ -956,7 +965,7 @@ final class SignClientTests: XCTestCase { func testSessionAuthenticateUserRespondError() async { let responseExpectation = expectation(description: "error response delivered") - let uri = try! await dapp.authenticate(AuthRequestParams.stub()) + let uri = try! await dapp.authenticate(AuthRequestParams.stub())! try? await walletPairingClient.pair(uri: uri) wallet.authenticateRequestPublisher.sink { [unowned self] request in @@ -1035,7 +1044,7 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub()) + let uri = try await dapp.authenticate(AuthRequestParams.stub())! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) @@ -1104,7 +1113,7 @@ final class SignClientTests: XCTestCase { }.store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub(chains: ["eip155:1", "eip155:137"])) + let uri = try await dapp.authenticate(AuthRequestParams.stub(chains: ["eip155:1", "eip155:137"]))! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) @@ -1129,7 +1138,7 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub()) + let uri = try await dapp.authenticate(AuthRequestParams.stub())! let uriStringWithoutMethods = uri.absoluteString.replacingOccurrences(of: "&methods=wc_sessionAuthenticate", with: "") let uriWithoutMethods = try WalletConnectURI(uriString: uriStringWithoutMethods) try await walletPairingClient.pair(uri: uriWithoutMethods) @@ -1138,6 +1147,7 @@ final class SignClientTests: XCTestCase { func testFallbackToSessionProposeIfWalletIsNotSubscribingSessionAuthenticate() async throws { + let responseExpectation = expectation(description: "successful response delivered") let requiredNamespaces = ProposalNamespace.stubRequired() @@ -1155,7 +1165,7 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub()) + let uri = try await dapp.authenticate(AuthRequestParams.stub())! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -1163,6 +1173,10 @@ final class SignClientTests: XCTestCase { // Link Mode func testLinkAuthRequest() async throws { + try await setUpDappForLinkMode() + dappRelayClient.blockPublishing = true + walletRelayClient.blockPublishing = true + let responseExpectation = expectation(description: "successful response delivered") // Set Wallet's universal link in dapp storage to mock wallet proof on link mode support @@ -1204,6 +1218,9 @@ final class SignClientTests: XCTestCase { } func testLinkSessionRequest() async throws { + try await setUpDappForLinkMode() + dappRelayClient.blockPublishing = true + walletRelayClient.blockPublishing = true let requestExpectation = expectation(description: "Wallet expects to receive a request") let responseExpectation = expectation(description: "Dapp expects to receive a response") @@ -1298,8 +1315,9 @@ final class SignClientTests: XCTestCase { } } - func testUpgradeFromRelayToLinkMode() async throws { + try await setUpDappForLinkMode() + let linkModeUpgradeExpectation = expectation(description: "successful upgraded to link mode") wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in Task(priority: .high) { @@ -1318,10 +1336,12 @@ final class SignClientTests: XCTestCase { let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + walletRelayClient.blockPublishing = true } } .store(in: &publishers) - dapp.authResponsePublisher.sink { (_, result) in + dapp.authResponsePublisher.sink { [unowned self] (_, result) in + dappRelayClient.blockPublishing = true guard case .success = result else { XCTFail(); return } @@ -1333,13 +1353,63 @@ final class SignClientTests: XCTestCase { .store(in: &publishers) - let uri = try await dapp.authenticate(AuthRequestParams.stub(), walletUniversalLink: walletLinkModeUniversalLink) + let uri = try await dapp.authenticate(AuthRequestParams.stub(), walletUniversalLink: walletLinkModeUniversalLink)! try await walletPairingClient.pair(uri: uri) await fulfillment(of: [linkModeUpgradeExpectation], timeout: InputConfig.defaultTimeout) } - func testUpgradeSessionToLinkModeAndSendRequestOverLinkMode() async throws { - fatalError() - add walidation for linkmode property in metadata - } +// func testUpgradeSessionToLinkModeAndSendRequestOverLinkMode() async throws { +// +// let requestMethod = "personal_sign" +// let requestParams = [EthSendTransaction.stub()] +// let responseExpectation = expectation(description: "Dapp expects to receive a response") +// +//// let responseParams = "0xdeadbeef" +// +// let linkModeUpgradeExpectation = expectation(description: "successful upgraded to link mode") +// wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in +// Task(priority: .high) { +// let signerFactory = DefaultSignerFactory() +// let signer = MessageSignerFactory(signerFactory: signerFactory).create() +// +// let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) +// +// let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) +// +// let signature = try signer.sign( +// message: siweMessage, +// privateKey: prvKey, +// type: .eip191) +// +// let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) +// +// _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) +// } +// } +// .store(in: &publishers) +// dapp.authResponsePublisher.sink { (_, result) in +// guard case .success(let (session, _)) = result, +// let session = session else { XCTFail(); return } +// +// Task { [unowned self] in +// let request = try! Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: Blockchain("eip155:1")!) +// let requestEnvelope = try! await self.dapp.requestLinkMode(params: request)! +// try! self.wallet.dispatchEnvelope(requestEnvelope) +// } +// } +// .store(in: &publishers) +// +// dapp.sessionResponsePublisher.sink { response in +//// semaphore.wait() +// +// responseExpectation.fulfill() +// }.store(in: &publishers) +//// semaphore.signal() +// +// +// let uri = try await dapp.authenticate(AuthRequestParams.stub(), walletUniversalLink: walletLinkModeUniversalLink)! +// try await walletPairingClient.pair(uri: uri) +// await fulfillment(of: [linkModeUpgradeExpectation], timeout: InputConfig.defaultTimeout) +// } + } diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index 537668f34..5949f242e 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -57,7 +57,8 @@ final class XPlatformW3WTests: XCTestCase { networkingClient: networkingClient, iatProvider: DefaultIATProvider(), projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider() + crypto: DefaultCryptoProvider(), + supportLinkMode: false ) w3wClient = Web3WalletClientFactory.create( diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index d023873d5..dada2716a 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: "https://lab.web3modal.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 67ebba1ee..bbd6e4976 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -130,7 +130,7 @@ private extension SceneDelegate { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: "https://lab.web3modal.com/wallet") ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 87309129a..f1e821491 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -13,6 +13,9 @@ public enum SocketConnectionStatus { /// Access via `Relay.instance` public final class RelayClient { + #if DEBUG + public var blockPublishing: Bool = false + #endif enum Errors: Error { case subscriptionIdNotFound } @@ -97,6 +100,12 @@ public final class RelayClient { /// Completes with an acknowledgement from the relay network public func publish(topic: String, payload: String, tag: Int, prompt: Bool, ttl: Int) async throws { + #if DEBUG + if blockPublishing { + logger.debug("[Publish] Publishing is blocked") + return + } + #endif let request = Publish(params: .init(topic: topic, message: payload, ttl: ttl, prompt: prompt, tag: tag)).asRPCRequest() let message = try request.asJSONEncodedString() diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index 6fb240dd7..e6116d4ef 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -35,7 +35,7 @@ actor LinkSessionAuthenticateResponder { let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) let peerParticipant = sessionAuthenticateRequestParams.requester - guard let peerUniversalLink = peerParticipant.metadata.redirect?.linkMode else { + guard let peerUniversalLink = peerParticipant.metadata.redirect?.universal else { throw Errors.missingPeerUniversalLink } diff --git a/Sources/WalletConnectSign/Engine/NonController/NonControllerSessionStateMachine.swift b/Sources/WalletConnectSign/Engine/Dapp/NonControllerSessionStateMachine.swift similarity index 100% rename from Sources/WalletConnectSign/Engine/NonController/NonControllerSessionStateMachine.swift rename to Sources/WalletConnectSign/Engine/Dapp/NonControllerSessionStateMachine.swift diff --git a/Sources/WalletConnectSign/Engine/Controller/ControllerSessionStateMachine.swift b/Sources/WalletConnectSign/Engine/Wallet/ControllerSessionStateMachine.swift similarity index 100% rename from Sources/WalletConnectSign/Engine/Controller/ControllerSessionStateMachine.swift rename to Sources/WalletConnectSign/Engine/Wallet/ControllerSessionStateMachine.swift diff --git a/Sources/WalletConnectSign/Engine/Wallet/SessionResponder.swift b/Sources/WalletConnectSign/Engine/Wallet/SessionResponder.swift new file mode 100644 index 000000000..fc9e89ef4 --- /dev/null +++ b/Sources/WalletConnectSign/Engine/Wallet/SessionResponder.swift @@ -0,0 +1,60 @@ + +import Foundation + +class SessionResponder { + enum Errors: Error { + case sessionRequestExpired + } + private let logger: ConsoleLogging + private let sessionStore: WCSessionStorage + private let networkingInteractor: NetworkInteracting + private let verifyContextStore: CodableStore + private let sessionRequestsProvider: SessionRequestsProvider + private let historyService: HistoryService + + init(logger: ConsoleLogging, sessionStore: WCSessionStorage, networkingInteractor: NetworkInteracting, verifyContextStore: CodableStore, sessionRequestsProvider: SessionRequestsProvider, historyService: HistoryService) { + self.logger = logger + self.sessionStore = sessionStore + self.networkingInteractor = networkingInteractor + self.verifyContextStore = verifyContextStore + self.sessionRequestsProvider = sessionRequestsProvider + self.historyService = historyService + } + + func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws { + guard sessionStore.hasSession(forTopic: topic) else { + throw WalletConnectError.noSessionMatchingTopic(topic) + } + + let protocolMethod = SessionRequestProtocolMethod() + + guard sessionRequestNotExpired(requestId: requestId) else { + try await networkingInteractor.respondError( + topic: topic, + requestId: requestId, + protocolMethod: protocolMethod, + reason: SignReasonCode.sessionRequestExpired + ) + verifyContextStore.delete(forKey: requestId.string) + throw Errors.sessionRequestExpired + } + + try await networkingInteractor.respond( + topic: topic, + response: RPCResponse(id: requestId, outcome: response), + protocolMethod: protocolMethod + ) + verifyContextStore.delete(forKey: requestId.string) + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in + guard let self = self else {return} + sessionRequestsProvider.emitRequestIfPending() + } + } + + private func sessionRequestNotExpired(requestId: RPCID) -> Bool { + guard let request = historyService.getSessionRequest(id: requestId)?.request + else { return false } + + return !request.isExpired() + } +} diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift index 042f95f91..e6a055902 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift @@ -22,11 +22,12 @@ actor ApproveSessionAuthenticateDispatcher { public func approveSessionAuthenticate(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String?) { - let transportType = try util.getHistoryRecord(requestId: requestId).transportType + let transportType = try util.getHistoryRecord(requestId: requestId).transportType ?? .relay + logger.debug("Will approve session authenticate with transport type: \(transportType)") switch transportType { - case .relay, .none: + case .relay: let session = try await sessionAuthenticateResponder.respond(requestId: requestId, auths: auths) return (session, nil) case .linkMode: diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift new file mode 100644 index 000000000..03c43c3b9 --- /dev/null +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift @@ -0,0 +1,67 @@ +import Foundation + +class LinkSessionResponder { + enum Errors: Error { + case sessionRequestExpired + case missingPeerUniversalLink + } + private let logger: ConsoleLogging + private let sessionStore: WCSessionStorage + private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let sessionRequestsProvider: SessionRequestsProvider + private let historyService: HistoryService + + init( + logger: ConsoleLogging, + sessionStore: WCSessionStorage, + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + sessionRequestsProvider: SessionRequestsProvider, + historyService: HistoryService + ) { + self.logger = logger + self.sessionStore = sessionStore + self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.sessionRequestsProvider = sessionRequestsProvider + self.historyService = historyService + } + + func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String { + guard let session = sessionStore.getSession(forTopic: topic) else { + throw WalletConnectError.noSessionMatchingTopic(topic) + } + + guard let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal else { + throw Errors.missingPeerUniversalLink + } + + guard sessionRequestNotExpired(requestId: requestId) else { + try await linkEnvelopesDispatcher.respondError( + topic: topic, + requestId: requestId, + peerUniversalLink: peerUniversalLink, + reason: SignReasonCode.sessionRequestExpired, + envelopeType: .type0 + ) + throw Errors.sessionRequestExpired + } + + let responseEnvelope = try await linkEnvelopesDispatcher.respond( + topic: topic, + response: RPCResponse(id: requestId, outcome: response), + peerUniversalLink: peerUniversalLink, + envelopeType: .type0 + ) + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in + guard let self = self else {return} + sessionRequestsProvider.emitRequestIfPending() + } + return responseEnvelope + } + + private func sessionRequestNotExpired(requestId: RPCID) -> Bool { + guard let request = historyService.getSessionRequest(id: requestId)?.request + else { return false } + + return !request.isExpired() + } +} diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift index ff33fbf63..4822e8704 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -98,7 +98,7 @@ class LinkSessionRequester { throw WalletConnectError.invalidPermissions } // it's safe to force unwrap because redirect was used during session creation before - let peerUniversalLink = session.peerParticipant.metadata.redirect!.linkMode! + let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) let ttl = try request.calculateTtl() diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift index f50a2d292..66f6d1572 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift @@ -26,6 +26,7 @@ class SessionResponderDispatcher { throw WalletConnectError.noSessionMatchingTopic(topic) } let transportType = session.transportType + logger.debug("Will respond session request with transport type: \(transportType)") switch transportType { case .relay: @@ -36,124 +37,3 @@ class SessionResponderDispatcher { } } } - -class SessionResponder { - enum Errors: Error { - case sessionRequestExpired - } - private let logger: ConsoleLogging - private let sessionStore: WCSessionStorage - private let networkingInteractor: NetworkInteracting - private let verifyContextStore: CodableStore - private let sessionRequestsProvider: SessionRequestsProvider - private let historyService: HistoryService - - init(logger: ConsoleLogging, sessionStore: WCSessionStorage, networkingInteractor: NetworkInteracting, verifyContextStore: CodableStore, sessionRequestsProvider: SessionRequestsProvider, historyService: HistoryService) { - self.logger = logger - self.sessionStore = sessionStore - self.networkingInteractor = networkingInteractor - self.verifyContextStore = verifyContextStore - self.sessionRequestsProvider = sessionRequestsProvider - self.historyService = historyService - } - - func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws { - guard sessionStore.hasSession(forTopic: topic) else { - throw WalletConnectError.noSessionMatchingTopic(topic) - } - - let protocolMethod = SessionRequestProtocolMethod() - - guard sessionRequestNotExpired(requestId: requestId) else { - try await networkingInteractor.respondError( - topic: topic, - requestId: requestId, - protocolMethod: protocolMethod, - reason: SignReasonCode.sessionRequestExpired - ) - verifyContextStore.delete(forKey: requestId.string) - throw Errors.sessionRequestExpired - } - - try await networkingInteractor.respond( - topic: topic, - response: RPCResponse(id: requestId, outcome: response), - protocolMethod: protocolMethod - ) - verifyContextStore.delete(forKey: requestId.string) - DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in - guard let self = self else {return} - sessionRequestsProvider.emitRequestIfPending() - } - } - - private func sessionRequestNotExpired(requestId: RPCID) -> Bool { - guard let request = historyService.getSessionRequest(id: requestId)?.request - else { return false } - - return !request.isExpired() - } -} - -class LinkSessionResponder { - enum Errors: Error { - case sessionRequestExpired - } - private let logger: ConsoleLogging - private let sessionStore: WCSessionStorage - private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher - private let sessionRequestsProvider: SessionRequestsProvider - private let historyService: HistoryService - - init( - logger: ConsoleLogging, - sessionStore: WCSessionStorage, - linkEnvelopesDispatcher: LinkEnvelopesDispatcher, - sessionRequestsProvider: SessionRequestsProvider, - historyService: HistoryService - ) { - self.logger = logger - self.sessionStore = sessionStore - self.linkEnvelopesDispatcher = linkEnvelopesDispatcher - self.sessionRequestsProvider = sessionRequestsProvider - self.historyService = historyService - } - - func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String { - guard let session = sessionStore.getSession(forTopic: topic) else { - throw WalletConnectError.noSessionMatchingTopic(topic) - } - - let peerUniversalLink = session.peerParticipant.metadata.redirect!.linkMode! - - guard sessionRequestNotExpired(requestId: requestId) else { - try await linkEnvelopesDispatcher.respondError( - topic: topic, - requestId: requestId, - peerUniversalLink: peerUniversalLink, - reason: SignReasonCode.sessionRequestExpired, - envelopeType: .type0 - ) - throw Errors.sessionRequestExpired - } - - let responseEnvelope = try await linkEnvelopesDispatcher.respond( - topic: topic, - response: RPCResponse(id: requestId, outcome: response), - peerUniversalLink: peerUniversalLink, - envelopeType: .type0 - ) - DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in - guard let self = self else {return} - sessionRequestsProvider.emitRequestIfPending() - } - return responseEnvelope - } - - private func sessionRequestNotExpired(requestId: RPCID) -> Bool { - guard let request = historyService.getSessionRequest(id: requestId)?.request - else { return false } - - return !request.isExpired() - } -} From 3c26608d9bd9088b340a68e98cc4b9174e807be9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 May 2024 09:06:33 +0200 Subject: [PATCH 586/814] add testUpgradeSessionToLinkModeAndSendRequestOverLinkMode --- .../Sign/SignClientTests.swift | 115 ++++++++++-------- .../Link/ApproveSessionAuthenticateUtil.swift | 1 + .../Link/LinkSessionRequestSubscriber.swift | 14 ++- .../SessionRequestDispatcher.swift | 1 + .../Types/Session/WCSession.swift | 2 +- 5 files changed, 76 insertions(+), 57 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index cf474452e..2ed7faf50 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1358,58 +1358,67 @@ final class SignClientTests: XCTestCase { await fulfillment(of: [linkModeUpgradeExpectation], timeout: InputConfig.defaultTimeout) } -// func testUpgradeSessionToLinkModeAndSendRequestOverLinkMode() async throws { -// -// let requestMethod = "personal_sign" -// let requestParams = [EthSendTransaction.stub()] -// let responseExpectation = expectation(description: "Dapp expects to receive a response") -// -//// let responseParams = "0xdeadbeef" -// -// let linkModeUpgradeExpectation = expectation(description: "successful upgraded to link mode") -// wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in -// Task(priority: .high) { -// let signerFactory = DefaultSignerFactory() -// let signer = MessageSignerFactory(signerFactory: signerFactory).create() -// -// let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) -// -// let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) -// -// let signature = try signer.sign( -// message: siweMessage, -// privateKey: prvKey, -// type: .eip191) -// -// let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) -// -// _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) -// } -// } -// .store(in: &publishers) -// dapp.authResponsePublisher.sink { (_, result) in -// guard case .success(let (session, _)) = result, -// let session = session else { XCTFail(); return } -// -// Task { [unowned self] in -// let request = try! Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: Blockchain("eip155:1")!) -// let requestEnvelope = try! await self.dapp.requestLinkMode(params: request)! -// try! self.wallet.dispatchEnvelope(requestEnvelope) -// } -// } -// .store(in: &publishers) -// -// dapp.sessionResponsePublisher.sink { response in -//// semaphore.wait() -// -// responseExpectation.fulfill() -// }.store(in: &publishers) -//// semaphore.signal() -// -// -// let uri = try await dapp.authenticate(AuthRequestParams.stub(), walletUniversalLink: walletLinkModeUniversalLink)! -// try await walletPairingClient.pair(uri: uri) -// await fulfillment(of: [linkModeUpgradeExpectation], timeout: InputConfig.defaultTimeout) -// } + func testUpgradeSessionToLinkModeAndSendRequestOverLinkMode() async throws { + + try await setUpDappForLinkMode() + let requestMethod = "personal_sign" + let requestParams = [EthSendTransaction.stub()] + let sessionResponseOnLinkModeExpectation = expectation(description: "Dapp expects to receive a response") + + let responseParams = "0xdeadbeef" + let semaphore = DispatchSemaphore(value: 0) + + wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in + + Task(priority: .high) { + let signerFactory = DefaultSignerFactory() + let signer = MessageSignerFactory(signerFactory: signerFactory).create() + + let supportedAuthPayload = try! wallet.buildAuthPayload(payload: request.payload, supportedEVMChains: [Blockchain("eip155:1")!, Blockchain("eip155:137")!], supportedMethods: ["eth_signTransaction", "personal_sign"]) + + let siweMessage = try! wallet.formatAuthMessage(payload: supportedAuthPayload, account: walletAccount) + + let signature = try signer.sign( + message: siweMessage, + privateKey: prvKey, + type: .eip191) + + let auth = try wallet.buildSignedAuthObject(authPayload: supportedAuthPayload, signature: signature, account: walletAccount) + + _ = try! await wallet.approveSessionAuthenticate(requestId: request.id, auths: [auth]) + semaphore.signal() + } + } + .store(in: &publishers) + dapp.authResponsePublisher.sink { [unowned self] (_, result) in + semaphore.wait() + dappRelayClient.blockPublishing = true + walletRelayClient.blockPublishing = true + guard case .success(let (session, _)) = result, + let session = session else { XCTFail(); return } + + Task { [unowned self] in + let request = try! Request(id: RPCID(0), topic: session.topic, method: requestMethod, params: requestParams, chainId: Blockchain("eip155:1")!) + let requestEnvelope = try! await self.dapp.requestLinkMode(params: request)! + try! self.wallet.dispatchEnvelope(requestEnvelope) + } + } + .store(in: &publishers) + + wallet.sessionRequestPublisher.sink { [unowned self] (sessionRequest, _) in + Task(priority: .high) { + let envelope = try! await wallet.respondLinkMode(topic: sessionRequest.topic, requestId: sessionRequest.id, response: .response(AnyCodable(responseParams)))! + try! dapp.dispatchEnvelope(envelope) + } + }.store(in: &publishers) + + dapp.sessionResponsePublisher.sink { response in + sessionResponseOnLinkModeExpectation.fulfill() + }.store(in: &publishers) + + let uri = try await dapp.authenticate(AuthRequestParams.stub(), walletUniversalLink: walletLinkModeUniversalLink)! + try await walletPairingClient.pair(uri: uri) + await fulfillment(of: [sessionResponseOnLinkModeExpectation], timeout: InputConfig.defaultTimeout) + } } diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index 241adab79..c69461c8a 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -103,6 +103,7 @@ class ApproveSessionAuthenticateUtil { acknowledged: true, transportType: transportType ) + logger.debug("created a session with topic: \(sessionTopic)") sessionStore.setSession(session) Task { diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift index 8730268cd..08827346d 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift @@ -26,7 +26,7 @@ class LinkSessionRequestSubscriber { return sessionRequestsProvider.sessionRequestPublisher } - func setupRequestSubscription() { + private func setupRequestSubscription() { envelopesDispatcher.requestSubscription(on: SessionRequestProtocolMethod().method) .sink { [unowned self] (payload: RequestSubscriptionPayload) in Task(priority: .high) { @@ -35,6 +35,13 @@ class LinkSessionRequestSubscriber { }.store(in: &publishers) } + private func upgradeSessionToLinkModeIfNeeded( _ session: inout WCSession) { + guard session.transportType != .linkMode else {return} + session.transportType = .linkMode + sessionStore.setSession(session) + logger.debug("session with topic: \(session.topic) upgraded to link mode") + } + func onSessionRequest(payload: RequestSubscriptionPayload) { logger.debug("Received session request") let topic = payload.topic @@ -46,11 +53,12 @@ class LinkSessionRequestSubscriber { chainId: payload.request.chainId, expiryTimestamp: payload.request.request.expiryTimestamp ) - guard let session = sessionStore.getSession(forTopic: topic) else { + guard var session = sessionStore.getSession(forTopic: topic) else { logger.debug("Session for topic not found") return } - guard let peerUniversalLink = session.peerParticipant.metadata.redirect?.linkMode else { + upgradeSessionToLinkModeIfNeeded(&session) + guard let peerUniversalLink = session.peerParticipant.metadata.redirect?.universal else { logger.debug("Peer universal link not found") return } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift index 4822e8704..4ac29bba2 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -26,6 +26,7 @@ class SessionRequestDispatcher { throw WalletConnectError.noSessionMatchingTopic(request.topic) } let transportType = session.transportType + logger.debug("Will send session request on transport type: \(transportType)") switch transportType { case .relay: diff --git a/Sources/WalletConnectSign/Types/Session/WCSession.swift b/Sources/WalletConnectSign/Types/Session/WCSession.swift index fbca74d2b..c5224bb00 100644 --- a/Sources/WalletConnectSign/Types/Session/WCSession.swift +++ b/Sources/WalletConnectSign/Types/Session/WCSession.swift @@ -16,7 +16,7 @@ struct WCSession: SequenceObject, Equatable { let selfParticipant: Participant let peerParticipant: Participant let controller: AgreementPeer - let transportType: TransportType + var transportType: TransportType private(set) var acknowledged: Bool private(set) var expiryDate: Date From 63a1b5011956b33a1bb6e510650ee9114a135392 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 May 2024 11:29:17 +0200 Subject: [PATCH 587/814] make linkMode property bool --- Example/IntegrationTests/Sign/SignClientTests.swift | 8 ++++---- Sources/WalletConnectPairing/Types/AppMetadata.swift | 6 +++--- .../Auth/Services/App/AuthResponseSubscriber.swift | 10 ++++++---- .../LinkAndRelayDispatchers/WalletErrorResponder.swift | 9 ++++++++- Sources/WalletConnectSign/Sign/SignClient.swift | 3 ++- 5 files changed, 23 insertions(+), 13 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 2ed7faf50..e9e998a44 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -24,7 +24,7 @@ final class SignClientTests: XCTestCase { let walletLinkModeUniversalLink = "https://test" - static private func makeClients(name: String, linkModeUniversalLink: String? = nil, supportLinkMode: Bool = false) -> (PairingClient, SignClient, RuntimeKeyValueStorage, RelayClient) { + static private func makeClients(name: String, linkModeUniversalLink: String? = UUID().uuidString, supportLinkMode: Bool = false) -> (PairingClient, SignClient, RuntimeKeyValueStorage, RelayClient) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() @@ -50,8 +50,8 @@ final class SignClientTests: XCTestCase { keychainStorage: keychain, networkingClient: networkingClient ) - let metadata = AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: UUID().uuidString, linkMode: linkModeUniversalLink)) - + let metadata = AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: linkModeUniversalLink, linkMode: supportLinkMode)) + let client = SignClientFactory.create( metadata: metadata, logger: logger, @@ -79,7 +79,7 @@ final class SignClientTests: XCTestCase { func setUpDappForLinkMode() async throws { try await tearDown() (dappPairingClient, dapp, dappKeyValueStorage, dappRelayClient) = Self.makeClients(name: "🍏Dapp", supportLinkMode: true) - (walletPairingClient, wallet, _, walletRelayClient) = Self.makeClients(name: "🍎Wallet", linkModeUniversalLink: walletLinkModeUniversalLink) + (walletPairingClient, wallet, _, walletRelayClient) = Self.makeClients(name: "🍎Wallet", linkModeUniversalLink: walletLinkModeUniversalLink, supportLinkMode: true) } override func tearDown() { diff --git a/Sources/WalletConnectPairing/Types/AppMetadata.swift b/Sources/WalletConnectPairing/Types/AppMetadata.swift index 25ada49cb..5362b94e2 100644 --- a/Sources/WalletConnectPairing/Types/AppMetadata.swift +++ b/Sources/WalletConnectPairing/Types/AppMetadata.swift @@ -21,7 +21,7 @@ public struct AppMetadata: Codable, Equatable { /// Universal link URL string. public let universal: String? - public let linkMode: String? + public let linkMode: Bool /** Creates a new Redirect object with the specified information. @@ -30,7 +30,7 @@ public struct AppMetadata: Codable, Equatable { - native: Native deeplink URL string. - universal: Universal link URL string. */ - public init(native: String, universal: String?, linkMode: String? = nil) { + public init(native: String, universal: String?, linkMode: Bool = false) { self.native = native self.universal = universal self.linkMode = linkMode @@ -85,7 +85,7 @@ public extension AppMetadata { description: "A protocol to connect blockchain wallets to dapps.", url: "https://walletconnect.com/", icons: [], - redirect: AppMetadata.Redirect(native: "", universal: nil, linkMode: nil) + redirect: AppMetadata.Redirect(native: "", universal: nil) ) } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 4ca753333..33bbfb429 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -61,7 +61,7 @@ class AuthResponseSubscriber { networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - let transportType = getTransportTypeUpgradeIfPossible(metadata: payload.response.responder.metadata, requestId: payload.id) + let transportType = getTransportTypeUpgradeIfPossible(peerMetadata: payload.response.responder.metadata, requestId: payload.id) let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) @@ -138,13 +138,15 @@ class AuthResponseSubscriber { } } - private func getTransportTypeUpgradeIfPossible(metadata: AppMetadata, requestId: RPCID) -> WCSession.TransportType { + private func getTransportTypeUpgradeIfPossible(peerMetadata: AppMetadata, requestId: RPCID) -> WCSession.TransportType { // upgrade to link mode only if dapp requested universallink because dapp may not be prepared for handling a response - add this to doc] // remove record - if let linkModeLink = metadata.redirect?.linkMode, + if let peerRedirect = peerMetadata.redirect, + peerRedirect.linkMode, + let universalLink = peerRedirect.universal, supportLinkMode { - linkModeLinksStore.set(true, forKey: linkModeLink) + linkModeLinksStore.set(true, forKey: universalLink) return .linkMode } else { return .relay diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index ec77c0386..8d0ade6bf 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -5,6 +5,7 @@ actor WalletErrorResponder { case recordForIdNotFound case malformedAuthRequestParams case peerUniversalLinkNotFound + case linkModeNotSupported } private let networkingInteractor: NetworkInteracting @@ -53,7 +54,11 @@ actor WalletErrorResponder { private func respondErrorLinkMode(_ error: AuthError, requestId: RPCID, topic: String, type1EnvelopeKey: Data) async throws -> String { let (sessionAuthenticateRequestParams, _) = try getsessionAuthenticateRequestParams(requestId: requestId) - guard let peerUniversalLink = sessionAuthenticateRequestParams.requester.metadata.redirect?.linkMode else { + guard let redirect = sessionAuthenticateRequestParams.requester.metadata.redirect, + redirect.linkMode else { + throw Errors.linkModeNotSupported + } + guard let peerUniversalLink = redirect.universal else { throw Errors.peerUniversalLinkNotFound } @@ -106,6 +111,8 @@ extension WalletErrorResponder.Errors: LocalizedError { return NSLocalizedString("The authentication request parameters are malformed.", comment: "Malformed Auth Request Params Error") case .peerUniversalLinkNotFound: return NSLocalizedString("The peer's universal link was not found.", comment: "Peer Universal Link Not Found Error") + case .linkModeNotSupported: + return NSLocalizedString("Link mode is not supported.", comment: "Link Mode Not Supported Error") } } } diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 02ee023f4..be4339671 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -350,13 +350,14 @@ public final class SignClient: SignClientProtocol { } - // Link mode + #if DEBUG @discardableResult public func authenticateLinkMode( _ params: AuthRequestParams, walletUniversalLink: String ) async throws -> String { return try await linkAuthRequester.request(params: params, walletUniversalLink: walletUniversalLink) } + #endif public func dispatchEnvelope(_ envelope: String) throws { try linkEnvelopesDispatcher.dispatchEnvelope(envelope) From e411b7e79f24aa8e0af32f5610fa0e9b8c83a878 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 May 2024 11:36:58 +0200 Subject: [PATCH 588/814] savepoint --- Example/IntegrationTests/Sign/SignClientTests.swift | 3 +-- .../XPlatform/Web3Wallet/XPlatformW3WTests.swift | 3 +-- Sources/WalletConnectSign/Auth/SignConfig.swift | 1 - Sources/WalletConnectSign/Sign/Sign.swift | 7 +++---- Sources/WalletConnectSign/Sign/SignClientFactory.swift | 10 ++++------ 5 files changed, 9 insertions(+), 15 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index e9e998a44..c1dd35c22 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -61,8 +61,7 @@ final class SignClientTests: XCTestCase { networkingClient: networkingClient, iatProvider: IATProviderMock(), projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - supportLinkMode: supportLinkMode + crypto: DefaultCryptoProvider() ) let clientId = try! networkingClient.getClientId() diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index 5949f242e..537668f34 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -57,8 +57,7 @@ final class XPlatformW3WTests: XCTestCase { networkingClient: networkingClient, iatProvider: DefaultIATProvider(), projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider(), - supportLinkMode: false + crypto: DefaultCryptoProvider() ) w3wClient = Web3WalletClientFactory.create( diff --git a/Sources/WalletConnectSign/Auth/SignConfig.swift b/Sources/WalletConnectSign/Auth/SignConfig.swift index 367c48175..7419f0f9b 100644 --- a/Sources/WalletConnectSign/Auth/SignConfig.swift +++ b/Sources/WalletConnectSign/Auth/SignConfig.swift @@ -3,6 +3,5 @@ import Foundation extension Sign { struct Config { let crypto: CryptoProvider - let supportLinkMode: Bool } } diff --git a/Sources/WalletConnectSign/Sign/Sign.swift b/Sources/WalletConnectSign/Sign/Sign.swift index 2ce580204..25f88df3e 100644 --- a/Sources/WalletConnectSign/Sign/Sign.swift +++ b/Sources/WalletConnectSign/Sign/Sign.swift @@ -29,8 +29,7 @@ public class Sign { projectId: Networking.projectId, crypto: config.crypto, networkingClient: Networking.interactor, - groupIdentifier: Networking.groupIdentifier, - supportLinkMode: config.supportLinkMode + groupIdentifier: Networking.groupIdentifier ) }() @@ -41,8 +40,8 @@ public class Sign { /// Sign instance config method /// - Parameters: /// - metadata: App metadata - static public func configure(crypto: CryptoProvider, supportLinkMode: Bool = false) { - Sign.config = Sign.Config(crypto: crypto, supportLinkMode: supportLinkMode) + static public func configure(crypto: CryptoProvider) { + Sign.config = Sign.Config(crypto: crypto) } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index e66101df0..ad2a01ec2 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -17,8 +17,7 @@ public struct SignClientFactory { projectId: String, crypto: CryptoProvider, networkingClient: NetworkingInteractor, - groupIdentifier: String, - supportLinkMode: Bool + groupIdentifier: String ) -> SignClient { let logger = ConsoleLogger(prefix: "📝", loggingLevel: .off) @@ -38,8 +37,7 @@ public struct SignClientFactory { networkingClient: networkingClient, iatProvider: iatProvider, projectId: projectId, - crypto: crypto, - supportLinkMode: supportLinkMode + crypto: crypto ) } @@ -52,8 +50,7 @@ public struct SignClientFactory { networkingClient: NetworkingInteractor, iatProvider: IATProvider, projectId: String, - crypto: CryptoProvider, - supportLinkMode:Bool + crypto: CryptoProvider ) -> SignClient { let kms = KeyManagementService(keychain: keychainStorage) let rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) @@ -113,6 +110,7 @@ public struct SignClientFactory { let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) + let supportLinkMode = metadata.redirect?.linkMode ?? false let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, supportLinkMode: supportLinkMode) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) From 605386f8edb4933c3922abfe930f19276889b496 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 23 May 2024 12:58:03 +0200 Subject: [PATCH 589/814] add verify context --- .../IntegrationTests.xctestplan | 1 + .../Auth/Link/LinkAuthRequestSubscriber.swift | 20 +++- .../Sign/SignClientFactory.swift | 2 +- .../WalletConnectVerify/VerifyClient.swift | 10 ++ .../VerifyContextFactory.swift | 31 ++++++ .../VerifyContextFactoryTests.swift | 99 +++++++++++++------ 6 files changed, 127 insertions(+), 36 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan index 3a1311643..3e624e54b 100644 --- a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan +++ b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan @@ -59,6 +59,7 @@ "ChatTests", "ENSResolverTests", "HistoryTests", + "NotifyTests", "SyncDerivationServiceTests", "SyncTests" ], diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift index c78762090..2edda30d6 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -6,17 +6,24 @@ class LinkAuthRequestSubscriber { private let kms: KeyManagementServiceProtocol private var publishers = [AnyCancellable]() private let envelopesDispatcher: LinkEnvelopesDispatcher + private let verifyClient: VerifyClientProtocol + private let verifyContextStore: CodableStore + var onRequest: (((request: AuthenticationRequest, context: VerifyContext?)) -> Void)? init( logger: ConsoleLogging, kms: KeyManagementServiceProtocol, - envelopesDispatcher: LinkEnvelopesDispatcher + envelopesDispatcher: LinkEnvelopesDispatcher, + verifyClient: VerifyClientProtocol, + verifyContextStore: CodableStore ) { self.logger = logger self.kms = kms self.envelopesDispatcher = envelopesDispatcher + self.verifyClient = verifyClient + self.verifyContextStore = verifyContextStore subscribeForRequest() } @@ -31,9 +38,14 @@ class LinkAuthRequestSubscriber { let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.authPayload, requester: payload.request.requester.metadata) - // TODO fix verify context - - let verifyContext = VerifyContext(origin: "", validation: .valid) + let metadata = payload.request.requester.metadata + guard let redirect = metadata.redirect, + let universalLink = redirect.universal else { + logger.warn("redirect property not present") + return + } + let verifyContext = verifyClient.createVerifyContextForLinkMode(redirectUniversalLink: universalLink, domain: metadata.url) + verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index ad2a01ec2..4420fcffe 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -122,7 +122,7 @@ public struct SignClientFactory { let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) - let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher) + let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher, verifyClient: verifyClient, verifyContextStore: verifyContextStore) let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) diff --git a/Sources/WalletConnectVerify/VerifyClient.swift b/Sources/WalletConnectVerify/VerifyClient.swift index 8187ae137..9e834d7ed 100644 --- a/Sources/WalletConnectVerify/VerifyClient.swift +++ b/Sources/WalletConnectVerify/VerifyClient.swift @@ -4,6 +4,7 @@ import Foundation public protocol VerifyClientProtocol { func verifyOrigin(assertionId: String) async throws -> VerifyResponse func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext + func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext } public actor VerifyClient: VerifyClientProtocol { @@ -40,6 +41,10 @@ public actor VerifyClient: VerifyClientProtocol { verifyContextFactory.createVerifyContext(origin: origin, domain: domain, isScam: isScam) } + nonisolated public func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext { + verifyContextFactory.createVerifyContextForLinkMode(redirectUniversalLink: redirectUniversalLink, domain: domain) + } + public func registerAssertion() async throws { try await assertionRegistrer.registerAssertion() } @@ -48,6 +53,7 @@ public actor VerifyClient: VerifyClientProtocol { #if DEBUG public struct VerifyClientMock: VerifyClientProtocol { + public init() {} public func verifyOrigin(assertionId: String) async throws -> VerifyResponse { @@ -57,6 +63,10 @@ public struct VerifyClientMock: VerifyClientProtocol { public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { return VerifyContext(origin: "domain.com", validation: .valid) } + + public func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext { + fatalError() + } } #endif diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift index b687932e4..0cdec63fb 100644 --- a/Sources/WalletConnectVerify/VerifyContextFactory.swift +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -21,4 +21,35 @@ class VerifyContextFactory { ) } } + + public func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext { + guard let redirectURL = URL(string: redirectUniversalLink), let domainURL = URL(string: domain) else { + return VerifyContext( + origin: domain, + validation: .invalid + ) + } + + let redirectHost = redirectURL.host?.lowercased() ?? "" + let domainHost = domainURL.host?.lowercased() ?? "" + + if redirectHost.isEmpty || domainHost.isEmpty { + return VerifyContext( + origin: domain, + validation: .invalid + ) + } + + if redirectHost.hasSuffix(domainHost) && (redirectHost == domainHost || redirectHost.hasSuffix("." + domainHost)) { + return VerifyContext( + origin: domain, + validation: .valid + ) + } else { + return VerifyContext( + origin: domain, + validation: .invalid + ) + } + } } diff --git a/Tests/VerifyTests/VerifyContextFactoryTests.swift b/Tests/VerifyTests/VerifyContextFactoryTests.swift index ac540cc0e..2806b10c3 100644 --- a/Tests/VerifyTests/VerifyContextFactoryTests.swift +++ b/Tests/VerifyTests/VerifyContextFactoryTests.swift @@ -4,35 +4,72 @@ import XCTest class VerifyContextFactoryTests: XCTestCase { - var factory: VerifyContextFactory! - - override func setUp() { - super.setUp() - factory = VerifyContextFactory() - } - - override func tearDown() { - factory = nil - super.tearDown() - } - - func testScamValidation() { - let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true) - XCTAssertEqual(context.validation, .scam) - } - - func testValidOriginAndDomain() { - let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: false) - XCTAssertEqual(context.validation, .valid) - } - - func testInvalidOriginAndDomain() { - let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://different.com", isScam: false) - XCTAssertEqual(context.validation, .invalid) - } - - func testUnknownValidation() { - let context = factory.createVerifyContext(origin: nil, domain: "http://example.com", isScam: false) - XCTAssertEqual(context.validation, .unknown) - } + var factory: VerifyContextFactory! + + override func setUp() { + super.setUp() + factory = VerifyContextFactory() + } + + override func tearDown() { + factory = nil + super.tearDown() + } + + func testScamValidation() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true) + XCTAssertEqual(context.validation, .scam) + } + + func testValidOriginAndDomain() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: false) + XCTAssertEqual(context.validation, .valid) + } + + func testInvalidOriginAndDomain() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://different.com", isScam: false) + XCTAssertEqual(context.validation, .invalid) + } + + func testUnknownValidation() { + let context = factory.createVerifyContext(origin: nil, domain: "http://example.com", isScam: false) + XCTAssertEqual(context.validation, .unknown) + } + + // tests for createVerifyContextForLinkMode + + func testValidUniversalLink() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "https://www.example.com/universallink", domain: "https://example.com") + XCTAssertEqual(context.validation, .valid) + } + + func testInvalidUniversalLink() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "https://www.invalid.com/universallink", domain: "https://example.com") + XCTAssertEqual(context.validation, .invalid) + } + + func testInvalidUniversalLinkFormat() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "invalidurl", domain: "https://example.com") + XCTAssertEqual(context.validation, .invalid) + } + + func testInvalidDomainFormat() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "https://www.example.com/universallink", domain: "invalidurl") + XCTAssertEqual(context.validation, .invalid) + } + + func testSubdomainMatch() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "https://sub.example.com/universallink", domain: "https://example.com") + XCTAssertEqual(context.validation, .valid) + } + + func testUppercaseDomainMatch() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "https://WWW.EXAMPLE.COM/universallink", domain: "https://example.com") + XCTAssertEqual(context.validation, .valid) + } + + func testEmptyHost() { + let context = factory.createVerifyContextForLinkMode(redirectUniversalLink: "https://", domain: "https://example.com") + XCTAssertEqual(context.validation, .invalid) } +} From ad4820c45af858461eccaab871f530bef7e7d165 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 07:49:44 +0200 Subject: [PATCH 590/814] update apps integration --- Example/DApp/Modules/Sign/SignPresenter.swift | 7 +++++-- Example/DApp/SceneDelegate.swift | 4 ++-- .../ApplicationLayer/ConfigurationService.swift | 2 +- .../WalletApp/ApplicationLayer/SceneDelegate.swift | 2 +- .../Auth/Link/LinkAuthRequester.swift | 11 +++++++++++ 5 files changed, 20 insertions(+), 6 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index dba7a45c1..c1c8e823e 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -113,7 +113,10 @@ final class SignPresenter: ObservableObject { Task { do { - try await Sign.instance.authenticateLinkMode(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://lab.web3modal.com/wallet") + if let pairingUri = try await Sign.instance.authenticate(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://lab.web3modal.com/wallet") { + walletConnectUri = pairingUri + router.presentNewPairing(walletConnectUri: walletConnectUri!) + } } catch { AlertPresenter.present(message: error.localizedDescription, type: .error) } @@ -230,7 +233,7 @@ extension SignPresenter: SceneViewModel {} // MARK: - Authenticate request stub extension AuthRequestParams { static func stub( - domain: String = "app.web3inbox", + domain: String = "lab.web3modal.com", chains: [String] = ["eip155:1", "eip155:137"], nonce: String = "32891756", uri: String = "https://app.web3inbox.com/login", diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 9bf9fba79..4e7cdf299 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -33,14 +33,14 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) - Sign.configure(crypto: DefaultCryptoProvider(), supportLinkMode: true) + Sign.configure(crypto: DefaultCryptoProvider()) let metadata = AppMetadata( name: "Swift Dapp", description: "WalletConnect DApp sample", url: "wallet.connect", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: "https://lab.web3modal.com/dapp") + redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: true) ) Web3Modal.configure( diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index dada2716a..849762592 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: "https://lab.web3modal.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: true) ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index bbd6e4976..56b3baf2e 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -130,7 +130,7 @@ private extension SceneDelegate { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: "https://lab.web3modal.com/wallet") + redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: true) ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index d7dc9358f..2d6846040 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -69,3 +69,14 @@ actor LinkAuthRequester { try AuthenticatedSessionRecapUrnFactory.createNamespaceRecap(methods: methods) } } + +extension LinkAuthRequester.Errors { + var localizedDescription: String { + switch self { + case .invalidChain: + return "The specified blockchain is invalid or unsupported." + case .walletLinkSupportNotProven: + return "Wallet link support has not been proven for the specified operation." + } + } +} From 3dacb6f4935bee08d6215a0018b9dd75c224c52f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 07:55:26 +0200 Subject: [PATCH 591/814] fix verify in dapp --- Example/DApp/SceneDelegate.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 4e7cdf299..4fc881e51 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -38,7 +38,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { let metadata = AppMetadata( name: "Swift Dapp", description: "WalletConnect DApp sample", - url: "wallet.connect", + url: "https://lab.web3modal.com/dapp", icons: ["https://avatars.githubusercontent.com/u/37784886"], redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: true) ) From b987df6b1cbba5bcc975a81bfe8d785fe1f453e1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 08:49:05 +0200 Subject: [PATCH 592/814] add config screen to dapp --- Example/DApp/Constants.swift | 6 +++ .../Modules/Configuration/ConfigModule.swift | 15 ++++++ .../Configuration/ConfigPresenter.swift | 36 +++++++++++++ .../Modules/Configuration/ConfigRouter.swift | 15 ++++++ .../Modules/Configuration/ConfigView.swift | 53 ++++++++++++++++++ Example/DApp/Modules/Sign/SignPresenter.swift | 9 ++++ Example/DApp/Modules/Sign/SignRouter.swift | 4 ++ Example/DApp/Modules/Sign/SignView.swift | 54 +++++++++++-------- Example/DApp/SceneDelegate.swift | 3 +- Example/ExampleApp.xcodeproj/project.pbxproj | 28 ++++++++++ 10 files changed, 199 insertions(+), 24 deletions(-) create mode 100644 Example/DApp/Constants.swift create mode 100644 Example/DApp/Modules/Configuration/ConfigModule.swift create mode 100644 Example/DApp/Modules/Configuration/ConfigPresenter.swift create mode 100644 Example/DApp/Modules/Configuration/ConfigRouter.swift create mode 100644 Example/DApp/Modules/Configuration/ConfigView.swift diff --git a/Example/DApp/Constants.swift b/Example/DApp/Constants.swift new file mode 100644 index 000000000..cf29055d0 --- /dev/null +++ b/Example/DApp/Constants.swift @@ -0,0 +1,6 @@ + +import Foundation + +enum Constants: String { + case groupIdentifier = "group.com.walletconnect.dapp" +} diff --git a/Example/DApp/Modules/Configuration/ConfigModule.swift b/Example/DApp/Modules/Configuration/ConfigModule.swift new file mode 100644 index 000000000..df4037810 --- /dev/null +++ b/Example/DApp/Modules/Configuration/ConfigModule.swift @@ -0,0 +1,15 @@ +import SwiftUI + +final class ConfigModule { + @discardableResult + static func create(app: Application) -> UIViewController { + let router = ConfigRouter(app: app) + let presenter = ConfigPresenter(router: router) + let view = ConfigView().environmentObject(presenter) + + let viewController = SceneViewController(viewModel: presenter, content: view) + router.viewController = viewController + + return viewController + } +} diff --git a/Example/DApp/Modules/Configuration/ConfigPresenter.swift b/Example/DApp/Modules/Configuration/ConfigPresenter.swift new file mode 100644 index 000000000..808673871 --- /dev/null +++ b/Example/DApp/Modules/Configuration/ConfigPresenter.swift @@ -0,0 +1,36 @@ +import UIKit +import Combine + +import WalletConnectSign + +final class ConfigPresenter: ObservableObject, SceneViewModel { + + + private let router: ConfigRouter + + init( + router: ConfigRouter + ) { + defer { setupInitialState() } + self.router = router + } + + func onAppear() { + + } + + private func setupInitialState() { + + } + + func cleanLinkModeSupportedWalletsCache() { + let userDefaults = UserDefaults(suiteName: Constants.groupIdentifier.rawValue)! + let prefix = "com.walletconnect.sdk.linkModeLinks" + let keys = userDefaults.dictionaryRepresentation().keys + + for key in keys where key.hasPrefix(prefix) { + userDefaults.removeObject(forKey: key) + } + } + +} diff --git a/Example/DApp/Modules/Configuration/ConfigRouter.swift b/Example/DApp/Modules/Configuration/ConfigRouter.swift new file mode 100644 index 000000000..c7aaf28e4 --- /dev/null +++ b/Example/DApp/Modules/Configuration/ConfigRouter.swift @@ -0,0 +1,15 @@ + +import Foundation +import UIKit + +import WalletConnectSign + +final class ConfigRouter { + weak var viewController: UIViewController! + + private let app: Application + + init(app: Application) { + self.app = app + } +} diff --git a/Example/DApp/Modules/Configuration/ConfigView.swift b/Example/DApp/Modules/Configuration/ConfigView.swift new file mode 100644 index 000000000..3c20e8441 --- /dev/null +++ b/Example/DApp/Modules/Configuration/ConfigView.swift @@ -0,0 +1,53 @@ +import SwiftUI + +struct ConfigView: View { + @EnvironmentObject var presenter: ConfigPresenter + + var body: some View { + NavigationStack { + ZStack { + Color(red: 25/255, green: 26/255, blue: 26/255) + .ignoresSafeArea() + + ScrollView { + VStack { + Button { + presenter.cleanLinkModeSupportedWalletsCache() + } label: { + HStack { + Spacer() + Text("Clean Link Mode Supported Wallets Cache") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.vertical, 25) + Spacer() + } + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + .padding(.top, 10) + } + .padding(12) + } + .padding(.bottom, 76) + .onAppear { + presenter.onAppear() + } + } + .navigationTitle("Configuration") + .navigationBarTitleDisplayMode(.inline) + .toolbarColorScheme(.dark, for: .navigationBar) + .toolbarBackground(.visible, for: .navigationBar) + .toolbarBackground( + Color(red: 25/255, green: 26/255, blue: 26/255), + for: .navigationBar + ) + } + } +} + +struct ConfigView_Previews: PreviewProvider { + static var previews: some View { + ConfigView() + } +} diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index c1c8e823e..aa69d979d 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -113,16 +113,25 @@ final class SignPresenter: ObservableObject { Task { do { + ActivityIndicatorManager.shared.start() if let pairingUri = try await Sign.instance.authenticate(.stub(methods: ["personal_sign"]), walletUniversalLink: "https://lab.web3modal.com/wallet") { walletConnectUri = pairingUri + ActivityIndicatorManager.shared.stop() router.presentNewPairing(walletConnectUri: walletConnectUri!) } } catch { AlertPresenter.present(message: error.localizedDescription, type: .error) + ActivityIndicatorManager.shared.stop() } } } + @MainActor + func openConfiguration() { + router.openConfig() + } + + @MainActor func disconnect() { if let session { Task { @MainActor in diff --git a/Example/DApp/Modules/Sign/SignRouter.swift b/Example/DApp/Modules/Sign/SignRouter.swift index 9d2ce26d8..6dea21cc2 100644 --- a/Example/DApp/Modules/Sign/SignRouter.swift +++ b/Example/DApp/Modules/Sign/SignRouter.swift @@ -34,4 +34,8 @@ final class SignRouter { func popToRoot() { viewController.popToRoot() } + + func openConfig() { + ConfigModule.create(app: app).push(from: viewController) + } } diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index 04b4036dd..03b4003a9 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -2,25 +2,23 @@ import SwiftUI struct SignView: View { @EnvironmentObject var presenter: SignPresenter - + var body: some View { NavigationStack { ZStack { Color(red: 25/255, green: 26/255, blue: 26/255) .ignoresSafeArea() - + ScrollView { if presenter.accountsDetails.isEmpty { VStack { ForEach(presenter.chains, id: \.name) { chain in networkItem(title: chain.name, icon: chain.name.lowercased(), id: chain.id) } - - Spacer() + Spacer() VStack(spacing: 10) { - Button { presenter.connectWalletWithSessionAuthenticateLinkMode() } label: { @@ -44,7 +42,7 @@ struct SignView: View { .background(Color(red: 95/255, green: 159/255, blue: 248/255)) .cornerRadius(16) } - + Button { presenter.connectWalletWithSessionPropose() } label: { @@ -110,47 +108,47 @@ struct SignView: View { .padding(12) } } - .padding(.bottom, presenter.accountsDetails.isEmpty ? 0 : 76) + .padding(.bottom, presenter.accountsDetails.isEmpty ? 0 : 76) .onAppear { presenter.onAppear() } - + if !presenter.accountsDetails.isEmpty { VStack { Spacer() - + Button { presenter.disconnect() } label: { ZStack { RoundedRectangle(cornerRadius: 16) .fill(.white.opacity(0.02)) - + HStack { ZStack { Circle() .fill(.white.opacity(0.05)) .frame(width: 32, height: 32) - + Circle() .fill(.white.opacity(0.1)) .frame(width: 30, height: 30) - + Image("exit") .resizable() .frame(width: 14, height: 14) } - + Text("Disconnect") .font(.system(size: 16, weight: .medium)) .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - + Spacer() } .padding(.horizontal, 12) } .frame(height: 56) - + } .padding(20) } @@ -164,22 +162,32 @@ struct SignView: View { Color(red: 25/255, green: 26/255, blue: 26/255), for: .navigationBar ) + .toolbar { + ToolbarItem(placement: .navigationBarTrailing) { + Button(action: { + presenter.openConfiguration() + }) { + Image(systemName: "gearshape") + .foregroundColor(.white) + } + } + } .alert(presenter.errorMessage, isPresented: $presenter.showError) { Button("OK", role: .cancel) {} } } } - + private func networkItem(title: String, icon: String, id: String) -> some View { ZStack { RoundedRectangle(cornerRadius: 16) .fill(Color(red: 30/255, green: 31/255, blue: 31/255)) - + HStack(spacing: 10) { Image(icon == "eip155" ? "ethereum" : icon) .resizable() .frame(width: 40, height: 40) - + VStack(alignment: .leading, spacing: 5) { HStack { Text(title) @@ -187,23 +195,23 @@ struct SignView: View { .truncationMode(.middle) .font(.system(size: 16, weight: .medium)) .foregroundColor(Color(red: 228/255, green: 231/255, blue: 231/255)) - + Spacer() } - + HStack { Text(id) .lineLimit(1) .truncationMode(.middle) .font(.system(size: 13, weight: .regular)) .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) - + Spacer() } } - + Spacer() - + if !presenter.accountsDetails.isEmpty { Image(systemName: "chevron.right") .foregroundColor(Color(red: 0.58, green: 0.62, blue: 0.62)) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 4fc881e51..8eb8c3bc8 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -6,6 +6,7 @@ import WalletConnectRelay import WalletConnectNetworking import Combine + class SceneDelegate: UIResponder, UIWindowSceneDelegate { var window: UIWindow? private var publishers = Set() @@ -29,7 +30,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { Networking.configure( - groupIdentifier: "group.com.walletconnect.dapp", + groupIdentifier: Constants.groupIdentifier.rawValue, projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 4550f7cbd..0ec6a24f9 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -19,6 +19,11 @@ 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */ = {isa = PBXBuildFile; productRef = 8448F1D327E4726F0000B866 /* WalletConnect */; }; 844AD55F2B1497270062E123 /* Web3Wallet in Frameworks */ = {isa = PBXBuildFile; productRef = 844AD55E2B1497270062E123 /* Web3Wallet */; }; 845B8D8C2934B36C0084A966 /* Account.swift in Sources */ = {isa = PBXBuildFile; fileRef = 845B8D8B2934B36C0084A966 /* Account.swift */; }; + 846E359F2C00654F00E63DF4 /* ConfigModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E359E2C00654F00E63DF4 /* ConfigModule.swift */; }; + 846E35A22C0065AD00E63DF4 /* ConfigRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A12C0065AD00E63DF4 /* ConfigRouter.swift */; }; + 846E35A42C0065B600E63DF4 /* ConfigPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A32C0065B600E63DF4 /* ConfigPresenter.swift */; }; + 846E35A62C0065C100E63DF4 /* ConfigView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A52C0065C100E63DF4 /* ConfigView.swift */; }; + 846E35A82C006C5600E63DF4 /* Constants.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A72C006C5600E63DF4 /* Constants.swift */; }; 847BD1D62989492500076C90 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D12989492500076C90 /* MainViewController.swift */; }; 847BD1D82989492500076C90 /* MainModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D32989492500076C90 /* MainModule.swift */; }; 847BD1D92989492500076C90 /* MainPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D42989492500076C90 /* MainPresenter.swift */; }; @@ -397,6 +402,11 @@ 845AA7D929BA1EBA00F33739 /* IntegrationTests.xctestplan */ = {isa = PBXFileReference; lastKnownFileType = text; name = IntegrationTests.xctestplan; path = ExampleApp.xcodeproj/IntegrationTests.xctestplan; sourceTree = ""; }; 845AA7DC29BB424800F33739 /* SmokeTests.xctestplan */ = {isa = PBXFileReference; lastKnownFileType = text; path = SmokeTests.xctestplan; sourceTree = ""; }; 845B8D8B2934B36C0084A966 /* Account.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Account.swift; sourceTree = ""; }; + 846E359E2C00654F00E63DF4 /* ConfigModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConfigModule.swift; sourceTree = ""; }; + 846E35A12C0065AD00E63DF4 /* ConfigRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConfigRouter.swift; sourceTree = ""; }; + 846E35A32C0065B600E63DF4 /* ConfigPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConfigPresenter.swift; sourceTree = ""; }; + 846E35A52C0065C100E63DF4 /* ConfigView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConfigView.swift; sourceTree = ""; }; + 846E35A72C006C5600E63DF4 /* Constants.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Constants.swift; sourceTree = ""; }; 847BD1D12989492500076C90 /* MainViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MainViewController.swift; sourceTree = ""; }; 847BD1D32989492500076C90 /* MainModule.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MainModule.swift; sourceTree = ""; }; 847BD1D42989492500076C90 /* MainPresenter.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MainPresenter.swift; sourceTree = ""; }; @@ -841,6 +851,17 @@ path = RelayIntegrationTests; sourceTree = ""; }; + 846E35A02C00655500E63DF4 /* Configuration */ = { + isa = PBXGroup; + children = ( + 846E359E2C00654F00E63DF4 /* ConfigModule.swift */, + 846E35A52C0065C100E63DF4 /* ConfigView.swift */, + 846E35A32C0065B600E63DF4 /* ConfigPresenter.swift */, + 846E35A12C0065AD00E63DF4 /* ConfigRouter.swift */, + ); + path = Configuration; + sourceTree = ""; + }; 847BD1DB2989493F00076C90 /* Main */ = { isa = PBXGroup; children = ( @@ -949,6 +970,7 @@ A5BB7FAB28B6AA7100707FC6 /* Common */, 84CE641E27981DED00142511 /* AppDelegate.swift */, 84CE642027981DED00142511 /* SceneDelegate.swift */, + 846E35A72C006C5600E63DF4 /* Constants.swift */, 84CE642727981DF000142511 /* Assets.xcassets */, 84CE642927981DF000142511 /* LaunchScreen.storyboard */, 84CE642C27981DF000142511 /* Info.plist */, @@ -1787,6 +1809,7 @@ isa = PBXGroup; children = ( C5B4C4C52AF12C2900B4274A /* Sign */, + 846E35A02C00655500E63DF4 /* Configuration */, ); path = Modules; sourceTree = ""; @@ -2235,6 +2258,8 @@ 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */, C5BE01E32AF696540064FC88 /* SceneViewController.swift in Sources */, A5A8E47D293A1CFE00FEB97D /* DefaultSocketFactory.swift in Sources */, + 846E35A22C0065AD00E63DF4 /* ConfigRouter.swift in Sources */, + 846E359F2C00654F00E63DF4 /* ConfigModule.swift in Sources */, C5BE01E52AF697470064FC88 /* Color.swift in Sources */, A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, @@ -2250,13 +2275,16 @@ C5BE01F82AF6CB270064FC88 /* SignInteractor.swift in Sources */, 8486EDD12B4F2DC1008E53C3 /* AlertPresenter.swift in Sources */, C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */, + 846E35A42C0065B600E63DF4 /* ConfigPresenter.swift in Sources */, 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */, C5BE02022AF774CB0064FC88 /* NewPairingInteractor.swift in Sources */, C5BE021D2AF79B9A0064FC88 /* SessionAccountInteractor.swift in Sources */, A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, + 846E35A62C0065C100E63DF4 /* ConfigView.swift in Sources */, C5BE01FB2AF6CB270064FC88 /* SignRouter.swift in Sources */, C5BE01F72AF6CB250064FC88 /* SignModule.swift in Sources */, C5BE01FA2AF6CB270064FC88 /* SignPresenter.swift in Sources */, + 846E35A82C006C5600E63DF4 /* Constants.swift in Sources */, ); runOnlyForDeploymentPostprocessing = 0; }; From 7f6f11cc6c86e0d1fba3ef25b77b1ce322f3a545 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 10:16:24 +0200 Subject: [PATCH 593/814] savepoint --- .../ApproveSessionAuthenticateDispatcher.swift | 4 ++-- .../LinkAndRelayDispatchers/WalletErrorResponder.swift | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift index e6a055902..65eaf047a 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/ApproveSessionAuthenticateDispatcher.swift @@ -36,11 +36,11 @@ actor ApproveSessionAuthenticateDispatcher { } func respondError(requestId: RPCID) async throws { - let transportType = try util.getHistoryRecord(requestId: requestId).transportType + let transportType = try util.getHistoryRecord(requestId: requestId).transportType ?? .relay switch transportType { - case .relay, .none: + case .relay: return try await sessionAuthenticateResponder.respondError(requestId: requestId) case .linkMode: return try await linkSessionAuthenticateResponder.respondError(requestId: requestId) diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index 8d0ade6bf..e965ebffb 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -29,7 +29,7 @@ actor WalletErrorResponder { func respondError(_ error: AuthError, requestId: RPCID) async throws -> String? { - let transportType = try getHistoryRecord(requestId: requestId).transportType + let transportType = try getHistoryRecord(requestId: requestId).transportType ?? .relay let authRequestParams = try getAuthRequestParams(requestId: requestId) let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) @@ -38,7 +38,7 @@ actor WalletErrorResponder { let type1EnvelopeKey = keys.publicKey.rawRepresentation switch transportType { - case .relay, .none: + case .relay: try await respondErrorRelay(error, requestId: requestId, topic: topic, type1EnvelopeKey: type1EnvelopeKey) return nil case .linkMode: From b20eb8bd8719ad19fc8ea53ccdcb3b6d9880a8c9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 12:52:31 +0200 Subject: [PATCH 594/814] add appmetadata init validation --- .../Types/AppMetadata.swift | 18 ++++++++-- .../Auth/Link/LinkEnvelopesDispatcher.swift | 4 +-- .../AppMetadataTests.swift | 33 +++++++++++++++++++ 3 files changed, 51 insertions(+), 4 deletions(-) create mode 100644 Tests/WalletConnectPairingTests/AppMetadataTests.swift diff --git a/Sources/WalletConnectPairing/Types/AppMetadata.swift b/Sources/WalletConnectPairing/Types/AppMetadata.swift index 5362b94e2..f71fe44ae 100644 --- a/Sources/WalletConnectPairing/Types/AppMetadata.swift +++ b/Sources/WalletConnectPairing/Types/AppMetadata.swift @@ -14,6 +14,7 @@ public struct AppMetadata: Codable, Equatable { public struct Redirect: Codable, Equatable { enum Errors: Error { case invalidLinkModeUniversalLink + case invalidUniversalLinkURL } /// Native deeplink URL string. public let native: String? @@ -30,11 +31,24 @@ public struct AppMetadata: Codable, Equatable { - native: Native deeplink URL string. - universal: Universal link URL string. */ - public init(native: String, universal: String?, linkMode: Bool = false) { + public init(native: String, universal: String?, linkMode: Bool = false) throws { + if linkMode && universal == nil { + throw Errors.invalidLinkModeUniversalLink + } + + if let universal = universal, !Redirect.isValidURL(universal) { + throw Errors.invalidUniversalLinkURL + } + self.native = native self.universal = universal self.linkMode = linkMode } + + private static func isValidURL(_ urlString: String) -> Bool { + let regex = "^(https?|ftp)://[^\\s/$.?#].[^\\s]*$|^www\\.[^\\s/$.?#].[^\\s]*$" + return NSPredicate(format: "SELF MATCHES %@", regex).evaluate(with: urlString) + } } /// The name of the app. @@ -85,7 +99,7 @@ public extension AppMetadata { description: "A protocol to connect blockchain wallets to dapps.", url: "https://walletconnect.com/", icons: [], - redirect: AppMetadata.Redirect(native: "", universal: nil) + redirect: try! AppMetadata.Redirect(native: "", universal: nil) ) } } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 695e1d8c8..77d955d89 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -43,7 +43,7 @@ class LinkEnvelopesDispatcher { throw Errors.invalidURL } - guard let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_envelope" })?.value else { + guard let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_ev" })?.value else { throw Errors.envelopeNotFound } guard let topic = components.queryItems?.first(where: { $0.name == "topic" })?.value else { @@ -95,7 +95,7 @@ class LinkEnvelopesDispatcher { guard var components = URLComponents(string: peerUniversalLink) else { throw URLError(.badURL) } - components.queryItems = [URLQueryItem(name: "wc_envelope", value: envelope), URLQueryItem(name: "topic", value: topic)] + components.queryItems = [URLQueryItem(name: "wc_ev", value: envelope), URLQueryItem(name: "topic", value: topic)] guard let finalURL = components.url else { throw URLError(.badURL) } return finalURL diff --git a/Tests/WalletConnectPairingTests/AppMetadataTests.swift b/Tests/WalletConnectPairingTests/AppMetadataTests.swift new file mode 100644 index 000000000..64dacfa81 --- /dev/null +++ b/Tests/WalletConnectPairingTests/AppMetadataTests.swift @@ -0,0 +1,33 @@ +import XCTest +@testable import WalletConnectPairing + +final class RedirectTests: XCTestCase { + + func testInitThrowsErrorWhenLinkModeIsTrueAndUniversalIsNil() { + XCTAssertThrowsError(try AppMetadata.Redirect(native: "nativeURL", universal: nil, linkMode: true)) { error in + XCTAssertEqual(error as? AppMetadata.Redirect.Errors, .invalidLinkModeUniversalLink) + } + } + + func testInitThrowsErrorWhenUniversalIsInvalidURL() { + XCTAssertThrowsError(try AppMetadata.Redirect(native: "nativeURL", universal: "invalid-url", linkMode: false)) { error in + XCTAssertEqual(error as? AppMetadata.Redirect.Errors, .invalidUniversalLinkURL) + } + } + + func testInitSucceedsWhenUniversalIsValidURLAndLinkModeIsTrue() { + XCTAssertNoThrow(try AppMetadata.Redirect(native: "nativeURL", universal: "https://valid.url", linkMode: true)) + } + + func testInitSucceedsWhenUniversalIsValidURLAndLinkModeIsFalse() { + XCTAssertNoThrow(try AppMetadata.Redirect(native: "nativeURL", universal: "https://valid.url", linkMode: false)) + } + + func testInitSucceedsWhenUniversalIsValidURLWithWWWAndLinkModeIsFalse() { + XCTAssertNoThrow(try AppMetadata.Redirect(native: "nativeURL", universal: "www.valid.com", linkMode: false)) + } + + func testInitSucceedsWhenLinkModeIsFalseAndUniversalIsNil() { + XCTAssertNoThrow(try AppMetadata.Redirect(native: "nativeURL", universal: nil, linkMode: false)) + } +} From a15c615890b5216313f9647528c6293849025b12 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 14:05:57 +0200 Subject: [PATCH 595/814] fix integration tests --- .../Sign/SignClientTests.swift | 22 +++++++++---------- Example/IntegrationTests/Stubs/Stubs.swift | 2 +- .../Web3Wallet/XPlatformW3WTests.swift | 2 +- .../Client/Wallet/NotifyConfig.swift | 2 +- 4 files changed, 14 insertions(+), 14 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index c1dd35c22..162c8b288 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -24,7 +24,7 @@ final class SignClientTests: XCTestCase { let walletLinkModeUniversalLink = "https://test" - static private func makeClients(name: String, linkModeUniversalLink: String? = UUID().uuidString, supportLinkMode: Bool = false) -> (PairingClient, SignClient, RuntimeKeyValueStorage, RelayClient) { + static private func makeClients(name: String, linkModeUniversalLink: String? = "https://x.com", supportLinkMode: Bool = false) -> (PairingClient, SignClient, RuntimeKeyValueStorage, RelayClient) { let logger = ConsoleLogger(prefix: name, loggingLevel: .debug) let keychain = KeychainStorageMock() let keyValueStorage = RuntimeKeyValueStorage() @@ -50,7 +50,7 @@ final class SignClientTests: XCTestCase { keychainStorage: keychain, networkingClient: networkingClient ) - let metadata = AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: linkModeUniversalLink, linkMode: supportLinkMode)) + let metadata = AppMetadata(name: name, description: "", url: "", icons: [""], redirect: try! AppMetadata.Redirect(native: "", universal: linkModeUniversalLink, linkMode: supportLinkMode)) let client = SignClientFactory.create( metadata: metadata, @@ -485,7 +485,7 @@ final class SignClientTests: XCTestCase { requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata.stub()), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) ) let sessionNamespaces = try AutoNamespaces.build( @@ -554,11 +554,11 @@ final class SignClientTests: XCTestCase { let sessionProposal = Session.Proposal( id: "", pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + proposer: AppMetadata.stub(), requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata.stub()), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) ) let sessionNamespaces = try AutoNamespaces.build( @@ -613,11 +613,11 @@ final class SignClientTests: XCTestCase { let sessionProposal = Session.Proposal( id: "", pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + proposer: AppMetadata.stub(), requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata.stub()), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) ) let sessionNamespaces = try AutoNamespaces.build( @@ -680,11 +680,11 @@ final class SignClientTests: XCTestCase { let sessionProposal = Session.Proposal( id: "", pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + proposer: AppMetadata.stub(), requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata.stub()), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) ) do { @@ -744,11 +744,11 @@ final class SignClientTests: XCTestCase { let sessionProposal = Session.Proposal( id: "", pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + proposer: AppMetadata.stub(), requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata.stub()), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) ) do { diff --git a/Example/IntegrationTests/Stubs/Stubs.swift b/Example/IntegrationTests/Stubs/Stubs.swift index ac61de16c..ec330c0b8 100644 --- a/Example/IntegrationTests/Stubs/Stubs.swift +++ b/Example/IntegrationTests/Stubs/Stubs.swift @@ -30,7 +30,7 @@ extension AppMetadata { description: "WalletConnectSwift", url: "https://walletconnect.com", icons: [], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: nil) + redirect: try! AppMetadata.Redirect(native: "wcdapp://", universal: nil) ) } } diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index 537668f34..8420a3a64 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -49,7 +49,7 @@ final class XPlatformW3WTests: XCTestCase { networkingClient: networkingClient) let signClient = SignClientFactory.create( - metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: AppMetadata.Redirect(native: "", universal: nil)), + metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: try! AppMetadata.Redirect(native: "", universal: nil)), logger: signLogger, keyValueStorage: keyValueStorage, keychainStorage: keychain, diff --git a/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift b/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift index 19c4333ac..8449c4a52 100644 --- a/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift +++ b/Sources/WalletConnectNotify/Client/Wallet/NotifyConfig.swift @@ -25,7 +25,7 @@ struct NotifyConfig: Codable { description: description, url: appDomain, icons: [image_url?.sm, image_url?.md, image_url?.lg].compactMap { $0 }, - redirect: AppMetadata.Redirect(native: "", universal: nil) + redirect: try! AppMetadata.Redirect(native: "", universal: nil) ) } } From d81deb1dd34cec15779c68609e69188af60d6f32 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 24 May 2024 14:09:40 +0200 Subject: [PATCH 596/814] fix builds --- Example/DApp/SceneDelegate.swift | 2 +- Example/WalletApp/ApplicationLayer/ConfigurationService.swift | 2 +- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 2 +- Sources/WalletConnectModal/Modal/Modal+Previews.swift | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 8eb8c3bc8..1a1f7ebba 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -41,7 +41,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { description: "WalletConnect DApp sample", url: "https://lab.web3modal.com/dapp", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: true) + redirect: try! AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: true) ) Web3Modal.configure( diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 849762592..2eda07ec7 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -21,7 +21,7 @@ final class ConfigurationService { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: true) + redirect: try! AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: true) ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 56b3baf2e..b384d1282 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -130,7 +130,7 @@ private extension SceneDelegate { description: "wallet description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: true) + redirect: try! AppMetadata.Redirect(native: "walletapp://", universal: "https://lab.web3modal.com/wallet", linkMode: true) ) Web3Wallet.configure(metadata: metadata, crypto: DefaultCryptoProvider(), environment: BuildConfiguration.shared.apnsEnvironment) diff --git a/Sources/WalletConnectModal/Modal/Modal+Previews.swift b/Sources/WalletConnectModal/Modal/Modal+Previews.swift index 12ee8c5c0..836c3cd75 100644 --- a/Sources/WalletConnectModal/Modal/Modal+Previews.swift +++ b/Sources/WalletConnectModal/Modal/Modal+Previews.swift @@ -39,7 +39,7 @@ struct ModalContainerView_Previews: PreviewProvider { description: "Showcase description", url: "example.wallet", icons: ["https://avatars.githubusercontent.com/u/37784886"], - redirect: AppMetadata.Redirect(native: "showcase://", universal: nil) + redirect: try! AppMetadata.Redirect(native: "showcase://", universal: nil) ) Networking.configure(groupIdentifier: "group.com.walletconnect.sdk", projectId: projectId, socketFactory: WebSocketFactoryMock()) From 423eb35697865ced7be634b0cadec15bd6ef4ccf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 May 2024 12:09:49 +0200 Subject: [PATCH 597/814] fix redirect --- .../Sign/SessionAccount/SessionAccountPresenter.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 625e0c858..31920ce46 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -53,9 +53,9 @@ final class SessionAccountPresenter: ObservableObject { lastRequest = request ActivityIndicatorManager.shared.stop() requesting = true -// DispatchQueue.main.async { [weak self] in -// self?.openWallet() -// } + DispatchQueue.main.async { [weak self] in + self?.openWallet() + } } catch { ActivityIndicatorManager.shared.stop() requesting = false From 427ef24ee5e6de08b83899f2fccc6123071e1350 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 May 2024 12:45:15 +0200 Subject: [PATCH 598/814] cleanup --- Example/DApp/SceneDelegate.swift | 2 +- .../ApplicationLayer/SceneDelegate.swift | 3 +- .../AuthRequest/AuthRequestPresenter.swift | 15 ++--- .../Wallet/AuthRequest/AuthRequestView.swift | 2 +- .../PushMessages/SubscriptionPresenter.swift | 12 ++-- .../Serialiser/Envelope.swift | 6 +- .../Auth/Link/LinkEnvelopesDispatcher.swift | 5 +- .../LinkSessionRequester.swift | 38 +++++++++++ .../SessionRequestDispatcher.swift | 67 ------------------- .../SessionRequester.swift | 36 ++++++++++ 10 files changed, 94 insertions(+), 92 deletions(-) create mode 100644 Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift create mode 100644 Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 1a1f7ebba..6f28b76aa 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -22,7 +22,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { do { try Sign.instance.dispatchEnvelope(url.absoluteString) } catch { - print("🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨") + print(error) } } diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index b384d1282..41fe1d8e9 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -23,10 +23,9 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio return } do { - print("🔵🔵🔵🔵🔵🔵🔵\(url.absoluteString)") try Web3Wallet.instance.dispatchEnvelope(url.absoluteString) } catch { - print("🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨") + print(error) } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index bc16c21c8..ce57ddd3d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -53,7 +53,7 @@ final class AuthRequestPresenter: ObservableObject { } @MainActor - func approve() async { + func signMulti() async { do { ActivityIndicatorManager.shared.start() @@ -61,14 +61,13 @@ final class AuthRequestPresenter: ObservableObject { _ = try await Web3Wallet.instance.approveSessionAuthenticate(requestId: request.id, auths: auths) ActivityIndicatorManager.shared.stop() - router.dismiss() /* Redirect */ -// if let uri = request.requester.redirect?.native { -// WalletConnectRouter.goBack(uri: uri) -// router.dismiss() -// } else { -// showSignedSheet.toggle() -// } + if let uri = request.requester.redirect?.native { + WalletConnectRouter.goBack(uri: uri) + router.dismiss() + } else { + showSignedSheet.toggle() + } } catch { ActivityIndicatorManager.shared.stop() diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift index 73ce87bc6..d47b07fa3 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestView.swift @@ -226,7 +226,7 @@ struct AuthRequestView: View { private func allowButton() -> some View { Button { Task(priority: .userInitiated) { await - presenter.approve() + presenter.signMulti() } } label: { Text(presenter.validationStatus == .scam ? "Proceed anyway" : "Sign Multi") diff --git a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift index 78ec0b532..2f9bb1a21 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/PushMessages/SubscriptionPresenter.swift @@ -38,12 +38,12 @@ final class SubscriptionPresenter: ObservableObject { } private func setUpMessagesRefresh() { -// Timer.publish(every: 10.0, on: .main, in: .default) -// .autoconnect() -// .sink(receiveValue: { [weak self] _ in -// guard let self = self else { return } -// self.pushMessages = self.interactor.getPushMessages() -// }).store(in: &disposeBag) + Timer.publish(every: 10.0, on: .main, in: .default) + .autoconnect() + .sink(receiveValue: { [weak self] _ in + guard let self = self else { return } + self.pushMessages = self.interactor.getPushMessages() + }).store(in: &disposeBag) } func deletePushMessage(at indexSet: IndexSet) { diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index ad4554c4c..bcaa2c051 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -19,7 +19,7 @@ public struct Envelope: Equatable { /// pk = public key (32 bytes) /// iv = initialization vector (12 bytes) /// ct = ciphertext (N bytes) - /// sealbox: in case of envelope type 0, 1, 3 and 4: = iv + ct + tag, in case of type 2 - raw data representation of a json object + /// sealbox: in case of envelope type 0, 1: = iv + ct + tag, in case of type 2 - raw data representation of a json object /// type0: tp + sealbox /// type1: tp + pk + sealbox init(_ codingType: CodingType, envelopeString: String) throws { @@ -34,10 +34,10 @@ public struct Envelope: Equatable { guard let envelopeTypeByte = envelopeData.subdata(in: 0..<1).first else { throw Errors.malformedEnvelope } - let pubKey: Data? = (envelopeTypeByte == 1 || envelopeTypeByte == 4) && envelopeData.count >= 33 ? envelopeData.subdata(in: 1..<33) : nil + let pubKey: Data? = (envelopeTypeByte == 1) && envelopeData.count >= 33 ? envelopeData.subdata(in: 1..<33) : nil self.type = try EnvelopeType(representingByte: envelopeTypeByte, pubKey: pubKey) - let startIndex = (envelopeTypeByte == 1 || envelopeTypeByte == 4) ? 33 : 1 + let startIndex = (envelopeTypeByte == 1) ? 33 : 1 self.sealbox = envelopeData.subdata(in: startIndex.. String? { + logger.debug("will request on session topic: \(request.topic)") + guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { + logger.debug("Could not find session for topic \(request.topic)") + throw WalletConnectError.noSessionMatchingTopic(request.topic) + } + guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + logger.debug("Invalid namespaces") + throw WalletConnectError.invalidPermissions + } + // it's safe to force unwrap because redirect was used during session creation before + let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! + let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) + let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) + let ttl = try request.calculateTtl() + let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) + let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) + return try await linkEnvelopesDispatcher.request(topic: session.topic, request: rpcRequest, peerUniversalLink: peerUniversalLink, envelopeType: .type0) + } +} diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift index 4ac29bba2..a017455d3 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -39,72 +39,5 @@ class SessionRequestDispatcher { } -class SessionRequester { - private let sessionStore: WCSessionStorage - private let networkingInteractor: NetworkInteracting - private let logger: ConsoleLogging - - init( - sessionStore: WCSessionStorage, - networkingInteractor: NetworkInteracting, - logger: ConsoleLogging - ) { - self.sessionStore = sessionStore - self.networkingInteractor = networkingInteractor - self.logger = logger - } - - func request(_ request: Request) async throws { - logger.debug("will request on session topic: \(request.topic)") - guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { - logger.debug("Could not find session for topic \(request.topic)") - return - } - guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { - logger.debug("Invalid namespaces") - throw WalletConnectError.invalidPermissions - } - let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) - let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) - let ttl = try request.calculateTtl() - let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) - let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) - try await networkingInteractor.request(rpcRequest, topic: request.topic, protocolMethod: SessionRequestProtocolMethod()) - } -} -class LinkSessionRequester { - private let sessionStore: WCSessionStorage - private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher - private let logger: ConsoleLogging - - init( - sessionStore: WCSessionStorage, - linkEnvelopesDispatcher: LinkEnvelopesDispatcher, - logger: ConsoleLogging - ) { - self.sessionStore = sessionStore - self.linkEnvelopesDispatcher = linkEnvelopesDispatcher - self.logger = logger - } - func request(_ request: Request) async throws -> String? { - logger.debug("will request on session topic: \(request.topic)") - guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { - logger.debug("Could not find session for topic \(request.topic)") - throw WalletConnectError.noSessionMatchingTopic(request.topic) - } - guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { - logger.debug("Invalid namespaces") - throw WalletConnectError.invalidPermissions - } - // it's safe to force unwrap because redirect was used during session creation before - let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal! - let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) - let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) - let ttl = try request.calculateTtl() - let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) - let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) - return try await linkEnvelopesDispatcher.request(topic: session.topic, request: rpcRequest, peerUniversalLink: peerUniversalLink, envelopeType: .type0) - } -} diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift new file mode 100644 index 000000000..ba253fba6 --- /dev/null +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift @@ -0,0 +1,36 @@ + +import Foundation + +class SessionRequester { + private let sessionStore: WCSessionStorage + private let networkingInteractor: NetworkInteracting + private let logger: ConsoleLogging + + init( + sessionStore: WCSessionStorage, + networkingInteractor: NetworkInteracting, + logger: ConsoleLogging + ) { + self.sessionStore = sessionStore + self.networkingInteractor = networkingInteractor + self.logger = logger + } + + func request(_ request: Request) async throws { + logger.debug("will request on session topic: \(request.topic)") + guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { + logger.debug("Could not find session for topic \(request.topic)") + return + } + guard session.hasPermission(forMethod: request.method, onChain: request.chainId) else { + logger.debug("Invalid namespaces") + throw WalletConnectError.invalidPermissions + } + let chainRequest = SessionType.RequestParams.Request(method: request.method, params: request.params, expiryTimestamp: request.expiryTimestamp) + let sessionRequestParams = SessionType.RequestParams(request: chainRequest, chainId: request.chainId) + let ttl = try request.calculateTtl() + let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) + let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) + try await networkingInteractor.request(rpcRequest, topic: request.topic, protocolMethod: SessionRequestProtocolMethod()) + } +} From c66475900ff57fc52b932e0c8038348064c8527a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 May 2024 13:00:44 +0200 Subject: [PATCH 599/814] remove unused class --- Sources/Auth/AuthDecryptionService.swift | 47 ------------------------ 1 file changed, 47 deletions(-) delete mode 100644 Sources/Auth/AuthDecryptionService.swift diff --git a/Sources/Auth/AuthDecryptionService.swift b/Sources/Auth/AuthDecryptionService.swift deleted file mode 100644 index 49f9b34d2..000000000 --- a/Sources/Auth/AuthDecryptionService.swift +++ /dev/null @@ -1,47 +0,0 @@ -import Foundation - -public class AuthDecryptionService { - enum Errors: Error { - case couldNotInitialiseDefaults - case couldNotDecodeTypeFromCiphertext - } - private let serializer: Serializing - private let pairingStorage: PairingStorage - - public init(groupIdentifier: String) throws { - let keychainStorage = GroupKeychainStorage(serviceIdentifier: groupIdentifier) - let kms = KeyManagementService(keychain: keychainStorage) - self.serializer = Serializer(kms: kms, logger: ConsoleLogger(prefix: "🔐", loggingLevel: .off)) - guard let defaults = UserDefaults(suiteName: groupIdentifier) else { - throw Errors.couldNotInitialiseDefaults - } - pairingStorage = PairingStorage(storage: SequenceStore(store: .init(defaults: defaults, identifier: PairStorageIdentifiers.pairings.rawValue))) - } - - public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthRequest { - let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded(ciphertext)) - setPairingMetadata(rpcRequest: rpcRequest, topic: topic) - if let params = try rpcRequest.params?.get(Auth_RequestParams.self), - let id = rpcRequest.id { - let authRequest = AuthRequest(id: id, topic: topic, payload: params.payloadParams, requester: params.requester.metadata) - return authRequest - } else { - throw Errors.couldNotDecodeTypeFromCiphertext - } - } - - public func getMetadata(topic: String) -> AppMetadata? { - pairingStorage.getPairing(forTopic: topic)?.peerMetadata - } - - private func setPairingMetadata(rpcRequest: RPCRequest, topic: String) { - guard var pairing = pairingStorage.getPairing(forTopic: topic), - pairing.peerMetadata == nil, - let peerMetadata = try? rpcRequest.params?.get(Auth_RequestParams.self).requester.metadata - else { return } - - pairing.updatePeerMetadata(peerMetadata) - pairingStorage.setPairing(pairing) - } -} - From d820c4a849c4b56de7b7651092141fb039d23dfe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 May 2024 14:03:36 +0200 Subject: [PATCH 600/814] fix kms tests --- Tests/WalletConnectKMSTests/EnvelopeTests.swift | 6 +++--- Tests/WalletConnectKMSTests/SerialiserTests.swift | 12 ++++++------ 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/Tests/WalletConnectKMSTests/EnvelopeTests.swift b/Tests/WalletConnectKMSTests/EnvelopeTests.swift index 80449160c..95abc1ae8 100644 --- a/Tests/WalletConnectKMSTests/EnvelopeTests.swift +++ b/Tests/WalletConnectKMSTests/EnvelopeTests.swift @@ -6,16 +6,16 @@ final class EnvelopeTests: XCTestCase { let sealbox = Data(base64Encoded: "V2FsbGV0Q29ubmVjdA==")! func testSerialisation() { - let envelope = Envelope(type: .type1(pubKey: pubKey), sealbox: sealbox) + let envelope = Envelope(type: .type1(pubKey: pubKey), sealbox: sealbox, codingType: .base64Encoded) let serialised = envelope.serialised() - let deserialised = try! Envelope(.base64Encoded(serialised)) + let deserialised = try! Envelope(.base64Encoded, envelopeString: serialised) XCTAssertEqual(envelope, deserialised) } func testDeserialise() { let serialised = "AnsibWV0aG9kIjoid2Nfc2Vzc2lvbkF1dGhlbnRpY2F0ZSIsImlkIjoxNzEyMjIwNjg1NjM1MzAzLCJqc29ucnBjIjoiMi4wIiwicGFyYW1zIjp7ImV4cGlyeVRpbWVzdGFtcCI6MTcxMjIyNDI4NSwiYXV0aFBheWxvYWQiOnsidHlwZSI6ImVpcDQzNjEiLCJzdGF0ZW1lbnQiOiJJIGFjY2VwdCB0aGUgU2VydmljZU9yZyBUZXJtcyBvZiBTZXJ2aWNlOiBodHRwczpcL1wvYXBwLndlYjNpbmJveC5jb21cL3RvcyIsImNoYWlucyI6WyJlaXAxNTU6MSIsImVpcDE1NToxMzciXSwicmVzb3VyY2VzIjpbInVybjpyZWNhcDpleUpoZEhRaU9uc2laV2x3TVRVMUlqcDdJbkpsY1hWbGMzUXZjR1Z5YzI5dVlXeGZjMmxuYmlJNlczdDlYWDE5ZlE9PSJdLCJkb21haW4iOiJhcHAud2ViM2luYm94IiwidmVyc2lvbiI6IjEiLCJhdWQiOiJodHRwczpcL1wvYXBwLndlYjNpbmJveC5jb21cL2xvZ2luIiwibm9uY2UiOiIzMjg5MTc1NiIsImlhdCI6IjIwMjQtMDQtMDRUMDg6NTE6MjVaIn0sInJlcXVlc3RlciI6eyJwdWJsaWNLZXkiOiIxOWYzNmY1N2M1NjYxNDY4ODk0NmU3MzliNzY4NmE2ZmE1OGNiZWFmOGQ3MzZmM2EzZDI2NjVlM2NlYmE4ZDQ5IiwibWV0YWRhdGEiOnsicmVkaXJlY3QiOnsibmF0aXZlIjoid2NkYXBwOlwvXC8iLCJ1bml2ZXJzYWwiOiJ3d3cud2FsbGV0Y29ubmVjdC5jb21cL2RhcHAifSwiaWNvbnMiOlsiaHR0cHM6XC9cL2F2YXRhcnMuZ2l0aHVidXNlcmNvbnRlbnQuY29tXC91XC8zNzc4NDg4NiJdLCJkZXNjcmlwdGlvbiI6IldhbGxldENvbm5lY3QgREFwcCBzYW1wbGUiLCJ1cmwiOiJ3YWxsZXQuY29ubmVjdCIsIm5hbWUiOiJTd2lmdCBEYXBwIn19fX0" - let deserialised = try! Envelope(.base64UrlEncoded(serialised)) + let deserialised = try! Envelope(.base64UrlEncoded, envelopeString: serialised) XCTAssertEqual(deserialised.type, .type2) } diff --git a/Tests/WalletConnectKMSTests/SerialiserTests.swift b/Tests/WalletConnectKMSTests/SerialiserTests.swift index 96cbe7f22..3cc14dbd9 100644 --- a/Tests/WalletConnectKMSTests/SerialiserTests.swift +++ b/Tests/WalletConnectKMSTests/SerialiserTests.swift @@ -23,7 +23,7 @@ final class SerializerTests: XCTestCase { _ = try! myKms.createSymmetricKey(topic) let messageToSerialize = "todo - change for request object" let serializedMessage = try! mySerializer.serialize(topic: topic, encodable: messageToSerialize, envelopeType: .type0) - let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, codingType: .base64Encoded(serializedMessage))! + let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, codingType: .base64Encoded, envelopeString: serializedMessage)! XCTAssertEqual(messageToSerialize, deserializedMessage) } @@ -39,7 +39,7 @@ final class SerializerTests: XCTestCase { let serializedMessage = try! peerSerializer.serialize(topic: topic, encodable: messageToSerialize, envelopeType: .type1(pubKey: peerPubKey.rawRepresentation)) print(agreementKeys.sharedKey.hexRepresentation) // -----------Me Deserialising ------------------- - let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, codingType: .base64Encoded(serializedMessage))! + let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: topic, codingType: .base64Encoded, envelopeString: serializedMessage)! XCTAssertEqual(messageToSerialize, deserializedMessage) } @@ -54,7 +54,7 @@ final class SerializerTests: XCTestCase { } // Deserialize the serialized message back into the original object - guard let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: "", codingType: .base64UrlEncoded(serializedMessage)) else { + guard let (deserializedMessage, _, _): (String, String?, Data) = mySerializer.tryDeserialize(topic: "", codingType: .base64UrlEncoded, envelopeString: serializedMessage) else { XCTFail("Deserialization failed for Type 2 envelope.") return } @@ -75,7 +75,7 @@ final class SerializerTests: XCTestCase { _ = try! myKms.createSymmetricKey(topic) let serialized = try! mySerializer.serialize(topic: topic, encodable: request, envelopeType: .type0) - if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(serialized)) { + if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded, envelopeString: serialized) { switch result { case .left(let result): XCTAssertEqual(result.request.method, request.method) @@ -96,7 +96,7 @@ final class SerializerTests: XCTestCase { _ = try! myKms.createSymmetricKey(topic) let serialized = try! mySerializer.serialize(topic: topic, encodable: response, envelopeType: .type0) - if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(serialized)) { + if let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded, envelopeString: serialized) { switch result { case .right(let result): XCTAssertEqual(result.response, response) @@ -115,7 +115,7 @@ final class SerializerTests: XCTestCase { // Assuming serialize can accept invalidData for the purpose of this test let serialized = try! mySerializer.serialize(topic: topic, encodable: invalidData, envelopeType: .type0) - let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded(serialized)) + let result = mySerializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded, envelopeString: serialized) XCTAssertNil(result, "Deserialization should fail for invalid data") } From 17ac8a59843d779b8e208733f618067a8ac034a1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 May 2024 14:19:47 +0200 Subject: [PATCH 601/814] fix wcm build --- .../Mocks/ModalSheetInteractorMock.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift index 23ed24b76..e22c5d5f3 100644 --- a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift +++ b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift @@ -30,11 +30,11 @@ final class ModalSheetInteractorMock: ModalSheetInteractor { let sessionProposal = Session.Proposal( id: "", pairingTopic: "", - proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil)), + proposer: AppMetadata(name: "", description: "", url: "", icons: [], redirect: try! AppMetadata.Redirect(native: "", universal: nil)), requiredNamespaces: [:], optionalNamespaces: nil, sessionProperties: nil, - proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) + proposal: SessionProposal(relays: [], proposer: Participant(publicKey: "", metadata: try! AppMetadata(name: "", description: "", url: "", icons: [], redirect: AppMetadata.Redirect(native: "", universal: nil))), requiredNamespaces: [:], optionalNamespaces: [:], sessionProperties: [:]) ) return Result.Publisher((sessionProposal, SignReasonCode.userRejectedChains)) From a93b69e3b76bd4b33617744c7588c06caf2189e6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 27 May 2024 14:41:16 +0200 Subject: [PATCH 602/814] update tests --- Example/IntegrationTests/Sign/SignClientTests.swift | 2 -- 1 file changed, 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 162c8b288..56262453f 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -1235,7 +1235,6 @@ final class SignClientTests: XCTestCase { dappLinkModeLinksStore.set(true, forKey: walletUniversalLink) wallet.authenticateRequestPublisher.sink { [unowned self] (request, _) in - semaphore.wait() Task(priority: .high) { let signerFactory = DefaultSignerFactory() let signer = MessageSignerFactory(signerFactory: signerFactory).create() @@ -1293,7 +1292,6 @@ final class SignClientTests: XCTestCase { } responseExpectation.fulfill() }.store(in: &publishers) - semaphore.signal() let requestEnvelope = try await dapp.authenticateLinkMode(AuthRequestParams.stub(), walletUniversalLink: walletUniversalLink) try wallet.dispatchEnvelope(requestEnvelope) From 3f877c8c06bdb97e5af1c8e60b28142734a8b1d0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 07:22:42 +0200 Subject: [PATCH 603/814] change qos in dispatch queues --- Example/DApp/Constants.swift | 4 ++-- Example/DApp/Modules/Configuration/ConfigPresenter.swift | 2 +- Example/DApp/Modules/Configuration/ConfigRouter.swift | 1 - Example/DApp/Modules/Sign/SignPresenter.swift | 1 - Example/DApp/SceneDelegate.swift | 2 +- Example/Shared/DefaultSocketFactory.swift | 2 +- Example/WalletApp/ApplicationLayer/LoggingService.swift | 2 +- Example/WalletApp/ApplicationLayer/ProfilingService.swift | 2 +- Sources/WalletConnectRelay/Dispatching.swift | 2 +- Sources/WalletConnectRelay/RelayClient.swift | 2 +- .../AutomaticSocketConnectionHandler.swift | 2 +- 11 files changed, 10 insertions(+), 12 deletions(-) diff --git a/Example/DApp/Constants.swift b/Example/DApp/Constants.swift index cf29055d0..36eb6a4d3 100644 --- a/Example/DApp/Constants.swift +++ b/Example/DApp/Constants.swift @@ -1,6 +1,6 @@ import Foundation -enum Constants: String { - case groupIdentifier = "group.com.walletconnect.dapp" +enum Constants { + static let groupIdentifier = "group.com.walletconnect.dapp" } diff --git a/Example/DApp/Modules/Configuration/ConfigPresenter.swift b/Example/DApp/Modules/Configuration/ConfigPresenter.swift index 808673871..b210d33fd 100644 --- a/Example/DApp/Modules/Configuration/ConfigPresenter.swift +++ b/Example/DApp/Modules/Configuration/ConfigPresenter.swift @@ -24,7 +24,7 @@ final class ConfigPresenter: ObservableObject, SceneViewModel { } func cleanLinkModeSupportedWalletsCache() { - let userDefaults = UserDefaults(suiteName: Constants.groupIdentifier.rawValue)! + let userDefaults = UserDefaults(suiteName: Constants.groupIdentifier)! let prefix = "com.walletconnect.sdk.linkModeLinks" let keys = userDefaults.dictionaryRepresentation().keys diff --git a/Example/DApp/Modules/Configuration/ConfigRouter.swift b/Example/DApp/Modules/Configuration/ConfigRouter.swift index c7aaf28e4..c3e5283f1 100644 --- a/Example/DApp/Modules/Configuration/ConfigRouter.swift +++ b/Example/DApp/Modules/Configuration/ConfigRouter.swift @@ -1,7 +1,6 @@ import Foundation import UIKit - import WalletConnectSign final class ConfigRouter { diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index aa69d979d..919f7326a 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -110,7 +110,6 @@ final class SignPresenter: ObservableObject { @MainActor func connectWalletWithSessionAuthenticateLinkMode() { - Task { do { ActivityIndicatorManager.shared.start() diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 6f28b76aa..beda25d4c 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -30,7 +30,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { Networking.configure( - groupIdentifier: Constants.groupIdentifier.rawValue, + groupIdentifier: Constants.groupIdentifier, projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) diff --git a/Example/Shared/DefaultSocketFactory.swift b/Example/Shared/DefaultSocketFactory.swift index e37b98232..64c8421f5 100644 --- a/Example/Shared/DefaultSocketFactory.swift +++ b/Example/Shared/DefaultSocketFactory.swift @@ -7,7 +7,7 @@ extension WebSocket: WebSocketConnecting { } struct DefaultSocketFactory: WebSocketFactory { func create(with url: URL) -> WebSocketConnecting { let socket = WebSocket(url: url) - let queue = DispatchQueue(label: "com.walletconnect.sdk.sockets", attributes: .concurrent) + let queue = DispatchQueue(label: "com.walletconnect.sdk.sockets", qos: .utility, attributes: .concurrent) socket.callbackQueue = queue return socket } diff --git a/Example/WalletApp/ApplicationLayer/LoggingService.swift b/Example/WalletApp/ApplicationLayer/LoggingService.swift index b03f7002b..6deba45d2 100644 --- a/Example/WalletApp/ApplicationLayer/LoggingService.swift +++ b/Example/WalletApp/ApplicationLayer/LoggingService.swift @@ -20,7 +20,7 @@ final class LoggingService { } private var _isLogging = false - private let queue = DispatchQueue(label: "com.walletApp.loggingService") + private let queue = DispatchQueue(label: "com.walletApp.loggingService", qos: .utility) func setUpUser(account: String, clientId: String) { let user = User() diff --git a/Example/WalletApp/ApplicationLayer/ProfilingService.swift b/Example/WalletApp/ApplicationLayer/ProfilingService.swift index ed46d3771..709f42cc7 100644 --- a/Example/WalletApp/ApplicationLayer/ProfilingService.swift +++ b/Example/WalletApp/ApplicationLayer/ProfilingService.swift @@ -8,7 +8,7 @@ import WalletConnectNotify final class ProfilingService { public static var instance = ProfilingService() - private let queue = DispatchQueue(label: "com.walletApp.profilingService") + private let queue = DispatchQueue(label: "com.walletApp.profilingService", qos: .utility) private var publishers = [AnyCancellable]() private var isProfiling: Bool { get { diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index a5c47ea17..81ede05d7 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -32,7 +32,7 @@ final class Dispatcher: NSObject, Dispatching { networkMonitor.networkConnectionStatusPublisher } - private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.dispatcher", attributes: .concurrent) + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.dispatcher", qos: .utility, attributes: .concurrent) init( socketFactory: WebSocketFactory, diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index f1e821491..fe0e00841 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -52,7 +52,7 @@ public final class RelayClient { private let rpcHistory: RPCHistory private let logger: ConsoleLogging - private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.relay_client", attributes: .concurrent) + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.relay_client", qos: .utility, attributes: .concurrent) public var logsPublisher: AnyPublisher { logger.logsPublisher diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index eb070ec0f..3be94af13 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -19,7 +19,7 @@ class AutomaticSocketConnectionHandler { private var socketUrlFallbackHandler: SocketUrlFallbackHandler private var publishers = Set() - private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", attributes: .concurrent) + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", qos: .utility, attributes: .concurrent) init( socket: WebSocketConnecting, From 43f2c872cc473358b28623fef5bad32c2a8d2a47 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 07:44:26 +0200 Subject: [PATCH 604/814] add envelope tests --- .../ApplicationLayer/SceneDelegate.swift | 2 +- .../WalletConnectKMSTests/EnvelopeTests.swift | 28 +++++++++++++++++++ 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 41fe1d8e9..0edf0a1ea 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -86,7 +86,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio do { try Web3Wallet.instance.dispatchEnvelope(url.absoluteString) } catch { - print(error) + AlertPresenter.present(message: error.localizedDescription, type: .error) } } } diff --git a/Tests/WalletConnectKMSTests/EnvelopeTests.swift b/Tests/WalletConnectKMSTests/EnvelopeTests.swift index 95abc1ae8..e150c3022 100644 --- a/Tests/WalletConnectKMSTests/EnvelopeTests.swift +++ b/Tests/WalletConnectKMSTests/EnvelopeTests.swift @@ -19,4 +19,32 @@ final class EnvelopeTests: XCTestCase { XCTAssertEqual(deserialised.type, .type2) } + func testInitWithValidBase64EncodedType0() { + let envelopeString = "AFdhbGxldENvbm5lY3Q=" + let envelope = try? Envelope(.base64Encoded, envelopeString: envelopeString) + + XCTAssertNotNil(envelope) + XCTAssertEqual(envelope?.type, .type0) + XCTAssertEqual(envelope?.sealbox, Data(base64Encoded: "V2FsbGV0Q29ubmVjdA==")) + } + + func testInitWithInvalidBase64() { + XCTAssertThrowsError(try Envelope(.base64Encoded, envelopeString: "invalid_base64")) { error in + XCTAssertEqual(error as? Envelope.Errors, .malformedEnvelope) + } + } + + func testInitWithInvalidBase64Url() { + XCTAssertThrowsError(try Envelope(.base64UrlEncoded, envelopeString: "invalid_base64url")) { error in + XCTAssertEqual(error as? Envelope.Errors, .malformedEnvelope) + } + } + + func testInitWithUnsupportedEnvelopeType() { + let envelopeString = "Mw==" // "3" in base64 + XCTAssertThrowsError(try Envelope(.base64Encoded, envelopeString: envelopeString)) { error in + XCTAssertEqual(error as? Envelope.Errors, .unsupportedEnvelopeType) + } + } + } From a393a8ec2ab06116029730115c1997757df43b1e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 08:18:21 +0200 Subject: [PATCH 605/814] Add envelope tests --- .../Serialiser/Envelope.swift | 16 +++- .../Serialiser/Serializer.swift | 4 +- .../WalletConnectKMSTests/EnvelopeTests.swift | 74 +++++++++++++++++-- 3 files changed, 81 insertions(+), 13 deletions(-) diff --git a/Sources/WalletConnectKMS/Serialiser/Envelope.swift b/Sources/WalletConnectKMS/Serialiser/Envelope.swift index bcaa2c051..943971465 100644 --- a/Sources/WalletConnectKMS/Serialiser/Envelope.swift +++ b/Sources/WalletConnectKMS/Serialiser/Envelope.swift @@ -47,14 +47,22 @@ public struct Envelope: Equatable { self.sealbox = sealbox } - func serialised() -> String { + func serialised(codingType: CodingType) -> String { + let dataToEncode: Data switch type { case .type0: - return (type.representingByte.data + sealbox).base64EncodedString() + dataToEncode = type.representingByte.data + sealbox case .type1(let pubKey): - return (type.representingByte.data + pubKey + sealbox).base64EncodedString() + dataToEncode = type.representingByte.data + pubKey + sealbox case .type2: - return (type.representingByte.data + sealbox).base64urlEncodedString() + dataToEncode = type.representingByte.data + sealbox + } + + switch codingType { + case .base64Encoded: + return dataToEncode.base64EncodedString() + case .base64UrlEncoded: + return dataToEncode.base64urlEncodedString() } } diff --git a/Sources/WalletConnectKMS/Serialiser/Serializer.swift b/Sources/WalletConnectKMS/Serialiser/Serializer.swift index 59303e204..ceda7ba04 100644 --- a/Sources/WalletConnectKMS/Serialiser/Serializer.swift +++ b/Sources/WalletConnectKMS/Serialiser/Serializer.swift @@ -68,7 +68,7 @@ public class Serializer: Serializing { throw error } let sealbox = try codec.encode(plaintext: messageJson, symmetricKey: symmetricKey) - return Envelope(type: envelopeType, sealbox: sealbox, codingType: codingType).serialised() + return Envelope(type: envelopeType, sealbox: sealbox, codingType: codingType).serialised(codingType: codingType) } /// Deserializes and decrypts an object @@ -112,7 +112,7 @@ public class Serializer: Serializing { private func serializeEnvelopeType2(encodable: Encodable, codingType: Envelope.CodingType) throws -> String { let messageData = try JSONEncoder().encode(encodable) let envelope = Envelope(type: .type2, sealbox: messageData, codingType: codingType) - return envelope.serialised() + return envelope.serialised(codingType: codingType) } private func handleType1Envelope(_ topic: String, peerPubKey: Data, sealbox: Data) throws -> (T, String, Data) { diff --git a/Tests/WalletConnectKMSTests/EnvelopeTests.swift b/Tests/WalletConnectKMSTests/EnvelopeTests.swift index e150c3022..d16531778 100644 --- a/Tests/WalletConnectKMSTests/EnvelopeTests.swift +++ b/Tests/WalletConnectKMSTests/EnvelopeTests.swift @@ -2,12 +2,12 @@ import XCTest @testable import WalletConnectKMS final class EnvelopeTests: XCTestCase { - let pubKey = Data(hex: "f82388e76d53632d8c73e4f4dbfe122321affee5d79cb63ee804a4ef251f4219") - let sealbox = Data(base64Encoded: "V2FsbGV0Q29ubmVjdA==")! func testSerialisation() { + let pubKey = Data(hex: "f82388e76d53632d8c73e4f4dbfe122321affee5d79cb63ee804a4ef251f4219") + let sealbox = Data(base64Encoded: "V2FsbGV0Q29ubmVjdA==")! let envelope = Envelope(type: .type1(pubKey: pubKey), sealbox: sealbox, codingType: .base64Encoded) - let serialised = envelope.serialised() + let serialised = envelope.serialised(codingType: .base64Encoded) let deserialised = try! Envelope(.base64Encoded, envelopeString: serialised) XCTAssertEqual(envelope, deserialised) } @@ -40,11 +40,71 @@ final class EnvelopeTests: XCTestCase { } } - func testInitWithUnsupportedEnvelopeType() { - let envelopeString = "Mw==" // "3" in base64 - XCTAssertThrowsError(try Envelope(.base64Encoded, envelopeString: envelopeString)) { error in - XCTAssertEqual(error as? Envelope.Errors, .unsupportedEnvelopeType) + func testInitWithValidType1Envelope() { + let pubKeyHex = "f82388e76d53632d8c73e4f4dbfe122321affee5d79cb63ee804a4ef251f4219" + let sealboxBase64 = "V2FsbGV0Q29ubmVjdA==" + let pubKey = Data(hex: pubKeyHex) + let sealbox = Data(base64Encoded: sealboxBase64)! + + // Create the Envelope object + let envelope = Envelope(type: .type1(pubKey: pubKey), sealbox: sealbox, codingType: .base64Encoded) + + // Serialize the Envelope object + let serializedEnvelopeString = envelope.serialised(codingType: .base64Encoded) + + // Deserialize the serialized string to create a new Envelope object + let deserializedEnvelope = try? Envelope(.base64Encoded, envelopeString: serializedEnvelopeString) + + // Ensure the deserialized envelope is not nil + XCTAssertNotNil(deserializedEnvelope) + guard let deserializedEnvelope = deserializedEnvelope else { + XCTFail("Deserialized envelope is nil") + return + } + + // Verify the deserialized envelope type and public key + if case let .type1(actualPubKey) = deserializedEnvelope.type { + XCTAssertEqual(actualPubKey, pubKey, "Public keys do not match") + } else { + XCTFail("Envelope type is not type1") + } + + // Verify the sealbox of the deserialized envelope + XCTAssertEqual(deserializedEnvelope.sealbox, sealbox, "Sealbox data does not match") + } + + func testInitWithValidBase64UrlEncodedType2() { + let jsonString = "{\"key\":\"value\"}" + let envelope = Envelope(type: .type2, sealbox: Data(jsonString.utf8), codingType: .base64UrlEncoded) + let serializedEnvelopeString = envelope.serialised(codingType: .base64UrlEncoded) + + let deserializedEnvelope = try? Envelope(.base64UrlEncoded, envelopeString: serializedEnvelopeString) + + XCTAssertNotNil(deserializedEnvelope) + guard let deserializedEnvelope = deserializedEnvelope else { + XCTFail("Deserialized envelope is nil") + return } + + XCTAssertEqual(deserializedEnvelope.type, .type2) + XCTAssertEqual(deserializedEnvelope.sealbox, Data(jsonString.utf8)) } + func testInitWithValidBase64EncodedType0_CustomData() { + let customData = "TestCustomData".data(using: .utf8)! + let envelope = Envelope(type: .type0, sealbox: customData, codingType: .base64Encoded) + let serializedEnvelopeString = envelope.serialised(codingType: .base64Encoded) + + let deserializedEnvelope = try? Envelope(.base64Encoded, envelopeString: serializedEnvelopeString) + + XCTAssertNotNil(deserializedEnvelope) + guard let deserializedEnvelope = deserializedEnvelope else { + XCTFail("Deserialized envelope is nil") + return + } + + XCTAssertEqual(deserializedEnvelope.type, .type0) + XCTAssertEqual(deserializedEnvelope.sealbox, customData) + } } + From ee2a57a9638645c13942b8cdd4b1c54a1c7f1db1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 08:20:50 +0200 Subject: [PATCH 606/814] add envelope type tests --- .../WalletConnectKMSTests/EnvelopeTests.swift | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/Tests/WalletConnectKMSTests/EnvelopeTests.swift b/Tests/WalletConnectKMSTests/EnvelopeTests.swift index d16531778..94212e0fe 100644 --- a/Tests/WalletConnectKMSTests/EnvelopeTests.swift +++ b/Tests/WalletConnectKMSTests/EnvelopeTests.swift @@ -106,5 +106,45 @@ final class EnvelopeTests: XCTestCase { XCTAssertEqual(deserializedEnvelope.type, .type0) XCTAssertEqual(deserializedEnvelope.sealbox, customData) } + + // Envelope type tests + + func testEnvelopeTypeInitWithType0() { + let envelopeType = try? Envelope.EnvelopeType(representingByte: 0, pubKey: nil) + XCTAssertNotNil(envelopeType) + XCTAssertEqual(envelopeType, .type0) + } + + func testEnvelopeTypeInitWithType1ValidPubKey() { + let pubKey = Data(hex: "f82388e76d53632d8c73e4f4dbfe122321affee5d79cb63ee804a4ef251f4219") + let envelopeType = try? Envelope.EnvelopeType(representingByte: 1, pubKey: pubKey) + XCTAssertNotNil(envelopeType) + XCTAssertEqual(envelopeType, .type1(pubKey: pubKey)) + } + + func testEnvelopeTypeInitWithType1InvalidPubKey() { + let invalidPubKey = Data(hex: "f82388e76d53632d8c73e4f4dbfe122321af") // Shorter than 32 bytes + XCTAssertThrowsError(try Envelope.EnvelopeType(representingByte: 1, pubKey: invalidPubKey)) { error in + XCTAssertEqual(error as? Envelope.Errors, .malformedEnvelope) + } + } + + func testEnvelopeTypeInitWithType1NilPubKey() { + XCTAssertThrowsError(try Envelope.EnvelopeType(representingByte: 1, pubKey: nil)) { error in + XCTAssertEqual(error as? Envelope.Errors, .malformedEnvelope) + } + } + + func testEnvelopeTypeInitWithType2() { + let envelopeType = try? Envelope.EnvelopeType(representingByte: 2, pubKey: nil) + XCTAssertNotNil(envelopeType) + XCTAssertEqual(envelopeType, .type2) + } + + func testEnvelopeTypeInitWithUnsupportedType() { + XCTAssertThrowsError(try Envelope.EnvelopeType(representingByte: 3, pubKey: nil)) { error in + XCTAssertEqual(error as? Envelope.Errors, .unsupportedEnvelopeType) + } + } } From 85c4dd2958912ba70b97244536ff4223c13227ce Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 09:01:39 +0200 Subject: [PATCH 607/814] Apply suggestions from code review Co-authored-by: Jack Pooley <169029079+jackpooleywc@users.noreply.github.com> --- .../WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift | 2 +- .../LinkAndRelayDispatchers/LinkSessionRequester.swift | 2 +- .../LinkAndRelayDispatchers/SessionRequestDispatcher.swift | 2 +- .../LinkAndRelayDispatchers/SessionRequester.swift | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index ca257dd54..e79b9354f 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -2,7 +2,7 @@ import UIKit import Combine -class LinkEnvelopesDispatcher { +final class LinkEnvelopesDispatcher { enum Errors: Error { case invalidURL case envelopeNotFound diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift index c49518c2b..015f261ee 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift @@ -1,7 +1,7 @@ import Foundation -class LinkSessionRequester { +final class LinkSessionRequester { private let sessionStore: WCSessionStorage private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let logger: ConsoleLogging diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift index a017455d3..cdb9e85af 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequestDispatcher.swift @@ -1,7 +1,7 @@ import Foundation -class SessionRequestDispatcher { +final class SessionRequestDispatcher { private let relaySessionRequester: SessionRequester private let linkSessionRequester: LinkSessionRequester private let logger: ConsoleLogging diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift index ba253fba6..b074df449 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionRequester.swift @@ -1,7 +1,7 @@ import Foundation -class SessionRequester { +final class SessionRequester { private let sessionStore: WCSessionStorage private let networkingInteractor: NetworkInteracting private let logger: ConsoleLogging From cb957fce50a8beb1be344fdec1a0d0dce7314f9c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 09:09:53 +0200 Subject: [PATCH 608/814] Update Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift Co-authored-by: Jack Pooley <169029079+jackpooleywc@users.noreply.github.com> --- .../Auth/Services/App/AuthResponseSubscriber.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 33bbfb429..cc4e8c5a4 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -85,7 +85,7 @@ class AuthResponseSubscriber { }.store(in: &publishers) } - private func subscribeForLinkResonse() { + private func subscribeForLinkResponse() { linkEnvelopesDispatcher.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } From 3dbf75cf9033b3b5703706fd642805b006dec2dc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 09:11:36 +0200 Subject: [PATCH 609/814] blockPublishing not public --- Example/DApp/SceneDelegate.swift | 2 -- Sources/WalletConnectRelay/RelayClient.swift | 2 +- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index beda25d4c..61cdec4c0 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -24,10 +24,8 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { } catch { print(error) } - } - func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { Networking.configure( groupIdentifier: Constants.groupIdentifier, diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index fe0e00841..efa501499 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -14,7 +14,7 @@ public enum SocketConnectionStatus { public final class RelayClient { #if DEBUG - public var blockPublishing: Bool = false + var blockPublishing: Bool = false #endif enum Errors: Error { case subscriptionIdNotFound From 5afa6720053995f30016b44c86093362cd57b461 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 28 May 2024 11:24:41 +0200 Subject: [PATCH 610/814] fix build --- .../Auth/Services/App/AuthResponseSubscriber.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index cc4e8c5a4..cab1ac6bd 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -48,7 +48,7 @@ class AuthResponseSubscriber { self.linkModeLinksStore = linkModeLinksStore self.supportLinkMode = supportLinkMode subscribeForResponse() - subscribeForLinkResonse() + subscribeForLinkResponse() } private func subscribeForResponse() { From 3afcf07d5af4a391104ba469f55f6304496933e2 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Tue, 28 May 2024 09:44:52 +0000 Subject: [PATCH 611/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 66c4ff16d..b363160a7 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.18.8"} +{"version": "1.19.0"} From 44d4977b25b39489520d4406d93f8c0236547fe7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 May 2024 13:20:22 +0200 Subject: [PATCH 612/814] integrate 1click auth --- .../WalletConnectPairing/PairingClient.swift | 12 ----------- .../WalletConnectSign/Sign/SignClient.swift | 21 ------------------- .../Sign/SignClientProtocol.swift | 2 ++ 3 files changed, 2 insertions(+), 33 deletions(-) diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index ead5d85be..44e79f7b2 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -2,9 +2,6 @@ import Foundation import Combine public class PairingClient: PairingRegisterer, PairingInteracting, PairingClientProtocol { - enum Errors: Error { - case pairingDoesNotSupportRequiredMethod - } public var pingResponsePublisher: AnyPublisher<(String), Never> { pingResponsePublisherSubject.eraseToAnyPublisher() } @@ -139,15 +136,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient _ = try pairingsProvider.getPairing(for: topic) } - public func validateMethodSupport(topic: String, method: String) throws { - _ = try pairingsProvider.getPairing(for: topic) - let pairing = pairingStorage.getPairing(forTopic: topic) - guard let methods = pairing?.methods, - methods.contains(method) else { - throw Errors.pairingDoesNotSupportRequiredMethod - } - } - public func register(method: ProtocolMethod) -> AnyPublisher, Never> { logger.debug("Pairing Client - registering for \(method.method)") return pairingRequestsSubscriber.subscribeForRequest(method) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index be4339671..5694955c3 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -320,27 +320,6 @@ public final class SignClient: SignClientProtocol { //---------------------------------------AUTH----------------------------------- - /// For a dApp to propose an authenticated session to a wallet. - /// Function will propose a session on existing pairing. - public func authenticate( - _ params: AuthRequestParams, - topic: String - ) async throws { - try pairingClient.validatePairingExistance(topic) - try pairingClient.validateMethodSupport(topic: topic, method: SessionAuthenticatedProtocolMethod().method) - logger.debug("Requesting Authentication on existing pairing") - try await appRequestService.request(params: params, topic: topic) - - let namespaces = try ProposalNamespaceBuilder.buildNamespace(from: params) - try await appProposeService.propose( - pairingTopic: topic, - namespaces: [:], - optionalNamespaces: namespaces, - sessionProperties: nil, - relay: RelayProtocolOptions(protocol: "irn", data: nil) - ) - } - /// For a dApp to propose an authenticated session to a wallet. public func authenticate( _ params: AuthRequestParams, diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index 292579f16..f74e2c9c7 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -19,8 +19,10 @@ public protocol SignClientProtocol { var requestExpirationPublisher: AnyPublisher { get } func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws + func request(params: Request) async throws func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]?) async throws -> Session + func authenticate(_ params: AuthRequestParams, walletUniversalLink: String?) async throws -> WalletConnectURI? func rejectSession(proposalId: String, reason: RejectionReason) async throws func rejectSession(requestId: RPCID) async throws func update(topic: String, namespaces: [String: SessionNamespace]) async throws From e56430b11ed7d93187fda7f76630f0734e57af6f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 May 2024 14:43:36 +0200 Subject: [PATCH 613/814] remove force unwrap --- Sources/WalletConnectModal/Modal/Screens/WalletList.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectModal/Modal/Screens/WalletList.swift b/Sources/WalletConnectModal/Modal/Screens/WalletList.swift index 96efd6a13..0180d4d35 100644 --- a/Sources/WalletConnectModal/Modal/Screens/WalletList.swift +++ b/Sources/WalletConnectModal/Modal/Screens/WalletList.swift @@ -215,7 +215,7 @@ struct WalletList: View { .stroke(.gray.opacity(0.4), lineWidth: 1) ) - Text(String(wallet.name.split(separator: " ").first!)) + Text(String(wallet.name.split(separator: " ").first ?? " ")) .font(.system(size: 12)) .foregroundColor(.foreground1) .multilineTextAlignment(.center) From a575e09ed7ad12e3ac6466f0b755c0020851c6a0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 29 May 2024 15:29:35 +0200 Subject: [PATCH 614/814] not display error alert on session request --- Example/WalletApp/ApplicationLayer/SceneDelegate.swift | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift index 0edf0a1ea..c3b5b2ab3 100644 --- a/Example/WalletApp/ApplicationLayer/SceneDelegate.swift +++ b/Example/WalletApp/ApplicationLayer/SceneDelegate.swift @@ -83,6 +83,12 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate, UNUserNotificatio if case WalletConnectURI.Errors.expired = error { AlertPresenter.present(message: error.localizedDescription, type: .error) } else { + guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false), + let queryItems = components.queryItems, + queryItems.contains(where: { $0.name == "wc_ev" }) else { + return + } + do { try Web3Wallet.instance.dispatchEnvelope(url.absoluteString) } catch { From 6bbf71a079138d05a94897bcdde256ce18c43c24 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 31 May 2024 11:04:09 +0200 Subject: [PATCH 615/814] add 1click auth w3m --- Example/DApp/SceneDelegate.swift | 5 +++-- Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- .../xcshareddata/swiftpm/Package.resolved | 2 +- 3 files changed, 5 insertions(+), 4 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 61cdec4c0..e2710ba6b 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -46,14 +46,15 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, metadata: metadata, crypto: DefaultCryptoProvider(), - customWallets: [ + authRequestParams: .stub(), customWallets: [ .init( id: "swift-sample", name: "Swift Sample Wallet", homepage: "https://walletconnect.com/", imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", order: 1, - mobileLink: "walletapp://" + mobileLink: "walletapp://", + linkMode: "https://lab.web3modal.com/dapp" ) ] ) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 0ec6a24f9..b6ca472c5 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3280,7 +3280,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = revision; - revision = c73ce390bc249af155b7320346b7045e53b89866; + revision = 4b746f76d524f5ba9279e6ec3c33014a43bae244; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 84752135e..b400440f5 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "c73ce390bc249af155b7320346b7045e53b89866", + "revision": "4b746f76d524f5ba9279e6ec3c33014a43bae244", "version": null } } From fb85cd3c460114e2149b4846557276c4e8f97d80 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 31 May 2024 13:33:14 +0200 Subject: [PATCH 616/814] fix redirect issue --- Example/DApp/SceneDelegate.swift | 2 +- Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index e2710ba6b..89b4712d4 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -54,7 +54,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", order: 1, mobileLink: "walletapp://", - linkMode: "https://lab.web3modal.com/dapp" + linkMode: "https://lab.web3modal.com/wallet" ) ] ) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index b6ca472c5..663d23895 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3280,7 +3280,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = revision; - revision = 4b746f76d524f5ba9279e6ec3c33014a43bae244; + revision = d84d37a0cda748bd69db340065f464b859c38158; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index b400440f5..db719c925 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "4b746f76d524f5ba9279e6ec3c33014a43bae244", + "revision": "d84d37a0cda748bd69db340065f464b859c38158", "version": null } } From de6bf8e25fa062d76281d77a0f0d1d63fba5d6cb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 3 Jun 2024 08:52:13 +0200 Subject: [PATCH 617/814] linkmode metadata optional --- Sources/WalletConnectPairing/Types/AppMetadata.swift | 2 +- .../Auth/Services/App/AuthResponseSubscriber.swift | 3 ++- .../LinkAndRelayDispatchers/WalletErrorResponder.swift | 3 ++- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectPairing/Types/AppMetadata.swift b/Sources/WalletConnectPairing/Types/AppMetadata.swift index f71fe44ae..ebd32f965 100644 --- a/Sources/WalletConnectPairing/Types/AppMetadata.swift +++ b/Sources/WalletConnectPairing/Types/AppMetadata.swift @@ -22,7 +22,7 @@ public struct AppMetadata: Codable, Equatable { /// Universal link URL string. public let universal: String? - public let linkMode: Bool + public let linkMode: Bool? /** Creates a new Redirect object with the specified information. diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index cab1ac6bd..6c3a304d8 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -143,7 +143,8 @@ class AuthResponseSubscriber { // remove record if let peerRedirect = peerMetadata.redirect, - peerRedirect.linkMode, + let peerLinkMode = peerRedirect.linkMode, + peerLinkMode == true, let universalLink = peerRedirect.universal, supportLinkMode { linkModeLinksStore.set(true, forKey: universalLink) diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index e965ebffb..7da610522 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -55,7 +55,8 @@ actor WalletErrorResponder { let (sessionAuthenticateRequestParams, _) = try getsessionAuthenticateRequestParams(requestId: requestId) guard let redirect = sessionAuthenticateRequestParams.requester.metadata.redirect, - redirect.linkMode else { + let linkMode = redirect.linkMode, + linkMode == true else { throw Errors.linkModeNotSupported } guard let peerUniversalLink = redirect.universal else { From 7eae272a9a0eef54bfe0897fe5c267dbb302568d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 3 Jun 2024 10:15:29 +0200 Subject: [PATCH 618/814] update w3m --- .../Modules/Sign/SessionAccount/SessionAccountPresenter.swift | 2 +- Example/DApp/Modules/Sign/SignPresenter.swift | 2 +- Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 2 +- .../Auth/Services/App/AuthResponseSubscriber.swift | 1 - 5 files changed, 4 insertions(+), 5 deletions(-) diff --git a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift index 31920ce46..e89ea8a8e 100644 --- a/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift +++ b/Example/DApp/Modules/Sign/SessionAccount/SessionAccountPresenter.swift @@ -87,7 +87,7 @@ extension SessionAccountPresenter { } private func getRequest(for method: String) throws -> AnyCodable { - let account = session.namespaces.first!.value.accounts.first!.absoluteString + let account = session.namespaces.first!.value.accounts.first!.address if method == "eth_sendTransaction" { let tx = Stub.tx return AnyCodable(tx) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 919f7326a..f21cc84e2 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -244,7 +244,7 @@ extension AuthRequestParams { domain: String = "lab.web3modal.com", chains: [String] = ["eip155:1", "eip155:137"], nonce: String = "32891756", - uri: String = "https://app.web3inbox.com/login", + uri: String = "https://lab.web3modal.com", nbf: String? = nil, exp: String? = nil, statement: String? = "I accept the ServiceOrg Terms of Service: https://app.web3inbox.com/tos", diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 663d23895..00f54ddc5 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3280,7 +3280,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = revision; - revision = d84d37a0cda748bd69db340065f464b859c38158; + revision = babf2a567ea06a4deb56c8152a4e92c96ef7b6c3; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index db719c925..091c4e2c8 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "d84d37a0cda748bd69db340065f464b859c38158", + "revision": "babf2a567ea06a4deb56c8152a4e92c96ef7b6c3", "version": null } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 6c3a304d8..8bf8ebac9 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -140,7 +140,6 @@ class AuthResponseSubscriber { private func getTransportTypeUpgradeIfPossible(peerMetadata: AppMetadata, requestId: RPCID) -> WCSession.TransportType { // upgrade to link mode only if dapp requested universallink because dapp may not be prepared for handling a response - add this to doc] - // remove record if let peerRedirect = peerMetadata.redirect, let peerLinkMode = peerRedirect.linkMode, From aee6e31eef5930755946001cc422074a4732f3d2 Mon Sep 17 00:00:00 2001 From: Jack Pooley <169029079+jackpooleywc@users.noreply.github.com> Date: Thu, 23 May 2024 17:11:59 +0200 Subject: [PATCH 619/814] Session rejection tags --- .../Auth/Link/LinkAuthRequestSubscriber.swift | 3 +- .../Auth/Link/LinkAuthRequester.swift | 2 +- .../Services/App/AuthResponseSubscriber.swift | 10 ++-- .../AuthenticateTransportTypeSwitcher.swift | 4 +- .../App/SessionAuthRequestService.swift | 2 +- .../Wallet/AuthRequestSubscriber.swift | 11 +++-- .../Wallet/SessionAuthenticateResponder.swift | 8 +++- .../SessionAuthenticatedProtocolMethod.swift | 48 +++++++++++++++---- .../Engine/Common/ApproveEngine.swift | 25 ++++++---- .../WalletErrorResponder.swift | 8 +++- .../Services/App/AppProposeService.swift | 2 +- .../SessionProposeProtocolMethod.swift | 41 +++++++++++++++- 12 files changed, 130 insertions(+), 34 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift index 2edda30d6..c245a19d2 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -29,7 +29,8 @@ class LinkAuthRequestSubscriber { private func subscribeForRequest() { - envelopesDispatcher.requestSubscription(on: SessionAuthenticatedProtocolMethod().method) + envelopesDispatcher + .requestSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove().method) .sink { [unowned self] (payload: RequestSubscriptionPayload) in logger.debug("LinkAuthRequestSubscriber: Received request") diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 2d6846040..c18b9fb78 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -37,7 +37,7 @@ actor LinkAuthRequester { var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() - let protocolMethod = SessionAuthenticatedProtocolMethod(ttl: params.ttl) + let protocolMethod = SessionAuthenticatedProtocolMethod.responseApprove(ttl: params.ttl) guard let chainNamespace = Blockchain(params.chains.first!)?.namespace, chainNamespace == "eip155" else { diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index cab1ac6bd..315818f3e 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -52,13 +52,15 @@ class AuthResponseSubscriber { } private func subscribeForResponse() { - networkingInteractor.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) + networkingInteractor + .responseErrorSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) - networkingInteractor.responseSubscription(on: SessionAuthenticatedProtocolMethod()) + networkingInteractor + .responseSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in let transportType = getTransportTypeUpgradeIfPossible(peerMetadata: payload.response.responder.metadata, requestId: payload.id) @@ -86,13 +88,13 @@ class AuthResponseSubscriber { } private func subscribeForLinkResponse() { - linkEnvelopesDispatcher.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod()) + linkEnvelopesDispatcher.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) - linkEnvelopesDispatcher.responseSubscription(on: SessionAuthenticatedProtocolMethod()) + linkEnvelopesDispatcher.responseSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in let pairingTopic = payload.topic diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift index 30223401b..494ec1f22 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthenticateTransportTypeSwitcher.swift @@ -45,7 +45,9 @@ class AuthenticateTransportTypeSwitcher { // Continue with relay if the error is walletLinkSupportNotProven } - let pairingURI = try await pairingClient.create(methods: [SessionAuthenticatedProtocolMethod().method]) + let pairingURI = try await pairingClient.create( + methods: [SessionAuthenticatedProtocolMethod.responseApprove().method] + ) logger.debug("Requesting Authentication on existing pairing") try await appRequestService.request(params: params, topic: pairingURI.topic) diff --git a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift index b26a40f0e..3b75365a4 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/SessionAuthRequestService.swift @@ -29,7 +29,7 @@ actor SessionAuthRequestService { var params = params let pubKey = try kms.createX25519KeyPair() let responseTopic = pubKey.rawRepresentation.sha256().toHexString() - let protocolMethod = SessionAuthenticatedProtocolMethod(ttl: params.ttl) + let protocolMethod = SessionAuthenticatedProtocolMethod.responseApprove(ttl: params.ttl) guard let chainNamespace = Blockchain(params.chains.first!)?.namespace, chainNamespace == "eip155" else { diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index ecc44bb78..a4389ee9f 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -36,7 +36,7 @@ class AuthRequestSubscriber { } private func subscribeForRequest() { - pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod()) + pairingRegisterer.register(method: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in guard !payload.request.isExpired() else { @@ -70,10 +70,15 @@ class AuthRequestSubscriber { }.store(in: &publishers) } - func respondError(payload: SubscriptionPayload, reason: SignReasonCode) { + private func respondError(payload: SubscriptionPayload, reason: SignReasonCode) { Task(priority: .high) { do { - try await networkingInteractor.respondError(topic: payload.topic, requestId: payload.id, protocolMethod: SessionAuthenticatedProtocolMethod(), reason: reason) + try await networkingInteractor.respondError( + topic: payload.topic, + requestId: payload.id, + protocolMethod: SessionAuthenticatedProtocolMethod.responseAutoReject(), + reason: reason + ) } catch { logger.error("Respond Error failed with: \(error.localizedDescription)") } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index 2f5a6123c..a4b229830 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -53,7 +53,13 @@ actor SessionAuthenticateResponder { let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: responseTopic, response: response, protocolMethod: SessionAuthenticatedProtocolMethod(), envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) + + try await networkingInteractor.respond( + topic: responseTopic, + response: response, + protocolMethod: SessionAuthenticatedProtocolMethod.responseApprove(), + envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation) + ) let session = try util.createSession( diff --git a/Sources/WalletConnectSign/Auth/SessionAuthenticatedProtocolMethod.swift b/Sources/WalletConnectSign/Auth/SessionAuthenticatedProtocolMethod.swift index 6005e63e5..4b44218f5 100644 --- a/Sources/WalletConnectSign/Auth/SessionAuthenticatedProtocolMethod.swift +++ b/Sources/WalletConnectSign/Auth/SessionAuthenticatedProtocolMethod.swift @@ -1,17 +1,47 @@ import Foundation struct SessionAuthenticatedProtocolMethod: ProtocolMethod { + + enum Tag: Int { + case sessionAuthenticate = 1116 + case sessionAuthenticateResponseApprove = 1117 + case sessionAuthenticateResponseReject = 1118 + case sessionAuthenticateResponseAutoReject = 1119 + } + let method: String = "wc_sessionAuthenticate" - let requestConfig = RelayConfig(tag: 1116, prompt: true, ttl: 3600) - - let responseConfig = RelayConfig(tag: 1117, prompt: false, ttl: 3600) - - - static let defaultTtl: TimeInterval = 3600 - private let ttl: Int + let requestConfig: RelayConfig + + let responseConfig: RelayConfig - init(ttl: TimeInterval = Self.defaultTtl) { - self.ttl = Int(ttl) + static let defaultTtl: TimeInterval = 300 + + private init( + ttl: TimeInterval, + responseTag: Tag + ) { + self.requestConfig = RelayConfig( + tag: Tag.sessionAuthenticate.rawValue, + prompt: true, + ttl: Int(ttl) + ) + self.responseConfig = RelayConfig( + tag: responseTag.rawValue, + prompt: false, + ttl: Int(ttl) + ) + } + + static func responseApprove(ttl: TimeInterval = Self.defaultTtl) -> Self { + Self(ttl: ttl, responseTag: .sessionAuthenticateResponseApprove) + } + + static func responseReject(ttl: TimeInterval = Self.defaultTtl) -> Self { + Self(ttl: ttl, responseTag: .sessionAuthenticateResponseReject) + } + + static func responseAutoReject(ttl: TimeInterval = Self.defaultTtl) -> Self { + Self(ttl: ttl, responseTag: .sessionAuthenticateResponseAutoReject) } } diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 3d0d9727b..eabb88d6b 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -114,7 +114,7 @@ final class ApproveEngine { async let proposeResponseTask: () = networkingInteractor.respond( topic: payload.topic, response: response, - protocolMethod: SessionProposeProtocolMethod() + protocolMethod: SessionProposeProtocolMethod.responseApprove() ) async let settleRequestTask: WCSession = settle( @@ -146,8 +146,13 @@ final class ApproveEngine { guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { throw Errors.proposalNotFound } - - try await networkingInteractor.respondError(topic: payload.topic, requestId: payload.id, protocolMethod: SessionProposeProtocolMethod(), reason: reason) + + try await networkingInteractor.respondError( + topic: payload.topic, + requestId: payload.id, + protocolMethod: SessionProposeProtocolMethod.responseReject(), + reason: reason + ) if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, let pairing = pairingStore.getPairing(forTopic: pairingTopic), @@ -216,12 +221,14 @@ final class ApproveEngine { private extension ApproveEngine { func setupRequestSubscriptions() { - pairingRegisterer.register(method: SessionProposeProtocolMethod()) + pairingRegisterer.register(method: SessionProposeProtocolMethod.responseAutoReject()) .sink { [unowned self] (payload: RequestSubscriptionPayload) in guard let pairing = pairingStore.getPairing(forTopic: payload.topic) else { return } + let responseApproveMethod = SessionAuthenticatedProtocolMethod.responseApprove().method if let methods = pairing.methods, - methods.flatMap({ $0 }) - .contains(SessionAuthenticatedProtocolMethod().method), authRequestSubscribersTracking.hasSubscribers() { + methods.contains(responseApproveMethod), + authRequestSubscribersTracking.hasSubscribers() + { logger.debug("Ignoring Session Proposal") // respond with an error? return @@ -236,7 +243,7 @@ private extension ApproveEngine { } func setupResponseSubscriptions() { - networkingInteractor.responseSubscription(on: SessionProposeProtocolMethod()) + networkingInteractor.responseSubscription(on: SessionProposeProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in handleSessionProposeResponse(payload: payload) }.store(in: &publishers) @@ -248,7 +255,7 @@ private extension ApproveEngine { } func setupResponseErrorSubscriptions() { - networkingInteractor.responseErrorSubscription(on: SessionProposeProtocolMethod()) + networkingInteractor.responseErrorSubscription(on: SessionProposeProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in handleSessionProposeResponseError(payload: payload) }.store(in: &publishers) @@ -340,7 +347,7 @@ private extension ApproveEngine { logger.debug("Received Session Proposal") let proposal = payload.request do { try Namespace.validate(proposal.requiredNamespaces) } catch { - return respondError(payload: payload, reason: .invalidUpdateRequest, protocolMethod: SessionProposeProtocolMethod()) + return respondError(payload: payload, reason: .invalidUpdateRequest, protocolMethod: SessionProposeProtocolMethod.responseAutoReject()) } proposalPayloadsStore.set(payload, forKey: proposal.proposer.publicKey) diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index e965ebffb..ca3e8e4c4 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -48,7 +48,13 @@ actor WalletErrorResponder { private func respondErrorRelay(_ error: AuthError, requestId: RPCID, topic: String, type1EnvelopeKey: Data) async throws { let envelopeType = Envelope.EnvelopeType.type1(pubKey: type1EnvelopeKey) - try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: SessionAuthenticatedProtocolMethod(), reason: error, envelopeType: envelopeType) + try await networkingInteractor.respondError( + topic: topic, + requestId: requestId, + protocolMethod: SessionAuthenticatedProtocolMethod.responseReject(), + reason: error, + envelopeType: envelopeType + ) } private func respondErrorLinkMode(_ error: AuthError, requestId: RPCID, topic: String, type1EnvelopeKey: Data) async throws -> String { diff --git a/Sources/WalletConnectSign/Services/App/AppProposeService.swift b/Sources/WalletConnectSign/Services/App/AppProposeService.swift index a92b80bea..bdeca0df5 100644 --- a/Sources/WalletConnectSign/Services/App/AppProposeService.swift +++ b/Sources/WalletConnectSign/Services/App/AppProposeService.swift @@ -33,7 +33,7 @@ final class AppProposeService { if let sessionProperties { try SessionProperties.validate(sessionProperties) } - let protocolMethod = SessionProposeProtocolMethod() + let protocolMethod = SessionProposeProtocolMethod.responseApprove() let publicKey = try! kms.createX25519KeyPair() let proposer = Participant( publicKey: publicKey.hexRepresentation, diff --git a/Sources/WalletConnectSign/Types/ProtocolMethods/SessionProposeProtocolMethod.swift b/Sources/WalletConnectSign/Types/ProtocolMethods/SessionProposeProtocolMethod.swift index f7068cfb4..f62db43af 100644 --- a/Sources/WalletConnectSign/Types/ProtocolMethods/SessionProposeProtocolMethod.swift +++ b/Sources/WalletConnectSign/Types/ProtocolMethods/SessionProposeProtocolMethod.swift @@ -2,8 +2,45 @@ import Foundation struct SessionProposeProtocolMethod: ProtocolMethod { let method: String = "wc_sessionPropose" + + enum Tag: Int { + case sessionPropose = 1100 + case sessionProposeResponseApprove = 1101 + case sessionProposeResponseReject = 1120 + case sessionProposeResponseAutoReject = 1121 + } - let requestConfig = RelayConfig(tag: 1100, prompt: true, ttl: 300) + let requestConfig: RelayConfig - let responseConfig = RelayConfig(tag: 1101, prompt: false, ttl: 300) + let responseConfig: RelayConfig + + static let defaultTtl: TimeInterval = 300 + + private init( + ttl: TimeInterval, + responseTag: Tag + ) { + self.requestConfig = RelayConfig( + tag: Tag.sessionPropose.rawValue, + prompt: true, + ttl: Int(ttl) + ) + self.responseConfig = RelayConfig( + tag: responseTag.rawValue, + prompt: false, + ttl: Int(ttl) + ) + } + + static func responseApprove(ttl: TimeInterval = Self.defaultTtl) -> Self { + Self(ttl: ttl, responseTag: .sessionProposeResponseApprove) + } + + static func responseReject(ttl: TimeInterval = Self.defaultTtl) -> Self { + Self(ttl: ttl, responseTag: .sessionProposeResponseReject) + } + + static func responseAutoReject(ttl: TimeInterval = Self.defaultTtl) -> Self { + Self(ttl: ttl, responseTag: .sessionProposeResponseAutoReject) + } } From 6989c77efbb7a6bfcddfb79db83e21df40cedf57 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 3 Jun 2024 13:44:15 +0200 Subject: [PATCH 620/814] add authentication alert --- Example/DApp/SceneDelegate.swift | 11 ++++++++++- Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- .../xcshareddata/swiftpm/Package.resolved | 2 +- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 89b4712d4..2de2c9534 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -58,7 +58,16 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) ] ) - + + Web3Modal.instance.authResponsePublisher.sink { (id, result) in + switch result { + case .success((_, _)): + AlertPresenter.present(message: "User Authenticted with SIWE", type: .success) + case .failure(_): + break + } + }.store(in: &publishers) + WalletConnectModal.configure( projectId: InputConfig.projectId, metadata: metadata diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 00f54ddc5..b7d71d28a 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3280,7 +3280,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = revision; - revision = babf2a567ea06a4deb56c8152a4e92c96ef7b6c3; + revision = 3baac675811b5fdeb689cef703e3dfc7682704e6; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 091c4e2c8..3198e81b5 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "babf2a567ea06a4deb56c8152a4e92c96ef7b6c3", + "revision": "3baac675811b5fdeb689cef703e3dfc7682704e6", "version": null } } From 075d74eb3a8db1988867d3d63678fba6cc4327eb Mon Sep 17 00:00:00 2001 From: llbartekll Date: Tue, 4 Jun 2024 07:08:14 +0000 Subject: [PATCH 621/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index b363160a7..e01fd4d43 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.0"} +{"version": "1.19.1"} From 00dc3944770a124d6572ab9318cea388a47b8d1e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 12 Jun 2024 10:06:53 +0200 Subject: [PATCH 622/814] add verifySIWE function --- .../WalletConnectSign/Sign/SignClient.swift | 22 ++++++++++++++----- .../Sign/SignClientFactory.swift | 3 ++- 2 files changed, 18 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 5694955c3..d2f994268 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -193,6 +193,7 @@ public final class SignClient: SignClientProtocol { private let linkSessionRequestSubscriber: LinkSessionRequestSubscriber private let sessionResponderDispatcher: SessionResponderDispatcher private let linkSessionRequestResponseSubscriber: LinkSessionRequestResponseSubscriber + private let messageVerifier: MessageVerifier private var publishers = Set() @@ -231,7 +232,8 @@ public final class SignClient: SignClientProtocol { linkSessionRequestSubscriber: LinkSessionRequestSubscriber, sessionResponderDispatcher: SessionResponderDispatcher, linkSessionRequestResponseSubscriber: LinkSessionRequestResponseSubscriber, - authenticateTransportTypeSwitcher: AuthenticateTransportTypeSwitcher + authenticateTransportTypeSwitcher: AuthenticateTransportTypeSwitcher, + messageVerifier: MessageVerifier ) { self.logger = logger self.networkingClient = networkingClient @@ -267,6 +269,7 @@ public final class SignClient: SignClientProtocol { self.sessionResponderDispatcher = sessionResponderDispatcher self.linkSessionRequestResponseSubscriber = linkSessionRequestResponseSubscriber self.authenticateTransportTypeSwitcher = authenticateTransportTypeSwitcher + self.messageVerifier = messageVerifier setUpConnectionObserving() setUpEnginesCallbacks() @@ -374,11 +377,6 @@ public final class SignClient: SignClientProtocol { return try pendingRequestsProvider.getPendingRequests() } - public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { - let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: payload, account: account) - return try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) - } - public func buildSignedAuthObject(authPayload: AuthPayload, signature: CacaoSignature, account: Account) throws -> AuthObject { try CacaosBuilder.makeCacao(authPayload: authPayload, signature: signature, account: account) } @@ -387,6 +385,17 @@ public final class SignClient: SignClientProtocol { try AuthPayloadBuilder.build(payload: payload, supportedEVMChains: supportedEVMChains, supportedMethods: supportedMethods) } + // MARK: - SIWE + + public func formatAuthMessage(payload: AuthPayload, account: Account) throws -> String { + let cacaoPayload = try CacaoPayloadBuilder.makeCacaoPayload(authPayload: payload, account: account) + return try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) + } + + public func verifySIWE(signature: CacaoSignature, message: String, address: String, chainId: String) async throws { + + } + //----------------------------------------------------------------------------------- /// For a wallet to approve a session proposal. @@ -590,3 +599,4 @@ public final class SignClient: SignClientProtocol { }.store(in: &publishers) } } + diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index f1fa294ea..4acff725c 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -178,7 +178,8 @@ public struct SignClientFactory { linkSessionRequestSubscriber: linkSessionRequestSubscriber, sessionResponderDispatcher: sessionResponderDispatcher, linkSessionRequestResponseSubscriber: linkSessionRequestResponseSubscriber, - authenticateTransportTypeSwitcher: authenticateTransportTypeSwitcher + authenticateTransportTypeSwitcher: authenticateTransportTypeSwitcher, + messageVerifier: signatureVerifier ) return client } From b0bf7892844fac62207aa8dcd27cda6c72287645 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 12 Jun 2024 17:01:43 +0200 Subject: [PATCH 623/814] savepoint --- Sources/WalletConnectSign/Auth/Types/AuthPayload.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift index 8edab5317..bca5ec3fa 100644 --- a/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift +++ b/Sources/WalletConnectSign/Auth/Types/AuthPayload.swift @@ -43,7 +43,7 @@ public struct AuthPayload: Codable, Equatable { } - init(requestParams: AuthRequestParams, iat: String) { + public init(requestParams: AuthRequestParams, iat: String) { self.type = "eip4361" self.chains = requestParams.chains self.domain = requestParams.domain From 8baa41899eff1fbd31edf2d615999ff14ffc4115 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 13 Jun 2024 09:05:01 +0200 Subject: [PATCH 624/814] Add siwe verification --- .../WalletConnectSign/Sign/SignClient.swift | 4 +- .../Verifier/MessageVerifier.swift | 39 ++++++++++++++++--- 2 files changed, 36 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index d2f994268..135b14b6a 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -392,8 +392,8 @@ public final class SignClient: SignClientProtocol { return try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) } - public func verifySIWE(signature: CacaoSignature, message: String, address: String, chainId: String) async throws { - + public func verifySIWE(signature: Data, message: String, address: String, chainId: String) async throws { + try await messageVerifier.verify(signature: signature, message: message, address: address, chainId: chainId) } //----------------------------------------------------------------------------------- diff --git a/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift b/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift index 12b82b40e..f0120942c 100644 --- a/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift +++ b/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift @@ -15,8 +15,8 @@ public struct MessageVerifier { } public func verify(signature: CacaoSignature, - message: String, - account: Account + message: String, + account: Account ) async throws { try await self.verify( signature: signature, @@ -27,9 +27,9 @@ public struct MessageVerifier { } public func verify(signature: CacaoSignature, - message: String, - address: String, - chainId: String + message: String, + address: String, + chainId: String ) async throws { guard let messageData = message.data(using: .utf8) else { @@ -54,4 +54,33 @@ public struct MessageVerifier { ) } } + + public func verify(signature: Data, + message: String, + address: String, + chainId: String + ) async throws { + + guard let messageData = message.data(using: .utf8) else { + throw Errors.utf8EncodingFailed + } + + let prefixedMessage = messageData.prefixed + + do { + try await eip191Verifier.verify( + signature: signature, + message: prefixedMessage, + address: address + ) + } catch { + // If eip191 verification fails, try eip1271 verification + try await eip1271Verifier.verify( + signature: signature, + message: prefixedMessage, + address: address, + chainId: chainId + ) + } + } } From 997be80a6f86be4ba340ac8121acde24fc428520 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 13 Jun 2024 09:16:29 +0200 Subject: [PATCH 625/814] savepoint --- Sources/WalletConnectSign/Sign/SignClient.swift | 2 +- Sources/WalletConnectSigner/Verifier/MessageVerifier.swift | 7 ++++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 135b14b6a..35b7941ce 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -392,7 +392,7 @@ public final class SignClient: SignClientProtocol { return try SIWEFromCacaoPayloadFormatter().formatMessage(from: cacaoPayload) } - public func verifySIWE(signature: Data, message: String, address: String, chainId: String) async throws { + public func verifySIWE(signature: String, message: String, address: String, chainId: String) async throws { try await messageVerifier.verify(signature: signature, message: message, address: address, chainId: chainId) } diff --git a/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift b/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift index f0120942c..d1a9680a6 100644 --- a/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift +++ b/Sources/WalletConnectSigner/Verifier/MessageVerifier.swift @@ -55,7 +55,7 @@ public struct MessageVerifier { } } - public func verify(signature: Data, + public func verify(signature: String, message: String, address: String, chainId: String @@ -64,19 +64,20 @@ public struct MessageVerifier { guard let messageData = message.data(using: .utf8) else { throw Errors.utf8EncodingFailed } + let signatureData = Data(hex: signature) let prefixedMessage = messageData.prefixed do { try await eip191Verifier.verify( - signature: signature, + signature: signatureData, message: prefixedMessage, address: address ) } catch { // If eip191 verification fails, try eip1271 verification try await eip1271Verifier.verify( - signature: signature, + signature: signatureData, message: prefixedMessage, address: address, chainId: chainId From c504ab06f5a27096c12d82068860ed5582c43fd9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 14 Jun 2024 09:51:03 +0200 Subject: [PATCH 626/814] add mixpanel to dapp --- Example/DApp/Common/InputConfig.swift | 16 --------- Example/DApp/SceneDelegate.swift | 4 +++ Example/ExampleApp.xcodeproj/project.pbxproj | 18 +++++----- .../Common => Shared}/AlertPresenter.swift | 0 .../ProfilingService.swift | 6 ++-- Example/WalletApp/Common/AlertPresenter.swift | 35 ------------------- 6 files changed, 14 insertions(+), 65 deletions(-) delete mode 100644 Example/DApp/Common/InputConfig.swift rename Example/{DApp/Common => Shared}/AlertPresenter.swift (100%) rename Example/{WalletApp/ApplicationLayer => Shared}/ProfilingService.swift (93%) delete mode 100644 Example/WalletApp/Common/AlertPresenter.swift diff --git a/Example/DApp/Common/InputConfig.swift b/Example/DApp/Common/InputConfig.swift deleted file mode 100644 index d710282b7..000000000 --- a/Example/DApp/Common/InputConfig.swift +++ /dev/null @@ -1,16 +0,0 @@ -import Foundation - -struct InputConfig { - - static var projectId: String { - guard let projectId = config(for: "PROJECT_ID"), !projectId.isEmpty else { - fatalError("PROJECT_ID is either not defined or empty in Configuration.xcconfig") - } - - return projectId - } - - private static func config(for key: String) -> String? { - return Bundle.main.object(forInfoDictionaryKey: key) as? String - } -} diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 2de2c9534..d28783139 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -34,6 +34,10 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) Sign.configure(crypto: DefaultCryptoProvider()) + if let clientId = try? Networking.interactor.getClientId() { + ProfilingService.instance.setUpProfiling(account: "swift_dapp_\(clientId)", clientId: clientId) + } + let metadata = AppMetadata( name: "Swift Dapp", description: "WalletConnect DApp sample", diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index b7d71d28a..50e440d22 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -24,6 +24,9 @@ 846E35A42C0065B600E63DF4 /* ConfigPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A32C0065B600E63DF4 /* ConfigPresenter.swift */; }; 846E35A62C0065C100E63DF4 /* ConfigView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A52C0065C100E63DF4 /* ConfigView.swift */; }; 846E35A82C006C5600E63DF4 /* Constants.swift in Sources */ = {isa = PBXBuildFile; fileRef = 846E35A72C006C5600E63DF4 /* Constants.swift */; }; + 84733CD32C1C2A4B001B2850 /* AlertPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84AEC2502B4D42C100E27A5B /* AlertPresenter.swift */; }; + 84733CD42C1C2C24001B2850 /* ProfilingService.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50B6A372B06697B00162B01 /* ProfilingService.swift */; }; + 84733CD52C1C2CEB001B2850 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE25D293F56D6004840D1 /* InputConfig.swift */; }; 847BD1D62989492500076C90 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D12989492500076C90 /* MainViewController.swift */; }; 847BD1D82989492500076C90 /* MainModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D32989492500076C90 /* MainModule.swift */; }; 847BD1D92989492500076C90 /* MainPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1D42989492500076C90 /* MainPresenter.swift */; }; @@ -36,7 +39,6 @@ 847BD1E8298A806800076C90 /* NotificationsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1E3298A806800076C90 /* NotificationsView.swift */; }; 847BD1EB298A87AB00076C90 /* SubscriptionsViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847BD1EA298A87AB00076C90 /* SubscriptionsViewModel.swift */; }; 847F08012A25DBFF00B2A5A4 /* XPlatformW3WTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 847F08002A25DBFF00B2A5A4 /* XPlatformW3WTests.swift */; }; - 8486EDD12B4F2DC1008E53C3 /* AlertPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */; }; 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */ = {isa = PBXBuildFile; productRef = 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */; }; 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9432A836C2A0003D5AF /* Sentry */; }; 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */ = {isa = PBXBuildFile; productRef = 8487A9452A836C3F0003D5AF /* Sentry */; }; @@ -87,7 +89,6 @@ A518A98829683FB60035247E /* Web3InboxModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518A98529683FB60035247E /* Web3InboxModule.swift */; }; A518A98929683FB60035247E /* Web3InboxRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518A98629683FB60035247E /* Web3InboxRouter.swift */; }; A518B31428E33A6500A2CE93 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518B31328E33A6500A2CE93 /* InputConfig.swift */; }; - A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51AC0D828E436A3001BACF9 /* InputConfig.swift */; }; A51AC0DF28E4379F001BACF9 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51AC0DE28E4379F001BACF9 /* InputConfig.swift */; }; A5417BBE299BFC3E00B469F3 /* ImportAccount.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */; }; A541959E2934BFEF0035AD19 /* CacaoSignerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959A2934BFEF0035AD19 /* CacaoSignerTests.swift */; }; @@ -419,7 +420,6 @@ 847BD1E3298A806800076C90 /* NotificationsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotificationsView.swift; sourceTree = ""; }; 847BD1EA298A87AB00076C90 /* SubscriptionsViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SubscriptionsViewModel.swift; sourceTree = ""; }; 847F08002A25DBFF00B2A5A4 /* XPlatformW3WTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = XPlatformW3WTests.swift; sourceTree = ""; }; - 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertPresenter.swift; sourceTree = ""; }; 8487A92E2A7BD2F30003D5AF /* XPlatformProtocolTests.xctestplan */ = {isa = PBXFileReference; lastKnownFileType = text; name = XPlatformProtocolTests.xctestplan; path = ../XPlatformProtocolTests.xctestplan; sourceTree = ""; }; 8487A9472A83AD680003D5AF /* LoggingService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoggingService.swift; sourceTree = ""; }; 849A4F18298281E300E61ACE /* WalletAppRelease.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletAppRelease.entitlements; sourceTree = ""; }; @@ -470,7 +470,6 @@ A518A98529683FB60035247E /* Web3InboxModule.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Web3InboxModule.swift; sourceTree = ""; }; A518A98629683FB60035247E /* Web3InboxRouter.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Web3InboxRouter.swift; sourceTree = ""; }; A518B31328E33A6500A2CE93 /* InputConfig.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; - A51AC0D828E436A3001BACF9 /* InputConfig.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; A51AC0DE28E4379F001BACF9 /* InputConfig.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ImportAccount.swift; sourceTree = ""; }; A541959A2934BFEF0035AD19 /* CacaoSignerTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = CacaoSignerTests.swift; sourceTree = ""; }; @@ -1380,6 +1379,8 @@ 84CB43D429B9FC88004DDA31 /* Tests */, A5629AEF2877F73000094373 /* DefaultSocketFactory.swift */, A59CF4F5292F83D50031A42F /* DefaultSignerFactory.swift */, + A50B6A372B06697B00162B01 /* ProfilingService.swift */, + 84AEC2502B4D42C100E27A5B /* AlertPresenter.swift */, A5A0843B29D2F60A000B9B17 /* DefaultCryptoProvider.swift */, A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */, A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */, @@ -1392,10 +1393,8 @@ A5BB7FAB28B6AA7100707FC6 /* Common */ = { isa = PBXGroup; children = ( - A51AC0D828E436A3001BACF9 /* InputConfig.swift */, A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */, 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */, - 8486EDD02B4F2DC1008E53C3 /* AlertPresenter.swift */, ); path = Common; sourceTree = ""; @@ -1630,7 +1629,6 @@ C56EE262293F56D6004840D1 /* Extensions */, C56EE263293F56D6004840D1 /* VIPER */, 84AEC24E2B4D1EE400E27A5B /* ActivityIndicatorManager.swift */, - 84AEC2502B4D42C100E27A5B /* AlertPresenter.swift */, ); path = Common; sourceTree = ""; @@ -1688,7 +1686,6 @@ C56EE280293F5757004840D1 /* Application.swift */, C56EE27F293F5757004840D1 /* AppDelegate.swift */, C56EE281293F5757004840D1 /* SceneDelegate.swift */, - A50B6A372B06697B00162B01 /* ProfilingService.swift */, 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */, A51811972A52E21A00A52B15 /* ConfigurationService.swift */, 8487A9472A83AD680003D5AF /* LoggingService.swift */, @@ -2249,6 +2246,9 @@ isa = PBXSourcesBuildPhase; buildActionMask = 2147483647; files = ( + 84733CD52C1C2CEB001B2850 /* InputConfig.swift in Sources */, + 84733CD42C1C2C24001B2850 /* ProfilingService.swift in Sources */, + 84733CD32C1C2A4B001B2850 /* AlertPresenter.swift in Sources */, C5BE021C2AF79B9A0064FC88 /* SessionAccountRouter.swift in Sources */, C5B4C4C42AF11C8B00B4274A /* SignView.swift in Sources */, C5BE02042AF7764F0064FC88 /* UIViewController.swift in Sources */, @@ -2262,7 +2262,6 @@ 846E359F2C00654F00E63DF4 /* ConfigModule.swift in Sources */, C5BE01E52AF697470064FC88 /* Color.swift in Sources */, A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */, - A51AC0D928E436A3001BACF9 /* InputConfig.swift in Sources */, C5BE01E22AF693080064FC88 /* Application.swift in Sources */, C5BE021B2AF79B9A0064FC88 /* SessionAccountPresenter.swift in Sources */, A5A8E47E293A1CFE00FEB97D /* DefaultSignerFactory.swift in Sources */, @@ -2273,7 +2272,6 @@ C5BE02012AF774CB0064FC88 /* NewPairingModule.swift in Sources */, C5BE02002AF774CB0064FC88 /* NewPairingRouter.swift in Sources */, C5BE01F82AF6CB270064FC88 /* SignInteractor.swift in Sources */, - 8486EDD12B4F2DC1008E53C3 /* AlertPresenter.swift in Sources */, C5BE01D12AF661D70064FC88 /* NewPairingView.swift in Sources */, 846E35A42C0065B600E63DF4 /* ConfigPresenter.swift in Sources */, 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */, diff --git a/Example/DApp/Common/AlertPresenter.swift b/Example/Shared/AlertPresenter.swift similarity index 100% rename from Example/DApp/Common/AlertPresenter.swift rename to Example/Shared/AlertPresenter.swift diff --git a/Example/WalletApp/ApplicationLayer/ProfilingService.swift b/Example/Shared/ProfilingService.swift similarity index 93% rename from Example/WalletApp/ApplicationLayer/ProfilingService.swift rename to Example/Shared/ProfilingService.swift index 709f42cc7..c928e0669 100644 --- a/Example/WalletApp/ApplicationLayer/ProfilingService.swift +++ b/Example/Shared/ProfilingService.swift @@ -2,7 +2,7 @@ import Foundation import Mixpanel import WalletConnectNetworking import Combine -import Web3Wallet +import WalletConnectSign import WalletConnectNotify final class ProfilingService { @@ -33,10 +33,8 @@ final class ProfilingService { mixpanel.people.set(properties: ["$name": account, "account": account]) handleLogs(from: Networking.instance.logsPublisher) - handleLogs(from: Notify.instance.logsPublisher) handleLogs(from: Push.instance.logsPublisher) - handleLogs(from: Web3Wallet.instance.logsPublisher) - + handleLogs(from: Sign.instance.logsPublisher) } private func handleLogs(from publisher: AnyPublisher) { diff --git a/Example/WalletApp/Common/AlertPresenter.swift b/Example/WalletApp/Common/AlertPresenter.swift deleted file mode 100644 index 5da5d4668..000000000 --- a/Example/WalletApp/Common/AlertPresenter.swift +++ /dev/null @@ -1,35 +0,0 @@ -import Foundation -import SwiftMessages -import UIKit - -struct AlertPresenter { - enum MessageType { - case warning - case error - case info - case success - } - - static func present(message: String, type: AlertPresenter.MessageType) { - DispatchQueue.main.async { - let view = MessageView.viewFromNib(layout: .cardView) - switch type { - case .warning: - view.configureTheme(.warning, iconStyle: .subtle) - case .error: - view.configureTheme(.error, iconStyle: .subtle) - case .info: - view.configureTheme(.info, iconStyle: .subtle) - case .success: - view.configureTheme(.success, iconStyle: .subtle) - } - view.button?.isHidden = true - view.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) - view.configureContent(title: "", body: message) - var config = SwiftMessages.Config() - config.presentationStyle = .top - config.duration = .seconds(seconds: 1.5) - SwiftMessages.show(config: config, view: view) - } - } -} From 1a551fd1fcf99976f185fc50cea3e21ef84e4ffa Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 14 Jun 2024 11:48:55 +0200 Subject: [PATCH 627/814] add mixpanel to dapp --- Example/DApp/Info.plist | 2 + .../Configuration/ConfigPresenter.swift | 5 ++ .../Modules/Configuration/ConfigView.swift | 81 ++++++++++++++++--- Example/DApp/SceneDelegate.swift | 9 +-- Example/Shared/ProfilingService.swift | 1 - .../Auth/Link/LinkEnvelopesDispatcher.swift | 9 ++- 6 files changed, 87 insertions(+), 20 deletions(-) diff --git a/Example/DApp/Info.plist b/Example/DApp/Info.plist index 20e5043da..1f05fe57e 100644 --- a/Example/DApp/Info.plist +++ b/Example/DApp/Info.plist @@ -2,6 +2,8 @@ + MIXPANEL_TOKEN + $(MIXPANEL_TOKEN) CFBundleURLTypes diff --git a/Example/DApp/Modules/Configuration/ConfigPresenter.swift b/Example/DApp/Modules/Configuration/ConfigPresenter.swift index b210d33fd..0872c7c25 100644 --- a/Example/DApp/Modules/Configuration/ConfigPresenter.swift +++ b/Example/DApp/Modules/Configuration/ConfigPresenter.swift @@ -8,6 +8,11 @@ final class ConfigPresenter: ObservableObject, SceneViewModel { private let router: ConfigRouter + var clientId: String { + guard let clientId = try? Networking.interactor.getClientId() else { return .empty } + return clientId + } + init( router: ConfigRouter ) { diff --git a/Example/DApp/Modules/Configuration/ConfigView.swift b/Example/DApp/Modules/Configuration/ConfigView.swift index 3c20e8441..35d061ddf 100644 --- a/Example/DApp/Modules/Configuration/ConfigView.swift +++ b/Example/DApp/Modules/Configuration/ConfigView.swift @@ -2,6 +2,8 @@ import SwiftUI struct ConfigView: View { @EnvironmentObject var presenter: ConfigPresenter + @State private var copyAlert: Bool = false + @State private var cacheCleanAlert: Bool = false var body: some View { NavigationStack { @@ -10,22 +12,71 @@ struct ConfigView: View { .ignoresSafeArea() ScrollView { - VStack { - Button { + VStack(spacing: 12) { + // Clean Cache Button + Button(action: { presenter.cleanLinkModeSupportedWalletsCache() - } label: { - HStack { - Spacer() - Text("Clean Link Mode Supported Wallets Cache") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.vertical, 25) - Spacer() + cacheCleanAlert = true + }) { + VStack(alignment: .leading, spacing: 4) { + HStack(spacing: 6) { + Text("Clean Cache") + .multilineTextAlignment(.leading) + .foregroundColor(.white) + .font(.system(size: 16, weight: .semibold)) + + Image(systemName: "trash") + .foregroundColor(.white) + + Spacer() + } + .padding(.horizontal, 12) + .padding(.top, 16) + + Text("Clean link mode supported wallets cache") + .multilineTextAlignment(.leading) + .foregroundColor(.white.opacity(0.7)) + .font(.system(size: 14)) + .padding(.horizontal, 12) + .padding(.bottom, 16) } - .background(Color(red: 95/255, green: 159/255, blue: 248/255)) - .cornerRadius(16) + .background(Color(red: 95/255, green: 159/255, blue: 248/255).opacity(0.2).cornerRadius(12)) } + .frame(maxWidth: .infinity) + .padding(.horizontal, 12) .padding(.top, 10) + + // Client ID Row + Button(action: { + UIPasteboard.general.string = presenter.clientId + copyAlert = true + }) { + VStack(alignment: .leading, spacing: 4) { + HStack(spacing: 6) { + Text("Client ID") + .multilineTextAlignment(.leading) + .foregroundColor(.white) + .font(.system(size: 16, weight: .semibold)) + + Image(systemName: "doc.on.doc") + .foregroundColor(.white) + + Spacer() + } + .padding(.horizontal, 12) + .padding(.top, 16) + + Text(presenter.clientId) + .multilineTextAlignment(.leading) + .foregroundColor(.white.opacity(0.7)) + .font(.system(size: 14)) + .padding(.horizontal, 12) + .padding(.bottom, 16) + } + .background(Color(red: 95/255, green: 159/255, blue: 248/255).opacity(0.2).cornerRadius(12)) + } + .frame(maxWidth: .infinity) + .padding(.horizontal, 12) } .padding(12) } @@ -43,6 +94,12 @@ struct ConfigView: View { for: .navigationBar ) } + .alert("Cache cleaned successfully", isPresented: $cacheCleanAlert) { + Button("OK", role: .cancel) { } + } + .alert("Client ID copied to clipboard", isPresented: $copyAlert) { + Button("OK", role: .cancel) { } + } } } diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index d28783139..91851597a 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -32,11 +32,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory() ) - Sign.configure(crypto: DefaultCryptoProvider()) - - if let clientId = try? Networking.interactor.getClientId() { - ProfilingService.instance.setUpProfiling(account: "swift_dapp_\(clientId)", clientId: clientId) - } let metadata = AppMetadata( name: "Swift Dapp", @@ -62,6 +57,10 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) ] ) + + if let clientId = try? Networking.interactor.getClientId() { + ProfilingService.instance.setUpProfiling(account: "swift_dapp_\(clientId)", clientId: clientId) + } Web3Modal.instance.authResponsePublisher.sink { (id, result) in switch result { diff --git a/Example/Shared/ProfilingService.swift b/Example/Shared/ProfilingService.swift index c928e0669..c5c3ee119 100644 --- a/Example/Shared/ProfilingService.swift +++ b/Example/Shared/ProfilingService.swift @@ -33,7 +33,6 @@ final class ProfilingService { mixpanel.people.set(properties: ["$name": account, "account": account]) handleLogs(from: Networking.instance.logsPublisher) - handleLogs(from: Push.instance.logsPublisher) handleLogs(from: Sign.instance.logsPublisher) } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index e79b9354f..13d850cce 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -36,15 +36,18 @@ final class LinkEnvelopesDispatcher { } func dispatchEnvelope(_ envelope: String) throws { + logger.debug("will dispatch an envelope: \(envelope)") guard let envelopeURL = URL(string: envelope), let components = URLComponents(url: envelopeURL, resolvingAgainstBaseURL: true) else { throw Errors.invalidURL } guard let wcEnvelope = components.queryItems?.first(where: { $0.name == "wc_ev" })?.value else { + logger.error(Errors.envelopeNotFound.localizedDescription) throw Errors.envelopeNotFound } guard let topic = components.queryItems?.first(where: { $0.name == "topic" })?.value else { + logger.error(Errors.topicNotFound.localizedDescription) throw Errors.topicNotFound } manageEnvelope(topic, wcEnvelope) @@ -159,19 +162,21 @@ final class LinkEnvelopesDispatcher { private func handleRequest(topic: String, request: RPCRequest) { do { + logger.debug("handling link mode request") try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote, transportType: .linkMode) requestPublisherSubject.send((topic, request)) } catch { - logger.debug(error) + logger.debug("Handling link mode request failed: \(error)") } } private func handleResponse(topic: String, response: RPCResponse) { do { + logger.debug("handling link mode response") let record = try rpcHistory.resolve(response) responsePublisherSubject.send((topic, record.request, response)) } catch { - logger.debug("Handle json rpc response error: \(error)") + logger.debug("Handling link mode response failed: \(error)") } } } From c612fb88bd7f9f60e2cf8664cb5db2b56d748df0 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Fri, 14 Jun 2024 09:51:18 +0000 Subject: [PATCH 628/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index e01fd4d43..803999dce 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.1"} +{"version": "1.19.2"} From 33fedc92ef42fae7922177eb8eb00574343e7714 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 14 Jun 2024 12:28:12 +0200 Subject: [PATCH 629/814] add non 1ca w3m --- Example/DApp/Modules/Sign/SignPresenter.swift | 14 +++++++++++++- Example/DApp/Modules/Sign/SignView.swift | 12 ++++++++++++ Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- .../xcshareddata/swiftpm/Package.resolved | 2 +- 4 files changed, 27 insertions(+), 3 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index f21cc84e2..415a6c36f 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -45,6 +45,7 @@ final class SignPresenter: ObservableObject { func connectWalletWithW3M() { Task { + Web3Modal.instance.enableAuthenticatedSessions() Web3Modal.set(sessionParams: .init( requiredNamespaces: Proposal.requiredNamespaces, optionalNamespaces: Proposal.optionalNamespaces @@ -52,7 +53,18 @@ final class SignPresenter: ObservableObject { } Web3Modal.present(from: nil) } - + + func connectWalletWithW3M_wc_sessionPropose() { + Task { + Web3Modal.instance.disableAuthenticatedSessions() + Web3Modal.set(sessionParams: .init( + requiredNamespaces: Proposal.requiredNamespaces, + optionalNamespaces: Proposal.optionalNamespaces + )) + } + Web3Modal.present(from: nil) + } + func connectWalletWithWCM() { WalletConnectModal.set(sessionParams: .init( requiredNamespaces: Proposal.requiredNamespaces, diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index 03b4003a9..8b5cb7ddb 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -33,6 +33,18 @@ struct SignView: View { Button { presenter.connectWalletWithW3M() + } label: { + Text("Connect with Web3Modal - 1CA") + .font(.system(size: 16, weight: .semibold)) + .foregroundColor(.white) + .padding(.horizontal, 16) + .padding(.vertical, 10) + .background(Color(red: 95/255, green: 159/255, blue: 248/255)) + .cornerRadius(16) + } + + Button { + presenter.connectWalletWithW3M_wc_sessionPropose() } label: { Text("Connect with Web3Modal") .font(.system(size: 16, weight: .semibold)) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 50e440d22..1620536ad 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3278,7 +3278,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = revision; - revision = 3baac675811b5fdeb689cef703e3dfc7682704e6; + revision = 5efac2f025d33be0fd522b1bb7bab6f07f772d58; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 3198e81b5..c1d71b921 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "3baac675811b5fdeb689cef703e3dfc7682704e6", + "revision": "5efac2f025d33be0fd522b1bb7bab6f07f772d58", "version": null } } From 26c01109f5a64898564bf1423e2d38010d80f1f6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 14 Jun 2024 13:18:42 +0200 Subject: [PATCH 630/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 39 ++++++------------- Example/DApp/Modules/Sign/SignView.swift | 12 ------ Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- .../xcshareddata/swiftpm/Package.resolved | 2 +- 4 files changed, 14 insertions(+), 41 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 415a6c36f..7c831b263 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -45,18 +45,6 @@ final class SignPresenter: ObservableObject { func connectWalletWithW3M() { Task { - Web3Modal.instance.enableAuthenticatedSessions() - Web3Modal.set(sessionParams: .init( - requiredNamespaces: Proposal.requiredNamespaces, - optionalNamespaces: Proposal.optionalNamespaces - )) - } - Web3Modal.present(from: nil) - } - - func connectWalletWithW3M_wc_sessionPropose() { - Task { - Web3Modal.instance.disableAuthenticatedSessions() Web3Modal.set(sessionParams: .init( requiredNamespaces: Proposal.requiredNamespaces, optionalNamespaces: Proposal.optionalNamespaces @@ -170,14 +158,6 @@ final class SignPresenter: ObservableObject { // MARK: - Private functions extension SignPresenter { private func setupInitialState() { - Sign.instance.sessionSettlePublisher - .receive(on: DispatchQueue.main) - .sink { [unowned self] _ in - self.router.dismiss() - self.getSession() - } - .store(in: &subscriptions) - getSession() Sign.instance.sessionDeletePublisher @@ -196,6 +176,9 @@ extension SignPresenter { case .success(let (session, _)): if session == nil { AlertPresenter.present(message: "Wallet Succesfully Authenticated", type: .success) + } else { + self.router.dismiss() + self.getSession() } break case .failure(let error): @@ -212,13 +195,6 @@ extension SignPresenter { } .store(in: &subscriptions) - Sign.instance.sessionsPublisher - .receive(on: DispatchQueue.main) - .sink { [unowned self] _ in - self.router.dismiss() - self.getSession() - } - .store(in: &subscriptions) Sign.instance.requestExpirationPublisher .receive(on: DispatchQueue.main) .sink { _ in @@ -226,6 +202,15 @@ extension SignPresenter { AlertPresenter.present(message: "Session Request has expired", type: .warning) } .store(in: &subscriptions) + + Web3Modal.instance.SIWEAuthenticationPublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] _ in + AlertPresenter.present(message: "Authenticated with SIWE", type: .success) + self.router.dismiss() + self.getSession() + } + .store(in: &subscriptions) } private func getSession() { diff --git a/Example/DApp/Modules/Sign/SignView.swift b/Example/DApp/Modules/Sign/SignView.swift index 8b5cb7ddb..03b4003a9 100644 --- a/Example/DApp/Modules/Sign/SignView.swift +++ b/Example/DApp/Modules/Sign/SignView.swift @@ -33,18 +33,6 @@ struct SignView: View { Button { presenter.connectWalletWithW3M() - } label: { - Text("Connect with Web3Modal - 1CA") - .font(.system(size: 16, weight: .semibold)) - .foregroundColor(.white) - .padding(.horizontal, 16) - .padding(.vertical, 10) - .background(Color(red: 95/255, green: 159/255, blue: 248/255)) - .cornerRadius(16) - } - - Button { - presenter.connectWalletWithW3M_wc_sessionPropose() } label: { Text("Connect with Web3Modal") .font(.system(size: 16, weight: .semibold)) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 1620536ad..2447d9efa 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3278,7 +3278,7 @@ repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { kind = revision; - revision = 5efac2f025d33be0fd522b1bb7bab6f07f772d58; + revision = 25abd7e5471f21d662400f9763948fbf97c60c97; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index c1d71b921..53859947e 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "5efac2f025d33be0fd522b1bb7bab6f07f772d58", + "revision": "25abd7e5471f21d662400f9763948fbf97c60c97", "version": null } } From c06c901c125e359332dafa4886b1b45fc6085b3c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 14 Jun 2024 20:19:35 +0200 Subject: [PATCH 631/814] fix modal integration --- Example/DApp/Modules/Sign/SignPresenter.swift | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 7c831b263..0b2e86e7d 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -205,10 +205,15 @@ extension SignPresenter { Web3Modal.instance.SIWEAuthenticationPublisher .receive(on: DispatchQueue.main) - .sink { [unowned self] _ in - AlertPresenter.present(message: "Authenticated with SIWE", type: .success) - self.router.dismiss() - self.getSession() + .sink { [unowned self] result in + switch result { + case .success((let message, let signature)): + AlertPresenter.present(message: "Authenticated with SIWE", type: .success) + self.router.dismiss() + self.getSession() + case .failure(let error): + AlertPresenter.present(message: "\(error)", type: .warning) + } } .store(in: &subscriptions) } From 0e48e714d873d4f36e1efba5d10cff1eba0e7fe3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 18 Jun 2024 08:00:41 +0200 Subject: [PATCH 632/814] add logs --- Example/DApp/AppDelegate.swift | 1 + Example/DApp/SceneDelegate.swift | 25 ++++++++++++++++++- .../Auth/Link/LinkEnvelopesDispatcher.swift | 13 ++++++++-- .../LinkSessionResponder.swift | 12 +++++++-- .../SessionResponderDispatcher.swift | 1 + 5 files changed, 47 insertions(+), 5 deletions(-) diff --git a/Example/DApp/AppDelegate.swift b/Example/DApp/AppDelegate.swift index ccfb15c17..1d9a60efd 100644 --- a/Example/DApp/AppDelegate.swift +++ b/Example/DApp/AppDelegate.swift @@ -17,6 +17,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate { } func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([any UIUserActivityRestoring]?) -> Void) async -> Bool { + ProfilingService.instance.send(logMessage: .init(message: "AppDelegate: will try to dispatch envelope: \(String(describing: userActivity.webpageURL))")) guard let url = userActivity.webpageURL, let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { return true diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 91851597a..f85038903 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -15,6 +15,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: will try to dispatch envelope - userActivity: \(String(describing: userActivity.webpageURL))")) guard let url = userActivity.webpageURL, let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { return @@ -27,6 +28,8 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { } func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: willConnectTo : \(String(describing: connectionOptions.userActivities.first?.webpageURL?.absoluteString))")) + Networking.configure( groupIdentifier: Constants.groupIdentifier, projectId: InputConfig.projectId, @@ -66,7 +69,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { switch result { case .success((_, _)): AlertPresenter.present(message: "User Authenticted with SIWE", type: .success) - case .failure(_): + case .failure(let error): break } }.store(in: &publishers) @@ -110,4 +113,24 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { window?.rootViewController = viewController window?.makeKeyAndVisible() } + + func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: - openURLContexts : \(String(describing: URLContexts.first?.url))")) + + guard let context = URLContexts.first else { return } + + let url = context.url + + guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false), + let queryItems = components.queryItems, + queryItems.contains(where: { $0.name == "wc_ev" }) else { + return + } + + do { + try Sign.instance.dispatchEnvelope(url.absoluteString) + } catch { + AlertPresenter.present(message: error.localizedDescription, type: .error) + } + } } diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 13d850cce..3ce61f2ef 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -55,16 +55,21 @@ final class LinkEnvelopesDispatcher { func request(topic: String, request: RPCRequest, peerUniversalLink: String, envelopeType: Envelope.EnvelopeType) async throws -> String { + logger.debug("Will send request with link mode") try rpcHistory.set(request, forTopic: topic, emmitedBy: .local, transportType: .relay) let envelopeUrl: URL do { envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: request, envelopeType: envelopeType, topic: topic) - DispatchQueue.main.async { + logger.debug("Will try to open envelopeUrl: \(envelopeUrl)") + + DispatchQueue.main.async { [weak self] in + self?.logger.debug("Will open universal link") UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) } } catch { + logger.error("Failed to open url, error: \(error) ") if let id = request.id { rpcHistory.delete(id: id) } @@ -75,9 +80,12 @@ final class LinkEnvelopesDispatcher { } func respond(topic: String, response: RPCResponse, peerUniversalLink: String, envelopeType: Envelope.EnvelopeType) async throws -> String { + logger.debug("will redpond for a request id: \(String(describing: response.id))") try rpcHistory.validate(response) let envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: response, envelopeType: envelopeType, topic: topic) - DispatchQueue.main.async { + logger.debug("Prepared envelopeUrl: \(envelopeUrl)") + DispatchQueue.main.async { [weak self] in + self?.logger.debug("Will open universal link") UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) } try rpcHistory.resolve(response) @@ -86,6 +94,7 @@ final class LinkEnvelopesDispatcher { } public func respondError(topic: String, requestId: RPCID, peerUniversalLink: String, reason: Reason, envelopeType: Envelope.EnvelopeType) async throws -> String { + logger.debug("Will respond with error, peerUniversalLink: \(peerUniversalLink)") let error = JSONRPCError(code: reason.code, message: reason.message) let response = RPCResponse(id: requestId, error: error) return try await respond(topic: topic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: envelopeType) diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift index 03c43c3b9..5d215be7a 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift @@ -26,15 +26,21 @@ class LinkSessionResponder { } func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String { + logger.debug("LinkSessionResponder: responding session request") guard let session = sessionStore.getSession(forTopic: topic) else { - throw WalletConnectError.noSessionMatchingTopic(topic) + let error = WalletConnectError.noSessionMatchingTopic(topic) + logger.debug("failed: \(error)") + throw error } guard let peerUniversalLink = session.peerParticipant.metadata.redirect!.universal else { - throw Errors.missingPeerUniversalLink + let error = Errors.missingPeerUniversalLink + logger.debug("failed: \(error)") + throw error } guard sessionRequestNotExpired(requestId: requestId) else { + logger.debug("request expired") try await linkEnvelopesDispatcher.respondError( topic: topic, requestId: requestId, @@ -45,6 +51,7 @@ class LinkSessionResponder { throw Errors.sessionRequestExpired } + logger.debug("will call linkEnvelopesDispatcher.respond()") let responseEnvelope = try await linkEnvelopesDispatcher.respond( topic: topic, response: RPCResponse(id: requestId, outcome: response), @@ -55,6 +62,7 @@ class LinkSessionResponder { guard let self = self else {return} sessionRequestsProvider.emitRequestIfPending() } + logger.debug("will return response envelope: \(responseEnvelope)") return responseEnvelope } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift index 66f6d1572..fa61d3971 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift @@ -33,6 +33,7 @@ class SessionResponderDispatcher { try await relaySessionResponder.respondSessionRequest(topic: topic, requestId: requestId, response: response) return nil case .linkMode: + logger.debug("will call linkSessionResponder.respondSessionRequest()") return try await linkSessionResponder.respondSessionRequest(topic: topic, requestId: requestId, response: response) } } From 65a6be1ebe93dba7e1006ac17c017f642b385d1c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 18 Jun 2024 08:08:25 +0200 Subject: [PATCH 633/814] fix auth error code mapping --- Example/DApp/SceneDelegate.swift | 2 +- .../Auth/Types/Errors/AuthError.swift | 15 +++++++++++---- 2 files changed, 12 insertions(+), 5 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index f85038903..e6dbacb12 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -69,7 +69,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { switch result { case .success((_, _)): AlertPresenter.present(message: "User Authenticted with SIWE", type: .success) - case .failure(let error): + case .failure(_): break } }.store(in: &publishers) diff --git a/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift b/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift index 715e0cd77..7120bcf39 100644 --- a/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift +++ b/Sources/WalletConnectSign/Auth/Types/Errors/AuthError.swift @@ -9,6 +9,7 @@ public enum AuthError: Codable, Equatable, Error, LocalizedError { case malformedRequestParams case messageCompromised case signatureVerificationFailed + case userRejectedRequest } extension AuthError: Reason { @@ -27,6 +28,8 @@ extension AuthError: Reason { self = .messageCompromised case Self.signatureVerificationFailed.code: self = .signatureVerificationFailed + case Self.userRejectedRequest.code: + self = .userRejectedRequest default: return nil } @@ -41,13 +44,15 @@ extension AuthError: Reason { case .userRejeted: return 14001 case .malformedResponseParams: - return 12001 + return 11001 case .malformedRequestParams: - return 12002 + return 11002 case .messageCompromised: - return 12003 + return 11003 case .signatureVerificationFailed: - return 12004 + return 11004 + case .userRejectedRequest: + return 12001 } } @@ -67,6 +72,8 @@ extension AuthError: Reason { return "Message verification failed" case .userDisconnected: return "User Disconnected" + case .userRejectedRequest: + return "User Rejected Request" } } From 9db4bc8d63cf2e21f7a09e58542a132b72f08f99 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 18 Jun 2024 12:09:25 +0200 Subject: [PATCH 634/814] add more logs --- Example/DApp/AppDelegate.swift | 19 +++++++++++++++++++ Example/DApp/SceneDelegate.swift | 10 ++++++++++ 2 files changed, 29 insertions(+) diff --git a/Example/DApp/AppDelegate.swift b/Example/DApp/AppDelegate.swift index 1d9a60efd..acc22e14a 100644 --- a/Example/DApp/AppDelegate.swift +++ b/Example/DApp/AppDelegate.swift @@ -8,6 +8,16 @@ class AppDelegate: UIResponder, UIApplicationDelegate { return true } + func applicationWillEnterForeground(_ application: UIApplication) { + ProfilingService.instance.send(logMessage: .init(message: "AppDelegate: application will enter foreground")) + // Additional code to handle entering the foreground + } + + func applicationDidBecomeActive(_ application: UIApplication) { + ProfilingService.instance.send(logMessage: .init(message: "AppDelegate: application did become active")) + // Additional code to handle becoming active + } + // MARK: UISceneSession Lifecycle func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration { @@ -33,4 +43,13 @@ class AppDelegate: UIResponder, UIApplicationDelegate { // Use this method to release any resources that were specific to the discarded scenes, as they will not return. } + func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool { + // Log the event of opening the app via URL + ProfilingService.instance.send(logMessage: .init(message: "AppDelegate: app opened by URL: \(url.absoluteString)")) + + // Handle the URL appropriately + try! Sign.instance.dispatchEnvelope(url.absoluteString) + + return true + } } diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index e6dbacb12..7141fa9e6 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -133,4 +133,14 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { AlertPresenter.present(message: error.localizedDescription, type: .error) } } + + func sceneWillEnterForeground(_ scene: UIScene) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: scene will enter foreground")) + // Additional code to handle entering the foreground + } + + func sceneDidBecomeActive(_ scene: UIScene) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: scene did become active")) + // Additional code to handle becoming active + } } From 891073afd1a1142b08441105c1556c20cc15541c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 18 Jun 2024 13:35:01 +0200 Subject: [PATCH 635/814] savepoint --- Example/DApp/SceneDelegate.swift | 110 ++++++++++-------- .../AuthRequest/AuthRequestPresenter.swift | 2 +- 2 files changed, 63 insertions(+), 49 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 7141fa9e6..2153d26f3 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -28,8 +28,68 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { } func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { + configureClientsIfNeeded() + setUpProfilingIfNeeded() ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: willConnectTo : \(String(describing: connectionOptions.userActivities.first?.webpageURL?.absoluteString))")) + configureClientsIfNeeded() + setUpProfilingIfNeeded() + + + setupWindow(scene: scene) + } + + private func setupWindow(scene: UIScene) { + guard let windowScene = (scene as? UIWindowScene) else { return } + window = UIWindow(windowScene: windowScene) + + let viewController = SignModule.create(app: app) + .wrapToNavigationController() + + window?.rootViewController = viewController + window?.makeKeyAndVisible() + } + + func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: - openURLContexts : \(String(describing: URLContexts.first?.url))")) + + guard let context = URLContexts.first else { return } + + let url = context.url + + guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false), + let queryItems = components.queryItems, + queryItems.contains(where: { $0.name == "wc_ev" }) else { + return + } + + do { + try Sign.instance.dispatchEnvelope(url.absoluteString) + } catch { + AlertPresenter.present(message: error.localizedDescription, type: .error) + } + } + + func sceneWillEnterForeground(_ scene: UIScene) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: scene will enter foreground")) + // Additional code to handle entering the foreground + } + + func sceneDidBecomeActive(_ scene: UIScene) { + ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: scene did become active")) + // Additional code to handle becoming active + } + + private func setUpProfilingIfNeeded() { + if let clientId = try? Networking.interactor.getClientId() { + ProfilingService.instance.setUpProfiling(account: "swift_dapp_\(clientId)", clientId: clientId) + } + } + + var clientsConfigured = false + private func configureClientsIfNeeded() { + if clientsConfigured {return} + else {clientsConfigured = true} Networking.configure( groupIdentifier: Constants.groupIdentifier, projectId: InputConfig.projectId, @@ -43,7 +103,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { icons: ["https://avatars.githubusercontent.com/u/37784886"], redirect: try! AppMetadata.Redirect(native: "wcdapp://", universal: "https://lab.web3modal.com/dapp", linkMode: true) ) - + Web3Modal.configure( projectId: InputConfig.projectId, metadata: metadata, @@ -60,10 +120,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ) ] ) - - if let clientId = try? Networking.interactor.getClientId() { - ProfilingService.instance.setUpProfiling(account: "swift_dapp_\(clientId)", clientId: clientId) - } Web3Modal.instance.authResponsePublisher.sink { (id, result) in switch result { @@ -78,7 +134,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, metadata: metadata ) - + Sign.instance.logger.setLogging(level: .debug) Networking.instance.setLogging(level: .debug) @@ -100,47 +156,5 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { }.store(in: &publishers) Web3Modal.instance.disableAnalytics() - setupWindow(scene: scene) - } - - private func setupWindow(scene: UIScene) { - guard let windowScene = (scene as? UIWindowScene) else { return } - window = UIWindow(windowScene: windowScene) - - let viewController = SignModule.create(app: app) - .wrapToNavigationController() - - window?.rootViewController = viewController - window?.makeKeyAndVisible() - } - - func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { - ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: - openURLContexts : \(String(describing: URLContexts.first?.url))")) - - guard let context = URLContexts.first else { return } - - let url = context.url - - guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false), - let queryItems = components.queryItems, - queryItems.contains(where: { $0.name == "wc_ev" }) else { - return - } - - do { - try Sign.instance.dispatchEnvelope(url.absoluteString) - } catch { - AlertPresenter.present(message: error.localizedDescription, type: .error) - } - } - - func sceneWillEnterForeground(_ scene: UIScene) { - ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: scene will enter foreground")) - // Additional code to handle entering the foreground - } - - func sceneDidBecomeActive(_ scene: UIScene) { - ProfilingService.instance.send(logMessage: .init(message: "SceneDelegate: scene did become active")) - // Additional code to handle becoming active } } diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index ce57ddd3d..fdd623c2f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -87,7 +87,7 @@ final class AuthRequestPresenter: ObservableObject { /* Redirect */ if let uri = request.requester.redirect?.native { - WalletConnectRouter.goBack(uri: uri) +// WalletConnectRouter.goBack(uri: uri) router.dismiss() } else { showSignedSheet.toggle() From 1fcbf6e64d7dc2d7e9b3839414dbef6a7793b65f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 19 Jun 2024 07:23:23 +0200 Subject: [PATCH 636/814] update links dispatcher --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 32 +++++++++++++++---- 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 3ce61f2ef..9ad9c35f2 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -7,6 +7,7 @@ final class LinkEnvelopesDispatcher { case invalidURL case envelopeNotFound case topicNotFound + case failedToOpenUniversalLink(String) } private let serializer: Serializing private let logger: ConsoleLogging @@ -64,10 +65,19 @@ final class LinkEnvelopesDispatcher { logger.debug("Will try to open envelopeUrl: \(envelopeUrl)") - DispatchQueue.main.async { [weak self] in - self?.logger.debug("Will open universal link") - UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) + try await withCheckedThrowingContinuation { continuation in + DispatchQueue.main.async { [weak self] in + self?.logger.debug("Will open universal link") + UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) { success in + if success { + continuation.resume(returning: ()) + } else { + continuation.resume(throwing: Errors.failedToOpenUniversalLink(envelopeUrl.absoluteString)) + } + } + } } + } catch { logger.error("Failed to open url, error: \(error) ") if let id = request.id { @@ -84,10 +94,20 @@ final class LinkEnvelopesDispatcher { try rpcHistory.validate(response) let envelopeUrl = try serializeAndCreateUrl(peerUniversalLink: peerUniversalLink, encodable: response, envelopeType: envelopeType, topic: topic) logger.debug("Prepared envelopeUrl: \(envelopeUrl)") - DispatchQueue.main.async { [weak self] in - self?.logger.debug("Will open universal link") - UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) + + try await withCheckedThrowingContinuation { continuation in + DispatchQueue.main.async { [weak self] in + self?.logger.debug("Will open universal link") + UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) { success in + if success { + continuation.resume(returning: ()) + } else { + continuation.resume(throwing: Errors.failedToOpenUniversalLink(envelopeUrl.absoluteString)) + } + } + } } + try rpcHistory.resolve(response) return envelopeUrl.absoluteString From 8f320a7e957bfc6b5dcee60cc90bf9f9617272da Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 19 Jun 2024 09:59:17 +0200 Subject: [PATCH 637/814] add isRunningTests to link dispatcher --- .../IntegrationTests.xctestplan | 5 +++++ .../Auth/Link/LinkEnvelopesDispatcher.swift | 16 ++++++++++++++-- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan index 3e624e54b..a7e0d1b30 100644 --- a/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan +++ b/Example/ExampleApp.xcodeproj/IntegrationTests.xctestplan @@ -10,6 +10,11 @@ ], "defaultOptions" : { "codeCoverage" : false, + "commandLineArgumentEntries" : [ + { + "argument" : "isTesting" + } + ], "environmentVariableEntries" : [ { "key" : "RELAY_HOST", diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 9ad9c35f2..bd7d093a1 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -66,6 +66,10 @@ final class LinkEnvelopesDispatcher { logger.debug("Will try to open envelopeUrl: \(envelopeUrl)") try await withCheckedThrowingContinuation { continuation in + if isRunningTests() { + continuation.resume(returning: ()) + return + } DispatchQueue.main.async { [weak self] in self?.logger.debug("Will open universal link") UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) { success in @@ -96,8 +100,12 @@ final class LinkEnvelopesDispatcher { logger.debug("Prepared envelopeUrl: \(envelopeUrl)") try await withCheckedThrowingContinuation { continuation in - DispatchQueue.main.async { [weak self] in - self?.logger.debug("Will open universal link") + if isRunningTests() { + continuation.resume(returning: ()) + return + } + DispatchQueue.main.async { [unowned self] in + logger.debug("Will open universal link") UIApplication.shared.open(envelopeUrl, options: [.universalLinksOnly: true]) { success in if success { continuation.resume(returning: ()) @@ -208,4 +216,8 @@ final class LinkEnvelopesDispatcher { logger.debug("Handling link mode response failed: \(error)") } } + + func isRunningTests() -> Bool { + return ProcessInfo.processInfo.arguments.contains("isTesting") + } } From 9c4e315fdab9380fe246e62d14c53355fe46a45a Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 20 Jun 2024 10:19:49 +0200 Subject: [PATCH 638/814] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e07ccaa25..2048a8dce 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Wallet Connect v.2 - Swift +# WalletConnect v.2 - Swift ![CI main](https://github.com/WalletConnect/WalletConnectSwiftV2/actions/workflows/ci.yml/badge.svg?branch=main) ![CI develop](https://github.com/WalletConnect/WalletConnectSwiftV2/actions/workflows/ci.yml/badge.svg?branch=develop) @@ -58,4 +58,4 @@ Apache 2.0 ## Guides -- [Artifacts sometimes not available in Actions -> Build name -> Artifacts?](./docs/guides/downloading_artifacts.md) \ No newline at end of file +- [Artifacts sometimes not available in Actions -> Build name -> Artifacts?](./docs/guides/downloading_artifacts.md) From 8c7e413c6f451304235ed161085ddc7947e0e6ae Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 20 Jun 2024 08:21:15 +0000 Subject: [PATCH 639/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 803999dce..b9ab60bd3 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.2"} +{"version": "1.19.3"} From a6a7d9b5a0c34e7c26a6c06ec23c4614dc9f6e78 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 27 Jun 2024 09:12:16 +0100 Subject: [PATCH 640/814] optimistic pairing removal --- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 2 +- .../Services/Common/Delete/PairingDeleteRequester.swift | 2 +- Sources/WalletConnectSign/Services/SignCleanupService.swift | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 53859947e..3198e81b5 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "25abd7e5471f21d662400f9763948fbf97c60c97", + "revision": "3baac675811b5fdeb689cef703e3dfc7682704e6", "version": null } } diff --git a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift index f976a3cd0..0c2355301 100644 --- a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift +++ b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift @@ -22,7 +22,7 @@ class PairingDeleteRequester { let pairingDeleteParams = PairingDeleteParams(code: reason.code, message: reason.message) logger.debug("Will delete pairing for reason: message: \(reason.message) code: \(reason.code)") let request = RPCRequest(method: protocolMethod.method, params: pairingDeleteParams) - try await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) + try? await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) pairingStorage.delete(topic: topic) kms.deleteSymmetricKey(for: topic) networkingInteractor.unsubscribe(topic: topic) diff --git a/Sources/WalletConnectSign/Services/SignCleanupService.swift b/Sources/WalletConnectSign/Services/SignCleanupService.swift index 5c2a6ec1c..fef62e04c 100644 --- a/Sources/WalletConnectSign/Services/SignCleanupService.swift +++ b/Sources/WalletConnectSign/Services/SignCleanupService.swift @@ -35,7 +35,7 @@ private extension SignCleanupService { let pairing = pairingStore.getAll().map { $0.topic } let session = sessionStore.getAll().map { $0.topic } - try await networkInteractor.batchUnsubscribe(topics: pairing + session) + try? await networkInteractor.batchUnsubscribe(topics: pairing + session) } func cleanupStorages() throws { @@ -43,6 +43,6 @@ private extension SignCleanupService { sessionStore.deleteAll() sessionTopicToProposal.deleteAll() rpcHistory.deleteAll() - try kms.deleteAll() + try? kms.deleteAll() } } From 4fe67fd14dfc84b250229f842e281cc32e5e30cb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 27 Jun 2024 09:40:36 +0100 Subject: [PATCH 641/814] no throwing function --- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 2 +- Sources/WalletConnectPairing/PairingClient.swift | 4 ++-- .../Services/Common/Delete/PairingDeleteRequester.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 3198e81b5..53859947e 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,7 +186,7 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "3baac675811b5fdeb689cef703e3dfc7682704e6", + "revision": "25abd7e5471f21d662400f9763948fbf97c60c97", "version": null } } diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 44e79f7b2..233fcd76b 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -128,8 +128,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient try await pingService.ping(topic: topic) } - public func disconnect(topic: String) async throws { - try await pairingDeleteRequester.delete(topic: topic) + public func disconnect(topic: String) async { + await pairingDeleteRequester.delete(topic: topic) } public func validatePairingExistance(_ topic: String) throws { diff --git a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift index 0c2355301..c8c08ba34 100644 --- a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift +++ b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift @@ -16,7 +16,7 @@ class PairingDeleteRequester { self.logger = logger } - func delete(topic: String) async throws { + func delete(topic: String) async { let reason = PairingReasonCode.userDisconnected let protocolMethod = PairingProtocolMethod.delete let pairingDeleteParams = PairingDeleteParams(code: reason.code, message: reason.message) diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 1ca6727d2..7b062359b 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -177,7 +177,7 @@ public class Web3WalletClient { try await pairingClient.pair(uri: uri) } - public func disconnectPairing(topic: String) async throws { + public func disconnectPairing(topic: String) async { try await pairingClient.disconnect(topic: topic) } From ccf37f8b4f45c28a24379e93d39238d8568893fe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 27 Jun 2024 10:52:12 +0100 Subject: [PATCH 642/814] fix build --- Sources/WalletConnectPairing/PairingClientProtocol.swift | 2 +- Sources/Web3Wallet/Web3WalletClient.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectPairing/PairingClientProtocol.swift b/Sources/WalletConnectPairing/PairingClientProtocol.swift index 905c1b4e8..f97e1458f 100644 --- a/Sources/WalletConnectPairing/PairingClientProtocol.swift +++ b/Sources/WalletConnectPairing/PairingClientProtocol.swift @@ -6,6 +6,6 @@ public protocol PairingClientProtocol { var pairingStatePublisher: AnyPublisher {get} var pairingExpirationPublisher: AnyPublisher {get} func pair(uri: WalletConnectURI) async throws - func disconnect(topic: String) async throws + func disconnect(topic: String) async func getPairings() -> [Pairing] } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 7b062359b..84f636b92 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -178,7 +178,7 @@ public class Web3WalletClient { } public func disconnectPairing(topic: String) async { - try await pairingClient.disconnect(topic: topic) + await pairingClient.disconnect(topic: topic) } /// For a wallet and a dApp to terminate a session From 4e3826aece1130e8fc1a16122416bc54bdf1a14c Mon Sep 17 00:00:00 2001 From: llbartekll Date: Thu, 27 Jun 2024 11:52:59 +0000 Subject: [PATCH 643/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index b9ab60bd3..ec58e3328 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.3"} +{"version": "1.19.4"} From 02ffb137926abd0813d59cebe30b348937886312 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 2 Jul 2024 15:52:32 +0200 Subject: [PATCH 644/814] savepoint --- Package.swift | 3 ++ Sources/Events/Event.swift | 20 ++++++++ Sources/Events/EventStorage.swift | 36 ++++++++++++++ Sources/Events/EventsClient.swift | 48 +++++++++++++++++++ .../NewPairingExecutionTraceEvents.swift | 30 ++++++++++++ 5 files changed, 137 insertions(+) create mode 100644 Sources/Events/Event.swift create mode 100644 Sources/Events/EventStorage.swift create mode 100644 Sources/Events/EventsClient.swift create mode 100644 Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift diff --git a/Package.swift b/Package.swift index b255c6b99..6667cedb9 100644 --- a/Package.swift +++ b/Package.swift @@ -126,6 +126,9 @@ let package = Package( .target( name: "Database", dependencies: ["WalletConnectUtils"]), + .target( + name: "Events", + dependencies: []), .target( name: "WalletConnectModal", dependencies: ["QRCode", "WalletConnectSign"], diff --git a/Sources/Events/Event.swift b/Sources/Events/Event.swift new file mode 100644 index 000000000..29b2f8e13 --- /dev/null +++ b/Sources/Events/Event.swift @@ -0,0 +1,20 @@ +import Foundation + + +struct Event: Codable { + let eventId: String + let bundleId: String + let timestamp: Int64 + let props: Props +} + +struct Props: Codable { + let event: String + let type: String + let properties: Properties? +} + +struct Properties: Codable { + let topic: String? + let trace: [String]? +} diff --git a/Sources/Events/EventStorage.swift b/Sources/Events/EventStorage.swift new file mode 100644 index 000000000..4622c5dcb --- /dev/null +++ b/Sources/Events/EventStorage.swift @@ -0,0 +1,36 @@ +// + +import Foundation + + +// Protocol for EventStorage +protocol EventStorage { + func saveErrorTrace(_ trace: [String]) + func fetchErrorTraces() -> [[String]] + func clearErrorTraces() +} + +// Default implementation using UserDefaults +class UserDefaultsEventStorage: EventStorage { + private let errorTracesKey = "errorTraces" + + func saveErrorTrace(_ trace: [String]) { + var existingTraces = fetchErrorTraces() + existingTraces.append(trace) + if let encoded = try? JSONEncoder().encode(existingTraces) { + UserDefaults.standard.set(encoded, forKey: errorTracesKey) + } + } + + func fetchErrorTraces() -> [[String]] { + if let data = UserDefaults.standard.data(forKey: errorTracesKey), + let traces = try? JSONDecoder().decode([[String]].self, from: data) { + return traces + } + return [] + } + + func clearErrorTraces() { + UserDefaults.standard.removeObject(forKey: errorTracesKey) + } +} diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift new file mode 100644 index 000000000..16aa4c53a --- /dev/null +++ b/Sources/Events/EventsClient.swift @@ -0,0 +1,48 @@ +import Foundation + +// Protocol for TraceEvent +protocol TraceEvent: CustomStringConvertible { + var description: String { get } +} + +// Protocol for ErrorEvent +protocol ErrorEvent: TraceEvent {} + + +// EventsCollector Class +class EventsCollector { + private var trace: [String] = [] + private var topic: String? + private let storage: EventStorage + + init(storage: EventStorage) { + self.storage = storage + } + + // Function to start trace with topic + func startTrace(topic: String) { + self.topic = topic + self.trace = [] + } + + // Function to save event + func saveEvent(_ event: TraceEvent) { + trace.append(event.description) + if event is ErrorEvent { + saveErrorTrace() + endTrace() + } + } + + // Function to end trace + func endTrace() { + self.topic = nil + self.trace = [] + } + + // Private function to save error trace + private func saveErrorTrace() { + storage.saveErrorTrace(trace) + print("Error trace saved: \(trace)") + } +} diff --git a/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift new file mode 100644 index 000000000..b5c060324 --- /dev/null +++ b/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift @@ -0,0 +1,30 @@ + +import Foundation + +enum NewPairingExecutionTraceEvents: String, TraceEvent { + case pairingStarted = "pairing_started" + case pairingUriValidationSuccess = "pairing_uri_validation_success" + case pairingUriNotExpired = "pairing_uri_not_expired" + case storeNewPairing = "store_new_pairing" + case subscribingPairingTopic = "subscribing_pairing_topic" + case subscribePairingTopicSuccess = "subscribe_pairing_topic_success" + + var description: String { + return self.rawValue + } +} + +// Enum for TraceErrorEvents +enum TraceErrorEvents: String, ErrorEvent { + case noWssConnection = "no_wss_connection" + case noInternetConnection = "no_internet_connection" + case malformedPairingUri = "malformed_pairing_uri" + case activePairingAlreadyExists = "active_pairing_already_exists" + case subscribePairingTopicFailure = "subscribe_pairing_topic_failure" + case pairingExpired = "pairing_expired" + case proposalExpired = "proposal_expired" + + var description: String { + return self.rawValue + } +} From 802ce62ea94898c7fe24c84d59cd7215968198c1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jul 2024 07:33:42 +0200 Subject: [PATCH 645/814] add tests scheme --- .../xcschemes/EventsTests 1.xcscheme | 54 +++++++++++++++++++ .../xcschemes/EventsTests.xcscheme | 54 +++++++++++++++++++ Package.swift | 7 ++- .../Engine/Common/ApproveEngine.swift | 1 + Tests/EventsTests/EventsCollectorTests.swift | 6 +++ 5 files changed, 120 insertions(+), 2 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/EventsTests.xcscheme create mode 100644 Tests/EventsTests/EventsCollectorTests.swift diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme new file mode 100644 index 000000000..7f7753025 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme @@ -0,0 +1,54 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests.xcscheme new file mode 100644 index 000000000..7f7753025 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests.xcscheme @@ -0,0 +1,54 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Package.swift b/Package.swift index 6667cedb9..97e0775cf 100644 --- a/Package.swift +++ b/Package.swift @@ -51,7 +51,7 @@ let package = Package( targets: [ .target( name: "WalletConnectSign", - dependencies: ["WalletConnectPairing", "WalletConnectVerify", "WalletConnectSigner"], + dependencies: ["WalletConnectPairing", "WalletConnectVerify", "WalletConnectSigner", "Events"], path: "Sources/WalletConnectSign", resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( @@ -172,7 +172,10 @@ let package = Package( dependencies: ["Commons", "TestingUtils"]), .testTarget( name: "WalletConnectModalTests", - dependencies: ["WalletConnectModal", "TestingUtils"]) + dependencies: ["WalletConnectModal", "TestingUtils"]), + .testTarget( + name: "EventsTests", + dependencies: ["Events"]), ], swiftLanguageVersions: [.v5] ) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index eabb88d6b..4f3f0b4c4 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -1,5 +1,6 @@ import Foundation import Combine +import Events final class ApproveEngine { enum Errors: Error { diff --git a/Tests/EventsTests/EventsCollectorTests.swift b/Tests/EventsTests/EventsCollectorTests.swift new file mode 100644 index 000000000..3354cfb2d --- /dev/null +++ b/Tests/EventsTests/EventsCollectorTests.swift @@ -0,0 +1,6 @@ +import Foundation +import XCTest + +class EventsCollectorTests: XCTestCase { + +} From 79c3c2cfbba74a5e655e682192289c90e48911ca Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jul 2024 08:20:15 +0200 Subject: [PATCH 646/814] add EventsCollectorTests --- Sources/Events/EventStorage.swift | 30 +++++------ Sources/Events/EventsClient.swift | 53 ++++++++++++++++---- Tests/EventsTests/EventsCollectorTests.swift | 53 ++++++++++++++++++++ 3 files changed, 111 insertions(+), 25 deletions(-) diff --git a/Sources/Events/EventStorage.swift b/Sources/Events/EventStorage.swift index 4622c5dcb..f128ae2e2 100644 --- a/Sources/Events/EventStorage.swift +++ b/Sources/Events/EventStorage.swift @@ -5,32 +5,32 @@ import Foundation // Protocol for EventStorage protocol EventStorage { - func saveErrorTrace(_ trace: [String]) - func fetchErrorTraces() -> [[String]] - func clearErrorTraces() + func saveErrorEvent(_ event: Event) + func fetchErrorEvents() -> [Event] + func clearErrorEvents() } // Default implementation using UserDefaults class UserDefaultsEventStorage: EventStorage { - private let errorTracesKey = "errorTraces" + private let errorEventsKey = "com.walletconnect.sdk.errorEvents" - func saveErrorTrace(_ trace: [String]) { - var existingTraces = fetchErrorTraces() - existingTraces.append(trace) - if let encoded = try? JSONEncoder().encode(existingTraces) { - UserDefaults.standard.set(encoded, forKey: errorTracesKey) + func saveErrorEvent(_ event: Event) { + var existingEvents = fetchErrorEvents() + existingEvents.append(event) + if let encoded = try? JSONEncoder().encode(existingEvents) { + UserDefaults.standard.set(encoded, forKey: errorEventsKey) } } - func fetchErrorTraces() -> [[String]] { - if let data = UserDefaults.standard.data(forKey: errorTracesKey), - let traces = try? JSONDecoder().decode([[String]].self, from: data) { - return traces + func fetchErrorEvents() -> [Event] { + if let data = UserDefaults.standard.data(forKey: errorEventsKey), + let events = try? JSONDecoder().decode([Event].self, from: data) { + return events } return [] } - func clearErrorTraces() { - UserDefaults.standard.removeObject(forKey: errorTracesKey) + func clearErrorEvents() { + UserDefaults.standard.removeObject(forKey: errorEventsKey) } } diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 16aa4c53a..8b2b5fdec 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -9,14 +9,15 @@ protocol TraceEvent: CustomStringConvertible { protocol ErrorEvent: TraceEvent {} -// EventsCollector Class class EventsCollector { - private var trace: [String] = [] - private var topic: String? + var trace: [String] = [] + var topic: String? private let storage: EventStorage + private let bundleId: String - init(storage: EventStorage) { + init(storage: EventStorage, bundleId: String) { self.storage = storage + self.bundleId = bundleId } // Function to start trace with topic @@ -28,8 +29,8 @@ class EventsCollector { // Function to save event func saveEvent(_ event: TraceEvent) { trace.append(event.description) - if event is ErrorEvent { - saveErrorTrace() + if let errorEvent = event as? ErrorEvent { + saveErrorEvent(errorEvent) endTrace() } } @@ -40,9 +41,41 @@ class EventsCollector { self.trace = [] } - // Private function to save error trace - private func saveErrorTrace() { - storage.saveErrorTrace(trace) - print("Error trace saved: \(trace)") + // Private function to save error event + private func saveErrorEvent(_ errorEvent: ErrorEvent) { + let event = Event( + eventId: UUID().uuidString, + bundleId: bundleId, + timestamp: Int64(Date().timeIntervalSince1970 * 1000), + props: Props( + event: "ERROR", + type: errorEvent.description, + properties: Properties( + topic: topic, + trace: trace + ) + ) + ) + storage.saveErrorEvent(event) + print("Error event saved: \(event)") } } + + +#if DEBUG +class MockEventStorage: EventStorage { + private(set) var savedEvents: [Event] = [] + + func saveErrorEvent(_ event: Event) { + savedEvents.append(event) + } + + func fetchErrorEvents() -> [Event] { + return savedEvents + } + + func clearErrorEvents() { + savedEvents.removeAll() + } +} +#endif diff --git a/Tests/EventsTests/EventsCollectorTests.swift b/Tests/EventsTests/EventsCollectorTests.swift index 3354cfb2d..d5b3ccef0 100644 --- a/Tests/EventsTests/EventsCollectorTests.swift +++ b/Tests/EventsTests/EventsCollectorTests.swift @@ -1,6 +1,59 @@ import Foundation import XCTest +@testable import Events class EventsCollectorTests: XCTestCase { + var mockStorage: MockEventStorage! + var eventsCollector: EventsCollector! + + override func setUp() { + super.setUp() + mockStorage = MockEventStorage() + eventsCollector = EventsCollector(storage: mockStorage, bundleId: "com.wallet.example") + } + + override func tearDown() { + eventsCollector = nil + mockStorage = nil + super.tearDown() + } + + func testStartTrace() { + eventsCollector.startTrace(topic: "test_topic") + XCTAssertEqual(eventsCollector.topic, "test_topic") + XCTAssertEqual(eventsCollector.trace.count, 0) + } + + func testSaveEvent() { + eventsCollector.startTrace(topic: "test_topic") + eventsCollector.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) + + XCTAssertEqual(eventsCollector.trace, ["pairing_started"]) + XCTAssertEqual(mockStorage.savedEvents.count, 0) + } + + func testSaveErrorEvent() { + eventsCollector.startTrace(topic: "test_topic") + eventsCollector.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) + eventsCollector.saveEvent(TraceErrorEvents.noInternetConnection) + + XCTAssertEqual(mockStorage.savedEvents.count, 1) + let savedEvent = mockStorage.savedEvents.first + XCTAssertNotNil(savedEvent) + XCTAssertEqual(savedEvent?.props.type, "no_internet_connection") + XCTAssertEqual(savedEvent?.props.properties?.topic, "test_topic") + XCTAssertEqual(savedEvent?.props.properties?.trace, ["pairing_started", "no_internet_connection"]) + XCTAssertNil(eventsCollector.topic) + XCTAssertEqual(eventsCollector.trace.count, 0) + } + + func testEndTrace() { + eventsCollector.startTrace(topic: "test_topic") + eventsCollector.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) + eventsCollector.endTrace() + + XCTAssertNil(eventsCollector.topic) + XCTAssertEqual(eventsCollector.trace.count, 0) + } } From 5302e2e577c271cd2482bcb6ca8a1eefa14de260 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jul 2024 12:21:10 +0200 Subject: [PATCH 647/814] Add networking --- Sources/Events/Event.swift | 1 - Sources/Events/EventStorage.swift | 23 +++- Sources/Events/EventsClient.swift | 100 ++++++------------ Sources/Events/EventsCollector.swift | 63 +++++++++++ Sources/Events/EventsDispatcher.swift | 39 +++++++ Sources/Events/NetworkingService.swift | 67 ++++++++++++ Tests/EventsTests/EventsCollectorTests.swift | 9 -- Tests/EventsTests/EventsDispatcherTests.swift | 38 +++++++ 8 files changed, 261 insertions(+), 79 deletions(-) create mode 100644 Sources/Events/EventsCollector.swift create mode 100644 Sources/Events/EventsDispatcher.swift create mode 100644 Sources/Events/NetworkingService.swift create mode 100644 Tests/EventsTests/EventsDispatcherTests.swift diff --git a/Sources/Events/Event.swift b/Sources/Events/Event.swift index 29b2f8e13..cc8c4d3c1 100644 --- a/Sources/Events/Event.swift +++ b/Sources/Events/Event.swift @@ -1,6 +1,5 @@ import Foundation - struct Event: Codable { let eventId: String let bundleId: String diff --git a/Sources/Events/EventStorage.swift b/Sources/Events/EventStorage.swift index f128ae2e2..348e5b7c1 100644 --- a/Sources/Events/EventStorage.swift +++ b/Sources/Events/EventStorage.swift @@ -1,9 +1,6 @@ -// import Foundation - -// Protocol for EventStorage protocol EventStorage { func saveErrorEvent(_ event: Event) func fetchErrorEvents() -> [Event] @@ -34,3 +31,23 @@ class UserDefaultsEventStorage: EventStorage { UserDefaults.standard.removeObject(forKey: errorEventsKey) } } + + +#if DEBUG +class MockEventStorage: EventStorage { + private(set) var savedEvents: [Event] = [] + + func saveErrorEvent(_ event: Event) { + savedEvents.append(event) + } + + func fetchErrorEvents() -> [Event] { + return savedEvents + } + + func clearErrorEvents() { + savedEvents.removeAll() + } +} +#endif + diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 8b2b5fdec..ff29c7f3a 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -1,81 +1,49 @@ import Foundation -// Protocol for TraceEvent -protocol TraceEvent: CustomStringConvertible { - var description: String { get } -} - -// Protocol for ErrorEvent -protocol ErrorEvent: TraceEvent {} - - -class EventsCollector { - var trace: [String] = [] - var topic: String? - private let storage: EventStorage - private let bundleId: String - init(storage: EventStorage, bundleId: String) { - self.storage = storage - self.bundleId = bundleId - } - - // Function to start trace with topic - func startTrace(topic: String) { - self.topic = topic - self.trace = [] - } +import Foundation - // Function to save event - func saveEvent(_ event: TraceEvent) { - trace.append(event.description) - if let errorEvent = event as? ErrorEvent { - saveErrorEvent(errorEvent) - endTrace() - } +class EventsClientFactory { + static func createEventsClient(projectId: String, sdkType: String, sdkVersion: String, bundleId: String) -> EventsClient { + let storage = UserDefaultsEventStorage() + let networkingService = NetworkingService(projectId: projectId, sdkType: sdkType, sdkVersion: sdkVersion) + return EventsClient(storage: storage, bundleId: bundleId, networkingService: networkingService) } +} +class EventsClient { + private let eventsCollector: EventsCollector + private let eventsDispatcher: EventsDispatcher - // Function to end trace - func endTrace() { - self.topic = nil - self.trace = [] + init(storage: EventStorage, bundleId: String, networkingService: NetworkingServiceProtocol) { + self.eventsCollector = EventsCollector(storage: storage, bundleId: bundleId) + let retryPolicy = RetryPolicy(maxAttempts: 3, initialDelay: 5, multiplier: 2) + self.eventsDispatcher = EventsDispatcher(networkingService: networkingService, retryPolicy: retryPolicy) + Task { await sendStoredEvents() } } - // Private function to save error event - private func saveErrorEvent(_ errorEvent: ErrorEvent) { - let event = Event( - eventId: UUID().uuidString, - bundleId: bundleId, - timestamp: Int64(Date().timeIntervalSince1970 * 1000), - props: Props( - event: "ERROR", - type: errorEvent.description, - properties: Properties( - topic: topic, - trace: trace - ) - ) - ) - storage.saveErrorEvent(event) - print("Error event saved: \(event)") + // Public method to start trace + public func startTrace(topic: String) { + eventsCollector.startTrace(topic: topic) } -} - -#if DEBUG -class MockEventStorage: EventStorage { - private(set) var savedEvents: [Event] = [] - - func saveErrorEvent(_ event: Event) { - savedEvents.append(event) + // Public method to save event + public func saveEvent(_ event: TraceEvent) { + eventsCollector.saveEvent(event) } - func fetchErrorEvents() -> [Event] { - return savedEvents - } + // Public method to send stored events + private func sendStoredEvents() async { + let events = eventsCollector.storage.fetchErrorEvents() + guard !events.isEmpty else { return } - func clearErrorEvents() { - savedEvents.removeAll() + do { + let success: Bool = try await eventsDispatcher.executeWithRetry(events: events) + if success { + self.eventsCollector.storage.clearErrorEvents() + } + } catch { + print("Failed to send events after multiple attempts: \(error)") + } } } -#endif + diff --git a/Sources/Events/EventsCollector.swift b/Sources/Events/EventsCollector.swift new file mode 100644 index 000000000..a8a6cbeb6 --- /dev/null +++ b/Sources/Events/EventsCollector.swift @@ -0,0 +1,63 @@ +import Foundation + +// Protocol for TraceEvent +protocol TraceEvent: CustomStringConvertible { + var description: String { get } +} + +// Protocol for ErrorEvent +protocol ErrorEvent: TraceEvent {} + + +class EventsCollector { + var trace: [String] = [] + var topic: String? + let storage: EventStorage + private let bundleId: String + + init(storage: EventStorage, bundleId: String) { + self.storage = storage + self.bundleId = bundleId + } + + // Function to start trace with topic + func startTrace(topic: String) { + self.topic = topic + self.trace = [] + } + + // Function to save event + func saveEvent(_ event: TraceEvent) { + trace.append(event.description) + if let errorEvent = event as? ErrorEvent { + saveErrorEvent(errorEvent) + endTrace() + } + } + + // Function to end trace + private func endTrace() { + self.topic = nil + self.trace = [] + } + + // Private function to save error event + private func saveErrorEvent(_ errorEvent: ErrorEvent) { + let event = Event( + eventId: UUID().uuidString, + bundleId: bundleId, + timestamp: Int64(Date().timeIntervalSince1970 * 1000), + props: Props( + event: "ERROR", + type: errorEvent.description, + properties: Properties( + topic: topic, + trace: trace + ) + ) + ) + storage.saveErrorEvent(event) + print("Error event saved: \(event)") + } +} + diff --git a/Sources/Events/EventsDispatcher.swift b/Sources/Events/EventsDispatcher.swift new file mode 100644 index 000000000..4df0eaee7 --- /dev/null +++ b/Sources/Events/EventsDispatcher.swift @@ -0,0 +1,39 @@ + +import Foundation + +struct RetryPolicy { + let maxAttempts: Int + let initialDelay: TimeInterval + let multiplier: Double + var delayOverride: TimeInterval? = nil +} + +class EventsDispatcher { + private let networkingService: NetworkingServiceProtocol + private let retryPolicy: RetryPolicy + + init(networkingService: NetworkingServiceProtocol, retryPolicy: RetryPolicy) { + self.networkingService = networkingService + self.retryPolicy = retryPolicy + } + + func executeWithRetry(events: [Event]) async throws -> Bool { + var attempts = 0 + var delay = retryPolicy.initialDelay + + while attempts < retryPolicy.maxAttempts { + attempts += 1 + do { + return try await networkingService.sendEvents(events) + } catch { + if attempts >= retryPolicy.maxAttempts { + throw error + } + let actualDelay = retryPolicy.delayOverride ?? delay + try await Task.sleep(nanoseconds: UInt64(actualDelay * Double(NSEC_PER_SEC))) + delay *= retryPolicy.multiplier + } + } + throw NSError(domain: "EventsDispatcherError", code: -1, userInfo: [NSLocalizedDescriptionKey: "Max retry attempts reached"]) + } +} diff --git a/Sources/Events/NetworkingService.swift b/Sources/Events/NetworkingService.swift new file mode 100644 index 000000000..8f7b647c1 --- /dev/null +++ b/Sources/Events/NetworkingService.swift @@ -0,0 +1,67 @@ + +import Foundation + +protocol NetworkingServiceProtocol { + func sendEvents(_ events: [Event]) async throws -> Bool +} + + +class NetworkingService: NetworkingServiceProtocol { + private let session: URLSession + private let projectId: String + private let sdkType: String + private let sdkVersion: String + private let apiURL = URL(string: "https://pulse.walletconnect.com/batch")! + + init(session: URLSession = .shared, projectId: String, sdkType: String, sdkVersion: String) { + self.session = session + self.projectId = projectId + self.sdkType = sdkType + self.sdkVersion = sdkVersion + } + + func sendEvents(_ events: [Event]) async throws -> Bool { + var request = URLRequest(url: apiURL) + request.httpMethod = "POST" + request.setValue("application/json", forHTTPHeaderField: "Content-Type") + request.setValue(projectId, forHTTPHeaderField: "x-project-id") + request.setValue(sdkType, forHTTPHeaderField: "x-sdk-type") + request.setValue(sdkVersion, forHTTPHeaderField: "x-sdk-version") + + request.httpBody = try JSONEncoder().encode(events) + + return try await withCheckedThrowingContinuation { continuation in + let task = session.dataTask(with: request) { data, response, error in + if let error = error { + continuation.resume(throwing: error) + return + } + + guard let httpResponse = response as? HTTPURLResponse, httpResponse.statusCode == 200 else { + continuation.resume(returning: false) + return + } + + continuation.resume(returning: true) + } + + task.priority = URLSessionTask.lowPriority + task.resume() + } + } +} + +#if DEBUG +class MockNetworkingService: NetworkingServiceProtocol { + var shouldFail = false + var attemptCount = 0 + + func sendEvents(_ events: [Event]) async throws -> Bool { + attemptCount += 1 + if shouldFail { + throw NSError(domain: "MockError", code: -1, userInfo: nil) + } + return true + } +} +#endif diff --git a/Tests/EventsTests/EventsCollectorTests.swift b/Tests/EventsTests/EventsCollectorTests.swift index d5b3ccef0..2379c500a 100644 --- a/Tests/EventsTests/EventsCollectorTests.swift +++ b/Tests/EventsTests/EventsCollectorTests.swift @@ -47,13 +47,4 @@ class EventsCollectorTests: XCTestCase { XCTAssertNil(eventsCollector.topic) XCTAssertEqual(eventsCollector.trace.count, 0) } - - func testEndTrace() { - eventsCollector.startTrace(topic: "test_topic") - eventsCollector.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) - eventsCollector.endTrace() - - XCTAssertNil(eventsCollector.topic) - XCTAssertEqual(eventsCollector.trace.count, 0) - } } diff --git a/Tests/EventsTests/EventsDispatcherTests.swift b/Tests/EventsTests/EventsDispatcherTests.swift new file mode 100644 index 000000000..e7b980e5a --- /dev/null +++ b/Tests/EventsTests/EventsDispatcherTests.swift @@ -0,0 +1,38 @@ +import XCTest +@testable import Events + +class EventsDispatcherTests: XCTestCase { + var mockNetworkingService: MockNetworkingService! + var eventsDispatcher: EventsDispatcher! + let events = [Event(eventId: UUID().uuidString, bundleId: "com.wallet.example", timestamp: Int64(Date().timeIntervalSince1970 * 1000), props: Props(event: "ERROR", type: "test_error", properties: Properties(topic: "test_topic", trace: ["test_trace"])))] + + override func setUp() { + super.setUp() + mockNetworkingService = MockNetworkingService() + let retryPolicy = RetryPolicy(maxAttempts: 3, initialDelay: 1, multiplier: 1.5, delayOverride: 0.001) + eventsDispatcher = EventsDispatcher(networkingService: mockNetworkingService, retryPolicy: retryPolicy) + } + + override func tearDown() { + eventsDispatcher = nil + mockNetworkingService = nil + super.tearDown() + } + + func testRetrySuccess() async throws { + mockNetworkingService.shouldFail = true + do { + _ = try await eventsDispatcher.executeWithRetry(events: events) + XCTFail("Expected to throw an error") + } catch { + XCTAssertEqual(mockNetworkingService.attemptCount, 3) + } + } + + func testRetryFailure() async throws { + mockNetworkingService.shouldFail = false + let result = try await eventsDispatcher.executeWithRetry(events: events) + XCTAssertEqual(result, true) + XCTAssertEqual(mockNetworkingService.attemptCount, 1) + } +} From 9a5a08eed69a6a6cecebd5c9a9fd60b37cd732fa Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 3 Jul 2024 12:26:57 +0200 Subject: [PATCH 648/814] savepoint --- Sources/Events/EventsClient.swift | 9 --------- Sources/Events/EventsClientFactory.swift | 10 ++++++++++ 2 files changed, 10 insertions(+), 9 deletions(-) create mode 100644 Sources/Events/EventsClientFactory.swift diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index ff29c7f3a..4a05fa9cf 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -1,15 +1,6 @@ import Foundation -import Foundation - -class EventsClientFactory { - static func createEventsClient(projectId: String, sdkType: String, sdkVersion: String, bundleId: String) -> EventsClient { - let storage = UserDefaultsEventStorage() - let networkingService = NetworkingService(projectId: projectId, sdkType: sdkType, sdkVersion: sdkVersion) - return EventsClient(storage: storage, bundleId: bundleId, networkingService: networkingService) - } -} class EventsClient { private let eventsCollector: EventsCollector private let eventsDispatcher: EventsDispatcher diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift new file mode 100644 index 000000000..f69c727cc --- /dev/null +++ b/Sources/Events/EventsClientFactory.swift @@ -0,0 +1,10 @@ + +import Foundation + +class EventsClientFactory { + static func createEventsClient(projectId: String, sdkType: String, sdkVersion: String, bundleId: String) -> EventsClient { + let storage = UserDefaultsEventStorage() + let networkingService = NetworkingService(projectId: projectId, sdkType: sdkType, sdkVersion: sdkVersion) + return EventsClient(storage: storage, bundleId: bundleId, networkingService: networkingService) + } +} From 8d00c136d5316f95ec9caaad80f9834b542ce07e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jul 2024 09:37:09 +0200 Subject: [PATCH 649/814] savepoint --- Example/DApp/SceneDelegate.swift | 9 +++++++ Package.swift | 2 +- Sources/Events/EventsClient.swift | 21 +++++++++------- Sources/Events/EventsClientFactory.swift | 24 +++++++++++++++---- Sources/Events/EventsCollector.swift | 10 ++++++-- Sources/Events/EventsImports.swift | 3 +++ .../Auth/Link/LinkAuthRequester.swift | 1 - 7 files changed, 53 insertions(+), 17 deletions(-) create mode 100644 Sources/Events/EventsImports.swift diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 2153d26f3..5d5c3cb62 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -117,6 +117,15 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { order: 1, mobileLink: "walletapp://", linkMode: "https://lab.web3modal.com/wallet" + ), + .init( + id: "rn-sample", + name: "RN Sample Wallet", + homepage: "https://walletconnect.com/", + imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", + order: 1, + mobileLink: "rn-web3wallet://", + linkMode: "https://lab.web3modal.com/walletkit_rn" ) ] ) diff --git a/Package.swift b/Package.swift index 97e0775cf..2b1a5f766 100644 --- a/Package.swift +++ b/Package.swift @@ -128,7 +128,7 @@ let package = Package( dependencies: ["WalletConnectUtils"]), .target( name: "Events", - dependencies: []), + dependencies: ["WalletConnectUtils"]), .target( name: "WalletConnectModal", dependencies: ["QRCode", "WalletConnectSign"], diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 4a05fa9cf..854923a05 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -1,14 +1,18 @@ import Foundation - class EventsClient { private let eventsCollector: EventsCollector private let eventsDispatcher: EventsDispatcher - - init(storage: EventStorage, bundleId: String, networkingService: NetworkingServiceProtocol) { - self.eventsCollector = EventsCollector(storage: storage, bundleId: bundleId) - let retryPolicy = RetryPolicy(maxAttempts: 3, initialDelay: 5, multiplier: 2) - self.eventsDispatcher = EventsDispatcher(networkingService: networkingService, retryPolicy: retryPolicy) + private let logger: ConsoleLogging + + init( + eventsCollector: EventsCollector, + eventsDispatcher: EventsDispatcher, + logger: ConsoleLogging + ) { + self.eventsCollector = eventsCollector + self.eventsDispatcher = eventsDispatcher + self.logger = logger Task { await sendStoredEvents() } } @@ -23,7 +27,7 @@ class EventsClient { } // Public method to send stored events - private func sendStoredEvents() async { + public func sendStoredEvents() async { let events = eventsCollector.storage.fetchErrorEvents() guard !events.isEmpty else { return } @@ -33,8 +37,7 @@ class EventsClient { self.eventsCollector.storage.clearErrorEvents() } } catch { - print("Failed to send events after multiple attempts: \(error)") + logger.debug("Failed to send events after multiple attempts: \(error)") } } } - diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift index f69c727cc..5b1489b69 100644 --- a/Sources/Events/EventsClientFactory.swift +++ b/Sources/Events/EventsClientFactory.swift @@ -1,10 +1,26 @@ - import Foundation class EventsClientFactory { - static func createEventsClient(projectId: String, sdkType: String, sdkVersion: String, bundleId: String) -> EventsClient { + static func createEventsClient( + projectId: String, + sdkType: String, + sdkVersion: String, + bundleId: String + ) -> EventsClient { let storage = UserDefaultsEventStorage() - let networkingService = NetworkingService(projectId: projectId, sdkType: sdkType, sdkVersion: sdkVersion) - return EventsClient(storage: storage, bundleId: bundleId, networkingService: networkingService) + let networkingService = NetworkingService( + projectId: projectId, + sdkType: sdkType, + sdkVersion: sdkVersion + ) + let logger = ConsoleLogger(prefix: "", loggingLevel: .off) + let retryPolicy = RetryPolicy(maxAttempts: 3, initialDelay: 5, multiplier: 2) + let eventsDispatcher = EventsDispatcher(networkingService: networkingService, retryPolicy: retryPolicy) + let eventsCollector = EventsCollector(storage: storage, bundleId: bundleId, logger: logger) + return EventsClient( + eventsCollector: eventsCollector, + eventsDispatcher: eventsDispatcher, + logger: logger + ) } } diff --git a/Sources/Events/EventsCollector.swift b/Sources/Events/EventsCollector.swift index a8a6cbeb6..8fa213441 100644 --- a/Sources/Events/EventsCollector.swift +++ b/Sources/Events/EventsCollector.swift @@ -13,11 +13,17 @@ class EventsCollector { var trace: [String] = [] var topic: String? let storage: EventStorage + private let logger: ConsoleLogging private let bundleId: String - init(storage: EventStorage, bundleId: String) { + init( + storage: EventStorage, + bundleId: String, + logger: ConsoleLogging + ) { self.storage = storage self.bundleId = bundleId + self.logger = logger } // Function to start trace with topic @@ -57,7 +63,7 @@ class EventsCollector { ) ) storage.saveErrorEvent(event) - print("Error event saved: \(event)") + logger.debug("Error event saved: \(event)") } } diff --git a/Sources/Events/EventsImports.swift b/Sources/Events/EventsImports.swift new file mode 100644 index 000000000..39a0c89b7 --- /dev/null +++ b/Sources/Events/EventsImports.swift @@ -0,0 +1,3 @@ +#if !CocoaPods +@_exported import WalletConnectUtils +#endif diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index c18b9fb78..228baef25 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -31,7 +31,6 @@ actor LinkAuthRequester { } func request(params: AuthRequestParams, walletUniversalLink: String) async throws -> String { - guard try linkModeLinksStore.get(key: walletUniversalLink) != nil else { throw Errors.walletLinkSupportNotProven } var params = params From 19c18262f99dae609c1fb7cf8796039ed9294dc3 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jul 2024 09:51:08 +0200 Subject: [PATCH 650/814] upgrade on link mode auth response --- Example/DApp/SceneDelegate.swift | 9 +++++++++ .../Auth/Services/App/AuthResponseSubscriber.swift | 2 ++ 2 files changed, 11 insertions(+) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 2153d26f3..5d5c3cb62 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -117,6 +117,15 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { order: 1, mobileLink: "walletapp://", linkMode: "https://lab.web3modal.com/wallet" + ), + .init( + id: "rn-sample", + name: "RN Sample Wallet", + homepage: "https://walletconnect.com/", + imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", + order: 1, + mobileLink: "rn-web3wallet://", + linkMode: "https://lab.web3modal.com/walletkit_rn" ) ] ) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 578b6a75e..03f0456be 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -97,6 +97,8 @@ class AuthResponseSubscriber { linkEnvelopesDispatcher.responseSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + _ = getTransportTypeUpgradeIfPossible(peerMetadata: payload.response.responder.metadata, requestId: payload.id) + let pairingTopic = payload.topic pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) removeResponseTopicRecord(responseTopic: payload.topic) From 5d1ca6fa75f70216df003cd368f89228674c1a86 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 4 Jul 2024 11:55:51 +0200 Subject: [PATCH 651/814] build apps with events package --- Package.swift | 4 ++-- Sources/Events/Events.swift | 11 +++++++++++ Sources/Events/EventsClient.swift | 2 +- Sources/Events/EventsClientFactory.swift | 12 +++++------- Sources/Events/EventsCollector.swift | 6 ++---- Sources/Events/EventsImports.swift | 2 ++ Sources/Events/NetworkingService.swift | 6 ++---- Sources/WalletConnectPairing/Pair.swift | 6 +++++- .../WalletConnectPairing/PairingClientFactory.swift | 8 +++++--- Sources/WalletConnectPairing/PairingImports.swift | 1 + .../Services/Wallet/WalletPairService.swift | 5 ++++- Sources/WalletConnectSign/Sign/SignImports.swift | 2 ++ 12 files changed, 42 insertions(+), 23 deletions(-) create mode 100644 Sources/Events/Events.swift diff --git a/Package.swift b/Package.swift index 2b1a5f766..7e5c3133c 100644 --- a/Package.swift +++ b/Package.swift @@ -84,7 +84,7 @@ let package = Package( path: "Sources/WalletConnectKMS"), .target( name: "WalletConnectPairing", - dependencies: ["WalletConnectNetworking"], + dependencies: ["WalletConnectNetworking", "Events"], resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "WalletConnectSigner", @@ -128,7 +128,7 @@ let package = Package( dependencies: ["WalletConnectUtils"]), .target( name: "Events", - dependencies: ["WalletConnectUtils"]), + dependencies: ["WalletConnectUtils", "WalletConnectNetworking"]), .target( name: "WalletConnectModal", dependencies: ["QRCode", "WalletConnectSign"], diff --git a/Sources/Events/Events.swift b/Sources/Events/Events.swift new file mode 100644 index 000000000..5b9d3e57a --- /dev/null +++ b/Sources/Events/Events.swift @@ -0,0 +1,11 @@ +import Foundation + +public class Events { + /// Singleton instance of EventsClient + public static var instance: EventsClient = { + return EventsClientFactory.create( + projectId: Networking.projectId, + sdkVersion: EnvironmentInfo.sdkName + ) + }() +} diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 854923a05..6a2a4cd5f 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -1,6 +1,6 @@ import Foundation -class EventsClient { +public class EventsClient { private let eventsCollector: EventsCollector private let eventsDispatcher: EventsDispatcher private let logger: ConsoleLogging diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift index 5b1489b69..e8384eac2 100644 --- a/Sources/Events/EventsClientFactory.swift +++ b/Sources/Events/EventsClientFactory.swift @@ -1,22 +1,19 @@ import Foundation -class EventsClientFactory { - static func createEventsClient( +public class EventsClientFactory { + static func create( projectId: String, - sdkType: String, sdkVersion: String, - bundleId: String + storage: EventStorage = UserDefaultsEventStorage() ) -> EventsClient { - let storage = UserDefaultsEventStorage() let networkingService = NetworkingService( projectId: projectId, - sdkType: sdkType, sdkVersion: sdkVersion ) let logger = ConsoleLogger(prefix: "", loggingLevel: .off) let retryPolicy = RetryPolicy(maxAttempts: 3, initialDelay: 5, multiplier: 2) let eventsDispatcher = EventsDispatcher(networkingService: networkingService, retryPolicy: retryPolicy) - let eventsCollector = EventsCollector(storage: storage, bundleId: bundleId, logger: logger) + let eventsCollector = EventsCollector(storage: storage, logger: logger) return EventsClient( eventsCollector: eventsCollector, eventsDispatcher: eventsDispatcher, @@ -24,3 +21,4 @@ class EventsClientFactory { ) } } + diff --git a/Sources/Events/EventsCollector.swift b/Sources/Events/EventsCollector.swift index 8fa213441..09f255dbd 100644 --- a/Sources/Events/EventsCollector.swift +++ b/Sources/Events/EventsCollector.swift @@ -1,7 +1,7 @@ import Foundation // Protocol for TraceEvent -protocol TraceEvent: CustomStringConvertible { +public protocol TraceEvent: CustomStringConvertible { var description: String { get } } @@ -14,15 +14,12 @@ class EventsCollector { var topic: String? let storage: EventStorage private let logger: ConsoleLogging - private let bundleId: String init( storage: EventStorage, - bundleId: String, logger: ConsoleLogging ) { self.storage = storage - self.bundleId = bundleId self.logger = logger } @@ -49,6 +46,7 @@ class EventsCollector { // Private function to save error event private func saveErrorEvent(_ errorEvent: ErrorEvent) { + let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" let event = Event( eventId: UUID().uuidString, bundleId: bundleId, diff --git a/Sources/Events/EventsImports.swift b/Sources/Events/EventsImports.swift index 39a0c89b7..5e63a68cb 100644 --- a/Sources/Events/EventsImports.swift +++ b/Sources/Events/EventsImports.swift @@ -1,3 +1,5 @@ #if !CocoaPods @_exported import WalletConnectUtils +@_exported import WalletConnectNetworking +@_exported import WalletConnectRelay #endif diff --git a/Sources/Events/NetworkingService.swift b/Sources/Events/NetworkingService.swift index 8f7b647c1..76754849d 100644 --- a/Sources/Events/NetworkingService.swift +++ b/Sources/Events/NetworkingService.swift @@ -9,14 +9,12 @@ protocol NetworkingServiceProtocol { class NetworkingService: NetworkingServiceProtocol { private let session: URLSession private let projectId: String - private let sdkType: String private let sdkVersion: String private let apiURL = URL(string: "https://pulse.walletconnect.com/batch")! - init(session: URLSession = .shared, projectId: String, sdkType: String, sdkVersion: String) { + init(session: URLSession = .shared, projectId: String, sdkVersion: String) { self.session = session self.projectId = projectId - self.sdkType = sdkType self.sdkVersion = sdkVersion } @@ -25,7 +23,7 @@ class NetworkingService: NetworkingServiceProtocol { request.httpMethod = "POST" request.setValue("application/json", forHTTPHeaderField: "Content-Type") request.setValue(projectId, forHTTPHeaderField: "x-project-id") - request.setValue(sdkType, forHTTPHeaderField: "x-sdk-type") + request.setValue("events_sdk", forHTTPHeaderField: "x-sdk-type") request.setValue(sdkVersion, forHTTPHeaderField: "x-sdk-version") request.httpBody = try JSONEncoder().encode(events) diff --git a/Sources/WalletConnectPairing/Pair.swift b/Sources/WalletConnectPairing/Pair.swift index 08eafec7e..8924420cd 100644 --- a/Sources/WalletConnectPairing/Pair.swift +++ b/Sources/WalletConnectPairing/Pair.swift @@ -37,6 +37,10 @@ private extension Pair { guard let config = Pair.config else { fatalError("Error - you must call Pair.configure(_:) before accessing the shared instance.") } - return PairingClientFactory.create(networkingClient: Networking.interactor, groupIdentifier: Networking.groupIdentifier) + return PairingClientFactory.create( + networkingClient: Networking.interactor, + eventsClient: Events.instance, + groupIdentifier: Networking.groupIdentifier + ) }() } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 22840bed3..18f609b39 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -4,6 +4,7 @@ public struct PairingClientFactory { public static func create( networkingClient: NetworkingInteractor, + eventsClient: EventsClient, groupIdentifier: String ) -> PairingClient { let logger = ConsoleLogger(loggingLevel: .off) @@ -13,20 +14,21 @@ public struct PairingClientFactory { } let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) - return PairingClientFactory.create(logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, networkingClient: networkingClient) + return PairingClientFactory.create(logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychainStorage, networkingClient: networkingClient, eventsClient: eventsClient) } public static func create( logger: ConsoleLogging, keyValueStorage: KeyValueStorage, keychainStorage: KeychainStorageProtocol, - networkingClient: NetworkingInteractor + networkingClient: NetworkingInteractor, + eventsClient: EventsClient ) -> PairingClient { let pairingStore = PairingStorage(storage: SequenceStore(store: .init(defaults: keyValueStorage, identifier: PairStorageIdentifiers.pairings.rawValue))) let kms = KeyManagementService(keychain: keychainStorage) let history = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) let appPairService = AppPairService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore) - let walletPairService = WalletPairService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, history: history, logger: logger) + let walletPairService = WalletPairService(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, history: history, logger: logger, eventsClient: eventsClient) let pairingRequestsSubscriber = PairingRequestsSubscriber(networkingInteractor: networkingClient, pairingStorage: pairingStore, logger: logger) let pairingsProvider = PairingsProvider(pairingStorage: pairingStore) let cleanupService = PairingCleanupService(pairingStore: pairingStore, kms: kms) diff --git a/Sources/WalletConnectPairing/PairingImports.swift b/Sources/WalletConnectPairing/PairingImports.swift index 23c1738ef..98b75f8a5 100644 --- a/Sources/WalletConnectPairing/PairingImports.swift +++ b/Sources/WalletConnectPairing/PairingImports.swift @@ -1,3 +1,4 @@ #if !CocoaPods @_exported import WalletConnectNetworking +@_exported import Events #endif diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index 2592d010d..4fd09290a 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -8,6 +8,7 @@ actor WalletPairService { let networkingInteractor: NetworkInteracting let kms: KeyManagementServiceProtocol + private let eventsClient: EventsClient private let pairingStorage: WCPairingStorage private let history: RPCHistory private let logger: ConsoleLogging @@ -17,13 +18,15 @@ actor WalletPairService { kms: KeyManagementServiceProtocol, pairingStorage: WCPairingStorage, history: RPCHistory, - logger: ConsoleLogging + logger: ConsoleLogging, + eventsClient: EventsClient ) { self.networkingInteractor = networkingInteractor self.kms = kms self.pairingStorage = pairingStorage self.history = history self.logger = logger + self.eventsClient = eventsClient } func pair(_ uri: WalletConnectURI) async throws { diff --git a/Sources/WalletConnectSign/Sign/SignImports.swift b/Sources/WalletConnectSign/Sign/SignImports.swift index 91463cad3..898b4f971 100644 --- a/Sources/WalletConnectSign/Sign/SignImports.swift +++ b/Sources/WalletConnectSign/Sign/SignImports.swift @@ -2,4 +2,6 @@ @_exported import WalletConnectPairing @_exported import WalletConnectSigner @_exported import WalletConnectVerify +@_exported import WalletConnectRelay +@_exported import Events #endif From abb77a14aa55f8b25e67fd7f9b293e88839c94df Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Jul 2024 10:21:46 +0200 Subject: [PATCH 652/814] savepoint --- .../Pairing/PairingTests.swift | 3 +- .../Sign/SignClientTests.swift | 3 +- .../Web3Wallet/XPlatformW3WTests.swift | 3 +- Sources/Events/EventsClient.swift | 30 ++++++++++++++++++- .../NewPairingExecutionTraceEvents.swift | 8 ++--- .../PairingClientFactory.swift | 2 +- .../Services/Wallet/WalletPairService.swift | 19 +++++++++--- 7 files changed, 55 insertions(+), 13 deletions(-) diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 2ea13ae0e..80c9e5f0a 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -42,7 +42,8 @@ final class PairingTests: XCTestCase { logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychain, - networkingClient: networkingClient) + networkingClient: networkingClient, + eventsClient: MockEventsClient()) return pairingClient diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 56262453f..04c18cc58 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -48,7 +48,8 @@ final class SignClientTests: XCTestCase { logger: logger, keyValueStorage: keyValueStorage, keychainStorage: keychain, - networkingClient: networkingClient + networkingClient: networkingClient, + eventsClient: MockEventsClient() ) let metadata = AppMetadata(name: name, description: "", url: "", icons: [""], redirect: try! AppMetadata.Redirect(native: "", universal: linkModeUniversalLink, linkMode: supportLinkMode)) diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index 8420a3a64..b01538240 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -46,7 +46,8 @@ final class XPlatformW3WTests: XCTestCase { logger: pairingLogger, keyValueStorage: keyValueStorage, keychainStorage: keychain, - networkingClient: networkingClient) + networkingClient: networkingClient, + eventsClient: MockEventsClient()) let signClient = SignClientFactory.create( metadata: AppMetadata(name: name, description: "", url: "", icons: [""], redirect: try! AppMetadata.Redirect(native: "", universal: nil)), diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 6a2a4cd5f..1fc63bce3 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -1,6 +1,12 @@ import Foundation -public class EventsClient { +public protocol EventsClientProtocol { + func startTrace(topic: String) + func saveEvent(_ event: TraceEvent) + func sendStoredEvents() async +} + +public class EventsClient: EventsClientProtocol { private let eventsCollector: EventsCollector private let eventsDispatcher: EventsDispatcher private let logger: ConsoleLogging @@ -41,3 +47,25 @@ public class EventsClient { } } } + +#if DEBUG +public class MockEventsClient: EventsClientProtocol { + var startTraceCalled = false + var saveEventCalled = false + var sendStoredEventsCalled = false + + public init() {} + + public func startTrace(topic: String) { + startTraceCalled = true + } + + public func saveEvent(_ event: TraceEvent) { + saveEventCalled = true + } + + public func sendStoredEvents() async { + sendStoredEventsCalled = true + } +} +#endif diff --git a/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift index b5c060324..bc4d2ba79 100644 --- a/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift @@ -1,7 +1,7 @@ import Foundation -enum NewPairingExecutionTraceEvents: String, TraceEvent { +public enum NewPairingExecutionTraceEvents: String, TraceEvent { case pairingStarted = "pairing_started" case pairingUriValidationSuccess = "pairing_uri_validation_success" case pairingUriNotExpired = "pairing_uri_not_expired" @@ -9,13 +9,13 @@ enum NewPairingExecutionTraceEvents: String, TraceEvent { case subscribingPairingTopic = "subscribing_pairing_topic" case subscribePairingTopicSuccess = "subscribe_pairing_topic_success" - var description: String { + public var description: String { return self.rawValue } } // Enum for TraceErrorEvents -enum TraceErrorEvents: String, ErrorEvent { +public enum TraceErrorEvents: String, ErrorEvent { case noWssConnection = "no_wss_connection" case noInternetConnection = "no_internet_connection" case malformedPairingUri = "malformed_pairing_uri" @@ -24,7 +24,7 @@ enum TraceErrorEvents: String, ErrorEvent { case pairingExpired = "pairing_expired" case proposalExpired = "proposal_expired" - var description: String { + public var description: String { return self.rawValue } } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 18f609b39..26293c3ad 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -22,7 +22,7 @@ public struct PairingClientFactory { keyValueStorage: KeyValueStorage, keychainStorage: KeychainStorageProtocol, networkingClient: NetworkingInteractor, - eventsClient: EventsClient + eventsClient: EventsClientProtocol ) -> PairingClient { let pairingStore = PairingStorage(storage: SequenceStore(store: .init(defaults: keyValueStorage, identifier: PairStorageIdentifiers.pairings.rawValue))) let kms = KeyManagementService(keychain: keychainStorage) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index 4fd09290a..e7ccd715e 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -8,7 +8,7 @@ actor WalletPairService { let networkingInteractor: NetworkInteracting let kms: KeyManagementServiceProtocol - private let eventsClient: EventsClient + private let eventsClient: EventsClientProtocol private let pairingStorage: WCPairingStorage private let history: RPCHistory private let logger: ConsoleLogging @@ -19,7 +19,7 @@ actor WalletPairService { pairingStorage: WCPairingStorage, history: RPCHistory, logger: ConsoleLogging, - eventsClient: EventsClient + eventsClient: EventsClientProtocol ) { self.networkingInteractor = networkingInteractor self.kms = kms @@ -30,6 +30,8 @@ actor WalletPairService { } func pair(_ uri: WalletConnectURI) async throws { + eventsClient.startTrace(topic: uri.topic) + eventsClient.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) logger.debug("Pairing with uri: \(uri)") guard try !pairingHasPendingRequest(for: uri.topic) else { logger.debug("Pairing with topic (\(uri.topic)) has pending request") @@ -40,14 +42,22 @@ actor WalletPairService { let symKey = try SymmetricKey(hex: uri.symKey) try kms.setSymmetricKey(symKey, for: pairing.topic) pairingStorage.setPairing(pairing) - + eventsClient.saveEvent(NewPairingExecutionTraceEvents.storeNewPairing) + let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { logger.debug("Pairing failed - Network is not connected") + eventsClient.saveEvent(TraceErrorEvents.noInternetConnection) throw Errors.networkNotConnected } - try await networkingInteractor.subscribe(topic: pairing.topic) + do { + try await networkingInteractor.subscribe(topic: pairing.topic) + } catch { + logger.debug("Failed to subscribe to topic: \(pairing.topic)") + eventsClient.saveEvent(TraceErrorEvents.subscribePairingTopicFailure) + throw error + } } } @@ -59,6 +69,7 @@ extension WalletPairService { } if pairing.active { + eventsClient.saveEvent(TraceErrorEvents.activePairingAlreadyExists) throw Errors.pairingAlreadyExist(topic: topic) } From 6d8b3d74ca6ead15682652f636ed655e826f56db Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 5 Jul 2024 12:39:35 +0200 Subject: [PATCH 653/814] savepoint --- ...ents.swift => PairingExecutionTraceEvents.swift} | 9 +++++---- .../NetworkInteracting.swift | 1 + .../NetworkingInteractor.swift | 4 ++++ .../Services/Wallet/WalletPairService.swift | 13 +++++++++---- Sources/WalletConnectRelay/Dispatching.swift | 5 +++++ Sources/WalletConnectRelay/RelayClient.swift | 4 ++++ Tests/EventsTests/EventsCollectorTests.swift | 4 ++-- 7 files changed, 30 insertions(+), 10 deletions(-) rename Sources/Events/ExecutionTraces/{NewPairingExecutionTraceEvents.swift => PairingExecutionTraceEvents.swift} (83%) diff --git a/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift similarity index 83% rename from Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift rename to Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift index bc4d2ba79..8ed89517e 100644 --- a/Sources/Events/ExecutionTraces/NewPairingExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift @@ -1,13 +1,15 @@ import Foundation -public enum NewPairingExecutionTraceEvents: String, TraceEvent { - case pairingStarted = "pairing_started" +public enum PairingExecutionTraceEvents: String, TraceEvent { case pairingUriValidationSuccess = "pairing_uri_validation_success" - case pairingUriNotExpired = "pairing_uri_not_expired" + case pairingStarted = "pairing_started" + case noWssConnection = "no_wss_connection" case storeNewPairing = "store_new_pairing" case subscribingPairingTopic = "subscribing_pairing_topic" case subscribePairingTopicSuccess = "subscribe_pairing_topic_success" + case pairingHasPendingRequest = "pairing_has_pending_request" + case emitSessionProposal = "emit_session_proposal" public var description: String { return self.rawValue @@ -16,7 +18,6 @@ public enum NewPairingExecutionTraceEvents: String, TraceEvent { // Enum for TraceErrorEvents public enum TraceErrorEvents: String, ErrorEvent { - case noWssConnection = "no_wss_connection" case noInternetConnection = "no_internet_connection" case malformedPairingUri = "malformed_pairing_uri" case activePairingAlreadyExists = "active_pairing_already_exists" diff --git a/Sources/WalletConnectNetworking/NetworkInteracting.swift b/Sources/WalletConnectNetworking/NetworkInteracting.swift index a79814399..e916c3f62 100644 --- a/Sources/WalletConnectNetworking/NetworkInteracting.swift +++ b/Sources/WalletConnectNetworking/NetworkInteracting.swift @@ -2,6 +2,7 @@ import Foundation import Combine public protocol NetworkInteracting { + var isSocketConnected: Bool { get } var socketConnectionStatusPublisher: AnyPublisher { get } var networkConnectionStatusPublisher: AnyPublisher { get } var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?), Never> { get } diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index 847606edd..e7c8eb90d 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -27,6 +27,10 @@ public class NetworkingInteractor: NetworkInteracting { .eraseToAnyPublisher() } + public var isSocketConnected: Bool { + return relayClient.isSocketConnected + } + public var networkConnectionStatusPublisher: AnyPublisher public var socketConnectionStatusPublisher: AnyPublisher diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index e7ccd715e..e66fc0ece 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -31,18 +31,22 @@ actor WalletPairService { func pair(_ uri: WalletConnectURI) async throws { eventsClient.startTrace(topic: uri.topic) - eventsClient.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) + eventsClient.saveEvent(PairingExecutionTraceEvents.pairingStarted) logger.debug("Pairing with uri: \(uri)") guard try !pairingHasPendingRequest(for: uri.topic) else { + eventsClient.saveEvent(PairingExecutionTraceEvents.pairingHasPendingRequest) logger.debug("Pairing with topic (\(uri.topic)) has pending request") return } - + if !networkingInteractor.isSocketConnected { + eventsClient.saveEvent(PairingExecutionTraceEvents.noWssConnection) + } + let pairing = WCPairing(uri: uri) let symKey = try SymmetricKey(hex: uri.symKey) try kms.setSymmetricKey(symKey, for: pairing.topic) pairingStorage.setPairing(pairing) - eventsClient.saveEvent(NewPairingExecutionTraceEvents.storeNewPairing) + eventsClient.saveEvent(PairingExecutionTraceEvents.storeNewPairing) let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { @@ -50,7 +54,7 @@ actor WalletPairService { eventsClient.saveEvent(TraceErrorEvents.noInternetConnection) throw Errors.networkNotConnected } - + eventsClient.saveEvent(PairingExecutionTraceEvents.subscribingPairingTopic) do { try await networkingInteractor.subscribe(topic: pairing.topic) } catch { @@ -81,6 +85,7 @@ extension WalletPairService { guard !pendingRequests.isEmpty else { return false } pendingRequests.forEach { request in + eventsClient.saveEvent(PairingExecutionTraceEvents.emitSessionProposal) networkingInteractor.handleHistoryRequest(topic: topic, request: request) } return true diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 81ede05d7..3af72ce97 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -3,6 +3,7 @@ import Combine protocol Dispatching { var onMessage: ((String) -> Void)? { get set } + var isSocketConnected: Bool { get } var networkConnectionStatusPublisher: AnyPublisher { get } var socketConnectionStatusPublisher: AnyPublisher { get } func send(_ string: String, completion: @escaping (Error?) -> Void) @@ -32,6 +33,10 @@ final class Dispatcher: NSObject, Dispatching { networkMonitor.networkConnectionStatusPublisher } + var isSocketConnected: Bool { + return networkMonitor.isConnected + } + private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.dispatcher", qos: .utility, attributes: .concurrent) init( diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index efa501499..93b33f1c7 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -22,6 +22,10 @@ public final class RelayClient { var subscriptions: [String: String] = [:] + public var isSocketConnected: Bool { + return dispatcher.isSocketConnected + } + public var messagePublisher: AnyPublisher<(topic: String, message: String, publishedAt: Date), Never> { messagePublisherSubject.eraseToAnyPublisher() } diff --git a/Tests/EventsTests/EventsCollectorTests.swift b/Tests/EventsTests/EventsCollectorTests.swift index 2379c500a..87419fdf9 100644 --- a/Tests/EventsTests/EventsCollectorTests.swift +++ b/Tests/EventsTests/EventsCollectorTests.swift @@ -27,7 +27,7 @@ class EventsCollectorTests: XCTestCase { func testSaveEvent() { eventsCollector.startTrace(topic: "test_topic") - eventsCollector.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) + eventsCollector.saveEvent(PairingExecutionTraceEvents.pairingStarted) XCTAssertEqual(eventsCollector.trace, ["pairing_started"]) XCTAssertEqual(mockStorage.savedEvents.count, 0) @@ -35,7 +35,7 @@ class EventsCollectorTests: XCTestCase { func testSaveErrorEvent() { eventsCollector.startTrace(topic: "test_topic") - eventsCollector.saveEvent(NewPairingExecutionTraceEvents.pairingStarted) + eventsCollector.saveEvent(PairingExecutionTraceEvents.pairingStarted) eventsCollector.saveEvent(TraceErrorEvents.noInternetConnection) XCTAssertEqual(mockStorage.savedEvents.count, 1) From 18bd2cdbe2e88fa64a4c736f044d68a42fc4df26 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 09:20:04 +0200 Subject: [PATCH 654/814] savepoint --- .../SessionApproveExecutionTraceEvents.swift | 2 ++ Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 6 ++++-- 2 files changed, 6 insertions(+), 2 deletions(-) create mode 100644 Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift diff --git a/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift new file mode 100644 index 000000000..350c82fae --- /dev/null +++ b/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift @@ -0,0 +1,2 @@ + +import Foundation diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 4f3f0b4c4..5befa4605 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -1,6 +1,5 @@ import Foundation import Combine -import Events final class ApproveEngine { enum Errors: Error { @@ -31,6 +30,7 @@ final class ApproveEngine { private let logger: ConsoleLogging private let rpcHistory: RPCHistory private let authRequestSubscribersTracking: AuthRequestSubscribersTracking + private let eventsClient: EventsClient private var publishers = Set() @@ -47,7 +47,8 @@ final class ApproveEngine { sessionStore: WCSessionStorage, verifyClient: VerifyClientProtocol, rpcHistory: RPCHistory, - authRequestSubscribersTracking: AuthRequestSubscribersTracking + authRequestSubscribersTracking: AuthRequestSubscribersTracking, + eventsClient: EventsClient ) { self.networkingInteractor = networkingInteractor self.proposalPayloadsStore = proposalPayloadsStore @@ -62,6 +63,7 @@ final class ApproveEngine { self.verifyClient = verifyClient self.rpcHistory = rpcHistory self.authRequestSubscribersTracking = authRequestSubscribersTracking + self.eventsClient = eventsClient setupRequestSubscriptions() setupResponseSubscriptions() From 34f30e8d0ab8aeab2dbce17d9599573503b8c0b9 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 09:36:30 +0200 Subject: [PATCH 655/814] Add approve session events --- .../PairingExecutionTraceEvents.swift | 2 +- .../SessionApproveExecutionTraceEvents.swift | 27 ++++++++ .../Services/Wallet/WalletPairService.swift | 6 +- .../Engine/Common/ApproveEngine.swift | 63 ++++++++++++++----- Tests/EventsTests/EventsCollectorTests.swift | 2 +- 5 files changed, 79 insertions(+), 21 deletions(-) diff --git a/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift index 8ed89517e..bfb809dd3 100644 --- a/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift @@ -17,7 +17,7 @@ public enum PairingExecutionTraceEvents: String, TraceEvent { } // Enum for TraceErrorEvents -public enum TraceErrorEvents: String, ErrorEvent { +public enum PairingTraceErrorEvents: String, ErrorEvent { case noInternetConnection = "no_internet_connection" case malformedPairingUri = "malformed_pairing_uri" case activePairingAlreadyExists = "active_pairing_already_exists" diff --git a/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift index 350c82fae..95cc48ca6 100644 --- a/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift @@ -1,2 +1,29 @@ import Foundation + +public enum SessionApproveExecutionTraceEvents: String, TraceEvent { + case approvingSessionProposal = "approving_session_proposal" + case sessionNamespacesValidationStarted = "session_namespaces_validation_started" + case sessionNamespacesValidationSuccess = "session_namespaces_validation_success" + case responseApproveSent = "response_approve_sent" + case settleRequestSent = "settle_request_sent" + case sessionSettleSuccess = "session_settle_success" + + public var description: String { + return self.rawValue + } +} + +public enum ApproveSessionTraceErrorEvents: String, ErrorEvent { + case sessionNamespacesValidationFailure = "session_namespaces_validation_failure" + case proposalNotFound = "proposal_not_found" + case proposalExpired = "proposal_expired" + case networkNotConnected = "network_not_connected" + case agreementMissingOrInvalid = "agreement_missing_or_invalid" + case relayNotFound = "relay_not_found" + case sessionSettleFailure = "session_settle_failure" + + public var description: String { + return self.rawValue + } +} diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index e66fc0ece..c5607aa59 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -51,7 +51,7 @@ actor WalletPairService { let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { logger.debug("Pairing failed - Network is not connected") - eventsClient.saveEvent(TraceErrorEvents.noInternetConnection) + eventsClient.saveEvent(PairingTraceErrorEvents.noInternetConnection) throw Errors.networkNotConnected } eventsClient.saveEvent(PairingExecutionTraceEvents.subscribingPairingTopic) @@ -59,7 +59,7 @@ actor WalletPairService { try await networkingInteractor.subscribe(topic: pairing.topic) } catch { logger.debug("Failed to subscribe to topic: \(pairing.topic)") - eventsClient.saveEvent(TraceErrorEvents.subscribePairingTopicFailure) + eventsClient.saveEvent(PairingTraceErrorEvents.subscribePairingTopicFailure) throw error } } @@ -73,7 +73,7 @@ extension WalletPairService { } if pairing.active { - eventsClient.saveEvent(TraceErrorEvents.activePairingAlreadyExists) + eventsClient.saveEvent(PairingTraceErrorEvents.activePairingAlreadyExists) throw Errors.pairingAlreadyExist(topic: topic) } diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 5befa4605..8f65ce772 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -70,12 +70,18 @@ final class ApproveEngine { setupResponseErrorSubscriptions() } + func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws -> Session { logger.debug("Approving session proposal") + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.approvingSessionProposal) - guard !sessionNamespaces.isEmpty else { throw Errors.emtySessionNamespacesForbidden } + guard !sessionNamespaces.isEmpty else { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionNamespacesValidationFailure) + throw Errors.emtySessionNamespacesForbidden + } guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.proposalNotFound) throw Errors.proposalNotFound } @@ -83,31 +89,44 @@ final class ApproveEngine { guard !proposal.isExpired() else { logger.debug("Proposal has expired, topic: \(payload.topic)") + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.proposalExpired) proposalPayloadsStore.delete(forKey: proposerPubKey) throw Errors.proposalExpired } let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.networkNotConnected) throw Errors.networkNotConnected } let pairingTopic = payload.topic - try Namespace.validate(sessionNamespaces) - try Namespace.validateApproved(sessionNamespaces, against: proposal.requiredNamespaces) + do { + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationStarted) + try Namespace.validate(sessionNamespaces) + try Namespace.validateApproved(sessionNamespaces, against: proposal.requiredNamespaces) + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationSuccess) + } catch { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionNamespacesValidationFailure) + throw error + } let selfPublicKey = try kms.createX25519KeyPair() guard let agreementKey = try? kms.performKeyAgreement( selfPublicKey: selfPublicKey, peerPublicKey: proposal.proposer.publicKey - ) else { throw Errors.agreementMissingOrInvalid } + ) else { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.agreementMissingOrInvalid) + throw Errors.agreementMissingOrInvalid + } let sessionTopic = agreementKey.derivedTopic() try kms.setAgreementSecret(agreementKey, topic: sessionTopic) guard let relay = proposal.relays.first else { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.relayNotFound) throw Errors.relayNotFound } @@ -128,21 +147,33 @@ final class ApproveEngine { pairingTopic: pairingTopic ) - _ = try await proposeResponseTask - let session: WCSession = try await settleRequestTask + do { + _ = try await proposeResponseTask + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.responseApproveSent) + } catch { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) + throw error + } - sessionStore.setSession(session) - onSessionSettle?(session.publicRepresentation()) - logger.debug("Session proposal response and settle request have been sent") + do { + let session: WCSession = try await settleRequestTask + sessionStore.setSession(session) + onSessionSettle?(session.publicRepresentation()) + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionSettleSuccess) + logger.debug("Session proposal response and settle request have been sent") - proposalPayloadsStore.delete(forKey: proposerPubKey) - verifyContextStore.delete(forKey: proposerPubKey) + proposalPayloadsStore.delete(forKey: proposerPubKey) + verifyContextStore.delete(forKey: proposerPubKey) - pairingRegisterer.activate( - pairingTopic: payload.topic, - peerMetadata: payload.request.proposer.metadata - ) - return session.publicRepresentation() + pairingRegisterer.activate( + pairingTopic: payload.topic, + peerMetadata: payload.request.proposer.metadata + ) + return session.publicRepresentation() + } catch { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) + throw error + } } func reject(proposerPubKey: String, reason: SignReasonCode) async throws { diff --git a/Tests/EventsTests/EventsCollectorTests.swift b/Tests/EventsTests/EventsCollectorTests.swift index 87419fdf9..2da5850cb 100644 --- a/Tests/EventsTests/EventsCollectorTests.swift +++ b/Tests/EventsTests/EventsCollectorTests.swift @@ -36,7 +36,7 @@ class EventsCollectorTests: XCTestCase { func testSaveErrorEvent() { eventsCollector.startTrace(topic: "test_topic") eventsCollector.saveEvent(PairingExecutionTraceEvents.pairingStarted) - eventsCollector.saveEvent(TraceErrorEvents.noInternetConnection) + eventsCollector.saveEvent(PairingTraceErrorEvents.noInternetConnection) XCTAssertEqual(mockStorage.savedEvents.count, 1) let savedEvent = mockStorage.savedEvents.first From a6dfd366b000b3a49381d67e2a280e9d7844a132 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 10:18:03 +0200 Subject: [PATCH 656/814] savepoint --- Sources/Events/EventsClient.swift | 4 ++++ Sources/Events/EventsCollector.swift | 4 ++++ Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 5 +++-- 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 1fc63bce3..a9c4c5831 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -27,6 +27,10 @@ public class EventsClient: EventsClientProtocol { eventsCollector.startTrace(topic: topic) } + public func setTopic(_ topic: String) { + eventsCollector.setTopic(topic) + } + // Public method to save event public func saveEvent(_ event: TraceEvent) { eventsCollector.saveEvent(event) diff --git a/Sources/Events/EventsCollector.swift b/Sources/Events/EventsCollector.swift index 09f255dbd..2ace98002 100644 --- a/Sources/Events/EventsCollector.swift +++ b/Sources/Events/EventsCollector.swift @@ -29,6 +29,10 @@ class EventsCollector { self.trace = [] } + func setTopic(_ topic: String) { + self.topic = topic + } + // Function to save event func saveEvent(_ event: TraceEvent) { trace.append(event.description) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 8f65ce772..53f19932c 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -84,6 +84,9 @@ final class ApproveEngine { eventsClient.saveEvent(ApproveSessionTraceErrorEvents.proposalNotFound) throw Errors.proposalNotFound } + let pairingTopic = payload.topic + + eventsClient.setTopic(pairingTopic) let proposal = payload.request @@ -100,8 +103,6 @@ final class ApproveEngine { throw Errors.networkNotConnected } - let pairingTopic = payload.topic - do { eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationStarted) try Namespace.validate(sessionNamespaces) From d2672b4ed9bd36127d220a3bda9c3025331e1b12 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 10:35:59 +0200 Subject: [PATCH 657/814] session authenticate events --- Sources/Events/EventsClient.swift | 5 + .../SessionAuthenticateTraceEvents.swift | 35 ++++++ .../Wallet/SessionAuthenticateResponder.swift | 119 ++++++++++++------ .../Engine/Common/ApproveEngine.swift | 4 +- 4 files changed, 126 insertions(+), 37 deletions(-) create mode 100644 Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index a9c4c5831..16ce1c833 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -3,6 +3,7 @@ import Foundation public protocol EventsClientProtocol { func startTrace(topic: String) func saveEvent(_ event: TraceEvent) + func setTopic(_ topic: String) func sendStoredEvents() async } @@ -63,6 +64,10 @@ public class MockEventsClient: EventsClientProtocol { public func startTrace(topic: String) { startTraceCalled = true } + + public func setTopic(_ topic: String) { + + } public func saveEvent(_ event: TraceEvent) { saveEventCalled = true diff --git a/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift b/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift new file mode 100644 index 000000000..08e5d4b47 --- /dev/null +++ b/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift @@ -0,0 +1,35 @@ +// + +import Foundation + +public enum SessionAuthenticateTraceEvents: String, TraceEvent { + case signatureVerificationStarted = "signature_verification_started" + case signatureVerificationSuccess = "signature_verification_success" + case requestParamsRetrieved = "request_params_retrieved" + case agreementKeysGenerated = "agreement_keys_generated" + case agreementSecretSet = "agreement_secret_set" + case sessionKeysGenerated = "session_keys_generated" + case sessionSecretSet = "session_secret_set" + case responseParamsCreated = "response_params_created" + case responseSent = "response_sent" + + public var description: String { + return self.rawValue + } +} + +public enum SessionAuthenticateErrorEvents: String, ErrorEvent { + case signatureVerificationFailed = "signature_verification_failed" + case requestParamsRetrievalFailed = "request_params_retrieval_failed" + case agreementKeysGenerationFailed = "agreement_keys_generation_failed" + case agreementSecretSetFailed = "agreement_secret_set_failed" + case sessionKeysGenerationFailed = "session_keys_generation_failed" + case sessionSecretSetFailed = "session_secret_set_failed" + case responseParamsCreationFailed = "response_params_creation_failed" + case sessionCreationFailed = "session_creation_failed" + case pairingActivationFailed = "pairing_activation_failed" + + public var description: String { + return self.rawValue + } +} diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index a4b229830..e5df57e19 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -11,6 +11,7 @@ actor SessionAuthenticateResponder { private let pairingRegisterer: PairingRegisterer private let metadata: AppMetadata private let util: ApproveSessionAuthenticateUtil + private let eventsClient: EventsClientProtocol init( networkingInteractor: NetworkInteracting, @@ -20,7 +21,8 @@ actor SessionAuthenticateResponder { walletErrorResponder: WalletErrorResponder, pairingRegisterer: PairingRegisterer, metadata: AppMetadata, - approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil + approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, + eventsClient: EventsClientProtocol ) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -30,54 +32,101 @@ actor SessionAuthenticateResponder { self.pairingRegisterer = pairingRegisterer self.metadata = metadata self.util = approveSessionAuthenticateUtil + self.eventsClient = eventsClient } func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { - try await util.recoverAndVerifySignature(cacaos: auths) - let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) - let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) - - - try kms.setAgreementSecret(responseKeys, topic: responseTopic) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.signatureVerificationStarted) + do { + try await util.recoverAndVerifySignature(cacaos: auths) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.signatureVerificationSuccess) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.signatureVerificationFailed) + throw error + } + + do { + let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.requestParamsRetrieved) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.requestParamsRetrievalFailed) + throw error + } + + do { + let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.agreementKeysGenerated) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.agreementKeysGenerationFailed) + throw error + } + + do { + try kms.setAgreementSecret(responseKeys, topic: responseTopic) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.agreementSecretSet) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.agreementSecretSetFailed) + throw error + } let peerParticipant = sessionAuthenticateRequestParams.requester - let sessionSelfPubKey = try kms.createX25519KeyPair() - let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation - let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) + do { + let sessionSelfPubKey = try kms.createX25519KeyPair() + let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation + let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.sessionKeysGenerated) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionKeysGenerationFailed) + throw error + } let sessionTopic = sessionKeys.derivedTopic() - try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) + do { + try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.sessionSecretSet) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionSecretSetFailed) + throw error + } let selfParticipant = Participant(publicKey: sessionSelfPubKeyHex, metadata: metadata) let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.responseParamsCreated) let response = RPCResponse(id: requestId, result: responseParams) - - try await networkingInteractor.respond( - topic: responseTopic, - response: response, - protocolMethod: SessionAuthenticatedProtocolMethod.responseApprove(), - envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation) - ) - - - let session = try util.createSession( - response: responseParams, - pairingTopic: pairingTopic, - request: sessionAuthenticateRequestParams, - sessionTopic: sessionTopic, - transportType: .relay - ) - - pairingRegisterer.activate( - pairingTopic: pairingTopic, - peerMetadata: sessionAuthenticateRequestParams.requester.metadata - ) - verifyContextStore.delete(forKey: requestId.string) - - return session + do { + try await networkingInteractor.respond( + topic: responseTopic, + response: response, + protocolMethod: SessionAuthenticatedProtocolMethod.responseApprove(), + envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation) + ) + eventsClient.saveEvent(SessionAuthenticateTraceEvents.responseSent) + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.responseSendFailed) + throw error + } + + do { + let session = try util.createSession( + response: responseParams, + pairingTopic: pairingTopic, + request: sessionAuthenticateRequestParams, + sessionTopic: sessionTopic, + transportType: .relay + ) + pairingRegisterer.activate( + pairingTopic: pairingTopic, + peerMetadata: sessionAuthenticateRequestParams.requester.metadata + ) + verifyContextStore.delete(forKey: requestId.string) + return session + } catch { + eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionCreationFailed) + throw error + } } func respondError(requestId: RPCID) async throws { diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 53f19932c..1fc5f0fe3 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -30,7 +30,7 @@ final class ApproveEngine { private let logger: ConsoleLogging private let rpcHistory: RPCHistory private let authRequestSubscribersTracking: AuthRequestSubscribersTracking - private let eventsClient: EventsClient + private let eventsClient: EventsClientProtocol private var publishers = Set() @@ -48,7 +48,7 @@ final class ApproveEngine { verifyClient: VerifyClientProtocol, rpcHistory: RPCHistory, authRequestSubscribersTracking: AuthRequestSubscribersTracking, - eventsClient: EventsClient + eventsClient: EventsClientProtocol ) { self.networkingInteractor = networkingInteractor self.proposalPayloadsStore = proposalPayloadsStore From b9f3b56e02d96c4a9225d81375b17bc10c16d9d0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 10:59:24 +0200 Subject: [PATCH 658/814] fix tests --- Sources/Events/EventsClient.swift | 11 ++--------- Tests/EventsTests/EventsCollectorTests.swift | 2 +- 2 files changed, 3 insertions(+), 10 deletions(-) diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 16ce1c833..dd481fbba 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -4,7 +4,6 @@ public protocol EventsClientProtocol { func startTrace(topic: String) func saveEvent(_ event: TraceEvent) func setTopic(_ topic: String) - func sendStoredEvents() async } public class EventsClient: EventsClientProtocol { @@ -37,8 +36,7 @@ public class EventsClient: EventsClientProtocol { eventsCollector.saveEvent(event) } - // Public method to send stored events - public func sendStoredEvents() async { + private func sendStoredEvents() async { let events = eventsCollector.storage.fetchErrorEvents() guard !events.isEmpty else { return } @@ -57,14 +55,13 @@ public class EventsClient: EventsClientProtocol { public class MockEventsClient: EventsClientProtocol { var startTraceCalled = false var saveEventCalled = false - var sendStoredEventsCalled = false public init() {} public func startTrace(topic: String) { startTraceCalled = true } - + public func setTopic(_ topic: String) { } @@ -72,9 +69,5 @@ public class MockEventsClient: EventsClientProtocol { public func saveEvent(_ event: TraceEvent) { saveEventCalled = true } - - public func sendStoredEvents() async { - sendStoredEventsCalled = true - } } #endif diff --git a/Tests/EventsTests/EventsCollectorTests.swift b/Tests/EventsTests/EventsCollectorTests.swift index 2da5850cb..3dc59c7f9 100644 --- a/Tests/EventsTests/EventsCollectorTests.swift +++ b/Tests/EventsTests/EventsCollectorTests.swift @@ -10,7 +10,7 @@ class EventsCollectorTests: XCTestCase { override func setUp() { super.setUp() mockStorage = MockEventStorage() - eventsCollector = EventsCollector(storage: mockStorage, bundleId: "com.wallet.example") + eventsCollector = EventsCollector(storage: mockStorage, logger: ConsoleLoggerMock()) } override func tearDown() { From 97c5f10554a79508571c33e6040d01402bd7fdea Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 11:37:22 +0200 Subject: [PATCH 659/814] savepoint --- Sources/Events/EventStorage.swift | 10 +++++++--- .../Engine/Common/ApproveEngine.swift | 1 + 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Sources/Events/EventStorage.swift b/Sources/Events/EventStorage.swift index 348e5b7c1..691ef903e 100644 --- a/Sources/Events/EventStorage.swift +++ b/Sources/Events/EventStorage.swift @@ -7,13 +7,17 @@ protocol EventStorage { func clearErrorEvents() } -// Default implementation using UserDefaults class UserDefaultsEventStorage: EventStorage { private let errorEventsKey = "com.walletconnect.sdk.errorEvents" + private let maxEvents = 30 func saveErrorEvent(_ event: Event) { var existingEvents = fetchErrorEvents() existingEvents.append(event) + // Ensure we keep only the last 30 events + if existingEvents.count > maxEvents { + existingEvents = Array(existingEvents.suffix(maxEvents)) + } if let encoded = try? JSONEncoder().encode(existingEvents) { UserDefaults.standard.set(encoded, forKey: errorEventsKey) } @@ -22,7 +26,8 @@ class UserDefaultsEventStorage: EventStorage { func fetchErrorEvents() -> [Event] { if let data = UserDefaults.standard.data(forKey: errorEventsKey), let events = try? JSONDecoder().decode([Event].self, from: data) { - return events + // Return only the last 30 events + return Array(events.suffix(maxEvents)) } return [] } @@ -32,7 +37,6 @@ class UserDefaultsEventStorage: EventStorage { } } - #if DEBUG class MockEventStorage: EventStorage { private(set) var savedEvents: [Event] = [] diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 1fc5f0fe3..cd127d81a 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -72,6 +72,7 @@ final class ApproveEngine { func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws -> Session { + eventsClient.startTrace(topic: "") logger.debug("Approving session proposal") eventsClient.saveEvent(SessionApproveExecutionTraceEvents.approvingSessionProposal) From 791c5ae84c99b11774d39b491035d83dd189af5b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 12:20:45 +0200 Subject: [PATCH 660/814] savepoint --- Sources/Events/EventsClient.swift | 39 ++++++++++++-- Sources/Events/EventsClientFactory.swift | 3 +- Sources/Events/UserDefaultsStateStorage.swift | 54 +++++++++++++++++++ Sources/WalletConnectSign/Sign/Sign.swift | 3 +- .../Sign/SignClientFactory.swift | 14 +++-- 5 files changed, 101 insertions(+), 12 deletions(-) create mode 100644 Sources/Events/UserDefaultsStateStorage.swift diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index dd481fbba..6a7ed3296 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -4,39 +4,65 @@ public protocol EventsClientProtocol { func startTrace(topic: String) func saveEvent(_ event: TraceEvent) func setTopic(_ topic: String) + func setTelemetryEnabled(_ enabled: Bool) } public class EventsClient: EventsClientProtocol { private let eventsCollector: EventsCollector private let eventsDispatcher: EventsDispatcher private let logger: ConsoleLogging + private var stateStorage: TelemetryStateStorage + private var telemetryEnabled: Bool init( eventsCollector: EventsCollector, eventsDispatcher: EventsDispatcher, - logger: ConsoleLogging + logger: ConsoleLogging, + stateStorage: TelemetryStateStorage ) { self.eventsCollector = eventsCollector self.eventsDispatcher = eventsDispatcher self.logger = logger - Task { await sendStoredEvents() } + self.stateStorage = stateStorage + self.telemetryEnabled = stateStorage.telemetryEnabled + + if telemetryEnabled { + Task { await sendStoredEvents() } + } else { + self.eventsCollector.storage.clearErrorEvents() + } } // Public method to start trace public func startTrace(topic: String) { + guard telemetryEnabled else { return } eventsCollector.startTrace(topic: topic) } public func setTopic(_ topic: String) { + guard telemetryEnabled else { return } eventsCollector.setTopic(topic) } // Public method to save event public func saveEvent(_ event: TraceEvent) { + guard telemetryEnabled else { return } eventsCollector.saveEvent(event) } + // Public method to set telemetry enabled or disabled + public func setTelemetryEnabled(_ enabled: Bool) { + telemetryEnabled = enabled + stateStorage.telemetryEnabled = enabled + if enabled { + Task { await sendStoredEvents() } + } else { + eventsCollector.storage.clearErrorEvents() + } + } + private func sendStoredEvents() async { + guard telemetryEnabled else { return } let events = eventsCollector.storage.fetchErrorEvents() guard !events.isEmpty else { return } @@ -55,6 +81,7 @@ public class EventsClient: EventsClientProtocol { public class MockEventsClient: EventsClientProtocol { var startTraceCalled = false var saveEventCalled = false + var telemetryEnabled = true public init() {} @@ -62,12 +89,14 @@ public class MockEventsClient: EventsClientProtocol { startTraceCalled = true } - public func setTopic(_ topic: String) { - - } + public func setTopic(_ topic: String) {} public func saveEvent(_ event: TraceEvent) { saveEventCalled = true } + + public func setTelemetryEnabled(_ enabled: Bool) { + telemetryEnabled = enabled + } } #endif diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift index e8384eac2..98ffdebf4 100644 --- a/Sources/Events/EventsClientFactory.swift +++ b/Sources/Events/EventsClientFactory.swift @@ -17,7 +17,8 @@ public class EventsClientFactory { return EventsClient( eventsCollector: eventsCollector, eventsDispatcher: eventsDispatcher, - logger: logger + logger: logger, + stateStorage: UserDefaultsTelemetryStateStorage() ) } } diff --git a/Sources/Events/UserDefaultsStateStorage.swift b/Sources/Events/UserDefaultsStateStorage.swift new file mode 100644 index 000000000..fa00eee21 --- /dev/null +++ b/Sources/Events/UserDefaultsStateStorage.swift @@ -0,0 +1,54 @@ +import Foundation + +protocol TelemetryStateStorage { + var telemetryEnabled: Bool { get set } +} + +class UserDefaultsTelemetryStateStorage: TelemetryStateStorage { + private let telemetryEnabledKey = "com.walletconnect.sdk.telemetryEnabled" + + var telemetryEnabled: Bool { + get { + if UserDefaults.standard.object(forKey: telemetryEnabledKey) == nil { + return true + } + return UserDefaults.standard.bool(forKey: telemetryEnabledKey) + } + set { + UserDefaults.standard.set(newValue, forKey: telemetryEnabledKey) + } + } + + init() { + if UserDefaults.standard.object(forKey: telemetryEnabledKey) == nil { + // Set default value if not already set + UserDefaults.standard.set(true, forKey: telemetryEnabledKey) + } + } +} + +#if DEBUG +class MockUserDefaultsTelemetryStateStorage: TelemetryStateStorage { + private var mockStorage: [String: Any] = [:] + private let telemetryEnabledKey = "com.walletconnect.sdk.telemetryEnabled" + + var telemetryEnabled: Bool { + get { + if mockStorage[telemetryEnabledKey] == nil { + return true + } + return mockStorage[telemetryEnabledKey] as? Bool ?? true + } + set { + mockStorage[telemetryEnabledKey] = newValue + } + } + + init() { + // Initialize with a default value if not already set + if mockStorage[telemetryEnabledKey] == nil { + mockStorage[telemetryEnabledKey] = true + } + } +} +#endif diff --git a/Sources/WalletConnectSign/Sign/Sign.swift b/Sources/WalletConnectSign/Sign/Sign.swift index 25f88df3e..3205485d6 100644 --- a/Sources/WalletConnectSign/Sign/Sign.swift +++ b/Sources/WalletConnectSign/Sign/Sign.swift @@ -29,7 +29,8 @@ public class Sign { projectId: Networking.projectId, crypto: config.crypto, networkingClient: Networking.interactor, - groupIdentifier: Networking.groupIdentifier + groupIdentifier: Networking.groupIdentifier, + eventsClient: Events.instance ) }() diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 4acff725c..6a9989112 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -17,7 +17,8 @@ public struct SignClientFactory { projectId: String, crypto: CryptoProvider, networkingClient: NetworkingInteractor, - groupIdentifier: String + groupIdentifier: String, + eventsClient: EventsClientProtocol ) -> SignClient { let logger = ConsoleLogger(prefix: "📝", loggingLevel: .off) @@ -37,7 +38,8 @@ public struct SignClientFactory { networkingClient: networkingClient, iatProvider: iatProvider, projectId: projectId, - crypto: crypto + crypto: crypto, + eventsClient: eventsClient ) } @@ -50,7 +52,8 @@ public struct SignClientFactory { networkingClient: NetworkingInteractor, iatProvider: IATProvider, projectId: String, - crypto: CryptoProvider + crypto: CryptoProvider, + eventsClient: EventsClientProtocol ) -> SignClient { let kms = KeyManagementService(keychain: keychainStorage) let rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) @@ -83,7 +86,8 @@ public struct SignClientFactory { sessionStore: sessionStore, verifyClient: verifyClient, rpcHistory: rpcHistory, - authRequestSubscribersTracking: authRequestSubscribersTracking + authRequestSubscribersTracking: authRequestSubscribersTracking, + eventsClient: eventsClient ) let cleanupService = SignCleanupService(pairingStore: pairingStore, sessionStore: sessionStore, kms: kms, sessionTopicToProposal: sessionTopicToProposal, networkInteractor: networkingClient, rpcHistory: rpcHistory) let deleteSessionService = DeleteSessionService(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) @@ -125,7 +129,7 @@ public struct SignClientFactory { let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil) + let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, eventsClient: eventsClient) let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder) From abdec5b185a7f910cd0be94623c35edf2b092b05 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 8 Jul 2024 15:48:05 +0200 Subject: [PATCH 661/814] savepoint --- .../xcschemes/EventsTests 1.xcscheme | 54 ------------------- .../Sign/SignClientTests.swift | 3 +- .../Web3Wallet/XPlatformW3WTests.swift | 3 +- .../ConfigurationService.swift | 1 + Sources/Events/EventsClient.swift | 21 +++++--- Sources/Events/EventsClientFactory.swift | 2 +- Sources/Events/EventsDispatcher.swift | 11 ++-- .../SessionAuthenticateTraceEvents.swift | 4 +- Sources/Events/NetworkingService.swift | 9 ++-- .../Wallet/SessionAuthenticateResponder.swift | 28 +++++++--- 10 files changed, 50 insertions(+), 86 deletions(-) delete mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme deleted file mode 100644 index 7f7753025..000000000 --- a/.swiftpm/xcode/xcshareddata/xcschemes/EventsTests 1.xcscheme +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 04c18cc58..31f09a9e3 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -62,7 +62,8 @@ final class SignClientTests: XCTestCase { networkingClient: networkingClient, iatProvider: IATProviderMock(), projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider() + crypto: DefaultCryptoProvider(), + eventsClient: MockEventsClient() ) let clientId = try! networkingClient.getClientId() diff --git a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift index b01538240..5826e1f1a 100644 --- a/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift +++ b/Example/IntegrationTests/XPlatform/Web3Wallet/XPlatformW3WTests.swift @@ -58,7 +58,8 @@ final class XPlatformW3WTests: XCTestCase { networkingClient: networkingClient, iatProvider: DefaultIATProvider(), projectId: InputConfig.projectId, - crypto: DefaultCryptoProvider() + crypto: DefaultCryptoProvider(), + eventsClient: MockEventsClient() ) w3wClient = Web3WalletClientFactory.create( diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 2eda07ec7..970353746 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -33,6 +33,7 @@ final class ConfigurationService { Notify.instance.setLogging(level: .debug) Sign.instance.setLogging(level: .debug) + Events.instance.setLogging(level: .debug) if let clientId = try? Networking.interactor.getClientId() { LoggingService.instance.setUpUser(account: importAccount.account.absoluteString, clientId: clientId) diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 6a7ed3296..f0bcb32c3 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -12,7 +12,6 @@ public class EventsClient: EventsClientProtocol { private let eventsDispatcher: EventsDispatcher private let logger: ConsoleLogging private var stateStorage: TelemetryStateStorage - private var telemetryEnabled: Bool init( eventsCollector: EventsCollector, @@ -24,35 +23,39 @@ public class EventsClient: EventsClientProtocol { self.eventsDispatcher = eventsDispatcher self.logger = logger self.stateStorage = stateStorage - self.telemetryEnabled = stateStorage.telemetryEnabled - if telemetryEnabled { + if stateStorage.telemetryEnabled { Task { await sendStoredEvents() } } else { self.eventsCollector.storage.clearErrorEvents() } } + public func setLogging(level: LoggingLevel) { + logger.setLogging(level: level) + } + // Public method to start trace public func startTrace(topic: String) { - guard telemetryEnabled else { return } + guard stateStorage.telemetryEnabled else { return } + logger.debug("Will start trace with topic: \(topic)") eventsCollector.startTrace(topic: topic) } public func setTopic(_ topic: String) { - guard telemetryEnabled else { return } + guard stateStorage.telemetryEnabled else { return } eventsCollector.setTopic(topic) } // Public method to save event public func saveEvent(_ event: TraceEvent) { - guard telemetryEnabled else { return } + guard stateStorage.telemetryEnabled else { return } + logger.debug("Will store an event: \(event)") eventsCollector.saveEvent(event) } // Public method to set telemetry enabled or disabled public func setTelemetryEnabled(_ enabled: Bool) { - telemetryEnabled = enabled stateStorage.telemetryEnabled = enabled if enabled { Task { await sendStoredEvents() } @@ -62,13 +65,15 @@ public class EventsClient: EventsClientProtocol { } private func sendStoredEvents() async { - guard telemetryEnabled else { return } + guard stateStorage.telemetryEnabled else { return } let events = eventsCollector.storage.fetchErrorEvents() guard !events.isEmpty else { return } + logger.debug("Will send events") do { let success: Bool = try await eventsDispatcher.executeWithRetry(events: events) if success { + logger.debug("Events sent successfully") self.eventsCollector.storage.clearErrorEvents() } } catch { diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift index 98ffdebf4..43bff4c76 100644 --- a/Sources/Events/EventsClientFactory.swift +++ b/Sources/Events/EventsClientFactory.swift @@ -10,7 +10,7 @@ public class EventsClientFactory { projectId: projectId, sdkVersion: sdkVersion ) - let logger = ConsoleLogger(prefix: "", loggingLevel: .off) + let logger = ConsoleLogger(prefix: "🧚🏻‍♂️", loggingLevel: .off) let retryPolicy = RetryPolicy(maxAttempts: 3, initialDelay: 5, multiplier: 2) let eventsDispatcher = EventsDispatcher(networkingService: networkingService, retryPolicy: retryPolicy) let eventsCollector = EventsCollector(storage: storage, logger: logger) diff --git a/Sources/Events/EventsDispatcher.swift b/Sources/Events/EventsDispatcher.swift index 4df0eaee7..0c347958b 100644 --- a/Sources/Events/EventsDispatcher.swift +++ b/Sources/Events/EventsDispatcher.swift @@ -22,16 +22,19 @@ class EventsDispatcher { var delay = retryPolicy.initialDelay while attempts < retryPolicy.maxAttempts { - attempts += 1 + if attempts > 0 || retryPolicy.initialDelay > 0 { + let actualDelay = retryPolicy.delayOverride ?? delay + try await Task.sleep(nanoseconds: UInt64(actualDelay * Double(NSEC_PER_SEC))) + delay *= retryPolicy.multiplier + } + do { return try await networkingService.sendEvents(events) } catch { + attempts += 1 if attempts >= retryPolicy.maxAttempts { throw error } - let actualDelay = retryPolicy.delayOverride ?? delay - try await Task.sleep(nanoseconds: UInt64(actualDelay * Double(NSEC_PER_SEC))) - delay *= retryPolicy.multiplier } } throw NSError(domain: "EventsDispatcherError", code: -1, userInfo: [NSLocalizedDescriptionKey: "Max retry attempts reached"]) diff --git a/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift b/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift index 08e5d4b47..88b2f0696 100644 --- a/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift @@ -1,4 +1,3 @@ -// import Foundation @@ -25,9 +24,8 @@ public enum SessionAuthenticateErrorEvents: String, ErrorEvent { case agreementSecretSetFailed = "agreement_secret_set_failed" case sessionKeysGenerationFailed = "session_keys_generation_failed" case sessionSecretSetFailed = "session_secret_set_failed" - case responseParamsCreationFailed = "response_params_creation_failed" case sessionCreationFailed = "session_creation_failed" - case pairingActivationFailed = "pairing_activation_failed" + case responseSendFailed = "response_send_failed" public var description: String { return self.rawValue diff --git a/Sources/Events/NetworkingService.swift b/Sources/Events/NetworkingService.swift index 76754849d..a8a03b620 100644 --- a/Sources/Events/NetworkingService.swift +++ b/Sources/Events/NetworkingService.swift @@ -1,11 +1,9 @@ - import Foundation protocol NetworkingServiceProtocol { func sendEvents(_ events: [Event]) async throws -> Bool } - class NetworkingService: NetworkingServiceProtocol { private let session: URLSession private let projectId: String @@ -35,12 +33,11 @@ class NetworkingService: NetworkingServiceProtocol { return } - guard let httpResponse = response as? HTTPURLResponse, httpResponse.statusCode == 200 else { + if let httpResponse = response as? HTTPURLResponse, (200..<300).contains(httpResponse.statusCode) { + continuation.resume(returning: true) + } else { continuation.resume(returning: false) - return } - - continuation.resume(returning: true) } task.priority = URLSessionTask.lowPriority diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index e5df57e19..dea7e0e9e 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -45,16 +45,22 @@ actor SessionAuthenticateResponder { throw error } + let sessionAuthenticateRequestParams: SessionAuthenticateRequestParams + let pairingTopic: String + do { - let (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) + (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) eventsClient.saveEvent(SessionAuthenticateTraceEvents.requestParamsRetrieved) } catch { eventsClient.saveEvent(SessionAuthenticateErrorEvents.requestParamsRetrievalFailed) throw error } + let responseTopic: String + let responseKeys: AgreementKeys + do { - let (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) + (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) eventsClient.saveEvent(SessionAuthenticateTraceEvents.agreementKeysGenerated) } catch { eventsClient.saveEvent(SessionAuthenticateErrorEvents.agreementKeysGenerationFailed) @@ -71,10 +77,14 @@ actor SessionAuthenticateResponder { let peerParticipant = sessionAuthenticateRequestParams.requester + let sessionSelfPubKey: AgreementPublicKey + let sessionSelfPubKeyHex: String + let sessionKeys: AgreementKeys + do { - let sessionSelfPubKey = try kms.createX25519KeyPair() - let sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation - let sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) + sessionSelfPubKey = try kms.createX25519KeyPair() + sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation + sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) eventsClient.saveEvent(SessionAuthenticateTraceEvents.sessionKeysGenerated) } catch { eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionKeysGenerationFailed) @@ -130,9 +140,11 @@ actor SessionAuthenticateResponder { } func respondError(requestId: RPCID) async throws { - try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + do { + try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + } catch { + throw error + } verifyContextStore.delete(forKey: requestId.string) } } - - From 4a8c090f07234a8359aa34ebe8b869136616d0e7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jul 2024 13:08:14 +0200 Subject: [PATCH 662/814] fix tests --- Tests/TestingUtils/NetworkingInteractorMock.swift | 2 ++ Tests/WalletConnectPairingTests/WalletPairServiceTests.swift | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/Tests/TestingUtils/NetworkingInteractorMock.swift b/Tests/TestingUtils/NetworkingInteractorMock.swift index a1fa196ad..65b73ab0c 100644 --- a/Tests/TestingUtils/NetworkingInteractorMock.swift +++ b/Tests/TestingUtils/NetworkingInteractorMock.swift @@ -6,6 +6,8 @@ import WalletConnectKMS import WalletConnectNetworking public class NetworkingInteractorMock: NetworkInteracting { + public var isSocketConnected: Bool = true + private var publishers = Set() diff --git a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift index 6def56757..832c5ccad 100644 --- a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift +++ b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift @@ -18,7 +18,7 @@ final class WalletPairServiceTestsTests: XCTestCase { storageMock = WCPairingStorageMock() cryptoMock = KeyManagementServiceMock() rpcHistory = RPCHistoryFactory.createForNetwork(keyValueStorage: RuntimeKeyValueStorage()) - service = WalletPairService(networkingInteractor: networkingInteractor, kms: cryptoMock, pairingStorage: storageMock, history: rpcHistory, logger: ConsoleLoggerMock()) + service = WalletPairService(networkingInteractor: networkingInteractor, kms: cryptoMock, pairingStorage: storageMock, history: rpcHistory, logger: ConsoleLoggerMock(), eventsClient: MockEventsClient()) } func testPairWhenNetworkNotConnectedThrows() async { From 51ba84f733653958971352e4e6d959fc8b21c952 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jul 2024 13:11:32 +0200 Subject: [PATCH 663/814] rename var --- Tests/WalletConnectPairingTests/WalletPairServiceTests.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift index 832c5ccad..1aeee96ec 100644 --- a/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift +++ b/Tests/WalletConnectPairingTests/WalletPairServiceTests.swift @@ -5,7 +5,7 @@ import XCTest import WalletConnectUtils import WalletConnectNetworking -final class WalletPairServiceTestsTests: XCTestCase { +final class WalletPairServiceTests: XCTestCase { var service: WalletPairService! var networkingInteractor: NetworkingInteractorMock! From ab47fe1f079e28e07b2c70914350dca8b889107d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jul 2024 13:22:37 +0200 Subject: [PATCH 664/814] fix tests --- Tests/WalletConnectSignTests/AppProposalServiceTests.swift | 3 ++- Tests/WalletConnectSignTests/ApproveEngineTests.swift | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index 18a392325..ae3a4772d 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -78,7 +78,8 @@ final class AppProposalServiceTests: XCTestCase { sessionStore: WCSessionStorageMock(), verifyClient: VerifyClientMock(), rpcHistory: history, - authRequestSubscribersTracking: AuthRequestSubscribersTracking(logger: logger) + authRequestSubscribersTracking: AuthRequestSubscribersTracking(logger: logger), + eventsClient: MockEventsClient() ) } diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index 585f7e4be..79b2f7996 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -52,7 +52,8 @@ final class ApproveEngineTests: XCTestCase { sessionStore: sessionStorageMock, verifyClient: VerifyClientMock(), rpcHistory: history, - authRequestSubscribersTracking: AuthRequestSubscribersTracking(logger: ConsoleLoggerMock()) + authRequestSubscribersTracking: AuthRequestSubscribersTracking(logger: ConsoleLoggerMock()), + eventsClient: MockEventsClient() ) } From a4e1f36c47ecc586a496a9754bc97a01305e40b8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jul 2024 13:56:54 +0200 Subject: [PATCH 665/814] fix relay tests --- Tests/RelayerTests/Mocks/DispatcherMock.swift | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Tests/RelayerTests/Mocks/DispatcherMock.swift b/Tests/RelayerTests/Mocks/DispatcherMock.swift index 2e12b6ab2..82dd12c6c 100644 --- a/Tests/RelayerTests/Mocks/DispatcherMock.swift +++ b/Tests/RelayerTests/Mocks/DispatcherMock.swift @@ -4,6 +4,8 @@ import Combine @testable import WalletConnectRelay class DispatcherMock: Dispatching { + var isSocketConnected: Bool = true + private var publishers = Set() private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) From cb4eaa244f60226ed30025dda0907bef1a091855 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 9 Jul 2024 19:09:29 +0200 Subject: [PATCH 666/814] savepoint --- .../Misc/NetworkConstants.swift | 3 +- .../WalletConnectRelay/RelayURLFactory.swift | 8 ++--- .../AutomaticSocketConnectionHandler.swift | 24 +++++---------- .../ManualSocketConnectionHandler.swift | 19 ++++-------- .../SocketConnectionHandler.swift | 1 - .../SocketUrlFallbackHandler.swift | 29 ------------------- 6 files changed, 16 insertions(+), 68 deletions(-) delete mode 100644 Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift diff --git a/Sources/WalletConnectRelay/Misc/NetworkConstants.swift b/Sources/WalletConnectRelay/Misc/NetworkConstants.swift index 5a23a21c8..9f2d6f259 100644 --- a/Sources/WalletConnectRelay/Misc/NetworkConstants.swift +++ b/Sources/WalletConnectRelay/Misc/NetworkConstants.swift @@ -1,4 +1,3 @@ enum NetworkConstants { - static var defaultUrl = "relay.walletconnect.com" - static var fallbackUrl = "relay.walletconnect.org" + static var defaultUrl = "relay.walletconnect.org" } diff --git a/Sources/WalletConnectRelay/RelayURLFactory.swift b/Sources/WalletConnectRelay/RelayURLFactory.swift index 20290fd24..5809c89fa 100644 --- a/Sources/WalletConnectRelay/RelayURLFactory.swift +++ b/Sources/WalletConnectRelay/RelayURLFactory.swift @@ -18,19 +18,15 @@ class RelayUrlFactory { self.socketAuthenticator = socketAuthenticator } - func setFallback() { - self.fallback = true - } - func create() -> URL { var components = URLComponents() components.scheme = "wss" - components.host = fallback ? NetworkConstants.fallbackUrl : relayHost + components.host = relayHost components.queryItems = [ URLQueryItem(name: "projectId", value: projectId) ] do { - let authToken = try socketAuthenticator.createAuthToken(url: fallback ? "wss://" + NetworkConstants.fallbackUrl : "wss://" + relayHost) + let authToken = try socketAuthenticator.createAuthToken(url: "wss://" + relayHost) components.queryItems?.append(URLQueryItem(name: "auth", value: authToken)) } catch { // TODO: Handle token creation errors diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 3be94af13..a757884c1 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -14,9 +14,8 @@ class AutomaticSocketConnectionHandler { private let appStateObserver: AppStateObserving private let networkMonitor: NetworkMonitoring private let backgroundTaskRegistrar: BackgroundTaskRegistering - private let defaultTimeout: Int = 5 + private let defaultTimeout: Int = 30 private let logger: ConsoleLogging - private var socketUrlFallbackHandler: SocketUrlFallbackHandler private var publishers = Set() private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", qos: .utility, attributes: .concurrent) @@ -27,24 +26,16 @@ class AutomaticSocketConnectionHandler { appStateObserver: AppStateObserving = AppStateObserver(), backgroundTaskRegistrar: BackgroundTaskRegistering = BackgroundTaskRegistrar(), logger: ConsoleLogging, - socketUrlFallbackHandler: SocketUrlFallbackHandler ) { self.appStateObserver = appStateObserver self.socket = socket self.networkMonitor = networkMonitor self.backgroundTaskRegistrar = backgroundTaskRegistrar self.logger = logger - self.socketUrlFallbackHandler = socketUrlFallbackHandler setUpStateObserving() setUpNetworkMonitoring() - socketUrlFallbackHandler.onTryReconnect = { [unowned self] in - Task(priority: .high) { - await tryReconect() - } - } - connect() } @@ -63,7 +54,7 @@ class AutomaticSocketConnectionHandler { } if !self.socket.isConnected { self.logger.debug("Connection timed out, initiating fallback...") - self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) + retryToConnect() } timer.cancel() } @@ -99,6 +90,12 @@ class AutomaticSocketConnectionHandler { socket.disconnect() } + private func retryToConnect() { + if !socket.isConnected { + socket.connect() + } + } + private func reconnectIfNeeded() { if !socket.isConnected { socket.connect() @@ -109,11 +106,6 @@ class AutomaticSocketConnectionHandler { // MARK: - SocketConnectionHandler extension AutomaticSocketConnectionHandler: SocketConnectionHandler { - func tryReconect() async { - guard await appStateObserver.currentState == .foreground else { return } - reconnectIfNeeded() - } - func handleConnect() throws { throw Errors.manualSocketConnectionForbidden } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index d0589ca9e..100f8bd3c 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -4,23 +4,14 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { private let socket: WebSocketConnecting private let logger: ConsoleLogging - private let defaultTimeout: Int = 5 - private var socketUrlFallbackHandler: SocketUrlFallbackHandler + private let defaultTimeout: Int = 30 private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.manual_socket_connection", attributes: .concurrent) init( socket: WebSocketConnecting, - logger: ConsoleLogging, - socketUrlFallbackHandler: SocketUrlFallbackHandler) { + logger: ConsoleLogging) { self.socket = socket self.logger = logger - self.socketUrlFallbackHandler = socketUrlFallbackHandler - - socketUrlFallbackHandler.onTryReconnect = { [unowned self] in - Task(priority: .high) { - await tryReconect() - } - } } func handleConnect() throws { @@ -34,8 +25,8 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { return } if !self.socket.isConnected { - self.logger.debug("Connection timed out, initiating fallback...") - self.socketUrlFallbackHandler.handleFallbackIfNeeded(error: .connectionFailed) + self.logger.debug("Connection timed out, will rety to connect...") + retryToConnect() } timer.cancel() } @@ -51,7 +42,7 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { // ManualSocketConnectionHandler does not support reconnection logic } - func tryReconect() async { + private func retryToConnect() { if !socket.isConnected { socket.connect() } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift index 91284893b..4ac3046dd 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift @@ -4,5 +4,4 @@ protocol SocketConnectionHandler { func handleConnect() throws func handleDisconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws func handleDisconnection() async - func tryReconect() async } diff --git a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift b/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift deleted file mode 100644 index dea30eecd..000000000 --- a/Sources/WalletConnectRelay/SocketUrlFallbackHandler.swift +++ /dev/null @@ -1,29 +0,0 @@ -import Foundation - -class SocketUrlFallbackHandler { - private let relayUrlFactory: RelayUrlFactory - private var logger: ConsoleLogging - private var socket: WebSocketConnecting - private let networkMonitor: NetworkMonitoring - var onTryReconnect: (()->())? - - init( - relayUrlFactory: RelayUrlFactory, - logger: ConsoleLogging, - socket: WebSocketConnecting, - networkMonitor: NetworkMonitoring) { - self.relayUrlFactory = relayUrlFactory - self.logger = logger - self.socket = socket - self.networkMonitor = networkMonitor - } - - func handleFallbackIfNeeded(error: NetworkError) { - if error == .connectionFailed && socket.request.url?.host == NetworkConstants.defaultUrl { - logger.debug("[WebSocket] - Fallback to \(NetworkConstants.fallbackUrl)") - relayUrlFactory.setFallback() - socket.request.url = relayUrlFactory.create() - onTryReconnect?() - } - } -} From b410943c4eadfd30c544bd9cfa5bb8b64bbb29cf Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jul 2024 08:08:58 +0200 Subject: [PATCH 667/814] remove fallback handler --- Sources/WalletConnectRelay/RelayClientFactory.swift | 11 +++-------- .../AutomaticSocketConnectionHandler.swift | 8 ++++---- .../ManualSocketConnectionHandler.swift | 2 +- Tests/RelayerTests/DispatcherTests.swift | 3 +-- .../ManualSocketConnectionHandlerTests.swift | 3 +-- 5 files changed, 10 insertions(+), 17 deletions(-) diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 3a4097336..2120b720e 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -61,16 +61,11 @@ public struct RelayClientFactory { if let bundleId = Bundle.main.bundleIdentifier { socket.request.addValue(bundleId, forHTTPHeaderField: "Origin") } - let socketFallbackHandler = SocketUrlFallbackHandler( - relayUrlFactory: relayUrlFactory, - logger: logger, - socket: socket, - networkMonitor: networkMonitor - ) + var socketConnectionHandler: SocketConnectionHandler! switch socketConnectionType { - case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger, socketUrlFallbackHandler: socketFallbackHandler) - case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket, logger: logger, socketUrlFallbackHandler: socketFallbackHandler) + case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger) + case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket, logger: logger) } let dispatcher = Dispatcher( diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index a757884c1..c9ea12219 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -14,7 +14,7 @@ class AutomaticSocketConnectionHandler { private let appStateObserver: AppStateObserving private let networkMonitor: NetworkMonitoring private let backgroundTaskRegistrar: BackgroundTaskRegistering - private let defaultTimeout: Int = 30 + private let defaultTimeout: Int = 60 private let logger: ConsoleLogging private var publishers = Set() @@ -25,7 +25,7 @@ class AutomaticSocketConnectionHandler { networkMonitor: NetworkMonitoring = NetworkMonitor(), appStateObserver: AppStateObserving = AppStateObserver(), backgroundTaskRegistrar: BackgroundTaskRegistering = BackgroundTaskRegistrar(), - logger: ConsoleLogging, + logger: ConsoleLogging ) { self.appStateObserver = appStateObserver self.socket = socket @@ -53,7 +53,7 @@ class AutomaticSocketConnectionHandler { return } if !self.socket.isConnected { - self.logger.debug("Connection timed out, initiating fallback...") + self.logger.debug("Connection timed out, will rety to connect...") retryToConnect() } timer.cancel() @@ -92,7 +92,7 @@ class AutomaticSocketConnectionHandler { private func retryToConnect() { if !socket.isConnected { - socket.connect() + connect() } } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index 100f8bd3c..04152bd21 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -4,7 +4,7 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { private let socket: WebSocketConnecting private let logger: ConsoleLogging - private let defaultTimeout: Int = 30 + private let defaultTimeout: Int = 60 private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.manual_socket_connection", attributes: .concurrent) init( diff --git a/Tests/RelayerTests/DispatcherTests.swift b/Tests/RelayerTests/DispatcherTests.swift index 4a58cfd97..e8b0de168 100644 --- a/Tests/RelayerTests/DispatcherTests.swift +++ b/Tests/RelayerTests/DispatcherTests.swift @@ -71,8 +71,7 @@ final class DispatcherTests: XCTestCase { projectId: "1012db890cf3cfb0c1cdc929add657ba", socketAuthenticator: socketAuthenticator ) - let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: logger, socket: webSocket, networkMonitor: networkMonitor) - let socketConnectionHandler = ManualSocketConnectionHandler(socket: webSocket, logger: logger, socketUrlFallbackHandler: socketUrlFallbackHandler) + let socketConnectionHandler = ManualSocketConnectionHandler(socket: webSocket, logger: logger) sut = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: relayUrlFactory, diff --git a/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift b/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift index 6f8a939cb..d86fbc9cf 100644 --- a/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/ManualSocketConnectionHandlerTests.swift @@ -22,9 +22,8 @@ final class ManualSocketConnectionHandlerTests: XCTestCase { projectId: "1012db890cf3cfb0c1cdc929add657ba", socketAuthenticator: socketAuthenticator ) - let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: ConsoleLoggerMock(), socket: socket, networkMonitor: networkMonitor) - sut = ManualSocketConnectionHandler(socket: socket, logger: ConsoleLoggerMock(), socketUrlFallbackHandler: socketUrlFallbackHandler) + sut = ManualSocketConnectionHandler(socket: socket, logger: ConsoleLoggerMock()) } func testHandleDisconnect() { From dbbd7f9e423418cda6ff1625862d95a19d0fdd5e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jul 2024 08:10:03 +0200 Subject: [PATCH 668/814] fix tests --- .../RelayerTests/AutomaticSocketConnectionHandlerTests.swift | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index b29a830ba..368d25da4 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -28,14 +28,12 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { socketAuthenticator: socketAuthenticator ) backgroundTaskRegistrar = BackgroundTaskRegistrarMock() - let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: ConsoleLoggerMock(), socket: webSocket, networkMonitor: networkMonitor) sut = AutomaticSocketConnectionHandler( socket: webSocketSession, networkMonitor: networkMonitor, appStateObserver: appStateObserver, backgroundTaskRegistrar: backgroundTaskRegistrar, - logger: ConsoleLoggerMock(), - socketUrlFallbackHandler: socketUrlFallbackHandler + logger: ConsoleLoggerMock() ) } From 96a1ae89dfa5ba75f576af36b70b6bc023d50b3c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 10 Jul 2024 13:04:55 +0200 Subject: [PATCH 669/814] fix tests --- Example/RelayIntegrationTests/RelayClientEndToEndTests.swift | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index eef6758de..e3888e786 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -52,9 +52,7 @@ final class RelayClientEndToEndTests: XCTestCase { socketAuthenticator: socketAuthenticator ) - let socketUrlFallbackHandler = SocketUrlFallbackHandler(relayUrlFactory: relayUrlFactory, logger: logger, socket: socket, networkMonitor: networkMonitor) - - let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger, socketUrlFallbackHandler: socketUrlFallbackHandler) + let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger) let dispatcher = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: urlFactory, From 73e39aa595e99ea5ccaea4f89dc43525be7906b5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 11 Jul 2024 15:23:18 +0200 Subject: [PATCH 670/814] fix linkmode response encoding --- .../WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index bd7d093a1..5eec32a99 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -129,7 +129,7 @@ final class LinkEnvelopesDispatcher { } private func serializeAndCreateUrl(peerUniversalLink: String, encodable: Encodable, envelopeType: Envelope.EnvelopeType, topic: String) throws -> URL { - let envelope = try serializer.serialize(topic: topic, encodable: encodable, envelopeType: envelopeType) + let envelope = try serializer.serialize(topic: topic, encodable: encodable, envelopeType: envelopeType, codingType: .base64UrlEncoded) guard var components = URLComponents(string: peerUniversalLink) else { throw URLError(.badURL) } From a19598716a8bf50dc48eacf272c7219da4a7b9a3 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Sun, 14 Jul 2024 16:46:26 +0000 Subject: [PATCH 671/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index ec58e3328..c09ac47c5 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.4"} +{"version": "1.19.5"} From fbacc4ceb6cec5162644a0dacf6a54d295188b89 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 15 Jul 2024 10:42:46 +0200 Subject: [PATCH 672/814] change podspec --- .../Auth/Link/LinkEnvelopesDispatcher.swift | 3 + WalletConnectSwiftV2.podspec | 62 +++---------------- 2 files changed, 13 insertions(+), 52 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 5eec32a99..2ac026b5a 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -1,5 +1,8 @@ +#if os(iOS) import UIKit +#endif + import Combine final class LinkEnvelopesDispatcher { diff --git a/WalletConnectSwiftV2.podspec b/WalletConnectSwiftV2.podspec index e6b1e4cf7..29d8cc4ab 100644 --- a/WalletConnectSwiftV2.podspec +++ b/WalletConnectSwiftV2.podspec @@ -2,76 +2,27 @@ require "json" package = JSON.parse(File.read(File.join(__dir__, "Sources/WalletConnectRelay/PackageConfig.json"))) -# -# Be sure to run `pod spec lint WalletConnectSwiftV2.podspec' to ensure this is a -# valid spec and to remove all comments including this before submitting the spec. -# -# To learn more about Podspec attributes see https://guides.cocoapods.org/syntax/podspec.html -# To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/ -# - Pod::Spec.new do |spec| - # ――― Spec Metadata ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # - # - # These will help people to find your library, and whilst it - # can feel like a chore to fill in it's definitely to your advantage. The - # summary should be tweet-length, and the description more in depth. - # - spec.name = "WalletConnectSwiftV2" spec.version = package["version"] spec.summary = "Swift implementation of WalletConnect v.2 protocol for native iOS applications." spec.description = "The communications protocol for web3, WalletConnect brings the ecosystem together by enabling wallets and apps to securely connect and interact." spec.homepage = "https://walletconnect.com" spec.license = { :type => 'Apache-2.0', :file => 'LICENSE' } - - # ――― Author Metadata ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # - # - # Specify the authors of the library, with email addresses. Email addresses - # of the authors are extracted from the SCM log. E.g. $ git log. CocoaPods also - # accepts just a name if you'd rather not provide an email address. - # - # Specify a social_media_url where others can refer to, for example a twitter - # profile URL. - # - spec.authors = "WalletConnect, Inc." spec.social_media_url = "https://twitter.com/WalletConnect" - - # ――― Source Location ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― # - # - # Specify the location from where the source should be retrieved. - # Supports git, hg, bzr, svn and HTTP. - # - spec.source = { :git => 'https://github.com/WalletConnect/WalletConnectSwiftV2.git', :tag => spec.version.to_s } - - # ――― Platform Specifics ――――――――――――――――――――――――――――――――――――――――――――――――――――――― # - # - # If this Pod runs only on iOS or OS X, then specify the platform and - # the deployment target. You can optionally include the target after the platform. - # - - ios_deployment_target = '13.0' - osx_deployment_target = '10.15' - tvos_deployment_target = '13.0' - + + spec.platform = :ios, '13.0' spec.swift_versions = '5.3' - spec.pod_target_xcconfig = { 'OTHER_SWIFT_FLAGS' => '-DCocoaPods' } - spec.ios.deployment_target = ios_deployment_target - spec.osx.deployment_target = osx_deployment_target - spec.tvos.deployment_target = tvos_deployment_target - - # ――― Sub Specs ――――――――――――――――――――――――――――――――――――――――――――――――――――――― # - spec.default_subspecs = 'WalletConnect' spec.subspec 'WalletConnect' do |ss| @@ -87,6 +38,7 @@ Pod::Spec.new do |spec| ss.dependency 'WalletConnectSwiftV2/WalletConnectPairing' ss.dependency 'WalletConnectSwiftV2/WalletConnectSigner' ss.dependency 'WalletConnectSwiftV2/WalletConnectVerify' + ss.dependency 'WalletConnectSwiftV2/Events' end spec.subspec 'WalletConnectAuth' do |ss| @@ -144,6 +96,7 @@ Pod::Spec.new do |spec| spec.subspec 'WalletConnectPairing' do |ss| ss.source_files = 'Sources/WalletConnectPairing/**/*.{h,m,swift}' ss.dependency 'WalletConnectSwiftV2/WalletConnectNetworking' + ss.dependency 'WalletConnectSwiftV2/Events' end spec.subspec 'WalletConnectRouter' do |ss| @@ -175,6 +128,12 @@ Pod::Spec.new do |spec| ss.source_files = 'Sources/Commons/**/*.{h,m,swift}' end + spec.subspec 'Events' do |ss| + ss.source_files = 'Sources/Events/**/*.{h,m,swift}' + ss.dependency 'WalletConnectSwiftV2/WalletConnectNetworking' + ss.dependency 'WalletConnectSwiftV2/WalletConnectUtils' + end + spec.subspec 'JSONRPC' do |ss| ss.source_files = 'Sources/JSONRPC/**/*.{h,m,swift}' ss.dependency 'WalletConnectSwiftV2/Commons' @@ -189,6 +148,5 @@ Pod::Spec.new do |spec| ss.dependency 'WalletConnectSwiftV2/WalletConnectSign' ss.dependency 'DSF_QRCode', '~> 16.1.1' ss.platform = :ios - # TODO: Re-add macOS nad tvOS support once fixed end end From 500817c160d49fc60730938e813865a7d0b104ae Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jul 2024 08:53:52 +0200 Subject: [PATCH 673/814] update fastfile --- .envrc | 1 + Example/ExampleApp.xcodeproj/project.pbxproj | 61 +++++++++++--------- fastlane/Fastfile | 8 ++- fastlane/Matchfile | 8 +++ 4 files changed, 51 insertions(+), 27 deletions(-) create mode 100644 .envrc create mode 100644 fastlane/Matchfile diff --git a/.envrc b/.envrc new file mode 100644 index 000000000..a498dd64e --- /dev/null +++ b/.envrc @@ -0,0 +1 @@ +source .env diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 2447d9efa..11d827abf 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -2651,7 +2651,7 @@ CLANG_WARN_UNREACHABLE_CODE = YES; CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; COPY_PHASE_STRIP = NO; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEBUG_INFORMATION_FORMAT = dwarf; ENABLE_STRICT_OBJC_MSGSEND = YES; ENABLE_TESTABILITY = YES; @@ -2715,7 +2715,7 @@ CLANG_WARN_UNREACHABLE_CODE = YES; CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; COPY_PHASE_STRIP = NO; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; ENABLE_NS_ASSERTIONS = NO; ENABLE_STRICT_OBJC_MSGSEND = YES; @@ -2744,7 +2744,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 1; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 14.0; @@ -2762,7 +2762,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 1; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 14.0; @@ -2783,9 +2783,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_ENTITLEMENTS = DApp/DApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 18; - DEVELOPMENT_TEAM = W5R8AG9K22; + CODE_SIGN_STYLE = Manual; + CURRENT_PROJECT_VERSION = 173; + DEVELOPMENT_TEAM = ""; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = DApp/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = dApp; @@ -2820,7 +2820,7 @@ CODE_SIGN_ENTITLEMENTS = DApp/DAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 18; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = DApp/Info.plist; @@ -2854,7 +2854,7 @@ CODE_SIGN_ENTITLEMENTS = PNDecryptionService/PNDecryptionService.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = PNDecryptionService/Info.plist; @@ -2883,9 +2883,11 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = PNDecryptionService/PNDecryptionServiceRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; - DEVELOPMENT_TEAM = W5R8AG9K22; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; + CODE_SIGN_STYLE = Manual; + CURRENT_PROJECT_VERSION = 173; + DEVELOPMENT_TEAM = ""; + "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = PNDecryptionService/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = PNDecryptionService; @@ -2900,6 +2902,7 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp.PNDecryptionService; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; + "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp.PNDecryptionService"; SKIP_INSTALL = YES; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; @@ -2916,7 +2919,7 @@ CODE_SIGN_IDENTITY = "Apple Development"; "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer"; CODE_SIGN_STYLE = Manual; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = ""; "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; @@ -2951,7 +2954,7 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; CODE_SIGN_STYLE = Manual; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = ""; "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; @@ -2983,7 +2986,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 13.0; @@ -3001,7 +3004,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 13.0; @@ -3019,7 +3022,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GCC_PREPROCESSOR_DEFINITIONS = ( "DEBUG=1", @@ -3042,7 +3045,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 7; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 14.0; @@ -3063,9 +3066,11 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = WalletApp/WalletApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 164; - DEVELOPMENT_TEAM = W5R8AG9K22; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; + CODE_SIGN_STYLE = Manual; + CURRENT_PROJECT_VERSION = 173; + DEVELOPMENT_TEAM = ""; + "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = WalletApp/Other/Info.plist; @@ -3084,6 +3089,7 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; + "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; @@ -3099,9 +3105,11 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = WalletApp/WalletAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 164; - DEVELOPMENT_TEAM = W5R8AG9K22; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; + CODE_SIGN_STYLE = Manual; + CURRENT_PROJECT_VERSION = 173; + DEVELOPMENT_TEAM = ""; + "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = WalletApp/Other/Info.plist; @@ -3120,6 +3128,7 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; + "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; @@ -3131,7 +3140,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 1; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 14.0; @@ -3149,7 +3158,7 @@ buildSettings = { CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_STYLE = Automatic; - CURRENT_PROJECT_VERSION = 1; + CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; IPHONEOS_DEPLOYMENT_TARGET = 14.0; diff --git a/fastlane/Fastfile b/fastlane/Fastfile index 114bce38f..0d89343e3 100644 --- a/fastlane/Fastfile +++ b/fastlane/Fastfile @@ -83,7 +83,7 @@ platform :ios do readonly: false, type: "appstore", app_identifier: ENV["MATCH_IDENTIFIERS"], - git_url: "https://github.com/WalletConnect/match-swift.git", + git_url: ENV["GIT_URL"], git_basic_authorization: options[:token], api_key: api_key, include_all_certificates: true, @@ -103,6 +103,12 @@ platform :ios do project: "Example/ExampleApp.xcodeproj", scheme: ENV["SCHEME"], export_method: "app-store", + export_options: { + provisioningProfiles: { + "com.walletconnect.walletapp" => "match AppStore com.walletconnect.walletapp", + "com.walletconnect.walletapp.PNDecryptionService" => "match AppStore com.walletconnect.walletapp.PNDecryptionService" + } + }, xcargs: "RELAY_HOST='#{options[:relay_host]}' PROJECT_ID='#{options[:project_id]}' WALLETAPP_SENTRY_DSN='#{options[:sentry_dsn]}' MIXPANEL_TOKEN='#{options[:mixpanel_token]}'" ) upload_to_testflight( diff --git a/fastlane/Matchfile b/fastlane/Matchfile new file mode 100644 index 000000000..0f2aadd72 --- /dev/null +++ b/fastlane/Matchfile @@ -0,0 +1,8 @@ +# fastlane/Matchfile + +git_url ENV["GIT_URL"] +type "appstore" # The default type, can be: appstore, adhoc, enterprise or development + +app_identifier ENV["MATCH_IDENTIFIERS"] +username ENV["FASTLANE_USER"] +team_id ENV["TEAM_ID"] \ No newline at end of file From 2635a0b1a47288457d6a1b112bac2e34857b1380 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jul 2024 09:20:40 +0200 Subject: [PATCH 674/814] update release.ymp --- .github/workflows/release.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 19e18a18f..d5b566841 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -38,5 +38,6 @@ jobs: APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }} APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }} WALLETAPP_SENTRY_DSN: ${{ secrets.WALLETAPP_SENTRY_DSN }} + GIT_URL: ${{ secrets.GIT_URL }} run: | make release APPLE_ID=${{ secrets.APPLE_ID }} TOKEN=$(echo -n $GH_USER:$GH_TOKEN | base64) PROJECT_ID=${{ secrets.RELEASE_PROJECT_ID }} WALLETAPP_SENTRY_DSN=${{ secrets.WALLETAPP_SENTRY_DSN }} MIXPANEL_TOKEN=${{secrets.MIXPANEL_TOKEN}} APP=${{ github.event.inputs.app }} From d8b27d6afef080754a1d9d0bed09180ebec7513d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jul 2024 09:59:30 +0200 Subject: [PATCH 675/814] update --- .github/workflows/release.yml | 2 +- Example/ExampleApp.xcodeproj/project.pbxproj | 7 +++++-- fastlane/Fastfile | 3 ++- fastlane/Matchfile | 2 +- 4 files changed, 9 insertions(+), 5 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index d5b566841..85dce2767 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -38,6 +38,6 @@ jobs: APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }} APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }} WALLETAPP_SENTRY_DSN: ${{ secrets.WALLETAPP_SENTRY_DSN }} - GIT_URL: ${{ secrets.GIT_URL }} + MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }} run: | make release APPLE_ID=${{ secrets.APPLE_ID }} TOKEN=$(echo -n $GH_USER:$GH_TOKEN | base64) PROJECT_ID=${{ secrets.RELEASE_PROJECT_ID }} WALLETAPP_SENTRY_DSN=${{ secrets.WALLETAPP_SENTRY_DSN }} MIXPANEL_TOKEN=${{secrets.MIXPANEL_TOKEN}} APP=${{ github.event.inputs.app }} diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 11d827abf..dda6d3a3b 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -2819,9 +2819,11 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_ENTITLEMENTS = DApp/DAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - CODE_SIGN_STYLE = Automatic; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; + CODE_SIGN_STYLE = Manual; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = W5R8AG9K22; + DEVELOPMENT_TEAM = ""; + "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = DApp/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = dApp; @@ -2841,6 +2843,7 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.dapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; + "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.dapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; diff --git a/fastlane/Fastfile b/fastlane/Fastfile index 0d89343e3..fb017b307 100644 --- a/fastlane/Fastfile +++ b/fastlane/Fastfile @@ -106,7 +106,8 @@ platform :ios do export_options: { provisioningProfiles: { "com.walletconnect.walletapp" => "match AppStore com.walletconnect.walletapp", - "com.walletconnect.walletapp.PNDecryptionService" => "match AppStore com.walletconnect.walletapp.PNDecryptionService" + "com.walletconnect.walletapp.PNDecryptionService" => "match AppStore com.walletconnect.walletapp.PNDecryptionService", + "com.walletconnect.dapp" => "match AppStore com.walletconnect.dapp" } }, xcargs: "RELAY_HOST='#{options[:relay_host]}' PROJECT_ID='#{options[:project_id]}' WALLETAPP_SENTRY_DSN='#{options[:sentry_dsn]}' MIXPANEL_TOKEN='#{options[:mixpanel_token]}'" diff --git a/fastlane/Matchfile b/fastlane/Matchfile index 0f2aadd72..eca226a1e 100644 --- a/fastlane/Matchfile +++ b/fastlane/Matchfile @@ -1,6 +1,6 @@ # fastlane/Matchfile -git_url ENV["GIT_URL"] +git_url ENV["MATCH_GIT_URL"] type "appstore" # The default type, can be: appstore, adhoc, enterprise or development app_identifier ENV["MATCH_IDENTIFIERS"] From 7f725e6b038f1dc6c78a5b8f22bd9a7dbc4827be Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 17 Jul 2024 10:00:48 +0200 Subject: [PATCH 676/814] disable automatic signing --- Example/ExampleApp.xcodeproj/project.pbxproj | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index dda6d3a3b..cf70d6ce0 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -2783,9 +2783,11 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_ENTITLEMENTS = DApp/DApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; CODE_SIGN_STYLE = Manual; CURRENT_PROJECT_VERSION = 173; DEVELOPMENT_TEAM = ""; + "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = DApp/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = dApp; @@ -2805,6 +2807,7 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.dapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; + "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.dapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; @@ -2856,9 +2859,11 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = PNDecryptionService/PNDecryptionService.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - CODE_SIGN_STYLE = Automatic; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; + CODE_SIGN_STYLE = Manual; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = W5R8AG9K22; + DEVELOPMENT_TEAM = ""; + "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = PNDecryptionService/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = PNDecryptionService; @@ -2873,6 +2878,7 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp.PNDecryptionService; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; + "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp.PNDecryptionService"; SKIP_INSTALL = YES; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; From 6bd05a3401675db1224d419f8609856d1cc7e652 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 19 Jul 2024 20:10:33 +0200 Subject: [PATCH 677/814] add VerifyServerPubKeyManager, remove verify .com fallback --- .../RPC/Methods/Subscription.swift | 13 +++-- .../WalletConnectVerify/OriginVerifier.swift | 14 +---- .../PublicKeyFetcher.swift | 35 +++++++++++++ .../VerifyServerPubKeyManager.swift | 39 ++++++++++++++ .../VerifyServerPubKeyManagerTests.swift | 52 +++++++++++++++++++ 5 files changed, 136 insertions(+), 17 deletions(-) create mode 100644 Sources/WalletConnectVerify/PublicKeyFetcher.swift create mode 100644 Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift create mode 100644 Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift diff --git a/Sources/WalletConnectRelay/RPC/Methods/Subscription.swift b/Sources/WalletConnectRelay/RPC/Methods/Subscription.swift index c4e4b1831..be2b25259 100644 --- a/Sources/WalletConnectRelay/RPC/Methods/Subscription.swift +++ b/Sources/WalletConnectRelay/RPC/Methods/Subscription.swift @@ -8,21 +8,24 @@ struct Subscription: RelayRPC { let topic: String let message: String let publishedAt: Date + let attestation: String? enum CodingKeys: String, CodingKey { - case topic, message, publishedAt + case topic, message, publishedAt, attestation } - internal init(topic: String, message: String, publishedAt: Date) { + internal init(topic: String, message: String, publishedAt: Date, attestation: String?) { self.topic = topic self.message = message self.publishedAt = publishedAt + self.attestation = attestation } init(from decoder: Decoder) throws { let container = try decoder.container(keyedBy: CodingKeys.self) topic = try container.decode(String.self, forKey: .topic) message = try container.decode(String.self, forKey: .message) + attestation = try? container.decode(String.self, forKey: .attestation) let publishedAtMiliseconds = try container.decode(UInt64.self, forKey: .publishedAt) publishedAt = Date(milliseconds: publishedAtMiliseconds) } @@ -45,7 +48,9 @@ struct Subscription: RelayRPC { "irn_subscription" } - init(id: String, topic: String, message: String) { - self.params = Params(id: id, data: Params.Contents(topic: topic, message: message, publishedAt: Date())) + #if DEBUG + init(id: String, topic: String, message: String, attestation: String? = nil) { + self.params = Params(id: id, data: Params.Contents(topic: topic, message: message, publishedAt: Date(), attestation: attestation)) } + #endif } diff --git a/Sources/WalletConnectVerify/OriginVerifier.swift b/Sources/WalletConnectVerify/OriginVerifier.swift index 0689088d2..54d4452f0 100644 --- a/Sources/WalletConnectVerify/OriginVerifier.swift +++ b/Sources/WalletConnectVerify/OriginVerifier.swift @@ -5,10 +5,7 @@ public final class OriginVerifier { case registrationFailed } - private var verifyHost = "verify.walletconnect.com" - /// The property is used to determine whether verify.walletconnect.org will be used - /// in case verify.walletconnect.com doesn't respond for some reason (most likely due to being blocked in the user's location). - private var fallback = false + private var verifyHost = "verify.walletconnect.org" func verifyOrigin(assertionId: String) async throws -> VerifyResponse { let sessionConfiguration = URLSessionConfiguration.default @@ -28,17 +25,8 @@ public final class OriginVerifier { } return response } catch { - if (error as? HTTPError) == .couldNotConnect && !fallback { - fallback = true - verifyHostFallback() - return try await verifyOrigin(assertionId: assertionId) - } throw error } } - - func verifyHostFallback() { - verifyHost = "verify.walletconnect.org" - } } diff --git a/Sources/WalletConnectVerify/PublicKeyFetcher.swift b/Sources/WalletConnectVerify/PublicKeyFetcher.swift new file mode 100644 index 000000000..849037f05 --- /dev/null +++ b/Sources/WalletConnectVerify/PublicKeyFetcher.swift @@ -0,0 +1,35 @@ +import Foundation + +// PublicKeyFetcher class +class PublicKeyFetcher { + struct VerifyServerPublicKey: Codable { + let publicKey: String + let expiresAt: TimeInterval + } + + private let urlString = "https://verify.walletconnect.org/v2/public-key" + + func fetchPublicKey() async throws -> VerifyServerPublicKey { + guard let url = URL(string: urlString) else { + throw NSError(domain: "", code: 0, userInfo: [NSLocalizedDescriptionKey: "Invalid URL"]) + } + + let (data, _) = try await URLSession.shared.data(from: url) + let publicKeyResponse = try JSONDecoder().decode(VerifyServerPublicKey.self, from: data) + return publicKeyResponse + } +} + +#if DEBUG +class MockPublicKeyFetcher: PublicKeyFetcher { + var publicKey: VerifyServerPublicKey? + var error: Error? + + override func fetchPublicKey() async throws -> VerifyServerPublicKey { + if let error = error { + throw error + } + return publicKey! + } +} +#endif diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift new file mode 100644 index 000000000..b0f8c1457 --- /dev/null +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -0,0 +1,39 @@ +import Foundation + +class VerifyServerPubKeyManager { + static let publicKeyStorageKey = "com.walletconnect.verify.pubKey" + private let store: CodableStore + private let fetcher: PublicKeyFetcher + + init(store: CodableStore, fetcher: PublicKeyFetcher) { + self.store = store + self.fetcher = fetcher + } + + // Public async function to get the public key + func getPublicKey() async throws -> String { + if let localKey = try getPublicKeyFromLocalStorage(), !isKeyExpired(localKey) { + return localKey.publicKey + } else { + let serverKey = try await fetcher.fetchPublicKey() + savePublicKeyToLocalStorage(publicKey: serverKey) + return serverKey.publicKey + } + } + + // Private function to get the public key from local storage + private func getPublicKeyFromLocalStorage() throws -> PublicKeyFetcher.VerifyServerPublicKey? { + return try store.get(key: Self.publicKeyStorageKey) + } + + // Private function to check if the key is expired + private func isKeyExpired(_ key: PublicKeyFetcher.VerifyServerPublicKey) -> Bool { + let currentTime = Date().timeIntervalSince1970 + return currentTime >= key.expiresAt + } + + // Private function to save the public key to local storage + private func savePublicKeyToLocalStorage(publicKey: PublicKeyFetcher.VerifyServerPublicKey) { + store.set(publicKey, forKey: Self.publicKeyStorageKey) + } +} diff --git a/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift b/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift new file mode 100644 index 000000000..8fd843fae --- /dev/null +++ b/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift @@ -0,0 +1,52 @@ +import Foundation +import XCTest +@testable import WalletConnectVerify + +class VerifyServerPubKeyManagerTests: XCTestCase { + var manager: VerifyServerPubKeyManager! + var store: CodableStore! + var fetcher: MockPublicKeyFetcher! + + override func setUp() { + super.setUp() + let storage = RuntimeKeyValueStorage() + store = CodableStore(defaults: storage, identifier: "test") + fetcher = MockPublicKeyFetcher() + manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) + } + + func testGetPublicKeyFromServer() async throws { + let expectedPublicKey = "test_public_key" + let expiresAt = Date().timeIntervalSince1970 + 3600 // 1 hour from now + fetcher.publicKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + + let publicKey = try await manager.getPublicKey() + + XCTAssertEqual(publicKey, expectedPublicKey) + } + + func testGetPublicKeyFromLocalStorage() async throws { + let expectedPublicKey = "test_public_key" + let expiresAt = Date().timeIntervalSince1970 + 3600 // 1 hour from now + let storedKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + store.set(storedKey, forKey: VerifyServerPubKeyManager.publicKeyStorageKey) + + let publicKey = try await manager.getPublicKey() + + XCTAssertEqual(publicKey, expectedPublicKey) + } + + func testGetExpiredPublicKeyFromLocalStorage() async throws { + let expectedPublicKey = "test_public_key" + let newTestPubKey = "new_test_public_key" + let expiresAt = Date().timeIntervalSince1970 - 3600 // 1 hour ago + let storedKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + store.set(storedKey, forKey: VerifyServerPubKeyManager.publicKeyStorageKey) + + fetcher.publicKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: newTestPubKey, expiresAt: Date().timeIntervalSince1970 + 3600) + + let publicKey = try await manager.getPublicKey() + + XCTAssertEqual(publicKey, newTestPubKey) + } +} From d3b80b369f70f090cb0baf0b70a26dfc499e214f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jul 2024 14:34:27 +0900 Subject: [PATCH 678/814] savepoint --- Package.swift | 2 +- Sources/WalletConnectJWT/JWTValidator.swift | 8 ++- .../WalletConnectVerify/VerifyClient.swift | 72 ++++++++++++++++++- .../WalletConnectVerify/VerifyImports.swift | 2 + .../VerifyServerPubKeyManager.swift | 10 +-- 5 files changed, 86 insertions(+), 8 deletions(-) diff --git a/Package.swift b/Package.swift index 7e5c3133c..797d5622c 100644 --- a/Package.swift +++ b/Package.swift @@ -121,7 +121,7 @@ let package = Package( path: "Sources/WalletConnectRouter/Router"), .target( name: "WalletConnectVerify", - dependencies: ["WalletConnectUtils", "WalletConnectNetworking"], + dependencies: ["WalletConnectUtils", "WalletConnectNetworking", "WalletConnectJWT"], resources: [.process("Resources/PrivacyInfo.xcprivacy")]), .target( name: "Database", diff --git a/Sources/WalletConnectJWT/JWTValidator.swift b/Sources/WalletConnectJWT/JWTValidator.swift index e94a72bdf..110309a8d 100644 --- a/Sources/WalletConnectJWT/JWTValidator.swift +++ b/Sources/WalletConnectJWT/JWTValidator.swift @@ -1,10 +1,14 @@ import Foundation -struct JWTValidator { +public struct JWTValidator { let jwtString: String - func isValid(publicKey: SigningPublicKey) throws -> Bool { + public init(jwtString: String) { + self.jwtString = jwtString + } + + public func isValid(publicKey: SigningPublicKey) throws -> Bool { var components = jwtString.components(separatedBy: ".") guard components.count == 3 else { throw JWTError.undefinedFormat } diff --git a/Sources/WalletConnectVerify/VerifyClient.swift b/Sources/WalletConnectVerify/VerifyClient.swift index 9e834d7ed..b4090be24 100644 --- a/Sources/WalletConnectVerify/VerifyClient.swift +++ b/Sources/WalletConnectVerify/VerifyClient.swift @@ -36,7 +36,11 @@ public actor VerifyClient: VerifyClientProtocol { public func verifyOrigin(assertionId: String) async throws -> VerifyResponse { return try await originVerifier.verifyOrigin(assertionId: assertionId) } - + + public func verifyOrigin(attestationJWT: String, messageId: String) async throws -> VerifyResponse { + + } + nonisolated public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { verifyContextFactory.createVerifyContext(origin: origin, domain: domain, isScam: isScam) } @@ -70,3 +74,69 @@ public struct VerifyClientMock: VerifyClientProtocol { } #endif + +class AttestationJWTVerifier { + + enum Errors: Error { + case issuerDoesNotMatchVerifyServerPubKey + case messageIdMismatch + case invalidJWT + } + + let verifyServerPubKeyManager: VerifyServerPubKeyManager + + init(verifyServerPubKeyManager: VerifyServerPubKeyManager) { + self.verifyServerPubKeyManager = verifyServerPubKeyManager + } + + // messageId - hash of the encrypted message supplied in the request + func verify(attestationJWT: String, messageId: String) async throws { + do { + let verifyServerPubKey = try await verifyServerPubKeyManager.getPublicKey() + try verifyJWTAgainstPubKey(attestationJWT, pubKey: verifyServerPubKey) + } catch { + let refreshedVerifyServerPubKey = try await verifyServerPubKeyManager.refreshKey() + try verifyJWTAgainstPubKey(attestationJWT, pubKey: refreshedVerifyServerPubKey) + } + + let claims = try decodeJWTClaims(jwtString: attestationJWT) + guard messageId == claims.id else { + throw Errors.messageIdMismatch + } + } + + func verifyJWTAgainstPubKey(_ jwtString: String, pubKey: String) throws { + let signingPubKey = try SigningPublicKey(hex: pubKey) + + let validator = JWTValidator(jwtString: jwtString) + guard try validator.isValid(publicKey: signingPubKey) else { + throw Errors.invalidJWT + } + } + + private func decodeJWTClaims(jwtString: String) throws -> AttestationJWTClaims { + let components = jwtString.components(separatedBy: ".") + + guard components.count == 3 else { throw Errors.invalidJWT } + + let payload = components[1] + guard let payloadData = Data(base64urlEncoded: payload) else { + throw Errors.invalidJWT + } + + let claims = try JSONDecoder().decode(AttestationJWTClaims.self, from: payloadData) + return claims + } +} + +struct AttestationJWTClaims: Codable { + + var exp: UInt64 + + var isScam: Bool? + + var id: String + + var origin: String +} + diff --git a/Sources/WalletConnectVerify/VerifyImports.swift b/Sources/WalletConnectVerify/VerifyImports.swift index 065c96db2..c47a6a9ba 100644 --- a/Sources/WalletConnectVerify/VerifyImports.swift +++ b/Sources/WalletConnectVerify/VerifyImports.swift @@ -1,4 +1,6 @@ #if !CocoaPods @_exported import WalletConnectUtils @_exported import WalletConnectNetworking +@_exported import WalletConnectJWT +@_exported import WalletConnectKMS #endif diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index b0f8c1457..c8acc994c 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -10,7 +10,6 @@ class VerifyServerPubKeyManager { self.fetcher = fetcher } - // Public async function to get the public key func getPublicKey() async throws -> String { if let localKey = try getPublicKeyFromLocalStorage(), !isKeyExpired(localKey) { return localKey.publicKey @@ -21,18 +20,21 @@ class VerifyServerPubKeyManager { } } - // Private function to get the public key from local storage + func refreshKey() async throws -> String { + let serverKey = try await fetcher.fetchPublicKey() + savePublicKeyToLocalStorage(publicKey: serverKey) + return serverKey.publicKey + } + private func getPublicKeyFromLocalStorage() throws -> PublicKeyFetcher.VerifyServerPublicKey? { return try store.get(key: Self.publicKeyStorageKey) } - // Private function to check if the key is expired private func isKeyExpired(_ key: PublicKeyFetcher.VerifyServerPublicKey) -> Bool { let currentTime = Date().timeIntervalSince1970 return currentTime >= key.expiresAt } - // Private function to save the public key to local storage private func savePublicKeyToLocalStorage(publicKey: PublicKeyFetcher.VerifyServerPublicKey) { store.set(publicKey, forKey: Self.publicKeyStorageKey) } From 94dd25821c2ffdc1e09b7e48be6d0b50bbc3d33d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jul 2024 15:59:44 +0900 Subject: [PATCH 679/814] fix build --- .../AttestationJWTVerifier.swift | 69 +++++++++++++++ .../PublicKeyFetcher.swift | 11 ++- .../WalletConnectVerify/VerifyClient.swift | 88 ++++--------------- .../VerifyClientFactory.swift | 7 +- .../VerifyServerPubKeyManager.swift | 6 +- 5 files changed, 104 insertions(+), 77 deletions(-) create mode 100644 Sources/WalletConnectVerify/AttestationJWTVerifier.swift diff --git a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift new file mode 100644 index 000000000..3d7ede265 --- /dev/null +++ b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift @@ -0,0 +1,69 @@ + +import Foundation + +struct AttestationJWTClaims: Codable { + + var exp: UInt64 + + var isScam: Bool? + + var id: String + + var origin: String +} + +class AttestationJWTVerifier { + + enum Errors: Error { + case issuerDoesNotMatchVerifyServerPubKey + case messageIdMismatch + case invalidJWT + } + + let verifyServerPubKeyManager: VerifyServerPubKeyManager + + init(verifyServerPubKeyManager: VerifyServerPubKeyManager) { + self.verifyServerPubKeyManager = verifyServerPubKeyManager + } + + // messageId - hash of the encrypted message supplied in the request + func verify(attestationJWT: String, messageId: String) async throws -> VerifyResponse { + do { + let verifyServerPubKey = try await verifyServerPubKeyManager.getPublicKey() + try verifyJWTAgainstPubKey(attestationJWT, pubKey: verifyServerPubKey) + } catch { + let refreshedVerifyServerPubKey = try await verifyServerPubKeyManager.refreshKey() + try verifyJWTAgainstPubKey(attestationJWT, pubKey: refreshedVerifyServerPubKey) + } + + let claims = try decodeJWTClaims(jwtString: attestationJWT) + guard messageId == claims.id else { + throw Errors.messageIdMismatch + } + + return VerifyResponse(origin: claims.origin, isScam: claims.isScam) + } + + func verifyJWTAgainstPubKey(_ jwtString: String, pubKey: String) throws { + let signingPubKey = try SigningPublicKey(hex: pubKey) + + let validator = JWTValidator(jwtString: jwtString) + guard try validator.isValid(publicKey: signingPubKey) else { + throw Errors.invalidJWT + } + } + + private func decodeJWTClaims(jwtString: String) throws -> AttestationJWTClaims { + let components = jwtString.components(separatedBy: ".") + + guard components.count == 3 else { throw Errors.invalidJWT } + + let payload = components[1] + guard let payloadData = Data(base64urlEncoded: payload) else { + throw Errors.invalidJWT + } + + let claims = try JSONDecoder().decode(AttestationJWTClaims.self, from: payloadData) + return claims + } +} diff --git a/Sources/WalletConnectVerify/PublicKeyFetcher.swift b/Sources/WalletConnectVerify/PublicKeyFetcher.swift index 849037f05..517761f15 100644 --- a/Sources/WalletConnectVerify/PublicKeyFetcher.swift +++ b/Sources/WalletConnectVerify/PublicKeyFetcher.swift @@ -1,7 +1,10 @@ import Foundation // PublicKeyFetcher class -class PublicKeyFetcher { +protocol PublicKeyFetching { + func fetchPublicKey() async throws -> PublicKeyFetcher.VerifyServerPublicKey +} +class PublicKeyFetcher: PublicKeyFetching { struct VerifyServerPublicKey: Codable { let publicKey: String let expiresAt: TimeInterval @@ -21,11 +24,11 @@ class PublicKeyFetcher { } #if DEBUG -class MockPublicKeyFetcher: PublicKeyFetcher { - var publicKey: VerifyServerPublicKey? +class MockPublicKeyFetcher: PublicKeyFetching { + var publicKey: PublicKeyFetcher.VerifyServerPublicKey? var error: Error? - override func fetchPublicKey() async throws -> VerifyServerPublicKey { + func fetchPublicKey() async throws -> PublicKeyFetcher.VerifyServerPublicKey { if let error = error { throw error } diff --git a/Sources/WalletConnectVerify/VerifyClient.swift b/Sources/WalletConnectVerify/VerifyClient.swift index b4090be24..4905f1fc2 100644 --- a/Sources/WalletConnectVerify/VerifyClient.swift +++ b/Sources/WalletConnectVerify/VerifyClient.swift @@ -7,6 +7,11 @@ public protocol VerifyClientProtocol { func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext } +public enum VerificationType { + case v1(assertionId: String) + case v2(attestationJWT: String, messageId: String) +} + public actor VerifyClient: VerifyClientProtocol { enum Errors: Error { case attestationNotSupported @@ -16,17 +21,20 @@ public actor VerifyClient: VerifyClientProtocol { let assertionRegistrer: AssertionRegistrer let appAttestationRegistrer: AppAttestationRegistrer let verifyContextFactory: VerifyContextFactory + let attestationVerifier: AttestationJWTVerifier init( originVerifier: OriginVerifier, assertionRegistrer: AssertionRegistrer, appAttestationRegistrer: AppAttestationRegistrer, - verifyContextFactory: VerifyContextFactory = VerifyContextFactory() + verifyContextFactory: VerifyContextFactory = VerifyContextFactory(), + attestationVerifier: AttestationJWTVerifier ) { self.originVerifier = originVerifier self.assertionRegistrer = assertionRegistrer self.appAttestationRegistrer = appAttestationRegistrer self.verifyContextFactory = verifyContextFactory + self.attestationVerifier = attestationVerifier } public func registerAttestationIfNeeded() async throws { @@ -37,8 +45,16 @@ public actor VerifyClient: VerifyClientProtocol { return try await originVerifier.verifyOrigin(assertionId: assertionId) } - public func verifyOrigin(attestationJWT: String, messageId: String) async throws -> VerifyResponse { - + /// Verify V2 attestation JWT + /// messageId - hash of the encrypted message supplied in the request + /// assertionId - hash of decrytped message + public func verify(_ verificationType: VerificationType) async throws -> VerifyResponse { + switch verificationType { + case .v1(let assertionId): + return try await verifyOrigin(assertionId: assertionId) + case .v2(let attestationJWT, let messageId): + return try await attestationVerifier.verify(attestationJWT: attestationJWT, messageId: messageId) + } } nonisolated public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { @@ -74,69 +90,3 @@ public struct VerifyClientMock: VerifyClientProtocol { } #endif - -class AttestationJWTVerifier { - - enum Errors: Error { - case issuerDoesNotMatchVerifyServerPubKey - case messageIdMismatch - case invalidJWT - } - - let verifyServerPubKeyManager: VerifyServerPubKeyManager - - init(verifyServerPubKeyManager: VerifyServerPubKeyManager) { - self.verifyServerPubKeyManager = verifyServerPubKeyManager - } - - // messageId - hash of the encrypted message supplied in the request - func verify(attestationJWT: String, messageId: String) async throws { - do { - let verifyServerPubKey = try await verifyServerPubKeyManager.getPublicKey() - try verifyJWTAgainstPubKey(attestationJWT, pubKey: verifyServerPubKey) - } catch { - let refreshedVerifyServerPubKey = try await verifyServerPubKeyManager.refreshKey() - try verifyJWTAgainstPubKey(attestationJWT, pubKey: refreshedVerifyServerPubKey) - } - - let claims = try decodeJWTClaims(jwtString: attestationJWT) - guard messageId == claims.id else { - throw Errors.messageIdMismatch - } - } - - func verifyJWTAgainstPubKey(_ jwtString: String, pubKey: String) throws { - let signingPubKey = try SigningPublicKey(hex: pubKey) - - let validator = JWTValidator(jwtString: jwtString) - guard try validator.isValid(publicKey: signingPubKey) else { - throw Errors.invalidJWT - } - } - - private func decodeJWTClaims(jwtString: String) throws -> AttestationJWTClaims { - let components = jwtString.components(separatedBy: ".") - - guard components.count == 3 else { throw Errors.invalidJWT } - - let payload = components[1] - guard let payloadData = Data(base64urlEncoded: payload) else { - throw Errors.invalidJWT - } - - let claims = try JSONDecoder().decode(AttestationJWTClaims.self, from: payloadData) - return claims - } -} - -struct AttestationJWTClaims: Codable { - - var exp: UInt64 - - var isScam: Bool? - - var id: String - - var origin: String -} - diff --git a/Sources/WalletConnectVerify/VerifyClientFactory.swift b/Sources/WalletConnectVerify/VerifyClientFactory.swift index 8b230fc5f..632173aa7 100644 --- a/Sources/WalletConnectVerify/VerifyClientFactory.swift +++ b/Sources/WalletConnectVerify/VerifyClientFactory.swift @@ -17,10 +17,15 @@ public class VerifyClientFactory { attestChallengeProvider: attestChallengeProvider, keyAttestationService: keyAttestationService ) + let verifyServerPubKeyManagerStore: CodableStore = CodableStore(defaults: keyValueStorage, identifier: "com.walletconnect.verify") + + let verifyServerPubKeyManager = VerifyServerPubKeyManager(store: verifyServerPubKeyManagerStore) + let attestationVerifier = AttestationJWTVerifier(verifyServerPubKeyManager: verifyServerPubKeyManager) return VerifyClient( originVerifier: originVerifier, assertionRegistrer: assertionRegistrer, - appAttestationRegistrer: appAttestationRegistrer + appAttestationRegistrer: appAttestationRegistrer, + attestationVerifier: attestationVerifier ) } } diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index c8acc994c..dac227ed4 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -1,11 +1,11 @@ import Foundation class VerifyServerPubKeyManager { - static let publicKeyStorageKey = "com.walletconnect.verify.pubKey" + static let publicKeyStorageKey = "verify_server_pub_key" private let store: CodableStore - private let fetcher: PublicKeyFetcher + private let fetcher: PublicKeyFetching - init(store: CodableStore, fetcher: PublicKeyFetcher) { + init(store: CodableStore, fetcher: PublicKeyFetching = PublicKeyFetcher()) { self.store = store self.fetcher = fetcher } From 601a01bd0dbc21a1ffe5641018a8bf5cdf45e3a1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jul 2024 18:05:58 +0900 Subject: [PATCH 680/814] savepoint --- .../NetworkInteracting.swift | 2 +- .../NetworkingInteractor.swift | 34 ++++++++++++------- .../RequestSubscriptionPayload.swift | 6 +++- .../PairingRequestsSubscriber.swift | 2 +- Sources/WalletConnectRelay/RelayClient.swift | 6 ++-- .../WalletConnectVerify/VerifyClient.swift | 14 +++----- .../VerifyServerPubKeyManager.swift | 15 ++++++++ 7 files changed, 52 insertions(+), 27 deletions(-) diff --git a/Sources/WalletConnectNetworking/NetworkInteracting.swift b/Sources/WalletConnectNetworking/NetworkInteracting.swift index e916c3f62..97d85b47c 100644 --- a/Sources/WalletConnectNetworking/NetworkInteracting.swift +++ b/Sources/WalletConnectNetworking/NetworkInteracting.swift @@ -5,7 +5,7 @@ public protocol NetworkInteracting { var isSocketConnected: Bool { get } var socketConnectionStatusPublisher: AnyPublisher { get } var networkConnectionStatusPublisher: AnyPublisher { get } - var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?), Never> { get } + var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?), Never> { get } func subscribe(topic: String) async throws func unsubscribe(topic: String) func batchSubscribe(topics: [String]) async throws diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index e7c8eb90d..3089b9e43 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -9,10 +9,10 @@ public class NetworkingInteractor: NetworkInteracting { private let rpcHistory: RPCHistory private let logger: ConsoleLogging - private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?), Never>() + private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?), Never>() private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() - public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?), Never> { + public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?), Never> { requestPublisherSubject.eraseToAnyPublisher() } @@ -51,8 +51,8 @@ public class NetworkingInteractor: NetworkInteracting { private func setupRelaySubscribtion() { relayClient.messagePublisher - .sink { [unowned self] (topic, message, publishedAt) in - manageSubscription(topic, message, publishedAt) + .sink { [unowned self] (topic, message, publishedAt, attestation) in + manageSubscription(topic, message, publishedAt, attestation) }.store(in: &publishers) } @@ -123,19 +123,29 @@ public class NetworkingInteractor: NetworkInteracting { }.store(in: &publishers) } + public func requestSubscription(on request: ProtocolMethod) -> AnyPublisher, Never> { return requestPublisher .filter { rpcRequest in return rpcRequest.request.method == request.method } - .compactMap { [weak self] topic, rpcRequest, decryptedPayload, publishedAt, derivedTopic in + .compactMap { [weak self] topic, rpcRequest, decryptedPayload, publishedAt, derivedTopic, encryptedMessage, attestation in do { guard let id = rpcRequest.id, let request = try rpcRequest.params?.get(RequestParams.self) else { return nil } - return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: decryptedPayload, publishedAt: publishedAt, derivedTopic: derivedTopic) + return RequestSubscriptionPayload( + id: id, + topic: topic, + request: request, + decryptedPayload: decryptedPayload, + publishedAt: publishedAt, + derivedTopic: derivedTopic, + encryptedMessage: encryptedMessage, + attestation: attestation + ) } catch { self?.logger.debug("Networking Interactor - \(error)") + return nil } - return nil } .eraseToAnyPublisher() } @@ -245,11 +255,11 @@ public class NetworkingInteractor: NetworkInteracting { try await respond(topic: topic, response: response, protocolMethod: protocolMethod, envelopeType: envelopeType) } - private func manageSubscription(_ topic: String, _ encodedEnvelope: String, _ publishedAt: Date) { + private func manageSubscription(_ topic: String, _ encodedEnvelope: String, _ publishedAt: Date, _ attestation: String?) { if let result = serializer.tryDeserializeRequestOrResponse(topic: topic, codingType: .base64Encoded, envelopeString: encodedEnvelope) { switch result { case .left(let result): - handleRequest(topic: topic, request: result.request, decryptedPayload: result.decryptedPayload, publishedAt: publishedAt, derivedTopic: result.derivedTopic) + handleRequest(topic: topic, request: result.request, decryptedPayload: result.decryptedPayload, publishedAt: publishedAt, derivedTopic: result.derivedTopic, encryptedMessage: encodedEnvelope, attestation: attestation) case .right(let result): handleResponse(topic: topic, response: result.response, publishedAt: publishedAt, derivedTopic: result.derivedTopic) } @@ -259,13 +269,13 @@ public class NetworkingInteractor: NetworkInteracting { } public func handleHistoryRequest(topic: String, request: RPCRequest) { - requestPublisherSubject.send((topic, request, Data(), Date(), nil)) + requestPublisherSubject.send((topic, request, Data(), Date(), nil, nil, nil )) } - private func handleRequest(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?) { + private func handleRequest(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?) { do { try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote, transportType: .relay) - requestPublisherSubject.send((topic, request, decryptedPayload, publishedAt, derivedTopic)) + requestPublisherSubject.send((topic, request, decryptedPayload, publishedAt, derivedTopic, encryptedMessage, attestation)) } catch { logger.debug(error) } diff --git a/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift b/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift index 135378a99..9ec16a154 100644 --- a/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift +++ b/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift @@ -2,18 +2,22 @@ import Foundation public struct RequestSubscriptionPayload: Codable, SubscriptionPayload { public let id: RPCID + public let encryptedMessage: String? + public let attestation: String? public let topic: String public let request: Request public let decryptedPayload: Data public let publishedAt: Date public let derivedTopic: String? - public init(id: RPCID, topic: String, request: Request, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?) { + public init(id: RPCID, topic: String, request: Request, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?) { self.id = id self.topic = topic self.request = request self.decryptedPayload = decryptedPayload self.publishedAt = publishedAt self.derivedTopic = derivedTopic + self.encryptedMessage = encryptedMessage + self.attestation = attestation } } diff --git a/Sources/WalletConnectPairing/PairingRequestsSubscriber.swift b/Sources/WalletConnectPairing/PairingRequestsSubscriber.swift index c3327e482..089eed549 100644 --- a/Sources/WalletConnectPairing/PairingRequestsSubscriber.swift +++ b/Sources/WalletConnectPairing/PairingRequestsSubscriber.swift @@ -28,7 +28,7 @@ public class PairingRequestsSubscriber { .filter { [unowned self] in !pairingProtocolMethods.contains($0.request.method)} .filter { [unowned self] in pairingStorage.hasPairing(forTopic: $0.topic)} .filter { [unowned self] in !registeredProtocolMethods.contains($0.request.method)} - .sink { [unowned self] topic, request, _, _, _ in + .sink { [unowned self] topic, request, _, _, _, _, _ in Task(priority: .high) { let protocolMethod = UnsupportedProtocolMethod(method: request.method) logger.debug("PairingRequestsSubscriber: responding unregistered request method") diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 93b33f1c7..f51f69c84 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -26,7 +26,7 @@ public final class RelayClient { return dispatcher.isSocketConnected } - public var messagePublisher: AnyPublisher<(topic: String, message: String, publishedAt: Date), Never> { + public var messagePublisher: AnyPublisher<(topic: String, message: String, publishedAt: Date, attestation: String?), Never> { messagePublisherSubject.eraseToAnyPublisher() } @@ -38,7 +38,7 @@ public final class RelayClient { dispatcher.networkConnectionStatusPublisher } - private let messagePublisherSubject = PassthroughSubject<(topic: String, message: String, publishedAt: Date), Never>() + private let messagePublisherSubject = PassthroughSubject<(topic: String, message: String, publishedAt: Date, attestation: String?), Never>() private let subscriptionResponsePublisherSubject = PassthroughSubject<(RPCID?, [String]), Never>() private var subscriptionResponsePublisher: AnyPublisher<(RPCID?, [String]), Never> { @@ -238,7 +238,7 @@ public final class RelayClient { try acknowledgeRequest(request) try rpcHistory.set(request, forTopic: params.data.topic, emmitedBy: .remote, transportType: .relay) logger.debug("received message: \(params.data.message) on topic: \(params.data.topic)") - messagePublisherSubject.send((params.data.topic, params.data.message, params.data.publishedAt)) + messagePublisherSubject.send((params.data.topic, params.data.message, params.data.publishedAt, params.data.attestation)) } catch { logger.error("RPC History 'set()' error: \(error)") } diff --git a/Sources/WalletConnectVerify/VerifyClient.swift b/Sources/WalletConnectVerify/VerifyClient.swift index 4905f1fc2..0d56ad089 100644 --- a/Sources/WalletConnectVerify/VerifyClient.swift +++ b/Sources/WalletConnectVerify/VerifyClient.swift @@ -2,7 +2,7 @@ import DeviceCheck import Foundation public protocol VerifyClientProtocol { - func verifyOrigin(assertionId: String) async throws -> VerifyResponse + func verify(_ verificationType: VerificationType) async throws -> VerifyResponse func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext } @@ -41,17 +41,13 @@ public actor VerifyClient: VerifyClientProtocol { try await appAttestationRegistrer.registerAttestationIfNeeded() } - public func verifyOrigin(assertionId: String) async throws -> VerifyResponse { - return try await originVerifier.verifyOrigin(assertionId: assertionId) - } - /// Verify V2 attestation JWT /// messageId - hash of the encrypted message supplied in the request /// assertionId - hash of decrytped message public func verify(_ verificationType: VerificationType) async throws -> VerifyResponse { switch verificationType { case .v1(let assertionId): - return try await verifyOrigin(assertionId: assertionId) + return try await originVerifier.verifyOrigin(assertionId: assertionId) case .v2(let attestationJWT, let messageId): return try await attestationVerifier.verify(attestationJWT: attestationJWT, messageId: messageId) } @@ -75,11 +71,11 @@ public actor VerifyClient: VerifyClientProtocol { public struct VerifyClientMock: VerifyClientProtocol { public init() {} - - public func verifyOrigin(assertionId: String) async throws -> VerifyResponse { + + public func verify(_ verificationType: VerificationType) async throws -> VerifyResponse { return VerifyResponse(origin: "domain.com", isScam: nil) } - + public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { return VerifyContext(origin: "domain.com", validation: .valid) } diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index dac227ed4..e91217b48 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -8,6 +8,21 @@ class VerifyServerPubKeyManager { init(store: CodableStore, fetcher: PublicKeyFetching = PublicKeyFetcher()) { self.store = store self.fetcher = fetcher + + // Check if there is a cached, non-expired key on initialization + Task { + do { + if let localKey = try getPublicKeyFromLocalStorage(), !isKeyExpired(localKey) { + // Key is valid, no action needed + } else { + // No valid key, fetch and store a new one + let serverKey = try await fetcher.fetchPublicKey() + savePublicKeyToLocalStorage(publicKey: serverKey) + } + } catch { + print("Failed to initialize public key: \(error)") + } + } } func getPublicKey() async throws -> String { From e98962bba214f38fe866e98463f3eeaace075543 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jul 2024 18:32:44 +0900 Subject: [PATCH 681/814] savepoint --- .../WalletConnectNetworking/NetworkInteracting.swift | 2 +- .../WalletConnectNetworking/NetworkingInteractor.swift | 8 ++++---- .../RequestSubscriptionPayload.swift | 4 ++-- .../Auth/Link/LinkEnvelopesDispatcher.swift | 2 +- .../Engine/Common/SessionEngine.swift | 10 ++++++++-- 5 files changed, 16 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectNetworking/NetworkInteracting.swift b/Sources/WalletConnectNetworking/NetworkInteracting.swift index 97d85b47c..bfef71546 100644 --- a/Sources/WalletConnectNetworking/NetworkInteracting.swift +++ b/Sources/WalletConnectNetworking/NetworkInteracting.swift @@ -5,7 +5,7 @@ public protocol NetworkInteracting { var isSocketConnected: Bool { get } var socketConnectionStatusPublisher: AnyPublisher { get } var networkConnectionStatusPublisher: AnyPublisher { get } - var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?), Never> { get } + var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?), Never> { get } func subscribe(topic: String) async throws func unsubscribe(topic: String) func batchSubscribe(topics: [String]) async throws diff --git a/Sources/WalletConnectNetworking/NetworkingInteractor.swift b/Sources/WalletConnectNetworking/NetworkingInteractor.swift index 3089b9e43..5b106cdb8 100644 --- a/Sources/WalletConnectNetworking/NetworkingInteractor.swift +++ b/Sources/WalletConnectNetworking/NetworkingInteractor.swift @@ -9,10 +9,10 @@ public class NetworkingInteractor: NetworkInteracting { private let rpcHistory: RPCHistory private let logger: ConsoleLogging - private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?), Never>() + private let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?), Never>() private let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() - public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?), Never> { + public var requestPublisher: AnyPublisher<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?), Never> { requestPublisherSubject.eraseToAnyPublisher() } @@ -269,10 +269,10 @@ public class NetworkingInteractor: NetworkInteracting { } public func handleHistoryRequest(topic: String, request: RPCRequest) { - requestPublisherSubject.send((topic, request, Data(), Date(), nil, nil, nil )) + requestPublisherSubject.send((topic, request, Data(), Date(), nil, "", nil )) } - private func handleRequest(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?) { + private func handleRequest(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?) { do { try rpcHistory.set(request, forTopic: topic, emmitedBy: .remote, transportType: .relay) requestPublisherSubject.send((topic, request, decryptedPayload, publishedAt, derivedTopic, encryptedMessage, attestation)) diff --git a/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift b/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift index 9ec16a154..9a532441b 100644 --- a/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift +++ b/Sources/WalletConnectNetworking/RequestSubscriptionPayload.swift @@ -2,7 +2,7 @@ import Foundation public struct RequestSubscriptionPayload: Codable, SubscriptionPayload { public let id: RPCID - public let encryptedMessage: String? + public let encryptedMessage: String public let attestation: String? public let topic: String public let request: Request @@ -10,7 +10,7 @@ public struct RequestSubscriptionPayload: Codable, Subscriptio public let publishedAt: Date public let derivedTopic: String? - public init(id: RPCID, topic: String, request: Request, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String?, attestation: String?) { + public init(id: RPCID, topic: String, request: Request, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?) { self.id = id self.topic = topic self.request = request diff --git a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift index 2ac026b5a..987a8aae8 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkEnvelopesDispatcher.swift @@ -152,7 +152,7 @@ final class LinkEnvelopesDispatcher { guard let id = rpcRequest.id, let request = try rpcRequest.params?.get(RequestParams.self) else { return nil } - return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil) + return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil, encryptedMessage: "", attestation: nil) } catch { self?.logger.debug(error) } diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 2933da364..97902c4ee 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -215,9 +215,15 @@ private extension SessionEngine { return respondError(payload: payload, reason: .sessionRequestExpired, protocolMethod: protocolMethod) } Task(priority: .high) { - let assertionId = payload.decryptedPayload.sha256().toHexString() do { - let response = try await verifyClient.verifyOrigin(assertionId: assertionId) + let response: VerifyResponse + if let attestation = payload.attestation, + let messageId = payload.encryptedMessage.data(using: .utf8)?.sha256().toHexString() { + response = try await verifyClient.verify(.v2(attestationJWT: attestation, messageId: messageId)) + } else { + let assertionId = payload.decryptedPayload.sha256().toHexString() + response = try await verifyClient.verify(.v1(assertionId: assertionId)) + } let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: session.peerParticipant.metadata.url, isScam: response.isScam) verifyContextStore.set(verifyContext, forKey: request.id.string) From dffbf647e4788be06da029a39ed7f9bc976dac84 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jul 2024 18:36:19 +0900 Subject: [PATCH 682/814] update verify on auth request --- .../Auth/Services/Wallet/AuthRequestSubscriber.swift | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index a4389ee9f..53ccbe790 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -56,7 +56,14 @@ class AuthRequestSubscriber { Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() do { - let response = try await verifyClient.verifyOrigin(assertionId: assertionId) + let response: VerifyResponse + if let attestation = payload.attestation, + let messageId = payload.encryptedMessage.data(using: .utf8)?.sha256().toHexString() { + response = try await verifyClient.verify(.v2(attestationJWT: attestation, messageId: messageId)) + } else { + let assertionId = payload.decryptedPayload.sha256().toHexString() + response = try await verifyClient.verify(.v1(assertionId: assertionId)) + } let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.authPayload.domain, isScam: response.isScam) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) From 66104b1a060afa5ecb8d9577435d6248a8e8073c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 22 Jul 2024 18:40:50 +0900 Subject: [PATCH 683/814] savepoint --- .../WalletConnectSign/Engine/Common/ApproveEngine.swift | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index cd127d81a..def3ed993 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -397,7 +397,14 @@ private extension ApproveEngine { Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() do { - let response = try await verifyClient.verifyOrigin(assertionId: assertionId) + let response: VerifyResponse + if let attestation = payload.attestation, + let messageId = payload.encryptedMessage.data(using: .utf8)?.sha256().toHexString() { + response = try await verifyClient.verify(.v2(attestationJWT: attestation, messageId: messageId)) + } else { + let assertionId = payload.decryptedPayload.sha256().toHexString() + response = try await verifyClient.verify(.v1(assertionId: assertionId)) + } let verifyContext = verifyClient.createVerifyContext( origin: response.origin, domain: payload.request.proposer.metadata.url, From 47ac891b9e1b89499800f910fc763e3b0beeff90 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jul 2024 20:55:54 +0900 Subject: [PATCH 684/814] upgrade w3m --- Example/ExampleApp.xcodeproj/project.pbxproj | 4 ++-- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index cf70d6ce0..67c128fcf 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3295,8 +3295,8 @@ isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { - kind = revision; - revision = 25abd7e5471f21d662400f9763948fbf97c60c97; + kind = upToNextMajorVersion; + minimumVersion = 1.0.0; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 53859947e..0ceb0bd52 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "25abd7e5471f21d662400f9763948fbf97c60c97", - "version": null + "revision": "d35349cdc4eb11286cd7bf05df940971a591fbc1", + "version": "1.5.1" } } ] From 37ad1e81cce4e7a1c9e1bc97b8548e2870ccd15d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 23 Jul 2024 20:57:30 +0900 Subject: [PATCH 685/814] savepoint --- .../project.xcworkspace/xcshareddata/swiftpm/Package.resolved | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 0ceb0bd52..53859947e 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "d35349cdc4eb11286cd7bf05df940971a591fbc1", - "version": "1.5.1" + "revision": "25abd7e5471f21d662400f9763948fbf97c60c97", + "version": null } } ] From f23fc74f0b0aecb4eb2b89fb7ffcb8ab0665a06b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jul 2024 14:31:21 +0900 Subject: [PATCH 686/814] store verify context in session object --- .../Link/ApproveSessionAuthenticateUtil.swift | 6 +++-- .../LinkSessionAuthenticateResponder.swift | 14 ++++++++--- .../Services/App/AuthResponseSubscriber.swift | 3 ++- .../Wallet/SessionAuthenticateResponder.swift | 4 +++- .../Engine/Common/ApproveEngine.swift | 8 +++++-- .../Engine/Common/SessionEngine.swift | 23 +++---------------- .../Sign/SignClientFactory.swift | 2 +- .../Types/Session/WCSession.swift | 13 ++++++++--- 8 files changed, 40 insertions(+), 33 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index c69461c8a..78e4e9b06 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -66,7 +66,8 @@ class ApproveSessionAuthenticateUtil { pairingTopic: String, request: SessionAuthenticateRequestParams, sessionTopic: String, - transportType: WCSession.TransportType + transportType: WCSession.TransportType, + verifyContext: VerifyContext ) throws -> Session? { @@ -101,7 +102,8 @@ class ApproveSessionAuthenticateUtil { settleParams: settleParams, requiredNamespaces: [:], acknowledged: true, - transportType: transportType + transportType: transportType, + verifyContext: verifyContext ) logger.debug("created a session with topic: \(sessionTopic)") diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index e6116d4ef..b176dd1aa 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -11,6 +11,7 @@ actor LinkSessionAuthenticateResponder { private let metadata: AppMetadata private let util: ApproveSessionAuthenticateUtil private let walletErrorResponder: WalletErrorResponder + private let verifyContextStore: CodableStore init( linkEnvelopesDispatcher: LinkEnvelopesDispatcher, @@ -18,10 +19,12 @@ actor LinkSessionAuthenticateResponder { kms: KeyManagementService, metadata: AppMetadata, approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, - walletErrorResponder: WalletErrorResponder + walletErrorResponder: WalletErrorResponder, + verifyContextStore: CodableStore ) { self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.logger = logger + self.verifyContextStore = verifyContextStore self.kms = kms self.metadata = metadata self.util = approveSessionAuthenticateUtil @@ -57,20 +60,25 @@ actor LinkSessionAuthenticateResponder { let url = try await linkEnvelopesDispatcher.respond(topic: responseTopic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) + let verifyContext = (try? verifyContextStore.get(key: requestId.string)) ?? VerifyContext(origin: nil, validation: .unknown) let session = try util.createSession( response: responseParams, pairingTopic: pairingTopic, request: sessionAuthenticateRequestParams, sessionTopic: sessionTopic, - transportType: .linkMode + transportType: .linkMode, + verifyContext: verifyContext ) + verifyContextStore.delete(forKey: requestId.string) + return (session, url) } func respondError(requestId: RPCID) async throws { - try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + _ = try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + verifyContextStore.delete(forKey: requestId.string) } } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 03f0456be..602827661 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -200,7 +200,8 @@ class AuthResponseSubscriber { settleParams: settleParams, requiredNamespaces: [:], acknowledged: true, - transportType: transportType + transportType: transportType, + verifyContext: nil ) sessionStore.setSession(session) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index dea7e0e9e..825225c0e 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -120,12 +120,14 @@ actor SessionAuthenticateResponder { } do { + let verifyContext = (try? verifyContextStore.get(key: requestId.string)) ?? VerifyContext(origin: nil, validation: .unknown) let session = try util.createSession( response: responseParams, pairingTopic: pairingTopic, request: sessionAuthenticateRequestParams, sessionTopic: sessionTopic, - transportType: .relay + transportType: .relay, + verifyContext: verifyContext ) pairingRegisterer.activate( pairingTopic: pairingTopic, diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index def3ed993..a94cae925 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -226,6 +226,8 @@ final class ApproveEngine { expiry: Int64(expiry) ) + let verifyContext = (try? verifyContextStore.get(key: proposal.proposer.publicKey)) ?? VerifyContext(origin: nil, validation: .unknown) + let session = WCSession( topic: topic, pairingTopic: pairingTopic, @@ -235,7 +237,8 @@ final class ApproveEngine { settleParams: settleParams, requiredNamespaces: proposal.requiredNamespaces, acknowledged: false, - transportType: .relay + transportType: .relay, + verifyContext: verifyContext ) logger.debug("Sending session settle request") @@ -467,7 +470,8 @@ private extension ApproveEngine { settleParams: params, requiredNamespaces: proposedNamespaces, acknowledged: true, - transportType: .relay + transportType: .relay, + verifyContext: nil ) sessionStore.setSession(session) diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 97902c4ee..40997cde9 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -214,26 +214,9 @@ private extension SessionEngine { guard !request.isExpired() else { return respondError(payload: payload, reason: .sessionRequestExpired, protocolMethod: protocolMethod) } - Task(priority: .high) { - do { - let response: VerifyResponse - if let attestation = payload.attestation, - let messageId = payload.encryptedMessage.data(using: .utf8)?.sha256().toHexString() { - response = try await verifyClient.verify(.v2(attestationJWT: attestation, messageId: messageId)) - } else { - let assertionId = payload.decryptedPayload.sha256().toHexString() - response = try await verifyClient.verify(.v1(assertionId: assertionId)) - } - let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: session.peerParticipant.metadata.url, isScam: response.isScam) - verifyContextStore.set(verifyContext, forKey: request.id.string) - - sessionRequestsProvider.emitRequestIfPending() - } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: session.peerParticipant.metadata.url, isScam: nil) - verifyContextStore.set(verifyContext, forKey: request.id.string) - sessionRequestsProvider.emitRequestIfPending() - } - } + let verifyContext = session.verifyContext ?? VerifyContext(origin: nil, validation: .unknown) + verifyContextStore.set(verifyContext, forKey: request.id.string) + sessionRequestsProvider.emitRequestIfPending() } func onSessionPing(payload: SubscriptionPayload) { diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 6a9989112..caebc0840 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -131,7 +131,7 @@ public struct SignClientFactory { let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, eventsClient: eventsClient) - let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder) + let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder, verifyContextStore: verifyContextStore) let approveSessionAuthenticateDispatcher = ApproveSessionAuthenticateDispatcher(relaySessionAuthenticateResponder: relaySessionAuthenticateResponder, logger: logger, rpcHistory: rpcHistory, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, linkSessionAuthenticateResponder: linkSessionAuthenticateResponder) diff --git a/Sources/WalletConnectSign/Types/Session/WCSession.swift b/Sources/WalletConnectSign/Types/Session/WCSession.swift index c5224bb00..3e40af9b2 100644 --- a/Sources/WalletConnectSign/Types/Session/WCSession.swift +++ b/Sources/WalletConnectSign/Types/Session/WCSession.swift @@ -17,6 +17,7 @@ struct WCSession: SequenceObject, Equatable { let peerParticipant: Participant let controller: AgreementPeer var transportType: TransportType + var verifyContext: VerifyContext? private(set) var acknowledged: Bool private(set) var expiryDate: Date @@ -41,7 +42,8 @@ struct WCSession: SequenceObject, Equatable { settleParams: SessionType.SettleParams, requiredNamespaces: [String: ProposalNamespace], acknowledged: Bool, - transportType: TransportType + transportType: TransportType, + verifyContext: VerifyContext? ) { self.topic = topic self.pairingTopic = pairingTopic @@ -56,6 +58,7 @@ struct WCSession: SequenceObject, Equatable { self.acknowledged = acknowledged self.expiryDate = Date(timeIntervalSince1970: TimeInterval(settleParams.expiry)) self.transportType = transportType + self.verifyContext = verifyContext } #if DEBUG @@ -74,7 +77,8 @@ struct WCSession: SequenceObject, Equatable { accounts: Set, acknowledged: Bool, expiryTimestamp: Int64, - transportType: TransportType + transportType: TransportType, + verifyContext: VerifyContext ) { self.topic = topic self.pairingTopic = pairingTopic @@ -89,6 +93,7 @@ struct WCSession: SequenceObject, Equatable { self.acknowledged = acknowledged self.expiryDate = Date(timeIntervalSince1970: TimeInterval(expiryTimestamp)) self.transportType = transportType + self.verifyContext = verifyContext } #endif @@ -192,7 +197,7 @@ struct WCSession: SequenceObject, Equatable { extension WCSession { enum CodingKeys: String, CodingKey { - case topic, pairingTopic, relay, selfParticipant, peerParticipant, expiryDate, acknowledged, controller, namespaces, timestamp, requiredNamespaces, sessionProperties, transportType + case topic, pairingTopic, relay, selfParticipant, peerParticipant, expiryDate, acknowledged, controller, namespaces, timestamp, requiredNamespaces, sessionProperties, transportType, verifyContext } init(from decoder: Decoder) throws { @@ -210,6 +215,7 @@ extension WCSession { self.requiredNamespaces = try container.decode([String: ProposalNamespace].self, forKey: .requiredNamespaces) self.pairingTopic = try container.decode(String.self, forKey: .pairingTopic) self.transportType = (try? container.decode(TransportType.self, forKey: .transportType)) ?? .relay + self.verifyContext = try? container.decode(VerifyContext.self, forKey: .verifyContext) } func encode(to encoder: Encoder) throws { @@ -227,5 +233,6 @@ extension WCSession { try container.encode(timestamp, forKey: .timestamp) try container.encode(requiredNamespaces, forKey: .requiredNamespaces) try container.encode(transportType, forKey: .transportType) + try container.encode(verifyContext, forKey: .verifyContext) } } From 9814f9551de3d0e9d9fce437b594284bef8dac38 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jul 2024 15:06:34 +0900 Subject: [PATCH 687/814] fix tests --- .../Wallet/WalletRequestSubscriber.swift | 2 +- .../WalletConnectVerify/PublicKeyFetcher.swift | 14 +++++++------- .../VerifyClientFactory.swift | 2 +- .../VerifyServerPubKeyManager.swift | 10 +++++----- Tests/RelayerTests/RelayClientTests.swift | 6 +++--- .../TestingUtils/NetworkingInteractorMock.swift | 8 ++++---- .../VerifyServerPubKeyManagerTests.swift | 16 +++++++++------- .../ApproveEngineTests.swift | 16 ++++++++-------- .../NonControllerSessionStateMachineTests.swift | 12 ++++++------ .../SessionEngineTests.swift | 2 +- .../Stub/Session+Stub.swift | 3 ++- 11 files changed, 47 insertions(+), 44 deletions(-) diff --git a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift index 7270871d7..f460252ce 100644 --- a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift @@ -44,7 +44,7 @@ class WalletRequestSubscriber { Task(priority: .high) { let assertionId = payload.decryptedPayload.sha256().toHexString() do { - let response = try await verifyClient.verifyOrigin(assertionId: assertionId) + let response = try await verifyClient.verify(.v1(assertionId: assertionId)) let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.payloadParams.domain, isScam: response.isScam) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) diff --git a/Sources/WalletConnectVerify/PublicKeyFetcher.swift b/Sources/WalletConnectVerify/PublicKeyFetcher.swift index 517761f15..fdd5caa72 100644 --- a/Sources/WalletConnectVerify/PublicKeyFetcher.swift +++ b/Sources/WalletConnectVerify/PublicKeyFetcher.swift @@ -2,13 +2,13 @@ import Foundation // PublicKeyFetcher class protocol PublicKeyFetching { - func fetchPublicKey() async throws -> PublicKeyFetcher.VerifyServerPublicKey + func fetchPublicKey() async throws -> VerifyServerPublicKey +} +struct VerifyServerPublicKey: Codable { + let publicKey: String + let expiresAt: TimeInterval } class PublicKeyFetcher: PublicKeyFetching { - struct VerifyServerPublicKey: Codable { - let publicKey: String - let expiresAt: TimeInterval - } private let urlString = "https://verify.walletconnect.org/v2/public-key" @@ -25,10 +25,10 @@ class PublicKeyFetcher: PublicKeyFetching { #if DEBUG class MockPublicKeyFetcher: PublicKeyFetching { - var publicKey: PublicKeyFetcher.VerifyServerPublicKey? + var publicKey: VerifyServerPublicKey? var error: Error? - func fetchPublicKey() async throws -> PublicKeyFetcher.VerifyServerPublicKey { + func fetchPublicKey() async throws -> VerifyServerPublicKey { if let error = error { throw error } diff --git a/Sources/WalletConnectVerify/VerifyClientFactory.swift b/Sources/WalletConnectVerify/VerifyClientFactory.swift index 632173aa7..a0fe4fbb6 100644 --- a/Sources/WalletConnectVerify/VerifyClientFactory.swift +++ b/Sources/WalletConnectVerify/VerifyClientFactory.swift @@ -17,7 +17,7 @@ public class VerifyClientFactory { attestChallengeProvider: attestChallengeProvider, keyAttestationService: keyAttestationService ) - let verifyServerPubKeyManagerStore: CodableStore = CodableStore(defaults: keyValueStorage, identifier: "com.walletconnect.verify") + let verifyServerPubKeyManagerStore: CodableStore = CodableStore(defaults: keyValueStorage, identifier: "com.walletconnect.verify") let verifyServerPubKeyManager = VerifyServerPubKeyManager(store: verifyServerPubKeyManagerStore) let attestationVerifier = AttestationJWTVerifier(verifyServerPubKeyManager: verifyServerPubKeyManager) diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index e91217b48..f72cd5419 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -2,10 +2,10 @@ import Foundation class VerifyServerPubKeyManager { static let publicKeyStorageKey = "verify_server_pub_key" - private let store: CodableStore + private let store: CodableStore private let fetcher: PublicKeyFetching - init(store: CodableStore, fetcher: PublicKeyFetching = PublicKeyFetcher()) { + init(store: CodableStore, fetcher: PublicKeyFetching = PublicKeyFetcher()) { self.store = store self.fetcher = fetcher @@ -41,16 +41,16 @@ class VerifyServerPubKeyManager { return serverKey.publicKey } - private func getPublicKeyFromLocalStorage() throws -> PublicKeyFetcher.VerifyServerPublicKey? { + private func getPublicKeyFromLocalStorage() throws -> VerifyServerPublicKey? { return try store.get(key: Self.publicKeyStorageKey) } - private func isKeyExpired(_ key: PublicKeyFetcher.VerifyServerPublicKey) -> Bool { + private func isKeyExpired(_ key: VerifyServerPublicKey) -> Bool { let currentTime = Date().timeIntervalSince1970 return currentTime >= key.expiresAt } - private func savePublicKeyToLocalStorage(publicKey: PublicKeyFetcher.VerifyServerPublicKey) { + private func savePublicKeyToLocalStorage(publicKey: VerifyServerPublicKey) { store.set(publicKey, forKey: Self.publicKeyStorageKey) } } diff --git a/Tests/RelayerTests/RelayClientTests.swift b/Tests/RelayerTests/RelayClientTests.swift index 6442757cb..d767623e4 100644 --- a/Tests/RelayerTests/RelayClientTests.swift +++ b/Tests/RelayerTests/RelayClientTests.swift @@ -29,10 +29,10 @@ final class RelayClientTests: XCTestCase { let topic = "0987" let message = "qwerty" let subscriptionId = "sub-id" - let subscription = Subscription(id: subscriptionId, topic: topic, message: message) + let subscription = Subscription(id: subscriptionId, topic: topic, message: message, attestation: nil) let request = subscription.asRPCRequest() - sut.messagePublisher.sink { (subscriptionTopic, subscriptionMessage, _) in + sut.messagePublisher.sink { (subscriptionTopic, subscriptionMessage, _, _) in XCTAssertEqual(subscriptionMessage, message) XCTAssertEqual(subscriptionTopic, topic) expectation.fulfill() @@ -62,7 +62,7 @@ final class RelayClientTests: XCTestCase { let expectation = expectation(description: "Duplicate Subscription requests must notify only the first time") let request = Subscription.init(id: "sub_id", topic: "topic", message: "message").asRPCRequest() - sut.messagePublisher.sink { (_, _, _) in + sut.messagePublisher.sink { (_, _, _, _) in expectation.fulfill() }.store(in: &publishers) diff --git a/Tests/TestingUtils/NetworkingInteractorMock.swift b/Tests/TestingUtils/NetworkingInteractorMock.swift index 65b73ab0c..c08cde49c 100644 --- a/Tests/TestingUtils/NetworkingInteractorMock.swift +++ b/Tests/TestingUtils/NetworkingInteractorMock.swift @@ -40,10 +40,10 @@ public class NetworkingInteractorMock: NetworkInteracting { networkConnectionStatusPublisherSubject.eraseToAnyPublisher() } - public let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?), Never>() + public let requestPublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?), Never>() public let responsePublisherSubject = PassthroughSubject<(topic: String, request: RPCRequest, response: RPCResponse, publishedAt: Date, derivedTopic: String?), Never>() - public var requestPublisher: AnyPublisher<(topic: String, request: JSONRPC.RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?), Never> { + public var requestPublisher: AnyPublisher<(topic: String, request: JSONRPC.RPCRequest, decryptedPayload: Data, publishedAt: Date, derivedTopic: String?, encryptedMessage: String, attestation: String?), Never> { requestPublisherSubject.eraseToAnyPublisher() } @@ -63,9 +63,9 @@ public class NetworkingInteractorMock: NetworkInteracting { .filter { rpcRequest in return rpcRequest.request.method == request.method } - .compactMap { topic, rpcRequest, decryptedPayload, publishedAt, derivedTopic in + .compactMap { topic, rpcRequest, decryptedPayload, publishedAt, derivedTopic, encryptedMessage, attestation in guard let id = rpcRequest.id, let request = try? rpcRequest.params?.get(Request.self) else { return nil } - return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: decryptedPayload, publishedAt: publishedAt, derivedTopic: derivedTopic) + return RequestSubscriptionPayload(id: id, topic: topic, request: request, decryptedPayload: decryptedPayload, publishedAt: publishedAt, derivedTopic: derivedTopic, encryptedMessage: encryptedMessage, attestation: attestation) } .eraseToAnyPublisher() } diff --git a/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift b/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift index 8fd843fae..913f23994 100644 --- a/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift +++ b/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift @@ -4,21 +4,21 @@ import XCTest class VerifyServerPubKeyManagerTests: XCTestCase { var manager: VerifyServerPubKeyManager! - var store: CodableStore! + var store: CodableStore! var fetcher: MockPublicKeyFetcher! override func setUp() { super.setUp() let storage = RuntimeKeyValueStorage() - store = CodableStore(defaults: storage, identifier: "test") + store = CodableStore(defaults: storage, identifier: "test") fetcher = MockPublicKeyFetcher() - manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) } func testGetPublicKeyFromServer() async throws { let expectedPublicKey = "test_public_key" let expiresAt = Date().timeIntervalSince1970 + 3600 // 1 hour from now - fetcher.publicKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + fetcher.publicKey = VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) let publicKey = try await manager.getPublicKey() @@ -28,8 +28,9 @@ class VerifyServerPubKeyManagerTests: XCTestCase { func testGetPublicKeyFromLocalStorage() async throws { let expectedPublicKey = "test_public_key" let expiresAt = Date().timeIntervalSince1970 + 3600 // 1 hour from now - let storedKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + let storedKey = VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) store.set(storedKey, forKey: VerifyServerPubKeyManager.publicKeyStorageKey) + manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) let publicKey = try await manager.getPublicKey() @@ -40,10 +41,11 @@ class VerifyServerPubKeyManagerTests: XCTestCase { let expectedPublicKey = "test_public_key" let newTestPubKey = "new_test_public_key" let expiresAt = Date().timeIntervalSince1970 - 3600 // 1 hour ago - let storedKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + let storedKey = VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) store.set(storedKey, forKey: VerifyServerPubKeyManager.publicKeyStorageKey) - fetcher.publicKey = PublicKeyFetcher.VerifyServerPublicKey(publicKey: newTestPubKey, expiresAt: Date().timeIntervalSince1970 + 3600) + fetcher.publicKey = VerifyServerPublicKey(publicKey: newTestPubKey, expiresAt: Date().timeIntervalSince1970 + 3600) + manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) let publicKey = try await manager.getPublicKey() diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index 79b2f7996..1d36d7902 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -73,8 +73,8 @@ final class ApproveEngineTests: XCTestCase { pairingStorageMock.setPairing(pairing) let proposerPubKey = AgreementPrivateKey().publicKey.hexRepresentation let proposal = SessionProposal.stub(proposerPubKey: proposerPubKey) - pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil)) - + pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil, encryptedMessage: "", attestation: nil)) + _ = try await engine.approveProposal(proposerPubKey: proposal.proposer.publicKey, validating: SessionNamespace.stubDictionary()) let topicB = networkingInteractor.subscriptions.last! @@ -98,7 +98,7 @@ final class ApproveEngineTests: XCTestCase { sessionProposed = true } - pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil)) + pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil, encryptedMessage: "", attestation: nil)) XCTAssertNotNil(try! proposalPayloadsStore.get(key: proposal.proposer.publicKey), "Proposer must store proposal payload") XCTAssertTrue(sessionProposed) } @@ -121,7 +121,7 @@ final class ApproveEngineTests: XCTestCase { didCallBackOnSessionApproved = true } sessionTopicToProposal.set(SessionProposal.stub().publicRepresentation(pairingTopic: ""), forKey: sessionTopic) - networkingInteractor.requestPublisherSubject.send((sessionTopic, RPCRequest.stubSettle(), Data(), Date(), "")) + networkingInteractor.requestPublisherSubject.send((sessionTopic, RPCRequest.stubSettle(), Data(), Date(), "", "", nil)) usleep(100) @@ -172,7 +172,7 @@ final class ApproveEngineTests: XCTestCase { engine.onSessionProposal = { _, _ in proposalReceivedExpectation.fulfill() } - pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil)) + pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil, encryptedMessage: "", attestation: nil)) wait(for: [proposalReceivedExpectation], timeout: 0.1) @@ -191,8 +191,8 @@ final class ApproveEngineTests: XCTestCase { engine.onSessionProposal = { _, _ in proposalReceivedExpectation.fulfill() } - pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil)) - + pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil, encryptedMessage: "", attestation: nil)) + wait(for: [proposalReceivedExpectation], timeout: 0.1) XCTAssertTrue(verifyContextStore.getAll().count == 1) @@ -214,7 +214,7 @@ final class ApproveEngineTests: XCTestCase { engine.onSessionProposal = { _, _ in proposalReceivedExpectation.fulfill() } - pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil)) + pairingRegisterer.subject.send(RequestSubscriptionPayload(id: RPCID("id"), topic: topicA, request: proposal, decryptedPayload: Data(), publishedAt: Date(), derivedTopic: nil, encryptedMessage: "", attestation: nil)) wait(for: [proposalReceivedExpectation], timeout: 0.1) diff --git a/Tests/WalletConnectSignTests/NonControllerSessionStateMachineTests.swift b/Tests/WalletConnectSignTests/NonControllerSessionStateMachineTests.swift index 7304ea2c8..5f9007b37 100644 --- a/Tests/WalletConnectSignTests/NonControllerSessionStateMachineTests.swift +++ b/Tests/WalletConnectSignTests/NonControllerSessionStateMachineTests.swift @@ -35,7 +35,7 @@ class NonControllerSessionStateMachineTests: XCTestCase { didCallbackUpdatMethods = true XCTAssertEqual(topic, session.topic) } - networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateNamespaces(), Data(), Date(), nil)) + networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateNamespaces(), Data(), Date(), nil, "", nil)) XCTAssertTrue(didCallbackUpdatMethods) usleep(100) XCTAssertTrue(networkingInteractor.didRespondSuccess) @@ -51,7 +51,7 @@ class NonControllerSessionStateMachineTests: XCTestCase { // } func testUpdateMethodPeerErrorSessionNotFound() { - networkingInteractor.requestPublisherSubject.send(("", RPCRequest.stubUpdateNamespaces(), Data(), Date(), nil)) + networkingInteractor.requestPublisherSubject.send(("", RPCRequest.stubUpdateNamespaces(), Data(), Date(), nil, "", nil)) usleep(100) XCTAssertFalse(networkingInteractor.didRespondSuccess) XCTAssertEqual(networkingInteractor.lastErrorCode, 7001) @@ -60,7 +60,7 @@ class NonControllerSessionStateMachineTests: XCTestCase { func testUpdateMethodPeerErrorUnauthorized() { let session = WCSession.stub(isSelfController: true) // Peer is not a controller storageMock.setSession(session) - networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateNamespaces(), Data(), Date(), nil)) + networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateNamespaces(), Data(), Date(), nil, "", nil)) usleep(100) XCTAssertFalse(networkingInteractor.didRespondSuccess) XCTAssertEqual(networkingInteractor.lastErrorCode, 3003) @@ -73,7 +73,7 @@ class NonControllerSessionStateMachineTests: XCTestCase { storageMock.setSession(session) let twoDaysFromNowTimestamp = Int64(TimeTraveler.dateByAdding(days: 2).timeIntervalSince1970) - networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateExpiry(expiry: twoDaysFromNowTimestamp), Data(), Date(), nil)) + networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateExpiry(expiry: twoDaysFromNowTimestamp), Data(), Date(), nil, "", nil)) let potentiallyExtendedSession = storageMock.getAll().first {$0.topic == session.topic}! XCTAssertEqual(potentiallyExtendedSession.expiryDate.timeIntervalSinceReferenceDate, tomorrow.timeIntervalSinceReferenceDate, accuracy: 1, "expiry date has been extended for peer non controller request ") @@ -84,7 +84,7 @@ class NonControllerSessionStateMachineTests: XCTestCase { let session = WCSession.stub(isSelfController: false, expiryDate: tomorrow) storageMock.setSession(session) let tenDaysFromNowTimestamp = Int64(TimeTraveler.dateByAdding(days: 10).timeIntervalSince1970) - networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateExpiry(expiry: tenDaysFromNowTimestamp), Data(), Date(), nil)) + networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateExpiry(expiry: tenDaysFromNowTimestamp), Data(), Date(), nil, "", nil)) let potentaillyExtendedSession = storageMock.getAll().first {$0.topic == session.topic}! XCTAssertEqual(potentaillyExtendedSession.expiryDate.timeIntervalSinceReferenceDate, tomorrow.timeIntervalSinceReferenceDate, accuracy: 1, "expiry date has been extended despite ttl to high") @@ -96,7 +96,7 @@ class NonControllerSessionStateMachineTests: XCTestCase { storageMock.setSession(session) let oneDayFromNowTimestamp = Int64(TimeTraveler.dateByAdding(days: 10).timeIntervalSince1970) - networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateExpiry(expiry: oneDayFromNowTimestamp), Data(), Date(), nil)) + networkingInteractor.requestPublisherSubject.send((session.topic, RPCRequest.stubUpdateExpiry(expiry: oneDayFromNowTimestamp), Data(), Date(), nil, "", nil)) let potentaillyExtendedSession = storageMock.getAll().first {$0.topic == session.topic}! XCTAssertEqual(potentaillyExtendedSession.expiryDate.timeIntervalSinceReferenceDate, tomorrow.timeIntervalSinceReferenceDate, accuracy: 1, "expiry date has been extended despite ttl to low") } diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index 0f2828805..a27cf8807 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -59,7 +59,7 @@ final class SessionEngineTests: XCTestCase { expiry: UInt64(Date().timeIntervalSince1970) ) - networkingInteractor.requestPublisherSubject.send(("topic", request, Data(), Date(), "")) + networkingInteractor.requestPublisherSubject.send(("topic", request, Data(), Date(), "", "", nil)) wait(for: [expectation], timeout: 0.5) } diff --git a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift index 4e332022d..b023226ce 100644 --- a/Tests/WalletConnectSignTests/Stub/Session+Stub.swift +++ b/Tests/WalletConnectSignTests/Stub/Session+Stub.swift @@ -32,7 +32,8 @@ extension WCSession { accounts: Account.stubSet(), acknowledged: acknowledged, expiryTimestamp: Int64(expiryDate.timeIntervalSince1970), - transportType: .relay) + transportType: .relay, + verifyContext: VerifyContext(origin: nil, validation: .unknown)) } } From 6e0167ce36285a3e6d3db476b402332c11047ea5 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jul 2024 17:56:34 +0900 Subject: [PATCH 688/814] fix relay tests --- Example/RelayIntegrationTests/RelayClientEndToEndTests.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index e3888e786..e52094049 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -115,12 +115,12 @@ final class RelayClientEndToEndTests: XCTestCase { expectationA.assertForOverFulfill = false expectationB.assertForOverFulfill = false - relayA.messagePublisher.sink { topic, payload, _ in + relayA.messagePublisher.sink { topic, payload, _, _ in (subscriptionATopic, subscriptionAPayload) = (topic, payload) expectationA.fulfill() }.store(in: &publishers) - relayB.messagePublisher.sink { topic, payload, _ in + relayB.messagePublisher.sink { topic, payload, _, _ in (subscriptionBTopic, subscriptionBPayload) = (topic, payload) Task(priority: .high) { sleep(1) From 85ffdde8482493090179d02389803a0430947370 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jul 2024 18:12:00 +0900 Subject: [PATCH 689/814] print more descriptive error --- .../WalletConnectVerify/PublicKeyFetcher.swift | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectVerify/PublicKeyFetcher.swift b/Sources/WalletConnectVerify/PublicKeyFetcher.swift index fdd5caa72..ec080e8a5 100644 --- a/Sources/WalletConnectVerify/PublicKeyFetcher.swift +++ b/Sources/WalletConnectVerify/PublicKeyFetcher.swift @@ -17,9 +17,19 @@ class PublicKeyFetcher: PublicKeyFetching { throw NSError(domain: "", code: 0, userInfo: [NSLocalizedDescriptionKey: "Invalid URL"]) } - let (data, _) = try await URLSession.shared.data(from: url) - let publicKeyResponse = try JSONDecoder().decode(VerifyServerPublicKey.self, from: data) - return publicKeyResponse + let (data, response) = try await URLSession.shared.data(from: url) + if let httpResponse = response as? HTTPURLResponse, !(200...299).contains(httpResponse.statusCode) { + let errorMessage = String(data: data, encoding: .utf8) ?? "Unknown error" + throw NSError(domain: "", code: httpResponse.statusCode, userInfo: [NSLocalizedDescriptionKey: errorMessage]) + } + + do { + let publicKeyResponse = try JSONDecoder().decode(VerifyServerPublicKey.self, from: data) + return publicKeyResponse + } catch { + print("Decoding error: \(error)") + throw NSError(domain: "", code: 0, userInfo: [NSLocalizedDescriptionKey: "Failed to decode JSON"]) + } } } From 7d8c2f419e4bc54206c7037dc86e678418dd159e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jul 2024 18:43:53 +0900 Subject: [PATCH 690/814] remove ack check --- .../LinkAndRelayDispatchers/LinkSessionRequester.swift | 2 +- .../LinkAndRelayDispatchers/SessionResponderDispatcher.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift index 015f261ee..684e5522a 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift @@ -18,7 +18,7 @@ final class LinkSessionRequester { func request(_ request: Request) async throws -> String? { logger.debug("will request on session topic: \(request.topic)") - guard let session = sessionStore.getSession(forTopic: request.topic), session.acknowledged else { + guard let session = sessionStore.getSession(forTopic: request.topic) else { logger.debug("Could not find session for topic \(request.topic)") throw WalletConnectError.noSessionMatchingTopic(request.topic) } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift index fa61d3971..de13ac389 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/SessionResponderDispatcher.swift @@ -21,7 +21,7 @@ class SessionResponderDispatcher { func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String? { - guard let session = sessionStore.getSession(forTopic: topic), session.acknowledged else { + guard let session = sessionStore.getSession(forTopic: topic) else { logger.debug("Could not find session for topic \(topic)") throw WalletConnectError.noSessionMatchingTopic(topic) } From 572591dfa49bfb47b0e91c0165fccf4d1e57c2ca Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 24 Jul 2024 19:38:55 +0900 Subject: [PATCH 691/814] update verify context creation --- .../Link/ApproveSessionAuthenticateUtil.swift | 15 +++++++++++++-- .../Link/LinkSessionAuthenticateResponder.swift | 4 +--- .../Wallet/SessionAuthenticateResponder.swift | 3 +-- .../Engine/Common/ApproveEngine.swift | 3 ++- .../Sign/SignClientFactory.swift | 2 +- 5 files changed, 18 insertions(+), 9 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index 78e4e9b06..c60273ff9 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -14,6 +14,8 @@ class ApproveSessionAuthenticateUtil { private let logger: ConsoleLogging private let sessionStore: WCSessionStorage private let sessionNamespaceBuilder: SessionNamespaceBuilder + private let verifyContextStore: CodableStore + private let verifyClient: VerifyClientProtocol init( logger: ConsoleLogging, @@ -23,7 +25,9 @@ class ApproveSessionAuthenticateUtil { messageFormatter: SIWEFromCacaoFormatting, sessionStore: WCSessionStorage, sessionNamespaceBuilder: SessionNamespaceBuilder, - networkingInteractor: NetworkInteracting + networkingInteractor: NetworkInteracting, + verifyContextStore: CodableStore, + verifyClient: VerifyClientProtocol ) { self.logger = logger self.kms = kms @@ -33,6 +37,8 @@ class ApproveSessionAuthenticateUtil { self.signatureVerifier = signatureVerifier self.messageFormatter = messageFormatter self.networkingInteractor = networkingInteractor + self.verifyContextStore = verifyContextStore + self.verifyClient = verifyClient } func getsessionAuthenticateRequestParams(requestId: RPCID) throws -> (request: SessionAuthenticateRequestParams, topic: String) { @@ -60,7 +66,6 @@ class ApproveSessionAuthenticateUtil { return (topic, keys) } - func createSession( response: SessionAuthenticateResponseParams, pairingTopic: String, @@ -116,6 +121,12 @@ class ApproveSessionAuthenticateUtil { return session.publicRepresentation() } + + func getVerifyContext(requestId: RPCID, domain: String) -> VerifyContext { + (try? verifyContextStore.get(key: requestId.string)) ?? verifyClient.createVerifyContext(origin: nil, domain: domain, isScam: false) + } + + func recoverAndVerifySignature(cacaos: [Cacao]) async throws { try await cacaos.asyncForEach { [unowned self] cacao in guard diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index b176dd1aa..31d6ba9fe 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -60,15 +60,13 @@ actor LinkSessionAuthenticateResponder { let url = try await linkEnvelopesDispatcher.respond(topic: responseTopic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) - let verifyContext = (try? verifyContextStore.get(key: requestId.string)) ?? VerifyContext(origin: nil, validation: .unknown) - let session = try util.createSession( response: responseParams, pairingTopic: pairingTopic, request: sessionAuthenticateRequestParams, sessionTopic: sessionTopic, transportType: .linkMode, - verifyContext: verifyContext + verifyContext: util.getVerifyContext(requestId: requestId, domain: sessionAuthenticateRequestParams.requester.metadata.url) ) verifyContextStore.delete(forKey: requestId.string) diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index 825225c0e..37e89a07d 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -120,14 +120,13 @@ actor SessionAuthenticateResponder { } do { - let verifyContext = (try? verifyContextStore.get(key: requestId.string)) ?? VerifyContext(origin: nil, validation: .unknown) let session = try util.createSession( response: responseParams, pairingTopic: pairingTopic, request: sessionAuthenticateRequestParams, sessionTopic: sessionTopic, transportType: .relay, - verifyContext: verifyContext + verifyContext: util.getVerifyContext(requestId: requestId, domain: sessionAuthenticateRequestParams.requester.metadata.url) ) pairingRegisterer.activate( pairingTopic: pairingTopic, diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index a94cae925..e0c762dd5 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -226,7 +226,8 @@ final class ApproveEngine { expiry: Int64(expiry) ) - let verifyContext = (try? verifyContextStore.get(key: proposal.proposer.publicKey)) ?? VerifyContext(origin: nil, validation: .unknown) + let verifyContext = (try? verifyContextStore.get(key: proposal.proposer.publicKey)) ?? verifyClient.createVerifyContext(origin: nil, domain: proposal.proposer.metadata.url, isScam: false) + let session = WCSession( topic: topic, diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index caebc0840..8ad3d214b 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -121,7 +121,7 @@ public struct SignClientFactory { let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) - let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder, networkingInteractor: networkingClient) + let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder, networkingInteractor: networkingClient, verifyContextStore: verifyContextStore, verifyClient: verifyClient) let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) From d563f758422340d774ba1133873a862558d9f24e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Jul 2024 12:32:50 +0900 Subject: [PATCH 692/814] pubkey as jwk --- Sources/WalletConnectJWT/JWTValidator.swift | 30 +++++++++++ .../AttestationJWTVerifier.swift | 12 ++--- .../PublicKeyFetcher.swift | 51 ++++++++++++++++++- .../VerifyServerPubKeyManager.swift | 12 +++-- .../VerifyServerPubKeyManagerTests.swift | 51 ++++++++++++++----- 5 files changed, 131 insertions(+), 25 deletions(-) diff --git a/Sources/WalletConnectJWT/JWTValidator.swift b/Sources/WalletConnectJWT/JWTValidator.swift index 110309a8d..4b82018fa 100644 --- a/Sources/WalletConnectJWT/JWTValidator.swift +++ b/Sources/WalletConnectJWT/JWTValidator.swift @@ -1,4 +1,5 @@ import Foundation +import CryptoKit public struct JWTValidator { @@ -24,3 +25,32 @@ public struct JWTValidator { return publicKey.isValid(signature: signatureData, for: unsignedData) } } + + +public struct P256JWTValidator { + + let jwtString: String + + public init(jwtString: String) { + self.jwtString = jwtString + } + + public func isValid(publicKey: P256.Signing.PublicKey) throws -> Bool { + var components = jwtString.components(separatedBy: ".") + + guard components.count == 3 else { throw JWTError.undefinedFormat } + + let signature = components.removeLast() + + guard let unsignedData = components + .joined(separator: ".") + .data(using: .utf8) + else { throw JWTError.invalidJWTString } + + let signatureData = try JWTEncoder.base64urlDecodedData(string: signature) + + let P256Signature = try P256.Signing.ECDSASignature(rawRepresentation: signatureData) + + return publicKey.isValidSignature(P256Signature, for: unsignedData) + } +} diff --git a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift index 3d7ede265..844995f5c 100644 --- a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift +++ b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift @@ -1,5 +1,6 @@ import Foundation +import CryptoKit struct AttestationJWTClaims: Codable { @@ -30,10 +31,10 @@ class AttestationJWTVerifier { func verify(attestationJWT: String, messageId: String) async throws -> VerifyResponse { do { let verifyServerPubKey = try await verifyServerPubKeyManager.getPublicKey() - try verifyJWTAgainstPubKey(attestationJWT, pubKey: verifyServerPubKey) + try verifyJWTAgainstPubKey(attestationJWT, signingPubKey: verifyServerPubKey) } catch { let refreshedVerifyServerPubKey = try await verifyServerPubKeyManager.refreshKey() - try verifyJWTAgainstPubKey(attestationJWT, pubKey: refreshedVerifyServerPubKey) + try verifyJWTAgainstPubKey(attestationJWT, signingPubKey: refreshedVerifyServerPubKey) } let claims = try decodeJWTClaims(jwtString: attestationJWT) @@ -44,10 +45,8 @@ class AttestationJWTVerifier { return VerifyResponse(origin: claims.origin, isScam: claims.isScam) } - func verifyJWTAgainstPubKey(_ jwtString: String, pubKey: String) throws { - let signingPubKey = try SigningPublicKey(hex: pubKey) - - let validator = JWTValidator(jwtString: jwtString) + func verifyJWTAgainstPubKey(_ jwtString: String, signingPubKey: P256.Signing.PublicKey) throws { + let validator = P256JWTValidator(jwtString: jwtString) guard try validator.isValid(publicKey: signingPubKey) else { throw Errors.invalidJWT } @@ -67,3 +66,4 @@ class AttestationJWTVerifier { return claims } } + diff --git a/Sources/WalletConnectVerify/PublicKeyFetcher.swift b/Sources/WalletConnectVerify/PublicKeyFetcher.swift index ec080e8a5..bbacc7e6f 100644 --- a/Sources/WalletConnectVerify/PublicKeyFetcher.swift +++ b/Sources/WalletConnectVerify/PublicKeyFetcher.swift @@ -1,13 +1,62 @@ import Foundation +import CryptoKit // PublicKeyFetcher class protocol PublicKeyFetching { func fetchPublicKey() async throws -> VerifyServerPublicKey } struct VerifyServerPublicKey: Codable { - let publicKey: String + enum Errors: Error { + case invalisXCoordinateData + case invalidYCoordinateData + } + let publicKey: JWK let expiresAt: TimeInterval + + enum CodingKeys: String, CodingKey { + case publicKey = "publicKey" + case expiresAt = "expiresAt" + } + + struct JWK: Codable { + let crv: String + let ext: Bool + let keyOps: [String] + let kty: String + let x: String + let y: String + + enum CodingKeys: String, CodingKey { + case crv + case ext + case keyOps = "key_ops" + case kty + case x + case y + } + + func P256SigningPublicKey() throws -> P256.Signing.PublicKey { + let jwk = self + // Convert the x and y values from base64url to Data + guard let xData = Data(base64urlEncoded: jwk.x), xData.count == 32 else { + print("Invalid x-coordinate data.") + throw Errors.invalisXCoordinateData + } + guard let yData = Data(base64urlEncoded: jwk.y), yData.count == 32 else { + print("Invalid y-coordinate data.") + throw Errors.invalidYCoordinateData + } + + // Concatenate the coordinates with the uncompressed point prefix 0x04 + let rawKeyData = xData + yData + + return try P256.Signing.PublicKey(rawRepresentation: rawKeyData) + } + } + } + + class PublicKeyFetcher: PublicKeyFetching { private let urlString = "https://verify.walletconnect.org/v2/public-key" diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index f72cd5419..3810f5dbe 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -1,6 +1,8 @@ import Foundation +import CryptoKit class VerifyServerPubKeyManager { + static let publicKeyStorageKey = "verify_server_pub_key" private let store: CodableStore private let fetcher: PublicKeyFetching @@ -25,20 +27,20 @@ class VerifyServerPubKeyManager { } } - func getPublicKey() async throws -> String { + func getPublicKey() async throws -> P256.Signing.PublicKey { if let localKey = try getPublicKeyFromLocalStorage(), !isKeyExpired(localKey) { - return localKey.publicKey + return try localKey.publicKey.P256SigningPublicKey() } else { let serverKey = try await fetcher.fetchPublicKey() savePublicKeyToLocalStorage(publicKey: serverKey) - return serverKey.publicKey + return try serverKey.publicKey.P256SigningPublicKey() } } - func refreshKey() async throws -> String { + func refreshKey() async throws -> P256.Signing.PublicKey { let serverKey = try await fetcher.fetchPublicKey() savePublicKeyToLocalStorage(publicKey: serverKey) - return serverKey.publicKey + return try serverKey.publicKey.P256SigningPublicKey() } private func getPublicKeyFromLocalStorage() throws -> VerifyServerPublicKey? { diff --git a/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift b/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift index 913f23994..1a997465a 100644 --- a/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift +++ b/Tests/VerifyTests/VerifyServerPubKeyManagerTests.swift @@ -1,5 +1,5 @@ -import Foundation import XCTest +import CryptoKit @testable import WalletConnectVerify class VerifyServerPubKeyManagerTests: XCTestCase { @@ -15,40 +15,65 @@ class VerifyServerPubKeyManagerTests: XCTestCase { } func testGetPublicKeyFromServer() async throws { - let expectedPublicKey = "test_public_key" + let expectedJWK = VerifyServerPublicKey.JWK.stub() + let expectedPublicKey = try expectedJWK.P256SigningPublicKey() let expiresAt = Date().timeIntervalSince1970 + 3600 // 1 hour from now - fetcher.publicKey = VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + fetcher.publicKey = VerifyServerPublicKey(publicKey: expectedJWK, expiresAt: expiresAt) manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) let publicKey = try await manager.getPublicKey() - XCTAssertEqual(publicKey, expectedPublicKey) + XCTAssertEqual(publicKey.rawRepresentation, expectedPublicKey.rawRepresentation) } func testGetPublicKeyFromLocalStorage() async throws { - let expectedPublicKey = "test_public_key" + let expectedJWK = VerifyServerPublicKey.JWK.stub() + let expectedPublicKey = try expectedJWK.P256SigningPublicKey() let expiresAt = Date().timeIntervalSince1970 + 3600 // 1 hour from now - let storedKey = VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + let storedKey = VerifyServerPublicKey(publicKey: expectedJWK, expiresAt: expiresAt) store.set(storedKey, forKey: VerifyServerPubKeyManager.publicKeyStorageKey) manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) let publicKey = try await manager.getPublicKey() - XCTAssertEqual(publicKey, expectedPublicKey) + XCTAssertEqual(publicKey.rawRepresentation, expectedPublicKey.rawRepresentation) } func testGetExpiredPublicKeyFromLocalStorage() async throws { - let expectedPublicKey = "test_public_key" - let newTestPubKey = "new_test_public_key" - let expiresAt = Date().timeIntervalSince1970 - 3600 // 1 hour ago - let storedKey = VerifyServerPublicKey(publicKey: expectedPublicKey, expiresAt: expiresAt) + let oldJWK = VerifyServerPublicKey.JWK.stub() + let newJWK = VerifyServerPublicKey.JWK( + crv: "P-256", + ext: true, + keyOps: ["verify"], + kty: "EC", + x: "MKl2ZQXTZsL10tK3nDXJZUJTTkGaxgPtg42lC5VxW9c", + y: "IcIsyFf6M5XzUjxwK9ujYB69TUMzIYGTkUyrvjoB3UM" + ) + let oldPublicKey = try oldJWK.P256SigningPublicKey() + let newPublicKey = try newJWK.P256SigningPublicKey() + let expiredTime = Date().timeIntervalSince1970 - 3600 // 1 hour ago + let validTime = Date().timeIntervalSince1970 + 3600 // 1 hour from now + let storedKey = VerifyServerPublicKey(publicKey: oldJWK, expiresAt: expiredTime) store.set(storedKey, forKey: VerifyServerPubKeyManager.publicKeyStorageKey) - fetcher.publicKey = VerifyServerPublicKey(publicKey: newTestPubKey, expiresAt: Date().timeIntervalSince1970 + 3600) + fetcher.publicKey = VerifyServerPublicKey(publicKey: newJWK, expiresAt: validTime) manager = VerifyServerPubKeyManager(store: store, fetcher: fetcher) let publicKey = try await manager.getPublicKey() - XCTAssertEqual(publicKey, newTestPubKey) + XCTAssertEqual(publicKey.rawRepresentation, newPublicKey.rawRepresentation) + } +} + +extension VerifyServerPublicKey.JWK { + static func stub() -> VerifyServerPublicKey.JWK { + return VerifyServerPublicKey.JWK( + crv: "P-256", + ext: true, + keyOps: ["verify"], + kty: "EC", + x: "CbL4DOYOb1ntd-8OmExO-oS0DWCMC00DntrymJoB8tk", + y: "KTFwjHtQxGTDR91VsOypcdBfvbo6sAMj5p4Wb-9hRA0" + ) } } From 1a5bba4b9f7c14054bb0033dbff7653b426e7616 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 29 Jul 2024 14:24:02 +0900 Subject: [PATCH 693/814] add AttestationJWTVerifierTests --- .../AttestationJWTVerifier.swift | 4 +- .../VerifyServerPubKeyManager.swift | 40 ++++++++++++++++++- .../VerifyTests/AttestationJWTVerifier.swift | 37 +++++++++++++++++ 3 files changed, 78 insertions(+), 3 deletions(-) create mode 100644 Tests/VerifyTests/AttestationJWTVerifier.swift diff --git a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift index 844995f5c..fb9ea9c7a 100644 --- a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift +++ b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift @@ -21,9 +21,9 @@ class AttestationJWTVerifier { case invalidJWT } - let verifyServerPubKeyManager: VerifyServerPubKeyManager + let verifyServerPubKeyManager: VerifyServerPubKeyManagerProtocol - init(verifyServerPubKeyManager: VerifyServerPubKeyManager) { + init(verifyServerPubKeyManager: VerifyServerPubKeyManagerProtocol) { self.verifyServerPubKeyManager = verifyServerPubKeyManager } diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index 3810f5dbe..b48b01d1a 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -1,7 +1,12 @@ import Foundation import CryptoKit -class VerifyServerPubKeyManager { +protocol VerifyServerPubKeyManagerProtocol { + func getPublicKey() async throws -> P256.Signing.PublicKey + func refreshKey() async throws -> P256.Signing.PublicKey +} + +class VerifyServerPubKeyManager: VerifyServerPubKeyManagerProtocol { static let publicKeyStorageKey = "verify_server_pub_key" private let store: CodableStore @@ -56,3 +61,36 @@ class VerifyServerPubKeyManager { store.set(publicKey, forKey: Self.publicKeyStorageKey) } } + +#if DEBUG +class VerifyServerPubKeyManagerMock: VerifyServerPubKeyManagerProtocol { + var mockPublicKey: P256.Signing.PublicKey? + var error: Error? + + init() { + let jwk = VerifyServerPublicKey.JWK( + crv: "P-256", + ext: true, + keyOps: ["verify"], + kty: "EC", + x: "NzUWD0z_Sr3corYWb2bfEF68_UvYcxFzslHKRJ_xCHk", + y: "gWkzUBt_VKro6rydyWdm-ii9-DHjpxdxVQTyX_ZZohc" + ) + mockPublicKey = try? jwk.P256SigningPublicKey() + } + + func getPublicKey() async throws -> P256.Signing.PublicKey { + if let error = error { + throw error + } + return mockPublicKey! + } + + func refreshKey() async throws -> P256.Signing.PublicKey { + if let error = error { + throw error + } + return mockPublicKey! + } +} +#endif diff --git a/Tests/VerifyTests/AttestationJWTVerifier.swift b/Tests/VerifyTests/AttestationJWTVerifier.swift new file mode 100644 index 000000000..8c32352e1 --- /dev/null +++ b/Tests/VerifyTests/AttestationJWTVerifier.swift @@ -0,0 +1,37 @@ +import XCTest +import CryptoKit +@testable import WalletConnectVerify + +class AttestationJWTVerifierTests: XCTestCase { + var verifier: AttestationJWTVerifier! + var mockManager: VerifyServerPubKeyManagerMock! + + override func setUp() { + super.setUp() + mockManager = VerifyServerPubKeyManagerMock() + verifier = AttestationJWTVerifier(verifyServerPubKeyManager: mockManager) + } + + func testVerifyValidJWT() async throws { + let jwt = "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MjIyMjMyOTYsImlkIjoiQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQSIsIm9yaWdpbiI6Imh0dHBzOi8vd2ViM21vZGFsLmNvbSIsImlzU2NhbSI6ZmFsc2V9.IyIDRId-8Yv6ZkrnHh4BdL7AClNM5brOyGpYbUw9V_SHJqxgEd9UzMlwcOsVoFHxIqgyoYA-ulvANHW0kv_KdA" + let messageId = "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" + + let response = try await verifier.verify(attestationJWT: jwt, messageId: messageId) + XCTAssertEqual(response.origin, "https://web3modal.com") + XCTAssertEqual(response.isScam, false) + } + + func testVerifyJWTWithInvalidMessageId() async throws { + let jwt = "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MjIyMjMyOTYsImlkIjoiQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQSIsIm9yaWdpbiI6Imh0dHBzOi8vd2ViM21vZGFsLmNvbSIsImlzU2NhbSI6ZmFsc2V9.IyIDRId-8Yv6ZkrnHh4BdL7AClNM5brOyGpYbUw9V_SHJqxgEd9UzMlwcOsVoFHxIqgyoYA-ulvANHW0kv_KdA" + let invalidMessageId = "InvalidMessageId" + + do { + _ = try await verifier.verify(attestationJWT: jwt, messageId: invalidMessageId) + XCTFail("Expected to throw messageIdMismatch error") + } catch AttestationJWTVerifier.Errors.messageIdMismatch { + // Expected error + } catch { + XCTFail("Unexpected error: \(error)") + } + } +} From df4475629f7e8039eac0a3cefb5ea5b4ed92cd44 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Aug 2024 13:42:16 +0200 Subject: [PATCH 694/814] savepoint --- Example/ExampleApp.xcodeproj/project.pbxproj | 42 ++++++------------- .../Engine/Common/ApproveEngine.swift | 1 - .../Engine/Common/SessionEngine.swift | 3 -- .../Sign/SignClientFactory.swift | 2 +- .../AttestationJWTVerifier.swift | 5 ++- .../Register/VerifyService.swift | 2 +- 6 files changed, 18 insertions(+), 37 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index cf70d6ce0..498b0aa9a 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -2783,11 +2783,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_ENTITLEMENTS = DApp/DApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = DApp/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = dApp; @@ -2807,7 +2805,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.dapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.dapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; @@ -2822,11 +2819,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++17"; CODE_SIGN_ENTITLEMENTS = DApp/DAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = DApp/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = dApp; @@ -2846,7 +2841,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.dapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.dapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; @@ -2859,11 +2853,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = PNDecryptionService/PNDecryptionService.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = PNDecryptionService/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = PNDecryptionService; @@ -2878,7 +2870,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp.PNDecryptionService; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp.PNDecryptionService"; SKIP_INSTALL = YES; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; @@ -2892,11 +2883,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = PNDecryptionService/PNDecryptionServiceRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = PNDecryptionService/Info.plist; INFOPLIST_KEY_CFBundleDisplayName = PNDecryptionService; @@ -2911,7 +2900,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp.PNDecryptionService; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp.PNDecryptionService"; SKIP_INSTALL = YES; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; @@ -3075,11 +3063,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = WalletApp/WalletApp.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = WalletApp/Other/Info.plist; @@ -3098,7 +3084,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; @@ -3114,11 +3099,9 @@ CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; CODE_SIGN_ENTITLEMENTS = WalletApp/WalletAppRelease.entitlements; CODE_SIGN_IDENTITY = "Apple Development"; - "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution"; - CODE_SIGN_STYLE = Manual; + CODE_SIGN_STYLE = Automatic; CURRENT_PROJECT_VERSION = 173; - DEVELOPMENT_TEAM = ""; - "DEVELOPMENT_TEAM[sdk=iphoneos*]" = W5R8AG9K22; + DEVELOPMENT_TEAM = W5R8AG9K22; ENABLE_PREVIEWS = YES; GENERATE_INFOPLIST_FILE = YES; INFOPLIST_FILE = WalletApp/Other/Info.plist; @@ -3137,7 +3120,6 @@ PRODUCT_BUNDLE_IDENTIFIER = com.walletconnect.walletapp; PRODUCT_NAME = "$(TARGET_NAME)"; PROVISIONING_PROFILE_SPECIFIER = ""; - "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "match AppStore com.walletconnect.walletapp"; SWIFT_EMIT_LOC_STRINGS = YES; SWIFT_VERSION = 5.0; TARGETED_DEVICE_FAMILY = "1,2"; diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index e0c762dd5..79a0cd447 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -399,7 +399,6 @@ private extension ApproveEngine { } Task(priority: .high) { - let assertionId = payload.decryptedPayload.sha256().toHexString() do { let response: VerifyResponse if let attestation = payload.attestation, diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 40997cde9..a18c922c8 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -20,7 +20,6 @@ final class SessionEngine { private let networkingInteractor: NetworkInteracting private let historyService: HistoryServiceProtocol private let verifyContextStore: CodableStore - private let verifyClient: VerifyClientProtocol private let kms: KeyManagementServiceProtocol private var publishers = [AnyCancellable]() private let logger: ConsoleLogging @@ -31,7 +30,6 @@ final class SessionEngine { networkingInteractor: NetworkInteracting, historyService: HistoryServiceProtocol, verifyContextStore: CodableStore, - verifyClient: VerifyClientProtocol, kms: KeyManagementServiceProtocol, sessionStore: WCSessionStorage, logger: ConsoleLogging, @@ -41,7 +39,6 @@ final class SessionEngine { self.networkingInteractor = networkingInteractor self.historyService = historyService self.verifyContextStore = verifyContextStore - self.verifyClient = verifyClient self.kms = kms self.sessionStore = sessionStore self.logger = logger diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 8ad3d214b..98bdb3239 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -65,7 +65,7 @@ public struct SignClientFactory { let verifyClient = VerifyClientFactory.create() let sessionRequestsProvider = SessionRequestsProvider(historyService: historyService) let invalidRequestsSanitiser = InvalidRequestsSanitiser(historyService: historyService, history: rpcHistory) - let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, verifyClient: verifyClient, kms: kms, sessionStore: sessionStore, logger: logger, sessionRequestsProvider: sessionRequestsProvider, invalidRequestsSanitiser: invalidRequestsSanitiser) + let sessionEngine = SessionEngine(networkingInteractor: networkingClient, historyService: historyService, verifyContextStore: verifyContextStore, kms: kms, sessionStore: sessionStore, logger: logger, sessionRequestsProvider: sessionRequestsProvider, invalidRequestsSanitiser: invalidRequestsSanitiser) let nonControllerSessionStateMachine = NonControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let controllerSessionStateMachine = ControllerSessionStateMachine(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let sessionExtendRequester = SessionExtendRequester(sessionStore: sessionStore, networkingInteractor: networkingClient) diff --git a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift index fb9ea9c7a..cea4f9a72 100644 --- a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift +++ b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift @@ -11,6 +11,8 @@ struct AttestationJWTClaims: Codable { var id: String var origin: String + + var isVerified: Bool } class AttestationJWTVerifier { @@ -47,7 +49,8 @@ class AttestationJWTVerifier { func verifyJWTAgainstPubKey(_ jwtString: String, signingPubKey: P256.Signing.PublicKey) throws { let validator = P256JWTValidator(jwtString: jwtString) - guard try validator.isValid(publicKey: signingPubKey) else { + guard let isValid = try? validator.isValid(publicKey: signingPubKey), + isValid else { throw Errors.invalidJWT } } diff --git a/Sources/WalletConnectVerify/Register/VerifyService.swift b/Sources/WalletConnectVerify/Register/VerifyService.swift index 5cf720118..dec10faee 100644 --- a/Sources/WalletConnectVerify/Register/VerifyService.swift +++ b/Sources/WalletConnectVerify/Register/VerifyService.swift @@ -20,7 +20,7 @@ enum VerifyAPI: HTTPService { } var queryParameters: [String: String]? { - return nil + return ["v2Supported": "true"] } var scheme: String { From c54013ae69fd729c2ba724dbff4c37ce4e712b6c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Aug 2024 14:57:51 +0200 Subject: [PATCH 695/814] savepoint --- .../WalletConnectVerify/VerifyContextFactory.swift | 10 +++++++++- Tests/VerifyTests/VerifyContextFactoryTests.swift | 13 +++++++++++++ 2 files changed, 22 insertions(+), 1 deletion(-) diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift index 0cdec63fb..004743a44 100644 --- a/Sources/WalletConnectVerify/VerifyContextFactory.swift +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -2,13 +2,21 @@ import Foundation class VerifyContextFactory { - public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { + public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool? = nil) -> VerifyContext { + if let isVerified = isVerified, !isVerified { + return VerifyContext( + origin: origin, + validation: .unknown + ) + } + guard isScam != true else { return VerifyContext( origin: origin, validation: .scam ) } + if let origin, let originUrl = URL(string: origin), let domainUrl = URL(string: domain) { return VerifyContext( origin: origin, diff --git a/Tests/VerifyTests/VerifyContextFactoryTests.swift b/Tests/VerifyTests/VerifyContextFactoryTests.swift index 2806b10c3..f89526d91 100644 --- a/Tests/VerifyTests/VerifyContextFactoryTests.swift +++ b/Tests/VerifyTests/VerifyContextFactoryTests.swift @@ -36,6 +36,19 @@ class VerifyContextFactoryTests: XCTestCase { XCTAssertEqual(context.validation, .unknown) } + func testVerifyContextIsMarkedAsUnknownWhenIsVerifiedIsFalse() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: false, isVerified: false) + XCTAssertEqual(context.validation, .unknown) + } + + func testVerifyContextIsMarkedAsScamWhenIsScamIsTrueRegardlessOfIsVerified() { + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true, isVerified: true) + XCTAssertEqual(context.validation, .scam) + + let contextWithFalseVerification = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true, isVerified: false) + XCTAssertEqual(contextWithFalseVerification.validation, .scam) + } + // tests for createVerifyContextForLinkMode func testValidUniversalLink() { From 41afb9e9a9e555c7818cdfce2fa4260f1b4e48a7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Aug 2024 15:05:10 +0200 Subject: [PATCH 696/814] add isVerified property --- .../WalletConnectVerify/VerifyContextFactory.swift | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift index 004743a44..f30b5ba65 100644 --- a/Sources/WalletConnectVerify/VerifyContextFactory.swift +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -3,20 +3,23 @@ import Foundation class VerifyContextFactory { public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool? = nil) -> VerifyContext { - if let isVerified = isVerified, !isVerified { + + guard isScam != true else { return VerifyContext( origin: origin, - validation: .unknown + validation: .scam ) } - guard isScam != true else { + // If isVerified is provided and is false, return unknown + if let isVerified = isVerified, !isVerified { return VerifyContext( origin: origin, - validation: .scam + validation: .unknown ) } + // Existing behavior for origin and domain validation if let origin, let originUrl = URL(string: origin), let domainUrl = URL(string: domain) { return VerifyContext( origin: origin, From bd983cb2069b61062d727a4a3ce40c7a1a138c58 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Aug 2024 15:15:45 +0200 Subject: [PATCH 697/814] fix AttestationJWTVerifierTests --- .../WalletConnectVerify/VerifyServerPubKeyManager.swift | 4 ++-- Tests/VerifyTests/AttestationJWTVerifier.swift | 9 ++++----- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift index b48b01d1a..49e2d3051 100644 --- a/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift +++ b/Sources/WalletConnectVerify/VerifyServerPubKeyManager.swift @@ -73,8 +73,8 @@ class VerifyServerPubKeyManagerMock: VerifyServerPubKeyManagerProtocol { ext: true, keyOps: ["verify"], kty: "EC", - x: "NzUWD0z_Sr3corYWb2bfEF68_UvYcxFzslHKRJ_xCHk", - y: "gWkzUBt_VKro6rydyWdm-ii9-DHjpxdxVQTyX_ZZohc" + x: "CbL4DOYOb1ntd-8OmExO-oS0DWCMC00DntrymJoB8tk", + y: "KTFwjHtQxGTDR91VsOypcdBfvbo6sAMj5p4Wb-9hRA0" ) mockPublicKey = try? jwk.P256SigningPublicKey() } diff --git a/Tests/VerifyTests/AttestationJWTVerifier.swift b/Tests/VerifyTests/AttestationJWTVerifier.swift index 8c32352e1..2f1a0e7ab 100644 --- a/Tests/VerifyTests/AttestationJWTVerifier.swift +++ b/Tests/VerifyTests/AttestationJWTVerifier.swift @@ -13,16 +13,15 @@ class AttestationJWTVerifierTests: XCTestCase { } func testVerifyValidJWT() async throws { - let jwt = "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MjIyMjMyOTYsImlkIjoiQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQSIsIm9yaWdpbiI6Imh0dHBzOi8vd2ViM21vZGFsLmNvbSIsImlzU2NhbSI6ZmFsc2V9.IyIDRId-8Yv6ZkrnHh4BdL7AClNM5brOyGpYbUw9V_SHJqxgEd9UzMlwcOsVoFHxIqgyoYA-ulvANHW0kv_KdA" - let messageId = "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" + let jwt = "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MjM0NzE3MjMsImlkIjoiYjNmYmZhMDUxZDJhNjdkNGRmNTYzM2IyMjc0NDAyNTUxMTg1NzQwZGQwMjA3YWM0OWI1M2RiYTcxOTc0YTgzNCIsIm9yaWdpbiI6Imh0dHBzOi8vcmVhY3QtZGFwcC12Mi1naXQtY2hvcmUtdmVyaWZ5LXYyLXNhbXBsZXMtd2FsbGV0Y29ubmVjdDEudmVyY2VsLmFwcCIsImlzU2NhbSI6bnVsbCwiaXNWZXJpZmllZCI6dHJ1ZX0.8RQwiEEfTGn8p3INRdHpi88dpzetKCp3nscfLtWG2cVE2dU0dWgV2ncqnh_RWmygqEnWCPUlH1RMwS1nWbZzrQ" + let messageId = "b3fbfa051d2a67d4df5633b2274402551185740dd0207ac49b53dba71974a834" let response = try await verifier.verify(attestationJWT: jwt, messageId: messageId) - XCTAssertEqual(response.origin, "https://web3modal.com") - XCTAssertEqual(response.isScam, false) + XCTAssertEqual(response.origin, "https://react-dapp-v2-git-chore-verify-v2-samples-walletconnect1.vercel.app") } func testVerifyJWTWithInvalidMessageId() async throws { - let jwt = "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MjIyMjMyOTYsImlkIjoiQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQSIsIm9yaWdpbiI6Imh0dHBzOi8vd2ViM21vZGFsLmNvbSIsImlzU2NhbSI6ZmFsc2V9.IyIDRId-8Yv6ZkrnHh4BdL7AClNM5brOyGpYbUw9V_SHJqxgEd9UzMlwcOsVoFHxIqgyoYA-ulvANHW0kv_KdA" + let jwt = "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MjM0NzE3MjMsImlkIjoiYjNmYmZhMDUxZDJhNjdkNGRmNTYzM2IyMjc0NDAyNTUxMTg1NzQwZGQwMjA3YWM0OWI1M2RiYTcxOTc0YTgzNCIsIm9yaWdpbiI6Imh0dHBzOi8vcmVhY3QtZGFwcC12Mi1naXQtY2hvcmUtdmVyaWZ5LXYyLXNhbXBsZXMtd2FsbGV0Y29ubmVjdDEudmVyY2VsLmFwcCIsImlzU2NhbSI6bnVsbCwiaXNWZXJpZmllZCI6dHJ1ZX0.8RQwiEEfTGn8p3INRdHpi88dpzetKCp3nscfLtWG2cVE2dU0dWgV2ncqnh_RWmygqEnWCPUlH1RMwS1nWbZzrQ" let invalidMessageId = "InvalidMessageId" do { From a00908828001f89587918697cd09eea272a728e1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Aug 2024 15:28:56 +0200 Subject: [PATCH 698/814] savepoint --- .../Auth/Link/ApproveSessionAuthenticateUtil.swift | 2 +- .../Auth/Services/Wallet/AuthRequestSubscriber.swift | 4 ++-- .../Engine/Common/ApproveEngine.swift | 7 ++++--- .../WalletConnectVerify/AttestationJWTVerifier.swift | 2 +- .../WalletConnectVerify/Register/VerifyResponse.swift | 1 + Sources/WalletConnectVerify/VerifyClient.swift | 11 +++++------ .../WalletConnectVerify/VerifyContextFactory.swift | 2 +- Tests/VerifyTests/VerifyContextFactoryTests.swift | 8 ++++---- 8 files changed, 19 insertions(+), 18 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index c60273ff9..cb439a4ff 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -123,7 +123,7 @@ class ApproveSessionAuthenticateUtil { func getVerifyContext(requestId: RPCID, domain: String) -> VerifyContext { - (try? verifyContextStore.get(key: requestId.string)) ?? verifyClient.createVerifyContext(origin: nil, domain: domain, isScam: false) + (try? verifyContextStore.get(key: requestId.string)) ?? verifyClient.createVerifyContext(origin: nil, domain: domain, isScam: false, isVerified: nil) } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index 53ccbe790..a3a5bbb7a 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -64,11 +64,11 @@ class AuthRequestSubscriber { let assertionId = payload.decryptedPayload.sha256().toHexString() response = try await verifyClient.verify(.v1(assertionId: assertionId)) } - let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.authPayload.domain, isScam: response.isScam) + let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.authPayload.domain, isScam: response.isScam, isVerified: response.isVerified) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.authPayload.domain, isScam: nil) + let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.authPayload.domain, isScam: nil, isVerified: nil) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) return diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 79a0cd447..fbe9a1a56 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -226,7 +226,7 @@ final class ApproveEngine { expiry: Int64(expiry) ) - let verifyContext = (try? verifyContextStore.get(key: proposal.proposer.publicKey)) ?? verifyClient.createVerifyContext(origin: nil, domain: proposal.proposer.metadata.url, isScam: false) + let verifyContext = (try? verifyContextStore.get(key: proposal.proposer.publicKey)) ?? verifyClient.createVerifyContext(origin: nil, domain: proposal.proposer.metadata.url, isScam: false, isVerified: nil) let session = WCSession( @@ -411,12 +411,13 @@ private extension ApproveEngine { let verifyContext = verifyClient.createVerifyContext( origin: response.origin, domain: payload.request.proposer.metadata.url, - isScam: response.isScam + isScam: response.isScam, + isVerified: response.isVerified ) verifyContextStore.set(verifyContext, forKey: proposal.proposer.publicKey) onSessionProposal?(proposal.publicRepresentation(pairingTopic: payload.topic), verifyContext) } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.proposer.metadata.url, isScam: nil) + let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.proposer.metadata.url, isScam: nil, isVerified: nil) onSessionProposal?(proposal.publicRepresentation(pairingTopic: payload.topic), verifyContext) return } diff --git a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift index cea4f9a72..424cf8fc4 100644 --- a/Sources/WalletConnectVerify/AttestationJWTVerifier.swift +++ b/Sources/WalletConnectVerify/AttestationJWTVerifier.swift @@ -44,7 +44,7 @@ class AttestationJWTVerifier { throw Errors.messageIdMismatch } - return VerifyResponse(origin: claims.origin, isScam: claims.isScam) + return VerifyResponse(origin: claims.origin, isScam: claims.isScam, isVerified: claims.isVerified) } func verifyJWTAgainstPubKey(_ jwtString: String, signingPubKey: P256.Signing.PublicKey) throws { diff --git a/Sources/WalletConnectVerify/Register/VerifyResponse.swift b/Sources/WalletConnectVerify/Register/VerifyResponse.swift index 24fba83eb..5ea509b46 100644 --- a/Sources/WalletConnectVerify/Register/VerifyResponse.swift +++ b/Sources/WalletConnectVerify/Register/VerifyResponse.swift @@ -3,4 +3,5 @@ import Foundation public struct VerifyResponse: Decodable { public let origin: String? public let isScam: Bool? + public let isVerified: Bool? } diff --git a/Sources/WalletConnectVerify/VerifyClient.swift b/Sources/WalletConnectVerify/VerifyClient.swift index 0d56ad089..93fb7dbb4 100644 --- a/Sources/WalletConnectVerify/VerifyClient.swift +++ b/Sources/WalletConnectVerify/VerifyClient.swift @@ -3,7 +3,7 @@ import Foundation public protocol VerifyClientProtocol { func verify(_ verificationType: VerificationType) async throws -> VerifyResponse - func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext + func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool?) -> VerifyContext func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext } @@ -53,8 +53,8 @@ public actor VerifyClient: VerifyClientProtocol { } } - nonisolated public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { - verifyContextFactory.createVerifyContext(origin: origin, domain: domain, isScam: isScam) + nonisolated public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool?) -> VerifyContext { + verifyContextFactory.createVerifyContext(origin: origin, domain: domain, isScam: isScam, isVerified: isVerified) } nonisolated public func createVerifyContextForLinkMode(redirectUniversalLink: String, domain: String) -> VerifyContext { @@ -69,14 +69,13 @@ public actor VerifyClient: VerifyClientProtocol { #if DEBUG public struct VerifyClientMock: VerifyClientProtocol { - public init() {} public func verify(_ verificationType: VerificationType) async throws -> VerifyResponse { - return VerifyResponse(origin: "domain.com", isScam: nil) + return VerifyResponse(origin: "domain.com", isScam: nil, isVerified: nil) } - public func createVerifyContext(origin: String?, domain: String, isScam: Bool?) -> VerifyContext { + public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool?) -> VerifyContext { return VerifyContext(origin: "domain.com", validation: .valid) } diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift index f30b5ba65..e1326ca09 100644 --- a/Sources/WalletConnectVerify/VerifyContextFactory.swift +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -2,7 +2,7 @@ import Foundation class VerifyContextFactory { - public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool? = nil) -> VerifyContext { + public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool?) -> VerifyContext { guard isScam != true else { return VerifyContext( diff --git a/Tests/VerifyTests/VerifyContextFactoryTests.swift b/Tests/VerifyTests/VerifyContextFactoryTests.swift index f89526d91..0d43c2aed 100644 --- a/Tests/VerifyTests/VerifyContextFactoryTests.swift +++ b/Tests/VerifyTests/VerifyContextFactoryTests.swift @@ -17,22 +17,22 @@ class VerifyContextFactoryTests: XCTestCase { } func testScamValidation() { - let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true) + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: true, isVerified: nil) XCTAssertEqual(context.validation, .scam) } func testValidOriginAndDomain() { - let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: false) + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://example.com", isScam: false, isVerified: nil) XCTAssertEqual(context.validation, .valid) } func testInvalidOriginAndDomain() { - let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://different.com", isScam: false) + let context = factory.createVerifyContext(origin: "http://example.com", domain: "http://different.com", isScam: false, isVerified: nil) XCTAssertEqual(context.validation, .invalid) } func testUnknownValidation() { - let context = factory.createVerifyContext(origin: nil, domain: "http://example.com", isScam: false) + let context = factory.createVerifyContext(origin: nil, domain: "http://example.com", isScam: false, isVerified: nil) XCTAssertEqual(context.validation, .unknown) } From a495480c139bd5c2c5ff22465e3e251354250f5f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 12 Aug 2024 15:39:59 +0200 Subject: [PATCH 699/814] fix redirect issue --- .../Wallet/AuthRequest/AuthRequestPresenter.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift index fdd623c2f..ce57ddd3d 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/AuthRequest/AuthRequestPresenter.swift @@ -87,7 +87,7 @@ final class AuthRequestPresenter: ObservableObject { /* Redirect */ if let uri = request.requester.redirect?.native { -// WalletConnectRouter.goBack(uri: uri) + WalletConnectRouter.goBack(uri: uri) router.dismiss() } else { showSignedSheet.toggle() From a23ae194719e65f96980bcb1abcaf579d62baf97 Mon Sep 17 00:00:00 2001 From: Alfreedom <00tango.bromine@icloud.com> Date: Mon, 12 Aug 2024 19:25:41 +0200 Subject: [PATCH 700/814] Added Flutter sample wallets --- Example/DApp/SceneDelegate.swift | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 5d5c3cb62..d750966e8 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -127,6 +127,24 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { mobileLink: "rn-web3wallet://", linkMode: "https://lab.web3modal.com/walletkit_rn" ) + .init( + id: "flutter-sample", + name: "Flutter Sample Wallet", + homepage: "https://walletconnect.com/", + imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", + order: 1, + mobileLink: "wcflutterwallet://", + linkMode: "https://lab.web3modal.com/walletkit_flutter" + ) + .init( + id: "flutter-sample-internal", + name: "Flutter Sample Wallet Internal", + homepage: "https://walletconnect.com/", + imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", + order: 1, + mobileLink: "wcflutterwallet-internal://", + linkMode: "https://lab.web3modal.com/walletkit_flutter_internal" + ) ] ) From 17d9a0acc40825b3b17a770358e9f5ff17eb31c1 Mon Sep 17 00:00:00 2001 From: Alfreedom <00tango.bromine@icloud.com> Date: Mon, 12 Aug 2024 21:01:14 +0200 Subject: [PATCH 701/814] Added a missing comma --- Example/DApp/SceneDelegate.swift | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index d750966e8..f4ed47f2c 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -126,7 +126,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { order: 1, mobileLink: "rn-web3wallet://", linkMode: "https://lab.web3modal.com/walletkit_rn" - ) + ), .init( id: "flutter-sample", name: "Flutter Sample Wallet", @@ -135,7 +135,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { order: 1, mobileLink: "wcflutterwallet://", linkMode: "https://lab.web3modal.com/walletkit_flutter" - ) + ), .init( id: "flutter-sample-internal", name: "Flutter Sample Wallet Internal", @@ -144,7 +144,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { order: 1, mobileLink: "wcflutterwallet-internal://", linkMode: "https://lab.web3modal.com/walletkit_flutter_internal" - ) + ), ] ) From 8489f46ac0a1babf165acb82a0b6abf12b9a47b4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Aug 2024 06:52:35 +0200 Subject: [PATCH 702/814] savepoint --- Sources/WalletConnectJWT/JWTValidator.swift | 2 +- .../Link/ApproveSessionAuthenticateUtil.swift | 5 +++- .../Wallet/AuthRequestSubscriber.swift | 1 - .../PublicKeyFetcher.swift | 26 ++++++++++++++++--- .../VerifyContextFactory.swift | 1 - 5 files changed, 27 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectJWT/JWTValidator.swift b/Sources/WalletConnectJWT/JWTValidator.swift index 4b82018fa..7dc300db5 100644 --- a/Sources/WalletConnectJWT/JWTValidator.swift +++ b/Sources/WalletConnectJWT/JWTValidator.swift @@ -3,7 +3,7 @@ import CryptoKit public struct JWTValidator { - let jwtString: String + private let jwtString: String public init(jwtString: String) { self.jwtString = jwtString diff --git a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift index cb439a4ff..73f14e765 100644 --- a/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift +++ b/Sources/WalletConnectSign/Auth/Link/ApproveSessionAuthenticateUtil.swift @@ -123,7 +123,10 @@ class ApproveSessionAuthenticateUtil { func getVerifyContext(requestId: RPCID, domain: String) -> VerifyContext { - (try? verifyContextStore.get(key: requestId.string)) ?? verifyClient.createVerifyContext(origin: nil, domain: domain, isScam: false, isVerified: nil) + guard let context = try? verifyContextStore.get(key: requestId.string) else { + return verifyClient.createVerifyContext(origin: nil, domain: domain, isScam: false, isVerified: nil) + } + return context } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift index a3a5bbb7a..d8e4372b6 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/AuthRequestSubscriber.swift @@ -54,7 +54,6 @@ class AuthRequestSubscriber { let request = AuthenticationRequest(id: payload.id, topic: payload.topic, payload: payload.request.authPayload, requester: payload.request.requester.metadata) Task(priority: .high) { - let assertionId = payload.decryptedPayload.sha256().toHexString() do { let response: VerifyResponse if let attestation = payload.attestation, diff --git a/Sources/WalletConnectVerify/PublicKeyFetcher.swift b/Sources/WalletConnectVerify/PublicKeyFetcher.swift index bbacc7e6f..b178673b2 100644 --- a/Sources/WalletConnectVerify/PublicKeyFetcher.swift +++ b/Sources/WalletConnectVerify/PublicKeyFetcher.swift @@ -58,26 +58,44 @@ struct VerifyServerPublicKey: Codable { class PublicKeyFetcher: PublicKeyFetching { + enum Errors: Error, LocalizedError { + case invalidURL + case httpError(statusCode: Int, message: String) + case decodingError(Error) + } private let urlString = "https://verify.walletconnect.org/v2/public-key" + func fetchPublicKey() async throws -> VerifyServerPublicKey { guard let url = URL(string: urlString) else { - throw NSError(domain: "", code: 0, userInfo: [NSLocalizedDescriptionKey: "Invalid URL"]) + throw Errors.invalidURL } let (data, response) = try await URLSession.shared.data(from: url) if let httpResponse = response as? HTTPURLResponse, !(200...299).contains(httpResponse.statusCode) { let errorMessage = String(data: data, encoding: .utf8) ?? "Unknown error" - throw NSError(domain: "", code: httpResponse.statusCode, userInfo: [NSLocalizedDescriptionKey: errorMessage]) + throw Errors.httpError(statusCode: httpResponse.statusCode, message: errorMessage) } do { let publicKeyResponse = try JSONDecoder().decode(VerifyServerPublicKey.self, from: data) return publicKeyResponse } catch { - print("Decoding error: \(error)") - throw NSError(domain: "", code: 0, userInfo: [NSLocalizedDescriptionKey: "Failed to decode JSON"]) + throw Errors.decodingError(error) + } + } +} + +extension PublicKeyFetcher.Errors { + var errorDescription: String? { + switch self { + case .invalidURL: + return "The URL provided is invalid." + case .httpError(let statusCode, let message): + return "HTTP Error \(statusCode): \(message)" + case .decodingError: + return "Failed to decode the JSON response." } } } diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift index e1326ca09..629973e38 100644 --- a/Sources/WalletConnectVerify/VerifyContextFactory.swift +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -19,7 +19,6 @@ class VerifyContextFactory { ) } - // Existing behavior for origin and domain validation if let origin, let originUrl = URL(string: origin), let domainUrl = URL(string: domain) { return VerifyContext( origin: origin, From 83c7c63d5d2e92aab51df0e86213f378770b6c5b Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Aug 2024 06:53:48 +0200 Subject: [PATCH 703/814] savepoint --- Sources/WalletConnectJWT/JWTValidator.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectJWT/JWTValidator.swift b/Sources/WalletConnectJWT/JWTValidator.swift index 7dc300db5..e328c9cec 100644 --- a/Sources/WalletConnectJWT/JWTValidator.swift +++ b/Sources/WalletConnectJWT/JWTValidator.swift @@ -29,7 +29,7 @@ public struct JWTValidator { public struct P256JWTValidator { - let jwtString: String + private let jwtString: String public init(jwtString: String) { self.jwtString = jwtString From 8d228bcd3a5132fcada87298a444fb5939ea9757 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Aug 2024 06:55:04 +0200 Subject: [PATCH 704/814] savepoint --- Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift index f460252ce..5002ceff4 100644 --- a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift @@ -45,7 +45,7 @@ class WalletRequestSubscriber { let assertionId = payload.decryptedPayload.sha256().toHexString() do { let response = try await verifyClient.verify(.v1(assertionId: assertionId)) - let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.payloadParams.domain, isScam: response.isScam) + let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.payloadParams.domain, isScam: response.isScam, isVerified: nil) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) } catch { From 4d8f292a1b9ae8d979de6e7308ad05f99951d421 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Aug 2024 06:59:10 +0200 Subject: [PATCH 705/814] fix unit tests --- Tests/WalletConnectSignTests/SessionEngineTests.swift | 2 -- 1 file changed, 2 deletions(-) diff --git a/Tests/WalletConnectSignTests/SessionEngineTests.swift b/Tests/WalletConnectSignTests/SessionEngineTests.swift index a27cf8807..63bff095f 100644 --- a/Tests/WalletConnectSignTests/SessionEngineTests.swift +++ b/Tests/WalletConnectSignTests/SessionEngineTests.swift @@ -30,7 +30,6 @@ final class SessionEngineTests: XCTestCase { networkingInteractor: networkingInteractor, historyService: historyService, verifyContextStore: verifyContextStore, - verifyClient: VerifyClientMock(), kms: KeyManagementServiceMock(), sessionStore: sessionStorage, logger: ConsoleLoggerMock(), @@ -75,7 +74,6 @@ final class SessionEngineTests: XCTestCase { networkingInteractor: networkingInteractor, historyService: historyService, verifyContextStore: verifyContextStore, - verifyClient: VerifyClientMock(), kms: KeyManagementServiceMock(), sessionStore: sessionStorage, logger: ConsoleLoggerMock(), From ee030b5dcc304612df6fd6082a1336e7c4178f57 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 13 Aug 2024 07:32:33 +0200 Subject: [PATCH 706/814] fix auth package issue --- Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift | 2 +- Sources/WalletConnectSign/Services/HistoryService.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift index 5002ceff4..c8697ec5d 100644 --- a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift @@ -49,7 +49,7 @@ class WalletRequestSubscriber { verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.payloadParams.domain, isScam: nil) + let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.payloadParams.domain, isScam: nil, isVerified: nil) verifyContextStore.set(verifyContext, forKey: request.id.string) onRequest?((request, verifyContext)) return diff --git a/Sources/WalletConnectSign/Services/HistoryService.swift b/Sources/WalletConnectSign/Services/HistoryService.swift index c3ac80a3a..4963b8028 100644 --- a/Sources/WalletConnectSign/Services/HistoryService.swift +++ b/Sources/WalletConnectSign/Services/HistoryService.swift @@ -110,7 +110,7 @@ final class MockHistoryService: HistoryServiceProtocol { removePendingRequestCalled(topic) } - func getSessionRequest(id: JSONRPC.RPCID) -> (request: Request, context: VerifyContext?)? { + func getSessionRequest(id: RPCID) -> (request: Request, context: VerifyContext?)? { fatalError("Unimplemented") } From 3b95e646f6699059389be5c113d8a7bb5875af52 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Tue, 13 Aug 2024 08:07:11 +0000 Subject: [PATCH 707/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index c09ac47c5..0aa2b143b 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.5"} +{"version": "1.19.6"} From 1410f8229730e70932ded6ed3b8379d96d82125d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Aug 2024 07:48:08 +0200 Subject: [PATCH 708/814] remove pairing ping --- .../xcshareddata/swiftpm/Package.resolved | 4 +-- .../WalletConnectPairing/PairingClient.swift | 7 ---- .../Common/Ping/PairingPingService.swift | 33 ------------------- 3 files changed, 2 insertions(+), 42 deletions(-) delete mode 100644 Sources/WalletConnectPairing/Services/Common/Ping/PairingPingService.swift diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 53859947e..c0ec1ea81 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -186,8 +186,8 @@ "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { "branch": null, - "revision": "25abd7e5471f21d662400f9763948fbf97c60c97", - "version": null + "revision": "2d94ebc9065d1602ddc7eb60dab34a853afb4186", + "version": "1.5.2" } } ] diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 233fcd76b..9139718b2 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -24,7 +24,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let appPairActivateService: AppPairActivationService private var pingResponsePublisherSubject = PassthroughSubject() private let logger: ConsoleLogging - private let pingService: PairingPingService private let networkingInteractor: NetworkInteracting private let pairingRequestsSubscriber: PairingRequestsSubscriber private let pairingsProvider: PairingsProvider @@ -53,7 +52,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient pairingRequestsSubscriber: PairingRequestsSubscriber, appPairActivateService: AppPairActivationService, cleanupService: PairingCleanupService, - pingService: PairingPingService, socketConnectionStatusPublisher: AnyPublisher, pairingsProvider: PairingsProvider, pairingStateProvider: PairingStateProvider @@ -70,7 +68,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient self.resubscribeService = resubscribeService self.expirationService = expirationService self.cleanupService = cleanupService - self.pingService = pingService self.pairingRequestsSubscriber = pairingRequestsSubscriber self.pairingsProvider = pairingsProvider self.pairingStateProvider = pairingStateProvider @@ -124,10 +121,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient try pairingsProvider.getPairing(for: topic) } - public func ping(topic: String) async throws { - try await pingService.ping(topic: topic) - } - public func disconnect(topic: String) async { await pairingDeleteRequester.delete(topic: topic) } diff --git a/Sources/WalletConnectPairing/Services/Common/Ping/PairingPingService.swift b/Sources/WalletConnectPairing/Services/Common/Ping/PairingPingService.swift deleted file mode 100644 index e1250bd5a..000000000 --- a/Sources/WalletConnectPairing/Services/Common/Ping/PairingPingService.swift +++ /dev/null @@ -1,33 +0,0 @@ -import Foundation - -public class PairingPingService { - private let pairingStorage: WCPairingStorage - private let pingRequester: PingRequester - private let pingResponder: PingResponder - private let pingResponseSubscriber: PingResponseSubscriber - - public var onResponse: ((String) -> Void)? { - get { - return pingResponseSubscriber.onResponse - } - set { - pingResponseSubscriber.onResponse = newValue - } - } - - public init( - pairingStorage: WCPairingStorage, - networkingInteractor: NetworkInteracting, - logger: ConsoleLogging) { - let protocolMethod = PairingProtocolMethod.ping - self.pairingStorage = pairingStorage - self.pingRequester = PingRequester(networkingInteractor: networkingInteractor, method: protocolMethod) - self.pingResponder = PingResponder(networkingInteractor: networkingInteractor, method: protocolMethod, logger: logger) - self.pingResponseSubscriber = PingResponseSubscriber(networkingInteractor: networkingInteractor, method: protocolMethod, logger: logger) - } - - public func ping(topic: String) async throws { - guard pairingStorage.hasPairing(forTopic: topic) else { return } - try await pingRequester.ping(topic: topic) - } -} From dd06d990b565d235f3ae34faa025b89596ba174d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Aug 2024 07:53:07 +0200 Subject: [PATCH 709/814] savepoint --- Example/IntegrationTests/Pairing/PairingTests.swift | 13 ------------- Sources/WalletConnectPairing/PairingClient.swift | 11 ----------- .../WalletConnectPairing/PairingClientFactory.swift | 2 -- .../WalletConnectPairing/PairingInteracting.swift | 2 -- Sources/WalletConnectSign/Sign/SignClient.swift | 6 ------ .../WalletConnectSign/Sign/SignClientFactory.swift | 2 -- 6 files changed, 36 deletions(-) diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift index 80c9e5f0a..7befae84d 100644 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ b/Example/IntegrationTests/Pairing/PairingTests.swift @@ -54,19 +54,6 @@ final class PairingTests: XCTestCase { walletPairingClient = makeClient(prefix: "🐶 Wallet: ", includeSign: false) } - func testPing() async { - let expectation = expectation(description: "expects ping response") - let uri = try! await appPairingClient.create() - try? await walletPairingClient.pair(uri: uri) - try! await walletPairingClient.ping(topic: uri.topic) - walletPairingClient.pingResponsePublisher - .sink { topic in - XCTAssertEqual(topic, uri.topic) - expectation.fulfill() - }.store(in: &publishers) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) - } - func testDisconnect() async { let expectation = expectation(description: "wallet disconnected pairing") diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 9139718b2..402a57c29 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -2,9 +2,6 @@ import Foundation import Combine public class PairingClient: PairingRegisterer, PairingInteracting, PairingClientProtocol { - public var pingResponsePublisher: AnyPublisher<(String), Never> { - pingResponsePublisherSubject.eraseToAnyPublisher() - } public var pairingDeletePublisher: AnyPublisher<(code: Int, message: String), Never> { pairingDeleteRequestSubscriber.deletePublisherSubject.eraseToAnyPublisher() } @@ -22,7 +19,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let walletPairService: WalletPairService private let appPairService: AppPairService private let appPairActivateService: AppPairActivationService - private var pingResponsePublisherSubject = PassthroughSubject() private let logger: ConsoleLogging private let networkingInteractor: NetworkInteracting private let pairingRequestsSubscriber: PairingRequestsSubscriber @@ -71,16 +67,9 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient self.pairingRequestsSubscriber = pairingRequestsSubscriber self.pairingsProvider = pairingsProvider self.pairingStateProvider = pairingStateProvider - setUpPublishers() setUpExpiration() } - private func setUpPublishers() { - pingService.onResponse = { [unowned self] topic in - pingResponsePublisherSubject.send(topic) - } - } - private func setUpExpiration() { expirationService.setupExpirationHandling() } diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 26293c3ad..560c1c204 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -33,7 +33,6 @@ public struct PairingClientFactory { let pairingsProvider = PairingsProvider(pairingStorage: pairingStore) let cleanupService = PairingCleanupService(pairingStore: pairingStore, kms: kms) let pairingDeleteRequester = PairingDeleteRequester(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) - let pingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appPairActivateService = AppPairActivationService(pairingStorage: pairingStore, logger: logger) let expirationService = ExpirationService(pairingStorage: pairingStore, networkInteractor: networkingClient, kms: kms) let resubscribeService = PairingResubscribeService(networkInteractor: networkingClient, pairingStorage: pairingStore) @@ -53,7 +52,6 @@ public struct PairingClientFactory { pairingRequestsSubscriber: pairingRequestsSubscriber, appPairActivateService: appPairActivateService, cleanupService: cleanupService, - pingService: pingService, socketConnectionStatusPublisher: networkingClient.socketConnectionStatusPublisher, pairingsProvider: pairingsProvider, pairingStateProvider: pairingStateProvider diff --git a/Sources/WalletConnectPairing/PairingInteracting.swift b/Sources/WalletConnectPairing/PairingInteracting.swift index 7db1ccd47..6fc1e30d5 100644 --- a/Sources/WalletConnectPairing/PairingInteracting.swift +++ b/Sources/WalletConnectPairing/PairingInteracting.swift @@ -9,8 +9,6 @@ public protocol PairingInteracting { func getPairing(for topic: String) throws -> Pairing - func ping(topic: String) async throws - func disconnect(topic: String) async throws #if DEBUG diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 35b7941ce..313aed58f 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -147,7 +147,6 @@ public final class SignClient: SignClientProtocol { private let sessionEngine: SessionEngine private let approveEngine: ApproveEngine private let disconnectService: DisconnectService - private let pairingPingService: PairingPingService private let sessionPingService: SessionPingService private let nonControllerSessionStateMachine: NonControllerSessionStateMachine private let controllerSessionStateMachine: ControllerSessionStateMachine @@ -203,7 +202,6 @@ public final class SignClient: SignClientProtocol { networkingClient: NetworkingInteractor, sessionEngine: SessionEngine, approveEngine: ApproveEngine, - pairingPingService: PairingPingService, sessionPingService: SessionPingService, nonControllerSessionStateMachine: NonControllerSessionStateMachine, controllerSessionStateMachine: ControllerSessionStateMachine, @@ -239,7 +237,6 @@ public final class SignClient: SignClientProtocol { self.networkingClient = networkingClient self.sessionEngine = sessionEngine self.approveEngine = approveEngine - self.pairingPingService = pairingPingService self.sessionPingService = sessionPingService self.nonControllerSessionStateMachine = nonControllerSessionStateMachine self.controllerSessionStateMachine = controllerSessionStateMachine @@ -573,9 +570,6 @@ public final class SignClient: SignClientProtocol { sessionEngine.onSessionResponse = { [unowned self] response in sessionResponsePublisherSubject.send(response) } - pairingPingService.onResponse = { [unowned self] topic in - pingResponsePublisherSubject.send(topic) - } sessionPingService.onResponse = { [unowned self] topic in pingResponsePublisherSubject.send(topic) } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 98bdb3239..dfd4f6d35 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -93,7 +93,6 @@ public struct SignClientFactory { let deleteSessionService = DeleteSessionService(networkingInteractor: networkingClient, kms: kms, sessionStore: sessionStore, logger: logger) let disconnectService = DisconnectService(deleteSessionService: deleteSessionService, sessionStorage: sessionStore) let sessionPingService = SessionPingService(sessionStorage: sessionStore, networkingInteractor: networkingClient, logger: logger) - let pairingPingService = PairingPingService(pairingStorage: pairingStore, networkingInteractor: networkingClient, logger: logger) let appProposerService = AppProposeService(metadata: metadata, networkingInteractor: networkingClient, kms: kms, logger: logger) let proposalExpiryWatcher = ProposalExpiryWatcher(proposalPayloadsStore: proposalPayloadsStore, rpcHistory: rpcHistory) let pendingProposalsProvider = PendingProposalsProvider(proposalPayloadsStore: proposalPayloadsStore, verifyContextStore: verifyContextStore) @@ -153,7 +152,6 @@ public struct SignClientFactory { networkingClient: networkingClient, sessionEngine: sessionEngine, approveEngine: approveEngine, - pairingPingService: pairingPingService, sessionPingService: sessionPingService, nonControllerSessionStateMachine: nonControllerSessionStateMachine, controllerSessionStateMachine: controllerSessionStateMachine, From ca7e74fa4b10b523fc78b665e94b8517ebed23d8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Aug 2024 09:23:14 +0200 Subject: [PATCH 710/814] savepoint --- .../ConfigurationService.swift | 1 - .../Modal/ModalInteractor.swift | 6 +- .../WalletConnectModalClient.swift | 58 ++----------------- .../WalletConnectPairing/PairingClient.swift | 15 +---- .../PairingClientFactory.swift | 4 -- .../PairingRegisterer.swift | 1 - .../App/AppPairActivationService.swift | 31 ---------- .../Delete/PairingDeleteRequester.swift | 30 ---------- .../Common/PairingStateProvider.swift | 2 +- .../Services/Wallet/WalletPairService.swift | 10 +--- .../WalletConnectPairing/Types/Pairing.swift | 4 -- .../Types/WCPairing.swift | 30 +--------- .../Services/App/AuthResponseSubscriber.swift | 2 - .../Wallet/SessionAuthenticateResponder.swift | 4 -- .../Engine/Common/ApproveEngine.swift | 32 ++++------ .../WalletConnectSign/Sign/SignClient.swift | 22 ------- .../Sign/SignClientProtocol.swift | 2 - .../SignDecryptionService.swift | 11 ---- Sources/Web3Wallet/Web3WalletClient.swift | 5 +- 19 files changed, 30 insertions(+), 240 deletions(-) delete mode 100644 Sources/WalletConnectPairing/Services/App/AppPairActivationService.swift delete mode 100644 Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift diff --git a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift index 970353746..7cd72d9db 100644 --- a/Example/WalletApp/ApplicationLayer/ConfigurationService.swift +++ b/Example/WalletApp/ApplicationLayer/ConfigurationService.swift @@ -67,7 +67,6 @@ final class ConfigurationService { Web3Wallet.instance.pairingExpirationPublisher .receive(on: DispatchQueue.main) .sink { pairing in - guard !pairing.active else { return } AlertPresenter.present(message: "Pairing has expired", type: .warning) }.store(in: &publishers) diff --git a/Sources/WalletConnectModal/Modal/ModalInteractor.swift b/Sources/WalletConnectModal/Modal/ModalInteractor.swift index fe18b4f48..acd41c5ce 100644 --- a/Sources/WalletConnectModal/Modal/ModalInteractor.swift +++ b/Sources/WalletConnectModal/Modal/ModalInteractor.swift @@ -4,7 +4,7 @@ import Foundation protocol ModalSheetInteractor { func getWallets(page: Int, entries: Int) async throws -> (Int, [Wallet]) - func createPairingAndConnect() async throws -> WalletConnectURI? + func createPairingAndConnect() async throws -> WalletConnectURI var sessionSettlePublisher: AnyPublisher { get } var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { get } @@ -34,7 +34,7 @@ final class DefaultModalSheetInteractor: ModalSheetInteractor { return (response.count, response.data.compactMap { $0 }) } - func createPairingAndConnect() async throws -> WalletConnectURI? { - try await WalletConnectModal.instance.connect(topic: nil) + func createPairingAndConnect() async throws -> WalletConnectURI { + try await WalletConnectModal.instance.connect() } } diff --git a/Sources/WalletConnectModal/WalletConnectModalClient.swift b/Sources/WalletConnectModal/WalletConnectModalClient.swift index b6a8f41be..cb16847b9 100644 --- a/Sources/WalletConnectModal/WalletConnectModalClient.swift +++ b/Sources/WalletConnectModal/WalletConnectModalClient.swift @@ -50,11 +50,11 @@ public class WalletConnectModalClient { // MARK: - Private Properties - private let signClient: SignClientProtocol + private let signClient: SignClient private let pairingClient: PairingClientProtocol & PairingInteracting & PairingRegisterer init( - signClient: SignClientProtocol, + signClient: SignClient, pairingClient: PairingClientProtocol & PairingInteracting & PairingRegisterer ) { self.signClient = signClient @@ -69,61 +69,15 @@ public class WalletConnectModalClient { /// For proposing a session to a wallet. /// Function will propose a session on existing pairing or create new one if not specified /// Namespaces from WalletConnectModal.config will be used - /// - Parameters: - /// - topic: pairing topic - public func connect( - topic: String? - ) async throws -> WalletConnectURI? { - if let topic = topic { - try pairingClient.validatePairingExistance(topic) - try await signClient.connect( - requiredNamespaces: WalletConnectModal.config.sessionParams.requiredNamespaces, - optionalNamespaces: WalletConnectModal.config.sessionParams.optionalNamespaces, - sessionProperties: WalletConnectModal.config.sessionParams.sessionProperties, - topic: topic - ) - return nil - } else { - let pairingURI = try await pairingClient.create() - try await signClient.connect( + public func connect() async throws -> WalletConnectURI { + let pairingURI = try await signClient.connect( requiredNamespaces: WalletConnectModal.config.sessionParams.requiredNamespaces, optionalNamespaces: WalletConnectModal.config.sessionParams.optionalNamespaces, - sessionProperties: WalletConnectModal.config.sessionParams.sessionProperties, - topic: pairingURI.topic + sessionProperties: WalletConnectModal.config.sessionParams.sessionProperties ) return pairingURI } - } - - /// For proposing a session to a wallet. - /// Function will propose a session on existing pairing. - /// - Parameters: - /// - requiredNamespaces: required namespaces for a session - /// - topic: pairing topic - public func connect( - requiredNamespaces: [String: ProposalNamespace], - optionalNamespaces: [String: ProposalNamespace]? = nil, - sessionProperties: [String: String]? = nil, - topic: String - ) async throws { - try await signClient.connect( - requiredNamespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: sessionProperties, - topic: topic - ) - } - - /// Ping method allows to check if peer client is online and is subscribing for given topic - /// - /// Should Error: - /// - When the session topic is not found - /// - /// - Parameters: - /// - topic: Topic of a session - public func ping(topic: String) async throws { - try await pairingClient.ping(topic: topic) - } + /// For sending JSON-RPC requests to wallet. /// - Parameters: diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 402a57c29..1f3ce81ae 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -18,12 +18,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient private let pairingStorage: WCPairingStorage private let walletPairService: WalletPairService private let appPairService: AppPairService - private let appPairActivateService: AppPairActivationService private let logger: ConsoleLogging private let networkingInteractor: NetworkInteracting private let pairingRequestsSubscriber: PairingRequestsSubscriber private let pairingsProvider: PairingsProvider - private let pairingDeleteRequester: PairingDeleteRequester private let resubscribeService: PairingResubscribeService private let expirationService: ExpirationService private let pairingDeleteRequestSubscriber: PairingDeleteRequestSubscriber @@ -41,12 +39,10 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient networkingInteractor: NetworkInteracting, logger: ConsoleLogging, walletPairService: WalletPairService, - pairingDeleteRequester: PairingDeleteRequester, pairingDeleteRequestSubscriber: PairingDeleteRequestSubscriber, resubscribeService: PairingResubscribeService, expirationService: ExpirationService, pairingRequestsSubscriber: PairingRequestsSubscriber, - appPairActivateService: AppPairActivationService, cleanupService: PairingCleanupService, socketConnectionStatusPublisher: AnyPublisher, pairingsProvider: PairingsProvider, @@ -58,9 +54,7 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient self.networkingInteractor = networkingInteractor self.socketConnectionStatusPublisher = socketConnectionStatusPublisher self.logger = logger - self.pairingDeleteRequester = pairingDeleteRequester self.pairingDeleteRequestSubscriber = pairingDeleteRequestSubscriber - self.appPairActivateService = appPairActivateService self.resubscribeService = resubscribeService self.expirationService = expirationService self.cleanupService = cleanupService @@ -89,10 +83,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient return try await appPairService.create(supportedMethods: methods) } - public func activate(pairingTopic: String, peerMetadata: AppMetadata?) { - appPairActivateService.activate(for: pairingTopic, peerMetadata: peerMetadata) - } - public func setReceived(pairingTopic: String) { guard var pairing = pairingStorage.getPairing(forTopic: pairingTopic) else { return logger.error("Pairing not found for topic: \(pairingTopic)") @@ -110,9 +100,8 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient try pairingsProvider.getPairing(for: topic) } - public func disconnect(topic: String) async { - await pairingDeleteRequester.delete(topic: topic) - } + @available(*, deprecated, message: "This method is deprecated. Pairing will disconnect automatically") + public func disconnect(topic: String) async {} public func validatePairingExistance(_ topic: String) throws { _ = try pairingsProvider.getPairing(for: topic) diff --git a/Sources/WalletConnectPairing/PairingClientFactory.swift b/Sources/WalletConnectPairing/PairingClientFactory.swift index 560c1c204..4cc01b94a 100644 --- a/Sources/WalletConnectPairing/PairingClientFactory.swift +++ b/Sources/WalletConnectPairing/PairingClientFactory.swift @@ -32,8 +32,6 @@ public struct PairingClientFactory { let pairingRequestsSubscriber = PairingRequestsSubscriber(networkingInteractor: networkingClient, pairingStorage: pairingStore, logger: logger) let pairingsProvider = PairingsProvider(pairingStorage: pairingStore) let cleanupService = PairingCleanupService(pairingStore: pairingStore, kms: kms) - let pairingDeleteRequester = PairingDeleteRequester(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) - let appPairActivateService = AppPairActivationService(pairingStorage: pairingStore, logger: logger) let expirationService = ExpirationService(pairingStorage: pairingStore, networkInteractor: networkingClient, kms: kms) let resubscribeService = PairingResubscribeService(networkInteractor: networkingClient, pairingStorage: pairingStore) let pairingDeleteRequestSubscriber = PairingDeleteRequestSubscriber(networkingInteractor: networkingClient, kms: kms, pairingStorage: pairingStore, logger: logger) @@ -45,12 +43,10 @@ public struct PairingClientFactory { networkingInteractor: networkingClient, logger: logger, walletPairService: walletPairService, - pairingDeleteRequester: pairingDeleteRequester, pairingDeleteRequestSubscriber: pairingDeleteRequestSubscriber, resubscribeService: resubscribeService, expirationService: expirationService, pairingRequestsSubscriber: pairingRequestsSubscriber, - appPairActivateService: appPairActivateService, cleanupService: cleanupService, socketConnectionStatusPublisher: networkingClient.socketConnectionStatusPublisher, pairingsProvider: pairingsProvider, diff --git a/Sources/WalletConnectPairing/PairingRegisterer.swift b/Sources/WalletConnectPairing/PairingRegisterer.swift index e09cf9a42..5e5a27642 100644 --- a/Sources/WalletConnectPairing/PairingRegisterer.swift +++ b/Sources/WalletConnectPairing/PairingRegisterer.swift @@ -6,7 +6,6 @@ public protocol PairingRegisterer { method: ProtocolMethod ) -> AnyPublisher, Never> - func activate(pairingTopic: String, peerMetadata: AppMetadata?) func setReceived(pairingTopic: String) func validatePairingExistance(_ topic: String) throws } diff --git a/Sources/WalletConnectPairing/Services/App/AppPairActivationService.swift b/Sources/WalletConnectPairing/Services/App/AppPairActivationService.swift deleted file mode 100644 index 3ce060f22..000000000 --- a/Sources/WalletConnectPairing/Services/App/AppPairActivationService.swift +++ /dev/null @@ -1,31 +0,0 @@ -import Foundation -import Combine - -final class AppPairActivationService { - enum Errors: Error { - case pairingNotFound - } - - private let pairingStorage: WCPairingStorage - private let logger: ConsoleLogging - - init(pairingStorage: WCPairingStorage, logger: ConsoleLogging) { - self.pairingStorage = pairingStorage - self.logger = logger - } - - func activate(for topic: String, peerMetadata: AppMetadata?) { - guard var pairing = pairingStorage.getPairing(forTopic: topic) else { - return logger.error("Pairing not found for topic: \(topic)") - } - - if !pairing.active { - pairing.activate() - } else { - try? pairing.updateExpiry() - } - - pairing.updatePeerMetadata(peerMetadata) - pairingStorage.setPairing(pairing) - } -} diff --git a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift b/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift deleted file mode 100644 index c8c08ba34..000000000 --- a/Sources/WalletConnectPairing/Services/Common/Delete/PairingDeleteRequester.swift +++ /dev/null @@ -1,30 +0,0 @@ -import Foundation - -class PairingDeleteRequester { - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - private let pairingStorage: WCPairingStorage - private let logger: ConsoleLogging - - init(networkingInteractor: NetworkInteracting, - kms: KeyManagementServiceProtocol, - pairingStorage: WCPairingStorage, - logger: ConsoleLogging) { - self.networkingInteractor = networkingInteractor - self.kms = kms - self.pairingStorage = pairingStorage - self.logger = logger - } - - func delete(topic: String) async { - let reason = PairingReasonCode.userDisconnected - let protocolMethod = PairingProtocolMethod.delete - let pairingDeleteParams = PairingDeleteParams(code: reason.code, message: reason.message) - logger.debug("Will delete pairing for reason: message: \(reason.message) code: \(reason.code)") - let request = RPCRequest(method: protocolMethod.method, params: pairingDeleteParams) - try? await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) - pairingStorage.delete(topic: topic) - kms.deleteSymmetricKey(for: topic) - networkingInteractor.unsubscribe(topic: topic) - } -} diff --git a/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift b/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift index ff917e33d..89ea7db8e 100644 --- a/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift +++ b/Sources/WalletConnectPairing/Services/Common/PairingStateProvider.swift @@ -23,7 +23,7 @@ class PairingStateProvider { } private func checkPairingState() { - let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.active || $0.requestReceived } + let pairingStateActive = !pairingStorage.getAll().allSatisfy { $0.requestReceived } if lastPairingState != pairingStateActive { pairingStatePublisherSubject.send(pairingStateActive) diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index c5607aa59..8fc8b43c4 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -2,7 +2,6 @@ import Foundation actor WalletPairService { enum Errors: Error { - case pairingAlreadyExist(topic: String) case networkNotConnected } @@ -71,18 +70,12 @@ extension WalletPairService { guard let pairing = pairingStorage.getPairing(forTopic: topic), pairing.requestReceived else { return false } - - if pairing.active { - eventsClient.saveEvent(PairingTraceErrorEvents.activePairingAlreadyExists) - throw Errors.pairingAlreadyExist(topic: topic) - } - + let pendingRequests = history.getPending() .compactMap { record -> RPCRequest? in (record.topic == pairing.topic) ? record.request : nil } - guard !pendingRequests.isEmpty else { return false } pendingRequests.forEach { request in eventsClient.saveEvent(PairingExecutionTraceEvents.emitSessionProposal) @@ -110,7 +103,6 @@ extension WalletPairService { extension WalletPairService.Errors: LocalizedError { var errorDescription: String? { switch self { - case .pairingAlreadyExist(let topic): return "Pairing with topic (\(topic)) is already active" case .networkNotConnected: return "Pairing failed. You seem to be offline" } } diff --git a/Sources/WalletConnectPairing/Types/Pairing.swift b/Sources/WalletConnectPairing/Types/Pairing.swift index 9edd37941..b7b783364 100644 --- a/Sources/WalletConnectPairing/Types/Pairing.swift +++ b/Sources/WalletConnectPairing/Types/Pairing.swift @@ -4,15 +4,11 @@ import Foundation */ public struct Pairing { public let topic: String - public let peer: AppMetadata? public let expiryDate: Date - public let active: Bool init(_ pairing: WCPairing) { self.topic = pairing.topic - self.peer = pairing.peerMetadata self.expiryDate = pairing.expiryDate - self.active = pairing.active } } diff --git a/Sources/WalletConnectPairing/Types/WCPairing.swift b/Sources/WalletConnectPairing/Types/WCPairing.swift index 9bd66f103..a471fa132 100644 --- a/Sources/WalletConnectPairing/Types/WCPairing.swift +++ b/Sources/WalletConnectPairing/Types/WCPairing.swift @@ -8,9 +8,7 @@ public struct WCPairing: SequenceObject { public let topic: String public let relay: RelayProtocolOptions - public private (set) var peerMetadata: AppMetadata? public private (set) var expiryDate: Date - public private (set) var active: Bool public private (set) var requestReceived: Bool public private (set) var methods: [String]? @@ -31,47 +29,25 @@ public struct WCPairing: SequenceObject { public init(uri: WalletConnectURI) { self.topic = uri.topic self.relay = uri.relay - self.active = false self.requestReceived = false self.methods = uri.methods self.expiryDate = Date(timeIntervalSince1970: TimeInterval(uri.expiryTimestamp)) } - - public mutating func activate() { - active = true - try? updateExpiry() - } public mutating func receivedRequest() { requestReceived = true } - - public mutating func updatePeerMetadata(_ metadata: AppMetadata?) { - peerMetadata = metadata - } - - public mutating func updateExpiry(_ ttl: TimeInterval = WCPairing.timeToLiveActive) throws { - let now = Self.dateInitializer() - let newExpiryDate = now.advanced(by: ttl) - let maxExpiryDate = now.advanced(by: Self.timeToLiveActive) - guard newExpiryDate > expiryDate && newExpiryDate <= maxExpiryDate else { - throw Errors.invalidUpdateExpiryValue - } - expiryDate = newExpiryDate - } } #if DEBUG extension WCPairing { - static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), isActive: Bool = true, topic: String = String.generateTopic()) -> WCPairing { - WCPairing(topic: topic, relay: RelayProtocolOptions.stub(), peerMetadata: AppMetadata.stub(), isActive: isActive, expiryDate: expiryDate) + static func stub(expiryDate: Date = Date(timeIntervalSinceNow: 10000), topic: String = String.generateTopic()) -> WCPairing { + WCPairing(topic: topic, relay: RelayProtocolOptions.stub(), expiryDate: expiryDate) } - init(topic: String, relay: RelayProtocolOptions, peerMetadata: AppMetadata, isActive: Bool = false, requestReceived: Bool = false, expiryDate: Date) { + init(topic: String, relay: RelayProtocolOptions, requestReceived: Bool = false, expiryDate: Date) { self.topic = topic self.relay = relay - self.peerMetadata = peerMetadata - self.active = isActive self.requestReceived = requestReceived self.expiryDate = expiryDate } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 602827661..6ef9839b3 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -66,7 +66,6 @@ class AuthResponseSubscriber { let transportType = getTransportTypeUpgradeIfPossible(peerMetadata: payload.response.responder.metadata, requestId: payload.id) let pairingTopic = payload.topic - pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) removeResponseTopicRecord(responseTopic: payload.topic) let requestId = payload.id @@ -100,7 +99,6 @@ class AuthResponseSubscriber { _ = getTransportTypeUpgradeIfPossible(peerMetadata: payload.response.responder.metadata, requestId: payload.id) let pairingTopic = payload.topic - pairingRegisterer.activate(pairingTopic: pairingTopic, peerMetadata: nil) removeResponseTopicRecord(responseTopic: payload.topic) let requestId = payload.id diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index 37e89a07d..8e1e399ef 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -128,10 +128,6 @@ actor SessionAuthenticateResponder { transportType: .relay, verifyContext: util.getVerifyContext(requestId: requestId, domain: sessionAuthenticateRequestParams.requester.metadata.url) ) - pairingRegisterer.activate( - pairingTopic: pairingTopic, - peerMetadata: sessionAuthenticateRequestParams.requester.metadata - ) verifyContextStore.delete(forKey: requestId.string) return session } catch { diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index fbe9a1a56..f3923f215 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -166,11 +166,6 @@ final class ApproveEngine { proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) - - pairingRegisterer.activate( - pairingTopic: payload.topic, - peerMetadata: payload.request.proposer.metadata - ) return session.publicRepresentation() } catch { eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) @@ -190,11 +185,12 @@ final class ApproveEngine { reason: reason ) - if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, - let pairing = pairingStore.getPairing(forTopic: pairingTopic), - !pairing.active { - pairingStore.delete(topic: pairingTopic) - } + // todo - delete and unsubscribe +// if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, +// let pairing = pairingStore.getPairing(forTopic: pairingTopic), +// !pairing.active { +// pairingStore.delete(topic: pairingTopic) +// } proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) @@ -343,11 +339,12 @@ private extension ApproveEngine { return logger.debug(Errors.pairingNotFound.localizedDescription) } - if !pairing.active { - kms.deleteSymmetricKey(for: pairing.topic) - networkingInteractor.unsubscribe(topic: pairing.topic) - pairingStore.delete(topic: payload.topic) - } + // todo - delete nad unsubscribe +// if !pairing.active { +// kms.deleteSymmetricKey(for: pairing.topic) +// networkingInteractor.unsubscribe(topic: pairing.topic) +// pairingStore.delete(topic: payload.topic) +// } logger.debug("Session Proposal has been rejected") kms.deletePrivateKey(for: payload.request.proposer.publicKey) @@ -457,11 +454,6 @@ private extension ApproveEngine { metadata: metadata ) - pairingRegisterer.activate( - pairingTopic: pairingTopic, - peerMetadata: params.controller.metadata - ) - let session = WCSession( topic: sessionTopic, pairingTopic: pairingTopic, diff --git a/Sources/WalletConnectSign/Sign/SignClient.swift b/Sources/WalletConnectSign/Sign/SignClient.swift index 313aed58f..7075c9373 100644 --- a/Sources/WalletConnectSign/Sign/SignClient.swift +++ b/Sources/WalletConnectSign/Sign/SignClient.swift @@ -296,28 +296,6 @@ public final class SignClient: SignClientProtocol { return pairingURI } - /// For a dApp to propose a session to a wallet. - /// Function will propose a session on existing pairing. - /// - Parameters: - /// - requiredNamespaces: required namespaces for a session - /// - topic: pairing topic - public func connect( - requiredNamespaces: [String: ProposalNamespace], - optionalNamespaces: [String: ProposalNamespace]? = nil, - sessionProperties: [String: String]? = nil, - topic: String - ) async throws { - logger.debug("Connecting Application") - try pairingClient.validatePairingExistance(topic) - try await appProposeService.propose( - pairingTopic: topic, - namespaces: requiredNamespaces, - optionalNamespaces: optionalNamespaces, - sessionProperties: sessionProperties, - relay: RelayProtocolOptions(protocol: "irn", data: nil) - ) - } - //---------------------------------------AUTH----------------------------------- /// For a dApp to propose an authenticated session to a wallet. diff --git a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift index f74e2c9c7..080843a99 100644 --- a/Sources/WalletConnectSign/Sign/SignClientProtocol.swift +++ b/Sources/WalletConnectSign/Sign/SignClientProtocol.swift @@ -18,8 +18,6 @@ public protocol SignClientProtocol { var pendingProposalsPublisher: AnyPublisher<[(proposal: Session.Proposal, context: VerifyContext?)], Never> { get } var requestExpirationPublisher: AnyPublisher { get } - func connect(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]?, sessionProperties: [String: String]?, topic: String) async throws - func request(params: Request) async throws func approve(proposalId: String, namespaces: [String: SessionNamespace], sessionProperties: [String: String]?) async throws -> Session func authenticate(_ params: AuthRequestParams, walletUniversalLink: String?) async throws -> WalletConnectURI? diff --git a/Sources/WalletConnectSign/SignDecryptionService.swift b/Sources/WalletConnectSign/SignDecryptionService.swift index a0b8f649a..9301c8517 100644 --- a/Sources/WalletConnectSign/SignDecryptionService.swift +++ b/Sources/WalletConnectSign/SignDecryptionService.swift @@ -50,7 +50,6 @@ public class SignDecryptionService { public func decryptAuthRequest(topic: String, ciphertext: String) throws -> AuthenticationRequest { let (rpcRequest, _, _): (RPCRequest, String?, Data) = try serializer.deserialize(topic: topic, codingType: .base64Encoded, envelopeString: ciphertext) - setPairingMetadata(rpcRequest: rpcRequest, topic: topic) if let params = try rpcRequest.params?.get(SessionAuthenticateRequestParams.self), let id = rpcRequest.id { let authRequest = AuthenticationRequest(id: id, topic: topic, payload: params.authPayload, requester: params.requester.metadata) @@ -63,14 +62,4 @@ public class SignDecryptionService { public func getMetadata(topic: String) -> AppMetadata? { sessionStorage.getSession(forTopic: topic)?.peerParticipant.metadata } - - private func setPairingMetadata(rpcRequest: RPCRequest, topic: String) { - guard var pairing = pairingStorage.getPairing(forTopic: topic), - pairing.peerMetadata == nil, - let peerMetadata = try? rpcRequest.params?.get(SessionAuthenticateRequestParams.self).requester.metadata - else { return } - - pairing.updatePeerMetadata(peerMetadata) - pairingStorage.setPairing(pairing) - } } diff --git a/Sources/Web3Wallet/Web3WalletClient.swift b/Sources/Web3Wallet/Web3WalletClient.swift index 84f636b92..62576d5a9 100644 --- a/Sources/Web3Wallet/Web3WalletClient.swift +++ b/Sources/Web3Wallet/Web3WalletClient.swift @@ -177,9 +177,8 @@ public class Web3WalletClient { try await pairingClient.pair(uri: uri) } - public func disconnectPairing(topic: String) async { - await pairingClient.disconnect(topic: topic) - } + @available(*, deprecated, message: "This method is deprecated. Pairing will disconnect automatically") + public func disconnectPairing(topic: String) async {} /// For a wallet and a dApp to terminate a session /// From 99b86e5cf948a4076fef6580bb0788d93759439d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Aug 2024 09:36:46 +0200 Subject: [PATCH 711/814] update integration tests --- Example/ExampleApp.xcodeproj/project.pbxproj | 12 --- .../Pairing/PairingTests.swift | 73 -------------- .../Sign/SignClientTests.swift | 94 +++++-------------- 3 files changed, 26 insertions(+), 153 deletions(-) delete mode 100644 Example/IntegrationTests/Pairing/PairingTests.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 02e8b077f..401737760 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -57,7 +57,6 @@ 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CE642027981DED00142511 /* SceneDelegate.swift */; }; 84CE642827981DF000142511 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 84CE642727981DF000142511 /* Assets.xcassets */; }; 84CE642B27981DF000142511 /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 84CE642927981DF000142511 /* LaunchScreen.storyboard */; }; - 84CEC64628D89D6B00D081A8 /* PairingTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CEC64528D89D6B00D081A8 /* PairingTests.swift */; }; 84D093EB2B4EA6CB005B1925 /* ActivityIndicatorManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */; }; 84DB38F32983CDAE00BFEE37 /* PushRegisterer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */; }; 84E6B84A29787A8000428BAF /* NotificationService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84E6B84929787A8000428BAF /* NotificationService.swift */; }; @@ -438,7 +437,6 @@ 84CE642A27981DF000142511 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; 84CE642C27981DF000142511 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; 84CE6453279FFE1100142511 /* Wallet.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = Wallet.entitlements; sourceTree = ""; }; - 84CEC64528D89D6B00D081A8 /* PairingTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PairingTests.swift; sourceTree = ""; }; 84D093EA2B4EA6CB005B1925 /* ActivityIndicatorManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActivityIndicatorManager.swift; sourceTree = ""; }; 84D72FC62B4692770057EAF3 /* DApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = DApp.entitlements; sourceTree = ""; }; 84DB38F029828A7C00BFEE37 /* WalletApp.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = WalletApp.entitlements; sourceTree = ""; }; @@ -977,14 +975,6 @@ path = DApp; sourceTree = ""; }; - 84CEC64728D8A98900D081A8 /* Pairing */ = { - isa = PBXGroup; - children = ( - 84CEC64528D89D6B00D081A8 /* PairingTests.swift */, - ); - path = Pairing; - sourceTree = ""; - }; 84D2A66728A4F5260088AE09 /* Auth */ = { isa = PBXGroup; children = ( @@ -1457,7 +1447,6 @@ children = ( 847F07FE2A25DBC700B2A5A4 /* XPlatform */, 849D7A91292E2115006A2BD4 /* Push */, - 84CEC64728D8A98900D081A8 /* Pairing */, A5E03E0A28646A8A00888481 /* Stubs */, A5E03E0928646A8100888481 /* Sign */, 84D2A66728A4F5260088AE09 /* Auth */, @@ -2396,7 +2385,6 @@ files = ( A51606F92A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, A5A0843E29D2F624000B9B17 /* DefaultCryptoProvider.swift in Sources */, - 84CEC64628D89D6B00D081A8 /* PairingTests.swift in Sources */, 767DC83528997F8E00080FA9 /* EthSendTransaction.swift in Sources */, 8439CB89293F658E00F2F2E2 /* PushMessage.swift in Sources */, A518B31428E33A6500A2CE93 /* InputConfig.swift in Sources */, diff --git a/Example/IntegrationTests/Pairing/PairingTests.swift b/Example/IntegrationTests/Pairing/PairingTests.swift deleted file mode 100644 index 7befae84d..000000000 --- a/Example/IntegrationTests/Pairing/PairingTests.swift +++ /dev/null @@ -1,73 +0,0 @@ -import Foundation -import XCTest -@testable import WalletConnectUtils -@testable import WalletConnectKMS -import WalletConnectRelay -import Combine -import WalletConnectNetworking -@testable import WalletConnectPairing -import WalletConnectSign - -final class PairingTests: XCTestCase { - - var appPairingClient: PairingClient! - var walletPairingClient: PairingClient! - - var pairingStorage: PairingStorage! - - private var publishers = [AnyCancellable]() - - func makeClient(prefix: String, includeSign: Bool = true) -> PairingClient { - let keychain = KeychainStorageMock() - let keyValueStorage = RuntimeKeyValueStorage() - - let logger = ConsoleLogger(prefix: prefix, loggingLevel: .debug) - - let relayClient = RelayClientFactory.create( - relayHost: InputConfig.relayHost, - projectId: InputConfig.projectId, - keyValueStorage: RuntimeKeyValueStorage(), - keychainStorage: keychain, - socketFactory: DefaultSocketFactory(), - networkMonitor: NetworkMonitor(), - logger: logger) - - let networkingClient = NetworkingClientFactory.create( - relayClient: relayClient, - logger: logger, - keychainStorage: keychain, - keyValueStorage: keyValueStorage) - - let pairingClient = PairingClientFactory.create( - logger: logger, - keyValueStorage: keyValueStorage, - keychainStorage: keychain, - networkingClient: networkingClient, - eventsClient: MockEventsClient()) - - - return pairingClient - } - - override func setUp() { - appPairingClient = makeClient(prefix: "🤖 Dapp: ") - walletPairingClient = makeClient(prefix: "🐶 Wallet: ", includeSign: false) - } - - func testDisconnect() async { - - let expectation = expectation(description: "wallet disconnected pairing") - - - walletPairingClient.pairingDeletePublisher.sink { _ in - expectation.fulfill() - }.store(in: &publishers) - - let uri = try! await appPairingClient.create() - - try? await walletPairingClient.pair(uri: uri) - - try! await appPairingClient.disconnect(topic: uri.topic) - wait(for: [expectation], timeout: InputConfig.defaultTimeout) - } -} diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 31f09a9e3..4575da2db 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -110,8 +110,7 @@ final class SignClientTests: XCTestCase { walletSettlementExpectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -124,8 +123,7 @@ final class SignClientTests: XCTestCase { let store = Store() let semaphore = DispatchSemaphore(value: 0) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) try await walletPairingClient.pair(uri: uri) wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in @@ -164,8 +162,7 @@ final class SignClientTests: XCTestCase { sessionDeleteExpectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [sessionDeleteExpectation], timeout: InputConfig.defaultTimeout) } @@ -194,8 +191,8 @@ final class SignClientTests: XCTestCase { expectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) @@ -247,8 +244,8 @@ final class SignClientTests: XCTestCase { responseExpectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [requestExpectation, responseExpectation], timeout: InputConfig.defaultTimeout) } @@ -292,48 +289,10 @@ final class SignClientTests: XCTestCase { expectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) - try await walletPairingClient.pair(uri: uri) - await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) - } - - func testNewSessionOnExistingPairing() async throws { - let dappSettlementExpectation = expectation(description: "Dapp settles session") - dappSettlementExpectation.expectedFulfillmentCount = 2 - let walletSettlementExpectation = expectation(description: "Wallet settles session") - walletSettlementExpectation.expectedFulfillmentCount = 2 - let requiredNamespaces = ProposalNamespace.stubRequired() - let sessionNamespaces = SessionNamespace.make(toRespond: requiredNamespaces) - var initiatedSecondSession = false - - wallet.sessionProposalPublisher.sink { [unowned self] (proposal, _) in - Task(priority: .high) { - do { - _ = try await wallet.approve(proposalId: proposal.id, namespaces: sessionNamespaces) - } catch { - XCTFail("\(error)") - } - } - }.store(in: &publishers) - dapp.sessionSettlePublisher.sink { [unowned self] _ in - dappSettlementExpectation.fulfill() - let pairingTopic = dappPairingClient.getPairings().first!.topic - if !initiatedSecondSession { - Task(priority: .high) { - _ = try! await dapp.connect(requiredNamespaces: requiredNamespaces, topic: pairingTopic) - } - initiatedSecondSession = true - } - }.store(in: &publishers) - wallet.sessionSettlePublisher.sink { _ in - walletSettlementExpectation.fulfill() - }.store(in: &publishers) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) try await walletPairingClient.pair(uri: uri) - await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) + await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } func testSuccessfulSessionUpdateNamespaces() async throws { @@ -358,8 +317,8 @@ final class SignClientTests: XCTestCase { XCTAssertEqual(namespace.values.first?.accounts.count, 2) expectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) } @@ -386,8 +345,8 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) @@ -417,8 +376,8 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) @@ -445,8 +404,8 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [expectation], timeout: InputConfig.defaultTimeout) @@ -524,8 +483,7 @@ final class SignClientTests: XCTestCase { walletSettlementExpectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) try await walletPairingClient.pair(uri: uri) await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -593,8 +551,8 @@ final class SignClientTests: XCTestCase { walletSettlementExpectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -652,8 +610,8 @@ final class SignClientTests: XCTestCase { walletSettlementExpectation.fulfill() }.store(in: &publishers) - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [dappSettlementExpectation, walletSettlementExpectation], timeout: InputConfig.defaultTimeout) } @@ -715,8 +673,8 @@ final class SignClientTests: XCTestCase { settlementFailedExpectation.fulfill() } - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [settlementFailedExpectation], timeout: InputConfig.defaultTimeout) } @@ -781,8 +739,8 @@ final class SignClientTests: XCTestCase { settlementFailedExpectation.fulfill() } - let uri = try! await dappPairingClient.create() - try await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces, topic: uri.topic) + let uri = try! await dapp.connect(requiredNamespaces: requiredNamespaces, optionalNamespaces: optionalNamespaces) + try await walletPairingClient.pair(uri: uri) await fulfillment(of: [settlementFailedExpectation], timeout: 1) } From 9210715a66480e7ec16a7af666301b165bb6e5ae Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 14 Aug 2024 10:31:13 +0200 Subject: [PATCH 712/814] remove pairing on response --- .../Engine/Common/ApproveEngine.swift | 35 +++++++++++-------- Sources/WalletConnectSign/Session.swift | 1 + 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index f3923f215..0ef8a9038 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -160,6 +160,9 @@ final class ApproveEngine { do { let session: WCSession = try await settleRequestTask sessionStore.setSession(session) + Task { + removePairing(pairingTopic: pairingTopic) + } onSessionSettle?(session.publicRepresentation()) eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionSettleSuccess) logger.debug("Session proposal response and settle request have been sent") @@ -186,15 +189,20 @@ final class ApproveEngine { ) // todo - delete and unsubscribe -// if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic, -// let pairing = pairingStore.getPairing(forTopic: pairingTopic), -// !pairing.active { -// pairingStore.delete(topic: pairingTopic) -// } + if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic { + Task { + removePairing(pairingTopic: pairingTopic) + } + } proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) + } + func removePairing(pairingTopic: String) { + pairingStore.delete(topic: pairingTopic) + networkingInteractor.unsubscribe(topic: pairingTopic) + kms.deleteSymmetricKey(for: pairingTopic) } func settle(topic: String, proposal: SessionProposal, namespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil, pairingTopic: String) async throws -> WCSession { @@ -328,6 +336,7 @@ private extension ApproveEngine { sessionTopicToProposal.set(proposal, forKey: sessionTopic) Task(priority: .high) { try await networkingInteractor.subscribe(topic: sessionTopic) + removePairing(pairingTopic: payload.topic) } } catch { return logger.debug(error.localizedDescription) @@ -335,16 +344,9 @@ private extension ApproveEngine { } func handleSessionProposeResponseError(payload: ResponseSubscriptionErrorPayload) { - guard let pairing = pairingStore.getPairing(forTopic: payload.topic) else { - return logger.debug(Errors.pairingNotFound.localizedDescription) + Task { + removePairing(pairingTopic: payload.topic) } - - // todo - delete nad unsubscribe -// if !pairing.active { -// kms.deleteSymmetricKey(for: pairing.topic) -// networkingInteractor.unsubscribe(topic: pairing.topic) -// pairingStore.delete(topic: payload.topic) -// } logger.debug("Session Proposal has been rejected") kms.deletePrivateKey(for: payload.request.proposer.publicKey) @@ -389,7 +391,10 @@ private extension ApproveEngine { proposalPayloadsStore.set(payload, forKey: proposal.proposer.publicKey) pairingRegisterer.setReceived(pairingTopic: payload.topic) - + Task { + networkingInteractor.unsubscribe(topic: payload.topic) + } + if let verifyContext = try? verifyContextStore.get(key: proposal.proposer.publicKey) { onSessionProposal?(proposal.publicRepresentation(pairingTopic: payload.topic), verifyContext) return diff --git a/Sources/WalletConnectSign/Session.swift b/Sources/WalletConnectSign/Session.swift index 06b2500f7..1277e69f6 100644 --- a/Sources/WalletConnectSign/Session.swift +++ b/Sources/WalletConnectSign/Session.swift @@ -5,6 +5,7 @@ import Foundation */ public struct Session: Codable { public let topic: String + @available(*, deprecated, message: "The pairingTopic property is deprecated.") public let pairingTopic: String public let peer: AppMetadata public let requiredNamespaces: [String: ProposalNamespace] From 50dbd36a42f34265c2194f23139dcf176da9ccf7 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 07:26:39 +0200 Subject: [PATCH 713/814] upgrade packages --- .../xcshareddata/swiftpm/Package.resolved | 14 +++++++------- .../PairingExecutionTraceEvents.swift | 1 - .../Engine/Common/ApproveEngine.swift | 3 --- 3 files changed, 7 insertions(+), 11 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index c0ec1ea81..6c7d4562a 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -6,8 +6,8 @@ "repositoryURL": "https://github.com/attaswift/BigInt.git", "state": { "branch": null, - "revision": "0ed110f7555c34ff468e72e1686e59721f2b0da6", - "version": "5.3.0" + "revision": "793a7fac0bfc318e85994bf6900652e827aef33e", + "version": "5.4.1" } }, { @@ -15,8 +15,8 @@ "repositoryURL": "https://github.com/krzyzanowskim/CryptoSwift.git", "state": { "branch": null, - "revision": "7892a123f7e8d0fe62f9f03728b17bbd4f94df5c", - "version": "1.8.1" + "revision": "678d442c6f7828def400a70ae15968aef67ef52d", + "version": "1.8.3" } }, { @@ -33,7 +33,7 @@ "repositoryURL": "https://github.com/mixpanel/mixpanel-swift", "state": { "branch": "master", - "revision": "9438b4a5f76bf2108b09f8fed1abbad8f353e1a2", + "revision": "61ce9b40817466fb1334db1d7a582fbaf616ab4c", "version": null } }, @@ -69,8 +69,8 @@ "repositoryURL": "https://github.com/getsentry/sentry-cocoa.git", "state": { "branch": null, - "revision": "38f4f70d07117b9f958a76b1bff278c2f29ffe0e", - "version": "8.21.0" + "revision": "d2ced2d961b34573ebd2ea0567a2f1408e90f0ae", + "version": "8.34.0" } }, { diff --git a/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift index bfb809dd3..5b924af0f 100644 --- a/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift @@ -20,7 +20,6 @@ public enum PairingExecutionTraceEvents: String, TraceEvent { public enum PairingTraceErrorEvents: String, ErrorEvent { case noInternetConnection = "no_internet_connection" case malformedPairingUri = "malformed_pairing_uri" - case activePairingAlreadyExists = "active_pairing_already_exists" case subscribePairingTopicFailure = "subscribe_pairing_topic_failure" case pairingExpired = "pairing_expired" case proposalExpired = "proposal_expired" diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 0ef8a9038..3d4d12204 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -391,9 +391,6 @@ private extension ApproveEngine { proposalPayloadsStore.set(payload, forKey: proposal.proposer.publicKey) pairingRegisterer.setReceived(pairingTopic: payload.topic) - Task { - networkingInteractor.unsubscribe(topic: payload.topic) - } if let verifyContext = try? verifyContextStore.get(key: proposal.proposer.publicKey) { onSessionProposal?(proposal.publicRepresentation(pairingTopic: payload.topic), verifyContext) From 67d1f514757b8360cbeff5041d1008d6975e470d Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 07:28:34 +0200 Subject: [PATCH 714/814] fix wc modal build --- Sources/WalletConnectModal/Modal/ModalViewModel.swift | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/Sources/WalletConnectModal/Modal/ModalViewModel.swift b/Sources/WalletConnectModal/Modal/ModalViewModel.swift index e78aa56e1..3a01cba3c 100644 --- a/Sources/WalletConnectModal/Modal/ModalViewModel.swift +++ b/Sources/WalletConnectModal/Modal/ModalViewModel.swift @@ -102,10 +102,7 @@ final class ModalViewModel: ObservableObject { @MainActor func createURI() async { do { - guard let wcUri = try await interactor.createPairingAndConnect() else { - toast = Toast(style: .error, message: "Failed to create pairing") - return - } + let wcUri = try await interactor.createPairingAndConnect() uri = wcUri.absoluteString deeplinkUri = wcUri.deeplinkUri } catch { From 3f8038d83b7b2e3e193e83293c3f35b9ec233f1e Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 07:52:43 +0200 Subject: [PATCH 715/814] add w3m --- Example/ExampleApp.xcodeproj/project.pbxproj | 35 +- .../xcshareddata/swiftpm/Package.resolved | 9 - Package.swift | 35 +- .../Web3Modal/Analytics/AnalyticsEvent.swift | 28 + .../Analytics/AnalyticsEventMapper.swift | 4 + .../Analytics/AnalyticsProvider.swift | 3 + .../AnalyticsEvent+ResultBuilders.swift | 17 + .../Convenience/AnalyticsEventGroup.swift | 24 + .../AnalyticsEventTrackingModifier.swift | 39 + .../Convenience/AnalyticsEventTrigger.swift | 6 + .../Analytics/Convenience/View+Track.swift | 30 + .../Analytics/Private/AnalyticsService.swift | 58 ++ .../ClickstreamAnalyticsProvider.swift | 124 ++++ .../Private/DefaultAnalyticsEventMapper.swift | 71 ++ .../Private/LoggingAnalyticsProvider.swift | 9 + .../Web3Modal/Components/AccountButton.swift | 267 +++++++ .../Web3Modal/Components/ConnectButton.swift | 49 ++ .../Components/Web3ModalButton.swift | 47 ++ .../Components/Web3ModalNetworkButton.swift | 110 +++ .../Core/BlockchainAPIInteractor.swift | 142 ++++ Sources/Web3Modal/Core/SignInteractor.swift | 48 ++ Sources/Web3Modal/Core/W3MAPIInteractor.swift | 247 +++++++ .../Web3Modal/Core/W3MJSONRPC+Coinbase.swift | 67 ++ Sources/Web3Modal/Core/W3MJSONRPC.swift | 90 +++ Sources/Web3Modal/Core/W3MResponse.swift | 15 + Sources/Web3Modal/Core/Web3Modal.swift | 348 +++++++++ Sources/Web3Modal/Core/Web3ModalClient.swift | 361 ++++++++++ Sources/Web3Modal/Extensions/Collection.swift | 2 + Sources/Web3Modal/Extensions/Sequence.swift | 29 + .../Extensions/View+RoundedCorners.swift | 96 +++ .../Web3Modal/Helpers/EnvironmentInfo.swift | 34 + Sources/Web3Modal/Models/Chain.swift | 214 ++++++ .../Models/Helpers/AccountStorage.swift | 28 + .../Models/Helpers/AsyncSemaphore.swift | 31 + .../Models/Helpers/Bundle+extension.swift | 17 + .../Models/Helpers/RecentWalletStorage.swift | 53 ++ .../Models/Helpers/Session+Stub.swift | 51 ++ Sources/Web3Modal/Models/Wallet.swift | 141 ++++ .../Web3Modal/Networking/BlockchainAPI.swift | 50 ++ .../Networking/GetWalletsResponse.swift | 16 + .../Web3Modal/Networking/Web3ModalAPI.swift | 84 +++ Sources/Web3Modal/PackageConfig.json | 3 + .../Resources/Assets.xcassets/Contents.json | 6 + .../Assets.xcassets/Mocks/Contents.json | 6 + .../MockChainImage.imageset/Contents.json | 21 + .../Mocks/MockChainImage.imageset/Polygon.png | Bin 0 -> 2543 bytes .../MockWalletImage.imageset/Contents.json | 21 + .../MockWalletImage.imageset/Rainbow.png | Bin 0 -> 8130 bytes .../imageLogo.imageset/Contents.json | 15 + .../Square Image Editor.png | Bin 0 -> 897 bytes Sources/Web3Modal/Router.swift | 65 ++ Sources/Web3Modal/Screens/AccountView.swift | 198 +++++ .../Screens/ChainSwitch/ChainSelectView.swift | 220 ++++++ .../NetworkDetail/NetworkDetailView.swift | 84 +++ .../NetworkDetailViewModel.swift | 243 +++++++ .../ChainSwitch/WhatIsNetworkView.swift | 78 ++ .../ConnectWallet/AllWalletsView.swift | 201 ++++++ .../ConnectWallet/ConnectWalletView.swift | 130 ++++ .../ConnectWallet/ConnectWithQRCode.swift | 89 +++ .../ConnectWallet/GetAWalletView.swift | 87 +++ .../Screens/ConnectWallet/QRCodeView.swift | 187 +++++ .../WalletDetail/WalletDetailView.swift | 347 +++++++++ .../WalletDetail/WalletDetailViewModel.swift | 242 +++++++ .../ConnectWallet/WhatIsWalletView.swift | 116 +++ .../Web3Modal/Sheets/ModalContainerView.swift | 105 +++ .../Sheets/Web3ModalSheetController.swift | 20 + Sources/Web3Modal/Sheets/Web3ModalView.swift | 144 ++++ .../Web3Modal/Sheets/Web3ModalViewModel.swift | 291 ++++++++ Sources/Web3Modal/Store.swift | 106 +++ Sources/Web3Modal/Web3ModalImports.swift | 5 + .../Wrappers/UIApplicationWrapper.swift | 18 + Sources/Web3ModalBackport/AsyncImage.swift | 171 +++++ Sources/Web3ModalBackport/Background.swift | 7 + Sources/Web3ModalBackport/Backport.swift | 14 + .../ContentSizeCategory.swift | 27 + Sources/Web3ModalBackport/OnChange.swift | 41 ++ Sources/Web3ModalBackport/Overlay.swift | 7 + Sources/Web3ModalBackport/ScaledMetric.swift | 80 +++ Sources/Web3ModalBackport/StateObject.swift | 63 ++ .../Components/W3MActionEntryStyle.swift | 106 +++ .../Components/W3MAvatarGradient.swift | 83 +++ .../Components/W3MButtonStyle.swift | 284 ++++++++ .../Components/W3MCardSelectButtonStyle.swift | 232 ++++++ .../Components/W3MChipButtonStyle.swift | 539 ++++++++++++++ .../Components/W3MListItemButtonStyle.swift | 224 ++++++ .../Components/W3MListSelectButtonStyle.swift | 183 +++++ .../Web3ModalUI/Components/W3MPicker.swift | 87 +++ Sources/Web3ModalUI/Components/W3MTag.swift | 99 +++ .../Web3ModalUI/Components/W3MTextField.swift | 86 +++ Sources/Web3ModalUI/Helpers/Bundle.swift | 15 + .../Helpers/Extensions/Color+extension.swift | 66 ++ .../Helpers/Extensions/Font+extension.swift | 120 ++++ .../Extensions/ImageResource_generated.swift | 675 ++++++++++++++++++ Sources/Web3ModalUI/Helpers/Radius.swift | 25 + Sources/Web3ModalUI/Helpers/Spacing.swift | 26 + .../Miscellaneous/AdaptiveStack.swift | 39 + .../Miscellaneous/Binding+extension.swift | 9 + .../Miscellaneous/DrawingProgressView.swift | 451 ++++++++++++ .../Web3ModalUI/Miscellaneous/Polygon.swift | 242 +++++++ .../Miscellaneous/Shape+extension.swift | 17 + Sources/Web3ModalUI/Miscellaneous/Toast.swift | 157 ++++ .../Web3ModalUI/Modifiers/Conditional.swift | 21 + Sources/Web3ModalUI/Modifiers/Shimmer.swift | 75 ++ .../Background100.colorset/Contents.json | 38 + .../Background125.colorset/Contents.json | 38 + .../Background150.colorset/Contents.json | 38 + .../Background175.colorset/Contents.json | 38 + .../Background200.colorset/Contents.json | 38 + .../Background225.colorset/Contents.json | 38 + .../Background250.colorset/Contents.json | 38 + .../Background275.colorset/Contents.json | 38 + .../Background300.colorset/Contents.json | 38 + .../BlackAndWhite100.colorset/Contents.json | 38 + .../Colors/Blue080.colorset/Contents.json | 38 + .../Colors/Blue090.colorset/Contents.json | 38 + .../Colors/Blue100.colorset/Contents.json | 38 + .../Assets.xcassets/Colors/Contents.json | 6 + .../Colors/Error100.colorset/Contents.json | 38 + .../Foreground100.colorset/Contents.json | 38 + .../Foreground125.colorset/Contents.json | 38 + .../Foreground150.colorset/Contents.json | 38 + .../Foreground175.colorset/Contents.json | 38 + .../Foreground200.colorset/Contents.json | 38 + .../Foreground225.colorset/Contents.json | 38 + .../Foreground250.colorset/Contents.json | 38 + .../Foreground275.colorset/Contents.json | 38 + .../Foreground300.colorset/Contents.json | 38 + .../Colors/Glass75.colorset/Contents.json | 38 + .../Colors/Glass88.colorset/Contents.json | 38 + .../GrayGlass002.colorset/Contents.json | 38 + .../GrayGlass005.colorset/Contents.json | 38 + .../GrayGlass010.colorset/Contents.json | 38 + .../GrayGlass020.colorset/Contents.json | 38 + .../Colors/Grey18.colorset/Contents.json | 20 + .../Colors/Grey20.colorset/Contents.json | 20 + .../Colors/Grey22.colorset/Contents.json | 20 + .../Colors/Indigo100.colorset/Contents.json | 38 + .../Colors/Inverse000.colorset/Contents.json | 38 + .../Colors/Inverse100.colorset/Contents.json | 38 + .../Colors/Magenta100.colorset/Contents.json | 38 + .../Colors/Orange100.colorset/Contents.json | 38 + .../Colors/Overblue002.colorset/Contents.json | 38 + .../Colors/Overblue005.colorset/Contents.json | 38 + .../Colors/Overblue010.colorset/Contents.json | 38 + .../Colors/Overblue015.colorset/Contents.json | 38 + .../Colors/Overblue020.colorset/Contents.json | 38 + .../Colors/Overblue080.colorset/Contents.json | 38 + .../Colors/Overblue090.colorset/Contents.json | 38 + .../Colors/Overgray001.colorset/Contents.json | 38 + .../Colors/Overgray002.colorset/Contents.json | 38 + .../Colors/Overgray005.colorset/Contents.json | 38 + .../Colors/Overgray010.colorset/Contents.json | 38 + .../Colors/Overgray015.colorset/Contents.json | 38 + .../Colors/Overgray020.colorset/Contents.json | 38 + .../Colors/Overgray025.colorset/Contents.json | 38 + .../Colors/Overgray030.colorset/Contents.json | 38 + .../Colors/Purple100.colorset/Contents.json | 38 + .../Colors/Success100.colorset/Contents.json | 38 + .../Colors/Teal100.colorset/Contents.json | 38 + .../Colors/Yellow100.colorset/Contents.json | 38 + .../Resources/Assets.xcassets/Contents.json | 6 + .../Arrow Bottom.imageset/Arrow Bottom.pdf | Bin 0 -> 1316 bytes .../Bold/Arrow Bottom.imageset/Contents.json | 15 + .../Bold/Arrow Left.imageset/Arrow Left.pdf | Bin 0 -> 1314 bytes .../Bold/Arrow Left.imageset/Contents.json | 15 + .../Bold/Arrow Right.imageset/Arrow Right.pdf | Bin 0 -> 1309 bytes .../Bold/Arrow Right.imageset/Contents.json | 15 + .../Bold/Arrow Top.imageset/Arrow Top.pdf | Bin 0 -> 1310 bytes .../Bold/Arrow Top.imageset/Contents.json | 15 + .../Icons/Bold/Bars.imageset/Bars.pdf | Bin 0 -> 4152 bytes .../Icons/Bold/Bars.imageset/Contents.json | 15 + .../Icons/Bold/Bin.imageset/Bin.pdf | Bin 0 -> 2660 bytes .../Icons/Bold/Bin.imageset/Contents.json | 15 + .../Icons/Bold/Browser.imageset/Browser.pdf | Bin 0 -> 4751 bytes .../Icons/Bold/Browser.imageset/Contents.json | 15 + .../Bold/Checkmark.imageset/Checkmark.pdf | Bin 0 -> 1219 bytes .../Bold/Checkmark.imageset/Contents.json | 15 + .../Chevron Bottom.pdf | Bin 0 -> 1158 bytes .../Chevron Bottom.imageset/Contents.json | 15 + .../Chevron Left.imageset/Chevron Left.pdf | Bin 0 -> 1157 bytes .../Bold/Chevron Left.imageset/Contents.json | 15 + .../Chevron Right.imageset/Chevron Right.pdf | Bin 0 -> 1161 bytes .../Bold/Chevron Right.imageset/Contents.json | 15 + .../Bold/Chevron Top.imageset/Chevron Top.pdf | Bin 0 -> 1211 bytes .../Bold/Chevron Top.imageset/Contents.json | 15 + .../Icons/Bold/Clock.imageset/Clock.pdf | Bin 0 -> 1668 bytes .../Icons/Bold/Clock.imageset/Contents.json | 15 + .../Icons/Bold/Code.imageset/Code.pdf | Bin 0 -> 1951 bytes .../Icons/Bold/Code.imageset/Contents.json | 15 + .../Icons/Bold/Compass.imageset/Compass.pdf | Bin 0 -> 1819 bytes .../Icons/Bold/Compass.imageset/Contents.json | 15 + .../Assets.xcassets/Icons/Bold/Contents.json | 9 + .../Icons/Bold/Copy.imageset/Contents.json | 15 + .../Icons/Bold/Copy.imageset/Copy.pdf | Bin 0 -> 5065 bytes .../Icons/Bold/Desktop.imageset/Contents.json | 15 + .../Icons/Bold/Desktop.imageset/Desktop.pdf | Bin 0 -> 3049 bytes .../Bold/Disconnect.imageset/Contents.json | 15 + .../Bold/Disconnect.imageset/Disconnect.pdf | Bin 0 -> 2927 bytes .../Icons/Bold/Doc.imageset/Contents.json | 15 + .../Icons/Bold/Doc.imageset/Doc.pdf | Bin 0 -> 3964 bytes .../Contents.json | 15 + .../Double Chevron Vertical.pdf | Bin 0 -> 1655 bytes .../Bold/External Link.imageset/Contents.json | 15 + .../External Link.imageset/External Link.pdf | Bin 0 -> 1306 bytes .../Bold/Eye Crossed.imageset/Contents.json | 15 + .../Bold/Eye Crossed.imageset/Eye Crossed.pdf | Bin 0 -> 4218 bytes .../Icons/Bold/Eye.imageset/Contents.json | 15 + .../Icons/Bold/Eye.imageset/Eye.pdf | Bin 0 -> 3845 bytes .../Icons/Bold/Filters.imageset/Contents.json | 15 + .../Icons/Bold/Filters.imageset/Filters.pdf | Bin 0 -> 1648 bytes .../Icons/Bold/Image.imageset/Contents.json | 15 + .../Icons/Bold/Image.imageset/Image.pdf | Bin 0 -> 4933 bytes .../Icons/Bold/Info.imageset/Contents.json | 15 + .../Icons/Bold/Info.imageset/Info.pdf | Bin 0 -> 2032 bytes .../Bold/Light Bulb.imageset/Contents.json | 15 + .../Bold/Light Bulb.imageset/Light Bulb.pdf | Bin 0 -> 3699 bytes .../Icons/Bold/Link.imageset/Contents.json | 15 + .../Icons/Bold/Link.imageset/Link.pdf | Bin 0 -> 2182 bytes .../Icons/Bold/Mail.imageset/Contents.json | 15 + .../Icons/Bold/Mail.imageset/Mail.pdf | Bin 0 -> 8118 bytes .../Icons/Bold/Mobile.imageset/Contents.json | 15 + .../Icons/Bold/Mobile.imageset/Mobile.pdf | Bin 0 -> 1795 bytes .../Icons/Bold/Moon.imageset/Contents.json | 15 + .../Icons/Bold/Moon.imageset/Moon.pdf | Bin 0 -> 1736 bytes .../Icons/Bold/Network.imageset/Contents.json | 15 + .../Icons/Bold/Network.imageset/Network.pdf | Bin 0 -> 6495 bytes .../Icons/Bold/Nut.imageset/Contents.json | 15 + .../Icons/Bold/Nut.imageset/Nut.pdf | Bin 0 -> 3745 bytes .../Icons/Bold/Off.imageset/Contents.json | 15 + .../Icons/Bold/Off.imageset/Off.pdf | Bin 0 -> 1782 bytes .../Icons/Bold/Pen.imageset/Contents.json | 15 + .../Icons/Bold/Pen.imageset/Pen.pdf | Bin 0 -> 2117 bytes .../Icons/Bold/Plus.imageset/Contents.json | 15 + .../Icons/Bold/Plus.imageset/Plus.pdf | Bin 0 -> 1414 bytes .../Contents.json | 15 + .../Question Mark Circle.pdf | Bin 0 -> 2717 bytes .../Icons/Bold/Refresh.imageset/Contents.json | 15 + .../Icons/Bold/Refresh.imageset/Refresh.pdf | Bin 0 -> 1798 bytes .../Sliders Horizontal.imageset/Contents.json | 15 + .../Sliders Horizontal.pdf | Bin 0 -> 2386 bytes .../Sliders Vertical.imageset/Contents.json | 15 + .../Sliders Vertical.pdf | Bin 0 -> 2405 bytes .../Icons/Bold/Squares.imageset/Contents.json | 15 + .../Icons/Bold/Squares.imageset/Squares.pdf | Bin 0 -> 7497 bytes .../Icons/Bold/Sun.imageset/Contents.json | 15 + .../Icons/Bold/Sun.imageset/Sun.pdf | Bin 0 -> 3635 bytes .../Swap Horizontal.imageset/Contents.json | 15 + .../Swap Horizontal.pdf | Bin 0 -> 1854 bytes .../Bold/Swap Vertical.imageset/Contents.json | 15 + .../Swap Vertical.imageset/Swap Vertical.pdf | Bin 0 -> 1909 bytes .../Icons/Bold/Users.imageset/Contents.json | 15 + .../Icons/Bold/Users.imageset/Users.pdf | Bin 0 -> 6618 bytes .../Icons/Bold/Wallet.imageset/Contents.json | 15 + .../Icons/Bold/Wallet.imageset/Wallet.pdf | Bin 0 -> 2008 bytes .../Warning Circle.imageset/Contents.json | 15 + .../Warning Circle.pdf | Bin 0 -> 2283 bytes .../Icons/Bold/Web.imageset/Contents.json | 15 + .../Icons/Bold/Web.imageset/Web.pdf | Bin 0 -> 2697 bytes .../Icons/Bold/X Mark.imageset/Contents.json | 15 + .../Icons/Bold/X Mark.imageset/X Mark.pdf | Bin 0 -> 1421 bytes .../Assets.xcassets/Icons/Contents.json | 6 + .../Icons/Error.imageset/Contents.json | 22 + .../Icons/Error.imageset/error.pdf | Bin 0 -> 1807 bytes .../Icons/Error.imageset/error_light.pdf | Bin 0 -> 1807 bytes .../Icons/Medium/Android.imageset/Android.pdf | Bin 0 -> 2369 bytes .../Medium/Android.imageset/Contents.json | 15 + .../Icons/Medium/App.imageset/App.pdf | Bin 0 -> 3354 bytes .../Icons/Medium/App.imageset/Contents.json | 15 + .../Medium/Arrow Left.imageset/Arrow Left.pdf | Bin 0 -> 1317 bytes .../Medium/Arrow Left.imageset/Contents.json | 15 + .../Arrow Right.imageset/Arrow Right.pdf | Bin 0 -> 1314 bytes .../Medium/Arrow Right.imageset/Contents.json | 15 + .../Icons/Medium/Auth.imageset/Auth.pdf | Bin 0 -> 2015 bytes .../Icons/Medium/Auth.imageset/Contents.json | 15 + .../Icons/Medium/Bell.imageset/Bell.pdf | Bin 0 -> 4511 bytes .../Icons/Medium/Bell.imageset/Contents.json | 15 + .../Icons/Medium/Bin.imageset/Bin.pdf | Bin 0 -> 2831 bytes .../Icons/Medium/Bin.imageset/Contents.json | 15 + .../Medium/Checkmark.imageset/Checkmark.pdf | Bin 0 -> 1222 bytes .../Medium/Checkmark.imageset/Contents.json | 15 + .../Chevron Bottom.pdf | Bin 0 -> 1158 bytes .../Chevron Bottom.imageset/Contents.json | 15 + .../Chevron Left.imageset/Chevron Left.pdf | Bin 0 -> 1157 bytes .../Chevron Left.imageset/Contents.json | 15 + .../Chevron Right.imageset/Chevron Right.pdf | Bin 0 -> 1161 bytes .../Chevron Right.imageset/Contents.json | 15 + .../Chevron Top.imageset/Chevron Top.pdf | Bin 0 -> 1157 bytes .../Medium/Chevron Top.imageset/Contents.json | 15 + .../Icons/Medium/Compass.imageset/Compass.pdf | Bin 0 -> 1832 bytes .../Medium/Compass.imageset/Contents.json | 15 + .../Icons/Medium/Contents.json | 9 + .../Icons/Medium/Copy.imageset/Contents.json | 15 + .../Icons/Medium/Copy.imageset/Copy.pdf | Bin 0 -> 5104 bytes .../Medium/Desktop.imageset/Contents.json | 15 + .../Icons/Medium/Desktop.imageset/Desktop.pdf | Bin 0 -> 3589 bytes .../Medium/Disconnect.imageset/Contents.json | 15 + .../Medium/Disconnect.imageset/Disconnect.pdf | Bin 0 -> 2845 bytes .../Icons/Medium/Doc.imageset/Contents.json | 15 + .../Icons/Medium/Doc.imageset/Doc.pdf | Bin 0 -> 11916 bytes .../Dots Horizontal.imageset/Contents.json | 15 + .../Dots Horizontal.pdf | Bin 0 -> 1715 bytes .../Dots Vertical.imageset/Contents.json | 15 + .../Dots Vertical.imageset/Dots Vertical.pdf | Bin 0 -> 1724 bytes .../Contents.json | 15 + .../Double Chevron Vertical.pdf | Bin 0 -> 1607 bytes .../Medium/Etherscan.imageset/Contents.json | 15 + .../Medium/Etherscan.imageset/Etherscan.pdf | Bin 0 -> 2377 bytes .../External Link.imageset/Contents.json | 15 + .../External Link.imageset/External Link.pdf | Bin 0 -> 1326 bytes .../Medium/Eye Crossed.imageset/Contents.json | 15 + .../Eye Crossed.imageset/Eye Crossed.pdf | Bin 0 -> 4110 bytes .../Icons/Medium/Eye.imageset/Contents.json | 15 + .../Icons/Medium/Eye.imageset/Eye.pdf | Bin 0 -> 3418 bytes .../Icons/Medium/File.imageset/Contents.json | 15 + .../Icons/Medium/File.imageset/File.pdf | Bin 0 -> 4290 bytes .../Medium/Filters.imageset/Contents.json | 15 + .../Icons/Medium/Filters.imageset/Filters.pdf | Bin 0 -> 1659 bytes .../Medium/Info Circle.imageset/Contents.json | 15 + .../Info Circle.imageset/Info Circle.pdf | Bin 0 -> 2036 bytes .../Icons/Medium/Info.imageset/Contents.json | 15 + .../Icons/Medium/Info.imageset/Info.pdf | Bin 0 -> 2037 bytes .../Medium/Light Bulb.imageset/Contents.json | 15 + .../Medium/Light Bulb.imageset/Light Bulb.pdf | Bin 0 -> 3402 bytes .../Medium/Magnifier.imageset/Contents.json | 15 + .../Medium/Magnifier.imageset/Magnifier.pdf | Bin 0 -> 1494 bytes .../Icons/Medium/Mail.imageset/Contents.json | 15 + .../Icons/Medium/Mail.imageset/Mail.pdf | Bin 0 -> 3434 bytes .../Medium/Mobile.imageset/Contents.json | 15 + .../Icons/Medium/Mobile.imageset/Mobile.pdf | Bin 0 -> 5869 bytes .../Icons/Medium/Moon.imageset/Contents.json | 15 + .../Icons/Medium/Moon.imageset/Moon.pdf | Bin 0 -> 1738 bytes .../Icons/Medium/Nut.imageset/Contents.json | 15 + .../Icons/Medium/Nut.imageset/Nut.pdf | Bin 0 -> 3774 bytes .../Icons/Medium/Off.imageset/Contents.json | 15 + .../Icons/Medium/Off.imageset/Off.pdf | Bin 0 -> 1792 bytes .../Icons/Medium/Paste.imageset/Contents.json | 15 + .../Icons/Medium/Paste.imageset/Paste.pdf | Bin 0 -> 3642 bytes .../Icons/Medium/Pen.imageset/Contents.json | 15 + .../Icons/Medium/Pen.imageset/Pen.pdf | Bin 0 -> 2432 bytes .../Icons/Medium/Plus.imageset/Contents.json | 15 + .../Icons/Medium/Plus.imageset/Plus.pdf | Bin 0 -> 1411 bytes .../Medium/QR code.imageset/Contents.json | 15 + .../Icons/Medium/QR code.imageset/QR code.pdf | Bin 0 -> 6238 bytes .../Contents.json | 15 + .../Question Mark Circle-1.pdf | Bin 0 -> 3131 bytes .../Medium/Refresh.imageset/Contents.json | 15 + .../Icons/Medium/Refresh.imageset/Refresh.pdf | Bin 0 -> 1812 bytes .../Medium/Sliders.imageset/Contents.json | 15 + .../Icons/Medium/Sliders.imageset/Sliders.pdf | Bin 0 -> 2401 bytes .../Medium/Squares.imageset/Contents.json | 15 + .../Icons/Medium/Squares.imageset/Squares.pdf | Bin 0 -> 8407 bytes .../Icons/Medium/Sun.imageset/Contents.json | 15 + .../Icons/Medium/Sun.imageset/MediumSun.pdf | Bin 0 -> 3647 bytes .../Swap Horizontal.imageset/Contents.json | 15 + .../Swap Horizontal.pdf | Bin 0 -> 1941 bytes .../Swap Vertical.imageset/Contents.json | 15 + .../Swap Vertical.imageset/Swap Vertical.pdf | Bin 0 -> 1945 bytes .../Medium/Twitter.imageset/Contents.json | 15 + .../Icons/Medium/Twitter.imageset/Twitter.pdf | Bin 0 -> 1859 bytes .../Medium/Wallet.imageset/Contents.json | 15 + .../Icons/Medium/Wallet.imageset/Wallet.pdf | Bin 0 -> 2058 bytes .../Warning Circle.imageset/Contents.json | 15 + .../Warning Circle.pdf | Bin 0 -> 2038 bytes .../Icons/Medium/Web.imageset/Contents.json | 15 + .../Icons/Medium/Web.imageset/Web.pdf | Bin 0 -> 5273 bytes .../Medium/X mark.imageset/Contents.json | 15 + .../Icons/Medium/X mark.imageset/X mark.pdf | Bin 0 -> 1425 bytes .../Icons/Medium/iOS.imageset/Contents.json | 15 + .../Icons/Medium/iOS.imageset/iOS.pdf | Bin 0 -> 2401 bytes .../Icons/Original/Add.imageset/Contents.json | 15 + .../Icons/Original/Add.imageset/iconAdd.pdf | Bin 0 -> 1634 bytes .../Original/Apple.imageset/Contents.json | 15 + .../Apple.imageset/socialIconApple.pdf | Bin 0 -> 1447 bytes .../Original/ArrowDown.imageset/Contents.json | 15 + .../ArrowDown.imageset/iconArrowDown.pdf | Bin 0 -> 1484 bytes .../ArrowExchange.imageset/Contents.json | 15 + .../iconArrowExchange.pdf | Bin 0 -> 2202 bytes .../Original/ArrowLeft.imageset/Contents.json | 15 + .../ArrowLeft.imageset/iconArrowLeft.pdf | Bin 0 -> 1483 bytes .../ArrowRight.imageset/Contents.json | 15 + .../ArrowRight.imageset/iconArrowRight.pdf | Bin 0 -> 1490 bytes .../Original/ArrowUp.imageset/Contents.json | 15 + .../Original/ArrowUp.imageset/iconArrowUp.pdf | Bin 0 -> 1491 bytes .../BackwardChevron.imageset/Contents.json | 15 + .../iconBackwardChevron.pdf | Bin 0 -> 1213 bytes .../Original/Checkmark.imageset/Contents.json | 15 + .../Checkmark.imageset/iconCheckmark.pdf | Bin 0 -> 1223 bytes .../Original/Compass.imageset/Compass.pdf | Bin 0 -> 1846 bytes .../Original/Compass.imageset/Contents.json | 15 + .../Icons/Original/Contents.json | 9 + .../Original/Desktop.imageset/Contents.json | 15 + .../Original/Desktop.imageset/iconDesktop.pdf | Bin 0 -> 3246 bytes .../Disconnect.imageset/Contents.json | 15 + .../Disconnect.imageset/iconDisconnect.pdf | Bin 0 -> 2841 bytes .../Original/Discord.imageset/Contents.json | 15 + .../Discord.imageset/socialIconDiscord.pdf | Bin 0 -> 2675 bytes .../DownwardChevron.imageset/Contents.json | 15 + .../iconDownwardChevron.pdf | Bin 0 -> 1211 bytes .../Original/Error.imageset/Contents.json | 22 + .../Icons/Original/Error.imageset/error.pdf | Bin 0 -> 1807 bytes .../Original/Error.imageset/error_light.pdf | Bin 0 -> 1807 bytes .../Original/Extension.imageset/Contents.json | 15 + .../Extension.imageset/iconExtension.pdf | Bin 0 -> 16604 bytes .../ExternalLink.imageset/Contents.json | 15 + .../iconExternalLink.pdf | Bin 0 -> 1427 bytes .../Original/Facebook.imageset/Contents.json | 15 + .../Facebook.imageset/socialIconFacebook.pdf | Bin 0 -> 1193 bytes .../ForwardChevron.imageset/Contents.json | 15 + .../iconForwardChevron.pdf | Bin 0 -> 1213 bytes .../Original/Github.imageset/Contents.json | 15 + .../Github.imageset/socialIconGithub.pdf | Bin 0 -> 2163 bytes .../Original/Google.imageset/Contents.json | 15 + .../Google.imageset/socialIconGoogle.pdf | Bin 0 -> 2272 bytes .../Original/Help.imageset/Contents.json | 15 + .../Icons/Original/Help.imageset/iconHelp.pdf | Bin 0 -> 1879 bytes .../Original/HelpSmall.imageset/Contents.json | 15 + .../HelpSmall.imageset/iconHelpSmall.pdf | Bin 0 -> 1972 bytes .../Original/History.imageset/Contents.json | 15 + .../Original/History.imageset/iconHistory.pdf | Bin 0 -> 1869 bytes .../LargeBackward.imageset/Contents.json | 15 + .../iconLargeBackward.pdf | Bin 0 -> 1215 bytes .../LargeClose.imageset/Contents.json | 15 + .../LargeClose.imageset/iconLargeClose.pdf | Bin 0 -> 1429 bytes .../Original/LargeCopy.imageset/Contents.json | 15 + .../LargeCopy.imageset/iconLargeCopy.pdf | Bin 0 -> 4296 bytes .../LargeDesktop.imageset/Contents.json | 15 + .../iconLargeDesktop.pdf | Bin 0 -> 3762 bytes .../LargeEmail.imageset/Contents.json | 15 + .../LargeEmail.imageset/iconLargeEmail.pdf | Bin 0 -> 3575 bytes .../LargeEmoji.imageset/Contents.json | 15 + .../LargeEmoji.imageset/iconLargeEmoji.pdf | Bin 0 -> 5295 bytes .../Original/LargeMoon.imageset/Contents.json | 15 + .../LargeMoon.imageset/iconLargeMoon.pdf | Bin 0 -> 1747 bytes .../LargePhone.imageset/Contents.json | 15 + .../LargePhone.imageset/iconLargePhone.pdf | Bin 0 -> 3604 bytes .../LargeQrcode.imageset/Contents.json | 15 + .../LargeQrcode.imageset/iconLargeQrcode.pdf | Bin 0 -> 7870 bytes .../Original/LargeSun.imageset/Contents.json | 15 + .../LargeSun.imageset/iconLargeSun.pdf | Bin 0 -> 5362 bytes .../LargeTwitter.imageset/Contents.json | 15 + .../LargeTwitter.imageset/iconTwitter.pdf | Bin 0 -> 1859 bytes .../Original/Mail.imageset/Contents.json | 15 + .../Icons/Original/Mail.imageset/iconMail.pdf | Bin 0 -> 3551 bytes .../Icons/Original/Off.imageset/Contents.json | 15 + .../Icons/Original/Off.imageset/iconOff.pdf | Bin 0 -> 1785 bytes .../Icons/Original/Pen.imageset/Contents.json | 15 + .../Icons/Original/Pen.imageset/iconPen.pdf | Bin 0 -> 2433 bytes .../Original/Phone.imageset/Contents.json | 15 + .../Original/Phone.imageset/iconPhone.pdf | Bin 0 -> 3095 bytes .../Original/Popular.imageset/Contents.json | 15 + .../Original/Popular.imageset/iconPopular.pdf | Bin 0 -> 4635 bytes .../Original/Qrcode.imageset/Contents.json | 15 + .../Original/Qrcode.imageset/iconQrcode.pdf | Bin 0 -> 7135 bytes .../QuestionMarkCircle.imageset/Contents.json | 15 + .../Question Mark Circle.pdf | Bin 0 -> 2666 bytes .../Original/Recent.imageset/Contents.json | 15 + .../Original/Recent.imageset/iconRecent.pdf | Bin 0 -> 1829 bytes .../Original/Retry.imageset/Contents.json | 15 + .../Original/Retry.imageset/iconRetry.pdf | Bin 0 -> 1769 bytes .../Original/Scan.imageset/Contents.json | 15 + .../Icons/Original/Scan.imageset/iconScan.pdf | Bin 0 -> 3975 bytes .../Original/Search.imageset/Contents.json | 15 + .../Original/Search.imageset/iconSearch.pdf | Bin 0 -> 1603 bytes .../Original/Telegram.imageset/Contents.json | 15 + .../Telegram.imageset/socialIconTelegram.pdf | Bin 0 -> 3086 bytes .../ToastError.imageset/Contents.json | 22 + .../ToastError.imageset/Icon Box-2.pdf | Bin 0 -> 2679 bytes .../ToastError.imageset/Icon Boxlight-2.pdf | Bin 0 -> 2679 bytes .../Original/ToastInfo.imageset/Contents.json | 22 + .../ToastInfo.imageset/Icon Box-1.pdf | Bin 0 -> 2434 bytes .../ToastInfo.imageset/Icon Boxlight-1.pdf | Bin 0 -> 2434 bytes .../ToastSuccess.imageset/Contents.json | 22 + .../ToastSuccess.imageset/Icon Box.pdf | Bin 0 -> 1612 bytes .../ToastSuccess.imageset/Icon Boxlight.pdf | Bin 0 -> 1612 bytes .../Original/Twitch.imageset/Contents.json | 15 + .../Twitch.imageset/socialIconTwitch.pdf | Bin 0 -> 1645 bytes .../Original/Twitter.imageset/Contents.json | 15 + .../Twitter.imageset/socialIconTwitter.pdf | Bin 0 -> 1677 bytes .../UpwardChevron.imageset/Contents.json | 15 + .../iconUpwardChevron.pdf | Bin 0 -> 1211 bytes .../Original/Wallet.imageset/Contents.json | 15 + .../Icons/Original/Wallet.imageset/Wallet.pdf | Bin 0 -> 2125 bytes .../Original/Website.imageset/Contents.json | 15 + .../Original/Website.imageset/iconWebsite.pdf | Bin 0 -> 3244 bytes .../Icons/Regular/4 dots.imageset/4 dots.pdf | Bin 0 -> 2091 bytes .../Regular/4 dots.imageset/Contents.json | 15 + .../Icons/Regular/App.imageset/App.pdf | Bin 0 -> 3502 bytes .../Icons/Regular/App.imageset/Contents.json | 15 + .../Arrow Bottom.imageset/Arrow Bottom.pdf | Bin 0 -> 1317 bytes .../Arrow Bottom.imageset/Contents.json | 15 + .../Icons/Regular/Bars.imageset/Bars.pdf | Bin 0 -> 4757 bytes .../Icons/Regular/Bars.imageset/Contents.json | 15 + .../Icons/Regular/Bell.imageset/Bell.pdf | Bin 0 -> 4135 bytes .../Icons/Regular/Bell.imageset/Contents.json | 15 + .../Regular/Browser.imageset/Browser.pdf | Bin 0 -> 5500 bytes .../Regular/Browser.imageset/Contents.json | 15 + .../Icons/Regular/Chart.imageset/Chart.pdf | Bin 0 -> 1656 bytes .../Regular/Chart.imageset/Contents.json | 15 + .../Chat Bubble.imageset/Chat Bubble.pdf | Bin 0 -> 3051 bytes .../Chat Bubble.imageset/Contents.json | 15 + .../Check Circle.imageset/Check Circle.pdf | Bin 0 -> 1737 bytes .../Check Circle.imageset/Contents.json | 15 + .../Regular/Checkmark.imageset/Checkmark.pdf | Bin 0 -> 1222 bytes .../Regular/Checkmark.imageset/Contents.json | 15 + .../Chevron Left.imageset/Chevron Left.pdf | Bin 0 -> 1211 bytes .../Chevron Left.imageset/Contents.json | 15 + .../Icons/Regular/Code.imageset/Code.pdf | Bin 0 -> 1982 bytes .../Icons/Regular/Code.imageset/Contents.json | 15 + .../Icons/Regular/Coin.imageset/Coin.pdf | Bin 0 -> 2057 bytes .../Icons/Regular/Coin.imageset/Contents.json | 15 + .../Regular/Compass.imageset/Compass.pdf | Bin 0 -> 1846 bytes .../Regular/Compass.imageset/Contents.json | 15 + .../Icons/Regular/Contents.json | 9 + .../Icons/Regular/Copy.imageset/Contents.json | 15 + .../Icons/Regular/Copy.imageset/Copy.pdf | Bin 0 -> 5285 bytes .../Regular/Desktop.imageset/Contents.json | 15 + .../Regular/Desktop.imageset/Desktop.pdf | Bin 0 -> 3751 bytes .../Contents.json | 15 + .../Double Chevron Right.pdf | Bin 0 -> 1673 bytes .../Regular/Extension.imageset/Browser-1.pdf | Bin 0 -> 5302 bytes .../Regular/Extension.imageset/Contents.json | 15 + .../External Link.imageset/Contents.json | 15 + .../External Link.imageset/External Link.pdf | Bin 0 -> 1329 bytes .../Eye Crossed.imageset/Contents.json | 15 + .../Eye Crossed.imageset/Eye Crossed.pdf | Bin 0 -> 4403 bytes .../Icons/Regular/Eye.imageset/Contents.json | 15 + .../Icons/Regular/Eye.imageset/Eye.pdf | Bin 0 -> 3906 bytes .../Regular/Filters.imageset/Contents.json | 15 + .../Regular/Filters.imageset/Filters.pdf | Bin 0 -> 1661 bytes .../Fingerprint.imageset/Contents.json | 15 + .../Fingerprint.imageset/Fingerprint.pdf | Bin 0 -> 4485 bytes .../Regular/Image.imageset/Contents.json | 15 + .../Icons/Regular/Image.imageset/Image.pdf | Bin 0 -> 5419 bytes .../Icons/Regular/Info.imageset/Contents.json | 15 + .../Icons/Regular/Info.imageset/Info.pdf | Bin 0 -> 2050 bytes .../Icons/Regular/Link.imageset/Contents.json | 15 + .../Icons/Regular/Link.imageset/Link.pdf | Bin 0 -> 2228 bytes .../Icons/Regular/Load.imageset/Contents.json | 15 + .../Icons/Regular/Load.imageset/Load.pdf | Bin 0 -> 2592 bytes .../Regular/Locker.imageset/Contents.json | 15 + .../Icons/Regular/Locker.imageset/Locker.pdf | Bin 0 -> 3487 bytes .../Regular/Magnifier.imageset/Contents.json | 15 + .../Magnifier.imageset/Magnifier-1.pdf | Bin 0 -> 1499 bytes .../Icons/Regular/Mail.imageset/Contents.json | 15 + .../Icons/Regular/Mail.imageset/Mail.pdf | Bin 0 -> 3686 bytes .../Regular/Mobile.imageset/Contents.json | 15 + .../Icons/Regular/Mobile.imageset/Mobile.pdf | Bin 0 -> 1803 bytes .../Icons/Regular/Moon.imageset/Contents.json | 15 + .../Icons/Regular/Moon.imageset/Moon.pdf | Bin 0 -> 1748 bytes .../Regular/Network.imageset/Contents.json | 15 + .../Regular/Network.imageset/Network.pdf | Bin 0 -> 8042 bytes .../Regular/QR code.imageset/Contents.json | 15 + .../Regular/QR code.imageset/QR code.pdf | Bin 0 -> 6287 bytes .../Contents.json | 15 + .../Question Mark Circle.pdf | Bin 0 -> 2630 bytes .../Regular/Question.imageset/Contents.json | 15 + .../Regular/Question.imageset/Question.pdf | Bin 0 -> 2440 bytes .../Regular/Sliders.imageset/Contents.json | 15 + .../Regular/Sliders.imageset/Sliders.pdf | Bin 0 -> 2434 bytes .../Regular/Squares.imageset/Contents.json | 15 + .../Regular/Squares.imageset/Squares.pdf | Bin 0 -> 8451 bytes .../Icons/Regular/Sun.imageset/Contents.json | 15 + .../Icons/Regular/Sun.imageset/Sun.pdf | Bin 0 -> 3699 bytes .../Swap Horizontal.imageset/Contents.json | 15 + .../Swap Horizontal.pdf | Bin 0 -> 1953 bytes .../Regular/Verif.imageset/Contents.json | 15 + .../Icons/Regular/Verif.imageset/Verif.pdf | Bin 0 -> 3881 bytes .../Regular/Wallet.imageset/Contents.json | 15 + .../Regular/Wallet.imageset/Wallet-1.pdf | Bin 0 -> 3537 bytes .../Warning Circle.imageset/Contents.json | 15 + .../Warning Circle.pdf | Bin 0 -> 2047 bytes .../Regular/X mark.imageset/Contents.json | 15 + .../Icons/Regular/X mark.imageset/X mark.pdf | Bin 0 -> 1429 bytes .../Icons/ToastError.imageset/Contents.json | 22 + .../Icons/ToastError.imageset/Icon Box-2.pdf | Bin 0 -> 2679 bytes .../ToastError.imageset/Icon Boxlight-2.pdf | Bin 0 -> 2679 bytes .../Icons/ToastInfo.imageset/Contents.json | 22 + .../Icons/ToastInfo.imageset/Icon Box-1.pdf | Bin 0 -> 2434 bytes .../ToastInfo.imageset/Icon Boxlight-1.pdf | Bin 0 -> 2434 bytes .../Icons/ToastSuccess.imageset/Contents.json | 22 + .../Icons/ToastSuccess.imageset/Icon Box.pdf | Bin 0 -> 1612 bytes .../ToastSuccess.imageset/Icon Boxlight.pdf | Bin 0 -> 1612 bytes .../Assets.xcassets/Images/Contents.json | 6 + .../imageBrowser.imageset/Contents.json | 23 + .../imageBrowserL@1x.png | Bin 0 -> 2434 bytes .../imageBrowserL@2x.png | Bin 0 -> 4898 bytes .../imageBrowserL@3x.png | Bin 0 -> 7470 bytes .../Images/imageDao.imageset/Contents.json | 23 + .../Images/imageDao.imageset/imageDaoL@1x.png | Bin 0 -> 2311 bytes .../Images/imageDao.imageset/imageDaoL@2x.png | Bin 0 -> 4669 bytes .../Images/imageDao.imageset/imageDaoL@3x.png | Bin 0 -> 7729 bytes .../Images/imageDeFi.imageset/Contents.json | 23 + .../imageDeFi.imageset/imageDeFiL@1x.png | Bin 0 -> 2052 bytes .../imageDeFi.imageset/imageDeFiL@2x.png | Bin 0 -> 4102 bytes .../imageDeFi.imageset/imageDeFiL@3x.png | Bin 0 -> 5969 bytes .../imageDefiAlt.imageset/Contents.json | 23 + .../imageDefiAltL@1x.png | Bin 0 -> 2459 bytes .../imageDefiAltL@2x.png | Bin 0 -> 4772 bytes .../imageDefiAltL@3x.png | Bin 0 -> 7180 bytes .../Images/imageEth.imageset/Contents.json | 23 + .../Images/imageEth.imageset/imageEthL@1x.png | Bin 0 -> 2880 bytes .../Images/imageEth.imageset/imageEthL@2x.png | Bin 0 -> 5686 bytes .../Images/imageEth.imageset/imageEthL@3x.png | Bin 0 -> 8367 bytes .../Images/imageLayers.imageset/Contents.json | 23 + .../imageLayers.imageset/imageLayersL@1x.png | Bin 0 -> 1932 bytes .../imageLayers.imageset/imageLayersL@2x.png | Bin 0 -> 3196 bytes .../imageLayers.imageset/imageLayersL@3x.png | Bin 0 -> 4610 bytes .../Images/imageLock.imageset/Contents.json | 23 + .../imageLock.imageset/imageLockL@1x.png | Bin 0 -> 1357 bytes .../imageLock.imageset/imageLockL@2x.png | Bin 0 -> 2711 bytes .../imageLock.imageset/imageLockL@3x.png | Bin 0 -> 4433 bytes .../Images/imageLogin.imageset/Contents.json | 23 + .../imageLogin.imageset/imageLoginL@1x.png | Bin 0 -> 2012 bytes .../imageLogin.imageset/imageLoginL@2x.png | Bin 0 -> 3967 bytes .../imageLogin.imageset/imageLoginL@3x.png | Bin 0 -> 6067 bytes .../imageNetwork.imageset/Contents.json | 23 + .../imageNetworkL@1x.png | Bin 0 -> 3605 bytes .../imageNetworkL@2x.png | Bin 0 -> 7433 bytes .../imageNetworkL@3x.png | Bin 0 -> 11524 bytes .../Images/imageNft.imageset/Contents.json | 23 + .../Images/imageNft.imageset/imageNftL@1x.png | Bin 0 -> 1852 bytes .../Images/imageNft.imageset/imageNftL@2x.png | Bin 0 -> 3456 bytes .../Images/imageNft.imageset/imageNftL@3x.png | Bin 0 -> 5159 bytes .../Images/imageNoun.imageset/Contents.json | 23 + .../imageNoun.imageset/imageNounL@1x.png | Bin 0 -> 559 bytes .../imageNoun.imageset/imageNounL@2x.png | Bin 0 -> 865 bytes .../imageNoun.imageset/imageNounL@3x.png | Bin 0 -> 1362 bytes .../imageProfile.imageset/Contents.json | 23 + .../imageProfileL@1x.png | Bin 0 -> 2530 bytes .../imageProfileL@2x.png | Bin 0 -> 5164 bytes .../imageProfileL@3x.png | Bin 0 -> 7738 bytes .../Images/imageSystem.imageset/Contents.json | 23 + .../imageSystem.imageset/imageSystemL@1x.png | Bin 0 -> 3220 bytes .../imageSystem.imageset/imageSystemL@2x.png | Bin 0 -> 6470 bytes .../imageSystem.imageset/imageSystemL@3x.png | Bin 0 -> 9954 bytes .../Assets.xcassets/Mocks/Contents.json | 6 + .../MockChainImage.imageset/Contents.json | 21 + .../Mocks/MockChainImage.imageset/Polygon.png | Bin 0 -> 2543 bytes .../MockWalletImage.imageset/Contents.json | 21 + .../MockWalletImage.imageset/Rainbow.png | Bin 0 -> 8130 bytes .../Assets.xcassets/OptionIcon/Contents.json | 6 + .../optionAll.imageset/Contents.json | 54 ++ .../OptionIcon/optionAll.imageset/all@2x.png | Bin 0 -> 2306 bytes .../OptionIcon/optionAll.imageset/all@3x.png | Bin 0 -> 3587 bytes .../optionAll.imageset/all_dark@2x.png | Bin 0 -> 2303 bytes .../optionAll.imageset/all_dark@3x.png | Bin 0 -> 3561 bytes .../optionBrowser.imageset/Contents.json | 54 ++ .../optionBrowserThemeDarkL@2x.png | Bin 0 -> 2888 bytes .../optionBrowserThemeDarkL@3x.png | Bin 0 -> 4426 bytes .../optionBrowserThemeLightL@2x.png | Bin 0 -> 3032 bytes .../optionBrowserThemeLightL@3x.png | Bin 0 -> 4669 bytes .../optionExtension.imageset/Contents.json | 54 ++ .../optionExtensionThemeDarkL@2x.png | Bin 0 -> 2675 bytes .../optionExtensionThemeDarkL@3x.png | Bin 0 -> 4035 bytes .../optionExtensionThemeLightL@2x.png | Bin 0 -> 2795 bytes .../optionExtensionThemeLightL@3x.png | Bin 0 -> 4232 bytes .../optionQrCode.imageset/Contents.json | 54 ++ .../optionQrCodeThemeDarkL@2x.png | Bin 0 -> 2834 bytes .../optionQrCodeThemeDarkL@3x.png | Bin 0 -> 4060 bytes .../optionQrCodeThemeLightL@2x.png | Bin 0 -> 2945 bytes .../optionQrCodeThemeLightL@3x.png | Bin 0 -> 4284 bytes .../Web3ModalUI/Web3ModalImports copy.swift | 3 + .../AccountButtonSnapshotTests.swift | 13 + .../NetworkButtonSnapshotTests.swift | 13 + .../QRCodeViewSnapshotTests.swift | 13 + .../test_snapshots.1.png | Bin 0 -> 201035 bytes .../test_snapshots.2.png | Bin 0 -> 194340 bytes .../test_snapshots.1.png | Bin 0 -> 138687 bytes .../test_snapshots.2.png | Bin 0 -> 131623 bytes .../test_snapshots.1.png | Bin 0 -> 442684 bytes .../test_snapshots.2.png | Bin 0 -> 416642 bytes .../W3MActionEntrySnapshotTests.swift | 13 + .../W3MButtonSnapshotTests.swift | 13 + .../W3MCardSelectSnapshotTests.swift | 13 + .../W3MChipButtonSnapshotTests.swift | 13 + .../W3MListItemSnapshotTests.swift | 26 + .../W3MListSelectSnapshotTests.swift | 25 + .../W3MTagSnapshotTests.swift | 13 + .../W3MToastSnapshotTests .swift | 13 + .../test_snapshots.1.png | Bin 0 -> 89777 bytes .../test_snapshots.2.png | Bin 0 -> 86234 bytes .../test_snapshots.1.png | Bin 0 -> 214828 bytes .../test_snapshots.2.png | Bin 0 -> 217636 bytes .../test_snapshots.1.png | Bin 0 -> 190081 bytes .../test_snapshots.2.png | Bin 0 -> 191000 bytes .../test_snapshots.1.png | Bin 0 -> 353415 bytes .../test_snapshots.2.png | Bin 0 -> 358143 bytes .../test_snapshots.1.png | Bin 0 -> 197177 bytes .../test_snapshots.2.png | Bin 0 -> 192768 bytes .../test_snapshots.3.png | Bin 0 -> 260814 bytes .../test_snapshots.1.png | Bin 0 -> 220249 bytes .../test_snapshots.2.png | Bin 0 -> 221836 bytes .../test_snapshots.3.png | Bin 0 -> 330900 bytes .../W3MTagSnapshotTests/test_snapshots.1.png | Bin 0 -> 29199 bytes .../W3MTagSnapshotTests/test_snapshots.2.png | Bin 0 -> 30907 bytes .../test_snapshots.1.png | Bin 0 -> 51989 bytes .../test_snapshots.2.png | Bin 0 -> 106572 bytes 697 files changed, 16401 insertions(+), 37 deletions(-) create mode 100644 Sources/Web3Modal/Analytics/AnalyticsEvent.swift create mode 100644 Sources/Web3Modal/Analytics/AnalyticsEventMapper.swift create mode 100644 Sources/Web3Modal/Analytics/AnalyticsProvider.swift create mode 100644 Sources/Web3Modal/Analytics/Convenience/AnalyticsEvent+ResultBuilders.swift create mode 100644 Sources/Web3Modal/Analytics/Convenience/AnalyticsEventGroup.swift create mode 100644 Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrackingModifier.swift create mode 100644 Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrigger.swift create mode 100644 Sources/Web3Modal/Analytics/Convenience/View+Track.swift create mode 100644 Sources/Web3Modal/Analytics/Private/AnalyticsService.swift create mode 100644 Sources/Web3Modal/Analytics/Private/ClickstreamAnalyticsProvider.swift create mode 100644 Sources/Web3Modal/Analytics/Private/DefaultAnalyticsEventMapper.swift create mode 100644 Sources/Web3Modal/Analytics/Private/LoggingAnalyticsProvider.swift create mode 100644 Sources/Web3Modal/Components/AccountButton.swift create mode 100644 Sources/Web3Modal/Components/ConnectButton.swift create mode 100644 Sources/Web3Modal/Components/Web3ModalButton.swift create mode 100644 Sources/Web3Modal/Components/Web3ModalNetworkButton.swift create mode 100644 Sources/Web3Modal/Core/BlockchainAPIInteractor.swift create mode 100644 Sources/Web3Modal/Core/SignInteractor.swift create mode 100644 Sources/Web3Modal/Core/W3MAPIInteractor.swift create mode 100644 Sources/Web3Modal/Core/W3MJSONRPC+Coinbase.swift create mode 100644 Sources/Web3Modal/Core/W3MJSONRPC.swift create mode 100644 Sources/Web3Modal/Core/W3MResponse.swift create mode 100644 Sources/Web3Modal/Core/Web3Modal.swift create mode 100644 Sources/Web3Modal/Core/Web3ModalClient.swift create mode 100644 Sources/Web3Modal/Extensions/Collection.swift create mode 100644 Sources/Web3Modal/Extensions/Sequence.swift create mode 100644 Sources/Web3Modal/Extensions/View+RoundedCorners.swift create mode 100644 Sources/Web3Modal/Helpers/EnvironmentInfo.swift create mode 100644 Sources/Web3Modal/Models/Chain.swift create mode 100644 Sources/Web3Modal/Models/Helpers/AccountStorage.swift create mode 100644 Sources/Web3Modal/Models/Helpers/AsyncSemaphore.swift create mode 100644 Sources/Web3Modal/Models/Helpers/Bundle+extension.swift create mode 100644 Sources/Web3Modal/Models/Helpers/RecentWalletStorage.swift create mode 100644 Sources/Web3Modal/Models/Helpers/Session+Stub.swift create mode 100644 Sources/Web3Modal/Models/Wallet.swift create mode 100644 Sources/Web3Modal/Networking/BlockchainAPI.swift create mode 100644 Sources/Web3Modal/Networking/GetWalletsResponse.swift create mode 100644 Sources/Web3Modal/Networking/Web3ModalAPI.swift create mode 100644 Sources/Web3Modal/PackageConfig.json create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/Contents.json create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/Mocks/Contents.json create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Contents.json create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Rainbow.png create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/imageLogo.imageset/Contents.json create mode 100644 Sources/Web3Modal/Resources/Assets.xcassets/imageLogo.imageset/Square Image Editor.png create mode 100644 Sources/Web3Modal/Router.swift create mode 100644 Sources/Web3Modal/Screens/AccountView.swift create mode 100644 Sources/Web3Modal/Screens/ChainSwitch/ChainSelectView.swift create mode 100644 Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailView.swift create mode 100644 Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailViewModel.swift create mode 100644 Sources/Web3Modal/Screens/ChainSwitch/WhatIsNetworkView.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/AllWalletsView.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/ConnectWalletView.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/ConnectWithQRCode.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/GetAWalletView.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/QRCodeView.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailView.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailViewModel.swift create mode 100644 Sources/Web3Modal/Screens/ConnectWallet/WhatIsWalletView.swift create mode 100644 Sources/Web3Modal/Sheets/ModalContainerView.swift create mode 100644 Sources/Web3Modal/Sheets/Web3ModalSheetController.swift create mode 100644 Sources/Web3Modal/Sheets/Web3ModalView.swift create mode 100644 Sources/Web3Modal/Sheets/Web3ModalViewModel.swift create mode 100644 Sources/Web3Modal/Store.swift create mode 100644 Sources/Web3Modal/Web3ModalImports.swift create mode 100644 Sources/Web3Modal/Wrappers/UIApplicationWrapper.swift create mode 100644 Sources/Web3ModalBackport/AsyncImage.swift create mode 100644 Sources/Web3ModalBackport/Background.swift create mode 100644 Sources/Web3ModalBackport/Backport.swift create mode 100644 Sources/Web3ModalBackport/ContentSizeCategory.swift create mode 100644 Sources/Web3ModalBackport/OnChange.swift create mode 100644 Sources/Web3ModalBackport/Overlay.swift create mode 100644 Sources/Web3ModalBackport/ScaledMetric.swift create mode 100644 Sources/Web3ModalBackport/StateObject.swift create mode 100644 Sources/Web3ModalUI/Components/W3MActionEntryStyle.swift create mode 100644 Sources/Web3ModalUI/Components/W3MAvatarGradient.swift create mode 100644 Sources/Web3ModalUI/Components/W3MButtonStyle.swift create mode 100644 Sources/Web3ModalUI/Components/W3MCardSelectButtonStyle.swift create mode 100644 Sources/Web3ModalUI/Components/W3MChipButtonStyle.swift create mode 100644 Sources/Web3ModalUI/Components/W3MListItemButtonStyle.swift create mode 100644 Sources/Web3ModalUI/Components/W3MListSelectButtonStyle.swift create mode 100644 Sources/Web3ModalUI/Components/W3MPicker.swift create mode 100644 Sources/Web3ModalUI/Components/W3MTag.swift create mode 100644 Sources/Web3ModalUI/Components/W3MTextField.swift create mode 100644 Sources/Web3ModalUI/Helpers/Bundle.swift create mode 100644 Sources/Web3ModalUI/Helpers/Extensions/Color+extension.swift create mode 100644 Sources/Web3ModalUI/Helpers/Extensions/Font+extension.swift create mode 100644 Sources/Web3ModalUI/Helpers/Extensions/ImageResource_generated.swift create mode 100644 Sources/Web3ModalUI/Helpers/Radius.swift create mode 100644 Sources/Web3ModalUI/Helpers/Spacing.swift create mode 100644 Sources/Web3ModalUI/Miscellaneous/AdaptiveStack.swift create mode 100644 Sources/Web3ModalUI/Miscellaneous/Binding+extension.swift create mode 100644 Sources/Web3ModalUI/Miscellaneous/DrawingProgressView.swift create mode 100644 Sources/Web3ModalUI/Miscellaneous/Polygon.swift create mode 100644 Sources/Web3ModalUI/Miscellaneous/Shape+extension.swift create mode 100644 Sources/Web3ModalUI/Miscellaneous/Toast.swift create mode 100644 Sources/Web3ModalUI/Modifiers/Conditional.swift create mode 100644 Sources/Web3ModalUI/Modifiers/Shimmer.swift create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background125.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background150.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background175.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background200.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background225.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background250.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background275.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background300.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/BlackAndWhite100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue080.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue090.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Error100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground125.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground150.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground175.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground200.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground225.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground250.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground275.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground300.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass75.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass88.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass002.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass005.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass010.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass020.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey18.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey20.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey22.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Indigo100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse000.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Magenta100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Orange100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue002.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue005.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue010.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue015.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue020.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue080.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue090.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray001.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray002.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray005.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray010.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray015.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray020.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray025.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray030.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Purple100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Success100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Teal100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Yellow100.colorset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Bottom.imageset/Arrow Bottom.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Bottom.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Arrow Left.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Right.imageset/Arrow Right.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Right.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Arrow Top.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Bars.imageset/Bars.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Bars.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Bin.imageset/Bin.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Bin.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Browser.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Checkmark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Chevron Bottom.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Chevron Left.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Right.imageset/Chevron Right.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Right.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Chevron Top.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Clock.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Code.imageset/Code.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Code.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Compass.imageset/Compass.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Compass.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Copy.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Copy.imageset/Copy.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Desktop.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Desktop.imageset/Desktop.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Disconnect.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Doc.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/External Link.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Eye Crossed.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye.imageset/Eye.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Filters.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Image.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Info.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Light Bulb.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Link.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mail.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mail.imageset/Mail.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Mobile.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Moon.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Network.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Network.imageset/Network.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Nut.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Off.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Off.imageset/Off.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Pen.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Pen.imageset/Pen.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Plus.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Question Mark Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Refresh.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Sliders Horizontal.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Sliders Vertical.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Squares.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Squares.imageset/Squares.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Sun.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Horizontal.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Horizontal.imageset/Swap Horizontal.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Swap Vertical.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Users.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Wallet.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Wallet.imageset/Wallet.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Warning Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Web.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/X Mark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Error.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Error.imageset/error.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Error.imageset/error_light.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Android.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/App.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Left.imageset/Arrow Left.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Left.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Arrow Right.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Auth.imageset/Auth.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Auth.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Bell.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Bin.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Checkmark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Chevron Bottom.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Chevron Left.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Chevron Right.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Chevron Top.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Compass.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Copy.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Desktop.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Desktop.imageset/Desktop.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Disconnect.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Doc.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Dots Horizontal.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Dots Vertical.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Etherscan.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/External Link.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Eye Crossed.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Eye.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/File.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Filters.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Filters.imageset/Filters.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Info Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Info.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Light Bulb.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Magnifier.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Magnifier.imageset/Magnifier.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mail.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mail.imageset/Mail.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Mobile.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Moon.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Nut.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Nut.imageset/Nut.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Off.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Paste.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Pen.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Pen.imageset/Pen.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Plus.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/QR code.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Question Mark Circle-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Refresh.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sliders.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sliders.imageset/Sliders.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Squares.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Squares.imageset/Squares.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/MediumSun.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Horizontal.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Horizontal.imageset/Swap Horizontal.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Swap Vertical.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Twitter.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Wallet.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Warning Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Warning Circle.imageset/Warning Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Web.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/X mark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/X mark.imageset/X mark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/iOS.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/iconAdd.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/socialIconApple.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowDown.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowDown.imageset/iconArrowDown.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowExchange.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowExchange.imageset/iconArrowExchange.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowLeft.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowLeft.imageset/iconArrowLeft.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/iconArrowRight.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowUp.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowUp.imageset/iconArrowUp.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/BackwardChevron.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/BackwardChevron.imageset/iconBackwardChevron.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Checkmark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Checkmark.imageset/iconCheckmark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Compass.imageset/Compass.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Compass.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Desktop.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Desktop.imageset/iconDesktop.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Disconnect.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Disconnect.imageset/iconDisconnect.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/socialIconDiscord.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/DownwardChevron.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/DownwardChevron.imageset/iconDownwardChevron.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/error.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/error_light.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Extension.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Extension.imageset/iconExtension.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ExternalLink.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ExternalLink.imageset/iconExternalLink.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/socialIconFacebook.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/iconForwardChevron.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/socialIconGithub.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/socialIconGoogle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/iconHelp.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/iconHelpSmall.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/iconHistory.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/iconLargeBackward.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeClose.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeClose.imageset/iconLargeClose.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeCopy.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeCopy.imageset/iconLargeCopy.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeDesktop.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeDesktop.imageset/iconLargeDesktop.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmail.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmail.imageset/iconLargeEmail.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/iconLargeEmoji.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/iconLargeMoon.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/iconLargePhone.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/iconLargeQrcode.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/iconLargeSun.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeTwitter.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeTwitter.imageset/iconTwitter.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/iconMail.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/iconOff.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/iconPen.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/iconPhone.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/iconPopular.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/iconQrcode.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Question Mark Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Recent.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Recent.imageset/iconRecent.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/iconRetry.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/iconScan.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Search.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Search.imageset/iconSearch.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/socialIconTelegram.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Box-2.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Boxlight-2.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Icon Box-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Icon Boxlight-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Icon Box.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Icon Boxlight.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/socialIconTwitch.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/socialIconTwitter.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/UpwardChevron.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/UpwardChevron.imageset/iconUpwardChevron.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Wallet.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/iconWebsite.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/4 dots.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/App.imageset/App.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/App.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Arrow Bottom.imageset/Arrow Bottom.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Arrow Bottom.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Bars.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Bell.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Browser.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Chart.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Chat Bubble.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Check Circle.imageset/Check Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Check Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Checkmark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Chevron Left.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Code.imageset/Code.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Code.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Coin.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Compass.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Copy.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Desktop.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Double Chevron Right.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Double Chevron Right.imageset/Double Chevron Right.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Browser-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/External Link.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye Crossed.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye Crossed.imageset/Eye Crossed.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Eye.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Filters.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Fingerprint.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Image.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Image.imageset/Image.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Info.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Info.imageset/Info.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Link.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Link.imageset/Link.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Load.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Load.imageset/Load.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Locker.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Locker.imageset/Locker.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Magnifier.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Magnifier.imageset/Magnifier-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Mail.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Mobile.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Moon.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Network.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/QR code.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Question Mark Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Question.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Sliders.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Squares.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sun.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sun.imageset/Sun.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Swap Horizontal.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Swap Horizontal.imageset/Swap Horizontal.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Verif.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Wallet.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Wallet.imageset/Wallet-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Warning Circle.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/X mark.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/X mark.imageset/X mark.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Box-2.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Boxlight-2.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Icon Box-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Icon Boxlight-1.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Icon Box.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Icon Boxlight.pdf create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageEth.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageEth.imageset/imageEthL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageEth.imageset/imageEthL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageEth.imageset/imageEthL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLock.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNft.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNft.imageset/imageNftL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNft.imageset/imageNftL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNft.imageset/imageNftL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNoun.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageSystem.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageSystem.imageset/imageSystemL@1x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageSystem.imageset/imageSystemL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageSystem.imageset/imageSystemL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Rainbow.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeDarkL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeDarkL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeLightL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeLightL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeDarkL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeDarkL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeLightL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeLightL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/Contents.json create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeDarkL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeDarkL@3x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeLightL@2x.png create mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeLightL@3x.png create mode 100644 Sources/Web3ModalUI/Web3ModalImports copy.swift create mode 100644 Tests/Web3ModalTests/AccountButtonSnapshotTests.swift create mode 100644 Tests/Web3ModalTests/NetworkButtonSnapshotTests.swift create mode 100644 Tests/Web3ModalTests/QRCodeViewSnapshotTests.swift create mode 100644 Tests/Web3ModalTests/__Snapshots__/AccountButtonSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalTests/__Snapshots__/AccountButtonSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalTests/__Snapshots__/NetworkButtonSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalTests/__Snapshots__/NetworkButtonSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalTests/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalTests/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/W3MActionEntrySnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MButtonSnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MCardSelectSnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MChipButtonSnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MListItemSnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MListSelectSnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MTagSnapshotTests.swift create mode 100644 Tests/Web3ModalUITests/W3MToastSnapshotTests .swift create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MButtonSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MButtonSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.3.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.3.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MTagSnapshotTests/test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MTagSnapshotTests/test_snapshots.2.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MToastSnapshotTests /test_snapshots.1.png create mode 100644 Tests/Web3ModalUITests/__Snapshots__/W3MToastSnapshotTests /test_snapshots.2.png diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 401737760..64905d043 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -53,6 +53,8 @@ 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */ = {isa = PBXBuildFile; productRef = 84AEC2532B4D43CD00E27A5B /* SwiftMessages */; }; 84B8154E2991099000FAD54E /* BuildConfiguration.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B8154D2991099000FAD54E /* BuildConfiguration.swift */; }; 84B8155B2992A18D00FAD54E /* NotifyMessageViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84B8155A2992A18D00FAD54E /* NotifyMessageViewModel.swift */; }; + 84C2E2B82C6F1F7000853BAA /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 84C2E2B72C6F1F7000853BAA /* Web3ModalUI */; }; + 84C2E2BA2C6F1F7800853BAA /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 84C2E2B92C6F1F7800853BAA /* Web3Modal */; }; 84CE641F27981DED00142511 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CE641E27981DED00142511 /* AppDelegate.swift */; }; 84CE642127981DED00142511 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84CE642027981DED00142511 /* SceneDelegate.swift */; }; 84CE642827981DF000142511 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 84CE642727981DF000142511 /* Assets.xcassets */; }; @@ -61,9 +63,6 @@ 84DB38F32983CDAE00BFEE37 /* PushRegisterer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84DB38F22983CDAE00BFEE37 /* PushRegisterer.swift */; }; 84E6B84A29787A8000428BAF /* NotificationService.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84E6B84929787A8000428BAF /* NotificationService.swift */; }; 84E6B84E29787A8000428BAF /* PNDecryptionService.appex in Embed Foundation Extensions */ = {isa = PBXBuildFile; fileRef = 84E6B84729787A8000428BAF /* PNDecryptionService.appex */; settings = {ATTRIBUTES = (RemoveHeadersOnCopy, ); }; }; - 84F391FA2BA87CEB00FDC20A /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 84F391F92BA87CEB00FDC20A /* Web3ModalUI */; }; - 84F3EFC52BA87C09005FCFAE /* Web3Modal in Frameworks */ = {isa = PBXBuildFile; productRef = 84F3EFC42BA87C09005FCFAE /* Web3Modal */; }; - 84F3EFC72BA87C09005FCFAE /* Web3ModalUI in Frameworks */ = {isa = PBXBuildFile; productRef = 84F3EFC62BA87C09005FCFAE /* Web3ModalUI */; }; 84FE684628ACDB4700C893FF /* RequestParams.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84FE684528ACDB4700C893FF /* RequestParams.swift */; }; A507BE1A29E8032E0038EF70 /* EIP55Tests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A507BE1929E8032E0038EF70 /* EIP55Tests.swift */; }; A50B6A362B06683800162B01 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = C56EE25D293F56D6004840D1 /* InputConfig.swift */; }; @@ -694,13 +693,12 @@ buildActionMask = 2147483647; files = ( 8448F1D427E4726F0000B866 /* WalletConnect in Frameworks */, - 84F3EFC52BA87C09005FCFAE /* Web3Modal in Frameworks */, + 84C2E2BA2C6F1F7800853BAA /* Web3Modal in Frameworks */, C5BE01DF2AF692D80064FC88 /* WalletConnectRouter in Frameworks */, A5B6C0F12A6EAB0800927332 /* WalletConnectNotify in Frameworks */, A54195A52934E83F0035AD19 /* Web3 in Frameworks */, 8487A9442A836C2A0003D5AF /* Sentry in Frameworks */, A5D85228286333E300DAF5C3 /* Starscream in Frameworks */, - 84F3EFC72BA87C09005FCFAE /* Web3ModalUI in Frameworks */, 8486EDD32B4F2EA6008E53C3 /* SwiftMessages in Frameworks */, 84943C7B2A9BA206007EBAC2 /* Mixpanel in Frameworks */, A573C53929EC365000E3CBFD /* HDWalletKit in Frameworks */, @@ -764,7 +762,7 @@ 8487A9462A836C3F0003D5AF /* Sentry in Frameworks */, C55D349929630D440004314A /* Web3Wallet in Frameworks */, C56EE255293F569A004840D1 /* Starscream in Frameworks */, - 84F391FA2BA87CEB00FDC20A /* Web3ModalUI in Frameworks */, + 84C2E2B82C6F1F7000853BAA /* Web3ModalUI in Frameworks */, 84AEC2542B4D43CD00E27A5B /* SwiftMessages in Frameworks */, A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */, C54C24902AEB1B5600DA4BF6 /* WalletConnectRouter in Frameworks */, @@ -1930,8 +1928,7 @@ C5BE01DE2AF692D80064FC88 /* WalletConnectRouter */, CFDB50712B2869AA00A0CBC2 /* WalletConnectModal */, 8486EDD22B4F2EA6008E53C3 /* SwiftMessages */, - 84F3EFC42BA87C09005FCFAE /* Web3Modal */, - 84F3EFC62BA87C09005FCFAE /* Web3ModalUI */, + 84C2E2B92C6F1F7800853BAA /* Web3Modal */, ); productName = DApp; productReference = 84CE641C27981DED00142511 /* DApp.app */; @@ -2056,7 +2053,7 @@ A59D25ED2AB3672700D7EA3A /* AsyncButton */, C54C248F2AEB1B5600DA4BF6 /* WalletConnectRouter */, 84AEC2532B4D43CD00E27A5B /* SwiftMessages */, - 84F391F92BA87CEB00FDC20A /* Web3ModalUI */, + 84C2E2B72C6F1F7000853BAA /* Web3ModalUI */, ); productName = ChatWallet; productReference = C56EE21B293F55ED004840D1 /* WalletApp.app */; @@ -2135,7 +2132,6 @@ 8487A9422A836C2A0003D5AF /* XCRemoteSwiftPackageReference "sentry-cocoa" */, 84943C792A9BA206007EBAC2 /* XCRemoteSwiftPackageReference "mixpanel-swift" */, 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */, - 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */, ); productRefGroup = 764E1D3D26F8D3FC00A1FB15 /* Products */; projectDirPath = ""; @@ -3261,14 +3257,6 @@ minimumVersion = 9.0.9; }; }; - 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */ = { - isa = XCRemoteSwiftPackageReference; - repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; - requirement = { - kind = upToNextMajorVersion; - minimumVersion = 1.0.0; - }; - }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/flypaper0/solana-swift"; @@ -3359,21 +3347,14 @@ package = 84AEC2522B4D43CD00E27A5B /* XCRemoteSwiftPackageReference "SwiftMessages" */; productName = SwiftMessages; }; - 84F391F92BA87CEB00FDC20A /* Web3ModalUI */ = { + 84C2E2B72C6F1F7000853BAA /* Web3ModalUI */ = { isa = XCSwiftPackageProductDependency; - package = 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */; productName = Web3ModalUI; }; - 84F3EFC42BA87C09005FCFAE /* Web3Modal */ = { + 84C2E2B92C6F1F7800853BAA /* Web3Modal */ = { isa = XCSwiftPackageProductDependency; - package = 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */; productName = Web3Modal; }; - 84F3EFC62BA87C09005FCFAE /* Web3ModalUI */ = { - isa = XCSwiftPackageProductDependency; - package = 84F3EFC32BA87C09005FCFAE /* XCRemoteSwiftPackageReference "web3modal-swift" */; - productName = Web3ModalUI; - }; A54195A42934E83F0035AD19 /* Web3 */ = { isa = XCSwiftPackageProductDependency; package = A5AE354528A1A2AC0059AE8A /* XCRemoteSwiftPackageReference "Web3" */; diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 6c7d4562a..85f611418 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -180,15 +180,6 @@ "revision": "569255adcfff0b37e4cb8004aea29d0e2d6266df", "version": "1.0.2" } - }, - { - "package": "swift-web3modal", - "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", - "state": { - "branch": null, - "revision": "2d94ebc9065d1602ddc7eb60dab34a853afb4186", - "version": "1.5.2" - } } ] }, diff --git a/Package.swift b/Package.swift index 797d5622c..bdb553662 100644 --- a/Package.swift +++ b/Package.swift @@ -43,10 +43,17 @@ let package = Package( .library( name: "WalletConnectIdentity", targets: ["WalletConnectIdentity"]), + .library( + name: "Web3Modal", + targets: ["Web3Modal"]), + .library( + name: "Web3ModalUI", + targets: ["Web3ModalUI"]) ], dependencies: [ .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.3.0"), - .package(url: "https://github.com/WalletConnect/QRCode", from: "14.3.1") + .package(url: "https://github.com/WalletConnect/QRCode", from: "14.3.1"), + .package(name: "CoinbaseWalletSDK", url: "https://github.com/WalletConnect/wallet-mobile-sdk", from: "1.0.0") ], targets: [ .target( @@ -139,6 +146,32 @@ let package = Package( .process("Resources/PrivacyInfo.xcprivacy"), ] ), + .target( + name: "Web3Modal", + dependencies: [ + "QRCode", + "WalletConnectSign", + "Web3ModalUI", + "Web3ModalBackport", + "CoinbaseWalletSDK" + ], + resources: [ + .process("Resources/Assets.xcassets"), + .copy("PackageConfig.json") + ] + ), + .target( + name: "Web3ModalUI", + dependencies: [ + "Web3ModalBackport" + ], + resources: [ + .process("Resources/Assets.xcassets") + ] + ), + .target( + name: "Web3ModalBackport" + ), .testTarget( name: "WalletConnectSignTests", dependencies: ["WalletConnectSign", "WalletConnectUtils", "TestingUtils", "WalletConnectVerify"]), diff --git a/Sources/Web3Modal/Analytics/AnalyticsEvent.swift b/Sources/Web3Modal/Analytics/AnalyticsEvent.swift new file mode 100644 index 000000000..cb0f0bb71 --- /dev/null +++ b/Sources/Web3Modal/Analytics/AnalyticsEvent.swift @@ -0,0 +1,28 @@ +enum AnalyticsEvent: Equatable { + case MODAL_LOADED + case MODAL_OPEN(connected: Bool) + case MODAL_CLOSE(connected: Bool) + case CLICK_ALL_WALLETS + case SELECT_WALLET(name: String, platform: Method) + case CLICK_NETWORKS +// case OPEN_ACTIVITY_VIEW // + case SWITCH_NETWORK(network: Chain) + case CONNECT_SUCCESS(method: Method, name: String) + case CONNECT_ERROR(message: String) + case DISCONNECT_SUCCESS + case DISCONNECT_ERROR + case CLICK_WALLET_HELP + case CLICK_NETWORK_HELP + case CLICK_GET_WALLET + + + enum Method: String { + case qrcode = "qrcode" + case mobile = "mobile" + } + +// enum Platform: String { +// case qrcode = "QR" +// case mobile = "mobile" +// } +} diff --git a/Sources/Web3Modal/Analytics/AnalyticsEventMapper.swift b/Sources/Web3Modal/Analytics/AnalyticsEventMapper.swift new file mode 100644 index 000000000..e1ddb240e --- /dev/null +++ b/Sources/Web3Modal/Analytics/AnalyticsEventMapper.swift @@ -0,0 +1,4 @@ +protocol AnalyticsEventMapper { + func eventName(for event: AnalyticsEvent) -> String + func parameters(for event: AnalyticsEvent) -> [String: String] +} diff --git a/Sources/Web3Modal/Analytics/AnalyticsProvider.swift b/Sources/Web3Modal/Analytics/AnalyticsProvider.swift new file mode 100644 index 000000000..79abfab81 --- /dev/null +++ b/Sources/Web3Modal/Analytics/AnalyticsProvider.swift @@ -0,0 +1,3 @@ +protocol AnalyticsProvider { + func track(_ event: AnalyticsEvent) +} diff --git a/Sources/Web3Modal/Analytics/Convenience/AnalyticsEvent+ResultBuilders.swift b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEvent+ResultBuilders.swift new file mode 100644 index 000000000..7277f3aef --- /dev/null +++ b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEvent+ResultBuilders.swift @@ -0,0 +1,17 @@ +import Foundation + +/// A builder resulting in an array of analytics event groups +@resultBuilder enum AnalyticsEventGroupBuilder { + /// Return an array of analytics event groups given a closure containing statements of analytics event groups + static func buildBlock(_ eventGroups: AnalyticsEventGroup...) -> [AnalyticsEventGroup] { + eventGroups + } +} + +/// A builder resulting in an array of analytics events +@resultBuilder enum AnalyticsEventBuilder { + /// Return an array of analytics events given a closure containing statements of analytics events. + static func buildBlock(_ events: AnalyticsEvent...) -> [AnalyticsEvent] { + events + } +} diff --git a/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventGroup.swift b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventGroup.swift new file mode 100644 index 000000000..7eab387ed --- /dev/null +++ b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventGroup.swift @@ -0,0 +1,24 @@ +/// A group of analytics events tracked together in response to a common trigger +struct AnalyticsEventGroup { + // MARK: Properties + + /// The trigger causing the analytics events to be tracked + let trigger: AnalyticsEventTrigger + + /// The events being tracked + let events: [AnalyticsEvent] + + // MARK: Initializers + + init(_ trigger: AnalyticsEventTrigger, events: [AnalyticsEvent]) { + self.trigger = trigger + self.events = events + } +} + +extension AnalyticsEventGroup { + /// Initialize with a trigger and event builder + init(_ trigger: AnalyticsEventTrigger, @AnalyticsEventBuilder events: () -> [AnalyticsEvent]) { + self.init(trigger, events: events()) + } +} diff --git a/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrackingModifier.swift b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrackingModifier.swift new file mode 100644 index 000000000..ed0756014 --- /dev/null +++ b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrackingModifier.swift @@ -0,0 +1,39 @@ +import SwiftUI + +/// A view modifier that tracks analytics events +struct AnalyticsEventTrackingModifier: ViewModifier { + + @EnvironmentObject var analyticsService: AnalyticsService + + /// The groups of analytics events to track + let groups: [AnalyticsEventGroup] + + func body(content: Content) -> some View { + content + .onAppear { + trackAll(in: groups(for: .onAppear)) + } + .onDisappear { + trackAll(in: groups(for: .onDisappear)) + } + .onTapGesture { + trackAll(in: groups(for: .onTapGesture)) + } + } + + // MARK: Helpers + + /// Returns the group for the given trigger + private func groups(for trigger: AnalyticsEventTrigger) -> [AnalyticsEventGroup] { + groups.filter { $0.trigger == trigger } + } + + /// Track all events in the given group + private func trackAll(in group: [AnalyticsEventGroup]) { + groups + .flatMap { $0.events } + .forEach { event in + analyticsService.track(event) + } + } +} diff --git a/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrigger.swift b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrigger.swift new file mode 100644 index 000000000..79346dae0 --- /dev/null +++ b/Sources/Web3Modal/Analytics/Convenience/AnalyticsEventTrigger.swift @@ -0,0 +1,6 @@ +/// A trigger that causes analytics events to be tracked +enum AnalyticsEventTrigger { + case onAppear + case onDisappear + case onTapGesture +} diff --git a/Sources/Web3Modal/Analytics/Convenience/View+Track.swift b/Sources/Web3Modal/Analytics/Convenience/View+Track.swift new file mode 100644 index 000000000..5e90a406a --- /dev/null +++ b/Sources/Web3Modal/Analytics/Convenience/View+Track.swift @@ -0,0 +1,30 @@ +import SwiftUI + +extension View { + + func track(@AnalyticsEventGroupBuilder _ groups: () -> [AnalyticsEventGroup]) -> some View { + let groups = groups() + let modifier = AnalyticsEventTrackingModifier(groups: groups) + return self.modifier(modifier) + } + + func track(_ event: AnalyticsEvent) { + let service: AnalyticsService = Environment(\.analyticsService).wrappedValue + service.track(event) + } + + func track(@AnalyticsEventBuilder _ events: () -> [AnalyticsEvent]) { + let service: AnalyticsService = Environment(\.analyticsService).wrappedValue + let events = events() + events.forEach { event in + service.track(event) + } + } + + /// Track a group of events in response to the trigger with the provided service. + func track(_ trigger: AnalyticsEventTrigger, @AnalyticsEventBuilder _ events: () -> [AnalyticsEvent]) -> some View { + let eventsArray = events() + let group = AnalyticsEventGroup(trigger, events: eventsArray) + return track { group } + } +} diff --git a/Sources/Web3Modal/Analytics/Private/AnalyticsService.swift b/Sources/Web3Modal/Analytics/Private/AnalyticsService.swift new file mode 100644 index 000000000..520beeca2 --- /dev/null +++ b/Sources/Web3Modal/Analytics/Private/AnalyticsService.swift @@ -0,0 +1,58 @@ +import Foundation + +class AnalyticsService: AnalyticsProvider, ObservableObject { + private(set) static var shared = AnalyticsService(providers: [ +// LoggingAnalyticsProvider(), + ClickstreamAnalyticsProvider() + ]) + + private let providers: [AnalyticsProvider] + var method: AnalyticsEvent.Method = .mobile + + var isAnalyticsEnabled: Bool { + return UserDefaults.standard.bool(forKey: analyticsEnabledKey) + } + + // Key to store the state of analytics + private let analyticsEnabledKey = "com.walletconnect.w3m.analyticsEnabled" + + init(providers: [AnalyticsProvider]) { + self.providers = providers + // Set default value for analytics enabled if it's not already set + if UserDefaults.standard.object(forKey: analyticsEnabledKey) == nil { + UserDefaults.standard.set(true, forKey: analyticsEnabledKey) + } + } + + func track(_ event: AnalyticsEvent) { + guard isAnalyticsEnabled else { return } + + providers.forEach { + $0.track(event) + } + if case .SELECT_WALLET(_, let platform) = event { + self.method = platform + } + } + + func disable() { + UserDefaults.standard.set(false, forKey: analyticsEnabledKey) + } + + func enable() { + UserDefaults.standard.set(true, forKey: analyticsEnabledKey) + } +} + +import SwiftUI + +struct AnalyticsServiceKey: EnvironmentKey { + static var defaultValue: AnalyticsService = .shared +} + +extension EnvironmentValues { + var analyticsService: AnalyticsService { + get { self[AnalyticsServiceKey.self] } + set { self[AnalyticsServiceKey.self] = newValue } + } +} diff --git a/Sources/Web3Modal/Analytics/Private/ClickstreamAnalyticsProvider.swift b/Sources/Web3Modal/Analytics/Private/ClickstreamAnalyticsProvider.swift new file mode 100644 index 000000000..32ed0b0a0 --- /dev/null +++ b/Sources/Web3Modal/Analytics/Private/ClickstreamAnalyticsProvider.swift @@ -0,0 +1,124 @@ +import Foundation + +class ClickstreamAnalyticsProvider: AnalyticsProvider { + private let eventMapper = DefaultAnalyticsEventMapper() + + func track(_ event: AnalyticsEvent) { + let urlString = analyticsApiUrl() + let name = eventMapper.eventName(for: event) + let properties = eventMapper.parameters(for: event) + let payload = EventPayload(for: name, properties: properties) + + guard + let url = URL(string: "\(urlString)/e") + else { + return + } + + Task { + do { + let encodedPayload = try JSONEncoder().encode(payload) + + var request = URLRequest(url: url) + request.httpMethod = "POST" + request.httpBody = encodedPayload + request.setW3MHeaders() +// request.setValue("com.walletconnect.web3modal.sample", forHTTPHeaderField: "Origin") + request.setValue("localhost", forHTTPHeaderField: "Origin") // Localhost temporarily + request.setValue("application/json", forHTTPHeaderField: "Content-Type") + + let (_, _) = try await URLSession.shared.dataWithRetry(for: request, retryPolicy: .init( + maxAttempts: 1, + initialDelay: 3, + multiplier: 3 + )) + } catch { + print("Failed posting event \(error)") + } + } + + } + + private func analyticsApiUrl() -> String { +// #if DEBUG +// return "https://analytics-api-cf-workers-staging.walletconnect-v1-bridge.workers.dev" +// #else + return "https://pulse.walletconnect.com" +// #endif + } +} + +struct EventPayload: Codable { + struct Props: Codable { + let type: String + let event: String + let properties: [String: String] + } + let eventId: String + let url: String + let domain: String + let timestamp: UInt64 + let props: Props + + init(for name: String, properties: [String: String]) { + self.eventId = UUID().uuidString + self.url = "https://lab.web3modal.com/" + self.domain = "lab.web3modal.com" + self.timestamp = UInt64(Date().timeIntervalSince1970) + + self.props = Props( + type: "track", + event: name, + properties: properties + ) + } +} + +private extension URLSession { + + struct RetryPolicy { + let maxAttempts: Int + let initialDelay: TimeInterval + let multiplier: Double + } + + enum NetworkError: Error { + case tooManyAttempts + case networkFailure(Error) + case invalidStatusCode + } + + func dataWithRetry(for request: URLRequest, retryPolicy: RetryPolicy) async throws -> (Data, URLResponse) { + var attempts = 0 + var delay = retryPolicy.initialDelay + + while attempts < retryPolicy.maxAttempts { + do { + // Attempt the network request + let (data, response) = try await URLSession.shared.data(for: request) + // If the request is successful, return the data and response + + guard + let httpResponse = response as? HTTPURLResponse, + (200..<300).contains(httpResponse.statusCode) + else { + throw NetworkError.invalidStatusCode + } + + return (data, response) + } catch { + attempts += 1 + if attempts >= retryPolicy.maxAttempts { + // If we've reached the max attempts, throw a tooManyAttempts error + throw NetworkError.tooManyAttempts + } else { + // If the request fails, wait for the delay before retrying + try await Task.sleep(nanoseconds: UInt64(delay * 1_000_000_000)) + delay *= retryPolicy.multiplier // Increase the delay for the next attempt + } + } + } + // Fallback error, though we should never reach here due to the throw in the loop + throw NetworkError.tooManyAttempts + } +} diff --git a/Sources/Web3Modal/Analytics/Private/DefaultAnalyticsEventMapper.swift b/Sources/Web3Modal/Analytics/Private/DefaultAnalyticsEventMapper.swift new file mode 100644 index 000000000..c62d4bd03 --- /dev/null +++ b/Sources/Web3Modal/Analytics/Private/DefaultAnalyticsEventMapper.swift @@ -0,0 +1,71 @@ +class DefaultAnalyticsEventMapper: AnalyticsEventMapper { + func eventName(for event: AnalyticsEvent) -> String { + switch event { + case .MODAL_LOADED: + return "MODAL_LOADED" + case .MODAL_OPEN: + return "MODAL_OPEN" + case .MODAL_CLOSE: + return "MODAL_CLOSE" + case .CLICK_ALL_WALLETS: + return "CLICK_ALL_WALLETS" + case .SELECT_WALLET: + return "SELECT_WALLET" + case .CLICK_NETWORKS: + return "CLICK_NETWORKS" +// case .OPEN_ACTIVITY_VIEW: +// return "OPEN_ACTIVITY_VIEW" + case .SWITCH_NETWORK: + return "SWITCH_NETWORK" + case .CONNECT_SUCCESS: + return "CONNECT_SUCCESS" + case .CONNECT_ERROR: + return "CONNECT_ERROR" + case .DISCONNECT_SUCCESS: + return "DISCONNECT_SUCCESS" + case .DISCONNECT_ERROR: + return "DISCONNECT_ERROR" + case .CLICK_WALLET_HELP: + return "CLICK_WALLET_HELP" + case .CLICK_NETWORK_HELP: + return "CLICK_NETWORK_HELP" + case .CLICK_GET_WALLET: + return "CLICK_GET_WALLET" + } + } + + func parameters(for event: AnalyticsEvent) -> [String: String] { + switch event { + case .MODAL_LOADED: + return [:] + case let .MODAL_OPEN(connected): + return ["connected": connected.description] + case let .MODAL_CLOSE(connected): + return ["connected": connected.description] + case .CLICK_ALL_WALLETS: + return [:] + case let .SELECT_WALLET(name, platform): + return ["wallet": name, "platform": platform.rawValue] + case .CLICK_NETWORKS: + return [:] +// case .OPEN_ACTIVITY_VIEW: +// return [:] + case let .SWITCH_NETWORK(network): + return ["network": network.id] + case let .CONNECT_SUCCESS(method, name): + return ["method": method.rawValue, "name": name] + case let .CONNECT_ERROR(message): + return ["message": message] + case .DISCONNECT_SUCCESS: + return [:] + case .DISCONNECT_ERROR: + return [:] + case .CLICK_WALLET_HELP: + return [:] + case .CLICK_NETWORK_HELP: + return [:] + case .CLICK_GET_WALLET: + return [:] + } + } +} diff --git a/Sources/Web3Modal/Analytics/Private/LoggingAnalyticsProvider.swift b/Sources/Web3Modal/Analytics/Private/LoggingAnalyticsProvider.swift new file mode 100644 index 000000000..43db57c7a --- /dev/null +++ b/Sources/Web3Modal/Analytics/Private/LoggingAnalyticsProvider.swift @@ -0,0 +1,9 @@ +class LoggingAnalyticsProvider: AnalyticsProvider { + private let eventMapper = DefaultAnalyticsEventMapper() + + func track(_ event: AnalyticsEvent) { + let name = eventMapper.eventName(for: event) + let properties = eventMapper.parameters(for: event) + print("📊 Event reported: \(name), properties: \(properties)") + } +} diff --git a/Sources/Web3Modal/Components/AccountButton.swift b/Sources/Web3Modal/Components/AccountButton.swift new file mode 100644 index 000000000..83f809840 --- /dev/null +++ b/Sources/Web3Modal/Components/AccountButton.swift @@ -0,0 +1,267 @@ +import SwiftUI + +struct AccountButtonStyle: ButtonStyle { + @ObservedObject var store: Store + + public init() { + self.store = .shared + } + + init( + store: Store = .shared, + isPressedOverride: Bool? = nil + ) { + self.store = store + self.isPressedOverride = isPressedOverride + } + + @Environment(\.isEnabled) var isEnabled + + var isPressedOverride: Bool? + + var addressFormatted: String? { + guard let address = store.account?.address else { + return nil + } + + return String(address.prefix(4)) + "..." + String(address.suffix(4)) + } + + var selectedChain: Chain { + return store.selectedChain ?? ChainPresets.ethChains.first! + } + + func makeBody(configuration: Configuration) -> some View { + var backgroundColor: Color = .GrayGlass002 + let pressedColor: Color = .GrayGlass010 + backgroundColor = (isPressedOverride ?? configuration.isPressed) ? pressedColor : backgroundColor + backgroundColor = isEnabled ? backgroundColor : .Overgray010 + + let verticalPadding = Spacing.xxxs + let leadingPadding = Spacing.xxs + let trailingPadding = Spacing.xxxs + + return Group { + if store.balance != nil { + mixedVariant() + } else { + accountVariant() + } + } + .padding(.vertical, verticalPadding) + .padding(.leading, leadingPadding) + .padding(.trailing, trailingPadding) + .background(backgroundColor) + .cornerRadius(Radius.m) + .overlay( + RoundedRectangle(cornerRadius: Radius.m) + .stroke(Color.Overgray010, lineWidth: 1) + ) + } + + func accountVariant() -> some View { + var textColor: Color = .Foreground100 + textColor = isEnabled ? textColor : .Overgray015 + + return HStack(spacing: Spacing.xxs) { + avatar() + + Text(addressFormatted ?? "") + .font(.paragraph500) + .foregroundColor(textColor) + } + .padding(Spacing.xs) + .cornerRadius(Radius.m) + } + + func mixedVariant() -> some View { + var textColor: Color = .Foreground100 + textColor = isEnabled ? textColor : .Overgray015 + + var textColorInner: Color = .Foreground200 + textColorInner = isEnabled ? textColorInner : .Overgray010 + + return HStack(spacing: Spacing.xs) { + HStack(spacing: Spacing.xxs) { + networkImage() + + let balance = store.balance?.roundedDecimal(to: 4, mode: .down) ?? 0 + + Text(balance == 0 ? "0 \(selectedChain.token.symbol)" : "\(balance, specifier: "%.3f") \(selectedChain.token.symbol)") + .font(.paragraph600) + .foregroundColor(textColor) + .lineLimit(1) + } + + HStack(spacing: Spacing.xxs) { + avatar() + + Text(addressFormatted ?? "") + .font(.paragraph500) + .foregroundColor(textColorInner) + } + .padding(Spacing.xs) + .background(Color.GrayGlass005) + .cornerRadius(Radius.m) + .overlay( + RoundedRectangle(cornerRadius: Radius.m) + .stroke(Color.Overgray010, lineWidth: 1) + ) + } + } + + @ViewBuilder + func networkImage() -> some View { + Group { + if let storedImage = store.chainImages[selectedChain.imageId] { + Image(uiImage: storedImage) + .resizable() + } else { + Image.Regular.network + .resizable() + .padding(Spacing.xxs) + } + } + .saturation(isEnabled ? 1 : 0) + .opacity(isEnabled ? 1 : 0.5) + .frame(width: 24, height: 24) + .clipShape(Circle()) + .overlay(Circle().stroke(.Overgray005, lineWidth: 2)) + } + + @ViewBuilder + func avatar() -> some View { + Group { + if let avatarUrlString = store.identity?.avatar, let url = URL(string: avatarUrlString) { + Backport.AsyncImage(url: url) + } else if let address = store.account?.address { + W3MAvatarGradient(address: address) + } + } + .saturation(isEnabled ? 1 : 0) + .opacity(isEnabled ? 1 : 0.5) + .frame(width: 20, height: 20) + .clipShape(Circle()) + .overlay(Circle().stroke(.GrayGlass010, lineWidth: 3)) + } +} + +public struct AccountButton: View { + let store: Store + let blockchainApiInteractor: BlockchainAPIInteractor + + public init() { + self.store = .shared + self.blockchainApiInteractor = BlockchainAPIInteractor(store: .shared) + } + + init(store: Store = .shared, blockchainApiInteractor: BlockchainAPIInteractor) { + self.store = store + self.blockchainApiInteractor = blockchainApiInteractor + } + + public var body: some View { + Button(action: { + Web3Modal.present() + }, label: {}) + .buttonStyle(AccountButtonStyle(store: store)) + .onAppear { + fetchIdentity() + fetchBalance() + } + } + + func fetchIdentity() { + Task { @MainActor in + do { + try await blockchainApiInteractor.getIdentity() + } catch { + store.toast = .init(style: .error, message: "Network error") + Web3Modal.config.onError(error) + } + } + } + + func fetchBalance() { + Task { @MainActor in + do { + try await blockchainApiInteractor.getBalance() + } catch { + store.toast = .init(style: .error, message: "Network error") + Web3Modal.config.onError(error) + } + } + } +} + +#if DEBUG + +public struct AccountButtonPreviewView: View { + public init() {} + + static let store = { (balance: Double?) -> Store in + let store = Store() + store.balance = balance + store.session = .stub + store.account = W3MAccount( + address: Session.stub.accounts.first!.address, + chain: Session.stub.accounts.first!.blockchain + ) + + return store + } + + static let blockchainInteractor = { () -> BlockchainAPIInteractor in + MockBlockchainAPIInteractor() + } + + public var body: some View { + VStack { + AccountButton( + store: AccountButtonPreviewView.store(1.23), + blockchainApiInteractor: MockBlockchainAPIInteractor() + ) + + AccountButton( + store: AccountButtonPreviewView.store(nil), + blockchainApiInteractor: MockBlockchainAPIInteractor() + ) + + AccountButton( + store: AccountButtonPreviewView.store(1.23), + blockchainApiInteractor: MockBlockchainAPIInteractor() + ) + .disabled(true) + + AccountButton( + store: AccountButtonPreviewView.store(nil), + blockchainApiInteractor: MockBlockchainAPIInteractor() + ) + .disabled(true) + + Button(action: {}, label: {}) + .buttonStyle( + AccountButtonStyle( + store: AccountButtonPreviewView.store(1.23), + isPressedOverride: true + ) + ) + + Button(action: {}, label: {}) + .buttonStyle( + AccountButtonStyle( + store: AccountButtonPreviewView.store(nil), + isPressedOverride: true + ) + ) + } + } +} + +struct AccountButton_Preview: PreviewProvider { + static var previews: some View { + AccountButtonPreviewView() + } +} + +#endif diff --git a/Sources/Web3Modal/Components/ConnectButton.swift b/Sources/Web3Modal/Components/ConnectButton.swift new file mode 100644 index 000000000..81db53745 --- /dev/null +++ b/Sources/Web3Modal/Components/ConnectButton.swift @@ -0,0 +1,49 @@ +import SwiftUI + + +public struct ConnectButton: View { + @ObservedObject var store: Store + + public init() { + self.store = .shared + } + + init(store: Store = .shared) { + self.store = store + } + + public var body: some View { + Button { + Web3Modal.present() + } label: { + if store.connecting { + HStack { + DrawingProgressView( + shape: .circle, + color: .white, + lineWidth: 2, + duration: 1, + isAnimating: .constant(true) + ) + .frame(width: 20, height: 20) + + Text("Connecting...") + } + } else { + Text("Connect wallet") + } + } + .buttonStyle(W3MChipButtonStyle()) + } +} + +struct ConnectButton_Preview: PreviewProvider { + static var previews: some View { + VStack { + ConnectButton() + + ConnectButton() + .disabled(true) + } + } +} diff --git a/Sources/Web3Modal/Components/Web3ModalButton.swift b/Sources/Web3Modal/Components/Web3ModalButton.swift new file mode 100644 index 000000000..e435e4ab3 --- /dev/null +++ b/Sources/Web3Modal/Components/Web3ModalButton.swift @@ -0,0 +1,47 @@ +import SwiftUI + +public struct Web3ModalButton: View { + @ObservedObject var store: Store + + public init() { + self.store = .shared + } + + init(store: Store = .shared) { + self.store = store + } + + public var body: some View { + Group { + if let _ = store.account { + AccountButton() + } else { + ConnectButton() + } + } + } +} + +#if DEBUG + +struct Web3Button_Preview: PreviewProvider { + static let store = { () -> Store in + let store = Store() + store.balance = 1.23 + store.account = .stub + return store + }() + + static var previews: some View { + VStack { + Web3ModalButton(store: Store()) + + Web3ModalButton(store: Web3Button_Preview.store) + + Web3ModalButton(store: Web3Button_Preview.store) + .disabled(true) + } + } +} + +#endif diff --git a/Sources/Web3Modal/Components/Web3ModalNetworkButton.swift b/Sources/Web3Modal/Components/Web3ModalNetworkButton.swift new file mode 100644 index 000000000..cb4eca398 --- /dev/null +++ b/Sources/Web3Modal/Components/Web3ModalNetworkButton.swift @@ -0,0 +1,110 @@ +import SwiftUI + + +public struct Web3ModalNetworkButton: View { + @ObservedObject var store: Store + + @Environment(\.analyticsService) var analyticsService + + public init() { + self.store = .shared + } + + init(store: Store = .shared) { + self.store = store + } + + public var body: some View { + if let selectedChain = store.selectedChain { + Button(selectedChain.chainName) { + Web3Modal.selectChain() + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + leadingImage: { + if let storedImage = store.chainImages[selectedChain.imageId] { + Circle() + .fill(.GrayGlass005) + .backport.overlay { + Image(uiImage: storedImage) + .resizable() + .frame(width: 22, height: 22) + .clipShape(Circle()) + } + .frame(width: 26, height: 26) + } else { + networkImagePlaceholder() + } + } + ) + ) + } else { + Button { + analyticsService.track(.CLICK_NETWORKS) + Web3Modal.selectChain() + } label: { + Text("Select network").foregroundColor(.Foreground100) + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + leadingImage: { + networkImagePlaceholder() + } + ) + ) + } + } + + private func networkImagePlaceholder() -> some View { + Circle().fill(.GrayGlass010, strokeBorder: .GrayGlass005, lineWidth: 2) + .backport.overlay { + Image.Bold.network + .foregroundColor(.Foreground200) + .padding(Spacing.xs) + } + .frame(width: 24, height: 24) + } +} + +#if DEBUG + +public struct NetworkButtonPreviewView: View { + public init() {} + + static let store = { (chain: Chain?) -> Store in + let store = Store() + store.balance = 1.23 + store.selectedChain = chain + store.chainImages[ChainPresets.ethChains[0].imageId] = UIImage( + named: "MockWalletImage", in: .coreModule, compatibleWith: nil + ) + + return store + } + + public var body: some View { + VStack { + Web3ModalNetworkButton(store: NetworkButtonPreviewView.store(nil)) + + Web3ModalNetworkButton(store: NetworkButtonPreviewView.store(ChainPresets.ethChains[0])) + + Web3ModalNetworkButton(store: NetworkButtonPreviewView.store(ChainPresets.ethChains[1])) + + Web3ModalNetworkButton(store: NetworkButtonPreviewView.store(ChainPresets.ethChains[0])) + .disabled(true) + + Web3ModalNetworkButton(store: NetworkButtonPreviewView.store(nil)) + .disabled(true) + } + } +} + +struct NetworkButton_Preview: PreviewProvider { + static var previews: some View { + NetworkButtonPreviewView() + } +} + +#endif diff --git a/Sources/Web3Modal/Core/BlockchainAPIInteractor.swift b/Sources/Web3Modal/Core/BlockchainAPIInteractor.swift new file mode 100644 index 000000000..99ef4f17e --- /dev/null +++ b/Sources/Web3Modal/Core/BlockchainAPIInteractor.swift @@ -0,0 +1,142 @@ +import Foundation +import WalletConnectNetworking + +class BlockchainAPIInteractor: ObservableObject { + let store: Store + + init(store: Store = .shared) { + self.store = store + } + + func getIdentity() async throws { + guard + let account = store.account, + store.connectedWith == .wc + else { return } + + let address = account.address + let chainId = account.chain.absoluteString + let clientId = try? Relay.instance.getClientId() + + + let httpClient = HTTPNetworkClient(host: "rpc.walletconnect.com") + let response = try await httpClient.request( + Identity.self, + at: BlockchainAPI.getIdentity( + params: .init( + address: address, + chainId: chainId, + projectId: Web3Modal.config.projectId, + clientId: clientId + ) + ) + ) + + DispatchQueue.main.async { [self] in + self.store.identity = response + } + } + + func getBalance() async throws { + enum GetBalanceError: Error { + case noAddress, invalidValue, noChain + } + + guard let address = store.account?.address else { + throw GetBalanceError.noAddress + } + + let request = RPCRequest( + method: "eth_getBalance", params: [ + address, "latest" + ] + ) + + guard let chain = store.selectedChain else { + throw GetBalanceError.noChain + } + + var urlRequest = URLRequest(url: URL(string: chain.rpcUrl)!) + urlRequest.httpMethod = "POST" + urlRequest.httpBody = try JSONEncoder().encode(request) + urlRequest.setValue("application/json", forHTTPHeaderField: "Content-Type") + + let (data, _) = try await URLSession.shared.data(for: urlRequest) + let decodedResponse = try JSONDecoder().decode(RPCResponse.self, from: data) + let weiFactor = pow(10, chain.token.decimal) + + guard let decimalValue = try decodedResponse.result? + .get(String.self) + .convertBalanceHexToBigDecimal()? + .toWei(weiFactor: weiFactor) + else { + throw GetBalanceError.invalidValue + } + + let doubleValue = Double(truncating: decimalValue as NSNumber) + + DispatchQueue.main.async { + self.store.balance = doubleValue + } + } +} + +struct Identity: Codable { + let name: String? + let avatar: String? +} + +struct BalanceRequest: Encodable { + init(address: String) { + self.address = address + + self.id = RPCID() + self.params = [ + address, "latest" + ] + } + + let address: String + let id: RPCID + let jsonrpc: String = "2.0" + let method: String = "eth_getBalance" + let params: [String] +} + +struct BalanceRpcResponse: Codable { + let id: RPCID + let jsonrpc: String + let result: String? + let error: RpcError? + + struct RpcError: Codable { + let code: Int + let message: String + } +} + +extension String { + func convertBalanceHexToBigDecimal() -> Decimal? { + let substring = dropFirst(2) + guard let longValue = UInt64(substring, radix: 16) else { return nil } + return Decimal(string: "\(longValue)") + } +} + +extension Decimal { + func toWei(weiFactor: Decimal) -> Decimal { + return self / weiFactor + } +} + +#if DEBUG +class MockBlockchainAPIInteractor: BlockchainAPIInteractor { + override func getIdentity() async throws { + // no-op + } + + override func getBalance() async throws { + // no-op + } +} +#endif diff --git a/Sources/Web3Modal/Core/SignInteractor.swift b/Sources/Web3Modal/Core/SignInteractor.swift new file mode 100644 index 000000000..299b05827 --- /dev/null +++ b/Sources/Web3Modal/Core/SignInteractor.swift @@ -0,0 +1,48 @@ +import Foundation +import Combine + +class SignInteractor: ObservableObject { + + private let store: Store + + lazy var sessionsPublisher: AnyPublisher<[Session], Never> = Web3Modal.instance.sessionsPublisher + lazy var sessionSettlePublisher: AnyPublisher = Web3Modal.instance.sessionSettlePublisher + lazy var sessionResponsePublisher: AnyPublisher = Web3Modal.instance.sessionResponsePublisher + lazy var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> = Web3Modal.instance.sessionRejectionPublisher + lazy var sessionDeletePublisher: AnyPublisher<(String, Reason), Never> = Web3Modal.instance.sessionDeletePublisher + lazy var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> = Web3Modal.instance.sessionEventPublisher + lazy var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result<(Session?, [Cacao]), AuthError>), Never> = Web3Modal.instance.authResponsePublisher + + + init(store: Store = .shared) { + self.store = store + } + + func connect(walletUniversalLink: String?) async throws { + let uri = try await Web3Modal.instance.connect(walletUniversalLink: walletUniversalLink) + + DispatchQueue.main.async { + self.store.uri = uri + self.store.retryShown = false + } + } + + func disconnect() async throws { + defer { + DispatchQueue.main.async { + self.store.session = nil + self.store.account = nil + } + } + + do { + try await Web3Modal.instance.disconnect(topic: store.session?.topic ?? "") + } catch { + DispatchQueue.main.async { + self.store.toast = .init(style: .error, message: "Failed to disconnect.") + } + Web3Modal.config.onError(error) + } + try await Web3Modal.instance.cleanup() + } +} diff --git a/Sources/Web3Modal/Core/W3MAPIInteractor.swift b/Sources/Web3Modal/Core/W3MAPIInteractor.swift new file mode 100644 index 000000000..0ebded136 --- /dev/null +++ b/Sources/Web3Modal/Core/W3MAPIInteractor.swift @@ -0,0 +1,247 @@ +import UIKit + +final class W3MAPIInteractor: ObservableObject { + @Published var isLoading: Bool = false + + private let store: Store + private let uiApplicationWrapper: UIApplicationWrapper + + private let entriesPerPage: Int = 40 + + var totalEntries: Int = 0 + + init( + store: Store = .shared, + uiApplicationWrapper: UIApplicationWrapper = .live + ) { + self.store = store + self.uiApplicationWrapper = uiApplicationWrapper + } + + func fetchWallets(search: String = "") async throws { + if search.isEmpty { + if store.currentPage + 1 > store.totalPages { + return + } + + store.currentPage = min(store.currentPage + 1, store.totalPages) + } + + DispatchQueue.main.async { + self.isLoading = true + } + + let params = Web3ModalAPI.GetWalletsParams( + page: search.isEmpty ? store.currentPage : 1, + entries: search.isEmpty ? entriesPerPage : 100, + search: search, + projectId: Web3Modal.config.projectId, + metadata: Web3Modal.config.metadata, + recommendedIds: Web3Modal.config.recommendedWalletIds, + excludedIds: Web3Modal.config.excludedWalletIds + ) + + let httpClient = HTTPNetworkClient(host: "api.web3modal.com") + let response = try await httpClient.request( + GetWalletsResponse.self, + at: Web3ModalAPI.getWallets( + params: params + ) + ) + + try await fetchWalletImages(for: response.data) + + DispatchQueue.main.async { [self] in + var wallets = response.data + + for index in wallets.indices { + let contains = store.installedWalletIds.contains(wallets[index].id) + wallets[index].isInstalled = contains + } + + if !search.isEmpty { + let matchingCustomWallets = store.customWallets.filter { wallet in + wallet.name.contains(search) + } + + self.store.searchedWallets = wallets + matchingCustomWallets + } else { + self.store.searchedWallets = [] + self.store.wallets.formUnion(wallets + store.customWallets) + self.totalEntries = response.count + self.store.totalPages = Int(ceil(Double(response.count) / Double(entriesPerPage))) + } + + self.isLoading = false + } + } + + func fetchAllWalletMetadata() async throws { + let httpClient = HTTPNetworkClient(host: "api.web3modal.com") + let response = try await httpClient.request( + GetIosDataResponse.self, + at: Web3ModalAPI.getIosData( + params: .init( + projectId: Web3Modal.config.projectId, + metadata: Web3Modal.config.metadata + ) + ) + ) + + let installedWallets: [String?] = try await response.data.concurrentMap { walletMetadata in + guard + let nativeUrl = URL(string: walletMetadata.ios_schema), + await UIApplication.shared.canOpenURL(nativeUrl) + else { + return nil + } + + return walletMetadata.id + } + + store.installedWalletIds = installedWallets.compactMap { $0 } + } + + func fetchFeaturedWallets() async throws { + let httpClient = HTTPNetworkClient(host: "api.web3modal.com") + let response = try await httpClient.request( + GetWalletsResponse.self, + at: Web3ModalAPI.getWallets( + params: .init( + page: 1, + entries: 4, + search: "", + projectId: Web3Modal.config.projectId, + metadata: Web3Modal.config.metadata, + recommendedIds: Web3Modal.config.recommendedWalletIds, + excludedIds: Web3Modal.config.excludedWalletIds + ) + ) + ) + + try await fetchWalletImages(for: response.data) + + DispatchQueue.main.async { [self] in + + var wallets = response.data + + for index in wallets.indices { + let contains = store.installedWalletIds.contains(wallets[index].id) + wallets[index].isInstalled = contains + } + + self.store.totalNumberOfWallets = response.count + self.store.featuredWallets.append(contentsOf: wallets) + } + } + + func fetchWalletImages(for wallets: [Wallet]) async throws { + var walletImages: [String: UIImage] = [:] + + try await wallets.concurrentMap { wallet in + + // Build URL + var imageUrl: URL? + if let imageId = wallet.imageId { + imageUrl = URL(string: "https://api.web3modal.com/getWalletImage/\(imageId)") + } else if let customImageUrl = wallet.imageUrl { + imageUrl = URL(string: customImageUrl) + } + + // Check whether we have some url and not fetched already + guard + let imageUrl, + !self.store.walletImages.contains(where: { key, _ in key == wallet.id }) + else { + return ("", UIImage?.none) + } + + var request = URLRequest(url: imageUrl) + request.setW3MHeaders() + + do { + let (data, _) = try await URLSession.shared.data(for: request) + let image = UIImage(data: data) + return (wallet.id, image) + } catch { + print(error.localizedDescription) + } + + return ("", UIImage?.none) + } + // Assign to outside dictionary + .forEach { (key: String, value: UIImage?) in + if value == nil || key == "" { + return + } + + walletImages[key] = value + } + + // Update images in Store + DispatchQueue.main.async { [walletImages] in + self.store.walletImages.merge(walletImages) { _, new in + new + } + } + } + + func prefetchChainImages() async throws { + var chainImages: [String: UIImage] = [:] + + try await ChainPresets.ethChains.concurrentMap { chain in + do { + let image = try await self.fetchAssetImage(id: chain.imageId) + return (chain.imageId, image) + } catch { + print(error.localizedDescription) + } + + return ("", UIImage?.none) + } + .forEach { key, value in + if value == nil { + return + } + + chainImages[key] = value + } + + DispatchQueue.main.async { [chainImages] in + self.store.chainImages.merge(chainImages) { _, new in + new + } + } + } + + func fetchAssetImage(id: String) async throws -> UIImage? { + + let url = URL(string: "https://api.web3modal.com/public/getAssetImage/\(id)")! + var request = URLRequest(url: url) + request.setW3MHeaders() + + let (data, _) = try await URLSession.shared.data(for: request) + + return UIImage(data: data) + } + + func fetchWalletImage(id: String) async throws -> UIImage? { + + let url = URL(string: "https://api.web3modal.com/getWalletImage/\(id)")! + var request = URLRequest(url: url) + request.setW3MHeaders() + + let (data, _) = try await URLSession.shared.data(for: request) + + return UIImage(data: data) + } +} + +extension URLRequest { + mutating func setW3MHeaders() { + setValue(Web3Modal.config.projectId, forHTTPHeaderField: "x-project-id") + setValue(Web3Modal.Config.sdkType, forHTTPHeaderField: "x-sdk-type") + setValue(Web3Modal.Config.sdkVersion, forHTTPHeaderField: "x-sdk-version") + setValue(EnvironmentInfo.sdkVersion, forHTTPHeaderField: "User-Agent") + } +} diff --git a/Sources/Web3Modal/Core/W3MJSONRPC+Coinbase.swift b/Sources/Web3Modal/Core/W3MJSONRPC+Coinbase.swift new file mode 100644 index 000000000..8ab70eb9d --- /dev/null +++ b/Sources/Web3Modal/Core/W3MJSONRPC+Coinbase.swift @@ -0,0 +1,67 @@ +import CoinbaseWalletSDK + +extension W3MJSONRPC { + func toCbAction() -> Web3JSONRPC? { + switch self { + case let .personal_sign(address, message): + return .personal_sign( + address: address, + message: message + ) + case .eth_requestAccounts: + return .eth_requestAccounts + case let .eth_signTransaction(from, to, value, data, nonce, _, gasPrice, maxFeePerGas, maxPriorityFeePerGas, gasLimit, chainId): + return .eth_signTransaction( + fromAddress: from, + toAddress: to, + weiValue: value, + data: data, + nonce: nonce, + gasPriceInWei: gasPrice, + maxFeePerGas: maxFeePerGas, + maxPriorityFeePerGas: maxPriorityFeePerGas, + gasLimit: gasLimit, + chainId: chainId + ) + case let .eth_sendTransaction(from, to, value, data, nonce, _, gasPrice, maxFeePerGas, maxPriorityFeePerGas, gasLimit, chainId): + return .eth_sendTransaction( + fromAddress: from, + toAddress: to, + weiValue: value, + data: data, + nonce: nonce, + gasPriceInWei: gasPrice, + maxFeePerGas: maxFeePerGas, + maxPriorityFeePerGas: maxPriorityFeePerGas, + gasLimit: gasLimit, + chainId: chainId, + actionSource: nil + ) + case let .wallet_switchEthereumChain(chainId): + return .wallet_switchEthereumChain(chainId: chainId) + case let .wallet_addEthereumChain(chainId, blockExplorerUrls, chainName, iconUrls, nativeCurrency, rpcUrls): + return .wallet_addEthereumChain( + chainId: chainId, + blockExplorerUrls: blockExplorerUrls, + chainName: chainName, + iconUrls: iconUrls, + nativeCurrency: nativeCurrency != nil ? .init( + name: nativeCurrency!.name, + symbol: nativeCurrency!.symbol, + decimals: nativeCurrency!.decimals + ) : nil, + rpcUrls: rpcUrls + ) + case let .wallet_watchAsset(type, options): + return .wallet_watchAsset( + type: type, + options: .init( + address: options.address, + symbol: options.symbol, + decimals: options.decimals, + image: options.image + ) + ) + } + } +} diff --git a/Sources/Web3Modal/Core/W3MJSONRPC.swift b/Sources/Web3Modal/Core/W3MJSONRPC.swift new file mode 100644 index 000000000..ddbc5a521 --- /dev/null +++ b/Sources/Web3Modal/Core/W3MJSONRPC.swift @@ -0,0 +1,90 @@ +import Foundation + +public enum W3MJSONRPC: Codable { + case eth_requestAccounts + + case personal_sign( + address: String, + message: String + ) + case eth_signTransaction( + from: String, + to: String?, + value: String, + data: String, + nonce: Int?, + gas: String?, + gasPrice: String?, + maxFeePerGas: String?, + maxPriorityFeePerGas: String?, + gasLimit: String?, + chainId: String + ) + + case eth_sendTransaction( + from: String, + to: String?, + value: String, + data: String, + nonce: Int?, + gas: String?, + gasPrice: String?, + maxFeePerGas: String?, + maxPriorityFeePerGas: String?, + gasLimit: String?, + chainId: String + ) + + case wallet_switchEthereumChain( + chainId: String + ) + + case wallet_addEthereumChain( + chainId: String, + blockExplorerUrls: [String]?, + chainName: String?, + iconUrls: [String]?, + nativeCurrency: AddChainNativeCurrency?, + rpcUrls: [String] + ) + + case wallet_watchAsset( + type: String, + options: WatchAssetOptions + ) + + var rawValues: (method: String, params: [String: Any]) { + let json = try! JSONEncoder().encode(self) + let dictionary = try! JSONSerialization.jsonObject(with: json) as! [String: [String: Any]] + + let method = dictionary.keys.first! + let params = dictionary[method]! + return (method, params) + } +} + +public struct AddChainNativeCurrency: Codable { + let name: String + let symbol: String + let decimals: Int + + public init(name: String, symbol: String, decimals: Int) { + self.name = name + self.symbol = symbol + self.decimals = decimals + } +} + +public struct WatchAssetOptions: Codable { + let address: String + let symbol: String? + let decimals: Int? + let image: String? + + public init(address: String, symbol: String?, decimals: Int?, image: String?) { + self.address = address + self.symbol = symbol + self.decimals = decimals + self.image = image + } +} diff --git a/Sources/Web3Modal/Core/W3MResponse.swift b/Sources/Web3Modal/Core/W3MResponse.swift new file mode 100644 index 000000000..7f99fcd45 --- /dev/null +++ b/Sources/Web3Modal/Core/W3MResponse.swift @@ -0,0 +1,15 @@ +import Foundation + +public struct W3MResponse: Codable, Equatable { + init(id: RPCID? = RPCID(), topic: String? = nil, chainId: String? = nil, result: RPCResult) { + self.id = id + self.topic = topic + self.chainId = chainId + self.result = result + } + + public let id: RPCID? + public let topic: String? + public let chainId: String? + public let result: RPCResult +} diff --git a/Sources/Web3Modal/Core/Web3Modal.swift b/Sources/Web3Modal/Core/Web3Modal.swift new file mode 100644 index 000000000..8a1125903 --- /dev/null +++ b/Sources/Web3Modal/Core/Web3Modal.swift @@ -0,0 +1,348 @@ +import CoinbaseWalletSDK +import Foundation +import SwiftUI + +#if canImport(UIKit) +import UIKit +#endif + +/// Web3Modal instance wrapper +/// +/// ```Swift +/// let metadata = AppMetadata( +/// name: "Swift dapp", +/// description: "dapp", +/// url: "dapp.wallet.connect", +/// icons: ["https://my_icon.com/1"] +/// ) +/// Web3Modal.configure(projectId: PROJECT_ID, metadata: metadata) +/// Web3Modal.instance.getSessions() +/// ``` +public class Web3Modal { + /// Web3Modalt client instance + public static var instance: Web3ModalClient = { + guard let config = Web3Modal.config else { + fatalError("Error - you must call Web3Modal.configure(_:) before accessing the shared instance.") + } + let client = Web3ModalClient( + logger: ConsoleLogger(prefix: "📜", loggingLevel: .off), + signClient: Sign.instance, + pairingClient: Pair.instance as! (PairingClientProtocol & PairingInteracting & PairingRegisterer), + store: .shared, + analyticsService: .shared + ) + + let store = Store.shared + + if let session = client.getSessions().first { + store.session = session + store.connectedWith = .wc + store.account = .init(from: session) + } else if CoinbaseWalletSDK.shared.isConnected() { + + let storedAccount = AccountStorage.read() + store.connectedWith = .cb + store.account = storedAccount + } else { + AccountStorage.clear() + } + + return client + }() + + struct Config { + static let sdkVersion: String = { + guard + let fileURL = Bundle.coreModule.url(forResource: "PackageConfig", withExtension: "json"), + let data = try? Data(contentsOf: fileURL), + let jsonObject = try? JSONSerialization.jsonObject(with: data, options: []) as? [String: Any], + let version = jsonObject["version"] as? String + else { + return "undefined" + } + + return "swift-\(version)" + }() + + static let sdkType = "w3m" + + let projectId: String + var metadata: AppMetadata + let crypto: CryptoProvider + var sessionParams: SessionParams + var authRequestParams: AuthRequestParams? + + let includeWebWallets: Bool + let recommendedWalletIds: [String] + let excludedWalletIds: [String] + let customWallets: [Wallet] + let coinbaseEnabled: Bool + + let onError: (Error) -> Void + + } + + private(set) static var config: Config! + + private(set) static var viewModel: Web3ModalViewModel! + + private init() {} + + /// Wallet instance wallet config method. + /// - Parameters: + /// - metadata: App metadata + public static func configure( + projectId: String, + metadata: AppMetadata, + crypto: CryptoProvider, + sessionParams: SessionParams = .default, + authRequestParams: AuthRequestParams?, + includeWebWallets: Bool = true, + recommendedWalletIds: [String] = [], + excludedWalletIds: [String] = [], + customWallets: [Wallet] = [], + coinbaseEnabled: Bool = true, + onError: @escaping (Error) -> Void = { _ in } + ) { + Pair.configure(metadata: metadata) + + Web3Modal.config = Web3Modal.Config( + projectId: projectId, + metadata: metadata, + crypto: crypto, + sessionParams: sessionParams, + authRequestParams: authRequestParams, + includeWebWallets: includeWebWallets, + recommendedWalletIds: recommendedWalletIds, + excludedWalletIds: excludedWalletIds, + customWallets: customWallets, + coinbaseEnabled: coinbaseEnabled, + onError: onError + ) + + Sign.configure(crypto: crypto) + + let store = Store.shared + let router = Router() + let w3mApiInteractor = W3MAPIInteractor(store: store) + let signInteractor = SignInteractor(store: store) + let blockchainApiInteractor = BlockchainAPIInteractor(store: store) + + store.customWallets = customWallets + + configureCoinbaseIfNeeded( + store: store, + metadata: metadata, + w3mApiInteractor: w3mApiInteractor + ) + + Web3Modal.viewModel = Web3ModalViewModel( + router: router, + store: store, + w3mApiInteractor: w3mApiInteractor, + signInteractor: signInteractor, + blockchainApiInteractor: blockchainApiInteractor, + supportsAuthenticatedSession: (config.authRequestParams != nil) + ) + + Task { + try? await w3mApiInteractor.fetchWalletImages(for: store.recentWallets + store.customWallets) + try? await w3mApiInteractor.fetchAllWalletMetadata() + try? await w3mApiInteractor.fetchFeaturedWallets() + try? await w3mApiInteractor.prefetchChainImages() + } + } + + public static func set(sessionParams: SessionParams) { + Web3Modal.config.sessionParams = sessionParams + } + + private static func configureCoinbaseIfNeeded( + store: Store, + metadata: AppMetadata, + w3mApiInteractor: W3MAPIInteractor + ) { + guard Web3Modal.config.coinbaseEnabled else { return } + + if let redirectLink = metadata.redirect?.universal ?? metadata.redirect?.native { + CoinbaseWalletSDK.configure(callback: URL(string: redirectLink)!) + } else { + CoinbaseWalletSDK.configure( + callback: URL(string: "w3mdapp://")! + ) + } + + var wallet: Wallet = .init( + id: "fd20dc426fb37566d803205b19bbc1d4096b248ac04548e3cfb6b3a38bd033aa", + name: "Coinbase", + homepage: "https://www.coinbase.com/wallet/", + imageId: "a5ebc364-8f91-4200-fcc6-be81310a0000", + order: 4, + mobileLink: nil, + linkMode: nil, + desktopLink: nil, + webappLink: nil, + appStore: "https://apps.apple.com/us/app/coinbase-wallet-nfts-crypto/id1278383455", + alternativeConnectionMethod: { + CoinbaseWalletSDK.shared.initiateHandshake { result, account in + switch result { + case .success: + guard + let account = account, + let blockchain = Blockchain( + namespace: account.chain == "eth" ? "eip155" : "", + reference: String(account.networkId) + ) + else { return } + + store.connectedWith = .cb + store.account = .init( + address: account.address, + chain: blockchain + ) + + withAnimation { + store.isModalShown = false + } + Web3Modal.viewModel.router.setRoute(Router.AccountSubpage.profile) + + let matchingChain = ChainPresets.ethChains.first(where: { + $0.chainNamespace == blockchain.namespace && $0.chainReference == blockchain.reference + }) + + store.selectedChain = matchingChain + case .failure(let error): + store.toast = .init(style: .error, message: error.localizedDescription) + } + } + } + ) + + wallet.isInstalled = CoinbaseWalletSDK.isCoinbaseWalletInstalled() + + store.customWallets.append(wallet) + + Task { [wallet] in + try? await w3mApiInteractor.fetchWalletImages(for: [wallet]) + } + } + +} + +#if canImport(UIKit) + +public extension Web3Modal { + static func selectChain(from presentingViewController: UIViewController? = nil) { + guard let vc = presentingViewController ?? topViewController() else { + assertionFailure("No controller found for presenting modal") + return + } + + _ = Web3Modal.instance + + Web3Modal.viewModel.router.setRoute(Router.NetworkSwitchSubpage.selectChain) + + Store.shared.connecting = true + + let modal = Web3ModalSheetController(router: Web3Modal.viewModel.router) + vc.present(modal, animated: true) + } + + static func present(from presentingViewController: UIViewController? = nil) { + guard let vc = presentingViewController ?? topViewController() else { + assertionFailure("No controller found for presenting modal") + return + } + + _ = Web3Modal.instance + + Store.shared.connecting = true + + Web3Modal.viewModel.router.setRoute(Store.shared.account != nil ? Router.AccountSubpage.profile : Router.ConnectingSubpage.connectWallet) + + let modal = Web3ModalSheetController(router: Web3Modal.viewModel.router) + vc.present(modal, animated: true) + } + + private static func topViewController(_ base: UIViewController? = nil) -> UIViewController? { + let base = base ?? UIApplication + .shared + .connectedScenes + .flatMap { ($0 as? UIWindowScene)?.windows ?? [] } + .last { $0.isKeyWindow }? + .rootViewController + + if let nav = base as? UINavigationController { + return topViewController(nav.visibleViewController) + } + + if let tab = base as? UITabBarController { + if let selected = tab.selectedViewController { + return topViewController(selected) + } + } + + if let presented = base?.presentedViewController { + return topViewController(presented) + } + + return base + } +} + +#elseif canImport(AppKit) + +import AppKit + +public extension Web3Modal { + static func present(from presentingViewController: NSViewController? = nil) { + let modal = Web3ModalSheetController() + presentingViewController!.presentAsModalWindow(modal) + } +} + +#endif + +public struct SessionParams { + public let requiredNamespaces: [String: ProposalNamespace] + public let optionalNamespaces: [String: ProposalNamespace]? + public let sessionProperties: [String: String]? + + public init(requiredNamespaces: [String: ProposalNamespace], optionalNamespaces: [String: ProposalNamespace]? = nil, sessionProperties: [String: String]? = nil) { + self.requiredNamespaces = requiredNamespaces + self.optionalNamespaces = optionalNamespaces + self.sessionProperties = sessionProperties + } + + public static let `default`: Self = { + let methods: Set = Set(EthUtils.ethMethods) + let events: Set = ["chainChanged", "accountsChanged"] + let blockchains = ChainPresets.ethChains.map(\.id).compactMap(Blockchain.init) + + let namespaces: [String: ProposalNamespace] = [ + "eip155": ProposalNamespace( + chains: blockchains, + methods: methods, + events: events + ) + ] + + let optionalNamespaces: [String: ProposalNamespace] = [ + "solana": ProposalNamespace( + chains: [ + Blockchain("solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp")! + ], + methods: [ + "solana_signMessage", + "solana_signTransaction" + ], events: [] + ) + ] + + return SessionParams( + requiredNamespaces: [:], + optionalNamespaces: namespaces.merging(optionalNamespaces, uniquingKeysWith: { old, _ in old }), + sessionProperties: nil + ) + }() +} diff --git a/Sources/Web3Modal/Core/Web3ModalClient.swift b/Sources/Web3Modal/Core/Web3ModalClient.swift new file mode 100644 index 000000000..beb10bb9d --- /dev/null +++ b/Sources/Web3Modal/Core/Web3ModalClient.swift @@ -0,0 +1,361 @@ +import class CoinbaseWalletSDK.CoinbaseWalletSDK +import struct CoinbaseWalletSDK.Action +import struct CoinbaseWalletSDK.ActionError +import Combine +import Foundation +import UIKit + +// Web3 Modal Client +/// +/// Cannot be instantiated outside of the SDK +/// +/// Access via `Web3Modal.instance` +public class Web3ModalClient { + // MARK: - Public Properties + + /// Publisher that sends sessions on every sessions update + /// + /// Event will be emited on controller and non-controller clients. + public var sessionsPublisher: AnyPublisher<[Session], Never> { + signClient.sessionsPublisher.eraseToAnyPublisher() + } + + /// Publisher that sends session when one is settled + /// + /// Event is emited on proposer and responder client when both communicating peers have successfully established a session. + public var sessionSettlePublisher: AnyPublisher { + signClient.sessionSettlePublisher.eraseToAnyPublisher() + } + + /// Publisher that sends session proposal that has been rejected + /// + /// Event will be emited on dApp client only. + public var sessionRejectionPublisher: AnyPublisher<(Session.Proposal, Reason), Never> { + signClient.sessionRejectionPublisher.eraseToAnyPublisher() + } + + /// Publisher that sends deleted session topic + /// + /// Event can be emited on any type of the client. + public var sessionDeletePublisher: AnyPublisher<(String, Reason), Never> { + signClient.sessionDeletePublisher.eraseToAnyPublisher() + } + + /// Publisher that sends response for session request + /// + /// In most cases that event will be emited on dApp client. + public var sessionResponsePublisher: AnyPublisher { + signClient.sessionResponsePublisher + .map { response in + W3MResponse( + id: response.id, + topic: response.topic, + chainId: response.chainId, + result: response.result + ) + } + .merge(with: coinbaseResponseSubject) + .eraseToAnyPublisher() + } + + public var coinbaseResponseSubject = PassthroughSubject() + + /// Publisher that sends web socket connection status + public var socketConnectionStatusPublisher: AnyPublisher { + signClient.socketConnectionStatusPublisher.eraseToAnyPublisher() + } + + /// Publisher that sends session event + /// + /// Event will be emited on dApp client only + public var sessionEventPublisher: AnyPublisher<(event: Session.Event, sessionTopic: String, chainId: Blockchain?), Never> { + signClient.sessionEventPublisher.eraseToAnyPublisher() + } + + public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result<(Session?, [Cacao]), AuthError>), Never> { + signClient.authResponsePublisher + } + + public var isAnalyticsEnabled: Bool { + return analyticsService.isAnalyticsEnabled + } + + public var SIWEAuthenticationPublisher: AnyPublisher, Never> { + return SIWEAuthenticationPublisherSubject.eraseToAnyPublisher() + } + + internal let SIWEAuthenticationPublisherSubject = PassthroughSubject, Never>() + + // MARK: - Private Properties + + private let signClient: SignClient + private let pairingClient: PairingClientProtocol & PairingInteracting & PairingRegisterer + private let store: Store + private let analyticsService: AnalyticsService + private var disposeBag = Set() + public let logger: ConsoleLogging + + init( + logger: ConsoleLogging, + signClient: SignClient, + pairingClient: PairingClientProtocol & PairingInteracting & PairingRegisterer, + store: Store, + analyticsService: AnalyticsService + ) { + self.logger = logger + self.signClient = signClient + self.pairingClient = pairingClient + self.store = store + self.analyticsService = analyticsService + setUpConnectionEvents() + analyticsService.track(.MODAL_LOADED) + } + + /// For creating new pairing + public func createPairing() async throws -> WalletConnectURI { + logger.debug("Creating new pairing") + do { + return try await pairingClient.create() + } catch { + Web3Modal.config.onError(error) + throw error + } + } + + /// For proposing a session to a wallet. + /// Function will propose a session on existing pairing or create new one if not specified + /// Namespaces from Web3Modal.config will be used + /// - Parameters: + /// - topic: pairing topic + public func connect(walletUniversalLink: String?) async throws -> WalletConnectURI? { + logger.debug("Connecting Application") + do { + if let authParams = Web3Modal.config.authRequestParams { + return try await signClient.authenticate(authParams, walletUniversalLink: walletUniversalLink) + } else { + let pairingURI = try await signClient.connect( + requiredNamespaces: Web3Modal.config.sessionParams.requiredNamespaces, + optionalNamespaces: Web3Modal.config.sessionParams.optionalNamespaces, + sessionProperties: Web3Modal.config.sessionParams.sessionProperties + ) + return pairingURI + } + } catch { + Web3Modal.config.onError(error) + throw error + } + } + + public func request(_ request: W3MJSONRPC) async throws { + logger.debug("Requesting: \(request.rawValues.method)") + switch store.connectedWith { + case .wc: + guard + let session = getSessions().first, + let chain = getSelectedChain(), + let blockchain = Blockchain(namespace: chain.chainNamespace, reference: chain.chainReference) + else { return } + + if case let .personal_sign(address, message) = request { + try await signClient.request( + params: .init( + topic: session.topic, + method: request.rawValues.method, + params: AnyCodable(any: [message, address]), + chainId: blockchain + ) + ) + } else { + try await signClient.request( + params: .init( + topic: session.topic, + method: request.rawValues.method, + params: AnyCodable(any: request.rawValues.params), + chainId: blockchain + ) + ) + } + case .cb: + + guard let jsonRpc = request.toCbAction() else { return } + + // Execute on main as Coinbase SDK is not dispatching on main when calling UIApplication.openUrl() + DispatchQueue.main.async { + CoinbaseWalletSDK.shared.makeRequest( + .init( + actions: [ + Action(jsonRpc: jsonRpc) + ] + ) + ) { result in + let response: W3MResponse + switch result { + case let .success(payload): + + switch payload.content.first { + case let .success(JSONString): + response = .init(result: .response(AnyCodable(JSONString))) + case let .failure(error): + response = .init(result: .error(.init(code: error.code, message: error.message))) + case .none: + response = .init(result: .error(.init(code: -1, message: "Empty response"))) + } + case let .failure(error): + Web3Modal.config.onError(error) + + if let cbError = error as? ActionError { + response = .init(result: .error(.init(code: cbError.code, message: cbError.message))) + } else { + response = .init(result: .error(.init(code: -1, message: error.localizedDescription))) + } + } + + self.coinbaseResponseSubject.send(response) + } + } + case .none: + break + } + } + + /// For sending JSON-RPC requests to wallet. + /// - Parameters: + /// - params: Parameters defining request and related session + public func request(params: Request) async throws { + do { + try await signClient.request(params: params) + } catch { + Web3Modal.config.onError(error) + throw error + } + } + + /// For a terminating a session + /// + /// Should Error: + /// - When the session topic is not found + /// - Parameters: + /// - topic: Session topic that you want to delete + public func disconnect(topic: String) async throws { + switch store.connectedWith { + case .wc: + do { + try await signClient.disconnect(topic: topic) + analyticsService.track(.DISCONNECT_SUCCESS) + } catch { + Web3Modal.config.onError(error) + analyticsService.track(.DISCONNECT_ERROR) + throw error + } + case .cb: + if case let .failure(error) = CoinbaseWalletSDK.shared.resetSession() { + analyticsService.track(.DISCONNECT_ERROR) + throw error + } else { + analyticsService.track(.DISCONNECT_SUCCESS) + } + case .none: + break + } + } + + /// Query sessions + /// - Returns: All sessions + public func getSessions() -> [Session] { + signClient.getSessions() + } + + /// Query pairings + /// - Returns: All pairings + public func getPairings() -> [Pairing] { + pairingClient.getPairings() + } + + /// Delete all stored data such as: pairings, sessions, keys + /// + /// - Note: Will unsubscribe from all topics + public func cleanup() async throws { + do { + try await signClient.cleanup() + } catch { + Web3Modal.config.onError(error) + throw error + } + } + + public func getAddress() -> String? { + guard let account = store.account else { return nil } + + return account.address + } + + public func getSelectedChain() -> Chain? { + guard let chain = store.selectedChain else { + return nil + } + + return chain + } + + public func addChainPreset(_ chain: Chain) { + ChainPresets.ethChains.append(chain) + } + + public func selectChain(_ chain: Chain) { + store.selectedChain = chain + } + + public func launchCurrentWallet() { + guard + let session = store.session, + let urlString = session.peer.redirect?.native ?? session.peer.redirect?.universal, + let url = URL(string: urlString) + else { return } + + DispatchQueue.main.async { + UIApplication.shared.open(url, completionHandler: nil) + } + } + + @discardableResult + public func handleDeeplink(_ url: URL) -> Bool { + if let components = URLComponents(url: url, resolvingAgainstBaseURL: false), + let queryItems = components.queryItems, + queryItems.contains(where: { $0.name == "wc_ev" }) { + do { + try signClient.dispatchEnvelope(url.absoluteString) + return true + } catch { + store.toast = .init(style: .error, message: error.localizedDescription) + return false + } + } + do { + return try CoinbaseWalletSDK.shared.handleResponse(url) + } catch { + store.toast = .init(style: .error, message: error.localizedDescription) + return false + } + } + + private func setUpConnectionEvents() { + analyticsService.track(.MODAL_LOADED) + + signClient.sessionSettlePublisher.sink { [unowned self] session in + self.analyticsService.track(.CONNECT_SUCCESS(method: analyticsService.method, name: session.peer.name)) + }.store(in: &disposeBag) + + + signClient.sessionRejectionPublisher.sink { [unowned self] (_, reason) in + self.analyticsService.track(.CONNECT_ERROR(message: reason.message)) + }.store(in: &disposeBag) + } + + public func enableAnalytics() { + analyticsService.enable() + } + + public func disableAnalytics() { + analyticsService.disable() + } +} diff --git a/Sources/Web3Modal/Extensions/Collection.swift b/Sources/Web3Modal/Extensions/Collection.swift new file mode 100644 index 000000000..fbf287572 --- /dev/null +++ b/Sources/Web3Modal/Extensions/Collection.swift @@ -0,0 +1,2 @@ +import Foundation + diff --git a/Sources/Web3Modal/Extensions/Sequence.swift b/Sources/Web3Modal/Extensions/Sequence.swift new file mode 100644 index 000000000..7a9047e37 --- /dev/null +++ b/Sources/Web3Modal/Extensions/Sequence.swift @@ -0,0 +1,29 @@ +import Foundation + +extension Sequence { + func asyncMap( + _ transform: (Element) async throws -> T + ) async rethrows -> [T] { + var values = [T]() + + for element in self { + try await values.append(transform(element)) + } + + return values + } + + func concurrentMap( + _ transform: @escaping (Element) async throws -> T + ) async throws -> [T] { + let tasks = map { element in + Task { + try await transform(element) + } + } + + return try await tasks.asyncMap { task in + try await task.value + } + } +} diff --git a/Sources/Web3Modal/Extensions/View+RoundedCorners.swift b/Sources/Web3Modal/Extensions/View+RoundedCorners.swift new file mode 100644 index 000000000..8cd2d1eaa --- /dev/null +++ b/Sources/Web3Modal/Extensions/View+RoundedCorners.swift @@ -0,0 +1,96 @@ +import SwiftUI + +#if canImport(UIKit) + +extension View { + func cornerRadius(_ radius: CGFloat, corners: UIRectCorner) -> some View { + clipShape( RoundedCorner(radius: radius, corners: corners) ) + } +} + +struct RoundedCorner: Shape { + + var insetAmount = 0.0 + var radius: CGFloat = .infinity + var corners: UIRectCorner = .allCorners + + func path(in rect: CGRect) -> Path { + let path = UIBezierPath(roundedRect: rect.inset(by: .init(top: 0, left: insetAmount, bottom: 0, right: insetAmount)), byRoundingCorners: corners, cornerRadii: CGSize(width: radius, height: radius)) + return Path(path.cgPath) + } +} + +extension RoundedCorner: InsettableShape { + func inset(by amount: CGFloat) -> some InsettableShape { + var roundedCorner = self + roundedCorner.insetAmount += amount + return roundedCorner + } +} + +#elseif canImport(AppKit) + +struct RectCorner: OptionSet { + + let rawValue: Int + + static let topLeft = RectCorner(rawValue: 1 << 0) + static let topRight = RectCorner(rawValue: 1 << 1) + static let bottomRight = RectCorner(rawValue: 1 << 2) + static let bottomLeft = RectCorner(rawValue: 1 << 3) + + static let allCorners: RectCorner = [.topLeft, topRight, .bottomLeft, .bottomRight] +} + + +// draws shape with specified rounded corners applying corner radius +struct RoundedCorner: Shape { + + var radius: CGFloat = .zero + var corners: RectCorner = .allCorners + + func path(in rect: CGRect) -> Path { + var path = Path() + + let p1 = CGPoint(x: rect.minX, y: corners.contains(.topLeft) ? rect.minY + radius : rect.minY ) + let p2 = CGPoint(x: corners.contains(.topLeft) ? rect.minX + radius : rect.minX, y: rect.minY ) + + let p3 = CGPoint(x: corners.contains(.topRight) ? rect.maxX - radius : rect.maxX, y: rect.minY ) + let p4 = CGPoint(x: rect.maxX, y: corners.contains(.topRight) ? rect.minY + radius : rect.minY ) + + let p5 = CGPoint(x: rect.maxX, y: corners.contains(.bottomRight) ? rect.maxY - radius : rect.maxY ) + let p6 = CGPoint(x: corners.contains(.bottomRight) ? rect.maxX - radius : rect.maxX, y: rect.maxY ) + + let p7 = CGPoint(x: corners.contains(.bottomLeft) ? rect.minX + radius : rect.minX, y: rect.maxY ) + let p8 = CGPoint(x: rect.minX, y: corners.contains(.bottomLeft) ? rect.maxY - radius : rect.maxY ) + + + path.move(to: p1) + path.addArc(tangent1End: CGPoint(x: rect.minX, y: rect.minY), + tangent2End: p2, + radius: radius) + path.addLine(to: p3) + path.addArc(tangent1End: CGPoint(x: rect.maxX, y: rect.minY), + tangent2End: p4, + radius: radius) + path.addLine(to: p5) + path.addArc(tangent1End: CGPoint(x: rect.maxX, y: rect.maxY), + tangent2End: p6, + radius: radius) + path.addLine(to: p7) + path.addArc(tangent1End: CGPoint(x: rect.minX, y: rect.maxY), + tangent2End: p8, + radius: radius) + path.closeSubpath() + + return path + } +} + +extension View { + func cornerRadius(_ radius: CGFloat, corners: RectCorner) -> some View { + clipShape( RoundedCorner(radius: radius, corners: corners) ) + } +} + +#endif diff --git a/Sources/Web3Modal/Helpers/EnvironmentInfo.swift b/Sources/Web3Modal/Helpers/EnvironmentInfo.swift new file mode 100644 index 000000000..83669b63f --- /dev/null +++ b/Sources/Web3Modal/Helpers/EnvironmentInfo.swift @@ -0,0 +1,34 @@ +#if os(iOS) +import UIKit +#endif +import Foundation + +enum EnvironmentInfo { + + static var sdkVersion: String { + "swift-\(packageVersion)/\(operatingSystem)" + } + + static var packageVersion: String { + guard + let fileURL = Bundle.coreModule.url(forResource: "PackageConfig", withExtension: "json"), + let data = try? Data(contentsOf: fileURL), + let jsonObject = try? JSONSerialization.jsonObject(with: data, options: []) as? [String: Any], + let version = jsonObject["version"] as? String + else { + return "undefined" + } + + return version + } + + public static var operatingSystem: String { +#if os(iOS) + return "\(UIDevice.current.systemName)-\(UIDevice.current.systemVersion)" +#elseif os(macOS) + return "macOS-\(ProcessInfo.processInfo.operatingSystemVersion)" +#elseif os(tvOS) + return "tvOS-\(ProcessInfo.processInfo.operatingSystemVersion)" +#endif + } +} diff --git a/Sources/Web3Modal/Models/Chain.swift b/Sources/Web3Modal/Models/Chain.swift new file mode 100644 index 000000000..73a6ea2e3 --- /dev/null +++ b/Sources/Web3Modal/Models/Chain.swift @@ -0,0 +1,214 @@ +import Foundation + +public struct Chain: Identifiable, Hashable { + + public var id: String { + "\(chainNamespace):\(chainReference)" + } + + public var chainName: String + public var chainNamespace: String + public var chainReference: String + public var requiredMethods: [String] + public var optionalMethods: [String] + public var events: [String] + public var token: Token + public var rpcUrl: String + public var blockExplorerUrl: String + public var imageId: String + + public struct Token: Hashable { + public var name: String + public var symbol: String + public var decimal: Int + + public init(name: String, symbol: String, decimal: Int) { + self.name = name + self.symbol = symbol + self.decimal = decimal + } + } + + public init(chainName: String, chainNamespace: String, chainReference: String, requiredMethods: [String], optionalMethods: [String], events: [String], token: Chain.Token, rpcUrl: String, blockExplorerUrl: String, imageId: String) { + self.chainName = chainName + self.chainNamespace = chainNamespace + self.chainReference = chainReference + self.requiredMethods = requiredMethods + self.optionalMethods = optionalMethods + self.events = events + self.token = token + self.rpcUrl = rpcUrl + self.blockExplorerUrl = blockExplorerUrl + self.imageId = imageId + } +} + +enum EthUtils { + + static let walletSwitchEthChain = "wallet_switchEthereumChain" + static let walletAddEthChain = "wallet_addEthereumChain" + + static let ethRequiredMethods = [ + "personal_sign", + "eth_signTypedData", + "eth_sendTransaction", + ] + static let ethOptionalMethods = [walletSwitchEthChain, walletAddEthChain] + static let ethMethods = ethRequiredMethods + ethOptionalMethods + + static let chainChanged = "chainChanged" + static let accountsChanged = "accountsChanged" + + static let ethEvents = [chainChanged, accountsChanged] +} + +enum ChainPresets { + static let ethToken = Chain.Token(name: "Ether", symbol: "ETH", decimal: 18) + + static var ethChains: [Chain] = [ + Chain( + chainName: "Ethereum", + chainNamespace: "eip155", + chainReference: "1", + requiredMethods: [], + optionalMethods: [], + events: [], + token: ethToken, + rpcUrl: "https://cloudflare-eth.com", + blockExplorerUrl: "https://etherscan.io", + imageId: "692ed6ba-e569-459a-556a-776476829e00" + ), + Chain( + chainName: "Arbitrum One", + chainNamespace: "eip155", + chainReference: "42161", + requiredMethods: [], + optionalMethods: [], + events: [], + token: ethToken, + rpcUrl: "https://arb1.arbitrum.io/rpc", + blockExplorerUrl: "https://arbiscan.io", + imageId: "600a9a04-c1b9-42ca-6785-9b4b6ff85200" + ), + Chain( + chainName: "Polygon", + chainNamespace: "eip155", + chainReference: "137", + requiredMethods: [], + optionalMethods: [], + events: [], + token: .init(name: "MATIC", symbol: "MATIC", decimal: 18), + rpcUrl: "https://polygon-rpc.com", + blockExplorerUrl: "https://polygonscan.com", + imageId: "41d04d42-da3b-4453-8506-668cc0727900" + ), + Chain( + chainName: "Avalanche", + chainNamespace: "eip155", + chainReference: "43114", + requiredMethods: [], + optionalMethods: [], + events: [], + token: .init(name: "Avalanche", symbol: "AVAX", decimal: 18), + rpcUrl: "https://api.avax.network/ext/bc/C/rpc", + blockExplorerUrl: "https://snowtrace.io", + imageId: "30c46e53-e989-45fb-4549-be3bd4eb3b00" + ), + Chain( + chainName: "BNB Smart Chain", + chainNamespace: "eip155", + chainReference: "56", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: .init(name: "BNB",symbol: "BNB",decimal: 18), + rpcUrl: "https://rpc.ankr.com/bsc", + blockExplorerUrl: "https://bscscan.com", + imageId: "93564157-2e8e-4ce7-81df-b264dbee9b00" + ), + Chain( + chainName: "OP Mainnet", + chainNamespace: "eip155", + chainReference: "10", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: ethToken, + rpcUrl: "https://mainnet.optimism.io", + blockExplorerUrl: "https://explorer.optimism.io", + imageId: "ab9c186a-c52f-464b-2906-ca59d760a400" + ), + Chain( + chainName: "Gnosis", + chainNamespace: "eip155", + chainReference: "100", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: .init(name: "Gnosis",symbol: "xDAI",decimal: 18), + rpcUrl: "https://rpc.gnosischain.com", + blockExplorerUrl: "https://blockscout.com/xdai/mainnet", + imageId: "02b53f6a-e3d4-479e-1cb4-21178987d100" + ), + Chain( + chainName: "zkSync Era", + chainNamespace: "eip155", + chainReference: "324", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: ethToken, + rpcUrl: "https://mainnet.era.zksync.io", + blockExplorerUrl: "https://explorer.zksync.io", + imageId: "b310f07f-4ef7-49f3-7073-2a0a39685800" + ), + Chain( + chainName: "Zora", + chainNamespace: "eip155", + chainReference: "7777777", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: ethToken, + rpcUrl: "https://rpc.zora.energy", + blockExplorerUrl: "https://explorer.zora.energy", + imageId: "845c60df-d429-4991-e687-91ae45791600" + ), + Chain( + chainName: "Base", + chainNamespace: "eip155", + chainReference: "8453", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: ethToken, + rpcUrl: "https://mainnet.base.org", + blockExplorerUrl: "https://basescan.org", + imageId: "7289c336-3981-4081-c5f4-efc26ac64a00" + ), + Chain( + chainName: "Celo", + chainNamespace: "eip155", + chainReference: "42220", + requiredMethods: EthUtils.ethRequiredMethods, + optionalMethods: EthUtils.ethOptionalMethods, + events: EthUtils.ethEvents, + token: .init(name: "CELO",symbol: "CELO",decimal: 18), + rpcUrl: "https://forno.celo.org", + blockExplorerUrl: "https://explorer.celo.org/mainnet", + imageId: "ab781bbc-ccc6-418d-d32d-789b15da1f00" + ), + Chain( + chainName: "Aurora", + chainNamespace: "eip155", + chainReference: "1313161554", + requiredMethods: [], + optionalMethods: [], + events: [], + token: ethToken, + rpcUrl: "https://mainnet.aurora.dev", + blockExplorerUrl: "https://aurorascan.dev", + imageId: "3ff73439-a619-4894-9262-4470c773a100" + ) + ] +} diff --git a/Sources/Web3Modal/Models/Helpers/AccountStorage.swift b/Sources/Web3Modal/Models/Helpers/AccountStorage.swift new file mode 100644 index 000000000..efeb54058 --- /dev/null +++ b/Sources/Web3Modal/Models/Helpers/AccountStorage.swift @@ -0,0 +1,28 @@ +import Foundation + +class AccountStorage { + enum Keys: String { + case storeAccount + } + + static func read(defaults: UserDefaults = .standard) -> W3MAccount? { + guard + let data = defaults.data(forKey: Keys.storeAccount.rawValue), + let account = try? JSONDecoder().decode(W3MAccount.self, from: data) + else { + return nil + } + + return account + } + + static func save(defaults: UserDefaults = .standard, _ account: W3MAccount?) { + guard let accountData = try? JSONEncoder().encode(account) else { return } + + defaults.set(accountData, forKey: Keys.storeAccount.rawValue) + } + + static func clear(defaults: UserDefaults = .standard) { + defaults.set(nil, forKey: Keys.storeAccount.rawValue) + } +} diff --git a/Sources/Web3Modal/Models/Helpers/AsyncSemaphore.swift b/Sources/Web3Modal/Models/Helpers/AsyncSemaphore.swift new file mode 100644 index 000000000..d25aa180a --- /dev/null +++ b/Sources/Web3Modal/Models/Helpers/AsyncSemaphore.swift @@ -0,0 +1,31 @@ +import Foundation + +// Simple implementation of semaphore using continuations. Please revise before using for anything else. +actor AsyncSemaphore { + private var count = 0 + private var waiters = [UnsafeContinuation]() + + public init(count: Int) { + self.count = count + } + + private func wait() async { + count -= 1 + if count >= 0 { return } + await withUnsafeContinuation { + waiters.append($0) + } + } + + private func signal() { + count += 1 + if waiters.isEmpty { return } + waiters.removeFirst().resume() + } + + public func withTurn(_ procedure: @Sendable () async throws -> Void) async rethrows { + await wait() + defer { signal() } + try await procedure() + } +} diff --git a/Sources/Web3Modal/Models/Helpers/Bundle+extension.swift b/Sources/Web3Modal/Models/Helpers/Bundle+extension.swift new file mode 100644 index 000000000..efd1d42b4 --- /dev/null +++ b/Sources/Web3Modal/Models/Helpers/Bundle+extension.swift @@ -0,0 +1,17 @@ +import Foundation + +#if CocoaPods +public extension Foundation.Bundle { + private class CocoapodsBundle {} + + static var coreModule: Bundle { + let bundle = Bundle(for: CocoapodsBundle.self) + let frameworkBundlePath = bundle.path(forResource: "Web3Modal", ofType: "bundle")! + return Bundle(path: frameworkBundlePath) ?? bundle + } +} +#else +public extension Foundation.Bundle { + static var coreModule: Bundle { Bundle.module } +} +#endif diff --git a/Sources/Web3Modal/Models/Helpers/RecentWalletStorage.swift b/Sources/Web3Modal/Models/Helpers/RecentWalletStorage.swift new file mode 100644 index 000000000..794028ded --- /dev/null +++ b/Sources/Web3Modal/Models/Helpers/RecentWalletStorage.swift @@ -0,0 +1,53 @@ +import Foundation + +class RecentWalletsStorage { + + static func loadRecentWallets(defaults: UserDefaults = .standard) -> [Wallet] { + guard + let data = defaults.data(forKey: "recentWallets"), + let wallets = try? JSONDecoder().decode([Wallet].self, from: data) + else { + return [] + } + + return wallets.filter { wallet in + guard let lastTimeUsed = wallet.lastTimeUsed else { + assertionFailure("Shouldn't happen we stored wallet without `lastTimeUsed`") + return false + } + + // Consider Recent only for 3 days + return abs(lastTimeUsed.timeIntervalSinceNow) < (24 * 60 * 60 * 3) + } + } + + static func saveRecentWallets(defaults: UserDefaults = .standard, _ wallets: [Wallet]) { + + let subset = Array( + wallets + .filter { + $0.lastTimeUsed != nil + } + .sorted(by: { lhs, rhs in + lhs.lastTimeUsed! > rhs.lastTimeUsed! + }) + .prefix(2) + ) + + var uniqueValues: [Wallet] = [] + subset.forEach { item in + guard !uniqueValues.contains(where: { wallet in + item.id == wallet.id + }) else { return } + uniqueValues.append(item) + } + + guard + let walletsData = try? JSONEncoder().encode(uniqueValues) + else { + return + } + + defaults.set(walletsData, forKey: "recentWallets") + } +} diff --git a/Sources/Web3Modal/Models/Helpers/Session+Stub.swift b/Sources/Web3Modal/Models/Helpers/Session+Stub.swift new file mode 100644 index 000000000..375cc2e49 --- /dev/null +++ b/Sources/Web3Modal/Models/Helpers/Session+Stub.swift @@ -0,0 +1,51 @@ +import Foundation + +#if DEBUG +extension Session { + static let stubJson: Data = """ + { + "peer": { + "name": "MetaMask Wallet", + "url": "https://metamask.io/", + "icons": [], + "redirect": { + "native": "metamask://", + "universal": "https://metamask.app.link/", + "linkMode: false + }, + "description": "MetaMask Wallet Integration" + }, + "namespaces": { + "eip155": { + "chains": [ + "eip155:56" + ], + "accounts": [ + "eip155:56:0x5c8877144d858e41d8c33f5baa7e67a5e0027e37" + ], + "events": [ + "chainChanged", + "accountsChanged" + ], + "methods": [ + "wallet_addEthereumChain", + "personal_sign", + "eth_sendTransaction", + "eth_signTypedData", + "wallet_switchEthereumChain" + ] + } + }, + "pairingTopic": "08698f505aa6f677823953cbe3d5f34e4f098635f2444096d88977c1850267bb", + "requiredNamespaces": {}, + "expiryDate": 720702756, + "topic": "34afbcab97c8b9105f66ea3770cb540d59085c6f0996b4170cb163fee2558f59" + } + """.data(using: .utf8)! + + static let stub: Session! = { + try! JSONDecoder().decode(Session.self, from: Session.stubJson) + }() +} + +#endif diff --git a/Sources/Web3Modal/Models/Wallet.swift b/Sources/Web3Modal/Models/Wallet.swift new file mode 100644 index 000000000..7cce3dc68 --- /dev/null +++ b/Sources/Web3Modal/Models/Wallet.swift @@ -0,0 +1,141 @@ +import Foundation + +public struct Wallet: Codable, Identifiable { + public let id: String + let name: String + let homepage: String + let imageId: String? + let imageUrl: String? + let order: Int + let mobileLink: String? + let linkMode: String? + let desktopLink: String? + let webappLink: String? + let appStore: String? + + var lastTimeUsed: Date? + var isInstalled: Bool = false + var alternativeConnectionMethod: (() -> Void)? = nil + + enum CodingKeys: String, CodingKey { + case id + case name + case homepage + case imageId = "image_id" + case imageUrl = "image_url" + case order + case mobileLink = "mobile_link" + case linkMode = "link_mode" + case desktopLink = "desktop_link" + case webappLink = "webapp_link" + case appStore = "app_store" + + // Decorated + case lastTimeUsed + case isInstalled + } + + public init( + id: String, + name: String, + homepage: String, + imageId: String? = nil, + imageUrl: String? = nil, + order: Int, + mobileLink: String?, + linkMode: String?, + desktopLink: String? = nil, + webappLink: String? = nil, + appStore: String? = nil, + lastTimeUsed: Date? = nil, + isInstalled: Bool = false, + alternativeConnectionMethod: (() -> Void)? = nil + ) { + self.id = id + self.name = name + self.homepage = homepage + self.imageId = imageId + self.imageUrl = imageUrl + self.order = order + self.mobileLink = mobileLink + self.linkMode = linkMode + self.desktopLink = desktopLink + self.webappLink = webappLink + self.appStore = appStore + self.lastTimeUsed = lastTimeUsed + self.isInstalled = isInstalled + self.alternativeConnectionMethod = alternativeConnectionMethod + } + + public init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + self.id = try container.decode(String.self, forKey: .id) + self.name = try container.decode(String.self, forKey: .name) + self.homepage = try container.decode(String.self, forKey: .homepage) + self.imageUrl = try container.decodeIfPresent(String.self, forKey: .imageUrl) + self.imageId = try container.decodeIfPresent(String.self, forKey: .imageId) + self.order = try container.decode(Int.self, forKey: .order) + self.linkMode = try container.decodeIfPresent(String.self, forKey: .linkMode) + self.mobileLink = try container.decodeIfPresent(String.self, forKey: .mobileLink) + self.desktopLink = try container.decodeIfPresent(String.self, forKey: .desktopLink) + self.webappLink = try container.decodeIfPresent(String.self, forKey: .webappLink) + self.appStore = try container.decodeIfPresent(String.self, forKey: .appStore) + self.lastTimeUsed = try container.decodeIfPresent(Date.self, forKey: .lastTimeUsed) + self.isInstalled = try container.decodeIfPresent(Bool.self, forKey: .isInstalled) ?? false + } +} + +extension Wallet: Equatable { + public static func == (lhs: Wallet, rhs: Wallet) -> Bool { + return lhs.id == rhs.id + } +} + +extension Wallet: Hashable { + public func hash(into hasher: inout Hasher) { + hasher.combine(id) + } +} + +#if DEBUG + +extension Wallet { + static let stubList: [Wallet] = [ + Wallet( + id: UUID().uuidString, + name: "Sample Wallet", + homepage: "https://example.com/cool", + imageId: "0528ee7e-16d1-4089-21e3-bbfb41933100", + order: 1, + mobileLink: "https://sample.com/foo/universal", + linkMode: "https://lab.web3modal.com/wallet", desktopLink: "sampleapp://deeplink", + webappLink: "https://sample.com/foo/webapp", + appStore: "" + ), + Wallet( + id: UUID().uuidString, + name: "Cool Wallet", + homepage: "https://example.com/cool", + imageId: "5195e9db-94d8-4579-6f11-ef553be95100", + order: 2, + mobileLink: "awsomeapp://", + linkMode: "https://lab.web3modal.com/wallet", desktopLink: "awsomeapp://deeplink", + webappLink: "https://awesome.com/foo/webapp", + appStore: "" + ), + Wallet( + id: UUID().uuidString, + name: "Cool Wallet", + homepage: "https://example.com/cool", + imageId: "3913df81-63c2-4413-d60b-8ff83cbed500", + order: 3, + mobileLink: "https://cool.com/foo/universal", + linkMode: "https://lab.web3modal.com/wallet", + desktopLink: "coolapp://deeplink", + webappLink: "https://cool.com/foo/webapp", + appStore: "" + ) + ] +} + +#endif diff --git a/Sources/Web3Modal/Networking/BlockchainAPI.swift b/Sources/Web3Modal/Networking/BlockchainAPI.swift new file mode 100644 index 000000000..48c260ff7 --- /dev/null +++ b/Sources/Web3Modal/Networking/BlockchainAPI.swift @@ -0,0 +1,50 @@ +import Foundation + +enum BlockchainAPI: HTTPService { + struct GetIdentityParams { + let address: String + let chainId: String + let projectId: String + let clientId: String? + } + + case getIdentity(params: GetIdentityParams) + + var path: String { + switch self { + case let .getIdentity(params): return "/v1/identity/\(params.address)" + } + } + + var method: HTTPMethod { + switch self { + case .getIdentity: return .get + } + } + + var body: Data? { + nil + } + + var queryParameters: [String: String]? { + switch self { + case let .getIdentity(params): + var parameters: [String: String] = [ + "projectId": params.projectId, + "chainId": params.chainId + ] + if let clientId = params.clientId { + parameters["clientId"] = clientId + } + return parameters + } + } + + var scheme: String { + return "https" + } + + var additionalHeaderFields: [String: String]? { + nil + } +} diff --git a/Sources/Web3Modal/Networking/GetWalletsResponse.swift b/Sources/Web3Modal/Networking/GetWalletsResponse.swift new file mode 100644 index 000000000..3a3edfaad --- /dev/null +++ b/Sources/Web3Modal/Networking/GetWalletsResponse.swift @@ -0,0 +1,16 @@ +import Foundation + +struct GetWalletsResponse: Codable { + let count: Int + let data: [Wallet] +} + +struct GetIosDataResponse: Codable { + let count: Int + let data: [WalletMetadata] + + struct WalletMetadata: Codable { + let id: String + let ios_schema: String + } +} diff --git a/Sources/Web3Modal/Networking/Web3ModalAPI.swift b/Sources/Web3Modal/Networking/Web3ModalAPI.swift new file mode 100644 index 000000000..eb835d8b3 --- /dev/null +++ b/Sources/Web3Modal/Networking/Web3ModalAPI.swift @@ -0,0 +1,84 @@ +import Foundation + +enum Web3ModalAPI: HTTPService { + struct GetWalletsParams { + let page: Int + let entries: Int + let search: String? + let projectId: String + let metadata: AppMetadata + let recommendedIds: [String] + let excludedIds: [String] + } + + struct GetIosDataParams { + let projectId: String + let metadata: AppMetadata + } + + case getWallets(params: GetWalletsParams) + case getIosData(params: GetIosDataParams) + + var path: String { + switch self { + case .getWallets: return "/getWallets" + case .getIosData: return "/getIosData" + } + } + + var method: HTTPMethod { + switch self { + case .getWallets: return .get + case .getIosData: return .get + } + } + + var body: Data? { + nil + } + + var queryParameters: [String: String]? { + switch self { + case let .getWallets(params): + return [ + "page": "\(params.page)", + "entries": "\(params.entries)", + "search": params.search ?? "", + "recommendedIds": params.recommendedIds.joined(separator: ","), + "excludedIds": params.excludedIds.joined(separator: ","), + "platform": "ios", + ] + .compactMapValues { value in + value.isEmpty ? nil : value + } + case let .getIosData(params): + return [ + "projectId": params.projectId, + "metadata": params.metadata.name + ] + } + } + + var scheme: String { + return "https" + } + + var additionalHeaderFields: [String: String]? { + switch self { + case let .getWallets(params): + return [ + "x-project-id": params.projectId, + "x-sdk-version": Web3Modal.Config.sdkVersion, + "x-sdk-type": Web3Modal.Config.sdkType, + "Referer": params.metadata.name + ] + case let .getIosData(params): + return [ + "x-project-id": params.projectId, + "x-sdk-version": Web3Modal.Config.sdkVersion, + "x-sdk-type": Web3Modal.Config.sdkType, + "Referer": params.metadata.name + ] + } + } +} diff --git a/Sources/Web3Modal/PackageConfig.json b/Sources/Web3Modal/PackageConfig.json new file mode 100644 index 000000000..695c89652 --- /dev/null +++ b/Sources/Web3Modal/PackageConfig.json @@ -0,0 +1,3 @@ +{ +"version": "1.1.0" +} diff --git a/Sources/Web3Modal/Resources/Assets.xcassets/Contents.json b/Sources/Web3Modal/Resources/Assets.xcassets/Contents.json new file mode 100644 index 000000000..73c00596a --- /dev/null +++ b/Sources/Web3Modal/Resources/Assets.xcassets/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/Contents.json b/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/Contents.json new file mode 100644 index 000000000..73c00596a --- /dev/null +++ b/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json b/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json new file mode 100644 index 000000000..1777a61f7 --- /dev/null +++ b/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json @@ -0,0 +1,21 @@ +{ + "images" : [ + { + "idiom" : "universal", + "scale" : "1x" + }, + { + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "Polygon.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png b/Sources/Web3Modal/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png new file mode 100644 index 0000000000000000000000000000000000000000..47e34581ab5b0632b6d70f98de7e435d19ee978c GIT binary patch literal 2543 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 Void)? = nil) { + uiApplicationWrapper.openURL(url, completionHandler) + } + + func canOpenURL(_ url: URL) -> Bool { + uiApplicationWrapper.canOpenURL(url) + } + + func setRoute(_ route: any SubPage) { + previousRoute = currentRoute + withAnimation { + currentRoute = route + } + } + + func goBack() { + let prev = previousRoute ?? Router.ConnectingSubpage.connectWallet + withAnimation { + currentRoute = prev + } + previousRoute = nil + } + + func resetRoute() { + withAnimation { + currentRoute = ConnectingSubpage.connectWallet + } + } + + enum AccountSubpage: SubPage { + case transactions + case profile + } + + enum ConnectingSubpage: SubPage { + case connectWallet + case qr + case allWallets + case whatIsAWallet + case walletDetail(Wallet) + case getWallet + } + + enum NetworkSwitchSubpage: SubPage { + case selectChain + case networkDetail(Chain) + case whatIsANetwork + } +} + +protocol SubPage: Equatable {} diff --git a/Sources/Web3Modal/Screens/AccountView.swift b/Sources/Web3Modal/Screens/AccountView.swift new file mode 100644 index 000000000..e062f58b2 --- /dev/null +++ b/Sources/Web3Modal/Screens/AccountView.swift @@ -0,0 +1,198 @@ +import SwiftUI + + +struct AccountView: View { + @EnvironmentObject var router: Router + @EnvironmentObject var blockchainApiInteractor: BlockchainAPIInteractor + @EnvironmentObject var signInteractor: SignInteractor + @EnvironmentObject var store: Store + + var addressFormatted: String? { + guard let address = store.account?.address else { + return nil + } + + return String(address.prefix(4)) + "..." + String(address.suffix(4)) + } + + var selectedChain: Chain { + return store.selectedChain ?? ChainPresets.ethChains.first! + } + + var body: some View { + VStack(spacing: 0) { + VStack(spacing: 0) { + avatar() + + Spacer() + .frame(height: Spacing.xl) + + HStack { + (store.identity?.name ?? addressFormatted).map { + Text($0) + .font(.title600) + .foregroundColor(.Foreground100) + } + + Button { + UIPasteboard.general.string = store.session?.accounts.first?.address + store.toast = .init(style: .success, message: "Address copied") + } label: { + Image.Medium.copy + .resizable() + .frame(width: 12, height: 12) + .foregroundColor(.Foreground250) + } + } + + Spacer() + .frame(height: Spacing.xxxxs) + + if store.balance != nil { + let balance = store.balance?.roundedDecimal(to: 4, mode: .down) ?? 0 + + Text(balance == 0 ? "0 \(selectedChain.token.symbol)" : "\(balance, specifier: "%.4f") \(selectedChain.token.symbol)") + .font(.paragraph500) + .foregroundColor(.Foreground200) + } + + Spacer() + .frame(height: Spacing.s) + + Button { + guard let chain = store.selectedChain else { return } + + router.openURL(URL(string: chain.blockExplorerUrl)!) + } label: { + Text("Block Explorer") + } + .buttonStyle(W3MChipButtonStyle( + variant: .transparent, + size: .s, + leadingImage: { + Image.Medium.compass + .resizable() + }, + trailingImage: { + Image.Bold.externalLink + .resizable() + } + )) + + } + + Spacer() + .frame(height: Spacing.xl) + + Button { + router.setRoute(Router.NetworkSwitchSubpage.selectChain) + } label: { + Text(selectedChain.chainName) + } + .buttonStyle(W3MListSelectStyle(imageContent: { _ in + Image( + uiImage: store.chainImages[selectedChain.imageId] ?? UIImage() + ) + .resizable() + .frame(width: 32, height: 32) + .clipShape(Circle()) + })) + + Spacer() + .frame(height: Spacing.xs) + + Button { + disconnect() + } label: { + Text("Disconnect") + } + .buttonStyle(W3MListSelectStyle(imageContent: { _ in + Image.Medium.disconnect + .resizable() + .frame(width: 14, height: 14) + .padding(Spacing.xxxs) + .frame(width: 32, height: 32) + .background(Color.GrayGlass010) + .clipShape(Circle()) + })) + + Spacer() + .frame(height: Spacing.m) + } + .padding(.horizontal, Spacing.s) + .padding(.top, 40) + .padding(.bottom) + .onAppear { + Task { + do { + try await blockchainApiInteractor.getBalance() + } catch { + store.toast = .init(style: .error, message: "Network error") + Web3Modal.config.onError(error) + } + } + + guard store.identity == nil else { + return + } + + Task { + do { + try await blockchainApiInteractor.getIdentity() + } catch { + store.toast = .init(style: .error, message: "Network error") + Web3Modal.config.onError(error) + } + } + } + .frame(maxWidth: .infinity) + .background(Color.Background125) + .overlay(closeButton().padding().foregroundColor(.Foreground100), alignment: .topTrailing) + .cornerRadius(30, corners: [.topLeft, .topRight]) + } + + @ViewBuilder + func avatar() -> some View { + if let avatarUrlString = store.identity?.avatar, let url = URL(string: avatarUrlString) { + Backport.AsyncImage(url: url) + .frame(width: 64, height: 64) + .clipShape(Circle()) + .overlay(Circle().stroke(.GrayGlass010, lineWidth: 8)) + } else if let address = store.account?.address { + W3MAvatarGradient(address: address) + .frame(width: 64, height: 64) + .overlay(Circle().stroke(.GrayGlass010, lineWidth: 8)) + } + } + + func disconnect() { + Task { + do { + router.setRoute(Router.ConnectingSubpage.connectWallet) + try await signInteractor.disconnect() + } catch { + store.toast = .init(style: .error, message: "Network error") + } + } + } + + private func closeButton() -> some View { + Button { + withAnimation { + store.isModalShown = false + } + } label: { + Image.Medium.xMark + } + } +} + +extension Double { + func roundedDecimal(to scale: Int = 0, mode: NSDecimalNumber.RoundingMode = .plain) -> Double { + var decimalValue = Decimal(self) + var result = Decimal() + NSDecimalRound(&result, &decimalValue, scale, mode) + return Double(truncating: result as NSNumber) + } +} + diff --git a/Sources/Web3Modal/Screens/ChainSwitch/ChainSelectView.swift b/Sources/Web3Modal/Screens/ChainSwitch/ChainSelectView.swift new file mode 100644 index 000000000..04c4fcff0 --- /dev/null +++ b/Sources/Web3Modal/Screens/ChainSwitch/ChainSelectView.swift @@ -0,0 +1,220 @@ +import SwiftUI + +struct ChainSelectView: View { + @EnvironmentObject var router: Router + @EnvironmentObject var store: Store + + @ObservedObject var viewModel: Web3ModalViewModel + + @Environment(\.analyticsService) var analyticsService: AnalyticsService + + var body: some View { + VStack(spacing: 0) { + modalHeader() + routes() + } + .background(Color.Background125) + .cornerRadius(30, corners: [.topLeft, .topRight]) + } + + @ViewBuilder + private func routes() -> some View { + switch router.currentRoute as? Router.NetworkSwitchSubpage { + case .none: + EmptyView() + case .selectChain: + if #available(iOS 14.0, *) { + grid() + } else { + Text("Please upgrade to iOS 14 to use this feature") + } + case .whatIsANetwork: + WhatIsNetworkView() + case let .networkDetail(chain): + NetworkDetailView(viewModel: .init(chain: chain, router: router)) + } + } + + @available(iOS 14.0, *) + @ViewBuilder + private func grid() -> some View { + let numberOfColumns = calculateNumberOfColumns() + let columns = Array(repeating: GridItem(.flexible()), count: numberOfColumns) + let maxNumberOfRows = ceil(Double(ChainPresets.ethChains.count) / Double(numberOfColumns)) + let numberOfRows = min(4, maxNumberOfRows) + + VStack { + ScrollView { + LazyVGrid(columns: columns, spacing: Spacing.l) { + ForEach(ChainPresets.ethChains, id: \.self) { chain in + gridElement(for: chain) + } + } + } + .frame(height: numberOfRows * 96 + (numberOfRows - 1) * Spacing.l) + .padding(Spacing.s) + + Divider() + .background(Color.GrayGlass005) + + VStack(spacing: 0) { + Text("Your connected wallet may not support some of the networks available for this dApp") + .fixedSize(horizontal: false, vertical: true) + .font(.small400) + .foregroundColor(.Foreground300) + .multilineTextAlignment(.center) + + Button { + router.setRoute(Router.NetworkSwitchSubpage.whatIsANetwork) + analyticsService.track(.CLICK_NETWORK_HELP) + } label: { + HStack(spacing: Spacing.xxs) { + Image.Bold.questionMarkCircle + .resizable() + .frame(width: 12, height: 12) + + Text("What is a network") + } + .foregroundColor(.Blue100) + .font(.small600) + } + .padding(.vertical, Spacing.s) + .background(Color.clear) + .contentShape(Rectangle()) + } + .padding(.horizontal) + .padding(.top, Spacing.xs) + .padding(.bottom, Spacing.xl) + } + } + + private func gridElement(for chain: Chain) -> some View { + let isSelected = chain.id == store.selectedChain?.id + let currentChains = viewModel.getChains() + let currentMethods = viewModel.getMethods() + let needToSendSwitchRequest = currentMethods.contains("wallet_switchEthereumChain") + let isChainApproved = store.account != nil ? currentChains.contains(chain) : true + + return Button(action: { + analyticsService.track(.SWITCH_NETWORK(network: chain)) + if store.account == nil { + store.selectedChain = chain + router.setRoute(Router.ConnectingSubpage.connectWallet) + } else if isChainApproved, !needToSendSwitchRequest { + store.selectedChain = chain + router.setRoute(Router.AccountSubpage.profile) + } else { + router.setRoute(Router.NetworkSwitchSubpage.networkDetail(chain)) + } + }, label: { + Text(chain.chainName) + }) + .buttonStyle(W3MCardSelectStyle( + variant: .network, + imageContent: { + Image( + uiImage: store.chainImages[chain.imageId] ?? UIImage() + ) + .resizable() + }, + isSelected: isSelected + )) + .disabled({ + if isSelected { + return true + } + + if store.session == nil { + return false + } + + if needToSendSwitchRequest { + return false + } + + if !currentChains.contains(chain) { + return true + } + + return false + }()) + } + + private func modalHeader() -> some View { + HStack(spacing: 0) { + switch router.currentRoute as? Router.NetworkSwitchSubpage { + case .none: + EmptyView() + case .selectChain: + if router.previousRoute as? Router.AccountSubpage == .profile { + backButton() + } + default: + backButton() + } + + Spacer() + + (router.currentRoute as? Router.NetworkSwitchSubpage)?.title.map { title in + Text(title) + .font(.paragraph700) + } + + Spacer() + + closeButton() + } + .padding() + .frame(height: 64) + .frame(maxWidth: .infinity) + .foregroundColor(.Foreground100) + .overlay( + RoundedCorner(radius: 30, corners: [.topLeft, .topRight]) + .stroke(Color.GrayGlass005, lineWidth: 1) + ) + .cornerRadius(30, corners: [.topLeft, .topRight]) + } + + private func backButton() -> some View { + Button { + router.goBack() + } label: { + Image.Medium.chevronLeft + } + } + + private func closeButton() -> some View { + Button { + withAnimation { + store.isModalShown = false + } + } label: { + Image.Medium.xMark + } + } + + private func calculateNumberOfColumns() -> Int { + let itemWidth: CGFloat = 76 + + let screenWidth = UIScreen.main.bounds.width + let count = floor(screenWidth / itemWidth) + let spaceLeft = screenWidth.truncatingRemainder(dividingBy: itemWidth) + let spacing = spaceLeft / (count - 1) + let updatedCount = spacing < 4 ? count - 1 : count + + return Int(updatedCount) + } +} + +extension Router.NetworkSwitchSubpage { + var title: String? { + switch self { + case .selectChain: + return "Select network" + case .whatIsANetwork: + return "What is a network?" + case let .networkDetail(chain): + return chain.chainName + } + } +} diff --git a/Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailView.swift b/Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailView.swift new file mode 100644 index 000000000..af43a517a --- /dev/null +++ b/Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailView.swift @@ -0,0 +1,84 @@ +import SwiftUI + + +struct NetworkDetailView: View { + @EnvironmentObject var store: Store + + @ObservedObject var viewModel: NetworkDetailViewModel + + + var body: some View { + VStack { + content() + .onAppear { + viewModel.handle(.onAppear) + } + } + } + + @ViewBuilder + func content() -> some View { + VStack(spacing: 0) { + chainImage() + .padding(.top, 20) + .padding(.bottom, Spacing.l) + } + .padding(.horizontal) + .padding(.bottom, Spacing.xl * 2) + } + + func chainImage() -> some View { + VStack(spacing: Spacing.xs) { + ZStack { + Image( + uiImage: store.chainImages[viewModel.chain.imageId] ?? UIImage() + ) + .resizable() + .frame(width: 80, height: 80) + .clipShape(Polygon(count: 6, relativeCornerRadius: 0.25)) + .cornerRadius(Radius.m) + .backport.overlay(alignment: .bottomTrailing) { + Image.Bold.xMark + .resizable() + .foregroundColor(.Error100) + .frame(width: 10, height: 10) + .padding(5) + .background(Color.Error100.opacity(0.15)) + .clipShape(Circle()) + .padding(2) + .background(Color.Background125) + .clipShape(Circle()) + .opacity(viewModel.switchFailed ? 1 : 0) + .offset(x: 5, y: 5) + } + + if !viewModel.switchFailed { + DrawingProgressView(shape: .hexagon, color: .Blue100, lineWidth: 3, isAnimating: .constant(true)) + .frame(width: 90, height: 90) + } + } + .padding(.bottom, Spacing.s) + + Text(!viewModel.switchFailed ? "Approve in wallet" : "Switch declined") + .font(.paragraph500) + .foregroundColor(.Foreground100) + + Text(!viewModel.switchFailed ? "Accept connection request in your wallet" : "Switch can be declined if chain is not supported by a wallet or previous request is still active") + .font(.small500) + .foregroundColor(.Foreground200) + .multilineTextAlignment(.center) + + if viewModel.switchFailed { + Button { + viewModel.handle(.didTapRetry) + } label: { + Text("Try again") + .font(.small600) + .foregroundColor(.Blue100) + } + .padding(Spacing.xl) + .buttonStyle(W3MButtonStyle(size: .m, variant: .accent, leftIcon: Image.Bold.refresh)) + } + } + } +} diff --git a/Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailViewModel.swift b/Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailViewModel.swift new file mode 100644 index 000000000..e52911d1e --- /dev/null +++ b/Sources/Web3Modal/Screens/ChainSwitch/NetworkDetail/NetworkDetailViewModel.swift @@ -0,0 +1,243 @@ +import Combine +import SwiftUI + +final class NetworkDetailViewModel: ObservableObject { + enum Event { + case onAppear + case didTapRetry + } + + @Published var switchFailed: Bool = false + var triedAddingChain: Bool = false + + private var disposeBag = Set() + + var chain: Chain + let router: Router + let store: Store + + + init( + chain: Chain, + router: Router, + store: Store = .shared + ) { + + self.chain = chain + self.router = router + self.store = store + + Web3Modal.instance.sessionEventPublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] event, _, _ in + switch event.name { + case "chainChanged": + guard let chainReference = try? event.data.get(Int.self) else { + return + } + + self.store.selectedChain = ChainPresets.ethChains.first(where: { $0.chainReference == String(chainReference) }) + self.router.setRoute(Router.AccountSubpage.profile) + + case "accountsChanged": + + guard let account = try? event.data.get([String].self) else { + return + } + + let chainReference = account[0].split(separator: ":")[1] + + self.store.selectedChain = ChainPresets.ethChains.first(where: { $0.chainReference == String(chainReference) }) + self.router.setRoute(Router.AccountSubpage.profile) + default: + break + } + } + .store(in: &disposeBag) + + Web3Modal.instance.sessionResponsePublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] response in + + switch response.result { + case .response: + + print("Switch/Add chain success switching to: \(chain.chainName)") + + self.store.selectedChain = chain + self.router.setRoute(Router.AccountSubpage.profile) + case let .error(error): + + if error.message.contains("4001") { + // User declined + self.switchFailed = true + return + } + + if !self.triedAddingChain { + guard let from = store.selectedChain else { + return + } + + self.triedAddingChain = true + Task { + try? await self.addEthChain(from: from, to: chain) + } + } else { + self.switchFailed = true + } + } + } + .store(in: &disposeBag) + } + + func handle(_ event: Event) { + switch event { + case .onAppear, .didTapRetry: + triedAddingChain = false + switchFailed = false + + Task { @MainActor in + // Switch chain + await switchChain(chain) + } + } + } + + @MainActor + func switchChain(_ to: Chain) async { + guard let from = store.selectedChain else { return } + + do { + try await switchEthChain(from: from, to: to) + } catch { + Web3Modal.config.onError(error) + } + + guard let session = store.session else { return } + + if + let urlString = session.peer.redirect?.native ?? session.peer.redirect?.universal, + let url = URL(string: urlString) + { + DispatchQueue.main.async { + self.router.openURL(url) + } + } + } + + @MainActor + private func switchEthChain( + from: Chain, + to: Chain + ) async throws { + guard let chainIdNumber = Int(to.chainReference) else { return } + + switch store.connectedWith { + case .wc: + + let chainHex = String(format: "%X", chainIdNumber) + + guard let session = store.session else { return } + + try await Web3Modal.instance.request(params: + .init( + topic: session.topic, + method: EthUtils.walletSwitchEthChain, + params: AnyCodable([AnyCodable(ChainSwitchParams(chainId: "0x\(chainHex)"))]), + chainId: .init(from.id)! + ) + ) + case .cb: + try await Web3Modal.instance.request(.wallet_switchEthereumChain(chainId: to.chainReference)) + case .none: + break + } + } + + @MainActor + private func addEthChain( + from: Chain, + to: Chain + ) async throws { + + guard let addChainParams = createAddEthChainParams(chain: to) else { + return + } + + switch store.connectedWith { + case .wc: + + guard let session = store.session else { return } + + try await Web3Modal.instance.request(params: + .init( + topic: session.topic, + method: EthUtils.walletAddEthChain, + params: AnyCodable([AnyCodable(addChainParams)]), + chainId: .init(from.id)! + ) + ) + case .cb: + try await Web3Modal.instance.request( + .wallet_addEthereumChain( + chainId: addChainParams.chainId, + blockExplorerUrls: addChainParams.blockExplorerUrls, + chainName: addChainParams.chainName, + iconUrls: addChainParams.iconUrls, + nativeCurrency: .init( + name: addChainParams.nativeCurrency.name, + symbol: addChainParams.nativeCurrency.symbol, + decimals: addChainParams.nativeCurrency.decimals + ), + rpcUrls: addChainParams.rpcUrls + )) + case .none: + break + } + } + + func createAddEthChainParams(chain: Chain) -> ChainAddParams? { + guard let chainIdNumber = Int(chain.chainReference) else { return nil } + + let chainHex = String(format: "%X", chainIdNumber) + + return ChainAddParams( + chainId: "0x\(chainHex)", + blockExplorerUrls: [ + chain.blockExplorerUrl + ], + chainName: chain.chainName, + nativeCurrency: .init( + name: chain.token.name, + symbol: chain.token.symbol, + decimals: chain.token.decimal + ), + rpcUrls: [ + chain.rpcUrl + ], + iconUrls: [ + chain.imageId + ] + ) + } + + struct ChainAddParams: Codable { + let chainId: String + let blockExplorerUrls: [String] + let chainName: String + let nativeCurrency: NativeCurrency + let rpcUrls: [String] + let iconUrls: [String] + + struct NativeCurrency: Codable { + let name: String + let symbol: String + let decimals: Int + } + } + + struct ChainSwitchParams: Codable { + let chainId: String + } +} diff --git a/Sources/Web3Modal/Screens/ChainSwitch/WhatIsNetworkView.swift b/Sources/Web3Modal/Screens/ChainSwitch/WhatIsNetworkView.swift new file mode 100644 index 000000000..7107001a7 --- /dev/null +++ b/Sources/Web3Modal/Screens/ChainSwitch/WhatIsNetworkView.swift @@ -0,0 +1,78 @@ +import SwiftUI + +struct WhatIsNetworkView: View { + @Environment(\.verticalSizeClass) var verticalSizeClass + + @EnvironmentObject var router: Router + + var body: some View { + content() + .onAppear { + UIPageControl.appearance().currentPageIndicatorTintColor = UIColor.Foreground100 + UIPageControl.appearance().pageIndicatorTintColor = UIColor.Foreground100.withAlphaComponent(0.2) + } + } + + func content() -> some View { + VStack(spacing: 0) { + if verticalSizeClass == .compact { + TabView { + ForEach(sections(), id: \.title) { section in + section + .padding(.bottom, 40) + } + } + .transform { + #if os(iOS) + if #available(iOS 14.0, *) { + $0.tabViewStyle(.page(indexDisplayMode: .always)) + } + #endif + } + .scaledToFill() + .layoutPriority(1) + + } else { + ForEach(sections(), id: \.title) { section in + section + .padding(.bottom, Spacing.s) + } + } + + Button(action: { + router.openURL(URL(string: "https://ethereum.org/en/developers/docs/networks/")!) + }) { + HStack { + Text("Learn More") + Image.Bold.externalLink + } + } + .buttonStyle(W3MButtonStyle(size: .s)) + } + .padding(.vertical, Spacing.xxl) + .padding(.horizontal, Spacing.xl) + } + + func sections() -> [HelpSection] { + [ + HelpSection( + title: "The system’s nuts and bolts", + description: "A network is what brings the blockchain to life, as this technical infrastructure allows apps to access the ledger and smart contract services.", + assets: [.imageNetwork, .imageLayers, .imageSystem] + ), + HelpSection( + title: "Designed for different uses", + description: "Each network is designed differently, and may therefore suit certain apps and experiences.", + assets: [.imageNoun, .imageDefiAlt, .imageDao] + ), + ] + } +} + +#if DEBUG +struct WhatIsNetworkView_Previews: PreviewProvider { + static var previews: some View { + WhatIsNetworkView() + } +} +#endif diff --git a/Sources/Web3Modal/Screens/ConnectWallet/AllWalletsView.swift b/Sources/Web3Modal/Screens/ConnectWallet/AllWalletsView.swift new file mode 100644 index 000000000..184aba222 --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/AllWalletsView.swift @@ -0,0 +1,201 @@ +import Combine +import SwiftUI +import UIKit + + +@available(iOS 14.0, *) +struct AllWalletsView: View { + @EnvironmentObject var router: Router + @EnvironmentObject var store: Store + @EnvironmentObject var interactor: W3MAPIInteractor + + @Environment(\.analyticsService) var analyticsService: AnalyticsService + + @EnvironmentObject var signInteractor: SignInteractor + + @State var searchTerm: String = "" + let searchTermPublisher = PassthroughSubject() + + private let semaphore = AsyncSemaphore(count: 1) + + var isSearching: Bool { + searchTerm.count >= 2 + } + + var body: some View { + content() + } + + @ViewBuilder + private func content() -> some View { + VStack(spacing: 0) { + HStack { + W3MTextField("Search wallet", text: $searchTerm) + .ignoresSafeArea(.keyboard, edges: .bottom) + + qrButton() + } + .padding(.horizontal) + .padding(.vertical, Spacing.xs) + + if isSearching { + searchGrid() + } else { + regularGrid() + } + } + .onAppear { + fetchWallets() + } + .animation(.default, value: isSearching) + .frame(maxHeight: UIScreen.main.bounds.height - 240) + .backport.onChange(of: searchTerm) { searchTerm in + searchTermPublisher.send(searchTerm) + } + .onReceive( + searchTermPublisher + .debounce(for: .milliseconds(500), scheduler: DispatchQueue.main) + .filter { string in + string.count >= 2 + } + .removeDuplicates() + ) { debouncedSearchTerm in + fetchWallets(search: debouncedSearchTerm) + } + .onReceive( + searchTermPublisher + .receive(on: DispatchQueue.main) + .removeDuplicates() + ) { searchTerm in + if searchTerm.count < 2 { + store.searchedWallets = [] + } + } + } + + @ViewBuilder + private func regularGrid() -> some View { + ScrollView { + LazyVGrid( + columns: Array( + repeating: GridItem(.flexible()), + count: calculateNumberOfColumns() + ), + spacing: Spacing.l + ) { + ForEach(store.wallets.sorted(by: { $0.order < $1.order }), id: \.self) { wallet in + gridElement(for: wallet) + } + + if interactor.isLoading || store.currentPage < store.totalPages { + ForEach(1 ... calculateNumberOfColumns() * 4, id: \.self) { _ in + Button(action: {}, label: { Text("Loading") }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { + Color.Overgray005.modifier(ShimmerBackground()) + }, + isLoading: .constant(true) + )) + } + .onAppear { + fetchWallets() + } + } + } + .padding(.horizontal, 12) + .padding(.bottom, 60) + } + } + + @ViewBuilder + private func searchGrid() -> some View { + Group { + ZStack(alignment: .center) { + Spacer().frame(maxWidth: .infinity, maxHeight: .infinity) + + ProgressView() + .opacity(interactor.isLoading ? 1 : 0) + + let columns = Array( + repeating: GridItem(.flexible()), + count: calculateNumberOfColumns() + ) + + ScrollView { + LazyVGrid(columns: columns, spacing: Spacing.l) { + ForEach(store.searchedWallets, id: \.self) { wallet in + gridElement(for: wallet) + } + } + .padding(.horizontal) + .padding(.bottom, 30) + } + } + } + .animation(.default, value: interactor.isLoading) + } + + private func gridElement(for wallet: Wallet) -> some View { + Button(action: { + Task { + do { + try await signInteractor.connect(walletUniversalLink: wallet.linkMode) + analyticsService.track(.SELECT_WALLET(name: wallet.name, platform: .mobile)) + router.setRoute(Router.ConnectingSubpage.walletDetail(wallet)) + } catch { + store.toast = .init(style: .error, message: error.localizedDescription) + } + } + }, label: { + Text(wallet.name) + }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { + if let storedImage = store.walletImages[wallet.id] { + Image(uiImage: storedImage) + .resizable() + } else { + Image.Regular.wallet + .resizable() + } + }, + isLoading: .constant(false) + )) + .id(wallet.id) + } + + private func fetchWallets(search: String = "") { + Task { + do { + try await semaphore.withTurn { + try await interactor.fetchWallets(search: search) + } + } catch { + store.toast = .init(style: .error, message: "Network error") + } + } + } + + private func qrButton() -> some View { + Button { + router.setRoute(Router.ConnectingSubpage.qr) + analyticsService.track(.SELECT_WALLET(name: "Unknown", platform: .qrcode)) + } label: { + Image.optionQrCode + } + } + + private func calculateNumberOfColumns() -> Int { + let itemWidth: CGFloat = 76 + + let screenWidth = UIScreen.main.bounds.width + let count = floor(screenWidth / itemWidth) + let spaceLeft = screenWidth.truncatingRemainder(dividingBy: itemWidth) + let spacing = spaceLeft / (count - 1) + let updatedCount = spacing < 4 ? count - 1 : count + + return Int(updatedCount) + } +} diff --git a/Sources/Web3Modal/Screens/ConnectWallet/ConnectWalletView.swift b/Sources/Web3Modal/Screens/ConnectWallet/ConnectWalletView.swift new file mode 100644 index 000000000..c80b0acfb --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/ConnectWalletView.swift @@ -0,0 +1,130 @@ +import SwiftUI + +struct ConnectWalletView: View { + @EnvironmentObject var store: Store + @EnvironmentObject var router: Router + + @Environment(\.analyticsService) var analyticsService: AnalyticsService + + @EnvironmentObject var signInteractor: SignInteractor + + let displayWCConnection = false + + var wallets: [Wallet] { + var recentWallets = store.recentWallets + + let result = (store.featuredWallets + store.customWallets).map { featuredWallet in + var featuredWallet = featuredWallet + let (index, matchingRecentWallet) = recentWallets.enumerated().first { (index, recentWallet) in + featuredWallet.id == recentWallet.id + } ?? (nil, nil) + + + if let match = matchingRecentWallet, let matchingIndex = index { + featuredWallet.lastTimeUsed = match.lastTimeUsed + recentWallets.remove(at: matchingIndex) + } + + return featuredWallet + } + + return (recentWallets + result) + } + + var body: some View { + VStack { + wcConnection() + + featuredWallets() + + Button(action: { + router.setRoute(Router.ConnectingSubpage.allWallets) + analyticsService.track(.CLICK_ALL_WALLETS) + }, label: { + Text("All wallets") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in + Image.optionAll + }, + tag: store.totalNumberOfWallets != 0 ? W3MTag(title: "\(store.totalNumberOfWallets)+", variant: .info) : nil + )) + } + .padding(Spacing.s) + .padding(.bottom) + } + + @ViewBuilder + private func featuredWallets() -> some View { + ForEach(wallets, id: \.self) { wallet in + Group { + let isRecent: Bool = wallet.lastTimeUsed != nil + let tagTitle: String? = isRecent ? "RECENT" : nil + + Button(action: { + Task { + do { + try await signInteractor.connect(walletUniversalLink: wallet.linkMode) + router.setRoute(Router.ConnectingSubpage.walletDetail(wallet)) + analyticsService.track(.SELECT_WALLET(name: wallet.name, platform: .mobile)) + } catch { + store.toast = .init(style: .error, message: error.localizedDescription) + } + } + }, label: { + Text(wallet.name) + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in + Group { + if let storedImage = store.walletImages[wallet.id] { + Image(uiImage: storedImage) + .resizable() + } else { + Image.Regular.wallet + .resizable() + .padding(Spacing.xxs) + } + } + .background(Color.Overgray005) + .backport.overlay { + RoundedRectangle(cornerRadius: Radius.xxxs) + .stroke(.Overgray010, lineWidth: 1) + } + }, + tag: tagTitle != nil ? .init(title: tagTitle!, variant: .info) : nil + )) + } + } + } + + @ViewBuilder + private func wcConnection() -> some View { + if displayWCConnection { + Button(action: { + router.setRoute(Router.ConnectingSubpage.qr) + }, label: { + Text("WalletConnect") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in + ZStack { + Color.Blue100 + + Image.imageLogo + .resizable() + .aspectRatio(contentMode: .fit) + .foregroundColor(.white) + } + }, + tag: W3MTag(title: "QR CODE", variant: .main) + )) + } + } +} + +struct ConnectWalletView_Previews: PreviewProvider { + static var previews: some View { + ConnectWalletView() + } +} diff --git a/Sources/Web3Modal/Screens/ConnectWallet/ConnectWithQRCode.swift b/Sources/Web3Modal/Screens/ConnectWallet/ConnectWithQRCode.swift new file mode 100644 index 000000000..980936b6a --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/ConnectWithQRCode.swift @@ -0,0 +1,89 @@ +import SwiftUI + + +struct ConnectWithQRCode: View { + + @EnvironmentObject var store: Store + @EnvironmentObject var signInteractor: SignInteractor + + var body: some View { + + VStack(spacing: Spacing.xl) { + if let uri = store.uri?.absoluteString { + + QRCodeView(uri: uri) + } else { + RoundedRectangle(cornerRadius: Radius.l) + .fill(.Overgray015) + .aspectRatio(1, contentMode: .fit) + .modifier(ShimmerBackground()) + } + + Text("Scan this QR code with your phone") + .font(.paragraph500) + .foregroundColor(.Foreground100) + + Button(action: { + UIPasteboard.general.string = store.uri?.absoluteString ?? "" + store.toast = .init(style: .success, message: "Link copied") + }, label: { + Text("Copy Link") + }) + .buttonStyle(W3MActionEntryStyle(leftIcon: .Bold.copy)) + .disabled(store.uri == nil) + } + .padding([.top, .horizontal], Spacing.xl) + .padding(.bottom, Spacing.l) + .padding(.bottom) + .background(Color.Background125) + .onAppear { + connect() + } + } + + private func connect() { + Task { + do { + try await signInteractor.connect(walletUniversalLink: nil) + } catch { + store.toast = .init(style: .error, message: "Failed to create connection URI.") + } + } + } +} + +struct ConnectWithQRCode_Previews: PreviewProvider { + static let stubUri: String = Array(repeating: ["a", "b", "c", "1", "2", "3"], count: 30) + .flatMap { $0 } + .shuffled() + .joined() + + static let store: Store = { + + let store = Store() + store.uri = WalletConnectURI( + string: "wc:de631d0009368177ec5b7dd26b5614536f6117c83236c15452f01f0f1c877529@2?symKey=61ee028ff757f897597cc367a4c2f359b34ec615764cae4dea6f41cdff53bf66&relay-protocol=irn" + ) + + return store + }() + + static var previews: some View { + VStack { + ConnectWithQRCode() + .environmentObject(store) + .environmentObject(MockSignInteractor(store: store)) + + ConnectWithQRCode() + .environmentObject(Store()) + .environmentObject(MockSignInteractor(store: Store())) + } + } + + class MockSignInteractor: SignInteractor { + + override func connect(walletUniversalLink: String?) async throws { + // no-op + } + } +} diff --git a/Sources/Web3Modal/Screens/ConnectWallet/GetAWalletView.swift b/Sources/Web3Modal/Screens/ConnectWallet/GetAWalletView.swift new file mode 100644 index 000000000..085a07240 --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/GetAWalletView.swift @@ -0,0 +1,87 @@ +import SwiftUI + + +struct GetAWalletView: View { + @EnvironmentObject var router: Router + @EnvironmentObject var store: Store + + var body: some View { + VStack { + ForEach(store.featuredWallets.prefix(4), id: \.self) { wallet in + Button(action: { + if let appstoreLink = wallet.appStore { + router.openURL(URL(string: appstoreLink)!) + } + }, label: { + Text(wallet.name) + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in + Group { + if let storedImage = store.walletImages[wallet.id] { + Image(uiImage: storedImage) + .resizable() + } else { + Image.Regular.wallet + .resizable() + .padding(Spacing.xxs) + } + } + .background( + RoundedRectangle(cornerRadius: Radius.xxxs) + .fill(.Overgray005) + ) + .backport.overlay { + RoundedRectangle(cornerRadius: Radius.xxxs) + .stroke(.Overgray010, lineWidth: 1) + } + } + )) + } + + Button(action: { + router.openURL(URL(string: "https://walletconnect.com/explorer?type=wallet")!) + }, label: { + Text("Explore all") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in + Image.optionAll + } + )) + .backport.overlay(alignment: .trailing) { + Image.Bold.externalLink + .resizable() + .frame(width: 14, height: 14) + .foregroundColor(.Foreground200) + .padding(.trailing, Spacing.l) + } + } + .padding(Spacing.s) + .padding(.bottom) + } +} + +#if DEBUG + +struct GetAWalletView_Previews: PreviewProvider { + static let store = { + let store = Store() + store.featuredWallets = Wallet.stubList + + for id in Wallet.stubList.map(\.imageId).compactMap({ $0 }).prefix(2) { + store.walletImages[id] = UIImage( + named: "MockWalletImage", in: .coreModule, compatibleWith: nil + ) + } + + return store + }() + + static var previews: some View { + GetAWalletView() + .environmentObject(GetAWalletView_Previews.store) + } +} + +#endif diff --git a/Sources/Web3Modal/Screens/ConnectWallet/QRCodeView.swift b/Sources/Web3Modal/Screens/ConnectWallet/QRCodeView.swift new file mode 100644 index 000000000..169792f5c --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/QRCodeView.swift @@ -0,0 +1,187 @@ +import QRCode +import SwiftUI + +struct QRCodeView: View { + let uri: String + var imageData: Data? = nil + + @Environment(\.colorScheme) var colorScheme + + var body: some View { + let size: CGSize = .init( + width: UIScreen.main.bounds.width - Spacing.xl * 2, + height: UIScreen.main.bounds.height * 0.4 + ) + + VStack(alignment: .center) { + render( + content: uri, + size: .init(width: size.width, height: size.width) + ) + .id(colorScheme) + .colorScheme(.light) + .cornerRadius(Radius.l) + } + } + + @MainActor private func render(content: String, size: CGSize) -> Image { + let doc = QRCode.Document( + utf8String: content, + errorCorrection: .quantize + ) + doc.design.shape.eye = QRCode.EyeShape.Squircle2() + doc.design.shape.onPixels = QRCode.PixelShape.Vertical( + insetFraction: 0.15, + cornerRadiusFraction: 1 + ) + + doc.design.additionalQuietZonePixels = 2 + + doc.design.style.eye = QRCode.FillStyle.Solid(UIColor.Foreground100.cgColor) + doc.design.style.pupil = QRCode.FillStyle.Solid(UIColor.Foreground100.cgColor) + doc.design.style.onPixels = QRCode.FillStyle.Solid(UIColor.Foreground100.cgColor) + doc.design.style.background = QRCode.FillStyle.Solid(UIColor.Background125.cgColor) + + let uiImage = imageData != nil ? + UIImage(data: imageData!) : + UIImage(named: "imageLogo", in: .coreModule, compatibleWith: nil)?.withColor(UIColor.Blue100) + + if let uiImage = uiImage { + let cgImage = uiImage.cgImage! + + let logoSize = 0.25 + let pathWidth = logoSize * (uiImage.size.width / uiImage.size.height) + let pathHeight = logoSize + + doc.logoTemplate = QRCode.LogoTemplate( + image: cgImage, + path: CGPath( + rect: CGRect(x: (1 - pathWidth) / 2, y: (1 - pathHeight) / 2, width: pathWidth, height: pathHeight), + transform: nil + ), + inset: 20 + ) + } + return doc.imageUI( + size.applying(.init(scaleX: 3, y: 3)), + dpi: 72 * 3, + label: Text("QR code with URI") + )! + } +} + +private extension UIImage { + func withColor(_ color: UIColor) -> UIImage? { + UIGraphicsBeginImageContextWithOptions(size, false, scale) + let drawRect = CGRect(x: 0, y: 0, width: size.width, height: size.height) + color.setFill() + UIRectFill(drawRect) + draw(in: drawRect, blendMode: .destinationIn, alpha: 1) + let tintedImage = UIGraphicsGetImageFromCurrentImageContext() + UIGraphicsEndImageContext() + return tintedImage! + } +} + +#if DEBUG +public struct QRCodeViewPreviewView: View { + public init() {} + + static let stubUri: String = Array(repeating: ["a", "b", "c", "1", "2", "3"], count: 10) + .flatMap { $0 } + .joined() + + public var body: some View { + VStack { + QRCodeView( + uri: QRCodeViewPreviewView.stubUri, + imageData: UIImage(named: "MockWalletImage", in: .coreModule, compatibleWith: nil)?.pngData() + ) + .previewLayout(.sizeThatFits) + + QRCodeView(uri: QRCodeViewPreviewView.stubUri) + } + } +} + +struct QRCodeView_Previews: PreviewProvider { + static var previews: some View { + QRCodeViewPreviewView() + .previewLayout(.sizeThatFits) + } +} +#endif + +extension QRCode.EyeShape { + /// A 'squircle' eye style + @objc(QRCodeEyeShapeSquircle2) class Squircle2: NSObject, QRCodeEyeShapeGenerator { + @objc public static let Name = "squircle" + @objc public static var Title: String { "Squircle2" } + @objc public static func Create(_ settings: [String: Any]?) -> QRCodeEyeShapeGenerator { + return QRCode.EyeShape.Squircle2() + } + + @objc public func settings() -> [String: Any] { return [:] } + @objc public func supportsSettingValue(forKey key: String) -> Bool { false } + @objc public func setSettingValue(_ value: Any?, forKey key: String) -> Bool { false } + + /// Make a copy of the object + @objc public func copyShape() -> QRCodeEyeShapeGenerator { + return Self.Create(settings()) + } + + public func eyePath() -> CGPath { + + let strokeWidth: CGFloat = 10 + let size: CGFloat = 65 + let cornerRadius: CGFloat = min(25, size/2) + let offset: CGFloat = (90 - size) / 2 + + let path = CGMutablePath() + path.addRoundedRect(in: CGRect(x: offset, y: offset, width: size, height: size), cornerWidth: cornerRadius, cornerHeight: cornerRadius) + + return path.copy(strokingWithWidth: strokeWidth, lineCap: .round, lineJoin: .round, miterLimit: 1) + } + + @objc public func eyeBackgroundPath() -> CGPath { + CGPath(rect: CGRect(origin: .zero, size: CGSize(width: 90, height: 90)), transform: nil) + } + + private static let _defaultPupil = QRCode.PupilShape.Squircle2() + public func defaultPupil() -> QRCodePupilShapeGenerator { Self._defaultPupil } + } +} + + +extension QRCode.PupilShape { + /// A 'squircle' pupil style + @objc(QRCodePupilShapeSquircle2) class Squircle2: NSObject, QRCodePupilShapeGenerator { + @objc public static var Name: String { "squircle2" } + /// The generator title + @objc public static var Title: String { "Squircle2" } + + @objc public static func Create(_ settings: [String : Any]?) -> QRCodePupilShapeGenerator { + Squircle2() + } + + /// Make a copy of the object + @objc public func copyShape() -> QRCodePupilShapeGenerator { Squircle2() } + + @objc public func settings() -> [String : Any] { [:] } + @objc public func supportsSettingValue(forKey key: String) -> Bool { false } + @objc public func setSettingValue(_ value: Any?, forKey key: String) -> Bool { false } + + /// The pupil centered in the 90x90 square + @objc public func pupilPath() -> CGPath { + + let size: CGFloat = 35 + let cornerRadius: CGFloat = min(12, size/2) + let offset: CGFloat = (90 - size) / 2 + + let path = CGMutablePath() + path.addRoundedRect(in: CGRect(x: offset, y: offset, width: size, height: size), cornerWidth: cornerRadius, cornerHeight: cornerRadius) + + return path + } + } +} diff --git a/Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailView.swift b/Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailView.swift new file mode 100644 index 000000000..bc7f5aba9 --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailView.swift @@ -0,0 +1,347 @@ +import SwiftUI + +struct WalletDetailView: View { + @Environment(\.verticalSizeClass) var verticalSizeClass + + @EnvironmentObject var store: Store + + @ObservedObject var viewModel: WalletDetailViewModel + + var body: some View { + content() + .onAppear { + DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { + viewModel.handle(.onAppear) + } + } + } + + @ViewBuilder + func content() -> some View { + VStack(spacing: 0) { + if viewModel.showToggle { + picker() + } + + walletInfo() + + if viewModel.wallet.isInstalled == true && !store.SIWEFallbackState { + copyLink() + } + + if + viewModel.preferredPlatform == .mobile, + viewModel.wallet.isInstalled != true, + viewModel.wallet.appStore != nil + { + appStoreRow() + } + + if store.SIWEFallbackState { + siweFallbackButtons() + } + } + .padding(.horizontal, Spacing.s) + .padding(.bottom, Spacing.xl + 17) + } + + private func siweFallbackButtons() -> some View { + HStack { + Button(action: { + Task { + try await viewModel.cancel() + } + }) { + Text("Cancel") + .foregroundColor(.black) + .padding() + .frame(maxWidth: .infinity) + .background(Color.gray.opacity(0.2)) + .cornerRadius(8) + } + + Button(action: { + Task { + try await viewModel.signSIWE() + } + }) { + Text("Sign") + .foregroundColor(.white) + .padding() + .frame(maxWidth: .infinity) + .background(Color.blue) + .cornerRadius(8) + } + } + .padding(.horizontal, 20) + .padding(.bottom, 20) + } + + private func picker() -> some View { + W3MPicker( + WalletDetailViewModel.Platform.allCases, + selection: viewModel.preferredPlatform + ) { item in + + HStack { + switch item { + case .mobile: + Image.Bold.mobile + case .browser: + Image.Bold.browser + } + + Text(item.rawValue.capitalized) + } + .font(.small500) + .multilineTextAlignment(.center) + .foregroundColor(viewModel.preferredPlatform == item ? .Foreground100 : .Foreground200) + .frame(maxWidth: .infinity) + .contentShape(Rectangle()) + .onTapGesture { + withAnimation(.easeInOut(duration: 0.15)) { + viewModel.preferredPlatform = item + } + } + } + .frame(maxWidth: 200) + .padding(.top, Spacing.l) + } + + private func copyLink() -> some View { + Button { + viewModel.handle(.didTapCopy) + } label: { + HStack(spacing: Spacing.xxxs) { + Image.Bold.copy + .resizable() + .frame(width: 12, height: 12) + Text("Copy link") + } + .font(.small600) + .foregroundColor(.Foreground200) + .padding(Spacing.xs) + } + .padding(.bottom, Spacing.xl) + } + + private func walletImage() -> some View { + return ZStack { + Image( + uiImage: store.walletImages[viewModel.wallet.id] ?? UIImage() + ) + .resizable() + .frame(width: 80, height: 80) + .cornerRadius(Radius.m) + .backport.overlay(alignment: .bottomTrailing) { + Image.Bold.xMark + .resizable() + .foregroundColor(.Error100) + .frame(width: 10, height: 10) + .padding(5) + .background(Color.Error100.opacity(0.15)) + .clipShape(Circle()) + .padding(2) + .background(Color.Background125) + .clipShape(Circle()) + .opacity(store.retryShown ? 1 : 0) + .offset(x: 5, y: 5) + } + + if !store.retryShown { + DrawingProgressView( + shape: .roundedRectangleRelative(relativeCornerRadius: Radius.m / 80), + color: .Blue100, + lineWidth: 3, + isAnimating: .constant(true) + ) + .frame(width: 90, height: 90) + } + } + } + + private func retryButton() -> some View { + return Button { + viewModel.handle(.didTapOpen) + } label: { + HStack { + Text(!store.retryShown ? "Open" : "Try again") + } + .font(.small600) + .foregroundColor(.Blue100) + } + .buttonStyle( + W3MButtonStyle( + size: .m, + variant: .accent, + leftIcon: store.retryShown ? Image.Bold.refresh : nil, + rightIcon: store.retryShown ? nil : Image.Bold.externalLink + ) + ) + } + + private func walletInfo() -> some View { + VStack(spacing: 0) { + walletImage() + .padding(.top, 40) + .padding(.bottom, Spacing.xl) + + Text(store.SIWEFallbackState ? "Web3Modal needs to connect to your wallet." : (store.retryShown ? "Connection declined" : "Continue in \(viewModel.wallet.name)")) + .font(.paragraph600) + .foregroundColor(store.retryShown ? .Error100 : .Foreground100) + .padding(.bottom, Spacing.xs) + + Text( + store.SIWEFallbackState + ? "Sign this message to prove you own this wallet and proceed. Cancelling will disconnect you." + : (store.retryShown + ? "Connection can be declined if a previous request is still active" + : viewModel.preferredPlatform == .browser ? "Open and continue in a new browser tab" : "Accept connection request in the wallet") + ) + .font(.small500) + .foregroundColor(.Foreground200) + .multilineTextAlignment(.center) + .padding(.bottom, Spacing.l) + + if store.retryShown || viewModel.preferredPlatform == .browser { + retryButton() + } + } + } + + func appStoreRow() -> some View { + HStack(spacing: 0) { + Text("Don't have \(viewModel.wallet.name)?") + .font(.paragraph500) + .foregroundColor(.Foreground200) + + Spacer() + + Button { + viewModel.handle(.didTapAppStore) + } label: { + Text("Get") + } + .buttonStyle(GetWalletButtonStyle()) + } + .padding() + .frame(height: 56) + .background(Color.GrayGlass002) + .cornerRadius(Radius.xs) + } + + struct GetWalletButtonStyle: ButtonStyle { + func makeBody(configuration: Configuration) -> some View { + HStack(spacing: Spacing.xxxs) { + configuration.label + Image.Bold.chevronRight + .resizable() + .frame(width: 12, height: 12) + } + .font(.small600) + .foregroundColor(.Blue100) + .padding([.vertical, .trailing], Spacing.xs) + .padding(.leading, Spacing.s) + .background(configuration.isPressed ? Color.GrayGlass010 : Color.clear) + .backport.overlay { + Capsule() + .stroke(.GrayGlass010, lineWidth: 1) + } + .clipShape(Capsule()) + } + } +} + +#if DEBUG + +class MockSignInteractor: SignInteractor { + override func connect(walletUniversalLink: String?) async throws { + // no-op + } + + override func disconnect() async throws { + // no-op + } +} + +class MockWalletDetailViewModel: WalletDetailViewModel { + convenience init(retryShown: Bool, isInstalled: Bool, store: Store) { + var wallet = Wallet.stubList.first! + wallet.isInstalled = isInstalled + + self.init( + wallet: wallet, + router: Router(), + signInteractor: MockSignInteractor(store: store), + store: store + ) + +// self.retryShown = retryShown + } + + override func startObserving() { + // no-op + } + + override func handle(_ event: Event) { + // no-op + } +} + +struct WalletDetailView_Preview: PreviewProvider { + static let store = { + let store = Store() + store.walletImages["0528ee7e-16d1-4089-21e3-bbfb41933100"] = UIImage( + named: "MockWalletImage", in: .coreModule, compatibleWith: nil + ) + + return store + }() + + static var previews: some View { + ScrollView { + WalletDetailView( + viewModel: MockWalletDetailViewModel( + retryShown: false, + isInstalled: false, + store: WalletDetailView_Preview.store + ) + ) + + Divider() + + WalletDetailView( + viewModel: MockWalletDetailViewModel( + retryShown: true, + isInstalled: false, + store: WalletDetailView_Preview.store + ) + ) + + Divider() + + WalletDetailView( + viewModel: MockWalletDetailViewModel( + retryShown: true, + isInstalled: true, + store: WalletDetailView_Preview.store + ) + ) + + Divider() + + WalletDetailView( + viewModel: MockWalletDetailViewModel( + retryShown: false, + isInstalled: true, + store: WalletDetailView_Preview.store + ) + ) + + Divider() + } + .environmentObject(WalletDetailView_Preview.store) + } +} + +#endif diff --git a/Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailViewModel.swift b/Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailViewModel.swift new file mode 100644 index 000000000..0018b52e4 --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/WalletDetail/WalletDetailViewModel.swift @@ -0,0 +1,242 @@ +import SwiftUI +import Combine + +class WalletDetailViewModel: ObservableObject { + enum Platform: String, CaseIterable, Identifiable { + case mobile + case browser + + var id: Self { self } + } + + enum Event { + case onAppear + case didTapOpen + case didTapAppStore + case didTapCopy + } + + let wallet: Wallet + let router: Router + let store: Store + let signInteractor: SignInteractor + + + @Published var preferredPlatform: Platform = .mobile + + private var disposeBag = Set() + + var showToggle: Bool { + hasWebAppLink && hasMobileLink && wallet.isInstalled != true + } + + var hasWebAppLink: Bool { wallet.webappLink?.isEmpty == false } + var hasMobileLink: Bool { wallet.mobileLink?.isEmpty == false } + + init( + wallet: Wallet, + router: Router, + signInteractor: SignInteractor, + store: Store = .shared + ) { + self.wallet = wallet + self.router = router + self.store = store + self.signInteractor = signInteractor + preferredPlatform = wallet.mobileLink != nil ? .mobile : .browser + + startObserving() + } + + func startObserving() { + Web3Modal.instance.sessionRejectionPublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] _, _ in + self?.store.retryShown = true + } + .store(in: &disposeBag) + } + + func cancel() async throws { + store.SIWEFallbackState = false + guard let topic = store.session?.topic else { return } + try await Web3Modal.instance.disconnect(topic: topic) + } + + func signSIWE() async throws { + DispatchQueue.main.async { [weak self] in + self?.store.SIWEFallbackState = false + } + guard let account = store.account?.account(), + let authRequestParams = Web3Modal.config.authRequestParams, + let topic = Web3Modal.instance.getSessions().first?.topic, + let chain = Web3Modal.instance.getSelectedChain(), + let blockchain = Blockchain(namespace: chain.chainNamespace, reference: chain.chainReference) + else { return } + + let authPayload = AuthPayload(requestParams: authRequestParams, iat: DefaultIATProvider().iat) + let siweMessage = try Sign.instance.formatAuthMessage(payload: authPayload, account: account) + + + let rpcRequest = try Request(topic: topic, method: "personal_sign", params: AnyCodable([siweMessage, account.address]), chainId: blockchain) + try await Sign.instance.request(params: rpcRequest) + + store.siweRequestId = rpcRequest.id + store.siweMessage = siweMessage + + DispatchQueue.main.async { [weak self] in + guard let self = self else { return } + self.navigateToWallet( + wallet: self.wallet, + preferBrowser: preferredPlatform == .browser + ) + } + } + + func handle(_ event: Event) { + switch event { + case .didTapCopy: + UIPasteboard.general.string = store.uri?.absoluteString ?? "" + store.toast = .init(style: .success, message: "Link copied") + case .onAppear: + + if wallet.alternativeConnectionMethod == nil { + + navigateToWalletWithPairingUri( + wallet: wallet, + preferBrowser: preferredPlatform == .browser + ) + } else { + wallet.alternativeConnectionMethod?() + } + + var wallet = wallet + wallet.lastTimeUsed = Date() + + store.recentWallets.append(wallet) + case .didTapOpen: + store.retryShown = false + + if wallet.alternativeConnectionMethod == nil { + navigateToWalletWithPairingUri( + wallet: wallet, + preferBrowser: preferredPlatform == .browser + ) + } else { + wallet.alternativeConnectionMethod?() + } + + case .didTapAppStore: + openAppstore(wallet: wallet) + } + } + + private func openAppstore(wallet: Wallet) { + guard + let storeLinkString = wallet.appStore, + let storeLink = URL(string: storeLinkString) + else { return } + + router.openURL(storeLink) + } + + private func navigateToWallet(wallet: Wallet, preferBrowser: Bool) { + do { + let link = preferBrowser ? wallet.webappLink : wallet.mobileLink + if let url = link?.toURL() { + router.openURL(url) { success in + self.store.toast = .init(style: .error, message: DeeplinkErrors.failedToOpen.localizedDescription) + } + } else { + throw DeeplinkErrors.noWalletLinkFound + } + } catch { + store.toast = .init(style: .error, message: error.localizedDescription) + Web3Modal.config.onError(error) + } + } + + private func navigateToWalletWithPairingUri(wallet: Wallet, preferBrowser: Bool) { + do { + let link = preferBrowser ? wallet.webappLink : wallet.mobileLink + + let urlString = try formatNativeUrlString(link) + if let url = urlString?.toURL() { + router.openURL(url) { success in + self.store.toast = .init(style: .error, message: DeeplinkErrors.failedToOpen.localizedDescription) + } + } else { + throw DeeplinkErrors.noWalletLinkFound + } + } catch { + store.toast = .init(style: .error, message: error.localizedDescription) + Web3Modal.config.onError(error) + } + } + + enum DeeplinkErrors: LocalizedError { + case noWalletLinkFound + case uriNotCreated + case failedToOpen + + var errorDescription: String? { + switch self { + case .noWalletLinkFound: + return NSLocalizedString("No valid link for opening given wallet found", comment: "") + case .uriNotCreated: + return NSLocalizedString("Couldn't generate link due to missing connection URI", comment: "") + case .failedToOpen: + return NSLocalizedString("Given link couldn't be opened", comment: "") + } + } + } + + private func isHttpUrl(url: String) -> Bool { + return url.hasPrefix("http://") || url.hasPrefix("https://") + } + + private func formatNativeUrlString(_ string: String?) throws -> String? { + guard let string = string, !string.isEmpty else { return nil } + + if isHttpUrl(url: string) { + return try formatUniversalUrlString(string) + } + + var safeAppUrl = string + if !safeAppUrl.contains("://") { + safeAppUrl = safeAppUrl.replacingOccurrences(of: "/", with: "").replacingOccurrences(of: ":", with: "") + safeAppUrl = "\(safeAppUrl)://" + } + + guard let deeplinkUri = store.uri?.deeplinkUri else { + throw DeeplinkErrors.uriNotCreated + } + + return "\(safeAppUrl)wc?uri=\(deeplinkUri)" + } + + private func formatUniversalUrlString(_ string: String?) throws -> String? { + guard let string = string, !string.isEmpty else { return nil } + + if !isHttpUrl(url: string) { + return try formatNativeUrlString(string) + } + + var plainAppUrl = string + if plainAppUrl.hasSuffix("/") { + plainAppUrl = String(plainAppUrl.dropLast()) + } + + guard let deeplinkUri = store.uri?.deeplinkUri else { + throw DeeplinkErrors.uriNotCreated + } + + return "\(plainAppUrl)/wc?uri=\(deeplinkUri)" + } +} + +private extension String { + func toURL() -> URL? { + URL(string: self) + } +} diff --git a/Sources/Web3Modal/Screens/ConnectWallet/WhatIsWalletView.swift b/Sources/Web3Modal/Screens/ConnectWallet/WhatIsWalletView.swift new file mode 100644 index 000000000..29069012e --- /dev/null +++ b/Sources/Web3Modal/Screens/ConnectWallet/WhatIsWalletView.swift @@ -0,0 +1,116 @@ +import SwiftUI + +struct WhatIsWalletView: View { + @Environment(\.verticalSizeClass) var verticalSizeClass + + @EnvironmentObject var router: Router + @Environment(\.analyticsService) var analyticsService: AnalyticsService + + var body: some View { + content() + .onAppear { + UIPageControl.appearance().currentPageIndicatorTintColor = UIColor.Foreground100 + UIPageControl.appearance().pageIndicatorTintColor = UIColor.Foreground100.withAlphaComponent(0.2) + } + } + + func content() -> some View { + VStack(spacing: 0) { + if verticalSizeClass == .compact { + TabView { + ForEach(sections(), id: \.title) { section in + section + .padding(.bottom, 40) + } + } + .transform { + #if os(iOS) + if #available(iOS 14.0, *) { + $0.tabViewStyle(.page(indexDisplayMode: .always)) + } + #endif + } + .scaledToFill() + .layoutPriority(1) + + } else { + ForEach(sections(), id: \.title) { section in + section + .padding(.bottom, Spacing.xxl) + } + } + + HStack { + Button(action: { + router.setRoute(Router.ConnectingSubpage.getWallet) + analyticsService.track(.CLICK_GET_WALLET) + }) { + HStack { + Image.Bold.wallet + Text("Get a wallet") + } + } + } + .buttonStyle(W3MButtonStyle(size: .s)) + } + .padding(.vertical, 40) + .padding(.horizontal, 40) + } + + func sections() -> [HelpSection] { + [ + HelpSection( + title: "One login for all of web3", + description: "Log in to any app by connecting your wallet. Say goodbye to countless passwords!", + assets: [.imageLogin, .imageProfile, .imageLock] + ), + HelpSection( + title: "A home for your digital assets", + description: "A wallet lets you store, send and receive digital assets like cryptocurrencies and NFTs.", + assets: [.imageDeFi, .imageNft, .imageEth] + ), + HelpSection( + title: "Your gateway to a new web", + description: "With your wallet, you can explore and interact with DeFi, NFTs, DAOs, and much more.", + assets: [.imageBrowser, .imageNoun, .imageDao] + ) + ] + } +} + +struct HelpSection: View { + let title: String + let description: String + let assets: [Image] + + var body: some View { + VStack(spacing: Spacing.zero) { + HStack(spacing: Spacing.s) { + ForEach(assets.indices, id: \.self) { index in + assets[index] + } + } + .padding(.bottom, Spacing.xl) + + Text(title) + .font(.paragraph500) + .foregroundColor(.Foreground100) + .multilineTextAlignment(.center) + .padding(.bottom, Spacing.xs) + Text(description) + .font(.small500) + .foregroundColor(.Foreground200) + .multilineTextAlignment(.center) + .fixedSize(horizontal: false, vertical: true) + .padding(.bottom, Spacing.s) + } + } +} + +#if DEBUG +struct WhatIsWalletView_Previews: PreviewProvider { + static var previews: some View { + WhatIsWalletView() + } +} +#endif diff --git a/Sources/Web3Modal/Sheets/ModalContainerView.swift b/Sources/Web3Modal/Sheets/ModalContainerView.swift new file mode 100644 index 000000000..1724badac --- /dev/null +++ b/Sources/Web3Modal/Sheets/ModalContainerView.swift @@ -0,0 +1,105 @@ +import SwiftUI + +struct ModalContainerView: View { + @Environment(\.presentationMode) var presentationMode + + @Environment(\.analyticsService) var analyticsService + + @ObservedObject var store: Store + @Backport.StateObject var router: Router + @Backport.StateObject var web3modalViewModel: Web3ModalViewModel + + init(store: Store = .shared, router: Router) { + self.store = store + _router = Backport.StateObject(wrappedValue: router) + _web3modalViewModel = Backport.StateObject( + wrappedValue: Web3Modal.viewModel + ) + } + + var body: some View { + ZStack { + Color.Overgray020 + .colorScheme(.light) + .opacity(store.isModalShown ? 1 : 0) + .transform { + #if os(iOS) + $0.onTapGesture { + withAnimation { + store.isModalShown = false + store.connecting = false + } + } + #endif + } + + VStack(spacing: 0) { + Spacer() + .background(Color.clear) + + if store.isModalShown { + Group { + switch router.currentRoute { + case _ where router.currentRoute as? Router.AccountSubpage != nil: + AccountView() + case _ where router.currentRoute as? Router.ConnectingSubpage != nil: + Web3ModalView( + viewModel: web3modalViewModel + ) + case _ where router.currentRoute as? Router.NetworkSwitchSubpage != nil: + ChainSelectView( + viewModel: web3modalViewModel + ) + default: + EmptyView() + } + } + .toastView(toast: $store.toast) + .transition(.move(edge: .bottom)) + .animation(.spring(), value: store.isModalShown) + .environmentObject(web3modalViewModel.router) + .environmentObject(web3modalViewModel.store) + .environmentObject(web3modalViewModel.w3mApiInteractor) + .environmentObject(web3modalViewModel.signInteractor) + .environmentObject(web3modalViewModel.blockchainApiInteractor) + } + } + } + .edgesIgnoringSafeArea(.all) + .backport.onChange(of: store.isModalShown, perform: { newValue in + if newValue { + let connected = store.account != nil + + analyticsService.track(.MODAL_OPEN(connected: connected)) + } else { + withAnimation { + self.dismiss() + store.connecting = false + } + } + }) + .onAppear { + withAnimation { + store.isModalShown = true + } + } + } + + private func dismiss() { + + let connected = store.account != nil + analyticsService.track(.MODAL_CLOSE(connected: connected)) + + // Small delay so the sliding transition can happen before cross disolve starts + DispatchQueue.main.asyncAfter(deadline: .now() + 0.2) { + self.presentationMode.wrappedValue.dismiss() + } + } +} + +@available(iOS 14.0, *) +struct ModalContainerView_Previews: PreviewProvider { + static var previews: some View { + ModalContainerView(router: Router()) + } +} diff --git a/Sources/Web3Modal/Sheets/Web3ModalSheetController.swift b/Sources/Web3Modal/Sheets/Web3ModalSheetController.swift new file mode 100644 index 000000000..7ecd9f302 --- /dev/null +++ b/Sources/Web3Modal/Sheets/Web3ModalSheetController.swift @@ -0,0 +1,20 @@ +import SwiftUI +import UIKit + +class Web3ModalSheetController: UIHostingController { + @available(*, unavailable) + @MainActor dynamic required init?(coder aDecoder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } + + init(router: Router) { + super.init(rootView: ModalContainerView(router: router)) + self.modalTransitionStyle = .crossDissolve + self.modalPresentationStyle = .overFullScreen + } + + override func viewDidLoad() { + super.viewDidLoad() + self.view.backgroundColor = .clear + } +} diff --git a/Sources/Web3Modal/Sheets/Web3ModalView.swift b/Sources/Web3Modal/Sheets/Web3ModalView.swift new file mode 100644 index 000000000..0a17f57a7 --- /dev/null +++ b/Sources/Web3Modal/Sheets/Web3ModalView.swift @@ -0,0 +1,144 @@ +import SwiftUI + +struct Web3ModalView: View { + @ObservedObject var viewModel: Web3ModalViewModel + + @EnvironmentObject var signInteractor: SignInteractor + @EnvironmentObject var store: Store + @EnvironmentObject var router: Router + + @Environment(\.analyticsService) var analyticsService: AnalyticsService + + var body: some View { + VStack(spacing: 0) { + modalHeader() + routes() + } + .background(Color.Background125) + .cornerRadius(30, corners: [.topLeft, .topRight]) + } + + @ViewBuilder + private func routes() -> some View { + switch router.currentRoute as? Router.ConnectingSubpage { + case .none: + EmptyView() + case .connectWallet: + ConnectWalletView() + case .allWallets: + if #available(iOS 14.0, *) { + AllWalletsView() + } else { + Text("Please upgrade to iOS 14 to use this feature") + } + case .qr: + ConnectWithQRCode() + case .whatIsAWallet: + WhatIsWalletView() + case let .walletDetail(wallet): + WalletDetailView( + viewModel: .init( + wallet: wallet, + router: router, + signInteractor: signInteractor, + store: store + ) + ) + case .getWallet: + GetAWalletView() + } + } + + private func modalHeader() -> some View { + HStack(spacing: 0) { + switch router.currentRoute as? Router.ConnectingSubpage { + case .none: + EmptyView() + case .connectWallet: + helpButton() + default: + backButton() + } + + Spacer() + + (router.currentRoute as? Router.ConnectingSubpage)?.title.map { title in + Text(title) + .font(.paragraph700) + } + + Spacer() + + closeButton() + } + .padding() + .frame(height: 64) + .frame(maxWidth: .infinity) + .foregroundColor(.Foreground100) + .overlay( + RoundedCorner(radius: 30, corners: [.topLeft, .topRight]) + .stroke(Color.GrayGlass005, lineWidth: 1) + ) + .cornerRadius(30, corners: [.topLeft, .topRight]) + } + + private func helpButton() -> some View { + Button(action: { + router.setRoute(Router.ConnectingSubpage.whatIsAWallet) + analyticsService.track(.CLICK_WALLET_HELP) + }, label: { + Image.Medium.questionMarkCircle + }) + } + + private func backButton() -> some View { + Button { + router.goBack() + } label: { + Image.Medium.chevronLeft + } + } + + private func closeButton() -> some View { + Button { + withAnimation { + store.isModalShown = false + } + } label: { + Image.Medium.xMark + } + } +} + +extension Router.ConnectingSubpage { + var title: String? { + switch self { + case .connectWallet: + return "Connect wallet" + case .qr: + return "WalletConnect" + case .allWallets: + return "All wallets" + case .whatIsAWallet: + return "What is a wallet?" + case let .walletDetail(wallet): + return "\(wallet.name)" + case .getWallet: + return "Get wallet" + } + } +} + +struct Web3ModalView_Previews: PreviewProvider { + static var previews: some View { + Web3ModalView( + viewModel: .init( + router: Router(), + store: Store(), + w3mApiInteractor: W3MAPIInteractor(store: Store()), + signInteractor: SignInteractor(store: Store()), + blockchainApiInteractor: BlockchainAPIInteractor(store: Store()), supportsAuthenticatedSession: false + )) + .previewLayout(.sizeThatFits) + } +} diff --git a/Sources/Web3Modal/Sheets/Web3ModalViewModel.swift b/Sources/Web3Modal/Sheets/Web3ModalViewModel.swift new file mode 100644 index 000000000..84d255914 --- /dev/null +++ b/Sources/Web3Modal/Sheets/Web3ModalViewModel.swift @@ -0,0 +1,291 @@ +import Combine +import SwiftUI + +public enum SIWEAuthenticationError: Error { + case requestRejected + case messageVerificationFailed +} + +class Web3ModalViewModel: ObservableObject { + private(set) var router: Router + private(set) var store: Store + private(set) var w3mApiInteractor: W3MAPIInteractor + private(set) var signInteractor: SignInteractor + private(set) var blockchainApiInteractor: BlockchainAPIInteractor + private let supportsAuthenticatedSession: Bool + + private var disposeBag = Set() + + init( + router: Router, + store: Store, + w3mApiInteractor: W3MAPIInteractor, + signInteractor: SignInteractor, + blockchainApiInteractor: BlockchainAPIInteractor, + supportsAuthenticatedSession: Bool + ) { + self.router = router + self.store = store + self.w3mApiInteractor = w3mApiInteractor + self.signInteractor = signInteractor + self.blockchainApiInteractor = blockchainApiInteractor + self.supportsAuthenticatedSession = supportsAuthenticatedSession + + setupSIWEFallback() + + Web3Modal.instance.sessionEventPublisher + .receive(on: DispatchQueue.main) + .sink { event, _, _ in + switch event.name { + case "chainChanged": + guard let chainReference = try? event.data.get(Int.self) else { + return + } + + Store.shared.selectedChain = ChainPresets.ethChains.first(where: { $0.chainReference == String(chainReference) }) + + case "accountsChanged": + + guard let account = try? event.data.get([String].self) else { + return + } + + let chainReference = account[0].split(separator: ":")[1] + + Store.shared.selectedChain = ChainPresets.ethChains.first(where: { $0.chainReference == String(chainReference) }) + default: + break + } + } + .store(in: &disposeBag) + + signInteractor.sessionSettlePublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] session in + guard let self = self else { return } + self.handleNewSession(session: session) + if supportsAuthenticatedSession { + self.handleSIWEFallback() + } else { + self.routeToProfile() + } + } + .store(in: &disposeBag) + + + signInteractor.authResponsePublisher + .receive(on: DispatchQueue.main) + .sink { [weak self] response in + switch response.result { + case .success(let (session, _)): + if let session = session { + self?.handleNewSession(session: session) + self?.routeToProfile() + } + case .failure(let error): + if error == .methodUnsupported { + break + } else { + store.toast = .init(style: .error, message: "Authentication error: \(error.localizedDescription)") + Web3Modal.config.onError(error) + self?.store.retryShown = true + } + } + } + .store(in: &disposeBag) + + + + signInteractor.sessionDeletePublisher + .receive(on: DispatchQueue.main) + .sink { topic, _ in + + if store.session?.topic == topic { + store.session = nil + store.account = nil + } + router.setRoute(Router.ConnectingSubpage.connectWallet) + } + .store(in: &disposeBag) + + signInteractor.sessionsPublisher + .receive(on: DispatchQueue.main) + .sink { sessions in + + if sessions.isEmpty { + DispatchQueue.main.async { + store.session = nil + store.account = nil + router.setRoute(Router.ConnectingSubpage.connectWallet) + } + } + } + .store(in: &disposeBag) + + Task { + try? await signInteractor.connect(walletUniversalLink: nil) + } + } + + func fetchIdentity() { + Task { @MainActor in + do { + try await blockchainApiInteractor.getIdentity() + } catch { + store.toast = .init(style: .error, message: "Network error") + Web3Modal.config.onError(error) + } + } + } + + func fetchBalance() { + Task { @MainActor in + do { + try await blockchainApiInteractor.getBalance() + } catch { + store.toast = .init(style: .error, message: "Network error") + Web3Modal.config.onError(error) + } + } + } + + private func handleNewSession(session: Session) { + store.connectedWith = .wc + store.account = .init(from: session) + store.session = session + + if + let blockchain = session.accounts.first?.blockchain, + let matchingChain = ChainPresets.ethChains.first(where: { $0.chainNamespace == blockchain.namespace && $0.chainReference == blockchain.reference }) + { + store.selectedChain = matchingChain + } + + fetchIdentity() + + } + + private func routeToProfile() { + router.setRoute(Router.AccountSubpage.profile) + withAnimation { + store.isModalShown = false + } + } + + private func handleSIWEFallback() { + store.SIWEFallbackState = true + } + + + func getChains() -> [Chain] { + guard let namespaces = store.session?.namespaces.values else { + return [] + } + + var chains = namespaces + .compactMap { $0.chains } + .flatMap { $0 } + .filter { chain in + isChainIdCAIP2Compliant(chainId: chain.absoluteString) + } + + if let requiredNamespaces = store.session?.requiredNamespaces.values { + let requiredChains = requiredNamespaces + .compactMap { $0.chains } + .flatMap { $0 } + .filter { chain in + isChainIdCAIP2Compliant(chainId: chain.absoluteString) + } + + chains.append(contentsOf: requiredChains) + } + + return chains + .compactMap { chain in + ChainPresets.ethChains.first(where: { chain.reference == $0.chainReference && chain.namespace == $0.chainNamespace }) + } + } + + func getMethods() -> [String] { + guard let session = store.session else { + return [] + } + + let methods = session.namespaces.values + .compactMap { $0.methods } + .flatMap { $0 } + + let requiredMethods = session.requiredNamespaces.values + .compactMap { $0.methods } + .flatMap { $0 } + + return (methods + requiredMethods) + } + + func isChainIdCAIP2Compliant(chainId: String) -> Bool { + let elements = chainId.split(separator: ":") + guard elements.count == 2 else { return false } + + let namespace = String(elements[0]) + let reference = String(elements[1]) + + return isNamespaceRegexCompliant(key: namespace) && referenceRegex.matches(in: reference, options: [], range: NSRange(location: 0, length: reference.utf16.count)).count > 0 + } + + private let referenceRegex = try! NSRegularExpression(pattern: "^[-_a-zA-Z0-9]{1,32}$") + + // For namespace key validation reference check CAIP-2: https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md#syntax + func isNamespaceRegexCompliant(key: String) -> Bool { + return namespaceRegex.matches(in: key, options: [], range: NSRange(location: 0, length: key.utf16.count)).count > 0 + } + + private let namespaceRegex = try! NSRegularExpression(pattern: "^[-a-z0-9]{3,8}$") + + private func setupSIWEFallback() { + Sign.instance.sessionResponsePublisher.sink { [weak self] response in + if response.id == self?.store.siweRequestId { + switch response.result { + case .response(let result): + guard let signature = try? result.get(String.self), + let siweMessage = self?.store.siweMessage, + let account = self?.store.account?.account() else { return } + + Task { [weak self] in + do { + try await Sign.instance.verifySIWE(signature: signature, message: siweMessage, address: account.address, chainId: account.blockchainIdentifier) + + guard let self = self else { return } + + Web3Modal.instance.SIWEAuthenticationPublisherSubject.send(.success((siweMessage, signature))) + + DispatchQueue.main.async { + self.router.setRoute(Router.AccountSubpage.profile) + self.store.isModalShown = false + } + } catch { + guard let self = self else { return } + + Web3Modal.instance.SIWEAuthenticationPublisherSubject.send(Result.failure( + .messageVerificationFailed)) + DispatchQueue.main.async { + self.store.toast = .init(style: .error, message: error.localizedDescription) + guard let topic = self.store.session?.topic else { return } + Task {try await Web3Modal.instance.disconnect(topic: topic)} + + } + } + } + case .error(let error): + DispatchQueue.main.async { + Web3Modal.instance.SIWEAuthenticationPublisherSubject.send(Result.failure( + .requestRejected)) + guard let self = self else { return } + self.store.SIWEFallbackState = false + guard let topic = self.store.session?.topic else { return } + Task {try await Web3Modal.instance.disconnect(topic: topic)} + } + } + } + }.store(in: &disposeBag) + } +} diff --git a/Sources/Web3Modal/Store.swift b/Sources/Web3Modal/Store.swift new file mode 100644 index 000000000..c439f5507 --- /dev/null +++ b/Sources/Web3Modal/Store.swift @@ -0,0 +1,106 @@ +import Combine +import SwiftUI +import WalletConnectUtils + +enum ConnectionProviderType { + case wc + case cb +} + +class Store: ObservableObject { + static var shared: Store = .init() + + @Published var isModalShown: Bool = false + @Published var retryShown = false + + @Published var SIWEFallbackState: Bool = false { + didSet { + if SIWEFallbackState == true { + retryShown = false + } + } + } + + @Published var identity: Identity? + @Published var balance: Double? + + @Published var connectedWith: ConnectionProviderType? + @Published var connecting: Bool = false + @Published var account: W3MAccount? { + didSet { + let matchingChain = ChainPresets.ethChains.first(where: { + $0.chainNamespace == account?.chain.namespace && $0.chainReference == account?.chain.reference + }) + + Store.shared.selectedChain = matchingChain + + AccountStorage.save(account) + } + } + + // WalletConnect specific + @Published var session: Session? { + didSet { + if let blockchain = session?.accounts.first?.blockchain { + let matchingChain = ChainPresets.ethChains.first(where: { + $0.chainNamespace == blockchain.namespace && $0.chainReference == blockchain.reference + }) + + Store.shared.selectedChain = matchingChain + } + } + } + @Published var uri: WalletConnectURI? + + @Published var wallets: Set = [] + @Published var featuredWallets: [Wallet] = [] + @Published var searchedWallets: [Wallet] = [] + @Published var customWallets: [Wallet] = [] + + var totalNumberOfWallets: Int = 0 + var currentPage: Int = 0 + var totalPages: Int = .max + var walletImages: [String: UIImage] = [:] + var installedWalletIds: [String] = [] + var siweRequestId: RPCID? = nil + var siweMessage: String? = nil + + var recentWallets: [Wallet] { + get { + RecentWalletsStorage.loadRecentWallets() + } + set(newValue) { + RecentWalletsStorage.saveRecentWallets(newValue) + } + } + + @Published public var selectedChain: Chain? + @Published var chainImages: [String: UIImage] = [:] + + @Published var toast: Toast? = nil +} + +struct W3MAccount: Codable { + let address: String + let chain: Blockchain +} + +extension W3MAccount { + + init?(from session: Session) { + guard let account = session.accounts.first else { + return nil + } + + self.init(address: account.address, chain: account.blockchain) + } + + static let stub: Self = .init( + address: "0x5c8877144d858e41d8c33f5baa7e67a5e0027e37", + chain: Blockchain(namespace: "eip155", reference: "56")! + ) + + func account() -> Account? { + return Account(blockchain: chain, address: address) + } +} diff --git a/Sources/Web3Modal/Web3ModalImports.swift b/Sources/Web3Modal/Web3ModalImports.swift new file mode 100644 index 000000000..192870cd9 --- /dev/null +++ b/Sources/Web3Modal/Web3ModalImports.swift @@ -0,0 +1,5 @@ +#if !CocoaPods +@_exported import Web3ModalUI +@_exported import Web3ModalBackport +@_exported import WalletConnectSign +#endif diff --git a/Sources/Web3Modal/Wrappers/UIApplicationWrapper.swift b/Sources/Web3Modal/Wrappers/UIApplicationWrapper.swift new file mode 100644 index 000000000..3017191ad --- /dev/null +++ b/Sources/Web3Modal/Wrappers/UIApplicationWrapper.swift @@ -0,0 +1,18 @@ +import Foundation +import UIKit + +struct UIApplicationWrapper { + let openURL: (URL, _ completionHandler: ((Bool) -> Void)?) -> Void + let canOpenURL: (URL) -> Bool +} + +extension UIApplicationWrapper { + static let live = Self( + openURL: { url, completion in + UIApplication.shared.open(url, completionHandler: completion) + }, + canOpenURL: { url in + UIApplication.shared.canOpenURL(url) + } + ) +} diff --git a/Sources/Web3ModalBackport/AsyncImage.swift b/Sources/Web3ModalBackport/AsyncImage.swift new file mode 100644 index 000000000..5069d75d8 --- /dev/null +++ b/Sources/Web3ModalBackport/AsyncImage.swift @@ -0,0 +1,171 @@ +import SwiftUI + +@available(iOS, deprecated: 15.0) +public extension Backport where Wrapped == Any { + + @ViewBuilder + static func AsyncImage(url: URL?, scale: CGFloat = 1) -> some View { + _AsyncImage(url: url, scale: scale) + } + + @ViewBuilder + static func AsyncImage(url: URL?, scale: CGFloat = 1, @ViewBuilder content: @escaping (Image) -> I, @ViewBuilder placeholder: @escaping () -> P) -> some View { + _AsyncImage(url: url, scale: scale, content: content, placeholder: placeholder) + } + + @ViewBuilder + static func AsyncImage(url: URL?, scale: CGFloat = 1, transaction: Transaction = Transaction(), @ViewBuilder content: @escaping (AsyncImagePhase) -> Content) -> some View { + _AsyncImage(url: url, scale: scale, transaction: transaction, content: content) + } + + enum AsyncImagePhase { + case empty + case success(Image) + case failure(Error) + + public var image: Image? { + guard case let .success(image) = self else { return nil } + return image + } + + public var error: Error? { + guard case let .failure(error) = self else { return nil } + return error + } + } + + // An iOS 13+ async/await backport implementation + private struct _AsyncImage: View { + @State private var phase: AsyncImagePhase = .empty + + var url: URL? + var scale: CGFloat = 1 + var transaction: Transaction = .init() + var content: (Backport.AsyncImagePhase) -> Content + + public var body: some View { + ZStack { + content(phase) + } + .backport.task(id: url) { + do { + guard !Task.isCancelled, let url = url else { return } + let (data, _) = try await URLSession.shared.data(from: url) + guard !Task.isCancelled else { return } + + #if os(macOS) + if let image = NSImage(data: data) { + withTransaction(transaction) { + phase = .success(Image(nsImage: image)) + } + } + #else + if let image = UIImage(data: data, scale: scale) { + withTransaction(transaction) { + phase = .success(Image(uiImage: image)) + } + } + #endif + } catch { + phase = .failure(error) + } + } + } + + init(url: URL?, scale: CGFloat = 1) where Content == AnyView { + self.url = url + self.scale = scale + self.content = { AnyView($0.image) } + } + + init(url: URL?, scale: CGFloat = 1, @ViewBuilder content: @escaping (Image) -> I, @ViewBuilder placeholder: @escaping () -> P) where Content == _ConditionalContent { + self.url = url + self.scale = scale + self.transaction = Transaction() + self.content = { phase -> _ConditionalContent in + if let image = phase.image { + return ViewBuilder.buildEither(first: content(image)) + } else { + return ViewBuilder.buildEither(second: placeholder()) + } + } + } + + init(url: URL?, scale: CGFloat = 1, transaction: Transaction = Transaction(), @ViewBuilder content: @escaping (Backport.AsyncImagePhase) -> Content) { + self.url = url + self.scale = scale + self.transaction = transaction + self.content = content + } + } + +} + +import SwiftUI +import Combine + +@available(iOS, deprecated: 15.0) +@available(macOS, deprecated: 12.0) +@available(tvOS, deprecated: 15.0) +@available(watchOS, deprecated: 8.0) +extension Backport where Wrapped: View { + + @ViewBuilder + func task(priority: TaskPriority = .userInitiated, @_inheritActorContext _ action: @escaping @Sendable () async -> Void) -> some View { + wrapped.modifier( + TaskModifier( + id: 0, + priority: priority, + action: action + ) + ) + } + + @ViewBuilder + func task(id: T, priority: TaskPriority = .userInitiated, @_inheritActorContext _ action: @escaping @Sendable () async -> Void) -> some View { + wrapped.modifier( + TaskModifier( + id: id, + priority: priority, + action: action + ) + ) + } + +} + +private struct TaskModifier: ViewModifier { + + var id: ID + var priority: TaskPriority + var action: @Sendable () async -> Void + + @State private var task: Task? + @State private var publisher = PassthroughSubject<(), Never>() + + init(id: ID, priority: TaskPriority, action: @Sendable @escaping () async -> Void) { + self.id = id + self.priority = priority + self.action = action + } + + func body(content: Content) -> some View { + content + .backport.onChange(of: id) { _ in + publisher.send() + } + .onReceive(publisher) { _ in + task?.cancel() + task = Task(priority: priority, operation: action) + } + .onAppear { + task?.cancel() + task = Task(priority: priority, operation: action) + } + .onDisappear { + task?.cancel() + task = nil + } + } + +} diff --git a/Sources/Web3ModalBackport/Background.swift b/Sources/Web3ModalBackport/Background.swift new file mode 100644 index 000000000..2327d550e --- /dev/null +++ b/Sources/Web3ModalBackport/Background.swift @@ -0,0 +1,7 @@ +import SwiftUI + +extension Backport where Wrapped: View { + public func background(alignment: Alignment = .center, @ViewBuilder _ content: () -> Content) -> some View { + wrapped.background(content(), alignment: alignment) + } +} diff --git a/Sources/Web3ModalBackport/Backport.swift b/Sources/Web3ModalBackport/Backport.swift new file mode 100644 index 000000000..cf03a5008 --- /dev/null +++ b/Sources/Web3ModalBackport/Backport.swift @@ -0,0 +1,14 @@ +import SwiftUI + +public struct Backport { + let wrapped: Wrapped + + public init(_ wrapped: Wrapped) { + self.wrapped = wrapped + } +} + +public extension View { + /// Wraps a SwiftUI `View` that can be extended to provide backport functionality. + var backport: Backport { .init(self) } +} diff --git a/Sources/Web3ModalBackport/ContentSizeCategory.swift b/Sources/Web3ModalBackport/ContentSizeCategory.swift new file mode 100644 index 000000000..4b36c2d67 --- /dev/null +++ b/Sources/Web3ModalBackport/ContentSizeCategory.swift @@ -0,0 +1,27 @@ +import SwiftUI + +extension ContentSizeCategory { + var order: Int { + switch self { + case .extraSmall: return 0 + case .small: return 1 + case .medium: return 2 + case .large: return 3 + case .extraLarge: return 4 + case .extraExtraLarge: return 5 + case .extraExtraExtraLarge: return 6 + case .accessibilityMedium: return 7 + case .accessibilityLarge: return 8 + case .accessibilityExtraLarge: return 9 + case .accessibilityExtraExtraLarge: return 10 + case .accessibilityExtraExtraExtraLarge: return 11 + @unknown default: fatalError("Unknown content size category") + } + } +} + +extension ContentSizeCategory: Comparable { + public static func < (lhs: ContentSizeCategory, rhs: ContentSizeCategory) -> Bool { + lhs.order < rhs.order + } +} diff --git a/Sources/Web3ModalBackport/OnChange.swift b/Sources/Web3ModalBackport/OnChange.swift new file mode 100644 index 000000000..d050cfe28 --- /dev/null +++ b/Sources/Web3ModalBackport/OnChange.swift @@ -0,0 +1,41 @@ +import SwiftUI +import Combine + +@available(iOS, deprecated: 14.0) +@available(macOS, deprecated: 11.0) +@available(tvOS, deprecated: 14.0) +@available(watchOS, deprecated: 7.0) +extension Backport where Wrapped: View { + + @ViewBuilder + public func onChange(of value: Value, perform action: @escaping (Value) -> Void) -> some View { + if #available(iOS 14, tvOS 14, macOS 11, watchOS 7, *) { + wrapped.onChange(of: value, perform: action) + } else { + wrapped.modifier(ChangeModifier(value: value, action: action)) + } + } + +} + +private struct ChangeModifier: ViewModifier { + let value: Value + let action: (Value) -> Void + + @State var oldValue: Value? + + init(value: Value, action: @escaping (Value) -> Void) { + self.value = value + self.action = action + _oldValue = .init(initialValue: value) + } + + func body(content: Content) -> some View { + content + .onReceive(Just(value)) { newValue in + guard newValue != oldValue else { return } + action(newValue) + oldValue = newValue + } + } +} diff --git a/Sources/Web3ModalBackport/Overlay.swift b/Sources/Web3ModalBackport/Overlay.swift new file mode 100644 index 000000000..054ba74f9 --- /dev/null +++ b/Sources/Web3ModalBackport/Overlay.swift @@ -0,0 +1,7 @@ +import SwiftUI + +extension Backport where Wrapped: View { + public func overlay(alignment: Alignment = .center, @ViewBuilder _ content: () -> Content) -> some View { + self.wrapped.overlay(content(), alignment: alignment) + } +} diff --git a/Sources/Web3ModalBackport/ScaledMetric.swift b/Sources/Web3ModalBackport/ScaledMetric.swift new file mode 100644 index 000000000..b223eccf1 --- /dev/null +++ b/Sources/Web3ModalBackport/ScaledMetric.swift @@ -0,0 +1,80 @@ +import SwiftUI + +@available(iOS, deprecated: 14) +@available(macOS, deprecated: 11) +@available(tvOS, deprecated: 14) +@available(watchOS, deprecated: 7) +public extension Backport where Wrapped == Any { + + /// A dynamic property that scales a numeric value. + @propertyWrapper + struct ScaledMetric: DynamicProperty where Value: BinaryFloatingPoint { + + @Environment(\.sizeCategory) var sizeCategory + + private let baseValue: Value + + #if os(iOS) || os(tvOS) + private let metrics: UIFontMetrics + #endif + + public var wrappedValue: Value { + #if os(iOS) || os(tvOS) + let traits = UITraitCollection(traitsFrom: [ + UITraitCollection(preferredContentSizeCategory: UIContentSizeCategory(sizeCategory: sizeCategory)) + ]) + + return Value(metrics.scaledValue(for: CGFloat(baseValue), compatibleWith: traits)) + #else + return baseValue + #endif + } + + #if os(iOS) || os(tvOS) + /// Creates the scaled metric with an unscaled value using the default scaling. + public init(baseValue: Value, metrics: UIFontMetrics) { + self.baseValue = baseValue + self.metrics = metrics + } + + /// Creates the scaled metric with an unscaled value using the default scaling. + public init(wrappedValue: Value) { + self.init(baseValue: wrappedValue, metrics: UIFontMetrics(forTextStyle: .body)) + } + + /// Creates the scaled metric with an unscaled value and a text style to scale relative to. + public init(wrappedValue: Value, relativeTo textStyle: UIFont.TextStyle) { + self.init(baseValue: wrappedValue, metrics: UIFontMetrics(forTextStyle: textStyle)) + } + #else + /// Creates the scaled metric with an unscaled value using the default scaling. + public init(wrappedValue: Value) { + self.baseValue = wrappedValue + } + #endif + + } + +} + +#if os(iOS) || os(tvOS) +private extension UIContentSizeCategory { + init(sizeCategory: ContentSizeCategory?) { + switch sizeCategory { + case .accessibilityExtraExtraExtraLarge: self = .accessibilityExtraExtraExtraLarge + case .accessibilityExtraExtraLarge: self = .accessibilityExtraExtraLarge + case .accessibilityExtraLarge: self = .accessibilityExtraLarge + case .accessibilityLarge: self = .accessibilityLarge + case .accessibilityMedium: self = .accessibilityMedium + case .extraExtraExtraLarge: self = .extraExtraExtraLarge + case .extraExtraLarge: self = .extraExtraLarge + case .extraLarge: self = .extraLarge + case .extraSmall: self = .extraSmall + case .large: self = .large + case .medium: self = .medium + case .small: self = .small + default: self = .unspecified + } + } +} +#endif diff --git a/Sources/Web3ModalBackport/StateObject.swift b/Sources/Web3ModalBackport/StateObject.swift new file mode 100644 index 000000000..bcd347cd5 --- /dev/null +++ b/Sources/Web3ModalBackport/StateObject.swift @@ -0,0 +1,63 @@ +import Combine +import SwiftUI + +@available(iOS, deprecated: 14.0) +@available(macOS, deprecated: 11.0) +@available(tvOS, deprecated: 14.0) +@available(watchOS, deprecated: 7.0) +extension Backport where Wrapped: ObservableObject { + + @propertyWrapper public struct StateObject: DynamicProperty { + private final class Wrapper: ObservableObject { + private var subject = PassthroughSubject() + + var value: Wrapped? { + didSet { + cancellable = nil + cancellable = value?.objectWillChange + .sink { [subject] _ in subject.send() } + } + } + + private var cancellable: AnyCancellable? + + var objectWillChange: AnyPublisher { + subject.eraseToAnyPublisher() + } + } + + @State private var state = Wrapper() + + @ObservedObject private var observedObject = Wrapper() + + private var thunk: () -> Wrapped + + public var wrappedValue: Wrapped { + if let object = state.value { + return object + } else { + let object = thunk() + state.value = object + return object + } + } + + public var projectedValue: ObservedObject.Wrapper { + ObservedObject(wrappedValue: wrappedValue).projectedValue + } + + public init(wrappedValue thunk: @autoclosure @escaping () -> Wrapped) { + self.thunk = thunk + } + + public mutating func update() { + if state.value == nil { + state.value = thunk() + } + if observedObject.value !== state.value { + observedObject.value = state.value + } + } + } + +} diff --git a/Sources/Web3ModalUI/Components/W3MActionEntryStyle.swift b/Sources/Web3ModalUI/Components/W3MActionEntryStyle.swift new file mode 100644 index 000000000..d023d8bbe --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MActionEntryStyle.swift @@ -0,0 +1,106 @@ +import SwiftUI + +public struct W3MActionEntryStyle: ButtonStyle { + @Environment(\.isEnabled) var isEnabled + + @Backport.ScaledMetric var scale: CGFloat = 1 + + var leftIcon: Image? + var rightIcon: Image? + + var isPressedOverride: Bool? + + public init( + leftIcon: Image? = nil, + rightIcon: Image? = nil + ) { + self.leftIcon = leftIcon + self.rightIcon = rightIcon + } + + #if DEBUG + init( + leftIcon: Image? = nil, + rightIcon: Image? = nil, + isPressedOverride: Bool? + ) { + self.leftIcon = leftIcon + self.rightIcon = rightIcon + self.isPressedOverride = isPressedOverride + } + #endif + + public func makeBody(configuration: Configuration) -> some View { + HStack(spacing: Spacing.xs) { + if let leftIcon { + leftIcon + .resizable() + .frame(width: 14 * scale, height: 14 * scale) + } + + configuration.label + + if let rightIcon { + rightIcon + .resizable() + .frame(width: 14 * scale, height: 14 * scale) + } + } + .font(.paragraph600) + .foregroundColor((isPressedOverride ?? configuration.isPressed) ? .Foreground150 : .Foreground200) + .frame(maxWidth: .infinity) + .frame(height: 56) + .opacity(isEnabled ? 1 : 0.5) + .padding(.vertical, Spacing.xs * scale) + .padding(.leading, Spacing.xs * scale) + .padding(.trailing, Spacing.xs * scale) + .backport + .background { (isPressedOverride ?? configuration.isPressed) ? Color.GrayGlass010 : Color.GrayGlass002 } + .cornerRadius(Radius.xs * scale) + } +} + +#if DEBUG + public struct W3MActionEntryStylePreviewView: View { + public init() {} + + public var body: some View { + ScrollView { + VStack { + Button(action: {}, label: { + Text("Copy link") + }) + .buttonStyle(W3MActionEntryStyle( + leftIcon: Image.Medium.desktop + )) + + Button(action: {}, label: { + Text("Copy link") + }) + .buttonStyle(W3MActionEntryStyle( + leftIcon: Image.Regular.copy, + isPressedOverride: true + )) + + Button(action: {}, label: { + Text("Copy link") + }) + .buttonStyle(W3MActionEntryStyle( + leftIcon: Image.Regular.copy + )) + .disabled(true) + } + .padding() + + } + } + } + + struct W3MActionEntry_Preview: PreviewProvider { + static var previews: some View { + W3MActionEntryStylePreviewView() + .previewLayout(.sizeThatFits) + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MAvatarGradient.swift b/Sources/Web3ModalUI/Components/W3MAvatarGradient.swift new file mode 100644 index 000000000..112b6ebad --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MAvatarGradient.swift @@ -0,0 +1,83 @@ +import SwiftUI + +public struct W3MAvatarGradient: View { + let address: String + + public init(address: String) { + self.address = address + } + + public var body: some View { + let colors = generateAvatarColors(address: address) + + GeometryReader { proxy in + // Create Orb like gradient + RadialGradient( + gradient: Gradient(stops: [ + .init(color: .white, location: 0.0052), + .init(color: colors[4], location: 0.3125), + .init(color: colors[2], location: 0.5156), + .init(color: colors[1], location: 0.6563), + .init(color: colors[0], location: 0.8229), + .init(color: colors[3], location: 1.0) + ]), + center: UnitPoint(x: 0.6496, y: 0.2436), + startRadius: 0, + endRadius: proxy.frame(in: .local).height * 0.8 + ) + } + .clipShape(Circle()) + } + + func generateAvatarColors(address: String) -> [Color] { + let hash = address.lowercased().replacingOccurrences(of: "0x", with: "") + let baseColor = String(hash.prefix(6)) + let rgbColor = hexToRgb(hex: baseColor) + var colors: [Color] = [] + for i in 0 ..< 5 { + let tintedColor = tintColor(rgb: rgbColor, tint: 0.15 * Double(i)) + colors.append( + Color( + red: CGFloat(tintedColor.0)/255.0, + green: CGFloat(tintedColor.1)/255.0, + blue: CGFloat(tintedColor.2)/255.0, + opacity: 1.0 + ) + ) + } + + return colors + } + + func hexToRgb(hex: String) -> (Int, Int, Int) { + guard let bigint = Int64(hex, radix: 16) else { return (0, 0, 0) } + + let r = Int((bigint >> 16) & 255) + let g = Int((bigint >> 8) & 255) + let b = Int(bigint & 255) + return (r, g, b) + } + + func tintColor(rgb: (Int, Int, Int), tint: Double) -> (Int, Int, Int) { + let (r, g, b) = rgb + let tintedR = Int(round(Double(r) + (255.0 - Double(r)) * tint)) + let tintedG = Int(round(Double(g) + (255.0 - Double(g)) * tint)) + let tintedB = Int(round(Double(b) + (255.0 - Double(b)) * tint)) + return (tintedR, tintedG, tintedB) + } +} + +struct W3MAvatarGradient_Preview: PreviewProvider { + static var previews: some View { + VStack { + W3MAvatarGradient(address: "0x5C8877144D858E41D8C33F5BAA7E67A5E0027E37") + .frame(width: 128, height: 128) + W3MAvatarGradient(address: "0x6E7E5B77B0EE215E6471713EF7EB1F69982A0603") + .frame(width: 16, height: 16) + W3MAvatarGradient(address: "0x7542D32A86402165DD13E09360A01DF0662401E9") + .frame(width: 32, height: 32) + W3MAvatarGradient(address: "0xEF56528723AA4ECC52E115DCF18628ADB773658B") + .frame(width: 64, height: 64) + } + } +} diff --git a/Sources/Web3ModalUI/Components/W3MButtonStyle.swift b/Sources/Web3ModalUI/Components/W3MButtonStyle.swift new file mode 100644 index 000000000..31163563f --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MButtonStyle.swift @@ -0,0 +1,284 @@ +import SwiftUI + +public struct W3MButtonStyle: ButtonStyle { + public enum Size { + case s, m + } + + public enum Variant { + case accent + case main + } + + @Environment(\.isEnabled) var isEnabled + + let size: Size + let variant: Variant + var leftIcon: Image? + var rightIcon: Image? + + var isPressedOverride: Bool? + + public init( + size: Size = .m, + variant: Variant = .main, + leftIcon: Image? = nil, + rightIcon: Image? = nil + ) { + self.size = size + self.variant = variant + self.leftIcon = leftIcon + self.rightIcon = rightIcon + } + + fileprivate init( + size: Size = .m, + variant: Variant = .main, + leftIcon: Image? = nil, + rightIcon: Image? = nil, + isPressedOverride: Bool? + ) { + self.size = size + self.variant = variant + self.leftIcon = leftIcon + self.rightIcon = rightIcon + self.isPressedOverride = isPressedOverride + } + + public func makeBody(configuration: Configuration) -> some View { + var textColor: Color = variant == .accent ? .Blue100 : .Inverse100 + textColor = isEnabled ? textColor : .Overgray015 + + var backgroundColor: Color = variant == .accent ? .clear : .Blue100 + let pressedColor: Color = variant == .accent ? .Overgray010 : .Blue080 + backgroundColor = (isPressedOverride ?? configuration.isPressed) ? pressedColor : backgroundColor + backgroundColor = isEnabled ? backgroundColor : .Overgray010 + + let verticalPadding = size == .m ? Spacing.xs : Spacing.xxs + let horizontalPadding = size == .m ? Spacing.l : Spacing.s + let leadingPadding = horizontalPadding - (leftIcon == nil ? 0 : Spacing.xxxs) + let trailingPadding = horizontalPadding - (rightIcon == nil ? 0 : Spacing.xxxs) + let iconSize: CGFloat = size == .m ? 16 : 14 + + return HStack(spacing: size == .m ? Spacing.xxs : Spacing.xxxs) { + if let leftIcon { + leftIcon + .resizable() + .frame(width: iconSize, height: iconSize) + .foregroundColor(textColor) + } + + configuration + .label + .lineLimit(1) + .font(size == .m ? .paragraph600 : .small600) + .foregroundColor(textColor) + + if let rightIcon { + rightIcon + .resizable() + .frame(width: iconSize, height: iconSize) + .foregroundColor(textColor) + } + } + .padding(.vertical, verticalPadding) + .padding(.leading, leadingPadding) + .padding(.trailing, trailingPadding) + .frame(height: size == .m ? 40 : 32) + .background(backgroundColor) + .cornerRadius(Radius.m) + .overlay( + RoundedRectangle(cornerRadius: Radius.m) + .stroke(Color.Overgray010, lineWidth: 1) + ) + } +} + +#if DEBUG + public struct W3MButtonStylePreviewView: View { + public init() {} + + public var body: some View { + VStack(alignment: .leading) { + Text("S") + .font(.title700) + + Text("Main") + .font(.large500) + + VStack(alignment: .leading) { + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, leftIcon: .Medium.desktop)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, rightIcon: .Medium.mobile, isPressedOverride: true)) + } + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + .disabled(true) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s)) + .disabled(true) + } + } + + Text("Accent") + .font(.large500) + + VStack(alignment: .leading) { + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, variant: .accent)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, variant: .accent, leftIcon: .Medium.desktop)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, variant: .accent, rightIcon: .Medium.mobile, isPressedOverride: true)) + } + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, variant: .accent, leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, variant: .accent, leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + .disabled(true) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(size: .s, variant: .accent)) + .disabled(true) + } + } + + Text("M") + .font(.title700) + + Text("Main") + .font(.large500) + + VStack(alignment: .leading) { + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle()) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(leftIcon: .Medium.desktop)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(rightIcon: .Medium.mobile, isPressedOverride: true)) + } + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + .disabled(true) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle()) + .disabled(true) + } + } + + Text("Accent") + .font(.large500) + + VStack(alignment: .leading) { + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(variant: .accent)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(variant: .accent, leftIcon: .Medium.desktop)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(variant: .accent, rightIcon: .Medium.mobile, isPressedOverride: true)) + } + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(variant: .accent, leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(variant: .accent, leftIcon: .Medium.desktop, rightIcon: .Medium.mobile)) + .disabled(true) + + Button(action: {}) { + Text("Button") + } + .buttonStyle(W3MButtonStyle(variant: .accent)) + .disabled(true) + } + } + } + .padding() + .background(Color.Overgray002) + } + } + + struct W3MButtonStyle_Preview: PreviewProvider { + static var previews: some View { + W3MButtonStylePreviewView() + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MCardSelectButtonStyle.swift b/Sources/Web3ModalUI/Components/W3MCardSelectButtonStyle.swift new file mode 100644 index 000000000..50f1ac5bd --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MCardSelectButtonStyle.swift @@ -0,0 +1,232 @@ +import SwiftUI + +public struct W3MCardSelectStyle: ButtonStyle { + public enum Variant { + case wallet + case network + } + + @Environment(\.isEnabled) var isEnabled + + let variant: Variant + + var imageContent: () -> ImageContent + var isPressedOverride: Bool? + var isSelected: Bool + + @Binding var isLoading: Bool + + public init( + variant: Variant, + @ViewBuilder imageContent: @escaping () -> ImageContent, + isLoading: Binding = .constant(false), + isSelected: Bool = false + ) { + self.variant = variant + self.imageContent = imageContent + self._isLoading = isLoading + self.isSelected = isSelected + } + + #if DEBUG + init( + variant: Variant, + @ViewBuilder imageContent: @escaping () -> ImageContent, + isPressedOverride: Bool? = nil, + isLoading: Binding, + isSelected: Bool = false + ) { + self.variant = variant + self.imageContent = imageContent + self.isPressedOverride = isPressedOverride + self._isLoading = isLoading + self.isSelected = isSelected + } + #endif + + public func makeBody(configuration: Configuration) -> some View { + + var backgroundColor: Color = (isPressedOverride ?? configuration.isPressed) ? .Overgray010 : .Overgray005 + backgroundColor = isSelected ? Color.Blue100.opacity(0.2) : backgroundColor + + var foregroundColor: Color = .Foreground100 + foregroundColor = isSelected ? .Blue100 : foregroundColor + + return VStack(spacing: Spacing.xs) { + imageComponent() + + configuration.label + .font(.tiny500) + .foregroundColor(foregroundColor) + .frame(maxWidth: .infinity) + .opacity(isLoading ? 0 : 1) + .backport + .overlay { + RoundedRectangle(cornerRadius: Radius.xs) + .stroke(.Overgray010, lineWidth: 1) + .background(RoundedRectangle(cornerRadius: Radius.xs).fill(.Overgray005)) + .opacity(isLoading ? 1 : 0) + } + .padding(.horizontal, Spacing.xs) + } + .if(isLoading) { + $0.modifier(ShimmerBackground()) + } + .opacity(isEnabled || isSelected ? 1 : 0.5) + .padding(.top, Spacing.xs) + .padding(.bottom, Spacing.xxs) + .background(backgroundColor) + .cornerRadius(Radius.xs) + .frame(minWidth: 76, maxWidth: 76, minHeight: 96, maxHeight: 96) + } + + @ViewBuilder + func imageComponent() -> some View { + imageContent() + .frame(width: 56, height: 56) + .saturation(isEnabled || isSelected ? 1 : 0) + .opacity(isEnabled || isSelected ? 1 : 0.5) + .transform { + switch variant { + case .network: + $0.clipShape(Polygon(count: 6, relativeCornerRadius: 0.25)) + case .wallet: + $0.clipShape(RoundedRectangle(cornerRadius: Radius.xs)) + } + } + .backport + .overlay { + switch variant { + case .network: + Polygon(count: 6, relativeCornerRadius: 0.25) + .stroke(isSelected ? .Blue100 : .Overgray010, lineWidth: 1) + .background(Polygon(count: 6, relativeCornerRadius: 0.25).fill(.Overgray005).opacity(isLoading ? 1 : 0)) + case .wallet: + RoundedRectangle(cornerRadius: Radius.xs) + .strokeBorder(isSelected ? .Blue100 : .Overgray010, lineWidth: 1) + .background(RoundedRectangle(cornerRadius: Radius.xs).fill(.Overgray005).opacity(isLoading ? 1 : 0)) + } + } + } +} + +#if DEBUG + public struct W3MCardSelectStylePreviewView: View { + public init() {} + + public var body: some View { + VStack { + HStack { + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { Image.mockWallet.resizable() }, + isLoading: .constant(false) + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { Image.mockWallet.resizable() }, + isLoading: .constant(false) + )) + .disabled(true) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { Image.mockWallet.resizable() }, + isLoading: .constant(false), + isSelected: true + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { Image.mockWallet.resizable() }, + isPressedOverride: true, + isLoading: .constant(false) + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .wallet, + imageContent: { Color.Overgray005 }, + isPressedOverride: false, + isLoading: .constant(true) + )) + } + + HStack { + Button(action: {}, label: { + Text("Polygon") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .network, + imageContent: { Image("MockChainImage", bundle: .module).resizable() }, + isLoading: .constant(false) + )) + Button(action: {}, label: { + Text("Polygon") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .network, + imageContent: { Image("MockChainImage", bundle: .module).resizable() }, + isLoading: .constant(false) + )) + .disabled(true) + + Button(action: {}, label: { + Text("Polygon") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .network, + imageContent: { Image("MockChainImage", bundle: .module).resizable() }, + isLoading: .constant(false), + isSelected: true + )) + + Button(action: {}, label: { + Text("Polygon") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .network, + imageContent: { Image("MockChainImage", bundle: .module).resizable() }, + isPressedOverride: true, + isLoading: .constant(false) + )) + + Button(action: {}, label: { + Text("Polygon") + }) + .buttonStyle(W3MCardSelectStyle( + variant: .network, + imageContent: { Color.Overgray005 }, + isPressedOverride: false, + isLoading: .constant(true) + )) + } + } + .padding() + .background(Color.Overgray002) + } + } + + struct W3MCardSelect_Preview: PreviewProvider { + static var previews: some View { + W3MCardSelectStylePreviewView() + .previewLayout(.sizeThatFits) + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MChipButtonStyle.swift b/Sources/Web3ModalUI/Components/W3MChipButtonStyle.swift new file mode 100644 index 000000000..84c8a4036 --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MChipButtonStyle.swift @@ -0,0 +1,539 @@ +import SwiftUI + +public struct W3MChipButtonStyle: ButtonStyle { + public enum Variant { + case fill + case shade + case transparent + + var textColor: Color { + switch self { + case .fill: + return Color.Inverse100 + case .shade: + return Color.Foreground200 + case .transparent: + return Color.Foreground150 + } + } + + var backgroundColor: Color { + switch self { + case .fill: + return Color.Blue100 + case .shade: + return Color.GrayGlass010 + case .transparent: + return Color.clear + } + } + + var pressedColor: Color { + switch self { + case .fill: + return Color.Blue080 + case .shade: + return Color.GrayGlass020 + case .transparent: + return Color.GrayGlass010 + } + } + } + + public enum Size { + case s, m + } + + @Environment(\.isEnabled) var isEnabled + + let variant: Variant + let size: Size + var leadingImage: () -> LeadingImageContent + var trailingImage: () -> TrailingImageContent + + var isPressedOverride: Bool? + + public init( + variant: Variant = .fill, + size: Size = .m, + @ViewBuilder leadingImage: @escaping () -> LeadingImageContent, + @ViewBuilder trailingImage: @escaping () -> TrailingImageContent + ) { + self.variant = variant + self.size = size + self.leadingImage = leadingImage + self.trailingImage = trailingImage + } + + fileprivate init( + variant: Variant, + size: Size = .m, + @ViewBuilder leadingImage: @escaping () -> LeadingImageContent, + @ViewBuilder trailingImage: @escaping () -> TrailingImageContent, + isPressedOverride: Bool? + ) { + self.variant = variant + self.size = size + self.leadingImage = leadingImage + self.trailingImage = trailingImage + self.isPressedOverride = isPressedOverride + } + + public func makeBody(configuration: Configuration) -> some View { + var textColor: Color = variant.textColor + textColor = isEnabled ? textColor : .Overgray015 + + var backgroundColor: Color = variant.backgroundColor + let pressedColor: Color = variant.pressedColor + backgroundColor = (isPressedOverride ?? configuration.isPressed) ? pressedColor : backgroundColor + backgroundColor = isEnabled ? backgroundColor : .Overgray010 + + let verticalPadding = size == .m ? Spacing.xxs : Spacing.xxs + let horizontalPadding = size == .m ? Spacing.m : Spacing.s + let leadingPadding = horizontalPadding - (LeadingImageContent.self == EmptyView.self ? 0 : Spacing.xxxs) + let trailingPadding = horizontalPadding - (TrailingImageContent.self == EmptyView.self ? 0 : Spacing.xxxs) + + return HStack(spacing: size == .m ? Spacing.xxs : Spacing.xxxs) { + leadingImage() + .clipShape(Circle()) + .saturation(isEnabled ? 1 : 0) + .opacity(isEnabled ? 1 : 0.5) + .frame(width: size == .m ? 24 : 16, height: size == .m ? 24 : 16) + + configuration + .label + .font(.paragraph600) + .lineLimit(1) + + trailingImage() + .saturation(isEnabled ? 1 : 0) + .opacity(isEnabled ? 1 : 0.5) + .frame(width: size == .m ? 14 : 12, height: size == .m ? 14 : 12) + } + .foregroundColor(textColor) + .padding(.vertical, verticalPadding) + .padding(.leading, leadingPadding) + .padding(.trailing, trailingPadding) + .frame(minHeight: size == .m ? 36 : 32) + .background(backgroundColor) + .cornerRadius(Radius.m) + .overlay( + RoundedRectangle(cornerRadius: Radius.m) + .stroke(Color.Overgray010, lineWidth: 1) + ) + } +} + +public extension W3MChipButtonStyle where LeadingImageContent == EmptyView, TrailingImageContent == EmptyView { + init( + variant: Variant = .fill, + size: Size = .m + ) { + self.variant = variant + self.size = size + self.leadingImage = { EmptyView() } + self.trailingImage = { EmptyView() } + } +} + +public extension W3MChipButtonStyle where LeadingImageContent == EmptyView { + init( + variant: Variant = .fill, + size: Size = .m, + @ViewBuilder trailingImage: @escaping () -> TrailingImageContent + ) { + self.variant = variant + self.size = size + self.leadingImage = { EmptyView() } + self.trailingImage = trailingImage + } +} + +public extension W3MChipButtonStyle where TrailingImageContent == EmptyView { + init( + variant: Variant = .fill, + size: Size = .m, + @ViewBuilder leadingImage: @escaping () -> LeadingImageContent + ) { + self.variant = variant + self.size = size + self.leadingImage = leadingImage + self.trailingImage = { EmptyView() } + } +} + +#if DEBUG + public struct W3MChipButtonStylePreviewView: View { + public init() {} + + public var body: some View { + ScrollView([.horizontal, .vertical]) { + VStack(alignment: .leading, spacing: 15) { + Group { + Text("Fill") + .font(.large600) + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle() + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(leadingImage: { Image.imageEth.resizable() }) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .fill, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .fill, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: true + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .fill, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + .disabled(true) + } + + Text("Shade") + .font(.large600) + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .shade) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .shade, leadingImage: { Image.imageEth.resizable() }) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: true + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + .disabled(true) + } + + Text("Transparent") + .font(.large600) + + HStack { + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .transparent) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .transparent, leadingImage: { Image.imageEth.resizable() }) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .transparent, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .transparent, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: true + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .transparent, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + .disabled(true) + } + } + + Divider() + .padding(.vertical, 24) + + Group { + + Text("Fill S") + .font(.large600) + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(size: .s) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(size: .s, leadingImage: { Image.imageEth.resizable() }) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .fill, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .fill, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: true + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .fill, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + .disabled(true) + } + + Text("Shade S") + .font(.large600) + + HStack { + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .shade, size: .s) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .shade, size: .s, leadingImage: { Image.imageEth.resizable() }) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: true + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .shade, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + .disabled(true) + } + + Text("Transparent S") + .font(.large600) + + HStack { + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .transparent, size: .s) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle(variant: .transparent, size: .s, leadingImage: { Image.imageEth.resizable() }) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .transparent, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .transparent, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: true + ) + ) + + Button(action: {}) { + Text("Button") + } + .buttonStyle( + W3MChipButtonStyle( + variant: .transparent, + size: .s, + leadingImage: { Image.imageEth.resizable() }, + trailingImage: { Image.Medium.externalLink.resizable() }, + isPressedOverride: nil + ) + ) + .disabled(true) + } + } + } + .padding() + .background(Color.Overgray002) + } + } + } + + struct W3MChipButtonStyle_Preview: PreviewProvider { + static var previews: some View { + W3MChipButtonStylePreviewView() + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MListItemButtonStyle.swift b/Sources/Web3ModalUI/Components/W3MListItemButtonStyle.swift new file mode 100644 index 000000000..953d421e1 --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MListItemButtonStyle.swift @@ -0,0 +1,224 @@ +import SwiftUI + +public struct W3MListItemButtonStyle: ButtonStyle { + @Environment(\.sizeCategory) var sizeCategory + @Environment(\.isEnabled) var isEnabled + + @Backport.ScaledMetric var scale: CGFloat = 1 + + var imageContent: () -> ImageContent + var showChevron: Bool = false + @Binding var isLoading: Bool + + var isPressedOverride: Bool? + + #if DEBUG + init( + @ViewBuilder imageContent: @escaping () -> ImageContent, + showChevron: Bool, + isLoading: Binding, + isPressedOverride: Bool? = nil + ) { + self.imageContent = imageContent + _isLoading = isLoading + self.showChevron = showChevron + self.isPressedOverride = isPressedOverride + } + #endif + + public func makeBody(configuration: Configuration) -> some View { + AdaptiveStack( + condition: sizeCategory >= .accessibilityMedium, + horizontalAlignment: .center, + spacing: Spacing.s + + ) { + imageComponent() + + configuration.label + + if !(sizeCategory >= .accessibilityMedium) { + Spacer() + } + + Group { + if isLoading { + DrawingProgressView( + shape: .circle, + color: .Blue100, + lineWidth: 2 * scale, + duration: 1, + isAnimating: $isLoading + ) + .frame(width: 15 * scale, height: 15 * scale) + } else if showChevron { + Image(systemName: "chevron.right") + .foregroundColor(.Foreground200) + } + + } + } + .font(.paragraph600) + .foregroundColor(.Foreground100) + .frame(maxWidth: .infinity) + .frame(minHeight: 56) + .opacity(isEnabled ? 1 : 0.5) + .padding(.vertical, Spacing.xs * scale) + .padding(.leading, Spacing.s * scale) + .padding(.trailing, Spacing.l * scale) + .backport + .background { (isPressedOverride ?? configuration.isPressed) ? Color.Overgray010 : Color.Overgray005 } + .cornerRadius(Radius.s * scale) + .allowsHitTesting(!isLoading) + } + + @ViewBuilder + func imageComponent() -> some View { + imageContent() + .frame(maxWidth: 32 * scale, maxHeight: 32 * scale) + .aspectRatio(contentMode: .fit) + .saturation(isEnabled ? 1 : 0) + .opacity(isEnabled ? 1 : 0.5) + .cornerRadius(Radius.xxxs * scale) + } +} + +#if DEBUG + public struct W3MListItemButtonStylePreviewView: View { + + @Environment(\.sizeCategory) var sizeCategory + + public init() {} + + public var body: some View { + ScrollView { + VStack { + Button(action: {}, label: { + AdaptiveStack(condition: sizeCategory >= .accessibilityMedium, spacing: 5) { + Text("0.527 ETH") + + Text("607.38 USD") + .foregroundColor(.Foreground200) + } + }) + .buttonStyle(W3MListItemButtonStyle( + imageContent: { + Image.imageEth + .resizable() + .clipShape(Circle()) + }, + showChevron: true, + isLoading: .constant(false), + isPressedOverride: nil + )) + + Button(action: {}, label: { + AdaptiveStack(condition: sizeCategory >= .accessibilityMedium, spacing: 5) { + Text("W/ CHEVRON") + + Text("607.38 USD") + .foregroundColor(.Foreground200) + } + }) + .buttonStyle(W3MListItemButtonStyle( + imageContent: { + Image.imageEth + .resizable() + .clipShape(Circle()) + }, + showChevron: true, + isLoading: .constant(false), + isPressedOverride: nil + )) + + Button(action: {}, label: { + HStack(spacing: 5) { + Text("W/O CHEVRON") + + Text("607.38 USD") + .foregroundColor(.Foreground200) + } + }) + .buttonStyle(W3MListItemButtonStyle( + imageContent: { + Image.imageEth + .resizable() + .clipShape(Circle()) + }, + showChevron: false, + isLoading: .constant(false), + isPressedOverride: nil + )) + + Button(action: {}, label: { + HStack(spacing: 5) { + Text("LOADING") + + Text("607.38 USD") + .foregroundColor(.Foreground200) + } + }) + .buttonStyle(W3MListItemButtonStyle( + imageContent: { + Image.imageEth + .resizable() + .clipShape(Circle()) + }, + showChevron: true, + isLoading: .constant(true), + isPressedOverride: nil + )) + + Button(action: {}, label: { + HStack(spacing: 5) { + Text("DISABLED") + + Text("607.38 USD") + .foregroundColor(.Foreground200) + } + }) + .buttonStyle(W3MListItemButtonStyle( + imageContent: { + Image.imageEth + .resizable() + .clipShape(Circle()) + }, + showChevron: true, + isLoading: .constant(false), + isPressedOverride: nil + )) + .disabled(true) + + Button(action: {}, label: { + HStack(spacing: 5) { + Text("PRESSED") + + Text("607.38 USD") + .foregroundColor(.Foreground200) + } + }) + .buttonStyle(W3MListItemButtonStyle( + imageContent: { + Image.imageEth + .resizable() + .clipShape(Circle()) + }, + showChevron: true, + isLoading: .constant(false), + isPressedOverride: true + )) + } + .padding() + .background(Color.Overgray002) + } + } + } + + struct W3MListItem_Preview: PreviewProvider { + static var previews: some View { + W3MListItemButtonStylePreviewView() + .previewLayout(.sizeThatFits) + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MListSelectButtonStyle.swift b/Sources/Web3ModalUI/Components/W3MListSelectButtonStyle.swift new file mode 100644 index 000000000..6b38822e0 --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MListSelectButtonStyle.swift @@ -0,0 +1,183 @@ +import SwiftUI + +public struct W3MListSelectStyle: ButtonStyle { + @Environment(\.isEnabled) var isEnabled + @Environment(\.sizeCategory) var sizeCategory + + @Backport.ScaledMetric var scale: CGFloat = 1 + + var imageContent: (CGFloat) -> ImageContent + var tag: W3MTag? + var showChevron: Bool + + var isPressedOverride: Bool? + + public init( + @ViewBuilder imageContent: @escaping (CGFloat) -> ImageContent, + tag: W3MTag? = nil, + showChevron: Bool = false + ) { + self.imageContent = imageContent + self.tag = tag + self.showChevron = showChevron + } + + #if DEBUG + init( + @ViewBuilder imageContent: @escaping (CGFloat) -> ImageContent, + tag: W3MTag? = nil, + isPressedOverride: Bool? = nil, + showChevron: Bool = false + ) { + self.imageContent = imageContent + self.tag = tag + self.isPressedOverride = isPressedOverride + self.showChevron = showChevron + } + #endif + + public func makeBody(configuration: Configuration) -> some View { + let layoutBreakCondition = sizeCategory >= .accessibilityMedium + + AdaptiveStack( + condition: layoutBreakCondition, + horizontalAlignment: .center, + spacing: 10 * scale + ) { + Group { + imageComponent() + .scaledToFill() + .foregroundColor(.Foreground100) + .layoutPriority(3) + + configuration.label + .lineLimit(1) + .scaledToFill() + .font(.paragraph500) + .foregroundColor(.Foreground100) + .layoutPriority(5) + + if !layoutBreakCondition { + Spacer() + } + + if let tag { + tag + .saturation(isEnabled ? 1 : 0) + .layoutPriority(3) + } else if showChevron { + Image.Bold.chevronRight + .foregroundColor(.Foreground200) + } else if !layoutBreakCondition { + Spacer() + .layoutPriority(3) + } + } + } + .frame(maxWidth: .infinity) + .opacity(isEnabled ? 1 : 0.5) + .padding(.vertical, Spacing.xs * scale) + .padding(.leading, Spacing.xs * scale) + .padding(.trailing, Spacing.l * scale) + .backport + .background { (isPressedOverride ?? configuration.isPressed) ? Color.Overgray010 : Color.Overgray002 } + .cornerRadius(Radius.xs * scale) + } + + @ViewBuilder + func imageComponent() -> some View { + imageContent(scale) + .frame(maxWidth: 40 * scale, maxHeight: 40 * scale) + .aspectRatio(contentMode: .fit) + .saturation(isEnabled ? 1 : 0) + .opacity(isEnabled ? 1 : 0.5) + .cornerRadius(Radius.xxs * scale) + } +} + +#if DEBUG + public struct W3MListSelectStylePreviewView: View { + public init() {} + + public var body: some View { + ScrollView { + VStack { + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in Image.mockWallet.resizable() }, + tag: W3MTag(title: "QR CODE", variant: .main) + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { scale in + ZStack { + Color.Overgray005 + RoundedRectangle(cornerRadius: Radius.xxxs * scale).stroke(.Overgray010, lineWidth: 1 * scale) + Image.Medium.wallet + } + }, + tag: W3MTag(title: "INSTALLED", variant: .success), + isPressedOverride: true + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in Image.mockWallet.resizable() } + )) + + Button(action: {}, label: { + Text("All wallets") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in + Image.optionAll + } + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in Image.mockWallet.resizable() }, + tag: W3MTag(title: "QR CODE", variant: .main) + )) + .disabled(true) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in Image.mockWallet.resizable() }, + showChevron: true + )) + + Button(action: {}, label: { + Text("Rainbow") + }) + .buttonStyle(W3MListSelectStyle( + imageContent: { _ in Image.mockWallet.resizable() }, + showChevron: true + )) + .disabled(true) + } + .padding() + .background(Color.Overgray002) + } + } + } + + struct W3MListSelect_Preview: PreviewProvider { + static var previews: some View { + W3MListSelectStylePreviewView() + .previewLayout(.sizeThatFits) + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MPicker.swift b/Sources/Web3ModalUI/Components/W3MPicker.swift new file mode 100644 index 000000000..845b93e99 --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MPicker.swift @@ -0,0 +1,87 @@ +import SwiftUI + +public struct W3MPicker: View where Data: Hashable, Content: View { + let sources: [Data] + let selection: Data? + let itemBuilder: (Data) -> Content + + private var customIndicator: AnyView? + + public init( + _ sources: [Data], + selection: Data?, + @ViewBuilder itemBuilder: @escaping (Data) -> Content + ) { + self.sources = sources + self.selection = selection + self.itemBuilder = itemBuilder + } + + public var body: some View { + ZStack(alignment: .center) { + if let selection = selection, let selectedIdx = sources.firstIndex(of: selection) { + + GeometryReader { geo in + RoundedRectangle(cornerRadius: Radius.s) + .fill(.GrayGlass002, strokeBorder: .GrayGlass002, lineWidth: 1) + .frame(width: geo.size.width / CGFloat(sources.count)) + .animation(.spring().speed(1.5), value: selection) + .offset(x: geo.size.width / CGFloat(sources.count) * CGFloat(selectedIdx), y: 0) + }.frame(height: 28) + } + + HStack(spacing: 0) { + ForEach(sources, id: \.self) { item in + itemBuilder(item) + } + } + } + .background( + RoundedRectangle(cornerRadius: Radius.s) + .fill(.GrayGlass002) + .padding(-3) + ) + } +} + +struct PreviewWeb3ModalPicker: View { + + enum Platform: String, CaseIterable { + case native + case browser + } + + @State private var selectedItem: Platform? = .native + + var body: some View { + W3MPicker( + Platform.allCases, + selection: selectedItem + ) { item in + + HStack { + item == .native ? Image.Bold.mobile : Image.Bold.browser + Text(item.rawValue.capitalized) + } + .font(.small600) + .multilineTextAlignment(.center) + .foregroundColor(selectedItem == item ? .Foreground100 : .Foreground200) + .frame(maxWidth: .infinity) + .contentShape(Rectangle()) + .onTapGesture { + withAnimation(.easeInOut(duration: 0.15)) { + selectedItem = item + } + } + } + .accentColor(Color.Overgray005) + .frame(maxWidth: 200) + .padding() + } +} + +struct Web3ModalPicker_Previews: PreviewProvider { + static var previews: some View { + PreviewWeb3ModalPicker() + } +} diff --git a/Sources/Web3ModalUI/Components/W3MTag.swift b/Sources/Web3ModalUI/Components/W3MTag.swift new file mode 100644 index 000000000..1f7b04ae4 --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MTag.swift @@ -0,0 +1,99 @@ +import SwiftUI + +public struct W3MTag: View { + public enum Variant: String, CaseIterable, Identifiable { + case main = "MAIN" + case info = "INFO" + case success = "SUCCESS" + case error = "ERROR" + case inProgress = "IN PROGRESS" + case warning = "WARNING" + case disabled = "DISABLED" + + var backgroundColor: Color { + switch self { + case .main: + return Color.Overblue015 + case .info: + return Color.Overgray010 + case .success: + return Color.Success100.opacity(0.15) + case .error: + return Color.Error100.opacity(0.15) + case .inProgress: + return Color(red: 0.84, green: 0.85, blue: 0.09).opacity(0.15) + case .warning: + return Color.Orange100.opacity(0.15) + case .disabled: + return Color.Overgray015.opacity(0.15) + } + } + + var textColor: Color { + switch self { + case .main: + return Color.Blue100 + case .info: + return Color.Foreground150 + case .success: + return Color.Success100 + case .error: + return Color.Error100 + case .inProgress: + return Color(red: 0.84, green: 0.85, blue: 0.09) + case .warning: + return Color.Orange100 + case .disabled: + return Color.Overgray015 + } + } + + public var id: Self { + return self + } + } + + let title: String + let variant: Variant + + @Backport.ScaledMetric var scale: CGFloat = 1 + + public init(title: String, variant: Variant) { + self.title = title + self.variant = variant + } + + public var body: some View { + Text(title) + .font(.micro700) + .lineLimit(1) + .foregroundColor(variant.textColor) + .padding(Spacing.xxxs * scale) + .background(variant.backgroundColor) + .cornerRadius(Radius.xxxxxs * scale) + } +} + +#if DEBUG + public struct W3MTagPreviewView: View { + public init() {} + + public var body: some View { + VStack { + ForEach(W3MTag.Variant.allCases) { + W3MTag(title: $0.rawValue, variant: $0) + } + } + .padding() + .background(Color.Overgray002) + } + } + + struct W3MTag_Preview: PreviewProvider { + static var previews: some View { + W3MTagPreviewView() + .previewLayout(.sizeThatFits) + } + } + +#endif diff --git a/Sources/Web3ModalUI/Components/W3MTextField.swift b/Sources/Web3ModalUI/Components/W3MTextField.swift new file mode 100644 index 000000000..945d97d77 --- /dev/null +++ b/Sources/Web3ModalUI/Components/W3MTextField.swift @@ -0,0 +1,86 @@ +import SwiftUI + +public struct W3MTextField: View { + var titleKey: LocalizedStringKey + @Binding var text: String + + /// Whether the user is focused on this `TextField`. + @State var isEditing: Bool = false + + public init( + _ titleKey: LocalizedStringKey, + text: Binding + ) { + self.titleKey = titleKey + self._text = text + } + + public var body: some View { + TextField(self.titleKey, text: self.$text, onEditingChanged: { self.isEditing = $0 }) + .padding(.horizontal, Spacing.xxl) + .padding(.vertical, Spacing.xxxxs) + .backport.overlay(alignment: .leading) { + Image.Medium.magnifier + .foregroundColor(.Foreground275) + } + .backport.overlay(alignment: .trailing) { + if !self.text.isEmpty { + Button(action: { + self.text = "" + }) { + ZStack { + RoundedRectangle(cornerRadius: Radius.xxxxs) + .fill(.GrayGlass020) + .frame(width: 18, height: 18) + .padding(.vertical, Spacing.xxxs) + + Image.Medium.xMark + .resizable() + .frame(width: 10, height: 10) + .foregroundColor(.Background250) + .blendMode(.destinationOut) + } + .compositingGroup() + } + } + } + .foregroundColor(.Foreground100) + .font(.paragraph500) + .padding(.vertical, Spacing.xs) + .padding(.horizontal, Spacing.s) + .background( + RoundedRectangle(cornerRadius: Radius.xxs) + .fill(self.isEditing ? .GrayGlass010 : .GrayGlass005) + ) + .background( + RoundedRectangle(cornerRadius: Radius.xxs) + .stroke(.GrayGlass005, lineWidth: 1) + ) + .backport.background { + if self.isEditing { + ZStack { + RoundedRectangle(cornerRadius: Radius.xxs) + .fill(Color(red: 0.2, green: 0.59, blue: 1).opacity(0.2)) + + RoundedRectangle(cornerRadius: Radius.xxs) + .inset(by: 4) + .blendMode(.destinationOut) + + RoundedRectangle(cornerRadius: Radius.xxs) + .inset(by: 4) + .stroke(Color.Blue100, lineWidth: 1) + } + .compositingGroup() + } + } + } +} + +struct W3MTextFieldStylePreview: PreviewProvider { + static var previews: some View { + VStack { + W3MTextField("FOoo", text: .constant("")) + } + .padding() + } +} diff --git a/Sources/Web3ModalUI/Helpers/Bundle.swift b/Sources/Web3ModalUI/Helpers/Bundle.swift new file mode 100644 index 000000000..6262ba066 --- /dev/null +++ b/Sources/Web3ModalUI/Helpers/Bundle.swift @@ -0,0 +1,15 @@ +import Foundation + + +#if CocoaPods +public extension Foundation.Bundle { + private class CocoapodsBundle {} + + static var module: Bundle { + let bundle = Bundle(for: CocoapodsBundle.self) + let frameworkBundlePath = bundle.path(forResource: "Web3ModalUI", ofType: "bundle")! + return Bundle(path: frameworkBundlePath) ?? bundle + } +} + +#endif diff --git a/Sources/Web3ModalUI/Helpers/Extensions/Color+extension.swift b/Sources/Web3ModalUI/Helpers/Extensions/Color+extension.swift new file mode 100644 index 000000000..12d42911e --- /dev/null +++ b/Sources/Web3ModalUI/Helpers/Extensions/Color+extension.swift @@ -0,0 +1,66 @@ +import SwiftUI + +public extension ShapeStyle where Self == Color { + static var Background100: Color { Color(#function, bundle: .module) } + static var Background125: Color { Color(#function, bundle: .module) } + static var Background150: Color { Color(#function, bundle: .module) } + static var Background175: Color { Color(#function, bundle: .module) } + static var Background200: Color { Color(#function, bundle: .module) } + static var Background225: Color { Color(#function, bundle: .module) } + static var Background250: Color { Color(#function, bundle: .module) } + static var Background275: Color { Color(#function, bundle: .module) } + static var Background300: Color { Color(#function, bundle: .module) } + static var BlackAndWhite100: Color { Color(#function, bundle: .module) } + static var Blue080: Color { Color(#function, bundle: .module) } + static var Blue090: Color { Color(#function, bundle: .module) } + static var Blue100: Color { Color(#function, bundle: .module) } + static var Error100: Color { Color(#function, bundle: .module) } + static var Foreground100: Color { Color(#function, bundle: .module) } + static var Foreground125: Color { Color(#function, bundle: .module) } + static var Foreground150: Color { Color(#function, bundle: .module) } + static var Foreground175: Color { Color(#function, bundle: .module) } + static var Foreground200: Color { Color(#function, bundle: .module) } + static var Foreground225: Color { Color(#function, bundle: .module) } + static var Foreground250: Color { Color(#function, bundle: .module) } + static var Foreground275: Color { Color(#function, bundle: .module) } + static var Foreground300: Color { Color(#function, bundle: .module) } + static var Glass75: Color { Color(#function, bundle: .module) } + static var Glass88: Color { Color(#function, bundle: .module) } + static var Indigo100: Color { Color(#function, bundle: .module) } + static var Inverse000: Color { Color(#function, bundle: .module) } + static var Inverse100: Color { Color(#function, bundle: .module) } + static var Magenta100: Color { Color(#function, bundle: .module) } + static var Orange100: Color { Color(#function, bundle: .module) } + static var Overblue002: Color { Color(#function, bundle: .module) } + static var Overblue005: Color { Color(#function, bundle: .module) } + static var Overblue010: Color { Color(#function, bundle: .module) } + static var Overblue015: Color { Color(#function, bundle: .module) } + static var Overblue020: Color { Color(#function, bundle: .module) } + static var Overblue080: Color { Color(#function, bundle: .module) } + static var Overblue090: Color { Color(#function, bundle: .module) } + static var Overgray001: Color { Color(#function, bundle: .module) } + static var Overgray002: Color { Color(#function, bundle: .module) } + static var Overgray005: Color { Color(#function, bundle: .module) } + static var Overgray010: Color { Color(#function, bundle: .module) } + static var Overgray015: Color { Color(#function, bundle: .module) } + static var Overgray020: Color { Color(#function, bundle: .module) } + static var Overgray025: Color { Color(#function, bundle: .module) } + static var Overgray030: Color { Color(#function, bundle: .module) } + static var Purple100: Color { Color(#function, bundle: .module) } + static var Success100: Color { Color(#function, bundle: .module) } + static var Teal100: Color { Color(#function, bundle: .module) } + static var Yellow100: Color { Color(#function, bundle: .module) } + static var Grey18: Color { Color(#function, bundle: .module) } + static var Grey20: Color { Color(#function, bundle: .module) } + static var Grey22: Color { Color(#function, bundle: .module) } + static var GrayGlass002: Color { Color(#function, bundle: .module) } + static var GrayGlass005: Color { Color(#function, bundle: .module) } + static var GrayGlass010: Color { Color(#function, bundle: .module) } + static var GrayGlass020: Color { Color(#function, bundle: .module) } +} + +public extension UIColor { + static var Blue100: UIColor { UIColor(named: #function, in: .module, compatibleWith: nil) ?? .blue } + static var Background125: UIColor { UIColor(named: #function, in: .module, compatibleWith: nil) ?? .blue } + static var Foreground100: UIColor { UIColor(named: #function, in: .module, compatibleWith: nil) ?? .blue } +} diff --git a/Sources/Web3ModalUI/Helpers/Extensions/Font+extension.swift b/Sources/Web3ModalUI/Helpers/Extensions/Font+extension.swift new file mode 100644 index 000000000..35ab48aff --- /dev/null +++ b/Sources/Web3ModalUI/Helpers/Extensions/Font+extension.swift @@ -0,0 +1,120 @@ +import SwiftUI + +public enum W3MFont { + case large500 + case large600 + case large700 + case micro600 + case micro700 + case paragraph500 + case paragraph600 + case paragraph700 + case small400 + case small500 + case small600 + case tiny500 + case tiny600 + case title500 + case title600 + case title700 + + var weight: Font.Weight { + switch self { + case .large500: return .medium + case .large600: return .semibold + case .large700: return .bold + case .micro600: return .semibold + case .micro700: return .bold + case .paragraph500: return .medium + case .paragraph600: return .semibold + case .paragraph700: return .bold + case .small400: return .regular + case .small500: return .medium + case .small600: return .semibold + case .tiny500: return .medium + case .tiny600: return .semibold + case .title500: return .medium + case .title600: return .semibold + case .title700: return .bold + } + } + + var size: CGFloat { + switch self { + case .large500: return 20.0 + case .large600: return 20.0 + case .large700: return 20.0 + case .micro600: return 10.0 + case .micro700: return 10.0 + case .paragraph500: return 16.0 + case .paragraph600: return 16.0 + case .paragraph700: return 16.0 + case .small400: return 14.0 + case .small500: return 14.0 + case .small600: return 14.0 + case .tiny500: return 12.0 + case .tiny600: return 12.0 + case .title500: return 24.0 + case .title600: return 24.0 + case .title700: return 24.0 + } + } +} + +struct ScaledFont: ViewModifier { + @Environment(\.sizeCategory) var sizeCategory + + var size: Double + var weight: Font.Weight + + func body(content: Content) -> some View { + let scaledSize = UIFontMetrics.default.scaledValue(for: size) + return content.font(.system(size: scaledSize, weight: weight)) + } +} + +extension View { + public func scaledFont(size: Double, weight: Font.Weight) -> some View { + return modifier(ScaledFont(size: size, weight: weight)) + } + + public func font(_ font: W3MFont) -> some View { + return modifier(ScaledFont(size: font.size, weight: font.weight)) + } +} + +struct FontPreviews: PreviewProvider { + @Environment(\.sizeCategory) var sizeCategory + + static var previews: some View { + VStack(spacing: 10) { + Group { + Text("large500").font(.large500) + Text("large600").font(.large600) + Text("large700").font(.large700) + } + Group { + Text("title500").font(.title500) + Text("title600").font(.title600) + Text("title700").font(.title700) + } + Group { + Text("paragraph500").font(.paragraph500) + Text("paragraph600").font(.paragraph600) + Text("paragraph700").font(.paragraph700) + } + Group { + Text("micro600").font(.micro600) + Text("micro700").font(.micro700) + } + Group { + Text("small500").font(.small500) + Text("small600").font(.small600) + } + Group { + Text("tiny500").font(.tiny500) + Text("tiny600").font(.tiny600) + } + } + } +} diff --git a/Sources/Web3ModalUI/Helpers/Extensions/ImageResource_generated.swift b/Sources/Web3ModalUI/Helpers/Extensions/ImageResource_generated.swift new file mode 100644 index 000000000..3a3b37333 --- /dev/null +++ b/Sources/Web3ModalUI/Helpers/Extensions/ImageResource_generated.swift @@ -0,0 +1,675 @@ +import SwiftUI + +public extension Image { + /// The "Regular" asset catalog resource namespace. + enum Regular { + /// The "Regular/4 dots" asset catalog image resource. + public static let _4Dots = Image("Regular/4 dots", bundle: .module) + + /// The "Regular/App" asset catalog image resource. + public static let app = Image("Regular/App", bundle: .module) + + /// The "Regular/Arrow Bottom" asset catalog image resource. + public static let arrowBottom = Image("Regular/Arrow Bottom", bundle: .module) + + /// The "Regular/Bars" asset catalog image resource. + public static let bars = Image("Regular/Bars", bundle: .module) + + /// The "Regular/Bell" asset catalog image resource. + public static let bell = Image("Regular/Bell", bundle: .module) + + /// The "Regular/Browser" asset catalog image resource. + public static let browser = Image("Regular/Browser", bundle: .module) + + /// The "Regular/Extension" asset catalog image resource. + public static let `extension` = Image("Regular/Extension", bundle: .module) + + /// The "Regular/Chart" asset catalog image resource. + public static let chart = Image("Regular/Chart", bundle: .module) + + /// The "Regular/Chat Bubble" asset catalog image resource. + public static let chatBubble = Image("Regular/Chat Bubble", bundle: .module) + + /// The "Regular/Check Circle" asset catalog image resource. + public static let checkCircle = Image("Regular/Check Circle", bundle: .module) + + /// The "Regular/Checkmark" asset catalog image resource. + public static let checkmark = Image("Regular/Checkmark", bundle: .module) + + /// The "Regular/Chevron Left" asset catalog image resource. + public static let chevronLeft = Image("Regular/Chevron Left", bundle: .module) + + /// The "Regular/Code" asset catalog image resource. + public static let code = Image("Regular/Code", bundle: .module) + + /// The "Regular/Coin" asset catalog image resource. + public static let coin = Image("Regular/Coin", bundle: .module) + + /// The "Regular/Compass" asset catalog image resource. + public static let compass = Image("Regular/Compass", bundle: .module) + + /// The "Regular/Copy" asset catalog image resource. + public static let copy = Image("Regular/Copy", bundle: .module) + + /// The "Regular/Desktop" asset catalog image resource. + public static let desktop = Image("Regular/Desktop", bundle: .module) + + /// The "Regular/Double Chevron Right" asset catalog image resource. + public static let doubleChevronRight = Image("Regular/Double Chevron Right", bundle: .module) + + /// The "Regular/External Link" asset catalog image resource. + public static let externalLink = Image("Regular/External Link", bundle: .module) + + /// The "Regular/Eye" asset catalog image resource. + public static let eye = Image("Regular/Eye", bundle: .module) + + /// The "Regular/Eye Crossed" asset catalog image resource. + public static let eyeCrossed = Image("Regular/Eye Crossed", bundle: .module) + + /// The "Regular/Filters" asset catalog image resource. + public static let filters = Image("Regular/Filters", bundle: .module) + + /// The "Regular/Fingerprint" asset catalog image resource. + public static let fingerprint = Image("Regular/Fingerprint", bundle: .module) + + /// The "Regular/Image" asset catalog image resource. + public static let image = Image("Regular/Image", bundle: .module) + + /// The "Regular/Info" asset catalog image resource. + public static let info = Image("Regular/Info", bundle: .module) + + /// The "Regular/Link" asset catalog image resource. + public static let link = Image("Regular/Link", bundle: .module) + + /// The "Regular/Load" asset catalog image resource. + public static let load = Image("Regular/Load", bundle: .module) + + /// The "Regular/Locker" asset catalog image resource. + public static let locker = Image("Regular/Locker", bundle: .module) + + /// The "Regular/Magnifier" asset catalog image resource. + public static let magnifier = Image("Regular/Magnifier", bundle: .module) + + /// The "Regular/Mail" asset catalog image resource. + public static let mail = Image("Regular/Mail", bundle: .module) + + /// The "Regular/Mobile" asset catalog image resource. + public static let mobile = Image("Regular/Mobile", bundle: .module) + + /// The "Regular/Moon" asset catalog image resource. + public static let moon = Image("Regular/Moon", bundle: .module) + + /// The "Regular/Network" asset catalog image resource. + public static let network = Image("Regular/Network", bundle: .module) + + /// The "Regular/QR code" asset catalog image resource. + public static let qrCode = Image("Regular/QR code", bundle: .module) + + /// The "Regular/Question" asset catalog image resource. + public static let question = Image("Regular/Question", bundle: .module) + + /// The "Regular/Question Mark Circle" asset catalog image resource. + public static let questionMarkCircle = Image("Regular/Question Mark Circle", bundle: .module) + + /// The "Regular/Sliders" asset catalog image resource. + public static let sliders = Image("Regular/Sliders", bundle: .module) + + /// The "Regular/Squares" asset catalog image resource. + public static let squares = Image("Regular/Squares", bundle: .module) + + /// The "Regular/Sun" asset catalog image resource. + public static let sun = Image("Regular/Sun", bundle: .module) + + /// The "Regular/Swap Horizontal" asset catalog image resource. + public static let swapHorizontal = Image("Regular/Swap Horizontal", bundle: .module) + + /// The "Regular/Verif" asset catalog image resource. + public static let verif = Image("Regular/Verif", bundle: .module) + + /// The "Regular/Wallet" asset catalog image resource. + public static let wallet = Image("Regular/Wallet", bundle: .module) + + /// The "Regular/Warning Circle" asset catalog image resource. + public static let warningCircle = Image("Regular/Warning Circle", bundle: .module) + + /// The "Regular/X mark" asset catalog image resource. + public static let xMark = Image("Regular/X mark", bundle: .module) + } + + /// The "Original" asset catalog resource namespace. + enum Original { + /// The "Original/Add" asset catalog image resource. + public static let add = Image("Original/Add", bundle: .module) + + /// The "Original/Apple" asset catalog image resource. + public static let apple = Image("Original/Apple", bundle: .module) + + /// The "Original/ArrowDown" asset catalog image resource. + public static let arrowDown = Image("Original/ArrowDown", bundle: .module) + + /// The "Original/ArrowExchange" asset catalog image resource. + public static let arrowExchange = Image("Original/ArrowExchange", bundle: .module) + + /// The "Original/ArrowLeft" asset catalog image resource. + public static let arrowLeft = Image("Original/ArrowLeft", bundle: .module) + + /// The "Original/ArrowRight" asset catalog image resource. + public static let arrowRight = Image("Original/ArrowRight", bundle: .module) + + /// The "Original/ArrowUp" asset catalog image resource. + public static let arrowUp = Image("Original/ArrowUp", bundle: .module) + + /// The "Original/BackwardChevron" asset catalog image resource. + public static let backwardChevron = Image("Original/BackwardChevron", bundle: .module) + + /// The "Original/Checkmark" asset catalog image resource. + public static let checkmark = Image("Original/Checkmark", bundle: .module) + + /// The "Original/Compass" asset catalog image resource. + public static let compass = Image("Original/Compass", bundle: .module) + + /// The "Original/Desktop" asset catalog image resource. + public static let desktop = Image("Original/Desktop", bundle: .module) + + /// The "Original/Disconnect" asset catalog image resource. + public static let disconnect = Image("Original/Disconnect", bundle: .module) + + /// The "Original/Discord" asset catalog image resource. + public static let discord = Image("Original/Discord", bundle: .module) + + /// The "Original/DownwardChevron" asset catalog image resource. + public static let downwardChevron = Image("Original/DownwardChevron", bundle: .module) + + /// The "Original/Error" asset catalog image resource. + public static let error = Image("Original/Error", bundle: .module) + + /// The "Original/Extension" asset catalog image resource. + public static let `extension` = Image("Original/Extension", bundle: .module) + + /// The "Original/ExternalLink" asset catalog image resource. + public static let externalLink = Image("Original/ExternalLink", bundle: .module) + + /// The "Original/Facebook" asset catalog image resource. + public static let facebook = Image("Original/Facebook", bundle: .module) + + /// The "Original/ForwardChevron" asset catalog image resource. + public static let forwardChevron = Image("Original/ForwardChevron", bundle: .module) + + /// The "Original/Github" asset catalog image resource. + public static let github = Image("Original/Github", bundle: .module) + + /// The "Original/Google" asset catalog image resource. + public static let google = Image("Original/Google", bundle: .module) + + /// The "Original/Help" asset catalog image resource. + public static let help = Image("Original/Help", bundle: .module) + + /// The "Original/HelpSmall" asset catalog image resource. + public static let helpSmall = Image("Original/HelpSmall", bundle: .module) + + /// The "Original/History" asset catalog image resource. + public static let history = Image("Original/History", bundle: .module) + + /// The "Original/LargeBackward" asset catalog image resource. + public static let largeBackward = Image("Original/LargeBackward", bundle: .module) + + /// The "Original/LargeClose" asset catalog image resource. + public static let largeClose = Image("Original/LargeClose", bundle: .module) + + /// The "Original/LargeCopy" asset catalog image resource. + public static let largeCopy = Image("Original/LargeCopy", bundle: .module) + + /// The "Original/LargeDesktop" asset catalog image resource. + public static let largeDesktop = Image("Original/LargeDesktop", bundle: .module) + + /// The "Original/LargeEmail" asset catalog image resource. + public static let largeEmail = Image("Original/LargeEmail", bundle: .module) + + /// The "Original/LargeEmoji" asset catalog image resource. + public static let largeEmoji = Image("Original/LargeEmoji", bundle: .module) + + /// The "Original/LargeMoon" asset catalog image resource. + public static let largeMoon = Image("Original/LargeMoon", bundle: .module) + + /// The "Original/LargePhone" asset catalog image resource. + public static let largePhone = Image("Original/LargePhone", bundle: .module) + + /// The "Original/LargeQrcode" asset catalog image resource. + public static let largeQrcode = Image("Original/LargeQrcode", bundle: .module) + + /// The "Original/LargeSun" asset catalog image resource. + public static let largeSun = Image("Original/LargeSun", bundle: .module) + + /// The "Original/LargeTwitter" asset catalog image resource. + public static let largeTwitter = Image("Original/LargeTwitter", bundle: .module) + + /// The "Original/Mail" asset catalog image resource. + public static let mail = Image("Original/Mail", bundle: .module) + + /// The "Original/Off" asset catalog image resource. + public static let off = Image("Original/Off", bundle: .module) + + /// The "Original/Pen" asset catalog image resource. + public static let pen = Image("Original/Pen", bundle: .module) + + /// The "Original/Phone" asset catalog image resource. + public static let phone = Image("Original/Phone", bundle: .module) + + /// The "Original/Popular" asset catalog image resource. + public static let popular = Image("Original/Popular", bundle: .module) + + /// The "Original/Qrcode" asset catalog image resource. + public static let qrcode = Image("Original/Qrcode", bundle: .module) + + /// The "Original/QuestionMarkCircle" asset catalog image resource. + public static let questionMarkCircle = Image("Original/QuestionMarkCircle", bundle: .module) + + /// The "Original/Recent" asset catalog image resource. + public static let recent = Image("Original/Recent", bundle: .module) + + /// The "Original/Retry" asset catalog image resource. + public static let retry = Image("Original/Retry", bundle: .module) + + /// The "Original/Scan" asset catalog image resource. + public static let scan = Image("Original/Scan", bundle: .module) + + /// The "Original/Search" asset catalog image resource. + public static let search = Image("Original/Search", bundle: .module) + + /// The "Original/Telegram" asset catalog image resource. + public static let telegram = Image("Original/Telegram", bundle: .module) + + /// The "Original/ToastError" asset catalog image resource. + public static let toastError = Image("Original/ToastError", bundle: .module) + + /// The "Original/ToastInfo" asset catalog image resource. + public static let toastInfo = Image("Original/ToastInfo", bundle: .module) + + /// The "Original/ToastSuccess" asset catalog image resource. + public static let toastSuccess = Image("Original/ToastSuccess", bundle: .module) + + /// The "Original/Twitch" asset catalog image resource. + public static let twitch = Image("Original/Twitch", bundle: .module) + + /// The "Original/Twitter" asset catalog image resource. + public static let twitter = Image("Original/Twitter", bundle: .module) + + /// The "Original/UpwardChevron" asset catalog image resource. + public static let upwardChevron = Image("Original/UpwardChevron", bundle: .module) + + /// The "Original/Wallet" asset catalog image resource. + public static let wallet = Image("Original/Wallet", bundle: .module) + + /// The "Original/Website" asset catalog image resource. + public static let website = Image("Original/Website", bundle: .module) + } + + /// The "Medium" asset catalog resource namespace. + enum Medium { + /// The "Medium/Android" asset catalog image resource. + public static let android = Image("Medium/Android", bundle: .module) + + /// The "Medium/App" asset catalog image resource. + public static let app = Image("Medium/App", bundle: .module) + + /// The "Medium/Arrow Left" asset catalog image resource. + public static let arrowLeft = Image("Medium/Arrow Left", bundle: .module) + + /// The "Medium/Arrow Right" asset catalog image resource. + public static let arrowRight = Image("Medium/Arrow Right", bundle: .module) + + /// The "Medium/Auth" asset catalog image resource. + public static let auth = Image("Medium/Auth", bundle: .module) + + /// The "Medium/Bell" asset catalog image resource. + public static let bell = Image("Medium/Bell", bundle: .module) + + /// The "Medium/Bin" asset catalog image resource. + public static let bin = Image("Medium/Bin", bundle: .module) + + /// The "Medium/Checkmark" asset catalog image resource. + public static let checkmark = Image("Medium/Checkmark", bundle: .module) + + /// The "Medium/Chevron Bottom" asset catalog image resource. + public static let chevronBottom = Image("Medium/Chevron Bottom", bundle: .module) + + /// The "Medium/Chevron Left" asset catalog image resource. + public static let chevronLeft = Image("Medium/Chevron Left", bundle: .module) + + /// The "Medium/Chevron Right" asset catalog image resource. + public static let chevronRight = Image("Medium/Chevron Right", bundle: .module) + + /// The "Medium/Chevron Top" asset catalog image resource. + public static let chevronTop = Image("Medium/Chevron Top", bundle: .module) + + /// The "Medium/Compass" asset catalog image resource. + public static let compass = Image("Medium/Compass", bundle: .module) + + /// The "Medium/Copy" asset catalog image resource. + public static let copy = Image("Medium/Copy", bundle: .module) + + /// The "Medium/Desktop" asset catalog image resource. + public static let desktop = Image("Medium/Desktop", bundle: .module) + + /// The "Medium/Disconnect" asset catalog image resource. + public static let disconnect = Image("Medium/Disconnect", bundle: .module) + + /// The "Medium/Doc" asset catalog image resource. + public static let doc = Image("Medium/Doc", bundle: .module) + + /// The "Medium/Dots Horizontal" asset catalog image resource. + public static let dotsHorizontal = Image("Medium/Dots Horizontal", bundle: .module) + + /// The "Medium/Dots Vertical" asset catalog image resource. + public static let dotsVertical = Image("Medium/Dots Vertical", bundle: .module) + + /// The "Medium/Double Chevron Vertical" asset catalog image resource. + public static let doubleChevronVertical = Image("Medium/Double Chevron Vertical", bundle: .module) + + /// The "Medium/Etherscan" asset catalog image resource. + public static let etherscan = Image("Medium/Etherscan", bundle: .module) + + /// The "Medium/External Link" asset catalog image resource. + public static let externalLink = Image("Medium/External Link", bundle: .module) + + /// The "Medium/Eye" asset catalog image resource. + public static let eye = Image("Medium/Eye", bundle: .module) + + /// The "Medium/Eye Crossed" asset catalog image resource. + public static let eyeCrossed = Image("Medium/Eye Crossed", bundle: .module) + + /// The "Medium/File" asset catalog image resource. + public static let file = Image("Medium/File", bundle: .module) + + /// The "Medium/Filters" asset catalog image resource. + public static let filters = Image("Medium/Filters", bundle: .module) + + /// The "Medium/Info" asset catalog image resource. + public static let info = Image("Medium/Info", bundle: .module) + + /// The "Medium/Info Circle" asset catalog image resource. + public static let infoCircle = Image("Medium/Info Circle", bundle: .module) + + /// The "Medium/Light Bulb" asset catalog image resource. + public static let lightBulb = Image("Medium/Light Bulb", bundle: .module) + + /// The "Medium/Magnifier" asset catalog image resource. + public static let magnifier = Image("Medium/Magnifier", bundle: .module) + + /// The "Medium/Mail" asset catalog image resource. + public static let mail = Image("Medium/Mail", bundle: .module) + + /// The "Medium/Mobile" asset catalog image resource. + public static let mobile = Image("Medium/Mobile", bundle: .module) + + /// The "Medium/Moon" asset catalog image resource. + public static let moon = Image("Medium/Moon", bundle: .module) + + /// The "Medium/Nut" asset catalog image resource. + public static let nut = Image("Medium/Nut", bundle: .module) + + /// The "Medium/Off" asset catalog image resource. + public static let off = Image("Medium/Off", bundle: .module) + + /// The "Medium/Paste" asset catalog image resource. + public static let paste = Image("Medium/Paste", bundle: .module) + + /// The "Medium/Pen" asset catalog image resource. + public static let pen = Image("Medium/Pen", bundle: .module) + + /// The "Medium/Plus" asset catalog image resource. + public static let plus = Image("Medium/Plus", bundle: .module) + + /// The "Medium/QR code" asset catalog image resource. + public static let qrCode = Image("Medium/QR code", bundle: .module) + + /// The "Medium/Question Mark Circle" asset catalog image resource. + public static let questionMarkCircle = Image("Medium/Question Mark Circle", bundle: .module) + + /// The "Medium/Refresh" asset catalog image resource. + public static let refresh = Image("Medium/Refresh", bundle: .module) + + /// The "Medium/Sliders" asset catalog image resource. + public static let sliders = Image("Medium/Sliders", bundle: .module) + + /// The "Medium/Squares" asset catalog image resource. + public static let squares = Image("Medium/Squares", bundle: .module) + + /// The "Medium/Sun" asset catalog image resource. + public static let sun = Image("Medium/Sun", bundle: .module) + + /// The "Medium/Swap Horizontal" asset catalog image resource. + public static let swapHorizontal = Image("Medium/Swap Horizontal", bundle: .module) + + /// The "Medium/Swap Vertical" asset catalog image resource. + public static let swapVertical = Image("Medium/Swap Vertical", bundle: .module) + + /// The "Medium/Twitter" asset catalog image resource. + public static let twitter = Image("Medium/Twitter", bundle: .module) + + /// The "Medium/Wallet" asset catalog image resource. + public static let wallet = Image("Medium/Wallet", bundle: .module) + + /// The "Medium/Warning Circle" asset catalog image resource. + public static let warningCircle = Image("Medium/Warning Circle", bundle: .module) + + /// The "Medium/Web" asset catalog image resource. + public static let web = Image("Medium/Web", bundle: .module) + + /// The "Medium/X mark" asset catalog image resource. + public static let xMark = Image("Medium/X mark", bundle: .module) + + /// The "Medium/iOS" asset catalog image resource. + public static let iOS = Image("Medium/iOS", bundle: .module) + } + + /// The "Bold" asset catalog resource namespace. + enum Bold { + /// The "Bold/Arrow Bottom" asset catalog image resource. + public static let arrowBottom = Image("Bold/Arrow Bottom", bundle: .module) + + /// The "Bold/Arrow Left" asset catalog image resource. + public static let arrowLeft = Image("Bold/Arrow Left", bundle: .module) + + /// The "Bold/Arrow Right" asset catalog image resource. + public static let arrowRight = Image("Bold/Arrow Right", bundle: .module) + + /// The "Bold/Arrow Top" asset catalog image resource. + public static let arrowTop = Image("Bold/Arrow Top", bundle: .module) + + /// The "Bold/Bars" asset catalog image resource. + public static let bars = Image("Bold/Bars", bundle: .module) + + /// The "Bold/Bin" asset catalog image resource. + public static let bin = Image("Bold/Bin", bundle: .module) + + /// The "Bold/Browser" asset catalog image resource. + public static let browser = Image("Bold/Browser", bundle: .module) + + /// The "Bold/Checkmark" asset catalog image resource. + public static let checkmark = Image("Bold/Checkmark", bundle: .module) + + /// The "Bold/Chevron Bottom" asset catalog image resource. + public static let chevronBottom = Image("Bold/Chevron Bottom", bundle: .module) + + /// The "Bold/Chevron Left" asset catalog image resource. + public static let chevronLeft = Image("Bold/Chevron Left", bundle: .module) + + /// The "Bold/Chevron Right" asset catalog image resource. + public static let chevronRight = Image("Bold/Chevron Right", bundle: .module) + + /// The "Bold/Chevron Top" asset catalog image resource. + public static let chevronTop = Image("Bold/Chevron Top", bundle: .module) + + /// The "Bold/Clock" asset catalog image resource. + public static let clock = Image("Bold/Clock", bundle: .module) + + /// The "Bold/Code" asset catalog image resource. + public static let code = Image("Bold/Code", bundle: .module) + + /// The "Bold/Compass" asset catalog image resource. + public static let compass = Image("Bold/Compass", bundle: .module) + + /// The "Bold/Copy" asset catalog image resource. + public static let copy = Image("Bold/Copy", bundle: .module) + + /// The "Bold/Desktop" asset catalog image resource. + public static let desktop = Image("Bold/Desktop", bundle: .module) + + /// The "Bold/Disconnect" asset catalog image resource. + public static let disconnect = Image("Bold/Disconnect", bundle: .module) + + /// The "Bold/Doc" asset catalog image resource. + public static let doc = Image("Bold/Doc", bundle: .module) + + /// The "Bold/Double Chevron Vertical" asset catalog image resource. + public static let doubleChevronVertical = Image("Bold/Double Chevron Vertical", bundle: .module) + + /// The "Bold/External Link" asset catalog image resource. + public static let externalLink = Image("Bold/External Link", bundle: .module) + + /// The "Bold/Eye" asset catalog image resource. + public static let eye = Image("Bold/Eye", bundle: .module) + + /// The "Bold/Eye Crossed" asset catalog image resource. + public static let eyeCrossed = Image("Bold/Eye Crossed", bundle: .module) + + /// The "Bold/Filters" asset catalog image resource. + public static let filters = Image("Bold/Filters", bundle: .module) + + /// The "Bold/Image" asset catalog image resource. + public static let image = Image("Bold/Image", bundle: .module) + + /// The "Bold/Info" asset catalog image resource. + public static let info = Image("Bold/Info", bundle: .module) + + /// The "Bold/Light Bulb" asset catalog image resource. + public static let lightBulb = Image("Bold/Light Bulb", bundle: .module) + + /// The "Bold/Link" asset catalog image resource. + public static let link = Image("Bold/Link", bundle: .module) + + /// The "Bold/Mail" asset catalog image resource. + public static let mail = Image("Bold/Mail", bundle: .module) + + /// The "Bold/Mobile" asset catalog image resource. + public static let mobile = Image("Bold/Mobile", bundle: .module) + + /// The "Bold/Moon" asset catalog image resource. + public static let moon = Image("Bold/Moon", bundle: .module) + + /// The "Bold/Network" asset catalog image resource. + public static let network = Image("Bold/Network", bundle: .module) + + /// The "Bold/Nut" asset catalog image resource. + public static let nut = Image("Bold/Nut", bundle: .module) + + /// The "Bold/Off" asset catalog image resource. + public static let off = Image("Bold/Off", bundle: .module) + + /// The "Bold/Pen" asset catalog image resource. + public static let pen = Image("Bold/Pen", bundle: .module) + + /// The "Bold/Plus" asset catalog image resource. + public static let plus = Image("Bold/Plus", bundle: .module) + + /// The "Bold/Question Mark Circle" asset catalog image resource. + public static let questionMarkCircle = Image("Bold/Question Mark Circle", bundle: .module) + + /// The "Bold/Refresh" asset catalog image resource. + public static let refresh = Image("Bold/Refresh", bundle: .module) + + /// The "Bold/Sliders Horizontal" asset catalog image resource. + public static let slidersHorizontal = Image("Bold/Sliders Horizontal", bundle: .module) + + /// The "Bold/Sliders Vertical" asset catalog image resource. + public static let slidersVertical = Image("Bold/Sliders Vertical", bundle: .module) + + /// The "Bold/Squares" asset catalog image resource. + public static let squares = Image("Bold/Squares", bundle: .module) + + /// The "Bold/Sun" asset catalog image resource. + public static let sun = Image("Bold/Sun", bundle: .module) + + /// The "Bold/Swap Horizontal" asset catalog image resource. + public static let swapHorizontal = Image("Bold/Swap Horizontal", bundle: .module) + + /// The "Bold/Swap Vertical" asset catalog image resource. + public static let swapVertical = Image("Bold/Swap Vertical", bundle: .module) + + /// The "Bold/Users" asset catalog image resource. + public static let users = Image("Bold/Users", bundle: .module) + + /// The "Bold/Wallet" asset catalog image resource. + public static let wallet = Image("Bold/Wallet", bundle: .module) + + /// The "Bold/Warning Circle" asset catalog image resource. + public static let warningCircle = Image("Bold/Warning Circle", bundle: .module) + + /// The "Bold/Web" asset catalog image resource. + public static let web = Image("Bold/Web", bundle: .module) + + /// The "Bold/X Mark" asset catalog image resource. + public static let xMark = Image("Bold/X Mark", bundle: .module) + } + + /// The "MockChainImage" asset catalog image resource. + static let mockChain = Image("MockChainImage", bundle: .module) + + /// The "MockWalletImage" asset catalog image resource. + static let mockWallet = Image("MockWalletImage", bundle: .module) + + /// The "imageBrowser" asset catalog image resource. + static let imageBrowser = Image("imageBrowser", bundle: .module) + + /// The "imageDao" asset catalog image resource. + static let imageDao = Image("imageDao", bundle: .module) + + /// The "imageDeFi" asset catalog image resource. + static let imageDeFi = Image("imageDeFi", bundle: .module) + + /// The "imageDefiAlt" asset catalog image resource. + static let imageDefiAlt = Image("imageDefiAlt", bundle: .module) + + /// The "imageEth" asset catalog image resource. + static let imageEth = Image("imageEth", bundle: .module) + + /// The "imageLayers" asset catalog image resource. + static let imageLayers = Image("imageLayers", bundle: .module) + + /// The "imageLock" asset catalog image resource. + static let imageLock = Image("imageLock", bundle: .module) + + /// The "imageLogin" asset catalog image resource. + static let imageLogin = Image("imageLogin", bundle: .module) + + /// The "imageLogo" asset catalog image resource. + static let imageLogo = Image("imageLogo", bundle: .module) + + /// The "imageNetwork" asset catalog image resource. + static let imageNetwork = Image("imageNetwork", bundle: .module) + + /// The "imageNft" asset catalog image resource. + static let imageNft = Image("imageNft", bundle: .module) + + /// The "imageNoun" asset catalog image resource. + static let imageNoun = Image("imageNoun", bundle: .module) + + /// The "imageProfile" asset catalog image resource. + static let imageProfile = Image("imageProfile", bundle: .module) + + /// The "imageSystem" asset catalog image resource. + static let imageSystem = Image("imageSystem", bundle: .module) + + /// The "optionAll" asset catalog image resource. + static let optionAll = Image("optionAll", bundle: .module) + + /// The "optionBrowser" asset catalog image resource. + static let optionBrowser = Image("optionBrowser", bundle: .module) + + /// The "optionExtension" asset catalog image resource. + static let optionExtension = Image("optionExtension", bundle: .module) + + /// The "optionQrCode" asset catalog image resource. + static let optionQrCode = Image("optionQrCode", bundle: .module) +} diff --git a/Sources/Web3ModalUI/Helpers/Radius.swift b/Sources/Web3ModalUI/Helpers/Radius.swift new file mode 100644 index 000000000..3e1fbca5a --- /dev/null +++ b/Sources/Web3ModalUI/Helpers/Radius.swift @@ -0,0 +1,25 @@ +import Foundation + +public enum Radius { + /// Default 4 points + public static var masterRadius: CGFloat = 4 + + /// Default 4 points + public static var xxxxxs: CGFloat = masterRadius + /// Default 6 points + public static var xxxxs: CGFloat = masterRadius * 1.5 + /// Default 8 points + public static var xxxs: CGFloat = masterRadius * 2 + /// Default 12 points + public static var xxs: CGFloat = masterRadius * 3 + /// Default 16 points + public static var xs: CGFloat = masterRadius * 4 + /// Default 20 points + public static var s: CGFloat = masterRadius * 5 + /// Default 28 points + public static var m: CGFloat = masterRadius * 7 + /// Default 36 points + public static var l: CGFloat = masterRadius * 9 + /// Default 80 points + public static var xxxl: CGFloat = masterRadius * 20 +} diff --git a/Sources/Web3ModalUI/Helpers/Spacing.swift b/Sources/Web3ModalUI/Helpers/Spacing.swift new file mode 100644 index 000000000..4a76b3c13 --- /dev/null +++ b/Sources/Web3ModalUI/Helpers/Spacing.swift @@ -0,0 +1,26 @@ +import Foundation + +public enum Spacing { + /// 0 points + public static var zero: CGFloat = 0 + /// 2 points + public static var xxxxs: CGFloat = 2 + /// 4 points + public static var xxxs: CGFloat = 4 + /// 6 points + public static var xxs: CGFloat = 6 + /// 8 points + public static var xs: CGFloat = 8 + /// 12 points + public static var s: CGFloat = 12 + /// 14 points + public static var m: CGFloat = 14 + /// 16 points + public static var l: CGFloat = 16 + /// 20 points + public static var xl: CGFloat = 20 + /// 24 points + public static var xxl: CGFloat = 24 + /// 80 points + public static var xxxl: CGFloat = 80 +} diff --git a/Sources/Web3ModalUI/Miscellaneous/AdaptiveStack.swift b/Sources/Web3ModalUI/Miscellaneous/AdaptiveStack.swift new file mode 100644 index 000000000..5eeab6afd --- /dev/null +++ b/Sources/Web3ModalUI/Miscellaneous/AdaptiveStack.swift @@ -0,0 +1,39 @@ +import SwiftUI + +struct AdaptiveStack: View { + let horizontalAlignment: HorizontalAlignment + let verticalAlignment: VerticalAlignment + let spacing: CGFloat? + let content: () -> Content + let condition: () -> Bool + + init( + condition: @autoclosure @escaping () -> Bool, + horizontalAlignment: HorizontalAlignment = .center, + verticalAlignment: VerticalAlignment = .center, + spacing: CGFloat? = nil, + @ViewBuilder content: @escaping () -> Content + ) { + self.condition = condition + self.horizontalAlignment = horizontalAlignment + self.verticalAlignment = verticalAlignment + self.spacing = spacing + self.content = content + } + + var body: some View { + if condition() { + VStack( + alignment: horizontalAlignment, + spacing: spacing, + content: content + ) + } else { + HStack( + alignment: verticalAlignment, + spacing: spacing, + content: content + ) + } + } +} diff --git a/Sources/Web3ModalUI/Miscellaneous/Binding+extension.swift b/Sources/Web3ModalUI/Miscellaneous/Binding+extension.swift new file mode 100644 index 000000000..1d872b670 --- /dev/null +++ b/Sources/Web3ModalUI/Miscellaneous/Binding+extension.swift @@ -0,0 +1,9 @@ +import SwiftUI + +public extension Binding { + /// Shorthand for default binding. Usually handy in View initialisers where outside binding is optional. + static func stored(_ value: Value) -> Self { + var value = value + return .init(get: { value }, set: { value = $0 }) + } +} diff --git a/Sources/Web3ModalUI/Miscellaneous/DrawingProgressView.swift b/Sources/Web3ModalUI/Miscellaneous/DrawingProgressView.swift new file mode 100644 index 000000000..a8a192e9d --- /dev/null +++ b/Sources/Web3ModalUI/Miscellaneous/DrawingProgressView.swift @@ -0,0 +1,451 @@ +import SwiftUI +import UIKit + +public struct DrawingProgressView: UIViewRepresentable { + var shape: DrawingProgressUIView.ShapePath + var color: UIColor + var lineWidth: CGFloat + var duration: Double + + @Binding var isAnimating: Bool + + public init( + shape: DrawingProgressUIView.ShapePath, + color: UIColor, + lineWidth: CGFloat, + duration: Double = 1.5, + isAnimating: Binding + ) { + self.shape = shape + self.color = color + self.lineWidth = lineWidth + self.duration = duration + self._isAnimating = isAnimating + } + + public func makeUIView(context: Context) -> DrawingProgressUIView { + let view = DrawingProgressUIView( + shape: shape, + colors: [color], + lineWidth: lineWidth, + duration: duration + ) + + view.isAnimating = true + + switch self.shape { + case .circle, .roundedRectangleRelative, .roundedRectangleAbsolute: + view.transform = .identity.rotated(by: -CGFloat.pi / 2) + case .hexagon: + break + } + + return view + } + + public func updateUIView(_ uiView: DrawingProgressUIView, context: Context) { + uiView.isAnimating = true + } +} + +struct DrawingProgressView_Preview: PreviewProvider { + static var previews: some View { + VStack { + DrawingProgressView( + shape: .circle, + color: .blue, + lineWidth: 5, + isAnimating: .constant(true) + ) + .frame(width: 100, height: 100) + + DrawingProgressView( + shape: .roundedRectangleAbsolute(cornerRadius: 5), + color: .blue, + lineWidth: 5, + isAnimating: .constant(true) + ) + .frame(width: 100, height: 100) + + DrawingProgressView( + shape: .roundedRectangleRelative(relativeCornerRadius: 0.25), + color: .blue, + lineWidth: 5, + isAnimating: .constant(true) + ) + .frame(width: 100, height: 100) + + DrawingProgressView( + shape: .hexagon, + color: .blue, + lineWidth: 5, + isAnimating: .constant(true) + ) + .frame(width: 100, height: 100) + } + } +} + +public class DrawingProgressUIView: UIView { + public enum ShapePath { + case circle + case roundedRectangleRelative(relativeCornerRadius: Double) + case roundedRectangleAbsolute(cornerRadius: Double) + case hexagon + } + + // MARK: - Properties + + let shape: ShapePath + let colors: [UIColor] + let lineWidth: CGFloat + let duration: Double + + private lazy var shapeLayer: ProgressShapeLayer = .init(strokeColor: colors.first!, lineWidth: lineWidth) + + var isAnimating: Bool = false { + didSet { + if self.isAnimating { + self.animateStroke() + } else { + self.shapeLayer.removeFromSuperlayer() + self.layer.removeAllAnimations() + self.removeFromSuperview() + } + } + } + + // MARK: - Initialization + + init( + shape: ShapePath, + frame: CGRect, + colors: [UIColor], + lineWidth: CGFloat, + duration: Double + ) { + self.shape = shape + self.colors = colors + self.lineWidth = lineWidth + self.duration = duration + + super.init(frame: frame) + + self.backgroundColor = .clear + } + + convenience init( + shape: ShapePath, + colors: [UIColor], + lineWidth: CGFloat, + duration: Double + ) { + self.init( + shape: shape, + frame: .zero, + colors: colors, + lineWidth: lineWidth, + duration: duration + ) + } + + @available(*, unavailable) + required init?(coder: NSCoder) { + fatalError("init(coder:) is not supported") + } + + override public func layoutSubviews() { + super.layoutSubviews() + + let path: CGPath + + switch self.shape { + case .circle: + path = UIBezierPath(ovalIn: frame).cgPath + case let .roundedRectangleRelative(relativeCornerRadius): + path = CGPath( + roundedRect: self.frame, + cornerWidth: self.frame.width * relativeCornerRadius, + cornerHeight: self.frame.height * relativeCornerRadius, + transform: nil + ) + case let .roundedRectangleAbsolute(cornerRadius): + path = CGPath( + roundedRect: self.frame, + cornerWidth: cornerRadius, + cornerHeight: cornerRadius, + transform: nil + ) + case .hexagon: + path = Polygon(count: 6, relativeCornerRadius: 0.25).path(in: frame).cgPath + } + + self.shapeLayer.path = path + + isAnimating = true + } + + // MARK: - Animations + + func animateStroke() { + let beginTime = 0.25 + + let startAnimation = StrokeAnimation( + type: .start, + beginTime: beginTime, + fromValue: 0.0, + toValue: 1.0, + duration: duration - beginTime + ) + + let endAnimation = StrokeAnimation( + type: .end, + fromValue: 0.0, + toValue: 1.0, + duration: duration - beginTime + ) + + let strokeAnimationGroup = CAAnimationGroup() + strokeAnimationGroup.duration = self.duration + strokeAnimationGroup.repeatDuration = .infinity + strokeAnimationGroup.animations = [startAnimation, endAnimation] + + self.shapeLayer.add(strokeAnimationGroup, forKey: "stroke") + + let colorAnimation = StrokeColorAnimation( + colors: colors.map { $0.cgColor }, + duration: strokeAnimationGroup.duration * Double(self.colors.count) + ) + + self.shapeLayer.add(colorAnimation, forKey: "color") + + self.layer.addSublayer(self.shapeLayer) + + self.shapeLayer.makeAnimationsPersistent() + } + + func animateRotation() { + let rotationAnimation = RotationAnimation( + direction: .z, + fromValue: 0, + toValue: CGFloat.pi * 2, + duration: 2, + repeatCount: .greatestFiniteMagnitude + ) + + self.layer.add(rotationAnimation, forKey: nil) + } +} + +class ProgressShapeLayer: CAShapeLayer { + public init(strokeColor: UIColor, lineWidth: CGFloat) { + super.init() + + self.strokeColor = strokeColor.cgColor + self.lineWidth = lineWidth + self.fillColor = UIColor.clear.cgColor + self.lineCap = .round + } + + @available(*, unavailable) + required init?(coder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } +} + +class RotationAnimation: CABasicAnimation { + enum Direction: String { + case x, y, z + } + + override init() { + super.init() + } + + public init( + direction: Direction, + fromValue: CGFloat, + toValue: CGFloat, + duration: Double, + repeatCount: Float + ) { + super.init() + + self.keyPath = "transform.rotation.\(direction.rawValue)" + + self.fromValue = fromValue + self.toValue = toValue + + self.duration = duration + + self.repeatCount = repeatCount + } + + @available(*, unavailable) + required init?(coder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } +} + +class StrokeAnimation: CABasicAnimation { + override init() { + super.init() + } + + init( + type: StrokeType, + beginTime: Double = 0.0, + fromValue: CGFloat, + toValue: CGFloat, + duration: Double + ) { + super.init() + + self.keyPath = type == .start ? "strokeStart" : "strokeEnd" + + self.beginTime = beginTime + self.fromValue = fromValue + self.toValue = toValue + self.duration = duration + self.timingFunction = .init(name: .easeInEaseOut) + } + + @available(*, unavailable) + required init?(coder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } + + enum StrokeType { + case start + case end + } +} + +class StrokeColorAnimation: CAKeyframeAnimation { + override init() { + super.init() + } + + init(colors: [CGColor], duration: Double) { + super.init() + + self.keyPath = "strokeColor" + self.values = colors + self.duration = duration + self.repeatCount = .greatestFiniteMagnitude + self.timingFunction = .init(name: .easeInEaseOut) + } + + @available(*, unavailable) + required init?(coder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } +} + +public extension CALayer { + var isAnimationsPaused: Bool { + return speed == 0.0 + } + + func pauseAnimations() { + if !self.isAnimationsPaused { + let currentTime = CACurrentMediaTime() + let pausedTime = convertTime(currentTime, from: nil) + speed = 0.0 + timeOffset = pausedTime + } + } + + func resumeAnimations() { + let pausedTime = timeOffset + speed = 1.0 + timeOffset = 0.0 + beginTime = 0.0 + let currentTime = CACurrentMediaTime() + let timeSincePause = convertTime(currentTime, from: nil) - pausedTime + beginTime = timeSincePause + } +} + +public extension CALayer { + private static var persistentHelperKey = "CALayer.LayerPersistentHelper" + + func makeAnimationsPersistent() { + withUnsafePointer(to: &CALayer.persistentHelperKey) { + var object = objc_getAssociatedObject(self, $0) + + if object == nil { + object = LayerPersistentHelper(with: self) + let nonatomic = objc_AssociationPolicy.OBJC_ASSOCIATION_RETAIN_NONATOMIC + objc_setAssociatedObject(self, $0, object, nonatomic) + } + } + } +} + +public class LayerPersistentHelper { + private var persistentAnimations: [String: CAAnimation] = [:] + private var persistentSpeed: Float = 0.0 + private weak var layer: CALayer? + + public init(with layer: CALayer) { + self.layer = layer + addNotificationObservers() + } + + deinit { + removeNotificationObservers() + } +} + +private extension LayerPersistentHelper { + func addNotificationObservers() { + let center = NotificationCenter.default + let enterForeground = UIApplication.willEnterForegroundNotification + let enterBackground = UIApplication.didEnterBackgroundNotification + center.addObserver(self, selector: #selector(didBecomeActive), name: enterForeground, object: nil) + center.addObserver(self, selector: #selector(willResignActive), name: enterBackground, object: nil) + } + + func removeNotificationObservers() { + NotificationCenter.default.removeObserver(self) + } + + func persistAnimations(with keys: [String]?) { + guard let layer = self.layer else { return } + keys?.forEach { key in + if let animation = layer.animation(forKey: key) { + self.persistentAnimations[key] = animation + } + } + } + + func restoreAnimations(with keys: [String]?) { + guard let layer = self.layer else { return } + keys?.forEach { key in + if let animation = persistentAnimations[key] { + layer.add(animation, forKey: key) + } + } + } +} + +@objc extension LayerPersistentHelper { + func didBecomeActive() { + guard let layer = self.layer else { return } + self.restoreAnimations(with: Array(self.persistentAnimations.keys)) + self.persistentAnimations.removeAll() + if self.persistentSpeed == 1.0 { // if layer was playing before background, resume it + layer.resumeAnimations() + } + } + + func willResignActive() { + guard let layer = self.layer else { return } + self.persistentSpeed = layer.speed + layer.speed = 1.0 // in case layer was paused from outside, set speed to 1.0 to get all animations + self.persistAnimations(with: layer.animationKeys()) + layer.speed = self.persistentSpeed // restore original speed + layer.pauseAnimations() + } +} diff --git a/Sources/Web3ModalUI/Miscellaneous/Polygon.swift b/Sources/Web3ModalUI/Miscellaneous/Polygon.swift new file mode 100644 index 000000000..957b8e263 --- /dev/null +++ b/Sources/Web3ModalUI/Miscellaneous/Polygon.swift @@ -0,0 +1,242 @@ +import SwiftUI + +/// Animatable Polygon +public struct Polygon: Shape { + + let count: Int + + enum CornerRadius { + case relative(CGFloat) + case constant(CGFloat) + func relativeRadius(maxRadius: CGFloat) -> CGFloat { + switch self { + case .relative(let relativeRadius): + return relativeRadius + case .constant(let radius): + return radius / maxRadius + } + } + var animatablePair: AnimatablePair { + get { + switch self { + case .relative(let relativeRadius): + return AnimatablePair(0.0, relativeRadius) + case .constant(let radius): + return AnimatablePair(1.0, radius) + } + } + set { + if newValue.first == 0.0 { + self = .relative(newValue.second) + } else { + self = .constant(newValue.second) + } + } + } + } + + var cornerRadius: CornerRadius + + public var animatableData: AnimatablePair { + get { + cornerRadius.animatablePair + } + set { + cornerRadius.animatablePair = newValue + } + } + + public init(count: Int, cornerRadius: CGFloat = 0.0) { + self.count = max(count, 3) + self.cornerRadius = .constant(max(cornerRadius, 0.0)) + } + + /// `relativeCornerRadius` is between `0.0` and `1.0`, where `0.0` is a pure polygon and `1.0` is a circle. + public init(count: Int, relativeCornerRadius: CGFloat) { + self.count = max(count, 3) + self.cornerRadius = .relative(min(max(relativeCornerRadius, 0.0), 1.0)) + } + + public func path(in rect: CGRect) -> Path { + + var path = Path() + + let size: CGSize = rect.size + + let maxRadius = maxRadius(size: size) + let relativeCornerRadius = cornerRadius.relativeRadius(maxRadius: maxRadius) + + if relativeCornerRadius == 0.0 { + + for i in 0.. CGFloat { + min(size.width, size.height) / 2.0 + } + + func angle(index: CGFloat) -> CGFloat { + index / CGFloat(count) - 0.25 + } + + func point(angle: CGFloat, size: CGSize) -> CGPoint { + let x: CGFloat = size.width / 2.0 + cos(angle * .pi * 2.0) * radius(size: size) + let y: CGFloat = size.height / 2.0 + sin(angle * .pi * 2.0) * radius(size: size) + return CGPoint(x: x, y: y) + } + + func maxRadius(size: CGSize) -> CGFloat { + + let currentPoint: CGPoint = point(angle: angle(index: 0.0), size: size) + let nextPoint: CGPoint = point(angle: angle(index: 1.0), size: size) + + let midPoint: CGPoint = CGPoint(x: (currentPoint.x + nextPoint.x) / 2, + y: (currentPoint.y + nextPoint.y) / 2) + + let centerPoint: CGPoint = CGPoint(x: size.width / 2, + y: size.height / 2) + + let pointDistance: CGPoint = CGPoint(x: abs(midPoint.x - centerPoint.x), + y: abs(midPoint.y - centerPoint.y)) + let distance: CGFloat = hypot(pointDistance.x, pointDistance.y) + + return distance + + } + + struct RounedCornerCircle { + let center: CGPoint + let leading: CGPoint + let trailing: CGPoint + } + + func rounedCornerCircle(leading: CGPoint, + center: CGPoint, + trailing: CGPoint, + cornerRadius: CGFloat) -> RounedCornerCircle { + rounedCornerCircle(center, leading, trailing, cornerRadius) + } + + private func rounedCornerCircle(_ p: CGPoint, + _ p1: CGPoint, + _ p2: CGPoint, + _ r: CGFloat) -> RounedCornerCircle { + + var r: CGFloat = r + + //Vector 1 + let dx1: CGFloat = p.x - p1.x + let dy1: CGFloat = p.y - p1.y + + //Vector 2 + let dx2: CGFloat = p.x - p2.x + let dy2: CGFloat = p.y - p2.y + + //Angle between vector 1 and vector 2 divided by 2 + let angle: CGFloat = (atan2(dy1, dx1) - atan2(dy2, dx2)) / 2 + + // The length of segment between angular point and the + // points of intersection with the circle of a given radius + let _tan: CGFloat = abs(tan(angle)) + var segment: CGFloat = r / _tan + + //Check the segment + let length1: CGFloat = sqrt(pow(dx1, 2) + pow(dy1, 2)) + let length2: CGFloat = sqrt(pow(dx2, 2) + pow(dy2, 2)) + + let _length: CGFloat = min(length1, length2) + + if segment > _length { + segment = _length; + r = _length * _tan; + } + + // Points of intersection are calculated by the proportion between + // the coordinates of the vector, length of vector and the length of the segment. + let p1Cross: CGPoint = proportion(p, segment, length1, dx1, dy1) + let p2Cross: CGPoint = proportion(p, segment, length2, dx2, dy2) + + // Calculation of the coordinates of the circle + // center by the addition of angular vectors. + let dx: CGFloat = p.x * 2 - p1Cross.x - p2Cross.x + let dy: CGFloat = p.y * 2 - p1Cross.y - p2Cross.y + + let L: CGFloat = sqrt(pow(dx, 2) + pow(dy, 2)) + let d: CGFloat = sqrt(pow(segment, 2) + pow(r, 2)) + + let circlePoint: CGPoint = proportion(p, d, L, dx, dy) + + return RounedCornerCircle(center: circlePoint, leading: p1Cross, trailing: p2Cross) + + } + + private func proportion(_ point: CGPoint, + _ segment: CGFloat, + _ length: CGFloat, + _ dx: CGFloat, + _ dy: CGFloat) -> CGPoint { + let factor: CGFloat = segment / length + return CGPoint(x: point.x - dx * factor, + y: point.y - dy * factor) + } +} + +struct Polygon_Previews: PreviewProvider { + static var previews: some View { + Polygon(count: 6, relativeCornerRadius: 0.5) + } +} diff --git a/Sources/Web3ModalUI/Miscellaneous/Shape+extension.swift b/Sources/Web3ModalUI/Miscellaneous/Shape+extension.swift new file mode 100644 index 000000000..a28ab44be --- /dev/null +++ b/Sources/Web3ModalUI/Miscellaneous/Shape+extension.swift @@ -0,0 +1,17 @@ +import SwiftUI + +public extension Shape { + func fill(_ fillStyle: Fill, strokeBorder strokeStyle: Stroke, lineWidth: Double = 1) -> some View { + self + .stroke(strokeStyle, lineWidth: lineWidth) + .background(self.fill(fillStyle)) + } +} + +public extension InsettableShape { + func fill(_ fillStyle: Fill, strokeBorder strokeStyle: Stroke, lineWidth: Double = 1) -> some View { + self + .strokeBorder(strokeStyle, lineWidth: lineWidth) + .background(self.fill(fillStyle)) + } +} diff --git a/Sources/Web3ModalUI/Miscellaneous/Toast.swift b/Sources/Web3ModalUI/Miscellaneous/Toast.swift new file mode 100644 index 000000000..61237fda8 --- /dev/null +++ b/Sources/Web3ModalUI/Miscellaneous/Toast.swift @@ -0,0 +1,157 @@ +import SwiftUI + +public struct Toast: Equatable { + let style: ToastStyle + let message: String + var duration: Double = 1.5 + var width: Double = .infinity + + public init(style: ToastStyle, message: String, duration: Double = 1.5, width: Double = .infinity) { + self.style = style + self.message = message + self.duration = duration + self.width = width + } +} + +public enum ToastStyle { + case error + case success + case info + + var icon: Image { + switch self { + case .info: return Image.Original.toastInfo + case .success: return Image.Original.toastSuccess + case .error: return Image.Original.toastError + } + } +} + +struct ToastView: View { + var style: ToastStyle + var message: String + + var onCancelTapped: () -> Void + + public var body: some View { + HStack(alignment: .center, spacing: Spacing.xs) { + style.icon + + Text(message.prefix(100)) + .font(.paragraph600) + .foregroundColor(.Foreground100) + + } + .onTapGesture { + onCancelTapped() + } + .padding(.leading, Spacing.xs) + .padding(.trailing, Spacing.l) + .padding(.vertical, Spacing.xs) + .background(Color.Background125) + .cornerRadius(Radius.l) + .backport + .overlay { + RoundedRectangle(cornerRadius: Radius.l) + .stroke(.GrayGlass005, lineWidth: 1) + } + .shadow(color: .black.opacity(0.12), radius: 32, x: 0, y: 14) + .shadow(color: .black.opacity(0.12), radius: 11, x: 0, y: 8) + } +} + +public struct ToastModifier: ViewModifier { + @Binding var toast: Toast? + @State private var workItem: DispatchWorkItem? + + public func body(content: Content) -> some View { + content + .overlay( + ZStack { + mainToastView() + .padding(Spacing.s) + } + .animation(.spring(), value: toast) + ) + .backport.onChange(of: toast) { _ in + showToast() + } + } + + @ViewBuilder func mainToastView() -> some View { + if let toast = toast { + VStack { + ToastView( + style: toast.style, + message: toast.message + ) { + dismissToast() + } + + Spacer() + .allowsHitTesting(false) + } + } + } + + private func showToast() { + guard let toast = toast else { return } + + #if os(iOS) + UIImpactFeedbackGenerator(style: .light) + .impactOccurred() + #endif + + if toast.duration > 0 { + workItem?.cancel() + + let task = DispatchWorkItem { + dismissToast() + } + + workItem = task + DispatchQueue.main.asyncAfter(deadline: .now() + toast.duration, execute: task) + } + } + + private func dismissToast() { + withAnimation { + toast = nil + } + + workItem?.cancel() + workItem = nil + } +} + +public extension View { + func toastView(toast: Binding) -> some View { + modifier(ToastModifier(toast: toast)) + } +} + +#if DEBUG + +public struct ToastViewPreviewView: View { + public init() {} + + public var body: some View { + VStack { + ToastView(style: .info, message: "Hello World", onCancelTapped: {}) + ToastView(style: .error, message: "Hello World", onCancelTapped: {}) + ToastView(style: .success, message: "Address copied", onCancelTapped: {}) + } + .padding() + .background(Color.Overgray002) + } +} + +struct ToastView_Preview: PreviewProvider { + static var previews: some View { + ToastViewPreviewView() + .previewLayout(.sizeThatFits) + } +} + +#endif diff --git a/Sources/Web3ModalUI/Modifiers/Conditional.swift b/Sources/Web3ModalUI/Modifiers/Conditional.swift new file mode 100644 index 000000000..4a0767fa4 --- /dev/null +++ b/Sources/Web3ModalUI/Modifiers/Conditional.swift @@ -0,0 +1,21 @@ +import SwiftUI + +extension View { + /// Applies the given transform if the given condition evaluates to `true`. + /// - Parameters: + /// - condition: The condition to evaluate. + /// - transform: The transform to apply to the source `View`. + /// - Returns: Either the original `View` or the modified `View` if the condition is `true`. + @ViewBuilder public func `if`(_ condition: @autoclosure () -> Bool, transform: (Self) -> Content) -> some View { + if condition() { + transform(self) + } else { + self + } + } + + /// Transforms the source `View` with the given closure giving more flexibility with modifcations. + public func transform(@ViewBuilder _ transform: (Self) -> some View) -> some View { + transform(self) + } +} diff --git a/Sources/Web3ModalUI/Modifiers/Shimmer.swift b/Sources/Web3ModalUI/Modifiers/Shimmer.swift new file mode 100644 index 000000000..2744c9230 --- /dev/null +++ b/Sources/Web3ModalUI/Modifiers/Shimmer.swift @@ -0,0 +1,75 @@ +import SwiftUI + +public struct ShimmerBackground: ViewModifier { + private let animation: Animation + private let gradient: Gradient + private let min, max: CGFloat + @State private var isInitialState = true + @Environment(\.layoutDirection) private var layoutDirection + + /// Initializes his modifier with a custom animation, + /// - Parameters: + /// - animation: A custom animation. Defaults to ``Shimmer/defaultAnimation``. + /// - gradient: A custom gradient. Defaults to ``Shimmer/defaultGradient``. + /// - bandSize: The size of the animated mask's "band". Defaults to 0.3 unit points, which corresponds to + /// 30% of the extent of the gradient. + public init( + animation: Animation = Self.defaultAnimation, + gradient: Gradient = Self.defaultGradient, + bandSize: CGFloat = 0.3 + ) { + self.animation = animation + self.gradient = gradient + // Calculate unit point dimensions beyond the gradient's edges by the band size + self.min = 0 - bandSize + self.max = 1 + bandSize + } + + /// The default animation effect. + public static let defaultAnimation = Animation.linear(duration: 0.5).delay(0.25).repeatForever(autoreverses: false) + + // A default gradient for the animated mask. + public static let defaultGradient = Gradient(colors: [ + .black.opacity(0.3), // translucent + .black, // opaque + .black.opacity(0.3) // translucent + ]) + + /// The start unit point of our gradient, adjusting for layout direction. + var startPoint: UnitPoint { + return isInitialState ? UnitPoint(x: min, y: min) : UnitPoint(x: 1, y: 1) + } + + /// The end unit point of our gradient, adjusting for layout direction. + var endPoint: UnitPoint { + return isInitialState ? UnitPoint(x: 0, y: 0) : UnitPoint(x: max, y: max) + } + + public func body(content: Content) -> some View { + content + .mask(LinearGradient(gradient: gradient, startPoint: startPoint, endPoint: endPoint)) + .onAppear { + withAnimation(animation) { + isInitialState = false + } + } + } +} + +struct Shimmer_Preview: PreviewProvider { + static var previews: some View { + VStack { + RoundedRectangle(cornerRadius: Radius.xs) + .stroke(.Overgray010, lineWidth: 1) + .background(RoundedRectangle(cornerRadius: Radius.xs).fill(.red)) + .frame(width: 100, height: 100) + .modifier(ShimmerBackground()) + + RoundedRectangle(cornerRadius: Radius.xs) + .stroke(.Overgray010, lineWidth: 1) + .background(RoundedRectangle(cornerRadius: Radius.xs).fill(.Overgray005)) + .frame(width: 100, height: 100) + .modifier(ShimmerBackground()) + } + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background100.colorset/Contents.json new file mode 100644 index 000000000..ee2f44f71 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background125.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background125.colorset/Contents.json new file mode 100644 index 000000000..dc512cda5 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background125.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x1A", + "green" : "0x1A", + "red" : "0x19" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background150.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background150.colorset/Contents.json new file mode 100644 index 000000000..b18b8b1d6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background150.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xF8", + "green" : "0xF8", + "red" : "0xF3" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x1F", + "green" : "0x1F", + "red" : "0x1E" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background175.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background175.colorset/Contents.json new file mode 100644 index 000000000..3e3ea0199 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background175.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xF4", + "green" : "0xF4", + "red" : "0xEE" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x25", + "green" : "0x25", + "red" : "0x22" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background200.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background200.colorset/Contents.json new file mode 100644 index 000000000..eb34a3f77 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background200.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xF1", + "green" : "0xF1", + "red" : "0xEA" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x2A", + "green" : "0x2A", + "red" : "0x27" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background225.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background225.colorset/Contents.json new file mode 100644 index 000000000..53d70f3da --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background225.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xED", + "green" : "0xED", + "red" : "0xE5" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x30", + "green" : "0x30", + "red" : "0x2C" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background250.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background250.colorset/Contents.json new file mode 100644 index 000000000..ea77cf369 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background250.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x97", + "green" : "0x97", + "red" : "0x8B" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x35", + "green" : "0x35", + "red" : "0x31" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background275.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background275.colorset/Contents.json new file mode 100644 index 000000000..496ec20e0 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background275.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xE7", + "green" : "0xE7", + "red" : "0xDC" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x3B", + "green" : "0x3B", + "red" : "0x36" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background300.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background300.colorset/Contents.json new file mode 100644 index 000000000..0e42e8d86 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Background300.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xE3", + "green" : "0xE3", + "red" : "0xD8" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x40", + "green" : "0x40", + "red" : "0x3B" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/BlackAndWhite100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/BlackAndWhite100.colorset/Contents.json new file mode 100644 index 000000000..8f066e43b --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/BlackAndWhite100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue080.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue080.colorset/Contents.json new file mode 100644 index 000000000..a940fe05f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue080.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xCC", + "green" : "0x78", + "red" : "0x29" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xB4", + "red" : "0x6C" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue090.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue090.colorset/Contents.json new file mode 100644 index 000000000..8f757b494 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue090.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xD2", + "green" : "0x7D", + "red" : "0x2D" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xAA", + "red" : "0x59" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue100.colorset/Contents.json new file mode 100644 index 000000000..099cb90ae --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Blue100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Contents.json new file mode 100644 index 000000000..73c00596a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Error100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Error100.colorset/Contents.json new file mode 100644 index 000000000..6e9d7d95f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Error100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x42", + "green" : "0x51", + "red" : "0xF0" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x67", + "green" : "0x5A", + "red" : "0xF2" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground100.colorset/Contents.json new file mode 100644 index 000000000..3142df2de --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xE7", + "green" : "0xE7", + "red" : "0xE4" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground125.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground125.colorset/Contents.json new file mode 100644 index 000000000..217e7e00a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground125.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x31", + "green" : "0x31", + "red" : "0x2D" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xD5", + "green" : "0xD5", + "red" : "0xD0" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground150.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground150.colorset/Contents.json new file mode 100644 index 000000000..84b6d48f3 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground150.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x4D", + "green" : "0x4D", + "red" : "0x47" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xB1", + "green" : "0xB1", + "red" : "0xA8" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground175.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground175.colorset/Contents.json new file mode 100644 index 000000000..a36059812 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground175.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x6D", + "green" : "0x6D", + "red" : "0x63" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xB0", + "green" : "0xB0", + "red" : "0xA8" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground200.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground200.colorset/Contents.json new file mode 100644 index 000000000..530bc2ce5 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground200.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x86", + "green" : "0x86", + "red" : "0x79" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x9E", + "green" : "0x9E", + "red" : "0x94" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground225.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground225.colorset/Contents.json new file mode 100644 index 000000000..cf8316340 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground225.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x8F", + "green" : "0x8F", + "red" : "0x82" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x8F", + "green" : "0x8F", + "red" : "0x86" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground250.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground250.colorset/Contents.json new file mode 100644 index 000000000..a9fbbd132 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground250.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x80", + "green" : "0x80", + "red" : "0x78" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x80", + "green" : "0x80", + "red" : "0x78" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground275.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground275.colorset/Contents.json new file mode 100644 index 000000000..79bd67fbc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground275.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xA0", + "green" : "0xA0", + "red" : "0x95" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x81", + "green" : "0x81", + "red" : "0x78" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground300.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground300.colorset/Contents.json new file mode 100644 index 000000000..93ad845ea --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Foreground300.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xA9", + "green" : "0xA9", + "red" : "0x9E" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x77", + "green" : "0x77", + "red" : "0x6E" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass75.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass75.colorset/Contents.json new file mode 100644 index 000000000..f9ca6ba81 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass75.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.750", + "blue" : "0xF5", + "green" : "0xF5", + "red" : "0xF4" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.660", + "blue" : "0x2A", + "green" : "0x2A", + "red" : "0x27" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass88.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass88.colorset/Contents.json new file mode 100644 index 000000000..c11a888bf --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Glass88.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.880", + "blue" : "0xF5", + "green" : "0xF5", + "red" : "0xF4" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.880", + "blue" : "0x2A", + "green" : "0x2A", + "red" : "0x27" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass002.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass002.colorset/Contents.json new file mode 100644 index 000000000..70b997bd9 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass002.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.020", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.020", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass005.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass005.colorset/Contents.json new file mode 100644 index 000000000..607c3d29b --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass005.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.050", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.050", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass010.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass010.colorset/Contents.json new file mode 100644 index 000000000..9bab67034 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass010.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.100", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.100", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass020.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass020.colorset/Contents.json new file mode 100644 index 000000000..75ce91d20 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/GrayGlass020.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.200", + "blue" : "0x14", + "green" : "0x14", + "red" : "0x14" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.200", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey18.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey18.colorset/Contents.json new file mode 100644 index 000000000..e8641bc2f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey18.colorset/Contents.json @@ -0,0 +1,20 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x34", + "green" : "0x34", + "red" : "0x30" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey20.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey20.colorset/Contents.json new file mode 100644 index 000000000..29858861e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey20.colorset/Contents.json @@ -0,0 +1,20 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x3B", + "green" : "0x3B", + "red" : "0x36" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey22.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey22.colorset/Contents.json new file mode 100644 index 000000000..637117849 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Grey22.colorset/Contents.json @@ -0,0 +1,20 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x3F", + "green" : "0x3F", + "red" : "0x3A" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Indigo100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Indigo100.colorset/Contents.json new file mode 100644 index 000000000..c593b1ced --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Indigo100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xF5", + "green" : "0x5C", + "red" : "0x3D" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFB", + "green" : "0x6D", + "red" : "0x51" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse000.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse000.colorset/Contents.json new file mode 100644 index 000000000..be9d677bb --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse000.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse100.colorset/Contents.json new file mode 100644 index 000000000..2536dc2d1 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Inverse100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Magenta100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Magenta100.colorset/Contents.json new file mode 100644 index 000000000..24458dc9e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Magenta100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x80", + "green" : "0x53", + "red" : "0xC6" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x8C", + "green" : "0x4D", + "red" : "0xCB" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Orange100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Orange100.colorset/Contents.json new file mode 100644 index 000000000..e0d30b902 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Orange100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x2E", + "green" : "0x8C", + "red" : "0xEA" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x4C", + "green" : "0xA6", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue002.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue002.colorset/Contents.json new file mode 100644 index 000000000..494cdad82 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue002.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.020", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.020", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue005.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue005.colorset/Contents.json new file mode 100644 index 000000000..8d76ed1df --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue005.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.050", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.050", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue010.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue010.colorset/Contents.json new file mode 100644 index 000000000..42ec52425 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue010.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.100", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.100", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue015.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue015.colorset/Contents.json new file mode 100644 index 000000000..2fae9a85f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue015.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.150", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.150", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue020.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue020.colorset/Contents.json new file mode 100644 index 000000000..7bf35a89c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue020.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.200", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.200", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue080.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue080.colorset/Contents.json new file mode 100644 index 000000000..8a630dbe2 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue080.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.800", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.800", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue090.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue090.colorset/Contents.json new file mode 100644 index 000000000..22ff9d608 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overblue090.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.900", + "blue" : "0xFF", + "green" : "0x96", + "red" : "0x33" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.900", + "blue" : "0xFF", + "green" : "0xA1", + "red" : "0x47" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray001.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray001.colorset/Contents.json new file mode 100644 index 000000000..7a5a199e4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray001.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.010", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.010", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray002.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray002.colorset/Contents.json new file mode 100644 index 000000000..cd2c2840c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray002.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.020", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.020", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray005.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray005.colorset/Contents.json new file mode 100644 index 000000000..ed5457638 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray005.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.050", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.050", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray010.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray010.colorset/Contents.json new file mode 100644 index 000000000..250f2d900 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray010.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.100", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.100", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray015.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray015.colorset/Contents.json new file mode 100644 index 000000000..12aca6f7f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray015.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.150", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.150", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray020.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray020.colorset/Contents.json new file mode 100644 index 000000000..2fdf102cc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray020.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.200", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.200", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray025.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray025.colorset/Contents.json new file mode 100644 index 000000000..a2bdd9cbe --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray025.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.250", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.250", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray030.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray030.colorset/Contents.json new file mode 100644 index 000000000..5d5e58c4d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Overgray030.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.300", + "blue" : "0x00", + "green" : "0x00", + "red" : "0x00" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "0.300", + "blue" : "0xFF", + "green" : "0xFF", + "red" : "0xFF" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Purple100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Purple100.colorset/Contents.json new file mode 100644 index 000000000..3c591e5fe --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Purple100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xFF", + "green" : "0x4C", + "red" : "0x79" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xF7", + "green" : "0x6E", + "red" : "0x90" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Success100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Success100.colorset/Contents.json new file mode 100644 index 000000000..68259fb64 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Success100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x62", + "green" : "0xB5", + "red" : "0x26" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x62", + "green" : "0xD9", + "red" : "0x26" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Teal100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Teal100.colorset/Contents.json new file mode 100644 index 000000000..d694a4261 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Teal100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xB6", + "green" : "0xB6", + "red" : "0x2B" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0xE2", + "green" : "0xE2", + "red" : "0x36" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Yellow100.colorset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Yellow100.colorset/Contents.json new file mode 100644 index 000000000..7b82ea94e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Colors/Yellow100.colorset/Contents.json @@ -0,0 +1,38 @@ +{ + "colors" : [ + { + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x1C", + "green" : "0xCC", + "red" : "0xEE" + } + }, + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "color" : { + "color-space" : "srgb", + "components" : { + "alpha" : "1.000", + "blue" : "0x00", + "green" : "0xFF", + "red" : "0xFA" + } + }, + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Contents.json new file mode 100644 index 000000000..73c00596a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Bottom.imageset/Arrow Bottom.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Bottom.imageset/Arrow Bottom.pdf new file mode 100644 index 0000000000000000000000000000000000000000..0a66ca1687108157fd2195df13e85cac223fb523 GIT binary patch literal 1316 zcmZvc-*3|}5XayBSKP~_4QYT_Yd3|$^+%bkAp!xQl0bE?bktAFh|+7Vi{^s+#q@tV9PwW(gllPcyLl$Lo9HCUVBSX zR5}$9xHV`^ikk_NL@kkYOpX;JsFk!K5Hy|+5k}-e^Ps(Pq-Ju}+!!y6goz!L z9~Febl$+t&YeWlUJuL${W zhS4+2a+I6k)+>#ER8Ok7qH=gOCr&sNZY)Rg)BAThs&{6?Tjht@j)qj4{D3J(i$;>r z!`uI-9V+(7?q9K*eP*enbGweco!WTc^VZp^fgc5QgvjE9O$EMe2HIy`NH5iKY}GK!lWA#lbk+HYl~hc2ViCXV&pxH-dp7zAUCCz!b1JDx6Ie_p|2Z;GC9<|G}4ka z*<`4=L!q$*M6R`zPJ!Cp^ASx+WmL10D^!vUM&^WoEz{gtWt5=2ypW|Wi5V`9Mx%&n zM5i2NBIvp^6e-&YuAD<7peA3+DMTHG@Ya-?0y!0UE`? znQ5KWFyOgU#-mMYL_%s>Et47ujyqXWD=3ewwuw#Isl9K@2(9;&TWX&s$5Wg4P1f9_ z7F6mSO}A?H$nM{;hJ9smo~L0=lO2b6H}S@*Jnt$~+JoY4)3iemci(9*=qbMa{S}~C zRu5qUpTl}nU9~T87h8BV=BN_dpOU9l=-cP64n4%pTTSj3Z8L<1BF42#a9MT4fW~G- zv*nB^FKzL0v!+xbRd~hse@K9V17H9p3WVA0ZSa^>Vs3bk$}XIu^V4;hN+) t?c1kt2B(|#*-n&V)wTn~f=7Xi+s$jB?8kqzsvE{~Pt literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Contents.json new file mode 100644 index 000000000..2c3eac92c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Arrow Left.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Right.imageset/Arrow Right.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Right.imageset/Arrow Right.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ea748e6927a96763eb7477b55013386c3ae6b7d7 GIT binary patch literal 1309 zcmZXUO>fjN5Qgvm6?3W7BGvKu+fr4DZYe^5C|hn7hmdvKMco9F6qWvZ#@WQlQXf{{ zXFW6TeC^To<<%*2#~6Zu=EqM4aCQdg=PcHn^p(jaFFwWkzJCBkaGhRteH+UiD=y=o zZ57w=FJN`E{8n}BH$yIl17fxnZ5G1id8E_nR5JqIA2^kfP(+Oo$qz(y(B8d|=c$b8rwQ;Jy>nkiCW+iv|Q(MIj($cL*cdMrEV@(m$#!c|LY>5F?cR-81OepVb@o~E$ zsgN>Q!xU%LJdrKF(%%tTc(MncQi5F$I48a;`|`25KQw)A;~f*=*nYv&C(xA9XcHa} z3K(uc`#K&)I@6hvOGEV^@>HEe6ll5*5ei8YJHG1Ma{Cxtmb&-hlFD)1HM@8M$J@=x kz9_}IX?jQr4+So6wl9&?4}WB3+YjlW@QxiFz58XhIPJL`b<+9E`JVgAyBT7nOc`W*xuU;6t+h zWnTZ;nVhVa*XPI`V+aDOA3qtu#RXhmvRH1?E0c4ceTwCM`v8jII$1Ss9rHcQmhsQF zi0k)Pu(+AO6%G5%kc;jCF&xgv)A$>5FGDbvjDnELX(;xS=gh2+)f6Q&9IZ2oO6MXt zD=qAq<`#|ADNfJy!HR@%qm9xCBcZSdzk>X_SPDG1o{SXiD7_O7g$2u{l)>AMDYV8* zFx)H3lfrfmZcb#7KB&pBU`aCNQj(xWWe{ON2#!-El0vb1PsgotQV2+uX)Cn!fYc+Q z9fjBt^hN|D0VPNJHYvUK8qvK#-f2sUC)a`@RiY(Qhr1*ge3B)&R?^bBuSLUz4i$@# zQ19Azgl>riZVk0W4EhBGF3@XlCPGb>E?68olKkv{I^HvqHQdZ@uuHex-=E=*s>azJ zA5TKT9@yO*RF$jZ@@y|N01RKIXUA;XB;I^XVM&C>0CSW-Jqn`$4= p;B>n=J2WL*S5*s1aM$4MX8Rne`tF}BuiH)z3h&v;$-6Jt{{Z3Z8~^|S literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Contents.json new file mode 100644 index 000000000..56450d4c8 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Arrow Top.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Bars.imageset/Bars.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Bars.imageset/Bars.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a73617fb650bd61c9c0614879545e5af790b3f6c GIT binary patch literal 4152 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 Rr~wogco~pZ4GO2eot@@_n!MWI_3J- zYU#eMX)8U1me#%@6_N+>$+;c|GS0;<=T=HKto7>FxcP>BG$gl{*RZwT6K-|vYoP@0 z3tI_2Rq2Y=_gs+5(Y4@(gkF0CNl4=khzl`}bNoLioeREH0uZ*~nlG{w+xQX0hmd1j z+tyR?z1n>U#n`}F>AgzIMPISAZ8e7As}R?7&LE*?S3Kt;#>7}Un9se|LKI?-c(~Th zWh}@SL`exfH_q)+JP=3kiObX!H=Ob*p6{y)S$2&WC@yA|%qyLfT~e}K=3!g6bLO81 zNiE6+owF!NX^asudmsu@5D1LdgT+&!_92oQJC}26JnEVdyA)t=NmAfqs4d96)SHFc zdBUPR$O&xj=2l8XU5+-NtAzuVfkLwyjThvwC}_DPl~>fo!2;VTfr}=EpF*>QobOYT zsPd6Etn!>|rFC=5ESIL9JSBSePkC2S_(1+<6jV&XV}UeTq*S`m`9NxCJmsH?uvO|z zW$9@NNmbXKw3p~|s6u)TPUpZ=&vq^aqAYKG<7Y{wP`l3{qz`#Rn#+k8co{tGOriOv z@*?jlR5c>471ghai>q1~AsyVI!(x3+TlEWQl%PxjVS)>35WWuu|Aw4P)N~Exyk{vHq$83NQD{{RtrV}gEf3tSQW77$Q~Ti zCrc2f3X;|8GaV!N)Iq1HjY~#?r~^(xPkS0?+mCcuvUhSA4-~|x1KL-GWMyMiB$|<( zQX1f5DHRzNq$<4^M;$;|Vu>6QH7}Vnt;q=|&XZe4esVOEWH*1(U?^fIJMW^RG>7#vjWwg`jRfS_m;8cSnI zRJ`#?tvNx3#EbIF-byC2E_9&OA)CaN)KMr-X8R4sjw}p7F;)1RL@G{NFo0UE*dMm) zO2$Mxns_$0WeM=Q70nPiQG_BPDR@Cp@D283NJe%A6_lqSQtMHZ6MqXEj*p6rh>a>u zsWS90(ADt0faJP)FYBhZK$r_GOmNP(TAUkulhSgwPM|sxQv}HeaX=2Gl42n9Rciss zkF<*&oiXWj3>FjDJ#u}^aD_-*v9<^+OUyJ)Z_%zYQN*?po`Lpf!kD)9E7Mk_XNfff zoH|MAk?N2~2144^h*;|VmtFb}hgz{uN>E7KJNV`!<%u+_nE~gZ87ZFpQOq)t! z%p_IEyp@vS0?!qI!#Zu3%_(5J4=TV+c?#NnRiSz`8>pD@Gv(|9dlzyRIduY_viu3M z2y2Sy(dPRl6Am9*WR*Q9OyogcwQ5`?md2$}^H_5o6Hl$|E83J0YKT#x<__#1Ag-rI zogbF*mXKi`Sb_BqVW{JY+DJ6E%{tcPVrNvg>fm~6*kYW$pS0K$G z(=?YS3gLX;jwscIN~AV-49i(LXfGi?s;g;{pk_6s5e_R6$KK-&V|}d_zm#dYp)2Jv zOT01#e^m!r4EAS-aM}f-Ns=;h2+wFoc3H19GZ(x?XqUFu61OYx&_mqV?s+2_71Hb# zjP@?J-;Y8fs)&`shEUf5;S*3|UO?y4MF|f6^{N`PLWOEC1nlQnfs~3_?;R}htT!OD zP3@d@2E;Ii3XM71M<(0kQRHWrNdW^&UQ1~TmocXGUj;=yaPb&*;sok#l>Quu zIH7H7j9YkGPOx#ciSRP2cT)bV7Z*7iJ+oPFFr8Ne0%I7X38~&`l%bvJqNK3sYeGo| z>&BbiFPEkVR;eF;vpg+-UG(i>ei%4^MbHO>@pXY+-|Zh4Xz0sFhnwF%J)K@(*6;tu zM+p9IzWdKVkL%6*yN|~S{Q3Cd{_gA3&+GSQi>To8;8hg7!oWuMq#w_kZjUdgpPmoL zmz4;uw^QBQ)6?tmi5m&Y4!*y823uhygRZ`W2-?4p-2CzW1E#L>;C8>~?dd1Z`v0^4 z1>{N-!M)NX2VeFJFOI*xd%b%&ef;$3&(Fsn7U*x0^W$%2-+^9$=bvg>f9ul@G3Y*p zD6(HlF<(g2CkIm$!+r`SRlar hb(O;w^_y?+|9ixG`*d{o{A%vd@qKyo=68Sj=6|3~v*rK* literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Contents.json new file mode 100644 index 000000000..3f27bd6e6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Browser.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Checkmark.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Checkmark.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f616b5222d8c902f8f893d5197d8f20fdda22bdd GIT binary patch literal 1219 zcmZXUO-~y!5Qgvm6>~v?N_aivZwVolP^zk}N<(j`hi$SzD%fqap`!iueZ5IG0eo1E zAA80#8Wbkd6_EN=hdgCy${c73N52`wE z{w!wA^!*u4uJ&iMUj0_A%`nJpjpNbUTjLbjI%4gz!O7~717|K&a%7(fEP8fgDC-cg=nJwrIG2FLN%odzDrn=qg{wgp#;~V*<#meQ z!9+9|;>qj4HafIMvkUAQ#9C)eD8$+z39&q4If0~ zg9bqY>GES>d|5-JB3Eu6*XLbDf>ErBJM zbGd_ZV-d|M4S#i8Gj*qK-l$f6RYh?dIc>F9WVY6%Pi9o48!41py=~iW)zkHNC>Nvp z_V-sq)n$F#Y{2JczNpW-C%Q(HUkZ`k7VWHUq-oQ4kIPxpQ+XTHO}I(du9_AnmWQ#0 zm-P~ia03I{dp-q?&#L;km?Kpx6-;S+&ZK*UFTcva2ic1RZS6%W1@_~CyTT{+s=n`T zpSwOSn;T^)s&)D0O949f1iTqg$Y4=BB0RWYmoi$zp0n2p`4tPIyiXu<>EhU C;R($E literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Contents.json new file mode 100644 index 000000000..63f424bf4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Checkmark.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Chevron Bottom.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Chevron Bottom.pdf new file mode 100644 index 0000000000000000000000000000000000000000..7e86e6340c06afe95b2b3f140ab16d6ccb27141f GIT binary patch literal 1158 zcmZXUO>dh(5QgvjE9Md@spMssWxu2-Qe!t&)mC*$Z&42vZyYKcS|C;0U*8!Fi|yGJxxAxVd4W-q0;ek9qPb)Z6|E6vCXI>iRYmdzP%i zpQ;S``&(GvAK#T7`^^@Di(!GBHdu2+^P%I?YhfIy;mk-V_bfj5defCPGu#S`nZR%_ z($rhnGs}gyI?a%2DXmoyiRR8aBOD%$ahhk&370|1Ql7~yl^Lo;A(U%3=U<>GZ!_l+ z#&ifNS{_wcWL&0L)z2jmkq)7-hT%$@%o;#Qf>R5c8>f_%Cn)u)b(T;J6&#`SIC?57 zy+9>2Ja3J{mq(phsbNNvVjU`pk&`*F|csR;EBIg4y*%Nzw z!)o@Gk!eOpO!gtC9BiefkEY5ZMYAPu>$>SXc=(Ry!dxGntMFx6AM_&M;_+=y? zs|`v8>L7=y&a!#NSounShvX=eImtu~cCp~x__FAWU9&w6eQCoZ6JXh)eY%3tT4_K$ zE-7HxK^>7oowR0T1RCNDk$+B+LzA2%>musgqS}R)(cAm5!f{-7%|2YgWwp6F3?<2% frUzFs1%s literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Contents.json new file mode 100644 index 000000000..f664dce68 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Bottom.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Chevron Left.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Chevron Left.pdf new file mode 100644 index 0000000000000000000000000000000000000000..56c69d7b2140716347035354e03eb79c275e1a8c GIT binary patch literal 1157 zcmZXU+isgc5QgvfDdr|pQYo+p_9R7-8oQ~gwyH~d7xjYTjYDNa3#3Z(^qs-5ka{ny z<=dTq4*d9Rv%b9)iDgUxhvvsm25@x+*Vio6TY6-2$)TKqSh@~> zsxsv7Z(wz|d@4Kkn~8)E3;49TjJtRy6OT)IyyST1m4xyzN5*S$)0H(diRBihL5Re2 zDXfMAvkCWB%Z#8F!e{|ALUHRdXJ8KHN#?9Kn2*UM6PXklo(iu?ZokMuDU|cbWCbNbH;Vo6B6XTQ;IQ*GNFRimkVjNG9Ij`_KGHx8!KqEvA zMH<+X_7Y}fs4lBXWQ;Uay>!&2CPo?NsqGPtg$Owu<4|L@OLQ{ul0CAAH>_q~8F^+j z#N-|_%F$I?xag@YQuJE-wyvALgZuC3JzVLxzrO;cn_?G6@HuR&;--0qdm7V!RuYPg zW4s2DO^1_G9=hhKEkg(7?tGM6HFY0q%t+Rr;HGGifgaJ~10WPXjPzr*#ZrMf$YIK} zYMwAwoYdbTSt#LqUno(7T}(JPzAE}+-|Sw8KDXh4aj@*zKK+8xT4_K$F2P~gK^>98 zI%&!^42n YyXqxi^}|0#(e^_-UKw_F_U_B=KTX~Ka{vGU literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Contents.json new file mode 100644 index 000000000..80250da42 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Left.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Right.imageset/Chevron Right.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Right.imageset/Chevron Right.pdf new file mode 100644 index 0000000000000000000000000000000000000000..84cd3306145fb3590d2a40d4c88120fa6ba48254 GIT binary patch literal 1161 zcmZXUU2oGc6o&8pE6z=&4QY<;#9z`hiM0$NK$MKTiHneWT~L}plA*z`=bSWOU42m{ zkA2?r;Wu4vH+NT(TgD^^sDJ!q0N2-WbHhTlqgSSuJo*%>efI=0!jw+6T@$hci#Fj; zk%#pCEv)aCZ+XjpGfW`*1!8=-nxCdkDY*CENe43K(raNH^!nr zk1{xu%o+LwSks(<^c`vCs1-|-;3H1JTdGWR`8kCGcr_{)fPpDNJG^tM_p=SlwqD)iEt=Hs(xDt>|m&NiOvR|vnTfWhE?n< zBi{_B7#&1rIXX)#HTf!;DEcjWTUB+}!ozp;AFk-z-(LZuZMF{s_#Adcc3Z!|1C8mG zo6s-l0OK{tWZWE;($Ln=O&(exho^(wx~{rVVMem|2)9{-4Df1twD<@JO&>?}vDjg$ zKpmto=2_Rz7%R`}Z;>pN@J<&>)L=U$oEu+fT~^ln)6kbDJTd{69owg0Fj~hN5D$x7 zL<_13#aQPlG7`Ifh0aeofz~-ag&v+z*JMQ*8b-JGVT0qiXzN3`go|Q#c^pcV)^!Ke ca6jPazW5ig`u<-dYr4K2p9r>Ez58m|6N(TZO3JO`V4Q6ll-OXqsPO5TaqV@|?jaig zc6J{Boz2P3^7>qI&zJ-O&5xf9;Nk) z8O{w?G6YT8#}tU1h}u#P$F+3EJ3ts?L`SgP1+Aq#LMkdBJfVD4aD*YE@>H_bREgk{ zERW1$XCCix5?Jt{l~Hykxvgrx5XrSu0ZYq~BzMv)iMKxGlO(M-RK6ufg=M*S$j18p zppdh;IW~DfUS3nh9@zaGRyp<+^(@ypbl0r=iX?IHJBSx4YCb zy1frel;gB(_UQ~xx9hWKQHoX5^gs;{0vEU2e+jD}{%6XzAKHmgu#=N_U#|ZHB)AA^ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Contents.json new file mode 100644 index 000000000..e18a8d948 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Top.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Clock.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Clock.pdf new file mode 100644 index 0000000000000000000000000000000000000000..bc571c2fbff680f35f034beb979b52a460e96ccd GIT binary patch literal 1668 zcmZvdO>f&U42JLe6}%K^2UOO#Y@jHxrt2_l!@6|0Vh7JrlMIQy+3wKo*N<{+%5ADc zKtB{;Q53NZx{b zCyg>dgd{3Pj1Kz3WM!w5cy)waB9p5Q*s59*QB zc*&ZSmZ57N+bVPrXWMd=TQqeaYCJIxwh7*rEi$kpnvK7RXe?$Qw<}B);tiHCowH~j zF;*Vs-yxYPxo1l8f*l>0F1{%Ha@VY%hd#C8feG;JFh}DrIE&8@h{q)b3>MUcH0Bu> zAt|LlLgrwUP!a-4R}KAgenc6D|rO15m89^!?E0%v#I Xe*v=}{x8b5AFd;faqQ&e-ItsHi`8A? literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Contents.json new file mode 100644 index 000000000..79d458666 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Clock.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Code.imageset/Code.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Code.imageset/Code.pdf new file mode 100644 index 0000000000000000000000000000000000000000..7490dbe3a36898a4432947e2185f3bbeb20047cb GIT binary patch literal 1951 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Contents.json new file mode 100644 index 000000000..063515431 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Disconnect.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Disconnect.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Disconnect.pdf new file mode 100644 index 0000000000000000000000000000000000000000..2d745adc29983777d577625aad80bde1df8f19e3 GIT binary patch literal 2927 zcmb7GO^+Kl486~<&?P`}h%8dyKoFqWZHl5Tx^;RBdT_myjf-8owVfjEug@b#qw#JI zMSYUrh!pwwNa@+l_1l+Z^DvNc=J5L;gE6mOnb)s}aepg+2foBtKaTsm^GD+Wu4UKh zd>l6q!|Hncd$%3e-@P$c?=JssPs3jWS*Jha=Ecjt`udx*Ic8s?**+|meOq6gw)-L4 zP*W~!h_T{CWFCfKYxOm|4hC}%kZNLIXE2cQHd3L|p%e|dZw0%j8GU{jUa9@RSJFbvo{=|6e9m64rMUaq~2P%N+4B-U2{&tUyNcm zr!MpnoJ;02L&Bb~sP0UoekvKInAuhbk>tEy6g|dMMLApLlsVbe3#`N?X4p+S0MipC zIUs!z3yMD>wJ0IJCP@Jl5s2I_;%it1Tgkdm9SYvDG)vUk5ON8@bVQ|0P|+54vyg2> zA<1J`^TgAM)pW6UL}G9uLkmbu zLyVXe_v%ac6~yk)w`!^03);BG)F_e|s`W?|y3!b?NUKF#V;k&1kz`YCDR3aMgCfbf zq79346UU%PFto5k1&V~)=##F_S^7jtN)EFGQjS3&IkFW4pyvQv>}wSR6r4k6FNGBd zfO6FK-=Nt@L|{wzx?m}1pS@Rvf%JP?-NuiR#Y8BvDD&x#C3wnnkr|K(ODq*Dr40r za`6(0P!wipx7!W{vphN|Bio39Pcn`b5oQYd6T`aLW(Tf{hkQ^ha2jz3q2>V<#6cc9 zjqt%3i!;XB=N0}DW824Av|S$aI~H6E7l`_jdDk&Uk|dSFxSu>hi*h2PZJMW!Tn5%a z39Mxx_X(aPCAmj%`Ow%pery;&~Enw1x%Ej;06Pav-7xiFQ5!vpxBEkx&pNlsi5pnrEuRB zC~u?o@R?sp@*tXCPs}Ct#}h7<H(RX}sNS z-W)!g_wDL&?Z&~3(#TyxU8j}IH#2)$kEg?@<90k5dB&}qyQ{W^)8) z@SITS;-x20e*vz3*xe#jBN?pwIah~Iu%)l!KLNS$lpcAK1W*0ICGo4xd2@fbdu;mo zIDQzM$%EuK{Y;7?bHMF~BJ0ZRJA@KHhFEThr%=Uy2u`R?|`M9OM?IGl|ntOT##?fxARy*`aM$Frsb<;CIIvu}TX`vr3! BQz!rc literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Contents.json new file mode 100644 index 000000000..1d93e4d20 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Doc.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Doc.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Doc.pdf new file mode 100644 index 0000000000000000000000000000000000000000..c3102198b3d8f222627dc00d9ffa4cf653af76e4 GIT binary patch literal 3964 zcmZu!O^*~u488ZSs0$KAqNct-B!m=}5JgE8vgC$xn9Me?(d9dF%KwZh3jCZ~B|JC1fnaqMCZE&Ft$E#e$>!8t4#o!yTOXXcBe3M?{R#xsLJ4hwd^gD!auiq4ZYnl7-yitf1MIG5mzR|} znrgGpt>_lbnP#1L&2uOzm7KHLP0i+5a%0ojdhXtI>#{FCkvD`?QUjEIjJX@{Z4cE~ z2h(nAX)eJZs*{3`WZFC8gEtS0=8H4lSzoKmaOdGJrkY?2H2aVvjGb-H*8tznme^A* z^cGsF4$%YaB_#*fwK(iOjFGJ?31BF>!z0!a6brH}xpMRa0xQ*mFqcs-+LzV=4xcr;(%DYR1CnCRJs@SSVTGNCRjNy=(F3SuEG@!rC;~Mc z!Ui2I8wgpDR)CPYP*PswJ+VC$T=E6mPs|f#HhjU7Y4VVYdS{m4jF2S;CJ9mjCXu42 zdIOt4BpawC7D{53Gg0KB17OSy{aAAafp}r|D3lBpQDb^vQz(o3mqR5frmkuGBYnBkBbkcrO~xWfOH^e zEiZ#Z3l2!ei|PW9jv1qoeCx^vQ20l%&eM;0)1cun*Ip9}^uuvbwg9%IsBI0qGQ_he98A2@)v#-Oy$LOS0^hBCy z6*I_P5Y^VO<5m2%7&cmZz}^GAs$2Vh~?Nj-QQn%Pn`@&wW{8dqw|bR^V{)J;h=no^Xg zPZ$E6Xl(=GuG5bvlR>=Dx6{+?r(p2k;0iM^;NcwyRxJjU!@N`P)z+RPDh*_bp^>i+ zr2!j}HVe@-6jQTlHpUA630ZP(@E!{LVrCM`n|j432CJAoPxCx?$7DmDgJX!mK`P`6 zq($Tdq(JvnN+{i9Fg05d3p6A(r5OS&HLM3kQh6YQ1yzS4sv));t5j=y@-;A3qUxZ!hvw4D&hO)Sl+Ji}C*SjxdoEX^)8<1>eh1T8I0 zWpvP&QWQWS&UyG2sZ0QY12iZgQPTpE#8h?{kiV7zI^ccTxN|iiVNOi8_@5~@h8rI` zBlar|2b<2bO|Xhj9j07_KZmJ=sOqvRj>9T_h{TQ(!6L@uAb36b@LI8`kFA!{K;7nYX{=#)W6| z+rNL!X7hUceiq>8`Q~=};`qtDUCu&uH^OYiV?09n@@?^SJ)e#r?|1Xb(4FpD++7_H z=lOsg=|Z=FuebNW433`+t*(6p>2+}PM7)DVyu#@oXqzCV2Da_VbMB V`JTMJKXW<}x4G%jqwjus^&cq_8N2`h literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Contents.json new file mode 100644 index 000000000..90f2f94c6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Double Chevron Vertical.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf new file mode 100644 index 0000000000000000000000000000000000000000..7a29e36191d33ad84d0adbb62fc616ee274bb8ca GIT binary patch literal 1655 zcmZWqO;6lF486~<@C6Afk<9mGB!pC!QdMnLy7Y#6NV5ZMwVSk?P|^PS+LOs7z#LZ2 zi|w(WowrBVmsh8vaEuAy(Ea$y0M5?f{G5e$Lyt@@@$yq>?}rCa2(HPi9}c13v+^?h z**0PQ{sLAv%crJiznLg_JisU8G+X(dn%<3w70~SG$n2JlzG;~%JRW61h|%(}XS$Hq z2qPDuE{yPoN59HzQ%TT;N0mfEmg?^05)>Ix*28+mucE1!X$~b;XrkQmYE5v=h-U z&c{P;Y93U>9$3C5O~c~&au+7j>^S637f3A1O;aSk^A)ntLQ6rsS*n=$&G`vSQ^?sI zF-enJAaM_>Ij))aKu6-GocBOcN@XlEn&L*Pl*GF7qNQf3uDp-D5Zoxs@uIY}>BCSn zWf`F!6SEo1^yf@@O8LHK<~i53TkJtDf8K-K_RYY*1 zvxw*nqqvlB+qN5exc!b|gQxuV_g8@Oy1owy_#8Id`l5S++gUPF%eW44(hlhsdeV$3 z(>nCseT>p~V|X%O>!;J|G4rK?}trC@W$4al64%fjU^jbkC}L#8~mF z{vMG^pZ?^veRv-T& R>cbG*5n3sBboB1a)qg}uUz`8{ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/Contents.json new file mode 100644 index 000000000..be6a2f0ba --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "External Link.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/External Link.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/External Link.pdf new file mode 100644 index 0000000000000000000000000000000000000000..02ed310be6323d155fc4d569adaea9b5c72e496c GIT binary patch literal 1306 zcmZXUTW`}a6oB9TE6&TL4QY<=7ipTrT80oHO2^y8LrA@@s7oNp(Acl%xV7Ds`k`_@ zpZld}i}~#(r747wjb3Bc7ATwjyWuHq*VQ(k=v?RtC!iEtUEhOrOz6RGCm&!!2> z_ct)Rn|?I|`As-wy8|p=F3YXFiTuW?XF@6k&C@}%h?UFGwD@eLlh%W$%v+-kM3usf z@?LQelsm(`2993$Vj>G2P(vK`-ZQNxa$Dl5)?7+Ifj-N5nmkNMa?qe+vL>jL#ybwt zSYg5`<1GfB&1b1Y6q&@xlrq*b;F;MIOB0g(HKZ^@jS~v}ZDW0y<;-F;BxbAGj!AB` z!>;a{APioNlZv}35nebSWs+V)VjHob5@&~6hej0~5T}YOp%}g;O^lu?Yp}D#Q0=sJ z23&5*mXxL(vDCZ5N`D>IN=qxSD5c}2`j6z{4Qa_&66ZJ#X`bjfy!%Nv#*{f%h2s2I zZ`-yT2e|)^`+%qV_V-tSYEiF40-wWbQ{QwiaGy%VVxnozxjMaNOUp2H&wUdHh#R*| z=4M?xh88`>b<1#3_sBpeG+D}s%Cc4;H!BPkVg^gderDY>>hhEL2P6|q*y@R;nBY(x z9ul9`W4-Ox$Eq)VcpwZc*=HSp!DuZtAWny4RpNoRAc=7vBa4gsKe9M_$5LKn!Hy7T z0t=DQ*w>qF=t=C}hdGwxeCVFS1)OhI7yF`A%dQ(CCcGs982#>FtnSBMI-EI0 K&d%O_x%~%jKpa5; literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Contents.json new file mode 100644 index 000000000..db1c07077 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Eye Crossed.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Eye Crossed.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Eye Crossed.pdf new file mode 100644 index 0000000000000000000000000000000000000000..65019e45723866ff1d49e163c10552287f4b3a27 GIT binary patch literal 4218 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Contents.json new file mode 100644 index 000000000..fe1cdfcb8 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Filters.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Filters.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Filters.pdf new file mode 100644 index 0000000000000000000000000000000000000000..3414f65a18b0d805b6b34a9a0010701ced062b81 GIT binary patch literal 1648 zcmZXVO>f&U42JLe6}$v!2h^7Q83RRuHCcyY8eO| z0{Sueilk&_v02|;sUR0Zk)-y=PeF8jO*c0}H#_qvqB##g>1ID1C}y}dUj5MN@+88w z{&TGK_Wdob?&nWcFMbOZ$Z?T$#ucpB?^KXZ-qp!R!VN}WHNvaFI-S8ZjiP1B`zA@A ztCSSNy#cEdDs~Ba$J$V<b#K9HuFjSMhSH%A zqF`0xAfg~j(_*P8bsau=mIZR^RTShh&WfBe=M}p+5Kc`7`6LF&jZ#4@mr*v0WduLF zfk()L_28ET1Lu;1+1kr!Ca_1G4Jp=zjupbzE>J-!i* z_$thBuwT9#6J{bz<3mZAV|paOJXONCP16oNJ$&aW!z=vu_m`${Q|`3|pY`ro-nP&5 z;AaJr^k0&Q(+dlbKR>req52v7s+~RSsp{?$1M?JN+mm+jSYH4D literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Contents.json new file mode 100644 index 000000000..55c299bc7 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Image.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Image.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Image.pdf new file mode 100644 index 0000000000000000000000000000000000000000..bce9d8d96b04186d4f7bd8cf84c43854eb057225 GIT binary patch literal 4933 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 Q+)35@<<+Y{|Ksc50c_OPkN^Mx literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Contents.json new file mode 100644 index 000000000..e809e2760 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Info.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Info.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Info.pdf new file mode 100644 index 0000000000000000000000000000000000000000..cc0ee8472af8eabf84833079bebdadeb50f7b32b GIT binary patch literal 2032 zcmbW2U2oGc6o&8pE6z=&4XH_-#Bn1{lUU0T0z~P!o45$Bw-vPsBpDj~dhC3>CtG*H z@I`g{_>894}JJ zf;81yDw=1bo`xxq5js%bV5+y6=ndW&A*vA!lQG180^=a>GvE;MsK==Q8CS)aG9XtA zZ;TMtn-1qaM}B*8CvHS3KEJ#j@#yVe+L61pkmRn^q#dr1EY}mL0@fRjg%Qd%f??8k zQuUqeyrJL>-hjqVW*N-^^+d1hq#{O>s0`)frg?8DjH3dX|32gwTzOm;*toAG3Kp5l zbN5+}&64RTC4o%RDAL3TK8#?j$_(S&bx+(8g_~rKxOX0e>wFCHQx4Yt^dZ25* zNjQD(JWHdejcuy?+SrEtJF*$vEvvG%rHkkvkrA$o+A&fCnmjcg;Ry=g@3t;g@)c}o zjI*rnovl2|zj0*ZDSPC}7uX;m7rrdoVqe`pHhrk=jfhB#eunyA%9KhJIXo;GQ72Ie zl(;|9-CEQe1OTOUl bfWxcZAM3L3-sYliyK>}0Mq)O5^Xc+0n53a) literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Contents.json new file mode 100644 index 000000000..984e68d52 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Light Bulb.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Light Bulb.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Light Bulb.pdf new file mode 100644 index 0000000000000000000000000000000000000000..9b9f790ecb30e75d788cf4cce2941b18bf36cdd7 GIT binary patch literal 3699 zcmZXX-HsGD5QXpiDSU$jk?65q{*@3?SV9yfQOJ@zl#9u10~_tmBs)Vy^7J{U-0f~) zgwX6aWxHH;s%$@c{qogQH|Ak*#+uU~e-6exduEu?_a9^7d4W9;(fY5&%L^UH5`47C=Q&Eb9>+0FWw z^WiweWsGxUwAK|d_k)ZQ#D!#5*ynb3bTL~grlYcqJPe)XF{R=p!Ac|tXH6QbOF3~| zDN$Snk?eg4hT}>tRfH^-?4r4Y7q-?=Gnk82YA`bTR0TiAu~wVJf=Er(l9U+4JIp0x zbT*U>mc`dxV3jZ>_7le#qt%&mE>bOsgd74wg>gk zG0qoyMS>FEcn*>sT~V91KV_JWOf(8gDyoe{BSnHOsOL*O!BEMWOruT(X#zRZoS9B~ zPMK*;s~-k($@GSywt|N`FhBffxKYC~W+l-l55hXKY%R13XjEh_RAgF7wvE){Vu5!+?2LUtBr8N+&Y@qYTiIsW6*ljXk2(glIBn4L4q%VOXvF$H%LtjI$oOb9vMFeL zXt<1zMy!C~r0~MbvSVvp!36zTS&Kf1tLS^QY8hgCfew@`c~s`BGN;*AVznq|MUVtk z5NBF+Lk77sx3jvG0D{a4+>lwPhoQ5s=)0A9h|06Y%vP-7nxr6TGhyY`5K+(2L}U07 z^#VoM(5#$Ro!P4HF84 zpZG}$PFAc3CdnhGGi#@BaWTyV2W(evv(aN1Wm8;1qwNeNNruw;Od#k9sQa04JqXM@ z{A3ErrSds6T1-{-tfEj3A(dM;7)L%inA8&8qs^Jc<&9ctb=_AIvulzrQ zY-WP|H#2dA=f2>&@vHr1e|LKS`Or@f)4Rc%Jhbiee*>jSG{Ex*1)$%|u_Gk$bA(qA z3YDL3C5|=tIpWjc3l!Ws@ba*~y_+5eJPUU}yhJ!2pHKJG6Z81?=1B|6?)r4P7;abt cynA!|-vsaVdANVL=yvc>$-|>Z-~ICHe|DhdzW@LL literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Contents.json new file mode 100644 index 000000000..b9a9ca04a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Link.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Link.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Link.pdf new file mode 100644 index 0000000000000000000000000000000000000000..18b234242e52006e3753faca25408555115522d0 GIT binary patch literal 2182 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Contents.json new file mode 100644 index 000000000..9cba2f2bf --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Mobile.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Mobile.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Mobile.pdf new file mode 100644 index 0000000000000000000000000000000000000000..0dba3d413de48189168b741181dfbaba1ba6dd41 GIT binary patch literal 1795 zcmb7_UvJYe6vf}~r?@YZHl!wT{!f}Fv6dkOh?4O(@eoqC3rZ76GBoz-vD5h2YmpFn zsGOhebMHNNZqL@M+lBBlBEbQ7-@X&`)fHb~lWaHol|q;MA7r~5A2?F5(5r^Am*t-P zmHbs#vUq#L%RBe28t5kpFPI(<%wT~L=0YVp==1Hf^4NeZDpFaRb;!4IDGEaj>j_e^NZ*MQ?;3Sx_M#)s-hsjkMH*k` z9C}$EC4q7oJFFs*V}o7SP-avt%uydgScFt6W#Q}tqG?-ahNKVxnZN@O#{#fMl{(i2 z<_wOfkVEBIgk-gy+gH;!p!?O_j7;a!P3q9mgh*mEv=~@5I{$UscH_YJUsdB%kN@TO z56S+z+{qbyl$*M|>7MxB-e`MO@KxA@H%f&Zy2rkf1MAjW%yP@F9c8N`>b`2=y6hF> zWJXT+)d*eLe_wA@s;nz0*u+_Ok7}i7?w1qFrv242C%dJnn+)}_9 z9WH_XIX=K@hM8P<5h8dtR)g*H;#Q-H?k*vdhb@sj`N}0 q%L_iQHx~y}{G#hd)&)-n`*-!TRM}5|S7kp=<>=l{XJ>Cd-Tnbz4RY-O literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Contents.json new file mode 100644 index 000000000..1513a9cc4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Moon.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Moon.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Moon.pdf new file mode 100644 index 0000000000000000000000000000000000000000..e67c5f6f703cc8c8f98c9ae51a79e5b53f2da9bb GIT binary patch literal 1736 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 bcmLTVz5TC{+oxw!r|`5qy?OJSKYjgQbb1Ly literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Contents.json new file mode 100644 index 000000000..960b99cef --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Nut.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Nut.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Nut.pdf new file mode 100644 index 0000000000000000000000000000000000000000..c2f9ad5e2751ac63c06c75ac88387c3d7bdfb528 GIT binary patch literal 3745 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Contents.json new file mode 100644 index 000000000..74c89669b --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Plus.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Plus.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Plus.pdf new file mode 100644 index 0000000000000000000000000000000000000000..39150b63bb708c2b9ec30831568495f9d4f45d41 GIT binary patch literal 1414 zcmZvcO>f&U42JLg6}$v!2Q-%AuLLLxtjRhI+px^tt?0pZ)YOAxZMHjf{q>_9iISJ< zV9<|9@f9U%w%y!Z$axMRQJ{YK35b`Mcy$G;-I-rlggpA9+Wqi^F~P!k^+Tu114JA3 zr><1-@fz2+;a}CmZ;*2_4iwI~VC!^_r>cXGWH&bYs)gLGClhBK2&U;`u}sm!rJI$p zn+%avR{=vd8laGIUg8wmBn(|PiB>?u0u16D-Y=UcNuEm*%BnKw=d&^j4XWH5?5#yO(u(B^5L7K-W8o9JOV-_= zfXl}u(8a9rT3wL^)r@tAhcRZz_#A~lM|X+>D|mv(chJIjFg;@%!gY^nlw()rdBQzK z>V2<8@7q=nJ>K0@@6m{U{Qadc+Ln7|!B@4b%WM6DcfNzTAYO^L+)9P&^>bIL9!+-_ zcDc1~2h~zW)7lPh%Z?bP76lK0LHsa8pX(h-MYDqfU7odmrdWBRzb6u`lucGL8|*ou z-}t&5%0};}p)Z|!1gbwAFN^tNmZouvgzb<5M+;jV}YaF`c;wo@x?5=Vcd?Cs|Czv IAHLoE1JWKVqyPW_ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Contents.json new file mode 100644 index 000000000..1ccdc2fec --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Question Mark Circle.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Question Mark Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Question Mark Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..17cbea66fc0f20d76c52572fce4ce50efd4c6a8a GIT binary patch literal 2717 zcmbVOU5^_z6n*!v@XJaq(mL1n^_NstqPr9!KrAV56%Qdh-3DzENK#b#>p9n%u_s+5 zKIUn1=6;@geB-OT+t=6DB&Dn-z5nG`rS*#!`sGVC?C#~Ka&vs~-LQK&z1JS#Qml@r z!?4<_#qIFNW<4ywex+~T%zv$q>UU)g)ko9xa^2pZe#?e95VKxyyJs_NFUR#xMN^86 zE+B9UiIdk`m5gtWWX@ zsxv3Dk#uaVp?Oaw^9*u`=bR0Q*X^81#4!ihF()*wuf5oXAia;n=um9}QQ*))jN#n< zb&EEKTGk7YLkt-yN-5bD4Og_!Ntgo^BN7PYgU^+KQc}nuz!?guRH9&pAQf`fmaMY@ zM}#4ZPJKyPTmhCG9cTh*DF+63851uVa{`EAMsQcA>45kgIfM8H5#}@wv0>H}=L!+B zTE{+m?M$XbIf2VU*+Wm@L;R>x4qY)i0OqnoR{@I3DP|z3us}w^IOL(M5j#0Z8-8pu z!o$j%0I5L(JQYf&fHIrsh}6kvzfo*x#}(*^U>Q0 z)}S*vHR%lV&f{!=ir`bICyIm3pdy+WZ7x_MCS<}}B`0A-=W{0$subE39Lq@zs8u3; zeuCHPy?Up1>c{`QI4q=5S-a)2f~yrF%zu$!V`MOb2pRk}TAZIBFxp_AbCbpvsdv$YB8ZqYiFq3tp292~3b z(OM5ZYlHqj$!&4}GskVySjH~FG9z$|J>;1v=?=D#R?cXN7+`}WhVv{GH%vkV>jj{-#+W8H=qxP{Y{BwqphRs?x#+ zt0Um=0TKpNCrr2v^v<|hT;Gk6^$z(rQhZ?PZiqLUO+7MY) zV{Hw48mS?(ggC`t)MG3+iSe2+-6`byaK39eO0iuvuowCjWbx&0w?7^A+n;eI!L#`3 z&)){UxLZ98Bk=ujzgfN7f7EZgUYbZ|b8G6GA}xpG{=;EC9JO3}mSeb^{q8jEkWp?t z6L_~e0Moc(RA_cD5~$sm7T<2}QL2^>mU_x_v;P2J`=tIOkXfX75lI?6wuHU$o7HLc zxPQ2G{dgGODbh)u#Zq+;u}gvmJU-aY^-b>@gcW`XIU7-hJk83<68{YH5!_r_;XkrL zr^9OVI2;r%kc)3_LC3S>emgwZ&o=kZ&!jAt`~68v!Ts&%RcPZYT!; literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Contents.json new file mode 100644 index 000000000..8a4468bfe --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Refresh.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Refresh.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Refresh.pdf new file mode 100644 index 0000000000000000000000000000000000000000..41267e8e9999f667b0eaf34d5059bf0ceb2c204b GIT binary patch literal 1798 zcmZuy!EPHz488AH%*8-bAfq9NLk@u;Kw~#W(H3=;+=3oddE=PRskp(6fC< zvfXk$^c*{-CXy`T?2_&Qa@STUKz3K6Klm9Af_fHX^GJ0E?6bX ztyWP@cK{3b-msH$uZS+-tKNGAb1tG(TGDK+pbUsaD?9jVZY<>hD%WZ-F5@f(2O&?Y zQY>syv8teDDqNBI5H7$D@gy+KN&|5=w_*?nK~<$=$=%6xB2_Js0#YRvZNP}geL6_R ztwo?0bsU6D#KcuVp$*v^A^|G&Ap4f77cJ91xWK}Itaj-=WcSjl5}*!OabpNAnGK2x zY=Bg&EqONT)-@uVcHEKY*4!u%X0sk@Jr}}V)l{<}_a0Y;tl3-Q%+)KzV!K!C6-eVI zEe@RcxFXQplPp&jWZjuMQ+|v_0b-x4N9U^2ptANXg1gG(|t#`qIx-!;*R!+ zeJBA%U3iuPAE$m{oQV`1Rc3^fCMl(n78r?MY`C-nEpV`K2?gj`oKb=qHdt=~HSdna zueAGe_&9v{W>^ou4l%Nh^XOrC#hf|}HKJyxnI1^fuY}z%(Csn@`*2xJxlz=SRBB&3Zqsabk?t z2k?5a1(wjZ6LdC!13C@n*^jFmNKKK!JUyIqx%q@x`k($CkTWLCi8H21aCbWJG4adA zesQNza!L7|5%Ideo6-w Mp~J<+cfY*(58eBEga7~l literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Contents.json new file mode 100644 index 000000000..89fec906d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Sliders Horizontal.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Sliders Horizontal.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Sliders Horizontal.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5faea4fa1764688c1110fa60b3485c4791c1c5e0 GIT binary patch literal 2386 zcmZuzO^@3)5WVwP%w>V3Kxlr5q67p1n%$--+M-*hw;%^ct884@R%J zad%XkyYZj>Fm8W*O}B5?zlK@;t*ka_ky$n`WVd?Oz{oXZbrX!Sj)r4BDQ2>nhm-1b z+w-Dc8+^rb^-6m`hn;UE_x$e?;{ zZR2bMr^TvI1(*~jdlID65^sfZRvj0SJo%dWxAhI`lWMi~v55wD#oG~B@G%&$XEYvq z8#o^iN;|UP>?;2XaRFV6%-zZkPP*1L{n{OlxYh;7c}fx1Y0K2Ez=Hx9gL54hk}M-x zzu0xUHx7=TK*efM)h_CYd+9AL-k9JLw?-8RMcZBk`mb)(Qea4!EP7a;lm`C9O0%W~q1} zkV=o>g&XlE2xrk|p$OIjflLC@DW0M>5Q%4&g{|7I0#=bU)v`7}@?nvfl}HNv%tp0i z^<9Ys@A7<0HL5_|)+If`4rrHBgwZieq!enYyr%I|7CtI8s6tz}vJ-BLGe|$(0Nz#- za-|Z%L?!KF7pf+tOi{#&jXFw%HIa$%EwU7ZlelgTmdVHO)JgrWc>I;wwhTg^d3iwE z*aVr6jlh_jo9|Dj=`z#1_n4ztn?L^jYoyKn?r|)@uj9jh_j>w5?`nNgmW7P6Nb7F# zv>oT^^LZF&;z_+N?rx{kWjrAwkLd-x-<^RG7);P=m@_0pe)IGG0jUyKu%#u=?erOE z?Kk<)KvtgGC!V;#SpwF=Z+Dm7VS0Re^vikts4yK>u9ZKj4Z#NjT$VMIc61WRBTrre z*$zjpq0n7H&Ug^^!LiPyc>)=SwQb;ccmIZhrXf&3}uF@2UU* literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Contents.json new file mode 100644 index 000000000..663d9475c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Sliders Vertical.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Sliders Vertical.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Sliders Vertical.pdf new file mode 100644 index 0000000000000000000000000000000000000000..4f7d74044a6f94a78f4657ab77551d41460710c2 GIT binary patch literal 2405 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 U^Y-aQ%-O@9mp5;I_m^+~3wk-lwg3PC literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Contents.json new file mode 100644 index 000000000..3b849e2db --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Sun.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Sun.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Sun.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ef173df8f65cefe6f271fc6e8127ae03b5f6241f GIT binary patch literal 3635 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Contents.json new file mode 100644 index 000000000..097be5b11 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Swap Vertical.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Swap Vertical.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Swap Vertical.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1954cb228ccb1933fcc25b012802dbf6a2003f69 GIT binary patch literal 1909 zcmZvdO^@6*42JLe6}&8v6o@S9TR;$?*=>rVExMib7UVGTI-4nG?RGpV(){|q^vEBZ ztq%jwBT^z?QuNjB&6^jjlTu8Eh7W%#qL(k})hpHYck)-+EpLA5`up=Ia)3Lr8qcS0 z|Dc+i?w>>3?S6bs*KfD~+EM+jSexk~Grzo8-ZpDtHp<3lZ>W7(Jr}d(Wo&z8bx9#x zL(ICAlB1;u<+O{@`9N&7E5_wSPF4fMZb4qwjPo1URwZqcEs?2c$FaCbM=+1wa-gh> zjh>k{#1?09(&CqNF*aGIRz)4N^)6vCu;r2{YU2x5R}yp#Ir$8-_<8XwHsidUa_|;0 zR8|O4b7GvhVNR#$b2M1AE?9O*w_3T&US%aM!)#{aZF+( zIo9}(C>f*+*{xX`cskD;C5)B~i`XoAOG}g#9V787>lRh*7tdOu0Hyz@3y$iO5(|Xq zQB0FiCWqcAI-{&1uZ+!XmUXltK=>`Ho~@c;fNp^~d+80d-IR!jP(G&^E1dEb^-w`B zJhh#OB6cg9v=ghzH6asr7Y!^R#9$PEMNS&AB*bSgvS);X_7}6-8}3wK^gZn@U>vnZOw`EiCJVt7iPV6XY_bM6s#owJP9> zB;$Dv>?9x_!BLpCdnX^pR{n5QSJ}Q7ve^;s7sLhxr&%H`pSkye$g;r>iMWn zm3g$*R8YB78#dKFVG-@0CXs5{pSDno#`^f3>ecT`CS)Cd^Q@Gyc$uMWV_rrmR9i=D z^L^hB=aJsM$Ed~A{PFK!9W}T6`>ujtySu~w_3(w>iT?9YtS=1FE@*w5ciMI1@cGns zBgrt|)$Oi_{@nFAQ6~8eZ}%rKLe(dt6TjY{_s8M>vFn#p_fZ*2>XNJcQVhWb0BbK}VEs{GT z&*I1dE%XhF7z8sqpZ14icT)H;Hb31!j%VZW&^@PThr8z&QJUQ_oJkU%1a96QzIKRy U`atea=P4bIIjO6wAAWoDA6+7mA^-pY literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Contents.json new file mode 100644 index 000000000..caacfa5aa --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Users.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Users.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Users.pdf new file mode 100644 index 0000000000000000000000000000000000000000..68ae78670493f97a8cc7290226fba147f346b309 GIT binary patch literal 6618 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 urq4fp{9>I));9HVNg>E zAv)yQQehNg;dA>M%#kKcvE1T8CF6{6|`!mumc+GoG-B~ zrf#kYL31_Oy(`i-JNx49O#MNhxV`L4m~$Z+-tEo%^eG`j5md-jrx;?w%ceS8QL=I= z-DzvAgHS+^wd)|MbTe^(T}n_Cn#Y<#ghY*%Ip3slOoL}RS|Tg;gautJf)=c5o&q+B z4K6L}2|-nMKI#Hd6>hwoU_%0NK3dR#vmHGGtWi6H(>ZGE&et*Dy!Y3%^(o6O9R%a{-u!Sp4(E|R{E6EfWAn#< z|MaxE-re>Myz6iFyEnsE`mmf(*{jPfv&?2s+kPCroVtD_elNDo-Q{pR_eVtJ$6|)p zyAv42hE`7sBYA2zzwB?2Dscr{n&Vs!UtnvWhi;EwBd;1;eJf8;u literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Contents.json new file mode 100644 index 000000000..aab64b29d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Warning Circle.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Warning Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Warning Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..b051edeb354ea6d51af025dd3c85fb6caaef1317 GIT binary patch literal 2283 zcmcJRPjA#P5XJBQ6mzN6A~mt|cOzAm=q^PF5M|4);t;ZKchM$+Bt?Z!kDbJCyj>*3 zfgCFD&-R;{XD8E>o7MHX3UVP7Nov1*6+{;oba^Rsv#~!#IZXSj$#RjhJs($En zS&ML`f9xu~etkvDTmM(pi|;}Oa(qa-!8u09bC{}X-ic)x^i?Brr>7z}sznk+@gmJL zVu;xy$TO8h34uVO5@1lk08>~FQi)?xjtm7xkf;PhXkfr|*uba~TLGUiUo%rOSY&BY z#1scAPNd99CC(#kU}SQ^4yNAd53`Ulo1x9&u;VyUkV;@Z7zW2vUc{|;_%cYR`&Ap5 zrcty=$&@q0g)7@2X(tl`D%_$fxN41`_kNWT!*sF zXzE-lOCmI`1lTmR@MY7qLr-^~O@lK}`03|2P2o-Xpl9%2Z+7KX`$Tu#rtm4^?;DSt z(pvZJV^`^(Yztk_a?7?EbYmjg{^{UN*%?OZjJz&u5xQ^qcDFI9lC5A(F3z%jG<(%i z{=FfdQg)zZ3+xe)3tyH)xo;m1w?1|HUP#Kt^cAvyDNEBhC4=WjNg7Ag0L3Ox`v9pt zHdQ}EsVVUg7181uilpR?Ls#zhx)b*F-mHurr+r)NGdkUE&L&gBb=wYP3my#)Z+E}6 W$$tE|r0j;VoJeL$oSeM+aQz#Q70>ek literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Contents.json new file mode 100644 index 000000000..3cdb76cc7 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Web.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Web.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Web.pdf new file mode 100644 index 0000000000000000000000000000000000000000..64fb66da3475ea1b180d2cb05750ac144732277d GIT binary patch literal 2697 zcmZve-H%%}5XIl`U*VTZEfO~#+v5+ZszkRGAwZNZZxs(Ad)qF`Ca_6S;jia6PI8m( zl84AS@yE=WGsk}N=GE)3Wh}!W&b#gJe+ z^I*5y3~5X`dht&Dm`lo~xw|2bIfR%y7-DEzTo_wSB^B33jWuZkQ7FaVqF@2h^e+Swl+*d3ZA{B=9IHbtSl)R zQnaO{hE(u)al?jZQ0jOQEL$)oXS^VyVj^@4+Ks*BxI19wZL8+WAu>{8U4iEte9jReNSCdXtf-V5pi>hheJSCLxXB~ z_2*gSC5p9Yh|2zU_JyE9H{f+h~Bpn31@~bl01XGEK1;q z0;#X_66lx%KGT0Fm7?+5*Ob~SvcIE#DTYu87Q%`M%;hl@O}UvIauP(7N6CqVL8vea zBo8p}qc2oSvxaKxyhdLY#MhP)E=b6}$XTSTp^Q>uBkNhrYr`aK?2Vyl!B)0hlb9s6 zd7rHc1&I=#<&K2O*n%iR-8z_R(7rOOR+^G|nSSd_A0=*lG$P3fmClje8HOfVO~cSG z@KTASL>jb>^o9~Rf5k%K`Uxdzw0>-33ka_p09`1G_z|3k3G2QVXh>qhNm>#rJ)dby zAI7mJI^!us*wjwx?h!NM!xh!bfvQw`87@LK^nL28VI9%UJp`7F}Rh81u3+&1| zuu6lpZX`5vVwNPIvSkQO=1GrpwmO;f1i~N+4XDIqi$PJP;=yVSCOX=@R!{VFPS&Ko z@lkeB5RwnHS|n(o3*CO^qG0{3BkUwqZwO+1wrq|yhODH z^n0a0jCooK3k1P}A|6M;To7cv;;!(q3f3J*rF57G0Ui|H?+hfv^oKbc6Q(?xz$#=+ z_zV+utWmffIuoAGGPPN-R*#Uyt`v}x19Lct6A8IHSYe?VJEh9rnp+Z4+u^iafh1EV z)_IXN{)L1g8g*Pyfz%u3ia8q>3AgC#=c=KVAcN9lz|2ytm_COM0_zn4#8J#hjE>xB zIeOm6vw|b603DALH#**bHEf1o275Iep9H7(gFO`v?~1_9IX^47=g-fL#W$PHcE5A) ze&hMUXYuPle@<@kX8B<{0zXYRx67B?&+gsP=4ZcWAjsr+^Ub5vPS?|J`{{l)?VLSu zu8-SYZ8!UA!-@8~Ie~AM_h61&twR@YAcN+&(c*{O8$xxK!L>V`bG7}%T6q-z4&-7d zuD*+%EWzD;;5qTD<$k%|e)w|f=lkjX;9VIGx!SkGUnw;3@x$%eM{YAiSmKvZ;4Xdy zp`iz}BG=~w2rq-roK@ X5q*C&F7Nj}9Ue3~JbCi%&#(Ujch@Ll literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/Contents.json new file mode 100644 index 000000000..26183ce92 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "X Mark.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/X Mark.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/X Mark.pdf new file mode 100644 index 0000000000000000000000000000000000000000..970d6fb8cc7d7339c832b7a807efad7a00964f01 GIT binary patch literal 1421 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Contents.json new file mode 100644 index 000000000..e5fa454bc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Android.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/App.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/App.pdf new file mode 100644 index 0000000000000000000000000000000000000000..aa5158ec8ee1da4682ee63f66414cf1b0c4a82c6 GIT binary patch literal 3354 zcmZu!%WfM-5WMeK%te45z{7bz0K-5m#X*n+QRv(ZA82YVGZ4vyqyxuapX%A(o|Tn7 z2+P{(>8|R>jIM5P-n_6n4}(=k9Y6dzDE0ECdi81;4|nu)a7%pk%XqlId{Q3ZnpT}J zr*X3%RyX56yY0CC@wK{syZp614}T9yYH4yzn-^;A?cbzC{fuk z@4O$fHaa)vzWmZL}6jG6O)~TvpOsNKCy{@q)XViA6x}+F-bCjJtJa4JOSbx&VQihYzQow9t+mzlH&`#fHXC5PPqXITy?9(k!GR$hiIxd? z@;pfbR!kJ8tWs7iM-|8bBH2JhOpQ^Kz&Wdjc|Vf@n&h&xvoTym?S1qXaY`sb=it3b zv>(7pxBxXmOl@7$%`2}-=mG(~W(mB8$PrL8ZK^>Rq``&&QxVPRQi{n-?Tz-uB-2bK zNk&^F6)Yr`D8FK>4L##PkkUd47rnSj!Ee$FU+2Ol37cN%gt_##T#vbQ>;YI)%PmYr zt?q!;%49jm!D0o%rf69!^2v-?DndH(St-$nU!Yz8)RvR{qBUBx_l4FPW20Hp=vo{gxprNXUeWw&0+ZMR9LMa4_B(ip;MZdlTni7)%C>m#)# zN}(*dZ$<05QmI8HB>;I6NZtTR-M40#x_2Hdtd`6q@ME=PCbe#RGUK+xry=N)YY6CI zOGD7bs`daeHPG@oqd5sGDb$*f-V$w%hM=5n!g}IiEruaHTOCriF)62` zcO_sNl0N9}0LZ!GQ|mYzioqt^fi#Q8P%~BMQi@n+vhf&oRbx^FtOw#_4i<=Y2IINe zp&(*t1ImPi8HrU>jiBE`jMGjt!k@?=ze25ui9lfip`9RUjUF%Jk98u7z^15JCi2IT zvq}qsA`;oL4y;jxf-Dw)qBdepSs~&l(l6Y!{4}C-D4a$KcsndfOthG26ZRW98g*ds z$D&caehaP}J z08zXd^^x#m1D*6nM^injH#UPpB^t90u5^U7jkVO`I|fg4D(Dl=G(n~fOod0mCO-}y zo9jr&Cr3k3BgE2)AnIlcDpThY5wK&z7$c&=|I7gz55fT}i3@sskAn^A#TifL43?P% z;tRf_-Em!DVhb9AOAOHR}s@3i0 zeq`X+@ou+yef*-{^^;AGGuzWHZ}U#;@qGMz+Ky*MH|{lWcYQou#sfUkb$bSHHz!~U zr(J^g)Iv)$eENtD(4c)Tbg+yq{|-F+PqefuwFbGkG-IOW`Mb@jt< GZ~g;UMx<5% literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/Contents.json new file mode 100644 index 000000000..55da715b9 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/App.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "App.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Left.imageset/Arrow Left.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Left.imageset/Arrow Left.pdf new file mode 100644 index 0000000000000000000000000000000000000000..996370c836fce3ed5af3c4dcc841b52d9eb56b0b GIT binary patch literal 1317 zcmZXUO>Yx15Qgvm6?3W7BGv2hx238QO({Zv2r0LU!?JPPpmY~@x2W{jGj{f?#fQjw z;u*j1%s5Bu%d1o5jxhuQ&5xf9;Oq>}&snUu=_`{C@>|uh-we6P3&glNop#f2$fcKFIgngvblOApFh?$q4Y|6iW~jK9-Z%uq zgYifkidjG{jQ0*u^5BIx2K0E2&=5MIicutLiF!PyV9zYqj;@q|JP4`0$;?|}q$Oq$ zX%CiXV#uO*-UdS?$5C0i_E}m*xr7Va*;I(&tahYZYpXDwnusvQk?0{#Ld67^LHeNR zxHKrNBMqs9ltU%&R-*|LW@Nc^+L?6G5NWx!MtY=dhNl~X0K`-SBt3hAS%^;1qjv(y zK~@`HplnJlLX)fP-6trNqie=;Q02*m(3Iya5Ho+v$q;%!|weFrz+ z>1og^zWx0bp;(u9aR8s=c2{0BPjHjE_-fLTs(3*2Zp^faUGvyhv4iyZHbc5qQ}?l^ z8`H}h;ks;z0nJxNi}#t(^lpofyDdqDfgc5QgvjE9O$EMe2HIzgMa%(Uc+th>&utI2dQ!1~oRsE-L(bW}WpqQTGrz zk9TI?`SQu~`sN(DV+=t+_v0r6xVV7JOBUO8`pe`YuRg{0VR!^ZaFuTL!!FiaR$a$G znMvf{k3l)|2N1wb0r-GMNy$ zR?Zr^_cEFy*OJ6pXqe+l2N5(Na-Wh!a6EV^O(;l!=gLXv$6Lh|6-Q;POZqGY@Pece zG}20u!bzu{F)$;;tws|tp=@fnq@vg)B?qDQa_vbTlDn+Mr$z;5wIg+-;B+gKeMxMX z?HVf6n7$_Fowp&CIuoQWprlUX zN25$b!yeiF8`iR~EX{Ks)@icS5br16I$h?Sl9>0PdfT?$(8Jw#+6y|>x4*w4RLlAy zX7D+#H}zHb0(W!#A_VOuX?~hKtzzFj@0!>{+PqbEx9Hj-wiGd~-2|8Qju@DX4wf^a zvb5F5&6=b_%3uXkoJIFcw)jeaPvpRpJ@S+i>`TBo@kKqB}zOGXak6%b$M1 z8lwyl&IhSI=>RQlK8kdvGb5U~SICpF<6D7t&2;WG5%@zTEr=c@P|^ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Contents.json new file mode 100644 index 000000000..5d97a0cf2 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Arrow Right.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Auth.imageset/Auth.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Auth.imageset/Auth.pdf new file mode 100644 index 0000000000000000000000000000000000000000..2d11a2045d077ba81e50ce61813e5e4cd76b98c5 GIT binary patch literal 2015 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Contents.json new file mode 100644 index 000000000..c0a52e8cc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Bell.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Bin.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Bin.pdf new file mode 100644 index 0000000000000000000000000000000000000000..300582f9d58351dac18eaff4f84a70e76ccd086c GIT binary patch literal 2831 zcmZuzO^+Kl486~<&}D(7KxC1kzJMS=v)dF!TXgI67WCkHCmR=DyS1Gn?XT~nW=1nk zGKXFHjYN@;j~w3I-@SQ3Hgz2tXO4gT*%|ZlrFr$L>kkk5v*RVc`l&xWUOpHPaIL$} zms7ua>Q;CCKf7(e{{FSOeY^a%J$HY1WLH+qp$(0$}cG(I!Y+dXtHl!4SUsx+P zC5jRjw{AOlkg~AH9nF`0MT^fF$1BQ?bd?>Pt}A%WuAa%{IZpdD64><3$)!ziLqOci z`^O-hQ|lDi3pg2KRm@H7z~&Nll2XFXX0c2g=c^lpvutDLglHOw5ZOBKMc9CN7d&TE z<1T?HknuK2%u*f8nYcJWlvCy!KmG?q!ZyJMT&YAxFex4&2jru25;!ClqtuCnYE3C9 zcxio!#V0-LZ1J(+1QsP`rN~(@?ITodV+=kbT4#wfvqHilz}mJ$KsiA{zzAN3gboT$mXl+Ois9i1VI>#g*@%D_NKKGi6xbj>#<{4{Ob~g)_Q1G! zl4&1K2AjBmjM;jy9Al!oXYxUyNBFE!kDiM4=7#q6Y) z#A`MSe2H!p6A8{C!<3MVE7eVvu}~sH!$lP4eFM2e1&mr>LSxI=b~D(jrx}~edG0~2 z8f#D)i3Ax9+-syI3bH$ZTHzoBMU5aPNLd4EDOE8ySH9BH_T2~M3erQd%&|QID-se~ zlh{}ygo46Db$iLlgX5Atn8!<3M8GJD9O5bjgc6~SH4h=X7{D>E6*N9Ax{SBTgled8 zQa2-N14#mslQvdHPYjF}qvwJ{d(;Zn*2$W<7@1Hd2rr34y2YaYgQzG7=W1&c_)Z#+ zilVT~(7G!bYalKPIwTO3dUUEGbeK@|z5vPP038E!u9R$0HJJoGyCM#i-dcM@wjHXH zAT+&C>lC{(aztp@v!#r_ilk{Q?Y?Y_BlIoB2Cs_67XkqS89gtc5t&dwTYLriLQ&Qv z4=fam9wLru-={1%AT&MV5g? z1e_-&)Lw`*FcR1VQ+p;F%4gN}rP@@32{MDqmfxKxG%fGY0k8ERHFJJw)7ck@4QWaa zA3`*eF$2p_aDy~aTu>+I1Px4@7sR5aGg|wKD_eN@{+sU5{o3j5G7cuw6r%&nFx{v& z+i-)bHOY>doqY^VpBT&;7%0^ZNM7ywhG=pLs!Xg67p^ zY2BZXA5Yu( zahAUD{|sbd37@NlB@OW0E}R3u-CQ>NKiCs=Ic;|P{?uV)UHxzeI-Z@6PyKWAZ1?bdAZ4{a h9xp}%t^}{%?*8lHeH~plr%MfoqbuFb&3C`N`5*F(KB52s literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Contents.json new file mode 100644 index 000000000..a2fd38f77 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Bin.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Checkmark.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Checkmark.pdf new file mode 100644 index 0000000000000000000000000000000000000000..c1fc64210d9759bdcdf2c4e3d23cf5198ba042aa GIT binary patch literal 1222 zcmZvcZ*S8u5XRs8Q{0W5XXA4GMY ze=VCle|tu=tNo{@7e56{H7-)y&GEF`duN>YF%iq?gY}x4hn;dVn>KyZ3br!owGWFsnk)o>Sh@q4$d58gF&L+`_qV|k%49pd-1xhxE%geyY+c0|bQN_p(-gTrQ5*MXBapH&97aXl^XcL* DI+qIO literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Contents.json new file mode 100644 index 000000000..63f424bf4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Checkmark.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Chevron Bottom.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Chevron Bottom.pdf new file mode 100644 index 0000000000000000000000000000000000000000..39501723286b37160baad22b34ecb19c83188895 GIT binary patch literal 1158 zcmZXUU2oGc6o&8pE6&ZN4XKWgKVxZ{#9D?BAWFyG#6?KGE~rf)$HonOFyEM>!lv?LAr`NCjIb!E%Gv89YHKt(3#5(N%CNDfcvbuJaso zLzTqgd1n<}9?xCwP{0u(1;*SN+Do3uy^zYsW-U)C#=&igrAqQ)(>NMaDtAI&54>bg z?C}k&*;f`tlN51~PgKfYRy5>MRC=T&w(Mqm;)jk?cvN*kCs%JT^Wr`eNH`PF-Kx@W@E!Y~Ox-f;C1N zAeCG literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Contents.json new file mode 100644 index 000000000..f664dce68 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Bottom.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Chevron Left.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Chevron Left.pdf new file mode 100644 index 0000000000000000000000000000000000000000..41658c2a85139128f295672a35bdf56c4c5c80b2 GIT binary patch literal 1157 zcmZXU%Wl&^6o&Wn6lW8uMe2C&7pba56N(TZg3GRAVVr4dl-OXqsPySMTQf2L{cLp9J9Y60WXDsCV&^h$YWHg?isVfJB%_udZ)HaU|I${He;2 zzrTj{?eeMY$Zx_a8xF9^xJXudC#jyCyycDwD35bwa!W>6*2Ge+m{JTlMjOwRh9g2R znKvpzZk-k!W+X5|OKlKMp@MR)oWy!WP{ozt3g0r}4AXE})S#XTY5l;a5>#{Uw4N(4 z>a4?7<^qf==eRML-%_r;=O!+~TcbD_Okk|W<u|4mwhqyw_ zA!8291-1q=vQ#R~ox>z!q@`AB^usO;9V^URJ0KhzLFl#DHcl{hyF}C0(!xvfKJho-%AgVhb)2*Aj4>eYd(w^Y9Xpw;)(c%M$D18{&$7+YI zLYyE^b=J)z#`0JFcSshQ@J<(*;(%Q$I1j!q`r^>+Uxq%l;hx}?kki!h7mP+F1LE;; z27?84LK6FoXGVshDE>q8RiI;daWB1`wF&iYQ5`}{;_ZFd;5yE_<`~Z5tlFKQmXhU7 f(?cA1Sa5b*JqPT5_{S*Pei+9~LsqMIUvB;ZrVsu? literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Contents.json new file mode 100644 index 000000000..80250da42 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Left.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Chevron Right.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Chevron Right.pdf new file mode 100644 index 0000000000000000000000000000000000000000..0b945ae636119fa469482a97d028ae18cc757cd9 GIT binary patch literal 1161 zcmZXUO>fgc5QgvjE9O$EMe2ILKcuP>O(;Tu2rjpZgK@U0QDTGbqS9Z_tYfcDx`$}} zcy{KU+1EMStZy$lwS;hB(ERvG0Isg!`kI7#8y|^S^6XQncl{$sgn5kW`Zg2?lC8s^ zsto!28(7^fpURH>CRl(C3)r-|oOkIZ7gWbE4qQ_voN*S)1DW4XhZE__npmn8Q;GqX zR2$Efh66$`nKvpzZk-k!W`t#wmf9eijta`Pa#BD^1XWxKuJCQtz%=X^HK=DoT0gL< z1l627t>+4iI_pr%T!2yK95)8@TgsL9+{9UUYZM2A35?Zv0W;yk2oYn_IYxyS&PxoJ zD9=085T}SaWXxf?Kxr@|OQq7>IZQI1wA4zCaj3%3vBEsHJ;G54La)8Hv4c_V5=~P} z124%Vd3Zx=@|8s2jHZ|z6wPvUmKGxUN+pVZ%ih*?(|2(H9sP$Z`}X%&fNWFj!U#Tx zZB^Vf&u|~dbmAs%CUo3Mob;3_4_))rmZ5{_@O(_SYU)1JSTWjrf}5g626{w`k07G- zabzE>ElP#hL7wWYnkPKVU+M3VEHdGpE;7XiyHs#)d{y+tzS;eM^tlZW1h0e~+mF9s zG&&g&kBc)Hc2FlIQDZ|}nz$8p{@hj0Ps)%M~z ilq_$W9%948fU~>mC7}A@U!!RIp&hRnIXipz<@O&hI{y0r literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Contents.json new file mode 100644 index 000000000..4163df781 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Right.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Chevron Top.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Chevron Top.pdf new file mode 100644 index 0000000000000000000000000000000000000000..929d3c36dfda2f6850c99cd72a2bdeeeec2471db GIT binary patch literal 1157 zcmZXUTW`}a6vyBFDb7o!4XKXr7ipTrT80oHO2^y8LrA@@s7)Zr(BRW^oVsq>`k^}c z+2`uNJ6X){r<__sI522_{3HN3H*kAPLcNNgM2vayDb(x!86?7GJk|AWD0ifohd-Mt zEZ^V3>|y*>b>uf;lno0oQ?jy=_Y8GRIm>|ysu>eXLA4|K+@;Y~HL+AHrW6B9t<+Wu z*dgk4`57t&*W5!z1XWxKu7FeSweSMA$M{n@#E@!$Dcn>= zZ>2{W5P7YP7^Rr%SO-@Yb6Coi_uK$NEZA59hH7rC<|l{?BgAkjyE2L;IggX4$~o>d zRx-uud21xz9d#Cm$KZ%K2IkIc+)JLEdM2cg%^I3g#E8f<1(|7Rr9kqw6`1bc#fMQXuLjs?}YE#}d zukeVyBmrfEn*-Wg(ik{IT86H9X{*pdRQEE4n>BSGYRnj=eSnLyMFu#n0gWC&MEPM9 zA2%y36=Da=oM+a&pfA6uze6&LWKJT*2D_Z_*!ZmM%Wbnhb$xBa6G54ief#kjjMh>E z;fYlHG7-icJ?RaU(Wb*FI{eO$w{xkpp literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Contents.json new file mode 100644 index 000000000..e18a8d948 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Top.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Compass.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Compass.pdf new file mode 100644 index 0000000000000000000000000000000000000000..e06fd2daf52a71cc447bb2c007790fb17966bbb7 GIT binary patch literal 1832 zcmZXVO>Y!A5Qgvm6?KUONO)ZSwuF!%fz^sdgn=94Fm#$^P^KHE2gL5L-?w_E-5th< z$n)6s)|b0-aeejrDeI&ZlcE00H%0X989jfl+U`bvD!b&Xf7Z<*escABwdZ7ny1EwC>K&>QS?sE$g+q8JbQdT}pE7i2bCzQ(njH z6XykF+$+u&V%E5x3=SuhC(8!jPS->t+G43{+38kwSqbc*YD!^46|#d?uqBTYqt=X; zF6+HTXjN`btGb<0qwZ9#Rh8V$jIH*ZZOY_y$R;rIk7s$z2#JV=XDLs;$N`!7XcNtP zGpl}KTrY|{PSzeRM!gznO{9`W)$l5-n<`bw!sDG{qhpA^FpWFw&;z_0qlfQ?CG*@AY#m&72> z7lWJ{C5Kq!b&L0uMgjO{cr@Oa=*5i<2w&nf3Gs|EaE|PZ1n5GH#~5rzRlKBOqA3Oj z!61LBL}GN?gQUdl3JAi?$&IxM1!AYlG0HR+r=U)8{I(1iYyGk6#UeN9ge|a=-C3vP z1t*&wqi(Pz6^{bkc*6q;$+&Aq&GJn@6xy!ygv>iOk@SWiGW)DW;gcc)OP#xW?H`^P8 zN|M2vCO?<`PuTKV`~%2BDLzn=1c&NyPW*Cn*xdKG4^4mX+ph}kQO8*?e+gfR3j};x zc**0Ax{4g)lvNSBj8Z&A4(^Y~bl j)w=HwBngiNUVYg9*CP7yf7)h$7}Md%MqOOIdiVN&KsSHr literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Contents.json new file mode 100644 index 000000000..7eb503ec9 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Compass.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Contents.json new file mode 100644 index 000000000..6e965652d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Contents.json @@ -0,0 +1,9 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "provides-namespace" : true + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Contents.json new file mode 100644 index 000000000..7cd8eaf7e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Copy.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Copy.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Copy.pdf new file mode 100644 index 0000000000000000000000000000000000000000..76321bd8bcf4590ea88ffc9986bef3e2b9840ee2 GIT binary patch literal 5104 zcmZ{oOK%+45ry~tD|#cq4&df}KLEo(EX6^P1X1Yhj4YVZSYkkN5|R#_{Q7)Vb?0`= z4=#k(nfs_ZRduSmU%h?v%@=;F%i>qJUjFgVWnI7ga{cP7<^1?g{=0-De)FgEas zi;r9EwKlJ)j~ujuwHkemf;C^9G~A8(SGga zy2tUP=Y*VPx164PVvpW1|-8vQh)T+B)&U z_^ayoM3w63(+ZUavb|whav5*uEo}?2q=H*YpO{m(T2kt24WQXwA)@u9L=E@KR(s6& zJh+30vc=SLR8x#P2!oH%dxOo%Yu=J`vE$GTK;FDdB!@+BM2ZdB)uvRAfTpeHm_3Hf z$OF0VARPKgk-~LtO_nbC(*NQWzZy1YqA?<^}t4mV~n^x}%V z%!rwJh|?jkL-b*;Cl0qUy?LxPcAVog4%pIwPnW~3sHl5KJnkr{TN{Ajz07S+AC z02MbPe$_jzUlqY*4P-PGl}asmQ%`E!Bz20uH7S+e2-!o8>1HC(=-h-5l3(bVr{x2c z2T{UaS1E(fk6>g@fhoa=h9^A5hn$)qp$9ySTc{5ekk!*-$-|F>8A)gojEn+N_9RtFLr+sbaIDGNif~2xN+dL)TM;`+afucPY0sE( zh^ZC_-QCKiAY58NEsLU4Qq@V?)8?eHA0`IGIB?6rdKGUxa|0KvXfe?2m46sgra-7< z$t*Kf#1xBCoMLmBi>4;c@o5UzoUx|99Y!%blmwd-+tkWA)`@v4sfX!rC~q;h5`%?0 zFY>IeOQ%!h6CDzDs#{OAFcscja!mz!s#~V4pbItbG3HiahZ@(hN=D_Hy91&^BM+k4 zArUJwf((r0pw5AnsfU5QY;;;OTGr*5Drr_W`fM|~k3mK!P3YQ~Vd)h_Jfa%1j^8{w z0^|@r^cILbmiGm62X)gqv>;ivP@#Z~oP}m2km#;7Ee5!RW*;FYJsH=ejK;dYWk%iN zkerE;-((;z3ZfS@UPChT;%=6{Z1{Y`KjJYliZ3I||^Asoh)Crmer;A%CjXBDAsIJ=}D|Ap# z6VbsN-ed%xpuPXWF9%Q1qL3*wf%F24R3+$c&AT;5q@}%}W;RcwK6o15@ifXvFr$H| zS#LZKzIYmiX-`7y_*Gu0C;vRnLg!gdH{}?L047!tPo9Qw?12}|6h`0vs8h)hL3{T$ zND2ca(qKgUL>Cvj^NDm{gPP@M{7PT-~VQLT>iSq$C>fv z<@%Y1F@Jo%NvXv7^@b^a|EhEI+sDVt%k%o(-}%bJ-_76t`>*qQ^Y-rjc>sStzq`Nt z`tsxY-Sr(r-Vil$AZvUJI6hrZx;;N%et0^apI7;gbUTiFeR+I2KXRjdM7n}+@1DR` zUbz%Hd}H--k-znELX`8TP-4%|AVz|ptg2}APauZj3B5es z-9Mb47QV^d{NW9BeD-|#c>a9-?Ec;7M#|0YTbDL&J?9FzEuD^bVlCE@{ z%nz+{Oi|?FAtgV%x_tYRbetwqMjih6b5iQnEA{&IH1BWZ&&jUw%}?|G_WV&ffY)Mm zIv?ll!?d}a|GC@E*WbTU7w^`8?M~C*6KPXE$}EeQef9J^qn-0UI<xGAiL&C$D2>Ffg`y zMC44!4S|0L8{NrD&1?(o(YMge;n0XRdw9#2#292wEZI!Fy*B zN&$7y){1PS39^6+dri=-!KUO@FB}kO5(r+^w>33|MF&nTeVzdowP0{8Ga#Y75S5g7 zg%$M?gf_M|mHNdS4rp3t@mAwlYaU5{!uxmLjJtSLO>VSH)b%s`5xzIS8x3j(O z@?I2xZ5;H<$tb!RjTE3e*(X%kjA|tI90*p8uTmdN(z}gT%y=Y<2zDq)V;>muL-xHy ztSOK!-P|e(#Nkem>F=RZ)XL&KD1+e(%19A6nIOV~e8oZx4Ft0bbXWSiS-k|wa^_(v z;z!yLO+P>+6P?RZpd}7~9(6~V0oHH<1xE?vtLFqL21cd=Evcg)ETbSz!NL$AGN~(8kN?G+>Rs(U5~@V7+rkL9l8q zj#aChV09A6suoyQb!3#=t|zm#}l>JHXJB+9P=G*=La6YN`zvJnT&*ry(|C-h2YI{33;OF_~ zZu{o&S-qF*wwAsxmiHhC=+DK))Af8hd^+ytlae17*UjCztq8-%JPgKM>%b8+~Dz4Rph6Ofgs@RcV?@YD|+iC=8b+xx@q*IPdy z=MR%najNOdzbY_pJq5UZ@H{RnweOHaobu@qW_fx7;SPCZh3n%ngjY_7&d2TD{d}CH zdOuu(j_0St!~8-$zq@%+N!eT<4re6^7lJqM?!L^3zWiX@9?vBm=R%yGJ^SvLxBmfs C*3;(z literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Contents.json new file mode 100644 index 000000000..063515431 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Disconnect.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Disconnect.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Disconnect.pdf new file mode 100644 index 0000000000000000000000000000000000000000..d1f54c6a615da6930df549a5652c66118bab8eb1 GIT binary patch literal 2845 zcmZuzO^+Kz5WUZ@=*vn8QpR1?-%=Eb>=J|ku{hi!4rX?;YqV>F?V!M~=T%Kl&n&^G z_M7hdc=f8fuWoPNy`nyK9T{tmzy01B^ZK=U^QIdQck;L6HNN>_JltO%j03opUFXYb z+&y)hoAIyxFmAtnYp&m~{|)Ev&yISlKV#>`tF~Hw^Cb`^Y$~PXl+Ez8oNU|L;yfI> z(1+xyupuv&iOD>5u_wC$iMNz>UoPx2 z8}3t%IZTixi@X^QQi=*CA>QLC_mX}DRn$l8Y?6JhBrBW{oP`vvK%kNIs0-}Ebd*Z5 zQTH)9jvo8SrsS<5t(J2RkPRUuq-EhMWmHnU!kkN9KualPIVvGpHl=qVTQ4b8B=;^+ z2ts>2eL`S~1J@Roq zm<3dkB+PJ(Ia@(ug0{5wkph(f48<+jE=d&YWj1hO61Dd}F_jD?W@gA~z_1_?i6t~? z*`tQKaMB6#NydY2w~(P4a3ucJsD+r-4aJCEaGXg*jZkU|F)^g00i#E8t`0GTrFkVR zD#Srb7trStgQ}ZQI#A?nQI8eNz2_hqKF-!~6pi7XcwZc#eTdi><#GxHP;!pZKaxR> z7oF^~FX|RdNm4pe(5*rzsM6e_V@?IGKnZ$OLtkf>4kl=OMO)oMXh4 zSRmX0xClsZo_aKjHVcL`l!)$u7jP+(N{kx-_G&m7=}=XaAzy>W%v=!7O$JguICL4e zNW^Ub3ysVeS|l#|w=B?|INER6ZEKys0> z!{}U&u4?+wef+9BbU%0UlBv&>`As9wm+7s88u|9rL3b@rpv~8Z!|`%9AAZG?2*1rQ zfB!L>&F$`ftiX@s-G2A>_}P4zn_S13wzi>(UkgFD)of`yo{yhS!+19G=-O6u*T=(U zJiw#8xMuKncLHY6yb7(}WdgPL+UEQH9YQsd!Pd-vu8*H^mcEGp3}j^q^KNBH5eE^V7S30dQbJ%K!iX literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Contents.json new file mode 100644 index 000000000..1d93e4d20 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Doc.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Doc.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Doc.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f64f541b005c3b465c8ff24c51bfe96eefffd05e GIT binary patch literal 11916 zcma)?UytQR5yju{r|?UpfP}|w_diPri6np!Ai{>Xh=*k|NfzzQz|MkzPtWgEx67V; zy%O`1o3q{R?&_*jr^^29>#u(OvoMy+B@EN>{MWx-hT-QwAAa$R%fr)m`rpfZ#P5Fp z@btsSABP3-jYhqE{P6Jh@pAXo!@u6$KfL+P7sHp|9RKhB(O}bsEAlu6e0p8Qy;iyqT_5>o}ztL$(D{U1DI>I+h&LJnK<8^Y4XKKLOrM z*Q#Zl%9>Kt0%eV*?={aUWkB{iEhV?To`5IQwdyq1ImUS%=5b+B_V)-jFF8jR9aBwZ zO6>F;yPn%t#AIvEtXP*4YGy?)JkBf>0Oz>IX=2G!a2l^?Yt3~GC9#v^E>{e?EcnS` zm*?2^+_qv4bz0(am!a=+KJM}c3~YTJuV=S4*J%#8O9*3~u;IednP1ZqxUDdcfq$(! z`^s%y4b=*DTw}sxbe&T!p=gE5b<|jJQtl{EQ`UWa0=${t_EqXUXlf*Ja#gAyv!ppTSD3~tZ9EB zT*?&XHyweQI*Bo_V^B<BwPcj`{w5B|o=6&yo9+J-o8nI?mY${9rT3+!}SP0h`Gh{hYXTn|Ht4tc)dKGg-FV ztZbv)K8_r0=Fij4@Qr3OA8A>l*~~GFu#M`^bmXwJ1J?JCLEB3HOn;su_a}R3x4F4r z*y%Sr{Z2doegeFi-d61#DjwP>xQt<)R#6M4goE+J_jt|;m^TXEr?*w1ZT>@fGoJ>w@RwtJE1d^Qxf>Btsak{~}teLkeNjXYq=DcgL^ zJcm@pUJmx5;t1C7BTqpnvriYT->fOqxtZW2x7{vY96ah29Bn)5KK&FtOqWVnBD4;x zFXIevkl{X&LC9fg&Q0c&LV8{~>!~0)SyQJvIe^5|Jm*QP`nK?=9M=w!hDd5B66;Okx8jgOZc~T86>an$VO$B|j@ z=Cbb3_SeJjT9wM$X@NscFGvz%JfKo5&dg(00w`vnn;pv9H)jzaEbEejT|r4D%!xhD z$l(>;%B>(sasaxyD4F3zH6L8xqg+{`&ZXdQjv;L3x?*7=SO)hUSGFFC5PsB%r4f3# zQ3%4;1^L7%9ojf4q%tRrD~2GN88f4YahLl;=HK}godX%lDG8HlM!N7LAk`~B2%A|< zIWj*W9w3067o?Ih(;P9gHpouUWn`vW7~c?MtUX>g|5Rq`n#RwpOWjG#sR^;{d=tl7 z@!>caWRVlu?urH+P*iKoamk#tq`>X7JHT2c<8}NQ^DP>OiPBuzXhDDCy}KCeYCM>6 zdn#D=^nfK|jH`?pSvSc@Q=O2gAjD6=qTtp=O)btN4&I`7BSwxCrvxkc zA^qfR{}z;$Ztql;A#xKR&_SuD?Akab*95YVsS2^TWw(B$xmoD65}9LD$m5FnSPdIZ z6bR@Oyr4{lYG@abn;Yq**Y4J1)$)K2xg{}D?Oc%bJBGGN3s+}|xsr4S_BB`991gmI zM=J5Rx#c>d)w8&2bKPF{=)}EX6OEA3m?{IcKoGkpN{M5*)DcsOn?0l`UST`D{}6bE zq99CJUe&{s(@-l?ExJ1s|Lx3<7$;oWLDumk>FM;4ce{V2fl^4>pdxC`hYW#7aj=7@ zF)Bb5?vI6eHKjy=bf3*aNJvH{UHEWs*QH)Bek@c}3|pv>VtPR7p%zd$ZVx$&!C#q6y)nvt%nTPr2aCw24YlTZ{+`O0$%(d(m4JmlI2s=n|n zq{53xe0-A@XELy^4)OjCwr8!Pl{=4*u<3E!z=tr zC}G8gP{aqgfSAcVg4Q5D2BKHA0GW54RMEN^xUUlM#0X+W5(b(|CJ|Q9rVhS~9zbLe``MLIf@N_0bjW<(I?>dg`Z#o*1A$0z0!omXi{lzd5apz% z+8BpwQ=iGjouD#R#FLa&*ML?zY|^R;#l4u=4d9~wAg*?+GzYu6YB^Y!2|ODOF9FrH z1SaB2k!h+nZVz|Vk!}X-Vs50ISeoOTLl`TYXr9!7GQD=?VofRCY_VN)j{@)LnAUH} z)G<{@y&L4+8P(r??iqHND`)B>y$7Pc$Tg;-v}4}SI6UPH^Y!c&_GUk=o=pxxa<-`T zBpYaL)ecI1nU=PeWPiNK@&xr&^)zaez67m54OUgZgB)dB!B0hDa{~HwRYf;z>QN_0 zP}b{kGVsM1jj(_|mn9V%^=4xIY1TcwkvCREh`_DYBFgY=PL%FeCQp#@OpRoRcQ z*Lw$5I;Tx9z*g$8p4B>8Wp2+W#2bNM!r{q~#bK^3|Q#Fq^y%CDH`K%LiZ3aa(!GV<0#aq!+26BL2 z-Iy@wMbC+6$$~fg)3(3AJYD|u|Gx0U$6KJHidHHWQou3$Z~y9fQ1APwO;AhHUo#g= zsncGp5ocNTH%7pHNyv;-o-v5jhh+p|F}*5O@=^N*PXN>nn|t83GuKp`A7B-wGTLGW zNimqSlE-(S=Dk)v_9&BC%|0<9a6DQQ-vM|MVhZ{=jtr$lybZiv=#@;kF@~RWD ztf?#Iql6~KAYCd!Yz;{WB$FZhVmFiUeC1D9!#}A~nde$Hz>6I)si`Xg&A=h## z+MY;_Rsh2ZQw&ADs^*U7ahw*A_DWMrVjJ~ERGpf)N3cS-k#-WVg9!;5KD?gewK9zt zb<^gRCD}3TQc-}KXhg#~rIoOy#)*!ad(DBq%nW3-Wd<)uJ$h1_$}M*h9ys`9Ea z`5fR3cc|>$Jd>tYQfVMa{WRm*%APE4B-LoXP_)3vcnNogXQ=yvFF}^v5m!sfQrsAn zDn(9HdB(H0UQ$-lIEzAqA~wO%fO@p*SI!nUVhniJ+?6_2!c>sC5$?*RQc4~mh()&3 zRr@#@(XjVBCL6N5_9n_6fC;U|vhPE7gEUl$v6e_f{j|;*lJd04gmlXAqsx3SMzwj} zLMC((o(%7VA>+Xp+I+XR7U*=LMd1Onr`SS|={KjXKo&y!1%rqyL~iZ}Iy|XV9g*%V zLd>h&ryMbIZ#H#I!EWuIW?h@9RskHM_Ge$6h*aZ9@BMubkdE3*cA;&j#2+DfJPn8% zRXT*984;mIgwEWVlo*ABxPWdwMXlO85ahweU~2v}PlmiT${Ivk-EPYewUM+>zf(rx zsDy97d5ib%THQU4Q1>G1N#8P=QlVa3h|$$Gm)8>f%HScBxd|Hs6&f%VDMnS2pqbXa zu_%o%c!RzXZUT)N$Egbs2Ojx`w;#}20i{2dZRE$1VMjEJB+{!J~x2m@pN2h3kz<~5+3wr}f(6fk6 z)Tq}>jUzY?Pctn~ZXDY@C;L zsM!_`bZCt9Sw@^I3{SE|5a|A>=WLitNGwWDG5YCXOU>1;v_qBwNo4Aqzk*17blLlJ zd5XQS~O$N(f2}pGFLazgJVh}Qs#f&E)omg)Ow%AZcl@8_=rSOh2HfN5)z4%Lidw4%OA^yPOrsQmwTa_|ii?YmKvvEb~}jTg?T_ z+Df`=RpEGq)SlZhFR#ypQHapphl*GhvTX>O05z(rz~+h8^g!xd;stBiC}EZ>i8XYJ z&y=YmpMCAClh2yIV9d4$8Orp9?^Jd&ec`8(nfPR?u#z8IRzgj?ZL~qt7ZX3sfI9r9 zFLpbd(unr{!qkNp=<1^186WFy;z9|yYYV-ykf-QXjJbeys|1n9VKF(1))GS4%0zlW zh_yO~3wqAfr!h9LfuSa7z~^clS8Vs$mlLG0QR?YCX$n+t)_Lx}JM%Y)MP}F}5(iW4 zim&{zcsT-(TV&iOxZvlBS93?hsb@nvR%-6{CBoGl;svsf+b;nKKIE3nrR}anh%+hC z;%vK8K>SxK((fGz`I5QsUV`ck4bFJfV%b%m&`jjLh120f6$h;!#7k4pFcOZ8L&}Qv+Bjt1Npg}X@9m(4 zfD->R_wk59_6i<)tNIK|(!P(v*7{RucEoh<6=s{$hce1seOxb-^~ApV0r9mQW8b`z zM@(_1wh~Ib?No}{_TY$&dyR<$`tE(4pW0V<#O?6PI$Tf_PY3H@T55dKqpz=z54yza zyKuzby|>*uCW&PqaaD@&K9g*|jq0mA;(L%X=%Z+*QsK4gw^@gtciTh%&`U3|I&!d% zV+ZRv=C<(F9XafQ(*LJc`|Gpe{!Q@q0Wl%iKP)C0mc>6ThMM;ej_-c?^z{7kW%%|l ze1Oc~-Jk#S_lM!`>$g8Vbl?vU-@SYL#q+<1Z#Nb)`Y_wthalI#ww2yIygdK&!~Mg{ zpii9N^yR*Me){^9FwX_5;`exfpc#3R;kV9eww^ci*wqK__@KY|r`f`Jc=U zH~W79IjjVk9aho-U;Kgl!M}X_@$LKPA6`%W_lJk?FQmJR9krd8R~nEZaR1}2aQlZR zhbZA+LA3M4i~1Y-D0TQ?_t#K@+^(Q}SnK15x9{FRe7Nwr_}y>6!W^H!JU>4CWcd8u tcRy)HxqI{c{Bh8M&A@lxy!-D1ySLBA-+uUL$I-Vv%jL7re)Y#+{|_(f8kYb7 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Contents.json new file mode 100644 index 000000000..971c50969 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Dots Horizontal.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Dots Horizontal.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Dots Horizontal.pdf new file mode 100644 index 0000000000000000000000000000000000000000..c005c38d1f236480dfb86f75a6a49bb9b0b53a25 GIT binary patch literal 1715 zcmchY%Wm5+5JmU%6|*srEFy{4%L0M`jolPQThvv$3%XEg#!(SVt)vubzdocyUMlvw z<-!;p4(D-6j2GL@&4mbZBEb>2-+vJEX;m z8}+-Es(g3N>)ZL4?CBSYAQ~4(&bWYex|ardYTQ{K{7JaM=w(B3P>hS0F7Uy#C|DI~ z5=R^dB1+P%@af@>G9cLD042bBFokcLrX6~|`=$q#Ug6h2KNW}DYOgH#q;_?6 z-9Gc3e{jez@Tk1yB9*FdpE{{}Hlwh#;nr<4s77ZrbI`$U)oI45MYCyX5Tq5{%d>8u^jUFIf3L|bQuZp6X|P8^-}t&3s>gQ!`sj0~?kVD&rb{xvoTX`;vc`6a zh)0VXpjg*w7LX9xDO%;nUU7CDOC+;cLs!+0sv~oI?>AbGv%Wp3b3Utg=aVR5*|r0l dhDU+J+xoB4)sKHKRX2?7h@^;Vv3UFW<^^w0WuyQA literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Contents.json new file mode 100644 index 000000000..c011cf94a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Dots Vertical.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Dots Vertical.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Dots Vertical.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f6ec10fdb57aca238f6a3a532898dd3c482712a1 GIT binary patch literal 1724 zcmchY%Wm5+5JmU%6|*srEFy_|_yGg~8oMcqwy3Lg7i6K*jH4o!T1hF=etm{Abt&8H zhO5!xa2}V$XtG}2T&Q41q&VXG$4_FuyyUAZGS$X@QatA2XH#vvM@|Ih)~oFrQ|u^Q znLnjA`G;#>-j2U?OTXzN3Zj0oq;eJvzd6MoEWIN*o*J#LCu6E1nwZ3;0`u2TqF<#u;*M;qcqMv9k$>OqNPq(6&Sj~76<}pdZY)c=-Yo* zR-rAVmfHY?Sc`oZbFb}uXd2F%ru(aqS2k?ok`W063GKOKZ4n8oAs>h)R0ZZshqxY% zGQN?zs0)IKy4i`Ag4_d#OdgG@_Rx2SXvn2t!O*1Q;cfs09n0hKZYl`y8G-Pk@<4WW>YwMjk=d*Hiz859T g>$+pxa4&FpTmCaregB^+nyzn0Wl>C%$@{N2uZp>6Jpcdz literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Contents.json new file mode 100644 index 000000000..90f2f94c6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Double Chevron Vertical.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf new file mode 100644 index 0000000000000000000000000000000000000000..fccc08e6882164f4a18b34096acf9c7f088a30e7 GIT binary patch literal 1607 zcmZWpOK;Oa5WerPm`kM=srJ6tD^-q zuzr69tGngDs$;*I$oTMpPr^A#^i56Qc&52@f*KYv{Xfu5{4!Px=}#3 zK2x3>?FWBKSX0E0kpO9+$ZVmsa7#pbS@@_!c5_{F(ANquk14rP(eMF#9e^JN;MqX{ zw5wR;f2=9xuVIGfGRYJnB1upFX6ANGXBrjMl3|@Wr5zT(>_Zxa8LHS5qcCQQvPUct zWixD@ERgdo)w)1Z56P~YM?zxHMPWU%R7@F@Uc_GeM_R{bk$-9_*;R{aFyk=z#V}yW zaTxSG40>qlz&TAEpRgTfn_`apfCHk(yo$6d1CshjcGb)n`QI&iN@>hJrDTt}jvaV- z!)o@G#idUhJ*|J-^zkfs>*y$GLh)GSZ|l10JGlRj#{*yf?eDJu`EB_a67V@}w&hjx z0{8O?7%S#DF_yM?kd(DBd0L0Ad2XxFK|D|EFyiF5$TegUSNzmegMTjn2 z{&Bm(R3TQdrZ}tS8EwT;{v9F)Ljv(h>L((8OhlWaG`U&dWa=QyHi{1NhjdYxL%|4vL>2`BA kl9I2RriWPYKyZGy{TDF%;pCTXKa?X>Vc5yZyDvBY0XD@|K>z>% literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Contents.json new file mode 100644 index 000000000..2fa01f965 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Etherscan.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Etherscan.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Etherscan.pdf new file mode 100644 index 0000000000000000000000000000000000000000..796280b092608bf72852bea8ef2e33a0bd6a20eb GIT binary patch literal 2377 zcmb7`+in|G6o&8TDfUgI_QKoyy!Mu=N;IJe0V25ERa_Wnni@Ga*e)tOJ>Qzx<4KBy zm`KU^_d5RTl&jmDw=-|0>%4Jh_v>$+F|S^k*RQ*Nd#4|}FvaKJ_uKp9M-u@TDs?#S z`{hG7zv=&6ulmI|Z_M?(>8I79`=j&L4Uci>m)ZC>`7S>S1zTP7KAP3TMRODzUktza5eP|#Y8CGk~lEkseIIssXc zZVokP*tIRiT-2zqAr-GLp=w%cK>QFv%8uyKb5=^oEvV6~KS<@03YLNm(tK0L$(KY- z!AeNU33`;FrQk#$tHhYy;3vj_RnK?0bQ#)Q6lK|~u~=e7wW5hVB8;e}B&bFkd`8K5 z63N8{uw=7jSE~_QlE9RvnQUp5U;v}@1D!yz)S+w*<{S(sB2E!+1ebDlK~?c4p_N8d zrMe=>kr0fQV3Ms=Btttq_?D9Z1)Qfrbp)%G1kHg8UnHCLj^qfL;A0Lkn`UF9X1LHY zG=jN6gyJYksWi_hx9OS{ib;!&ShJ~-xdU-62@XbNjAMn~NeT`V^{&J=!JrZ@)F{b& zM-6K%&NUD(r^e)OaY`?x@$`T;E43;vnM#iq9}`Fp;wbZ%i0YlB#Ny54Z!^W{ofZO` zF}E5rwUe4+Xdu*(5?qi~S8UVCOc!hemT7(X8Z`^$Z*GuE%pBGy$SDT3b&?9!!*|oT zM$9viu2t<|A2TDy42TEu!?=6TQt(Bd8R?>C+++!Nd_dr7Kv#i zNM<@z?}Q=F*onq4!A^T6Tl&8aX`J>EEeSW+8aI?~n&(?<(|zndbldKy|Gg}WW%3-; z^54sn(P1Vln`%b;uoPlpU21FVPzN(BHbhrp5To=UX#h2e4#7zC>OwIy2AUNxtW5f( zW@gpQBITz2n0!`5)XktySR0Ku23ZLnb|ova)nU~E3dJ8*BW{bps7lrlldjiVa;?+= zsA&~|#QCHvY61UBPYx63`4VfhcxpMauh5cp!NGZvA&p^us?r%l&akhkKX1tE;bneESc-DeLk8 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/Contents.json new file mode 100644 index 000000000..be6a2f0ba --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "External Link.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/External Link.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/External Link.pdf new file mode 100644 index 0000000000000000000000000000000000000000..8b12b0c24a4ef6d8323616df62ec0a2fea7129c4 GIT binary patch literal 1326 zcmZXUTW`}a6oB9TE6&TL4QY<=7ipTrT80oHO2^y8LrA@@s7)Zr(BRi|oH|ar`Jr+? zpZld}tL5z_r744NN53Bc7ATwjw=Z{jBrb6$K3^|pTmiEtgIy1otNffUQ|XIF*w z`x{u?&A+OS{3e{T;Q$*im-&|8IQ3o`;Q=p9NUNYaOqw&XWUH%cA}F`QqbSFBZ;dc; zIDtla&p8Nc1Tzk8i&0Ky)r=~_83y4Tw==;#LE~C;&g6_D8znhSUQSpF2W@6aNrmOs z2^dT!bwMrn%Db3C@*+mLDV&Uk7?mq1DJBE+@4G=n!%}+8BSBcs8$*S#nQYQjEX#xhc~1qUrC(pG`QoG$ALah zzi}qdzRDDLqIg@^P2a)&cia&?#kaq|0u-xq8xr^&HoNksd4_vT^5w{LGotA>T3Uy$ zd1|ZBLEOT1GPh{zKGf(juHXn)Ws3~3Cj*)-YD9T~i;uevh6*u*HH>~1%@gYKSMhg9 zW|qu}rI=us9Zrca%D&t;+f&u&HarjpmK@WMzhJbM8W5+$84Ne5Gm;o*JQK1Oqj-UE zOI{#vv0x`sICWTvg!;DJ?L$jq_dYDK9Oqqg2p4d^+gu!rQmmV%hnVnC;NougFJSb; TKU>-MLpr$nikzLj`*QmqmyRE2 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Contents.json new file mode 100644 index 000000000..db1c07077 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Eye Crossed.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Eye Crossed.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Eye Crossed.pdf new file mode 100644 index 0000000000000000000000000000000000000000..dfa4d72c927dae16a4031d06d45ab495680e4db2 GIT binary patch literal 4110 zcmb7{OOIT)5ry~nS8yZ1HefbcEWQB4fGx#AkOWc2*%?_(T5WlZQFlB&4xIe@d_~^A z-6L(1Heg(x;iDd>P8DChee>Oy(br{(F1XV_eqNmW>MQs4*URDf&i=W`Ex!BH;rRaf zCzk;4Y}NVs>2UvH*}XaZ>tTPm`~A1>_4l{`+MkzSmgvLyxp4XTa{GGuH&J!br=V54 z+kd$3+?H)0=lyYs%7LZF=%V-@B<1GVq(1eksTi7LY>7j!SoE#7Qo3Q6-O+1nQM21G zF?rFLLv}IvDpFH(kA~(_L#~FZN>9mwwcL6X!(tXme5vQcD8+T(ib^bYr248sa{!E0 zs$yC8vDFlVYh10Ra9#FVyGVD{_tJAz+nRlmTyq4hF?37>s!3ZgNPFTygIZ`MXP}hI zwzX+4u>neMF^pTe6!(E**IL@x+Ee9^K-vSb9JjWfbD5x433FXdS;o4M8~$@^@1dwc zsT3?4TYCu8;FzRf9ns5VC&xC6c2AQ2c+aq*38We7c!hl*jP7t0ECGh4sU$Hp`3babL+}0%WF-9pLHwy_^2>q z+`6(9x=QFIW+Z)Ovs$7XF}reJy~J8=>sA{SlN6ar63S6R3r^r)tesl}5JeQw3+g}y z`Frn;aBs+dDX>3d-WAK91Z0IFkU&Ba$BnHTxuY+o^<>7TS@m|-TJ(>L_!0|+0S2Rr z@!i{fVyiX;1{q(reK_ugj8_G_h{^?toAmf~A4g7!GTVb7F_CPhq?Mw3G%P@Vqnm1j z{ti}lRn(#&KJcyHBBfDKMz(Dg3PIjb8Ti_Is|9UYSD`5Lqz&0Gjk?n?6lh)5h+mA7 zY#$;8E1FNL6q_MgsX0qFqB;X{6SYK6C5ek9>?3Au2o@s8Qd`#RvIqeL5-R6Y-_=B$9Vuo4t~XN6 z^$FQlLam6u>1~2&-A*IYCe?Hk4xxZi7IKA(OsNL!$hIXga|m~_jx6b@+7d&mlpYX^ z2x*xvBn#=yx{9(3#d33+Q8?1CZf+&kI!kY}j&87)-sXcfl39A2ukA(YB@`H4YgkV2 zBx4kzL?dBG80b$JLcbKDJb+S2%^LGUb2B@w1trKp*M0=+8MPd}MH|(`hK;|SDhYav zZ2a9;WuIFp9LnAF6+)z+@OMM@3v|!cFK<`ngd$l&EBb;3m?zk5YcSWGuzLBJX^-&l z$1j%S^4I@+STRX$bkhG}Sm|Cf29Hjj=yMTo^z+JQ#1j=ON{HlE$ zVm_<{-!O7M`3)l(WMCwDYlGg|hZF*-9C}5%_#@*`g3=~tOe+a;Q>!_^ZjdZNX&gqQ zoJP!oPe%AziD-ifC2fc-TZu6Q4GE0&H1q_0KnUoXRE!1H`+d8_5kwnM8o9v@kqpI7m!iHb(YB zP^KkfHyDP$^>V9OVpuNWf(?tom_P{eux@$=MuQ`B6C3`65qHeQv>79iM0#%`31U9m z0J+7RvARG9i{zRUnpba;2@GUr4kY%19kwW%CQ)C~F7|DlQR&->o(n^gsk(r!cLZMitO&hjVjM~_3 zWSA$356qH`cOdgV8(2E@9JX7FK)NuP84f(2&P z`?=!=@dAAbp%xJR#VQ&wfp`g3SosmeQ)GjlpY9(X4^Im(_T3-e5RT8zrw@nE-DeN) pKA%C^-JMR)&Kw?5-+lk^p99v9m;3$G^Kgfr-IiCce)pH}{tI%@JPrT= literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Contents.json new file mode 100644 index 000000000..a2a6cb4c6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Eye.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Eye.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Eye.pdf new file mode 100644 index 0000000000000000000000000000000000000000..243e5adfe24bc9e39c8c11670c47817ff854bcc0 GIT binary patch literal 3418 zcmb7{%WfMt6o&VF3T_M}1x)dN0fGRH-4sPz)K$6*x=_bsTZOG@C8bF7^!*RXIWw*o zMYS+SpEx|X{~Xd6H`nhkjY>iospa(B??TEqZ{*vzVm#c^S7FzD^TT+!KR-wZxTRI6 z^KslgiOu!+*M1nc-@cPqAJ*T7llW5@rRzuP`QehEp8saOmxg~Eo|ad69Y36gg9xe= z@1v2IR%xSkGV*B!wJJIUZDdqAmt3qQ!);ySR~ZeWC|!zndbO^s*7e;M#8&Cm*%haZ z@zHC!?B-uuWi*JzJBCYOyxW3SRv*NjIEbJBcapJ1E6IQ7*ubz&B{^i#C2Jk!xWX7y zt}vhm^07g0b0C!ycv2u!ho`m`n8Zs)fT=XHCiu!Fhy% zr<|}7Ph1HSWXTShU^GC>#-<#wHA4u(rjTo+%-ccUCb;~}tg-PXl0|%$Y4}GYg(CN&`0a!f(4|5YSn81g4E_(y;dj?9ZH}&aXry} zC2B~8%MOyWwJU89u|5{8aZN&l080p&d|<5+v!z;esf)5QoyZFWh9W|f#7x9EAXXLq zC}=W3h*jpsxoq1IuwLsTp}CkeP<_)uR-~I8@l*4}k_BQBy6+aMC&YX}(wo)lF_?ii zOJglEFilgVvl@R;A*YD4!fMMANJMQSNY5mQhXv{k&NrCW9tr_zHG!mEGCmM#l?%#Y zbC>FSy}m(N#Fz?Jbq#n`GMbU>b)`V`C@Op+dtFanS$KoYnptxW%Wcp^x-!uO=pHox zAQk~D%ndk*#C4S;&^DI18JM7vxM>)!dTZWm>A{uBrB@fvV6=7g;y!o&D#~R-a58}U z9N~-s#n_gTbLT$>eY6;kx92yS& zkQRA)>S-FcS(RB{^RQ*%u)bEe4HDQqZF!+Flo}ehyd6XrT^+Y8s|Koep5`q(2SgE| z_c;O}8m{$(#QV8=YtY4ZP&UDa{93PaU6AoMI+)ob^gD<7)9%T+@|B zt~@)&>R|6#L#rTJX`BmIBPZ;oW=Y9+U)6gRU4#1_cfJtQ-M3wo(K3ne$(Xjw{dx2C z;V_*~^5d_#Pvf)sUx^zVt|P$xgZ8ga^1#T!Px>&z zIhKgmV1egFUf literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/Contents.json new file mode 100644 index 000000000..5b6ce870c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "File.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/File.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/File.imageset/File.pdf new file mode 100644 index 0000000000000000000000000000000000000000..16830f0a867f122690a5fe80154c5f3f8f2ab8f9 GIT binary patch literal 4290 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 A0RR91 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Contents.json new file mode 100644 index 000000000..2f29257d5 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Info Circle.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Info Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Info Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5f28551ca4530f7a64608371cb607000e6815d95 GIT binary patch literal 2036 zcmbVNOK;RL5Wf3Y%%xI`v`%ctb|O`k=$0Y`h_dBYaR^zrU9_7(lA^+|XPk}4?nC0? z!)o@+%r{Su4=&Em7lK>H1mw_t`N{x}kKyEmxpwXUGMVDpJJ;Tfx1bPQd97jWUA<%3 znftM6-0JlyEHBf4&A`4h!Sm@r9)tx+$v3@M5*Q9jLPE2Prld#0(6r3(*=S+7LK~68 z?g3b8sVWVISB14g!@>qVOQr-htmL_tvP|_#(ldN!OQG4THw~c_Uh<)A6HxgGN~s~b zP(d$-LQsQQgpdi0*%DiX$g4LEp-@$}?3P`#mVNy9b|{`#Rb|azwL_w+7O;?04`ng6 zBZ9fIvXt145{0}196cW@>RDdQrUdz#3L{OW61|ceaxt@|ke?i6^QJ*hab=`61}h)f zuzZib66DJlq9f4okOQ$rh;nWIyU2Oy*q=w9hJ~&W-V(u0A%!yWh6x?+8b+*bX$puC zaWpJ~ktC6bg-oJB!=9n0s3HkL#L+Oqh=K(AMCye20t=kS>EOuBV~zzNu;7J}g~DvH zrpjvUyL@6mNW(~}mJV>DzCAuKsX7STj{<}1-m6ZT@d$9_T2+c&Ig zzm@kZT;S594PFq8n>~Bkw%s_u)o0xFc(PAFzd6V*>Kiu$@7;P+pLX|f6{m?hAWSG` zlmgSr4c%SexB>iIvYP3ZT|2rKJ^F_vfERU-80Z;Fo*NI*GnBpEtT9yZ8LS}qS$215 zE1twZAd)cQWk{HOf&)2>i7)H1-gY++P49bm&2q48KWY9KjMhp6!t=rXK1t9Lgj4qr z5(Pdbk070wk0DcH!TcdEVRbYd`+Bo=J@egrbB5(O9J-x5g2T=FXkV0U)paBIgr@>$ Zmz!S>qo3aAx*w->L@5e(aPaEG`EP0wqXYl| literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Contents.json new file mode 100644 index 000000000..e809e2760 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Info.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Info.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Info.pdf new file mode 100644 index 0000000000000000000000000000000000000000..7c6d524b19c420ca7a9a16352058735db706d452 GIT binary patch literal 2037 zcmbW2-*3|}5XayBSKP~_4XH^S$Br#clUTDU>8Fn)H0n_ zg+U!y5Y!Y3sYOIy-O`Yn3aRampwA<^pc2GT2(|2i-LZ~+{P*p^FrT{}Ds!7rW93UX z6THOjNMWIo87yB}N+UVo(R2GJD?~0`Q6*?9pT-p`fjTp86wZZLOOf~LmIgbK33Olt zV5Pj8n4Bq{cqP>0`3cbxj5&~6M3n3Q7rAh!$W+xcjy#uBk+t-}OIPCvakqF~*LaP} zj2k6OysFc!O$hJ$P?7+vc)=g4@`z<8G_a!#T}@(%KIFuXzV7=GT*6a<^PBB2i_uRHbaNP|bhze{ Kot(V-aQz!-=cn=j literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Contents.json new file mode 100644 index 000000000..984e68d52 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Light Bulb.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Light Bulb.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Light Bulb.pdf new file mode 100644 index 0000000000000000000000000000000000000000..6b7f1512e46df1d753d4016c5f01abbb1a492115 GIT binary patch literal 3402 zcmZvfU2hvj6o&8jSIkYN7OCs`{*bClG^GduqNLnaTo`BD1UWXuE-L(bo-;e1-B7Hm za-N(yGjl%PGkNm%^_%BrOv7N5R>$9dAC!9WLcM%BOoto!ajfQRM-D&u9Fr%&?r7vHe_iz1ocJwxfTrf(;n`G7Qep%Vg z`j^x0FoZE+YqK(LG~Q_))cxSbP;$v`1?^>DW5(dUwoY|a#79U;?S{@W%;uP}@;XP8 zR2m~Y>8#wSlXlKQw6z?Rb+DZIE=>DSg4)BJjn;V;$CQkYmX*Qj#MTk-+S>$)*`;V8 zUi%VeU)j3iGt36(l2(4yCMF!jk&S&R5MxU=MTId%LRB~eETv5N!WeytoZXLBmtrF% zxEP(Rv(Ch7L(r1dtcznY2LD(!wio7Xae7$^5wBv^ymM9Kw9AlwhQzs|E^_B~(lk1g z3t?-wF@%T!=@KFJ&WTtoOYOd{g~R@rc5Strp;S>;g&9|=c|akP}j082JlF>krp z!;N`uNuxM*4JWR?5QmJ&(SipyzTNdHrCyWy6A;h$Z|Xba*!36V`Hiq7_H zMnf2~ykd3?R8R7frkpaDx1+U@j6s}nUKgoaN348JI4rTJFc*EQR$ix22?3RaJ43lA zAvR|(!4?)%_A?7c3e1^eP4#56Np(MKV$szG+j(6uCev2ZCDsxaKc*ZtX%oV2r1t8a z>j`GEqep8P%wi=4=0YUH3yWiPx^VgKotWBMm~!@Z24P&a`kzlKBx(*LR#|Q%B>OO* zz1_L8l;>F0$OxhE=UCO~RpLnro+QSBSiwTj1hQo!iT63vEn8tBsKDjU-D;Kl+o5Y- zFT4AN8B1s7P~?ohcu(P&a1pho>^hR_XMra-iygJwYJG9Hu)ghXSRg%wh`FSUrv5BV z&W*^bM6irLIZI`+fAJwo8I+Mqaik!O&Jhc-qGizw2&#=j(P+gcPkIBtN<@WqFm0r2 zV1}l$SmjJ>OC6PhWIG`-L?hBwQYs@o`Oj$kM-U-Q3D8ouVl{=_0!bTq9CG1)1WcjYz2ws)X7$Uql2J z=qJuqt>{~b(S=bYger$Hgky<>QP!oXHFq|n09DujS_h^$ZiQ*A8Q8RckEJj_KKMCYYn z*twE<@X_1FiC#A*Rgn|vl4EsEsKM*&DU}ogc>J*z|WXJ+-`-H(wtP$MZ?O z|CRSMpUp3S|1qh}+wI4xfgh)vyX~vvXZ2p{t$vm-h6mG(mTwnN*VF0v>0vjW6pf&+ zo4c#y;XEDKQJ&`)_;&jMQ&eU}t4F+`{Q2By;`?#M9xi zm1Fe$7cu%fIzMdh_S3__Upt%cUK5U|r{n$fOg+83c{T@SbA3FXm0Y+6c=PV=pNZ4g Vzk0S0=XxEUw|aQ;~v?N;n?BEg__`l&Wg0(xo@lLz*?P6`Qn4s3^a_<80!Dtq&{b z+j)Ctj;=4SPLVst5Ck+oelmcwGdMqIvEHOlCYQYU6zlu`0TjV?lIr?4mOEBl#y{IC zuHRq4>Sp;>b?i4oE`|eQx}4_Q;y*J9X(7A|Q0->TES4`_RWr-IazblB#YG4x5q3;- zw8o-eKsotE!GlspD9FfjX{B%uDwdhyCJ1XJWLt`BNopFh%S$LD5 zvZ)y@JkD^AEL)qC%1&ogu?Lomm@V#RhLnx+!YPVMSQI({nyE^&!Hgi4v>4HT@did zhFG0dWQJ?h(wco#0}|YML?K{O_0(D_2;)Y3idw)^lMe50hES|mnwnyXWRN~2saci! z12IrXN$wmPsVI~{R~4v`$b&S-Y4BWG6|79L9kfLz6`SimN#zIATze~Wgp|pmln?Cg z4XfE#mS%7quxT38;O(c>8=YrVXG*hMyshh|@8I@3%`%(Sh*sry)y$FwRYcwM%{z>H|IP!h_Eruews zP^geHSi|IJ)jW|d{uh5oWMRp^vXm0+vcoy?RoR!1&HZcD=QiFk0gmlAQ~CvKj50uY zJV;eZ2kMMy0UV&zD~HHZVCiH2@^pOr@^4nVlIJ|D-N#GhST??# zc84kG;^r8gvR?b_Obm(`t8F&n0eUBBi7w4!ZT8AK9lUY!t;LsFu-Q20O~u@teN?+i z{yyhite{Rdsxc*d+oCNg&q>*!y)AambsryWED}wgK4o8bPrmq4l#SY@KY$Ua~(r$S~%yBu6`5}hjNzNlFj z*hID&(=A^Sv8;|NdwbdIb>E?%2C7av+7 zJ!z*C980F7Hm9viMcQ*AL8oF%stk6vU`AV5bEMoz4F*+ZPxnb=uy1H=o*VgI_cj@A zOR%nWwsjL3azG@J(RQHVJe`KSu8+`#E2nlD#SR5RyWVn#kjAbnGc3!%?!bgFSZv}a zwDCpe4PpOES4LB-G#Xou0bR0fWO+fBk}6jyXI;5a<&tDy36g{Pk`iSsEY{^k^m-w? zZffGJMo;R&ndXefwe;Y!_g99b4>eNkI&i8(wjd!Xz7-~BV7sWSu*Gf->*^D>E}>ne ze%Xx!x|VBW=$7SZh(}xK|$|;JuSj`+{CgS5nUigqq z7@&!<7<$JthOtq=a0F>*b{QiO4bO~Uq8W&u?Qj4cLa3=@fYfeF(4}=Mdtqb{Jh8Br-M~~1G?Fh`QV6BaiH1u?+tMLx!~2E9&HEmVv{{zqD(IDEFw ztK1e`wa&=3%ScinmqpaUaDy8tFI0mxWcpJ~0e_>-(8#$1N!musc9%HO(eQ)1zxctx z7z65o^aq&rT%Ad@Wy~Bb79`b_iumARtQI3msr#qI#m92Sq-oO1RoJIQbUg&#hNOtY zjX7vD!a$5+seg*-e9Tncz|mfb>!T;r;G!2J?ej^((1D@{*B~UEWfXf$Bu^Yu$i)^~ z-)fdM(OZTGaQ4>&?{;G7q zJ|lx6pgu~SM&@+P+=^`hb8c+GUo{&h8!1%QI9@o?TBI8mPO3;23_52kpORA}|c7ic{GH{ajhkgAdjuE#l7$4|uCFY-TutajoB zvf4=sJdFb{giYhoPVE_wOd7^32{g%$az!+?O7INn|I8GGRpm%#J=_V#XnKk?tt=DU~B@%VK7xPPJ^-`+fFq-?H_$Fq`xE5VyL axBu+PzW!IVy+7A-c%!@N(W7sEdi5`+ptNZK literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Contents.json new file mode 100644 index 000000000..9cba2f2bf --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Mobile.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Mobile.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Mobile.pdf new file mode 100644 index 0000000000000000000000000000000000000000..96a96d6163bc238a2b24031e206349a0c6a0f966 GIT binary patch literal 5869 zcmcIo+m0JW5PhGo=$A+dQpVGBA1R7NHUuF+BpW0iA|8x)k}UEC)(#4MJ*T>>PnYdM zJjIbB?{RlsPS>fvJbL}|)l**%Md4lL4!`|gIQQ(Cd;Ywb_jmGVQCocV!@U1+`sf;f zw=(K@dYIR{V)b(V>wYuee*41RytRLAj>Vt&=gTU5T$R2&JF)Dha>AFobGxD|hoddb`Z$h0Gqfq1a)RNubs22RTD{U*hK$z?GCEpgT69WeQ+zDm7yIJPm*qF*0B*oD zXp%LVs(KhF=LvGjd|S5DP&X)>w2B@JE6g=um|z>o0k+LpuseEi7#;L#1EVm!MR5!n z*%U+B2sUPHTTEpS@70ts52i5+!_<7|GNe&-h%AFC-WIVLR1<4ZR^r3gCVhk=OYIG` zL2X`fx5b*(*Szcu*p$sw_kHUcj2oK1azbgOK3gOdXi(n-x5bF0>%K)m1Sj&KE_!5= zsL>@75fCIfLaPppL5+=z4w})$bg)ER4kCeqxNO9>P>ST$nVDont$Q^JS!)bZIvkbO zM`{NW_$p{%C@XkE^PoOmQ!E@*q~NCUWH zPe={r`UQ^#JR{ge%OJK_C?#arV)GxcB|v+ZJ(iGdC#(@Nd7{cVx9)ZlzC9B&aqns~sYD@-`y4D>v{tWHOE)?iM6^1FI$22$o zgbkPot!$(9bjsd1KFz*)|x5aKjCTs0i^gi*3fT$!(sz2-0F$ zgDUNInxY&kp&i`tqbqs5W8}(tBK&htPIM5_~5n?2$97aO$ zJnB^Q;i$GWc)={Hgue28pqy{fuoimgph|W)B?LmS^$|4lqv)iwFW5v{%lty25B{vm!yt77C|%pKU}HGY}1JqBsSTaGDOwO zEkmW8RzuD}7988E!L6mioo4D=xM)(p%2^Y#eeEploHyYhHO-r#C4*Lj*0eYlK{Fi< zZ=o2h+LREK%|dl8#A#REcpuS?tELO5GF@{y!Qz7|s>?uIJk%ygFMC#RiF7$?*vP5F zv%q!PWUzImb`8ksR&EAd?tDr|YSGfGNhMoUhG=h-qakL3iIsy3vNG0$dq}vwfo&X+ zKv*m|cr@LOJx~=UBhzLP_7=`IBZ<+X>E272nfpI`rBWb=n9Ds4XP$eTz8Yd`i~ ziQ`ewi`gUuLv#oGxV88Rf)=o8DBhHY`vsK;)?rGglGp>~I=^uDde78k+2h5^WT5WZuNToVOHSB`R;!G;_%tM(@QE6=X(_{ zk7?`WH8NScosWl451aYu!< z2DdKxxjB5oTz?h+5s0ybXES3-52!TN6ptQ#^V6$;0kP(X`~Uy| literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Contents.json new file mode 100644 index 000000000..1513a9cc4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Moon.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Moon.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Moon.pdf new file mode 100644 index 0000000000000000000000000000000000000000..53c54c2293d27aca41e2497025e485a718c811cd GIT binary patch literal 1738 zcmZXVO>Yx15Qgvm6~0uWNH`wb+$sD^5W$aGNKe|tNX9tl-5t5>SxbX+g+8P${q8?+qS#e-D(fGELOvA+pach zanb%-H|_G(nLht`{Hqz%4@JiAm$uX9N!`_NWV{bKlCGrL%qJ_Xo1y7cFxlsnqb4%U z;+)kR<&CqE7|7MY1mpBh!If^j}Etm>wI8qJSfHYynk$=fhH%_W6o zEr?HIEtgy@6NjL^u|CB_x>3<&mzW3)@iIFE+L2Ejyg6R>f-!!UVI( zC>rWnlY;l&0zD9?QMalpUn}3ttelRVvqwtggSAOhm=vnD&!|y=E>r%`j+18~Z*tDb zk%m>0fT9m5M2|AWgiN^d0}PC^#Uysg<$@%{1iuO4y-T4WFORwJAK^`eaT5hW=wOR@5FJ-C_6)g{7-EmAqx|5rlOuE_do_a#i-Uxi@F|%z z?=`~Zz=ITLZbpqlcT$#s`er*a(Zz%cfMQAsN6}<1;|%~&W(kaJ0Ry@V&Bex(INU1` z)D5_!Vu#z8B8|<=wsb5C^08=C^kQbHkA4x(5g|MhhDfD3DA*wIhUY>exM(PzC_;{X zRLef2Gx4qLHuC`#BM|3nq3#!9)@n(I6RCTFfsi!#S z{ZE{w2l)>mN1oz6Po==22Am5&U+q?R{muQOzqjqRvRc%k*78?JX3rXUTzFmko$e~~ z$g`}9h!Sq`K5`EZl25p~`&I$HI-%WmwZ3b&s@&e|3&`g43b`Y}F5WVlO;Ke{vz!b^hClCZ^?4~H%qOQ|h(1W_(I4)$Vm6RgwukV{#lDm#C ztq%6;i61j>-aIZZZm!>6TAhZ$Dx(g+{XQu5>Xmx^dYJZi{B>|^eDlM!zdwIe1n`ze zozBN;`#5Z_r@tP?>Gs<<>gwJ4+jtuO9IQ6-QKmgy_NUcvg;Fp^S*v3)AviTYE>rus z{%{)iL((QXo`f9gq{kuX5>g?%0z)6?bjYD(rxu9X)DctLdS0gztg{%`Rts(1vTKLN zA!{3xiA7y@usmOFfmXXNV2^HDttYnZ+M#jyID8oP!_WVlWTRcll+1tPm{K&QC>t~? zlzdW;ARgI98wD&WhN2=9<*j`JC7+AStEuA~j!rpjuE zjS4h8h}NC;V8Q5^a!FnZCc6PM_|c>NxH%BDD%zz~N|bGZ5iw>Ru^e{@rD9RLY>f8} zH22I%7wk<|OC~`sPFceMB z=vfh!^sIG0N9I|?$HJ9ylG;k83%HW=4Dxi=J;E|fLf@wK2ej0qX?-LuU&CH^T+46W znvDk7PVZn~l`pPDYjvPPEOxA(fH{?a^zdvQAfOdWq7aXf#CuJ7on}Y1`cI9k%0x&N zi{nnNYFex?t13B^9GuUFnIMfXJekh|5p`kfB2)(kL}Jw}dZ>}X;*H6Wx+y8JBds8I zM%daib%e`95iW?>C}K*%)L>v7A~siSh6U#)ZE%ygf7uIAqpEH2M6H9F`%H!p3GRd9 zU~SAjWtanFI7v_l;g)bb&7MgKMW2%k2eIy<_-jAt#>fV1?wuEC(i@ddhW9WtT-3+;<5=|C2%g%IvN~q z9!HU+(!<6%>QP5$G7*p(L1^cEk8>QL)cGjv`S8)tj&J#Gp{5NZ%`w75IyYFfSb_pp6aovz z`2egk&0FK;z%nwI1L2{A@QSdi8Zbl(7w*LcGDp=F(2*__KH#1o;~i_tnuEC;LyX0#|=q7%BkmVe`)Y_7jYxGp_U4A!iFJHaQ zcW|6qJJ?3GgI-{ElG!x64%X&^SJ$uP-IcEz^&ZhK9elr-FC%1$`d!3#7aCVyIuJHs3$oAymZ~+^V+E)!`H7+Gp{ffUH)+ z3(smLPVm$>ToS+9p0~Th{nM$RkJE?2s5H#!^IwJ6Y8WTr`hnldliGI(w)GSu=TH;= z^ic#q{1U>+@C?FP(I%dc+lSqB9JqSlU4xDnr^Dm)QoVS%dpVP`xjh`tiW3%sH}4+) XnGn6)G`GjIq(itH4i^{S{Pgx;JQMh9 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Contents.json new file mode 100644 index 000000000..2c3a3e7f0 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Off.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Off.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Off.pdf new file mode 100644 index 0000000000000000000000000000000000000000..bc78536c57982c72c28be2186e95cf528eb30e19 GIT binary patch literal 1792 zcmZuyO>fgc5WVlOm`kM=shgesUa6`?Q;HBEO3JO`U>vs%YHWyIRQUDGI`-J1>>*k| zzj-tBc0D<|zPvg`8H7Mk(0uzY0M5?f{9IJ^IzI|M#}^-}`o4PrL*Od2+HO}BTd}yT zer?KX_4WdmH}j{m6+Z<^)h|%v=9G7{cg`wh(nKn^QzX-P)0VXe(t30z0{T&TE230r zqBb)yGS5lpw2ltu&`@1Tp@UwMy{?7FIi|c(DN*Ql58REh^-WzeWS0vc&jiaNqpkhl)Y20$$np<08biZv>7 zQ%i$MD^HNMS}XEW=ccVzPznn0QF#wYhha>1liu!6I7#D`CRs+fs2n)3vaHi+dVShh zK$-dlOlPDNsH6=cdOgu{)!L{KMv1<}0b&gbWgb^XRVU|^N?bpsrwmcWaM&oJN~`31 zlLkkUjEOp=VD^n@T46*tGq^9>so+&_dvqxnN`n%0G)UGNnWFVMAxamc&iBpaa_XoC|XyT2f?e-ZX=B;8yv}%UQHF^fix%zyXYug87W`=H)9E zCX4a{ZAzAWiW(i#nbT;&U4$l4O4(F?V_e#{_v&h40 zm_*~)$`fio&JZ2)G_wrTlv}*6>!xer_A5<2T8l5ge^juzF7B%V_*kts#YOWBx07#E zuRL_7?`>3CRc-UME2|drTwM)v%ckzCnlk30I)c~5jxcZoG#kAc;*q>~zgbhMkULnx zm}l8MQ7pcwza?a*Oh5IihY(C?sT zh;I8KgxZo7c`=KI(hHU~;a`@+DX`lWo5yM=^69<1Bs-4VW?P-W@n(IpH)XMEnhtWq cy}^r{&7X>@@BgccUDvmRE+}zy^ybsmUyN*b+yDRo literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Contents.json new file mode 100644 index 000000000..577b64507 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Paste.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Paste.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Paste.pdf new file mode 100644 index 0000000000000000000000000000000000000000..458b89fbf841e410e036d8d4b831dff54502815a GIT binary patch literal 3642 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 Kd-mNgZ~q6Y3-pQr literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Contents.json new file mode 100644 index 000000000..74c89669b --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Plus.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Plus.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Plus.pdf new file mode 100644 index 0000000000000000000000000000000000000000..4c70ce45f8b3de94ad7f0d997e5328a6db850b53 GIT binary patch literal 1411 zcmZXUQE!_t5Xax|Q`}3Xc2WTY#voOd)?}TgZCXb6R_%ciH)Tp-13Gp6^g9##?5uu> zoS*Hx|DFBkY_q<-6p;cDnBef^Cm>#3;q^7>erx_h8uIv)?sxMeW&~@qYnn&h93Won zKV7Tq_cyq@3;(qf{00#v%fQ4=IByl?u*!iSH-Ifw5k}oY!w||dQt|eSZE7=-?5;y3Tm|d z$%0;R%K~}K_Fgi#J7B@3@HN?I!ixBQTi^~e<3u)6flN4GaI3sX9dgewU@V6jCwiTl zpIZx$@bCtD_zK1_)(y@&#wABf(d%PF1)zHtnr;Nte4sM!}7)px*_Z!4th4^E) zC8=mCsL|zF4Nr7dywX1r2_h9IkxYRTC-jA{nz`8zyVIl3qkez{6&&A(`NcxYOd?@B zM1so<>8oHzMmo*#s4S=z|Dlp@=>&;HlGals$l4CgW7F;R2s~aeUp|-3I4|W0QC4tv_U_B=KV1(l#{d8T literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/Contents.json new file mode 100644 index 000000000..0abda80de --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "QR code.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/QR code.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/QR code.pdf new file mode 100644 index 0000000000000000000000000000000000000000..f87dcf2569a77529478d64097a65e47944db2824 GIT binary patch literal 6238 zcmcgxO|KI-6y49S@CFGMnbeAy~pUmo9(U4 z=7nhm@kBioMcVr+*Hq?mkiSfZ}avBU7e`D`Vw z9EWYkqimbE(^#?IV+916zRv|abEd(-W^ zpZ?Fv$bBRevPA8+%l)wU%8^Vmirhn<81XG?+fHFM=e!cv3h&1VVrKhkse1;IPQ<|l zJE)p+Lo`JWi!lgEgmaTpaZ}sbkwi5{MOjKT?68jr46K=M}?h zG|AE-a|&go`15@YZbA%r}nb~3$TAK*OQP~Q~OV++f zwMc!-#!xA)ddV=b)>>Q$Xv`X<6=P^5X;((2tJRA9tL&{wp;Qf2&7o@4d|hG> zly4GmbYdVS98?ZeE6Tu~u&01reo_z`;=&e?3yc|5%8&^_Ah;(6@+!r>?BWz*Hlr#D z)G7GY8ii5ul;CLQl0bfX^&r&LdujL&=asRayiFNu>-r&O?;H*+0I6dp0=*wBKn+bp zvX<0BMwM0vxv8l`KSoDJ$hZNL9dnEX)m>3R&IX*ZXle{D1?)QF6yc{7aVoMgj1K)c z!jR;=2jpSqP@oX9v$U(ndV{SX*)n2Wf|)MT)Iwc!;u)%23=t&-m8KQiha5}^XVdt1s2va$70=c67Bp*1*m8m5; zH50NL=Sz0wywcQWoy8F@jMn0;*nB`)Bm7?bO3GnV8nJ7D7fVcRUzJQEr=S*LhA25L z6AVhe6x8ync9s0Iby6klgH)69^;1uDAJaUkhv;2455QVwoD2=slxc{YM?fwC4b|oW zbia90@2GiDP~1GJ_tZRKByOGroxayR8S7m%54iBMdGgZjWrNyJM9Z0)XK6-q!yC|} zyX+odVEN1T0UD`)N>kPDh9cO@1_I{pcM#B0YurK!oT zCp~h>oGn<}8#5MuEVG-HT!hLSu2to?Dr%rDLR|e4NCg#og?|iDz*}M%l=LwqX;#}x zIk0_FH0*{Hm-6>BdWmubPWktXv#7*WZrix|Xd%M!4_TTfr6xE=pl+eK(*L2KkRw1^ zO+fqTgUKm1!Br}_4CxRx0ZVzC$yB8#0AWA6N;r%mQ4@x=nlLELsi3ANfZDFY#B81L zHTxjEu6z~#=a`5}aO5;Z?-_`&Ruilo2QUF7p=lFNEg{)40%{r-afz}MAgv~`54e+f z8rRe$!m%_!;6yniR?7}4Y-*CrVF{MlK&lh4{c?q1h^lAQqnesbmd;sqTvd~EsHutC zRn&y76E$HUq?(kkx;kr2G*ly}A&&5uXddZWu8Lbc5>R~T6vtH|5LbnU*k%n@-!xPs z0H_L)ij;5)M^u=H<1P%P^0P3R!+C1i3{|o4oyFlvLFH9Wk7_~`oEleY_N>ShA*+3X zHX&jIArOt?*$-e%43xu4N|t`{XQH#TRVbI8CRhu@L9ot*sHDU#qSHn$nVZgph*Nwf zM9dJ%8zvIvw_+TiO^BG9M2HmBgoq(6L=1`$F(hdQ)QC>Xf$fu`VK=0>l)tT)=qb3q z^R`D}djDM>i*YN6{8o(jM0rDAf3@EqPDk_l7rZIsv;O(7-)FOaxp_NR;D`D8X7lv$ z!Mv6iOnw=0$WZwh`PNptnvaL~ciZ`B=+*kFF8A!PKh1mWNKe)ce7U&;W3GeRRg9l&#_~IX^H`sIl literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Contents.json new file mode 100644 index 000000000..bf72a880c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Question Mark Circle-1.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Question Mark Circle-1.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Question Mark Circle-1.pdf new file mode 100644 index 0000000000000000000000000000000000000000..41f69003c874a93f5fff7e762c71cfd8e6f418dc GIT binary patch literal 3131 zcmb7G%dQ(m5Z(7z^d?fW$hfQDEk%*Yy#ygZTpV^03p00eW8??e4hnpIPI+dk+x8+b z3#)ymy6V((>e<8n+n3ZOrAQmS|NRf8^{ZF<^=mck9{I1bEx!11*gc&-Y6o!1QpeL_ zSZ&qfe)xOc56kb~=(~6Azy7HHQq-CAqs@GHDJOYHT^NP%ZaVebdbN?8lpXt>B0Fo$ z^CjF7Fmygz@4PNua4E#7-7Ftxc|m$5m>AnAGF|kRT+{-RpOyH|g_NV$6%rnO!$ZK0 z`dF=q<*jlvQNhHT_#lXA>lIQrMMJ<%0}4MYL}&S1UmO301@pZ%(WV7yn1iOfGrL$F11{JKuLgGrrL?z6K4+5e(1gs>R ziVON84R#;>7E`faql*J&pFmD9>U=37S~Me3h^}x~ zj#4z=6QoC3S!=9mq)|9Bd2+UA3$s|KM0gKLfjiO)- z5xm5%@3Kaey$jiAJx0I=Xl$?$iz5z%v!VD1sX&P{LtQQ=M*>0_!wFf3RbQx-f@J07 zErybK;X0csgODJNuebhlJBt67C}DsCNhuTIVBscwcgTP(WPpT{3t4b*AV?`EV8tNL z0R+z;CWs?*6xr1Y5uZ6v*Kru*J-5b489Z`|EtbnFV7ih{9!Nu*FZ!D&JPMM`jqh9{`x?aeL=<)x8bD6 zbRK#rFyV0;$`BNBL3ngb;(|4Y>sO+H?@jg^Gn2Sb5ph8{WD_gFx+>^5Cf$yh>LG_yZz~?-~Wb%5zpe+fBqcw;$ihPOu$dW<9hXG|5?AU zYhQIzK7(}&m^CejbOs+*2Vgo(P_wl%B-`xbhxH?< zYW85MXFGTMPq<4r{Et8yO_-XECU)>B2CL(DtJ7+;f4aQ-`7nG?Mkh6;v7 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Contents.json new file mode 100644 index 000000000..8a4468bfe --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Refresh.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Refresh.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Refresh.pdf new file mode 100644 index 0000000000000000000000000000000000000000..b8bf5bc3349f11fde9baaf6f8316c7e6691b5450 GIT binary patch literal 1812 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 W|AKJ${3_SMXQ_R8^X4~y`sTlH=4-P6 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/Contents.json new file mode 100644 index 000000000..f8d3017cd --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "MediumSun.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/MediumSun.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/MediumSun.pdf new file mode 100644 index 0000000000000000000000000000000000000000..80dda54e5b59e9848fc6a38ca8cfcd8c867c532b GIT binary patch literal 3647 zcmZWs%Z}SN6y579xEUZR5SedEKoFprX^NsPI(51Wx^Okhj0-M3UOaGnlb>c=tq zsFewLvZK{%-wl26L-M`>hsG}WV0BOx@{8*P*Cn3seU7(lK-Z66M;GC|q;QK}Ek&RS z^?C123d#r=C51$*kYt^@7A&pp8Ze*&?xUuV5!6xyn!2aX_Rd=~Mk*!-J&Xf}W&7l8 z!rYASwKv{c<$4#xFrerLN+EhZHm+0Wd!sQfOQ0Q-!^C$0gVugP65EeD4rWv>WD{b0 zK#QyChrt=A)zrB@nbEsJ8AC&jI-(RkM3g5`Qnrs{NS>|O)xfp1hLUY>v3F4X4tr+| zCMH851)=fkT~!iICB zpfDy>ndf9fqIOWb_KwQrK_%x(lK~^6Hj)dGEintm#AosL6q9Gw`oKG5w5TOE&O-6V z6R(yH19|hf0(L^Jm@DEwP*Lrz^b5-tqU!8icyRf%M>Iax_QHqL$&)L?z86&FKXQ6i;W3L#BCu_{#sSaGDL z8_6gAQP()mxgUwPub9z2NXLbMdeVR+hn<1Vn5QH0DuktB4_+EE%w}Y|nD^>_IfZV-L$+Y~tXo8S0 znkN>)ud?(GXIuwsak9nERx76CfWut;qz2*!!I+FAtV*QHv5So$R0Eel`=u=G4*its z1#7x4(Ho@r6+S6~BC8EL5mjgfg*B#W69=xiO6RCfR7*e{Tu}u9t1#9SbWB()r4+<# zz(unpnsi&U3dE(9`UFHN*fyknjq6W{Bur_|X zxomdF$LFqJPxI#vSBx&J39DKRxC$u1<%hc^KdFO2prYrH)3~``K?YaFD+s)P4dFg4 z(B-t*?&ecRtM|hl#_{TW+|RGotL?+%8=@#dYzA&9hl$rLgLds?JVYeFKCjw#dxqe{ zsOPy})vJ##U)|oke#T8yib>P>$7eqsv2jJv^(Yi+7H_CcNWpnLTxn8@1Zi!_*CmeG`(2 z9EnZiQjEzHNTJcu8fOI6Ihvqp#c<-r1*dbMm5md;M(d-YPJv@W(#cY6f=}5-dQdQc zckdHGymjn^W1O>D>l>#Rm`$gXyIHcA`PDcfK$4BHix zw0*;dqeHjWWCZhUOhB{Nq$^TlOKB<(C7MgvDc4{!;7u-4jv+B*>zuU5C0!BQL>;|J zKq^m5buh`$g@R&wp$oT6dyIT>p>2$E@s@k)8ta^hI7625bRbr%6g^{Fsw>f)JxlB* zpl>Wk?HxL}2#c6`WD$}~N|m3%G=?Ril478WEQQb;Pe!&BQ0|X)EE*~jCI5^oQ+ZJ| zAf2LNX%OZ?+AR%Q8ks>@ax4>E`YnDJaGMG^4#r>>HmFWdhoSoTgBsLtN;c@S9@kwe zYjfVQY_+Z{78Tr9Z~Jl>#?wR}e#a`t)4u=b&z{=b{e8axZ~D8#{?+)EK5YG|O_4n} zFWYi5j7qGYcKtMdId=U-vg~(@yX$c{^#dZxreDF^{Sg@X1v>j42voll?JtKrNF~W& zSL0ldU%=)6>7Rg{c?uVvB*Cc$+!DXupY{*q{U!D5vHz$vMK$LtzZ5*inE)>jV|?YI zp+XiqFCgsJZ>`wj{(fWS6SQ6u1HLIMbUN-25B*W$!`c3PgK|8X#>f6CJvrPxor}`$ h#_>dwa4B&6?(lC9_2mP)Kb}fD96772s~_LK{tp?6mdOAB literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Contents.json new file mode 100644 index 000000000..097be5b11 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Swap Vertical.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Swap Vertical.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Swap Vertical.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ebe9d127ce0451ad6c83ba71f78339cad1c59bf9 GIT binary patch literal 1945 zcmZuyO^?$s5WV|X__7ip;m-Km5<-GqKnM^^mmA_xvSBIeCeRcF{Cb{K$H{)=l)lc4 zXWo0BoSdJ%e9S5c!IEVE<-3sb$rJhXsc5^){8Q*9zIxksSBG!X09@y&;jnKv*J5?n z{@yn2`qguJda?Y~4C1F?MdKrBdU;&m?*A_u?X+yJ=hPZkUxua=Mgr%)PVN9E?PE%kS*74Okz7K? zYSJFilu9Z&c7*^_MwwF^kqwf9H((A`jtt+xiV$;h6)bmn#}zyAO`sCAfUM(5 z!THE=3+QDNJb1|GA5ma)BxXK zW;?lwpCwdytf@G}Ph40Pb&R>y1q6wGgiUY*juJpva_kxYLw_LG2HaO=67IyYrR)-kAw-j7MiFuz6uw8U z0yJgbj?f3$LSzPV}(@UFewZl3pl z!8MCYdBC9_I1hfhIc#?Q)y>pD`}V6K8N_kIaZ2x;aT0KO7#1A==qiMbdJ|%k?m&4% z-HO5rz72UlCm!~j?XKO6tlsN0(D7jCuiJ<6!S?duk(AZC?+-E$JQBRR*#2wL{rC~x R><{BO9JCQ9CokT={10`dm%ac1 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Contents.json new file mode 100644 index 000000000..8bc518e6a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Twitter.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Twitter.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Twitter.pdf new file mode 100644 index 0000000000000000000000000000000000000000..13f308ec487afb825c9d0099e91055d83bbda519 GIT binary patch literal 1859 zcmZvdNpBlR5QXpaEBa!w4nFRzbp&%cS6)I_6O-km&;X2+M^ay>}$ zTBO(PBzTb=dvQ2{R;e+&?t4u!C3g-rRq62&RC;JBxaFB^_L@~Ac4REQ)C7CY*s04t zDDnFVSq_gdO<3Iy>LZl|ls$Ng&jFgq=Ub7Q5%(a8_!e_06&AtA+%-en*RHJ;ta3!c zW=L&uLMkE&{6K1vf?qVhq^JQ_6ij{TS@GjjjgcafZ@EdePttPMhM)SBDJ_9TiPE~6 zN2x?gUSbPbCn}O+qxe*^P{Ne2X=(*bYlw&yAskXqhO|yb3t2T~0m)GctwLo_S3;~{ zO(j$lvZN48aMi=Dgm6Ndui7KcG+iF7z#t5Ejud)sN}X(4K&mNU=p`dYDsILYcx_rwsB_^w1+UgC0asRd}WTaig_m=L(7%##4HRh-pO}n3}RqV zkJKjgG1pFuiAd!<=1spP_H-XJr`(9csM*Yd(eTj4mWg?i)U5*u*c)xR&t2&cJV3SP z!h91k1yQyVET`TIb(Q0?uq^`FscvJ`Np6;cvI29~F(d}ubj;AO3I3mBu^c`RpN94D z%V78J;g}sRpB=gTi)c%6Jcvxe=}^wTS+6(yo%{G3hm&Xa>py>vZg#b}86SY3#_QGM z-R7(N$n-qDgJ%^TYdb`mkGsv6?Q+~XJI(Wla2K2Peq58$?(zY=T5Q1_`!GRg*V~}u zRiFK^x`wK=3g+&R=VJ2(UwOuV2XYpP)jEr01@4XsPlaDB_KVxi&12WE+ws%DZV&h6 z+h12`RCd4*kFfIgxb+cIcs_#I(Dn>sYMxlxC3_0hljDB7Sly1>fuFhA_m{}=a<{n~ sU%8j7>sR-p%;uZT-dVwuz_Smle@EC)KX;4mekw;;&f&$2Z-0LO9~@DH)Bpeg literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Contents.json new file mode 100644 index 000000000..5e974e19c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Wallet.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Wallet.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Wallet.pdf new file mode 100644 index 0000000000000000000000000000000000000000..d137229edec08608a9ac5a7d58f8c5c43d753a29 GIT binary patch literal 2058 zcmZXV-EJH=42AFY6udEz6v(Woe*r;&#%_wDE$VK17vy3yo;X|V?zB6bBJI=nXjVf_ z;xS;zpGAs1B&D1CyEiYmi%KzR8bAE0h+e*=SFhA?dMJM?v*w#$hSTHa6IsA**)?6x z!|tdycf&vXe%Su_nr`2&|LQ08x8hFEAL(WBLRPE)v9p$$xJ%wdW2iqiOW7uisXr<4 zk~<%rHI|NzF}6keAP%w(g8IQ=soNbqL zwifpDDN$o3tVZJqF4xe6n3>?wLkH`!queo0!~zHb1$LA=cF9Ee6BM!CXv@W)K#y1> zhkW%{jU9}2#?E$x?Ko)stl~pL!8l00j;|=<5^_g;67;N`*QTUiMYw9t@F!{s>Q(VF z>naTHuJVUkewa$##J>;;qi>az>K@dmQly-GOc6Eo(O8{Pbk?0S$=J}~L8Z=lpW})J zv=*|o1f8H=%p@d0ITv)%L>NlJ(W9%xQ$~6rWlQZqL397q&?+=VOvKAMmR3QMXz@HZ zO|Wbn8ci=9+2m|&rDuZ&h-^6;i(Ijxa88whY=qH?KDwS-rrH5yOc zn|WMOFR7}KIoUca0_S9FVgg(Km>%a-nQ)x>O$qx_St(*%WIig?9#x5+ge4R)xX2)y zP4;DEDp?g#80MsOdxA36lUw?x9ViHSnIcFC9!*mF3whbjW@nvl5D2YgQUFRBt%o5I zB*O`R0%eS6f7Lj`aYz=IlpGZ@xdB#>+(S-sAqqxB27WzXsae?;eK=ejOh6yVv6vde^2`hL*!}vA5OYX**2g z=W{XXU9RILU!6@!Q>HcNibPHvMuQJ}OO7U0<{En}YY&6L9@l)4U=)PW7{hvwVWe zTl55BV!zoHH7fVDVZfjN5WV|X%%xI`v`+k;NL3}er3e9H*>bBmgsj^x+D%}SqQb9doW$d_J@DZ} zW@~0N5-0~}LPEVyu4G4(u5MVtCnwAyFUwLG z*w4V68||#hq2RfZvM>+=k9Lk+396aprFITklAWE|O>7CGsKGT#k-Qi~>}H_i+DK8B zkV2?vm!uF>V-|yC4GRKOw#1eoiW*#_6w|bq1*g0Lm!f}l? zkj1ba5iGc{(%KTY11GM`VNq}!>>P|W(B%vYH7%4=xtoEOs}N$ao7fUWQG;u=8%PB1 zePXj*K8;FHC|^`ZU@^30NNi%Wm_tl!7WIFNjEy=r|DRi)nnjp+n)Xa_Wn5u3Bru&Y z!L61;*>wDfqh@4A6w?Hcc;p`w#NLg^RzS`0m=3h#SqbU|2+gssIDkkJL@ek_(jyBh zCz)xLbS9|AMiwy&t?!wPVg=SxIb$touC3Hcfxs3X%S#SIMh;X%9tlk@an(Rtou@)X zDcr<|9x(_x5K^I_$p7ZWaFW9n-HrEeysX2$JYM2Lm5%OkO)%c= z*~_MB`wp%@<6Vy<`}Fghhip~d`U!aNH{0sGeSquK1Jn${#$u*fWLo>Ky+72xgYcTH zC%R?Z^uED};VFsWsyZMBW`br9PJrkk%HD1_C>25mYlv}{?LGR6XZkxtW=z=eGp3MW zM*&mf%c`$-?d@aNhl9UiIXE^pPWXZ~Mj1eO8X|{b1`R<9b%sHZ(1m*nnP-l|7Pxbd z9i2&z{h`|K{DFntdvk&1IPTiLKY`=z=432Nwr<-VLc&9Vv#aedkLrgPx;pejI-(Gk K9UZ;;aQPeX$*1)I literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Contents.json new file mode 100644 index 000000000..3cdb76cc7 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Web.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Web.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Web.pdf new file mode 100644 index 0000000000000000000000000000000000000000..771c43b130b45f3ec360d7f7ba6a44e00e4d168c GIT binary patch literal 5273 zcmZvgTaO#Z5ryC9SImn5JAh~VegO;vu@nbE5=2?&&G5sTqNNQaGFh$zC%-=5>7HrM zQl|94J?!r4sycP5W?sF0^W9f=$e?5Qm&2&7y)1Q;u<9B~Kp58xy zm_6XVR$ZQ-jt`%vyEn)GJRXksfBbfS{r�!)5ySWEayuv)R6UHNJiR+xY45>AG_) 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/Contents.json new file mode 100644 index 000000000..06050ad52 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "iOS.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/iOS.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/iOS.pdf new file mode 100644 index 0000000000000000000000000000000000000000..626a83b6f52239e7d70a5ebd5d0f2abe5ff6acda GIT binary patch literal 2401 zcmb7`&2C#q42AdiDP|KOS$H&@;rszXfW~f$qAi*_-348!@=f9*mRd+} z7e((vxH=*^!6m>; zv)b*q^YUg|T+Dx8ujb3|Ub^!)_rI-n(_fSLFdi4~Ue1nh$KRrll3NT;qOYa47~SgT zIkEPd&KiHPqUR6JJDAj;{JvYipT|dTSx7 zTTRuMsFE63sWrBaRSGc-D~&bw=!)+t_ompyTv{pk6`u=1pu~q(lmNv`>9JNrcw%yy zk~EFjA*jTLA6RNRm|yBj1heWQ#gN)+NCBi%La1aexi*z?UeKypz;bMbYKo8Aaxp91 zdJ&K;0-bOmB}=#Sst*dQhQY5wN98>D>#!%<6!XV?uBH#uyJ)FXOQ9QOxk`&cH6s6{8Hw$vlTfhh9m1RkYj$O>LHh!r?tm$c*( z9LkQ!p`v4a#kyx$*U(Uu9Z_pAJHjZ+v(9wiG1KPGkZfocvisCR6?JD+Msr1miji3w zP|<+ut*Kp0kvu?DK@fCIE+HC(+6!fvkULZu6hckXaYf5$EEhW!8PNb_Q&4W{230}d z3KUA}P3}P^U0BRQ6-T@5g$Q9l4Fb?7y@XF1VW&z}Qd&(4X{rq6$WA*!lr-Uv@<$gL zFxpvTA-e%VcCcDW6G9USCr=4+$U7j2I%-IW8e+vOgAK37uw-b&m8LN6kjP6^Vp~s; ziB#dNgaZ`Pn@;hOsmsVkt+BzkE)jcp$klp8rzL4Ovb14NQ+Tb^?qJ+ zqTSke;OpfU%pvdr-MiZjI^Ow*wwKZbBr}p;r5J2tQ>9eEZP5@#fY?D3PZZyPo8}H^Q$k_?(aze literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/Contents.json new file mode 100644 index 000000000..120417a64 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "filename" : "iconAdd.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/iconAdd.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Add.imageset/iconAdd.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a9994d19c8fdca9198e6bb9d5ddec3cdab46d9e5 GIT binary patch literal 1634 zcmZWq!ET%|5WUY=%w?tI5Ws+8SBfGvyG>QKRntvxQ4iGXY^YdhfmCU~K4UOrvv61q z&-ToF&$Gkoes^~zf*e3#gw4-ifOvh4H#eZ`gL#G6$HULMKK9R;5V$wHy1v!L3BsNJ zTPnT(aEsdq|4nu92SgAJ4@OgP#nEz&m(us)lUJC*mnOfehqY=Iaa{D1%rU z1}H?3WoaxD^dY;b=%@|zDX1Kl1)Drs%QYR1;!LD5W;*AkzF$9&JC{|#=^XdI=@bqs(@O-t}<8|aM2&!TCB}A7K@{NypPqn zY)sr$Wk>;c8)HV6?KZ}|;CzV_cow-zo<}|-dj&pk+hq{ySi@r4j+HeT%jktFIrvqD9!w^&=-9ui`(WEA6@TruQ)0$nsV)R z*Sxe!cW7qUly2M9J(cLt46X_M{_nRo#gCebdc)1|;Gq|ODi1^zje UKYR^}wjbn(RK&1az5jam22wdy$^ZZW literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/Contents.json new file mode 100644 index 000000000..68e649279 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "socialIconApple.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/socialIconApple.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Apple.imageset/socialIconApple.pdf new file mode 100644 index 0000000000000000000000000000000000000000..211b3ec43b22e01fa1328941c34a62a485b7f653 GIT binary patch literal 1447 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/Contents.json new file mode 100644 index 000000000..d10acf840 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconArrowRight.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/iconArrowRight.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/iconArrowRight.pdf new file mode 100644 index 0000000000000000000000000000000000000000..fe634ac12a21576873e14b26050837ff6422c75c GIT binary patch literal 1490 zcmZWp%We}f6y5tP?xs?^sAG@E*S1tuqA5iP5G7?-u?Weu4N7JpGew23=iGTF#f!)} zakl>F6f*vdr$zxnHvk#j!QYB%qpdre< zdPc&wPj+%tAA3U44m?Su`iNy`IA1o)ZS{C;`m!$`6xv;NZ6LqI9y^Bs_Xj=N-l!ZQ zhdkv>P|E*%l^8M{y|NaLUqRRjBh>7dn{BaIQoZ-rkmIzjcEuT;Zq{d=D6>UXH6(;v bd1rTfgc5WVlOm`kPhP-nkCq^c54DMElKDYuG4aNIU1u_1O*;n(+#y>=4VL$ZE5 zA8+2y?8)u*&ABRq5Q-!<-+u_AiwnBE6ji#|zByQ2Bs;aAy;UqThKUnIxP`LvtP^msNQ<#z8mfzzffYaHt+jdK(V>yuB8wn7#u z1{)Yt!G{=;)hX?z%82(swCc?VKkKO!Oeq+xG|Yn6PJ7Cbu@nn!f=MZRS_i}#X(W3( zPOe-aWr_ek05<@=O!#0hX_>qwS41hDcRiG_Bq03R09QMfUkYES6b()@s3iHqM5IVV zGzB#QIh~@4V^(KDMd2z31_M8U8=)XAS7wGXY_OCe!z!Uz7AL#HBa4~i*&{W<6gR+f zvQ8{8*CUI-dXBD;rxg7ut|vPLBS9s=H--oo1!t-I(t=I6px(|!k9fWqAz4J@l4U9x zM4J}DaXTU00cMN~F~HR-6SRX>-*Q=Er`Rted}A)MdV9)7A)2tpahe958*QQT0bPZ61H5w#9_)XyaDod5fGBc8;AsKpn-1DL0497UeGVML=- z(}3Cu#o*4~)OFLfbpH*5j5WJm?y9;Y2ttbteX3ULhs& zcV*QQKNe%Sc~f^t(GtHDBlz{t&x(^jR!DmAnlO*)m6?55uRxW!f(4CP=FKw*t4wwu zs6CE^DL#nAncAZ&2gmucTW*@iW7n5m^&lh#F*F4Kl6MZ%05~snX1}9)g76Of10@R~ zcLC@gY$f7pSO*xFdB!N_1jaDlrO3MFl1d5*gkCG3*fxw6P*9_6gdYIm-Cd{zEOqqj-2D8u3-+u*d*YDAl}e2gruU a@m6>1e~HzP|1@Yx15WV|X%%xI`RIkV1ma0lLr3e9{q}(bFOX9Xc=`LiqsPOA~-Xxo(;M44z z&o_SFqwCA7Q`maxWmlD(LahE#AjYcEwLWMg8qgd~kV zj$I`96Kh>8_*LRy3ubLh?28p+aCV4ODW-^?!bzi z00zLYZ5=ciIc*&>fdn5AZl%ZgIs&npgDKl#u+z$L8g{GLVX|dGVRqq#bj7o*UbnG%|pD-|QhTRqF4l6;EdzDJ3?ttYwaZ>m7 zvb{e{eO~1|p(uzo`GF&@!Z-rFIk=#~qGp7k;unw)xRP>qQPBNMD0;ku!>DAjtPRw! z>cujzM7h0pmsrPf*FNSGI$q3A)=R0TZQD~JJgm36S^UYEe)#3otA3yZQL{KYdh_Y( EFBq!|i~s-t literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Compass.imageset/Compass.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Compass.imageset/Compass.pdf new file mode 100644 index 0000000000000000000000000000000000000000..77b056b97e42571aaae3d8d7e84a1a709d7fdc69 GIT binary patch literal 1846 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/Contents.json new file mode 100644 index 000000000..b6c119133 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "socialIconDiscord.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/socialIconDiscord.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Discord.imageset/socialIconDiscord.pdf new file mode 100644 index 0000000000000000000000000000000000000000..64da48ec8f6c0dc74818aa4d992f1df4ff04830b GIT binary patch literal 2675 zcmZuz+m0JW5Pk2j=$Dleq_q2fk)lXsmmma);P4jlU}h&9qg@Yp92EF^PF2tJjP3Qq zs`t3-a;i?1`{w=KyH`dfA&k^=_~TC@xqC+(B!t@+LsJih{b|NdAQ%r`^)+nM2GAY>k2==&# zR9%rMl8)JPc61%5PQ;ZzeCL7%k)TkQVBt@5$3m1|fi7GVM5pAXQ=sUwLrxqa!<|); zQwGKfTZx*WyU{QFuMx7lyyX97u?wbV zD$+BiCNvq;?mEbLo&cUK76H^w;-vZ@{eWeXS?mErG;fu%_-64?Jc!woU?C}vlUYXC zIT&d`)P@8XZEsa^cq%`JorjL5io-3H3(Dg9WkJU z63;vhxM2!408F9$x?-j=M2MDM6V)?NCq82;Xk0POkq=mXPpCK#Y*;XCOG-YX^gO~2 zvp*qT70Ayg?o`8Qr9*V^gfVpvt)`8KzO;A^;eCT?O?kN$=lzc`)zb=T@qqC@Sh9i+ zs;9=L#cK$$rXF9>E?2ZmC7G504O!7%VNncdwEhZ91K zl3p@1_}jmK^%VS}N6^)4hw^Bzpv{l_d!#Cf!B);uZig>O*i6YTj>dCO@yruN8qZi( z!`t0y_c%P9n|?j^pM;i4RPyv!#t`r$40!rriuoiD4Z`c^9I^&)pGyeCb^$qhKhdZ8 zvJRs>L#N|z|JWY|b?=8el;g!XJoPW-i~aq}T9nOp7*3K1b9px(_W$+Bo}Y)i)TvDisCZ= zT331b_5v0+`%hITehMXVSb)3D>9qUzKa?(bbO_bsTsa+^HeFQ-CJ+?o$r9oWI;BBL#fJEd(GJm)2uC7PA|Fb|q){Uoa#U$G@zVr?wlp&@wedJm zOo-QL(9Cs}P$(li;+A8B4Zi_xg7U_DbKQgEXpYdwyjqtR%`@E6yk2IIazc={mi&+Z z?WmTyYo6LFcfhw|$F^wdo;q~ES7HZ#`TZkv@B2(W_pS}gn66Xte!U{4zy_AE>#}H` zNUs{T&P3fI6Qyd8i92-%Cbxx)vM)Ey{bA{Io9_fd5LPbT%lccyIn!A?pjj*i}Zy7~(q0tgrY literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/Contents.json new file mode 100644 index 000000000..2f044cb50 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/Contents.json @@ -0,0 +1,22 @@ +{ + "images" : [ + { + "filename" : "error_light.pdf", + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "error.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/error.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Error.imageset/error.pdf new file mode 100644 index 0000000000000000000000000000000000000000..eee3f6c5a123da8b932fb8a79d9ba80c995f9a37 GIT binary patch literal 1807 zcmah~+iuf95PjdTn3qZ|5}V!iUZtuMO)o-#C@F6h560Q1L5U5qiwa-QtYgnQZ6&No z*_@rrnKR?b(apuxTge?`5(G5ge=va4QYM28Z`OdcrKYb-NXvC+jrM)PUB^^@Ca<_C7qYW4-yektWEGFvX35Y~g? zp^!ma_`l48D-o0z;JEWn7aCG$wD%YQJQvm$c$s=7T%j@|xst&-mHjGK@SuVZ67vh^ zmC~?bmRl`^l-Vv}K?Y$&j^=pbq_)Kru?9^J;=2^z=!6;Jks}@m5ymRz5E=X|cSz4m zNS#Oag;&@%R7W_8yvR=C^m%Xh*boiXb|FZc;|p$;v&Q83IJMe45imZn$4RllVHs56 z1Q~Rg_>o=(7sjC`$cuC(yG{S5^y*VI>d*uk`bd5iOCyr_r2Y-`GekAg1dtLHQ>jBm z2vfz#j+EU@GB_-uZ$QpKT_R7Kv5Mhnzv*W??WAGhjN2(KqWyN0QdwGBn&7nb-qm%} zwQ%SJyV%t3Ks@OtWvx_0zys5ib zW5%>QNARZHAqHlEaCeS1Bq(p_59=jTg;c=;#ys=p5q;$g{w*StNcJF7DzK%5x$t?} zm78XD==!va_Y7ZcwqIcVp2i_A3?Mu_5~riTs0nh&^8k{{Ad6>^3(p~KP@6+5qq1YS zE7zO2W2t-ZFHnx-w%NuLI9@ML_M*%dP18XtxEFYKyZ#%IegBtK?z+AlX}n=aN0*@|!tV{P+?7?%?G(%!%wqkcJzjeD6O{$R6ZcvB3dL zADNOtu?Wc#DkM6F9Wr^KSg*0nSj95AjAmtTXXx{5ur2UfGssP;=KUy<2z;e@ar z3=bMx@8JJ3r!x|i7vQ+_PCE^$GllnB2Jl>1n~c;e;k3$#%z@E3HLj@Uz?@ zJtZJ@9@%TJux+T0kOFzpKFKv6I=mza8=|4wE_hSq_<~#IOi0KOA5U%JZQ(IKvB%cg z;E*&`I6(#-CVr%s=E68{JaQmiY2T*5DZTm>jXE?zhCY&C#nKT$J~my>fqsUlMmhnc zM8#CTeAYs{Et=Lp`GJH)^Y5YEoAh6Lpa{eHbfs*oyJz?f&=JfW|A!M{ah5(x+7BvLA{ zrG&ZgdD)elW_9TLyo(PEuQuBcu=EYq7;OOIVc~7)EvN}{$TKa1q%z3jAIRZYID`s= z+8jbgWyfw;t~YVVQup3nq8!IgAHI!}aYy{_}FZ{`%L~-~8tC{N+depOA=a2vJ+w1p#*#BQo@0b6+q}yQsU5EC^ zulis8-_orNWg5n-{%u^+x?G=LH`X0pEcX8N z4@r_kI1Urs!)-6*~*Jg#V{YvT->I`-^ZHT1q- z6Y8AnG|D*o1+i60Wi7>S$Zjobe*<^dwrAI>VKYUm%H+amP;;%57U*Z4Zqu-=3HvZ` z#W*Kds4)*qs>6JMV!fwFn`rOicf>aR>RxxCRu4Ttpwt54E-bJUzPiQlK{<@Mfq@}u zy_IDcE4uIJvGt||RX_LBqfP8OhFi^foY3McLb)J)} zzuOO-In`PIIo{@B9@eC*evCd?Ayy9m>Gp~VVOSm_44kV%goE>1uImkbl@V(sqAkNz z#%p%~pjfX%Phvf9Vte=KwDZUm7Bp{e%HH>sd*RE~t;K?4+pJtYA^@83CTZG0=s4uO zPB5=&NJKY>a2Z=~CPrU3;dh%HuLQ$Tc+2uVVtAVBkoNJdfrp?67&qG4ZPhR#OwdDa z@>SC?Eg7e}A!a3b*ohv1_v~7Ak@{C%7#S#IDJ%+B>sS<>$C9%};(I!AE0K-4AksiQ znA4(@vQZh6OdYT;C5_1RfO5CMKqSEbaeY>zV@xCswd=dzNx z5hE|SXN2toUE6yq^NP_#XVI$lv{^7gW?7Aql6aMPBa$NQ&ULhxIEn_CF zNYBftg5|;b+SMJj?clpk9CsS3v?gwj_;SGn61q2R&eJRdP%$I(LXJAu97tbl)>-e@ z*RJ=4(5^UQ`!vmY)VWg5wW2$f2n2*k9&+hGo?4bExUQ0ng^l?(^9QnZEV9Nd2PbEf zvOCfXw5JDhN!t5eU!@OplhP(hFVDLC9q}E=8Bg#XN*L6|B_CIyjorfHx~?e#}55al8ZTtz-?0Zf*V zIQdiwYWyQH2_>_7sq1K7U2_^%kh7o563%i-+WTEq3FT7qP+4YXxzXb1$ckEcDRUvH z+!v%za>+a{*Z^c1I&R1O6k{G1`OC5lL#9Ev<%;9z$P+}>j&eFD`Qt&ste|=>gcTl^ ziG5{lnTnr`g5%W0t{^i2+LbF2cXx5q zHL_oe4SB15`Uw_~4Tbg3=al`PC3EfGiUUP?0=W3y*g zjAM6$-fKvL$L{;4NP^c|74~d_R0*C`uVewtMG(a>fdp?MWveKmd>cq<6Z%mlH?Jfd zfzvpWLI~Y6HHoPKuc1c+q8K}NQjy*!DkI9@-p0bbFfKp<183|M0oH}$+o3#j>)05@ zC%z0-S}8A7lW+=(D(Y8((>mdYG9i*N(veuGAt;(6EVEi@IveYQR`KVSaE!Khg^_Vg z97~5i<=D;T?Lw(3CHkh63!k{?@?md`h+_jo-a?&Z@RKiK>A;%S}h z*#z3UK@_IMURq*D!reAeaqPjDmhLwhbE`Q}dq2r0N{9Ap=(>^E586(vY{4hgO}kW;o>LH-4RZowUP@{KV4i7!yiKr)(QTwj!G2WGE7!&kan zL;-qi$<3P|bkw*rLK5MXw&k-#9k#^o8EcK^l`S|$=LQy0)YJyg!wws-)HtjK9uz|` zK}Yh;2vGb*5LDmBj(h)lAg9UyKmz2~8d^lFRc?!_NZ4E~xT?mdcDBeyH?k~Tp+YYS zTA7@`M~X5U4bIGDfjF#xCn?$KF@Ukszz3!&V{iCjmX+Cb=nb6XQUxYY?^)a7k$#Kvp&$foyNNB{T+qo z&NBxThXAVG_p^xz95X39e4LB1485B+uup`w9f-AeuvZVdX)k}I3$KYdSIDwqCiz)H z6a0R61n=Nh2*p{B(+gX1H|5y2DN&DE57VTq8@QdNS7{s6XEChTMd@JZ+myB&lbE5( ztdflYXPWDIN`GKNMO;vM1r zU`f$_AapSUQTr0}nw7RMjdK;|-5x3^R8q8ws7EcKUHW;-g~<1^N#qBWyZ2Poxt7_& zMcHMg{y|sr+IjL$ZXv*VP-A{KDn;?Hi>B&Mhlr93BVJV!inY%4mOvC*vQL9lbBPrT zBa#KUGQk0&lT^+S9b;xGgJImNip(Ke9%CKpig5u0QJd%(sGz-otP$eUXi*!48jUrL zlzk1Pz!odTVcP;p1q~}+*{JX~W942;=tNbw(baYCTTp6>wa)GM%$C~ti}te%3}|%L z?)w=ym_Zz@?MhJaT`TUm1D%e!TAUR+gCzL|1?#3x#u7od6SzZhISAZ$O)7grx<;q@ z!~r@^^?cLg^iQ(sZnk-#BW$EfaW^4UG}$mwfh=c)czDN0_s}ut!-|eb!ZrhO%Vl-V z;5ue}JWZSsy~K4IKi{}8fH6!nOY!AQ01ZUlCdf*}3#1Jq>BwSrnT4nbs@@!9POf5x z4vhwTvHh^(+%QT2_(m$)6sz-3Ael*NlYlbP_!v0j872c|q^RmTQ2huYB56>P5_2hE zyJ~nYKFmmUn^Dc?&?8fDhS!GBPs2xiS{l*@tz~7D;b$gMhzkEs9723H_~_B6Biiq- z7VtntMR%G>D=_kqvQU7PfnkzQdiIFoz>%i)JLjv9QEBMh(_k{u~FHFhe@+xQeh193jyk!|dZ4tSjq4NY#BleY`Q)G^ki|Avyh<;nKE`5a%L(HQLPje&d20H2qi^3pB`>NGFh$hc`iX{n!uQ7}EGV20GMZ52jp6S2p-#$yEnd2Z0!Z5ao zC20txT>MFI#~Ke!xQMKWHckbFK@5LQ0TNm%&p|mQdg4J03pNNP+7)xLZ8csQ>|RE$ zN-59jW^5N$6&SHA!&~uO>SbG|{3oh;Sr`QdBn` zbY>7t&lXI}A+F!(5?0b79gAqWSjua3z8=ppq0XXAYjlX-SzR_fUL9Fu^-~Z@ZDvIb z(FDg>Gu?bpwHGQP@W$G~uHpWYm9ga$D?_+@R?5&jI`pcbeT+*_R#u%S&Ni4tj|`P2 zYSl8j57HxI+tY2~RxLzg{{!imxefC)dOo*y<_z`{Llt6yo7GiE>8XPMJT7oxJ$~gn zl8%Be^8gOUi(KYR@(4>qAUy3LiV)fl@u~ae+FKOhdcbD-&WKjb1B6h&S)F6iLytl@ zH}7tZk33=+Ce)%F;Z9V@+vArcpE$C0GA2X82ZSw@SuR!K{tO|FG$d%~mfL>C^fEE< zw7XDz#{R`e57YTvCJOrQTF|0E9K1y{b$PM{8py_qR|&#R%@|xd=4=8{Yl}bR zHlrJH-cS=RsMW}Q3lTYXCF@B#q@5Tg*=kf-vOpY8C5=NXx-N9}xOqEkq080V5o4>u zUZP{ZW$##QuBd0M_7KsZw%iJjZ(v(hwYNLPDHXzOtl^Cn@?aze4L?U zf!y&?$aI><$5A@weB|IGGGY}S2|k`)Hq7{R$3f+O#f@}6kEh7F;+jU)3w9aU0hy?i z8qy1PW~~iVe4}93WjP-UfKa4#zFx4GiSeFOVJT3l|iFVI_A~izyyQbDyjtsG96b{sgAU^mM>YTgbZV{A}XrekbrvHY$)mJCuoRK zW_!$w@k8h1p6%u*;(;Sp%aWNH#55%M7#UDDI+bNMY>4uzABCD++S{r%~|-FAjXSLvRZk z@hN88EGRHd|0p^JdW}Gsh1?kZskCr}jsrxWHt2Tt7~lI4fC7;Oe0jjuLKrCC@ns^) zkx%vJ33|KAWpE51^}V2o1aWAL**e*}QZn z_6A?`NTho z8IXXsuOaez5PJMTY?LjG0z~OS`^I>UtwM?7`OtIsZ(u<+JyG`zUF=L}Rkw8i3MJfnMMqQ(c4 zj?jt-S!w=!Z9S2hg)qKRF)u#NsGu6@ym@{VLQ$`|C_Qlw$tlmJ&xP?7(c7u?YzYeOX=a2CS%2=4WxzOC?Y z3VB49?4%T>8BrAmO+pyhp&}tvSL)-@!=g76$5<9B$}N3+AS&xXKr(HKeGr4D_$T8d zY;Yw;#iw!NW137+YRKYR=h2A<+Yrv`e6(8Fzc8kEIt>>}of!z_k`TTCa+#Pn`1!z? zj|WxQg4NZ&60RXWIxv@j8G-6}!?c7`+3SHGAGzf~oR0xqM?y|@tW5?Yt5#yt(N}5+ zDvOnxoP17nM-?}NRE@8nC8D-gr!MPj`F_}JNAQ}vY^Lvn4>b|-{_sO2^|~D2sVw?& z;S-fiAc~O-!%Vv!$Gj%Ob*MiAv6_fiMXV?gtBEKYt+olwY9dsGhX-QOoxYdS)e*0W znEKirVUO{>gnd$}(;%>FB8}@CpVu};KYP(fT^ki+QU(hLM4#0i5u8s}yQg9Xi?JRN zH8ux?Dp0q2#Pp%i5mDoIMD%cb=F0@GBb7doKOt5Vov^$8_{rFrkGOE&kLR8<6&5koY>W*_lxVrkd#9vJ{EPLHvNqqnJKc4J4xUhEQ-?q!XeY#D`;d z%n?+1Ms{mAzLo>1T5Uh341K?bY%6(0p>A1Fc&x7Y0iv(y1IdnPh!=?Ri&6Q9-}(^8 z;s-Smzd#BqMqQ$zmTHpQO$#H3_uOHt>+9H-0aySUOn~ac_M@%y{Rl~f4Pkslpa{l? z4#Y}F`20>tq4@Cq^aY6X(N-`mGd@O^P*G#^D^f?WZXt70qahj|W#u`1!9xu}_!h== zNB5_BKNcy3(n06bue2~aA@Iv0`Ouy*IEg?Qfn2L69tGljn7brD|K31f`ksH6pr6pH zN3kIb)f6A@!ik2}eyF~p=}`RV?MdI33duZYnhg2|B}`{ok9FE zf+3bg8T3a18r3ilbasOb&bTe{@jqrm%)(n`h5@8RI9Yf8$wWeLpYSYo*5;>X6N(4Cnb_z18pTb0pruJ zVgs?4GVx((t@`GmhUhoL&c_0V@EvJGJR0f)g}yosi&GH?g3l4=gG~bL#pRsfY*dQ1 zs^h7yg0CYxn#PA3PgK2=Fl&5N6aD$}g_u==SzCM5XcI8mlj{*J5^N*iD{r2sz*FPeip4aRhDgNNg zG}Oif6|xx{_V>*ws^myk`Dg+|NhsrHvj3FO?SVlmmK}q_85#_Q`maHJl`O|TL4>Chr00wiq;%Y%Z(l!setG_S;s5=> zhkyJ5b^PM}?e+PW*I#`8@t3ZY4bBmgsj^x+9r^ssPOBVNgOAO4=eAN zd3^KDj8AT_Z_Xumj7bpCe*eJ$E-v8mlEr36f0%v4bg_D7#dZ9> zujBUJ6>RR-|LUIoVv>vTfS51m`L_C|ywJg-krGa53H9^hna%R0uN(aAWU#UXiSbGm zYyk3Ez|uJB6(}x@DTN?A7e+h9OFO$JsAhqy94~luri5h7?(Av2aKD?Wy@utHMCRbh@>H`y0W*Y6<-!W`c?)GW_JwmKk|MkZrZ*N( z`y?(7_M|&aI1-V~l#sf1xCCvQLB`~#ZrGbjK6 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/Contents.json new file mode 100644 index 000000000..5b6612523 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "socialIconFacebook.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/socialIconFacebook.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/socialIconFacebook.pdf new file mode 100644 index 0000000000000000000000000000000000000000..49a0739d4f716fc57d594d41046441d968140a87 GIT binary patch literal 1193 zcmZuxO>dkq5WUZ@n9EAZA%MZaB1Ms!-KMJAswwF$%7L=ZhKj{4CRN&BpBWY#)9f5p z!}EN+c^>cTc6)Onf*e3#g!;!%K)k%ft1D35jz1yx@$j?i_QMk<1eP3ShF(<%2)F7_ zQ>*gBHE!^Fo)xf@h@g+nxshZWFo@R!_Gko z@noB!OumIOBDRcLC&m9zA?PlrsG+Z#R`tNQ_i;;doEd#k=Xloa&X1ymrPc%Tz@xn3 YUGq;7`|)3;>W6WhB9CFUdjIw273hruIsgCw literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/Contents.json new file mode 100644 index 000000000..b883d2a5d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconForwardChevron.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/iconForwardChevron.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/iconForwardChevron.pdf new file mode 100644 index 0000000000000000000000000000000000000000..8499a34d00e0a1fc7d6620cce8aa6137d57e1556 GIT binary patch literal 1213 zcmZ8h%Wm5+5WMp%_7Wf|5Q^^y5CmwPrYPE?snc7~gK9I0i&$zUrAYhr9m*E{;K5i8 zxw|vVp-*nFZ_Xw6j7bvI{`kp=E-vWulBH&uKbhLct52zU9G*x6oaa;h(4~6Ks_XP; zwMg^#S2VlZ|626yHf_~93!L<)U8Ip=iX^hsi z2I#eSPGwNb7>y*!Wwb%)@mw@9BH~7%4fZ4t+G>k_Od~WZTJqd_@3f+4W>CZ%8FX;i zw9;E|2~#TPBM|BHbYqCItd3mhCIqCgrHrAe)I9a= zOSecp<##bvo3+h=4n5^ZF@fLy{z|#`V?xiphm&cP2UUGsEy0wsfO+XMYhS=uZn^FX z^@o*k?R%ASr~W|XCUI5|^>h1pnEKkK2PVj~jrROY&cf{kc)O&aF(SOD?b6_x*A8+H zdXAs~&mBU+#$zbLP1C8Nt5?sdWBKwvTw@%keY;L)bh=ueZH7|K+jgKVcpPtaxB8dB Ue*CAYyJ3_Qqhco~@4npp2R0oDp#T5? literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/Contents.json new file mode 100644 index 000000000..0d9c3b1d8 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "socialIconGithub.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/socialIconGithub.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Github.imageset/socialIconGithub.pdf new file mode 100644 index 0000000000000000000000000000000000000000..26a55ef7be4a9b759b64d4c94c9dd3bec14bd203 GIT binary patch literal 2163 zcmZuz%Z}4P5WLS<^kpSDFq!v5LP)R+2mt~DH^d=i%@VX5Lu?T6^;FL|WA6r^oN_;^ zYkInK_V(i011+NvniTb)zX_s;59!e((d{q!r!Y%=^{U%njbF(ET(i|M9=gqqSY33# zcH3_K{0W`EU;f$-;)l>um50>v6D96Q=e4ztm@c$SOhij#p;Q29EwqDVR-zQ<=B3hZDrut6D2igh?!nK*93wH*eDYBLtSUwbM07YFBEOfRIs!(a? zVbBepd6YwoQPBcvXWKBefHB+xPR4p*+$TtADM-)Ss?ttqP7Q&Aw6*=M1Q%|xfM!BE zSFR+uJ0OZxDD{XKC(Ys5q52K!6;W z6|Q(J8aV0wbcs$eEkiDf!m6@@jVZD_@I)l;+f&TQ?8+hHni<9Ua9p}DU=g7dckC$! z=CO7m8lzOxriqr>Lv!|P7>>CPfa@h@*e>9nrdWm!PXXL8MqDgcz04d&n7hgKD%EKf z=Hbi(p$v^SMiyi4tN0@J;+^3AFb)6Xrr@PeH;DGev<2cCjK#8gyx;fZKp#J0(coFV z-5k38NS+tU1ikJqcbg~uZ~8cMYEbC3eL-$1}ih?gxeJFU3X$N?EG&Tr7ge^EdxG?3dK{{yE%+CTslsiyT=>$r%<9OKY zuDgTa(|d6NIqnVpO?RK}?JnKrl E0Z$pc-~a#s literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/Contents.json new file mode 100644 index 000000000..dcd047bbc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "socialIconGoogle.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/socialIconGoogle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Google.imageset/socialIconGoogle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..63be3579b9d62b22e6f2184b6c85e60510eb6cff GIT binary patch literal 2272 zcmbVOO^@3)5WVwP@UlR12+bim`~ZRg&2CZ@ZIQ(3E$G43DjNs8R%XR6=b%2(x1@zrnr?(XnGdw^@% zH6Hf;=0UA)`hT}wzyA5TzJ7c9tsB)pij1vG+xg*1duqSs`8P7f2ToRZ56hcvTYDJ0 zooZ2%VP~zg`eDI>363(czE{C`%OOU6h7rYJqxRUxAtXF-C^lN{3};Fy;31Yw(c{5V zU|V#j*tindB|X&;<$!3iO)ioq<4bgikxWblOTveQ-{u>9FjAM~LQ1YM_y#q} zrR0HGS8TALqv-;^!5evCU54gpp?n_C69)P z@HW=m8s?=HJTwlqVSJK?!5()c2x&#+@HJ^apq2OsWq?ncLZa{ThUn{p)RGcNsNV1( zt3+r;mLkK(v+DwyGT9s!1a>HnIh?keL&e!5sD+v}68xCKb^$V-Cn2GUukTIRq;R!^ zI29DvzQG9~{SxVvH$G0gnB8%giyY7yzRG~K!2XP216m6QHY`A7bc2XIMG7W*C?bZO z&SU8zLBvm&Wc`3f5(0iI^DO$dpK80K^Q0CG6(VSqjTeHX&T^ng~8BI6Md@ach zbiA(MNouzhI&-IA|%j(z|-Q{l7={^}onwf2id+%T`@oy?FKV3oj|vBme*a literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/Contents.json new file mode 100644 index 000000000..0738d25c0 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconHelp.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/iconHelp.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Help.imageset/iconHelp.pdf new file mode 100644 index 0000000000000000000000000000000000000000..98b561f6c92daf44ed4020be0cd35c5ef1c6dee8 GIT binary patch literal 1879 zcmb7FOK;Oa5WerPm`kPhkj=gyQdNnj6d^#Alv~9iIBpx%*buv@@avhicgK!;Vh@r1 z?YzEk#*>qqtLug2o-qjm+V4LY!1*~`T(G*?rdOus`0``jJoJyC5nLy$u0Pb9JzHMY zzjsx=es>A0+xc77v0qGbF&q%(VL?xHC%Ll83M@AAr*UM_pD)G{`+&1sE7IA?`a_gY8I_ju*Xi~aA^D>XDE*L*pq}A9fJ!v zJq3&0o54BBG=aiKR0;(v@j{y1l!OQ`2pT$Sqr)ampejSPh&)G|LzHy_r}A(>a=3}y zly|}=snZV33$AR#wD`s?DU}YiBn`p1JeO~prtLep`-aOD&+=w-sGA;aTACU9RBv~i z%k~BCrmukp9&5>>Nt%`tYh8Ek^P#FcNDI4!TeVG(DLP2ox`1E*{H#;*hZ>X4HhQXq zHvRI$Zi}TtVz7piWz{}o!7>*+1?r9?xuZxaQ+LF2bX;xv%~Shu?D}%3@0kG4MyBZ( zoVD5l!ud!6!xJ=w0S+3i*heUXgcX_+}TVwUZU*P7@4|H&kcy@B~_Ve{WiS>rH literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/Contents.json new file mode 100644 index 000000000..fb03063d4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconHelpSmall.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/iconHelpSmall.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/iconHelpSmall.pdf new file mode 100644 index 0000000000000000000000000000000000000000..3640e183dc5a65c42ce0d2a7a4e894db641a1c52 GIT binary patch literal 1972 zcmb7FO>f*b5WVwP@M0i2n9CuDLlOuAG~BT&%^n6^JaMU=Jxe9nWz+LtNY*oP+Grupqb>8HZj{|Ne2@`@HT5U zOdO-f0f|NLv^U8GpCax7W4It-F}vilegI}ENG^8HMe8gM3kA+F`;@|lSongg0AJP0 z8n#)aIPgBiB!#*-Ss~2KQ$5v4qH)P2q(u>k&9G-6&e{M^jRGM7_oyV} znLKpA_C}02>+?k8EZ8~Espe`G(9_^iyj^<($)${b16g`gkp>c;dc&Z0v7(ii>S>1* zJx=i|CWb&HRA`wg2K-{H;a(srW`Wg{=pPwn0L^s4`) z-)-8i@+D06Ebi^J`Z~5l|MAkagD$VZ>h7lRMuZr2c?wqW*MI(OOYr*^L3htZ$)i3a zhab*&NL7~#j(Ux9(|<(5v?RMZ8lHN>fbBe$NW+sV=ZiO|@$}H&KfU_t(!N*FyP7L4 zf3;wj2Mu`n@W4zb-BrjV&+=7>uvEW-_$w>Hs`=ugK;&xZc7 seXgIK@1D=39FBcI>QeAT@8RwF-xk?V@9XI@PUR3*i@Lh{_UG510er%mvH$=8 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/Contents.json new file mode 100644 index 000000000..141c0fac4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconHistory.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/iconHistory.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/History.imageset/iconHistory.pdf new file mode 100644 index 0000000000000000000000000000000000000000..d56e137f6ea4f44f841eb6b16fa946b885686076 GIT binary patch literal 1869 zcmchYOK;RL5XbNS6mzN69`dmB@=8@Dx=RrPMA>qyIE1Xb4cbj0Nm1d`cbwQWUbuG- zEAKD%Je_~eZZ|iPj4L4|q|kr=ApkBf;p$45ZfE}r74qbx>GsnjWC*u**EkKPK8j>x zez%R;zPpC?UHGpV#V;Y_bT&x+BBB*N<3$>)!tRIW$Vd6H_c1n|AUA1TEoY9*WGu^E z$sEIGxmGFz8PA(iB$YMIq!BWU)oct87M6vqs*<71eFhYO5#@pYXdlMUib|so@*rDDPYJ6>ZOHM@S?8#Ky43ZcPT`xr8ZOn@`kN+ zPt(|kW!8u)RxTN)2c%^#wOT>MRC`ApCPdUihLkqDql!5$AzO)0k>G(wVwKOyn%6)p zcZ)Vkr8G$+Dho?y@}}$hX@vW4D4}S{Z9SN7g2GCrL!Zp9t*`rMxaSU2-(=|vm&&ia zudNyTr=c+;Sef?j)_pf&h!Lztd-(OwPh*4c4F(N#+~z_0o_uI`m@3!`w&0_z`zK6T zx@6hWc7Csi&7*Y#8%`u*wA=fOOP6e_XY75fWiQDg-mb|z7ttpUorvkddJ zMo4B-|A%ty&FQYfivK@I^TBDT+k+Vde(;j_8*In<*dNUWoVUA+r76j_?ya3e;f&c&j literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/Contents.json new file mode 100644 index 000000000..c1a5f3750 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconLargeBackward.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/iconLargeBackward.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/iconLargeBackward.pdf new file mode 100644 index 0000000000000000000000000000000000000000..10caf6f1fc68fe609be9b9344821ac2350b0b349 GIT binary patch literal 1215 zcmZ9MTW{1b5QX3UE9RwAi&V$=i&RyjTZ#}M%9gi^hmdvKMco88DJuMWj&s|KpPbM3 z%sJz6PHwMn&L#JZNfOlj_{oSaF6i=-rFxY=ncC;Yr&K?7Pox2tc~{$QQ@LTqb^5ce z((?TkE$;Tes+Rp`l8b(jm?r1*Y+jRGDixw3tVthT2vlu$NB8!P!P=^3o;#_uG$aE; zOKS~n0HX?+ll0tcZJi?^=c0)jDJQTD2hYk$YTgPYI+7ULJDKS ztdd#bOac$u8!JKjbA|%fUPO>8Ya0`ABTWMRArRCEVS<4M)K^LGurY9>oCh3` z$3FPh$~u7{<4Gxav;i3)V@`oG#>vyH1b3jc@WvzCC^sV)t?A2sd{Y&BVh?Xv&AzhS zZDT7K_Y=+feCT{m4z_utXA7{zV5O?5{$cjt&cr`5W=YF_C+*Y2nd z;cY~H|KvGMv6iWAUbafjN5WV|X%%xI`RL9?Tq^c6#r3e9{Y`Ik&Le|{|?Iw_)T6CEg>8jR6l+afU7IGz9zohhEF2qc=E}YyY>krf}0T4w6)I;Bw71E zMeaB6Z(wyl|H>Qkn{djy1#H}0#$EhRQK3T=D9V}C+(3SqGGkcWGp4<#s)(>~5H!rp@ zL40gZMxz9A*~O2P;Y^Dz!nn45mc ztV`pFsfgm}C2z~JY8!a?j-!Yxxyx!_wxGkv4bW%5EwY>H1si&*2x0)=~q)!{Q9O9pF1LEQvb9njmM> zQz&KV%~2F*_B4@m#&eSlnz6xlP~hu1)sO17Vy}A6 z?MKzAs?*i;&$W!pqJ-KTkyk7sg->tXbzY;g^=D&8Q2a`sm2mME2R);eL7G+ITh zh%%;ZY$Pa0A3_jGMyr$qq^0v-S%aln#+-u+!kF%))>7vjZJIIHzm9pkMF*LbGB|Fa zFx4n!GmIHKvaR#c!`NZt#i+S5*33RnyI(u;nq}<6ZkbkJ@ph2HOfh*_%Z$z>Gw&@F z!`2qE1h#7&4d`y6MI39ig9bzipb_nw6}do^C={pyCW<%a;fDne1@ze^C!BPl%*4Fp zwZjosdXWF(%e*<%IL773NT(6(opLgIO4GA%Vd#I+n? zidH=n7)m{37}+hpXBK0&=N}`*M&%N!Zk*V&c^KAHo~@_pr7|Wb>!wP93rcg84I|YQ zc+E&P7|!e##;RY|KsdTP)q471COh;#e0@_gOlv71SuolptUc3sFAa zxFSMENBW4OrGX_`s-Ji|Z$Qe%oANR3;Mo>m4IDPpO0TLT7rqe*;u-_YR9#x

T{# z$xgHc>0mXq69=?YqtrpyDvh#R7iCt4Kz0Ge5B*J*SG{B;t)6fF^j0;veh)vk{ge*EpoW9HLipeZ-#73~y2YoFc$l;*4Ax z7&3w>8Yr%X#?iDRlSCMw%`5@!R#uu4uAkuz^8}3D9z+d(E=G;Uv1aDG?~ZcgzyKpF z3{qsatl0~U1C5!TtJ&Mm)iqY848!U^b7s2l$QetgRIWzs$_3P|TUx zlLqnPOyas5G`5T9Yn0&cT~1e z!<1rB5HT;k_c`OTBoNE3fTB~?zK=C6apl=2KASbxa zfz%TVS4J0^?}ins2xIFjQ;{ra8diyd+eA;}qVVMFJy*rOe!}fAc%=W?O$B0acXq87O$zZgYSXZ2&TdTNb5RK|6X^C#Bczv2)){NeLe_aJYJ;n+ z1L`LNY_eX0M~2mSLdCJPSx@p=WxcReoox9*U3#GjT$C(=tfTv;#3I64wn5e>URzd{ zo{pFz`d!t_T&XHCDmhM~K8Lc_f>yOWoT}x4Zpcx^cpns6O6-Qp!q%g?MB3p9TqQAJ zUd9g#0O=5ucT*R_May-HrQB3A$UQY9+)_^sGL)r0Tlh&c4cezRJ<|19A2g-^>Gjaw zGknYyTi`~SO*u5?Ro~El6?f^@uM9-w|2(T{5J}UAZq3vt_M+_1PkL$AXQ>U| z^Q+V`jMwVs+x`Al?#}|9rMPX-&+Fa&_SNBwct1K&Zbc3IF-Co_ z+x2w#eB7-kK`-RK-OXWt#t|n$&*KjM_U~US9sY5}q0@Fj* zX9#6>2|+~Q5B+!+#2>GWODLnFFCnM&Sa?2e?;qCVLecx-HRyPHIy|n=#MAq`XO)!A k?cs11S>(0Bc2MBgQ$26P0pY{S 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 T+U9gA;^yXu-(LL(_^Qz4 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/Contents.json new file mode 100644 index 000000000..bdbceecf3 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconLargeEmoji.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/iconLargeEmoji.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/iconLargeEmoji.pdf new file mode 100644 index 0000000000000000000000000000000000000000..c112e63b506f3678eab15dd423a2e5d0b3063a71 GIT binary patch literal 5295 zcmcJT%Wfn^7KZov6tQUu7EZ_gA|a%q8%Co6O^;#MV&SPS8Y8<3T*U}@dcG5p8Iffp z(V|85Ci{29x%}sv`Qr7fFRsj-rpYL+j{o~%QtFdW)Tf_L`@>uL?_{_5^_Tm@yYu(T z0p7@|)A@0K`!HR<+W-GpOKiNnKk|ytW}zmvpyGrVzHJRX)Z2CU!i29EuOT_v+XpM5!#%Q$YwLV3c1TrabL7?oiwT;wLyu`!IE<|0#V}nhmO7kIF zt}$W2MdHS$i9Bh^yHc;y~PTNeOnZtlV%~pcslv_-beGVN|pxR9Hl-D>v&B zY>Fz*&d|ZI&dsT%nD0^R&~EZ`jKmy+JLuQe2NZ&{*tvzAXq7D3g2ok{1Lsz0b}p$V z_R!j)-9(8I(LxwINWat8OT2Ili?yUJr>d`J=5W)R;2$a~?NAp|;T)+dnF({$h|d|w z6R_OkV71Gs(&R%Z?VKeJ)ClJi6;Y*`U?V93luHRM#WVy zN217B5J==!$OjQ3SD)4G{Rg$^_iY$7I&v}hjzNadF)Er!$&Hcs4aMGuHgBXQYDezY zlg(+t3~o2VR(1rnHc=FCvCt@(_d2$cX>1FYk~5Vcw}u7Oc=}moa)}?94avkBg(b{j zBG6XdJs&{n0yX)2;+QBWYxej2GE`1oAvQTj+o!}F$yU>D$yh@r)}PeGlGqnmuYe15 zDV2@HUQrv}9Yc4VP4=}4I*K>WrdkHQl!;gtziYMhng@-Lu3@b=2QVL!*EQ{z9s))T zi*D7iHXA|7f69W0EnP`4tpnW-Y-wI#gwE4Z!FrbyG&xGXqOBbY7Gr6#UAkt)Y;e^c zv$ofY>a{huJ}g+sbXbvSTDz`T@=LC@z7A`0lG17!xQ>8^`cN(E)1sjyQk5E(!Lp## zwde{tprK)g8B?)3=fKvCp~Bbx^G7FZ{aDgStm>nalP(kjx0$eDAvzcElc~FoVo+vY zkV@+_8>~bfrCZg}ZfJCZJ+0^uTKA|sTG)FmA9H;V>F2cuSCm+0|U@nq;*bx+{$bbV6= zR0c#9vdC2@lUJUF0;vzj*bbSJ;)xa!>ONy<41CH#2j%6$goT2RvaYQRbeT*M2w=Ut zP|xI(?N9n?x0I7~(^|#dB_tYnmfIWe*?4G-c+LSg# zC9yJ*B2A>r354+m);DP*-#3lVJVv`00ps~kETWOZ#W zG+G5(EU2z-(9X$_H>ewmw;c2L#ljJcnw`~?5y;{5z$B|=hm+sNBzfguK@Vp}mTk)f z<6Q;vnD)-FmEwP4gJzp&Fq;_Y*#v-uH|)a1yv#Z0$b_OCY}8aLpA||=tBo}sYvoN_ zqpNIA#<^r(#Nez8L|;gjuv}>7j)^&o>TY6_QyCwgRE^J~(9tZ*r_A6XkOi7eo0o;5 znQ7ykVc){+ZX!Je7CdCqsG29tds)5X$}b7uA=y?JYC6{W>#{n{86 zO^njIgduK#g39M329=372e@wJ(j=!ikqqKWDTM0wWxAC;fy4jzOKR@pFCnX=kR&g(nhchZpO1^@v;5Wbi zxEJN`_9)$aDHA*T7qsht-@V0DB_7}VILo}vKh!*=CqQyQrRmitXh#@>Ko*!@T z?)Q%qpA@hE^$I#ZIvpSOAFGe<-hSLjxxP6b&q^Gw^j?2`_uC%p>!-!r$8&Xu!R4kG KFFyaz7rz6RLK-Ci literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/Contents.json new file mode 100644 index 000000000..e2f14bca6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconLargeMoon.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/iconLargeMoon.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/iconLargeMoon.pdf new file mode 100644 index 0000000000000000000000000000000000000000..0ff6c60e3fb2492138ace01d36878d029cbb330d GIT binary patch literal 1747 zcmZ8iO^+Kl487}D@UlP>ATlY5`T&9e$!=2=ZPC=}Ey%%{oopP$GmXb7(*F8B&3I<) z)y4EPMLv>G^v&D5H_yc;V}zLck6#SYix>3rrD?nS`qj8geDhn|J)Az12e_?X!|B-W z4rX)L{7A#BSZ^+Fi!n5vN!F`m zRT5avyX@!yPy>rd1;s17M9D@8K_f}DISOY6q#;Sk6^iUb_SDpPMS>ea=9p84pXcmK zB2nuzi?7jUDAYSmoO!J0y|XRrh0GJ98Qf)X;ka21hb)*Jvj zj;g-;X>bLtkG6Oh8CAn8X-p1KOc>C3H3CE&A!oA|P4M%Ug>kvg7$52=+ngmzT#?3j zTT%>OS8NeNK!DuH@^jgMVsfhaXgszp;n9oL0UlfI>VydN}`v(-^a!TNZX(|UC5*VX+ML^nN zP%Cs%#^M%i4k?Qg3=Uvg-D}(Y+O`G3tiZ+B6u&}b8^TCjuJ~!0&R#4 zPhb+4IKkWi#uTPnm|cblYk7}!xj>C6Hi0G7uwXDIkr$gCIxt2!%l_gmEN)=LK~s!1 z1ZK(T8N{y2sJKRb)Z5zfPtQze{xo&}oR`bIiR#jsHk1g*WkH1n#^Tz%>bm|k(EATq zWH_6*yJOp(2#TZa8T!4w-|t@cKj{6cwMAeKI-EwiT63&zJM`a=O*>FsmUFnGnvYTJ`_n=C(f-TKiZu{>bEN8N7py4_a-ql54@AKnd{q2-9d$w?KGd*N{j7i+UC>NDV9C8p0lX z3*ZM)am_lhju&}`a}Dap6u_RPEFZt`~F0=;IX}%cl-ZZupj?^cE{6L Oj;K>}bMw<5Z~g~4HgI16 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/Contents.json new file mode 100644 index 000000000..6eeb82d28 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconLargePhone.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/iconLargePhone.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/iconLargePhone.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1e4e891fa43be9d12c3af6320083351590a1cdc5 GIT binary patch literal 3604 zcmb7HO^+Nk5WV-W@MWb0X?tA$wiHDoy96OXgblZd!_eE=9ke?GGZPf}^}KT1<(^y+ zbLx3**T<_@W%t#)+qc&=#$h0()#10_2c=%UQm^Dn6j=~>yUVzh7Q`1 zY%$WUNu1rQK-18p6Hp$m#af3}ULS{#!+!Yrf0L|RR{zbh88syeUKumG=)CdZ7>_O{ zA_gO656aA#qj$zIlzcSWDTEwBabhT&q?1*gt&gOgD`3vvdgVu-tsy|Rl_$1`4oyQE zoenX@)w(=7ld=yhYoteGa?T|ZaZ9MYaXyw{YJ9-FHK@3r+QDuRLHthv^`0VP1IAIXZ#07m)<(tx^ za1ehmG1h2W+^}auDC=5!h%Xrw99tU?i+sY8NF|I$%bG!+!mCE>fkV(L1prsZyTz+i z3dQAhpg;<$M{*`+Sd+?wQiMbiUPU2g<~YPFGLk7IY7>NKK^3K7qFk{g0teFkNgqg9 z(kv3Y^wc`V#)&Xd9xSRTbk*fhVP~}%r3AG%@)yUXOG}mtmGDxw+>x!2OA=9IIM#X> zgh!%?LJ-l;GzdnbvZoa&auoYrwSXeJ4T@RGyGM)HOCR)dcc!K!-yFXA6c7AeStL7+RORv_K(QUD_1WAd=%r#K%rX zYlHvfJSGG~UdQ0DV+yDWdBqOjDzC;DJSuvWo^%#&qx|A`l#hSzGQYm?aYm zWP|aTzG&~!WkSrnj=Twhx7wI9w{#wpNtn|NQAiohmHF6n=oQ`y8^K~j0%-{+B-WKP z5$jM!ml4$pl5#IwAr!4d7nmt+FE~W9I1$7FDAe%8_G=tq5Jw4)2)0$jEd+WTAU!AW z7cE9{Pko_}N$U&=d+lNMsu9i#b;-2f|PiZKCM~E&=0Q!#>f$k``u* zh(%HtO$kyCEt7TPx>RyA+yvv$2BiY9guzAJ7z}}-#UVhH&zE&IF3ddgPFpTZ4IWSx z!zxFBMKqjJ)e$Cbm6oUtP>~=cyQ0-Vs<;I4^l0qkwb2?!OfM0jWC{9MR}zOP8UzaM z1qZZT=DI2b67isz0+R?jkA>V)Wp$2u7$A`pOeG0_|%_qfQ8_nF!VSk2;lj2W}2LAH*A2U0DnBjEwIl^(sXUgXL z-9188oWY%HUTzMb5HQtXyP?yirEp=1J)JJHTsGcp&)cWN!{ye`$NA%+RUCK*ENnc?c{o1fnP3s*SOumAu6 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/Contents.json new file mode 100644 index 000000000..fd5c1bb1f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconLargeQrcode.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/iconLargeQrcode.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/iconLargeQrcode.pdf new file mode 100644 index 0000000000000000000000000000000000000000..acc1c795d1d72921ba07067985fc9752a0bfbaf8 GIT binary patch literal 7870 zcmchcOOGW-5ry~nSJY-C8|hZ(`ypAD@E9Wm2s379v1od(?Lj@=(A`GHzn(9$vLds3 zkc>TIW?@~Q&PQa#IT4XrFTVWzi?dzx>0}qP-2d(Gr)Bx%ljYM-PnWyb^1mlH<5z#U z+-QodX$*9Mths*Wb)79sff4#Z6y!!2D%ge9k|GRlS{qtm3)BY`H|8dq|hrjt$ z{bIvfYc|;|H*d#O9j8AYZ|+XcuPy{ukc{$Z8y>?HaHO zDAa1PoT&+yRUc~uZI!9aNIpg@P&Tz#IfL`X+9;4UA&7@LtMlGend%*X#JalXT7wNh zHbw)4n;fx8Nt|hIG0nsH4v-_JHCh*mIv!?xA$CN{c>_%XtXmh3yUmX77PMrI1yYE{l>p6mgh)-MSV)YAjFMEsMguXi7P7!A3OQH z1T}kEQn`n(z(@y!dT;>2w;a%!x0;dzqL_$h*CP2T4&GVPL=%P54h|P2>1Wn~x#FOc zl1`YOJ^Lx=1ThxbbjoG?X>muka9J5=SDTz+UMC!>Tk?phUS6u~a zDRcW9I||Y=rsOWxuqEUvVVc#t65vVCmrW8SpjaHE>C&RUR7e9OTdrhHnu-#sYh~oX=!->Qim`Rs}66g{(4C zB`p~Bu9jAgHc>aM`T+k`)&VP9wGh^*WCf$pN;NrPF2GbtofAqCCEKE(F7LvM9VR%xUrV?*xN!G+6@`mAWN~+4dVJ0Lmbw-6QDB0Tw2O+!E1+$W`9bW5V-@F?u zvAH>^+y#vW<&*Vy!MEtRrhVeDNnS7q=EQOpeTyw=9xGM$f|0u_g;a$PEvS?qN6XVI>zf3Wtyu=~TvYShTx=qTNqRL)i; zyVVrzQ6+b?p}dyKfwhLM_j&`BCT?r?+KR}Mx+_@g_S)X)QXD4e*6wY>bjD2m-lR;~ zeCzlQ(!|c*^Ud1Su1{#z#X0&uQH`o|bbbPhJQLy8-mj@n^aJ#3##QYC#o8v)xepYusT9hI1+5d@KxBIC1sg0ng?8EvHV~o0?a>c5 za98T+2nFs^9X+9dU8|!jJcw0%yY+>$T17OiGo0lrp=rJ0L9c|dcZZW;0egQqDHgDI zh_hq`-CD$5vvukbhiGNo)+7!AyodCtoWz^%@~0~r%@L`V+Dc+G+_FS?ai#l?w0eq( zM%pM67;Otz9z_h^Z1W^H_EFp$S(R>fxt%~7+?=W7czfbT zlv9Pv10-+m8|xkurpAy5b)=eoJAryS-9$a0wkUFQQlk~Sr9Ib?!n5vC9jVwYUalyW ztD<6YKQA{~u9K}%?H*8bZO-PS(~xmq;Ti~-GF)^XxxS%r>u zjI8f&F(5VNhN;hOmgPF8C({k|^zZtuDd1PX?6&hWBp}Vx#%}d8&kG7FDae!0bwTFq z2U7|_GP!x67HQkNrXZPIn;LHwB$Ks$rQCN_4Mk2>oV#BJS|%A5h|Hk?Pt9egxUl?5Z; zq4uz5(EZ?}Nf}ZtpX&;&(}4M1eiJtPNJpyi&Fy{qIHc|}T%jRT=mQC4qz$?Cv`jJ; ziPl~|9qy^<6H}cj-#!0+j^1Lh{_gWr>3LL}sFFB4!RRMPoM*1J#lI3L_SiPONBh%?~ z#hv29^DNQeazY{37~(b7%58xu-kJmOpE6?x8{I`O3LZl+o$Q0~dXkiGjju;GN6eio z_+19fKFe9`6IVGh+hvWaHv1pBnpj z#QmeAd|%u?MrP-#ev9N;dwiq3`t{x2{nO*}^FuOBXVPYdtV%c~Ck@$&l3 z^=J1#EMN1u`uroL3p+G^?Q6ZdJl=o*aC3QFZg@tr^mx7w}~&WpRRB3 zzdcU<;o3af>o>QThZA3zuYUJA?)d2O{_W-C<)b&RKi-^j_3HlqX^{gr_g;PV=En=xw=d1t T4^Qnle5xy_7cYMEr!W2kw(}Vk literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/Contents.json new file mode 100644 index 000000000..10bf9c661 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconLargeSun.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/iconLargeSun.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/iconLargeSun.pdf new file mode 100644 index 0000000000000000000000000000000000000000..64ced8e34fd7e6021fc73f2c7054cec270d24782 GIT binary patch literal 5362 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/Contents.json new file mode 100644 index 000000000..df0b05e64 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconMail.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/iconMail.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Mail.imageset/iconMail.pdf new file mode 100644 index 0000000000000000000000000000000000000000..4bff5a2b372c19663d8c55caa084f7a6fc60aea6 GIT binary patch literal 3551 zcmZu!U2j`A41K@9LN5i{0hL943n&V#$vO<%urA$Ou?Nq&O*16+X1hbzU%x|%(!K8L zhd?&dQbHAH!zJH~z-md@Kou5J!MwfZgwW2{$*1`A`LO?zrO zClFXoI|th5>`H8=oh)r^@fjfxPC<$d#xWeFD zst(8%vWZU>c?2bLwK${6$or0QF`D4A?U-T7G}54`u5|)^jkJ(E2n`mi!xG1(?tz3sBv;ldNt&m9wW@PUKF0vVJ90VI^xCU1b*Xmjx@Vag?}7X*3<-qFggj$E=OqbKD6!^6vI zQ!>1)0|6Fd!bSww;|0b{fcSM{AepJCXlKBJ0&syGp&B6yb!IXe$(>OagijnLb_(^t zKuboVz@$PfFl$naQA$}ykq@QbUf5YM?pjrgAq*R~t{+|@YYg`l#-qrimKR_hMWz%? z_r)6X)1w&BMBGU1|YICuYqa_alq_?{HojJ8B_!TAMt21YSBpMZCvl8+e zYW>7*_Wqk`Km9uKTU;L6{Z-Bn@b+5AQ_76Tx*sqe@tbe=`@{L9-u;e8JwBT^+vB`H ztH6(UfqtHE@3*fGpVYhMP97IA#ePjMtM2P&J{>+Dck@Z{4~OpV>aaiKh?C-94ITXL z-@j%){BFjft6vrz$N0su`SJc1p(@VcM)gy!4j&OPNwABf)1@aoC{~{Mq|-%~&G2e_ z-aZ`eE=@lj=l7FQX=)D={;Oi(Nefs$m_Bu-_5;EMxP%=3{U3w};}^RK@7XUPn-;_K zaeMzTA1AKf57(gM>FMw|KT}WdZ=W?%HaCaES#iRZ-p$+l&oiR0KgG7kb4>>?k1{=Z J^4%}5{{zgt$;JQx literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/Contents.json new file mode 100644 index 000000000..2377ec5d8 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconOff.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/iconOff.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Off.imageset/iconOff.pdf new file mode 100644 index 0000000000000000000000000000000000000000..57c43112303e3295953867986bdbbd5b92ebd1a4 GIT binary patch literal 1785 zcmZuy+fLg+5PjdTm=`3d#Afdo2_cnGs;aF@L*GyzQfGlw!ER$y(SChrZSUAYI8wAZ zJ9FmD+4bb;`ts^ja?h9q0nLw}4B+ex&d*t@H~A-1bA0hB)%V>4XarX|s_ph^{m2%V z>Cd)GtM?bMyqW*1TK1bsF8T*VS)9^}_9Ry}M`4g37S-dFISU)P+Nx%*gi6Ev908Ba zbLotd1}4y#U4;5g4HKjbNrkB+ODNcGj%jUu@R&Ll2&Em;K}dz#`fvw?xe^|REe|uK z^o)69gOY^pW*{{{{8O7GV}dI7zzi4Gd22x`RBn}Z=#t?oI1$k$$%7JFIY8>DbQBrV z)_7cL9*j3mW=JY)tbmFsZnTJ*PjDHu(;DPtob^_FH6bLb!qXh>MOrKHllg}QZBaNO z6^q=NXd)IY1lY;w(!@XzQD8*^124kxD!C{Oc0S5ifCbPN9S_=!Tnq2y+>XeVM1xQW znHIS*TA8`IyF@*(`qW%I8GM)-f`_TRk#pZ(xxD#K-@Rcq`^xf^8b?r>S9vrIb4*HOXp9+x zal9?w)^*dhaQhv{9X^Ze^*+@d*gV!o=yTd^*B8w*+`eLooZeDe6|Plko2Px1TF4`{ z&@G#~!xAmzd0N14e}AQ1{61mP+04y4XcjL%ZZ{|uatA9YRhG>Y3YMeTiKsnfatBPg zQhU(lkholT>s@nynEJd=cT9k1!<&}B!C9*Kp7i<|AggzEc0srA0=+mY63 Kc69Xa%hi8C4|9kB literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/Contents.json new file mode 100644 index 000000000..cd519e668 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconPen.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/iconPen.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Pen.imageset/iconPen.pdf new file mode 100644 index 0000000000000000000000000000000000000000..2f70a34a629cbf45faa767b00e4ce63f1a40632a GIT binary patch literal 2433 zcmZveTaOz>5QX38SM*Dy1S#XLzLyk5A{&AbAi{>XhzH}HY!+>7upJcg>-nlZ_S!4v zVKsZE>vrl?wV%9w{pPuhbr{5XxB27G!MPVN+{>54w7#)_hj5NBewx;|`;RUHUfZeN zemgBc4U5;)KXfQN&tKIPTAfxY(^T(Ixr?<0j%2Sj>O=@h>tv)?io{pVf zcB}OueoVpF6rF@Ix0{N`YX>hBdjY=%d21=Ednrox^3Yf~MsYv!fF-z29Q1P1hxT4Gw zB~g1CThqkXd$1gG@}$Q(%4uMHmYDED$9&C_?HmVVjLlr9P*X|=uvIU<0M?R7$FlO8 zn~y-MJ{?F4xwTZSpjwS5atR~n6ZOJHR-s&jDrp&%O3=`m&5)b}5LtS{chf@SU|GkO ziuuEIhO8^zIou$I+4_Rw>6@Zo7} z=nQuf$U??YLqQ!gTa}__{(H?rZlz>cnj1xIKPr-;Fe1+V1gnh(JT$&{kKDYJ&?}o2 z!b!x~4r)M0CM3fit93PeL^w^E51d9q#wZ05L#q)-6^VL73RL087?2DZonxvAV$O_V zgL)hCz&gTF^s!4Y2i1t52$w0Ce9=+SJ}HsT^1ass2dX*slcA)nz1~phAG}0{I0W-Z zA8TP&?X9#*D`pXhG?Zaz4gu|<(l9Cxau-vKRcp^pT0=c{5;+&NiTB7jAxUy;DbL-F zBS}cbr*)0@o(F=^)=$PF;b7gg22%+tsJ=7FCdazU;}_iZ5&<=NVX=SK2|QP zfd1cuQHio*!I%nkkJC~D?O{rj3KMQFm`(c>G*@V2HuhowhAm~#v)Y~vDHx`s-=FP89op?>shaPtn5OFSPk&x zTgHV^hw5U*8GMG&4r5^QWLzq{6#4b;bQLG-4vXA`e zUT5g%>E>?vYV*athmFVgsFWl0@OJcdJ?%E1x2tLA>}o%{yV|VxgxEQ|*N@u z@Y{)?XLrBlar#ZL`0?(BRGn3D?T%5dHlImY=42ln?Jhl)3r`klcTwfR@M^hV-fwO% zO}}iX4+G;d9E!KUuCP$E1D+pY2<&m|6J&b2fEY$B)AYJ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/Contents.json new file mode 100644 index 000000000..f5d42dea6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconPhone.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/iconPhone.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Phone.imageset/iconPhone.pdf new file mode 100644 index 0000000000000000000000000000000000000000..79ca1b1a3b98138ec434c10f1e7f56284f84f762 GIT binary patch literal 3095 zcmb7G+io015Pk2j=od=~QfB*pk)lY%CI|r{IJ`wXEaQo@$h!->8x;6@PW5zGw+#|v zAFT12?y6I#E>l-;Z{EDnQxrl=C6B-SDx`e*Qoed6mct$WE6j**zFQ9Wmygl{yrom; z%W2u}#pY)DV>d6iU%!^u@5cY;v-n-;NtK^e?coJK@jKhzX*>D#_`L5|`5Zr-=Yz0Q zENA5l(=P3Wo19bDhXM4>IAYD~%MmiGky&(5P2T6=oMdZEnVm8+gNRy>Gsc7vYcTXeloq)c9W+yl%4F0|6ByZx**hBm z+3d9PQbWQNYz%V7)evwY6PUeK!Acl*A=@ampRCPMX+U1vU>rd~`IH^5n#m~V1HjOn z*$KzUaECa99hya$;J?`8t8t|Xb_}IPbM%^+CbP>-lViw@<`}E~7f}X`wHq)Nc@`ao zmsFI07(j$>a@0!pb1YD2({!9gC*9=c$T%k~KusMbjCJB*SWHG(b4I8kYHAo`dW>+I z2Y*}*%!(g|SFN&od~EceZdfWl!-`TtmRSQGS^EbxR%+vLv%_S440>H zQpUQFWSnvg-WqgGvP$C>a^|c~2}nRcd0X-r0(BQ*UVEo;3XWZ*dp=pTED+^#h}4q! z*A|{(^5|y+eQ;b`u=41LtTb6KV^aZX8a8Cc5LQm*RIHb`BnKKe4VEB>SJo6u&7XmK z@K>;v70H32L98lsmSc#IW#Ger*LGZ4;SkpmI- zEVCR4eXWE6sU1xIs%X8i(AEQ(BWeai4v;4M8Z;6LtLWw|(ZGyFQWGkx*h`QQdO_cu zQ9wnf5)z;gj8P@&Ya!5hUTcG{)_MV0OQ=ibdY#qU!)UAJNVB-*1fWZH^O12w1KemJ=Ww1n^&X1y8FJ5mi+lS-*)rJa){dP>4?<`g%M$m2|&&Ic;|j%Sll7zPW)M&(6pF@?1XK o-92AL+1wtF7fAsZc{lHNe=T5NR`~7dQo=DQT5)yt)emp}1_9J=rT_o{ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/Contents.json new file mode 100644 index 000000000..68143b846 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconPopular.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/iconPopular.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Popular.imageset/iconPopular.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ba4a8f0f3c31dc78d4f985fa73ee5a95c607cf9e GIT binary patch literal 4635 zcmZ9QOK&8{5rpskEBdm4BtXr2Wjz2vfVFE0f^Ar)d=q@2XGbdBdGo`&Z@=_gSr)&#_4LnwE$jN#SL@ebFUQCC`sWg^@tZ#%A3r?* zvPQsL%{o6n9q&FaH}8)Bxj!6lzx!r=`{VV$4(H|9#c!_vt?n}Ta*nRPwVYi{tKULw zKIZlC@nz+lHV5a!GQZ1I(wgt~JTR$#sW3`zH%ig=lpd@QMQZ4oA+4)*LpQ07> zWj(OYT(qFQlFP*f4Sd8Z4T>-O^q5PlAZE_H)YpX&OLAa2r<(QAV^u8-s?YjVx7KQ{ zZpC6BT&jVEWh)YmX zbD4SLYPv-t2F;sXF+7mAno@9z%J5R!O7uR-OVgKW%f@B3Zg@OxmQ(T_*`t!S1W}5@ zI%Ai%7<{V@EbI|Zo5%hg*;x=VrTHD%xpEM{YO5|2py~}zVY?#&zQVtXfe{KpTLN6o zgJka23W)dSLj|#voR=e@bi`qrm6BC>*I8bm5Ks)x=hid8J0e&&-$G4_8w))LX*1&2 zhyn-tT8U)Ysv|BkAqNaCAc;wk?68C_!z5Q%!&!-|VSK>NCFTGYVugikfC4o~&4PIW z635LYj;K^O%QS#L4AYoMy$A z2q7_Hkh0FJf$)GhXC&TkySK(MWP2?E7RYuZJmiDhN+22m+f#ALP#aiY3*x|>5(CHJ zqLQKGzE|>`4u&zQG-egpUJS%Fl1S^w_C~^hSPN{~?`-6soa?;Lj4?A213Aymv-CZA*iL?12V$~XidD8DSLDU zB@$BBbqe4YmYQ!wX)r}z!{AmSh+QZ(ZlR1KjFWlHs|YVHnDo?AWrk)=77I)+z>`UK zLC~JC&5Xbl7Ywfe&BPJdT7-QwzkmYVA+JUf5)*Ebql((dRTZ4B-IZE(NopklAo>h( zF1e3TlQ)*KmuL)u5JUo!@>e<{uo!d)9C9Nl5)DB^lsKSSK$U@}cInhez%{Q+941FT zXYV9lT?f1D!&cwx*^tY@sMj_4VfjTN;tcASY7j-#0;RcoFep2UR01~1GajdsSkyFB zhHMf<9!3X*qB_pw7=eZh1tP(eUO_%JgcecEfqWI@3e`eOjhrSO`cj8h<1D~Ro{|w* zS5PHY((G8vQgol3C<*W z(HXKSq-H}%4y@yv2rnP$GpLyik|+D+VJdf_=o7f)iqpWC=BP(nhwfx51%no$y*^?U z+Sh}Mf-|7-mmYacNu;;h3)&dpD<^UzAy#*Rgy9$6Rua3r-Q$y9zoU$oPkcaIqh`f| zYAOKe5{#1yk*<)6GyvlM6p|N+U?-%MY`t2F@EK9>J|0J)j`Tx;_)kOVL9(ww{lKtS zQcGvyJAKE!9%wk|EYuFo+Z(}g5gtqr8S+6@F_7s;qqmTkh3(!pMBA}F$cPBpi5OEO zui|DX9934OcSM&=H!81?!2mP@n|5U9iONf=w4ciE!KVk6%SOQvJqPV5j@CPg$xRA2 z&0yB+qVhTp(rLRQ>)#i{1xHi#zt9zh^sT$x~)sKCz;w&I&I9DA~7g;)k z=t0!fkgdqB8SNPeEdb=|HbBn`x#=*`CNRzNRB;A$G;mbsAujL}Qv&KQqVD}6TF%8- zMw)cneSw4Y0VFS!VnLJxd#}KCa3t#>e^JLoxum(@_o9#ISpk;1lQ<}H8Li7MC`mxD z0HLEdshQroucMjvy@N4CXgArD?dnA6V?5!s8fEo8J7Ac!RAX|K^*fWf&Q^3hscA)~dpTDP|ra1?Cc9U|_n#k63w7P4vB zDV=H<$3tM==b`H-x9Hx|t<}ay48Hb^T75Rry6Hcj1oZZ_)zix$mGtX7?UCRi5s2Wc zc!3pSm}SErRS(78zdt~R~gV>mTFM1@&t@B%7bfWlPs-thae;4cupBKk_96#djbBm(y9Re z{KfLP{B6-Yemv4IFM2)R_m@7(k>*36uJ`2!fSW%&KAxV>>remS2Lb+WezUbk?;cJcUN8Oq>G<=4mM{BF_1`s{8hhaJ2haLweVh=|^cqTzhtMaG-c+AJ zlDAKwXfF$&pYHA-j!z3e-`srv4tIQZK7BlXzJ7N9{`1`_H@BzL^QsGX_ul+?|Gy*F X_n&d@o}T-4cx%Vy&6_{|_1pggvOl6` literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/Contents.json new file mode 100644 index 000000000..a492c77ab --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconQrcode.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/iconQrcode.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/iconQrcode.pdf new file mode 100644 index 0000000000000000000000000000000000000000..4527f26db729a6e639bec5633e4561729c74177f GIT binary patch literal 7135 zcmchcOK&De6^8fyD|!oYbpP)8 zyVV0;$*QO4$J6!utKWXPzWQeVubZdkpNrj0`?s3oj|=@ve*?14l@!*x zmF$Y~>&^SIRoCesPdE3AHCu9_TEC`^|F0#i>@l0mB~>S2bRk5JtTl(4*SOVeQ}r{F zTrxSWH_Noj6>D8y+fgao%0^?HFGir`Oe%Q|99k=@ZWe1dS5u6sfzcYa+O4?aU4u9+ zy45-ab1@rP6|6&Awz`cod=#)0&c(`Bj|9OXUD$l8 zDc9A?Um=IG%5T+1D^RkvZ~ih!g~li8I=*;s>O|Ma8BPR~tDQ`C z6Sr()@?v3|Ejwgu+`O;JIly9_I9tqQa^*CBBeqZs$fktiK-rp@yK_8XktpO>Bm{c86LSLl-iTc<8zt5R*$zl7YiSTkzRrxu#pvY}G_b*lunK6g(ENRQHP9NAW1$ za@OuVC*C#`4^C1K?*+!DIS^XaY4tz@rj-g$yvq6(ec}*eO303&z!sbm`weWVykoI@5n9+|ii=@OhHU6C_7E6B)d zDv0q;lDa29helJvR3Y4!YB5#HjTREFNyd8**6R(HwK;P-j@XM5M`k=Oh}N#K1>7)7 zoNYf!>5@Mxbx^W|YsA8W^l~X-RY-e&l&VUWPNCOIZ;K`BSS#6Dpnq{JSx$;5Upko)h6@IW2}3FD4o#uO~!Z&_}n2r6P&Y;uf5s$zs5O)XNt?n3@Q$?2d%GK8-ePHPr?>Yj2Bf0gEDEa3cLP(+^a9mh z)s#51b=fF|t+c!x>4S_4$wf%+8#nmnVR+D)wa z_E*2GG5nnPrzO2ifZ77oPf1bs1mJ0MB!D6+^39^yY~}%Kbn5vdhKC#jqa*WJeVGDu z))zS-PbNu%vSR9<1QRyddY~%#ojk7kc2#iPq9H!SQ3x4dT2P$F^YTS1Ojr+AHh-84 z<2()W*$@gMG;Q{SbdX1fckLUy!< zmNw_DL7}NQUMM)X1_ia`U+5JBQcD==O#j zW>9eM6AEhmA6E=WMUl66FDk=+AGuL5*ox~T4{%FL?3FysV2eG=uqROyY1Vli5YZJ} z;SHqCf_0)GQ?Mz7$Su05redcwywnW&{NT24!veTDo-PKr2Edc{9h8~XOL7nQT7VS6!)GP7LE%0 zv^b!h0Md8m@k@6ghKyt0lvlGbXN<8xo^dGl`FEdo$rDoxQp;8(6YoB0SZ$_9IK%s>%5LJONgRAJrV>(I&olB(;>4#@Djo{ zQR_pSMH>h`B~xh|SkZy4u8~+2(0#52N(Hh@nzN3-0y>^eVv{~21HqyNoI_vVM`*@NbG|! z5brx?%EmVByaMM@DF`etR9qt;Ld)quZBSiGPVi{J&Gzf(5KXoQSs@$K5dOC-gWdHWxCyp*awYEuV#@A!l29rZcFe zu_V;IuBUrD4w{|-)vC}gZhU^jdijtBBfRNedZf31A$f1#>XPpuMsVLRrFsNP)uBJ0-rQb)`S8Q~ZErQGviF=_r}o{ZY1jWc&bm51J$(Oob9!3k!_jfv ztB3n%u6SDItI+}e<=_7}$>r}(TsnPO5;^pX)8+4P-yrHL8eFZ%Ew3KFM_}899S1#~ zp9IT0og_CsooTsme0BYNefRM0eCrR7r?-n)^RnwF|GV-bhp7#?|AU}vf35clQD4uY z1ZDUk1Pk~flwr<4*jR{^1A2bEzP&p=E_{N!{M~EJ@#)jU`_pIZr?+oD+l_L0_3-e# iio(sjm*3p}ctZO2Den65xv7)*Ahvw+$#4Gj)qem~?}(cK literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Contents.json new file mode 100644 index 000000000..1ccdc2fec --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Question Mark Circle.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Question Mark Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Question Mark Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a734159e588545281b1098f569de1cdacd6e0d0e GIT binary patch literal 2666 zcmbW3O>Y}F5Qgvk6}%Wo3Yg;Xn?Mktv74f3i@Hj0K@aMB>Am)VYnD2m z4*h1QR@ePs+pb@K`$}KES^n#e>Q6<+j*qtU;!;*m-&NyM2r24r*EB^;7RPR{iizY) zNg6cA9J1bl`4n=sV9tg_RTo3i+v1qyR8rO1RCutSNh(x=?o>9p!fzazvt%I^tB(kT z4CPA6fdonvQ7ThwvN?}>&X-IXtdOgjr6{H35=bH!Tv(Ej$yVeBf0Go~q7WhCWHOaX zq=BL<)kdHuHK9&L*bP1`<>EqavL?tHaViXnI~0j@jnSd7m{^Z!V*x_=4%T>xy$!yMUXgGub%e>`(f0_&+E6Iy zOJ~Tr0$5B@6W?B!&XHh&k}^>oF6f9ENJLCWyNn$VOz;u<)JF#H7*x(|hxV?ofA!R?6!Q1b*yqx0_ePNBtJ3%2Y5}w2rscY-!yehYyFYKWe_gtS56sYa|UZY`?(rEK$o7xe*{@r!dHJ`i4#1E!%w5hp)_91-$)gmBC~LLL{5$EY;L(_yo{?+=Q* z_uVzh@$5M4`se!D_V)R?D691_oHQpq7I^h$`>99tO^Kxr;G_?wHweVUC|}qDJQ?)uA{4aIUO^>FiJ>%>{B)wVAevSr#6ZpFpUj9_USCD?w;MR7(oh(xTN)!30BDn$iRpu@sHcS!XGt5BbCVh$%_x4A8|$Mg59}J_GdO6kO>a&Ok&24`Fz5gPdUvnVlRdn ziyLiRS82D!HMZY*h#~OGvkcQJoV{$Cw(sEfGp$B?X4lJI-Skkz6*xlg>(zRB(f)+n zJUscrU79CkE9F|$UHiDJ>JH-iP3h)s(^H8K;_gl0r(fUdSp2@GqLcj`dGOwzyJQq^d*%QD literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/Contents.json new file mode 100644 index 000000000..ee4b37a03 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconRetry.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/iconRetry.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Retry.imageset/iconRetry.pdf new file mode 100644 index 0000000000000000000000000000000000000000..62346da22fe9217f8bc10bd78f434d8a87cef30f GIT binary patch literal 1769 zcmZWqO^@3)5WVwP%w>V(5Sqhp0zrUgw<(IYXzKJ9^x$fhjSH{TT1t`j*Y}Mqk?SrE z81&5rXX5{oGvz4 zgauSx!P;=ia0NqWoX>Pp2F~n5BF3@9sfPp$lm#*-#%KVou0=>`-d9C0h`1a>Qx zxX8#-#LD*xvMN&jx+X}x=n6sj3SduRd5e`1cYS>979U*b?4J#L`NJ*z`-I8YU6UuA!PE{*OiwuaS7Os`)A+ zng+wpd8!!eoV>T0tOj9_kt6FNA*9VVIg@Y~ti8{;HIdDE=OqAhNwG9mMkj;vu6W|A z3p)r>xl7w4I@(l1g;3J+B%(2XNf>bbNNBW6rbGu?>_vKPVq(w{^NYx}z>0J#YhN5& zyx7eOO;$wqhzMwMJS^$E6{@sQVg)mL&}5UT29t*VU(N=Js_ShxP}*c|iUzKovpf)p z5}{`~GgC9ibG literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/Contents.json new file mode 100644 index 000000000..e00deafd2 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "iconScan.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/iconScan.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Scan.imageset/iconScan.pdf new file mode 100644 index 0000000000000000000000000000000000000000..3bbb37489cdc02c136d86f8c1d0079e6b1693c6e GIT binary patch literal 3975 zcmchaOOISN5QX>mS9lXCSr%%_>c zD1zpsL$u1+IRy@o1xvE|3`a;%tV>s&I# z6NpE<;?-4}eF(W^nH}a>be7}9IVIzQlabjMs~H*Q;&V=3uwtCIV170U zqkafKQ!mTXWT2lGT2M@1i#*Z-NWm-&8QB9OPZwzhLSAs3ERT9XpJaihn7wQ$&J|PO z^{B6(HM)n&l^mT24hGRGsQpFc8T*vitS|T@YNt`*Ousp{njvD#(jrR13^P%$<$%!v0f=?e#itD4MhjN zMmmB27v11&r_E7BOUI8I=MDJ*$ie5(c5xBAdAwJ@?aDV>A0(oboI&BH)KiR|=bh zWf*E60-KRHcN9IwqA&c&SX_QBFH)3+RcCe0#%IIoLo^KcTJF(-Y$t|uInV(NOgb15 zqn4#aT1ozf#Y4Q6vcO`n2~jMQd0UD_Jd0ZU(3gr1pS|MQF&VXAh`p%ORF%1&a@p|j9h`v zNt_o~V5&;G=<~QdhBj*RCw(5hLYG;EScFb&Ic)3v=G7O! zvgNn8cu*eaS;|1bv{+j1yQNk@G zl-IgCjR65Qf%c}Z-S>-*dr!y7NL>?qYw29(B3nG6b##)t?KG^TH*~&GitaDHpF{b> zhR8bYTw*mTYE`Ifhou2YGY9R4^8q0U&)v42hCvEw0uq5c)kT+1PWrrVwrdif z#UpQ~{vcXjPx4S|uPRdH$D@iepC4PBulD=H>8RfP!sCnI=GE=PZhunLQ{8mvhuz)% z?eoKD^`;U;o>S)!({2@MG{@Jn*3IsC`1G*d9hE%rmgTMw`x9FnmAvj2@aMmN-^u3h zc5J$O0ZJU>Ww`n7{*F+UoZv<+yIdbW5wPjOo) zr+$9ey`8j5Q+-L+|ENf-78G#*aci_c><5H;E}{Bv`V#V(xBS#H5rh76Ef?iV=%Y># zxAz}*4--%2&9^T|$K&JSfjN5WV|X%%xI`gyZqIrK%F$QiK3ew%jTXA?vn_b`wZaRQUCbH;I#_KCGO# zGjC>|XXfPQ>iRWu#~6Zu=KBu@aDEOK7cADB^vUEBFFwZlp??HL;5u1#eH+U?E3V@2 zZ57w=E@5@M{Hi+kiy;?>17fm zqhL>%@K$(7SkMxs0MCsKUWJ4>;dDZT_rY62oH8N=sF>ployO#+q_p0EC3Y(?v6H#C z4h%O#AsMNdCMDLd6osSHdN%NQcJ(rTq3Q=xtlafT{JEXo;cVFrn0 z)Oe@+ltf!Jg2;L(pL?EI^dCYP#S1j+QgGH8Ob>&u?mu}A8f@ny4Asgp*`a^-@P9vpWfAa#i z+YO}(se(03QC7_pC5&UTGf{WUWRI9qr0%H7!Esgg<*s=+c71N+Jrm&AFrw)ftf4Ug zg2#gb4mYSXL_6geLP68|Kjf&ybh0DLG(N`=ZL|#aZMogWmeHCo-d~X%r(Ls;XK=dR loDHHB>!#@;6?~AlxZVDZl>K4dmu-J22bD*5a`N``^*^*CR73y( literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/Contents.json new file mode 100644 index 000000000..29086eda2 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "socialIconTelegram.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/socialIconTelegram.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/socialIconTelegram.pdf new file mode 100644 index 0000000000000000000000000000000000000000..812d0b29fd65f98f54ed36466640d0003427178f GIT binary patch literal 3086 zcmeHJOK;pZ5We$Q@Dd;?5Q)P#fxtlgM9~Iuy*UI3dXQ!Lk*-(nN-muI`hG)cwY!#s z7U;D+>{1^&!2IY5cmW8bTs&U(-yRxS zp0?}z5&M*Z&mS+pHg!K@XY2OyAuAbH^Y^fp6^+_t`DtCPx`%4rtmjwv;s>8$f zNq&*4P+K_V48kkWuGl%znI!K9QhWm#KTST~^FhXez7rw4}PsEAnhmN9KiAkSEG zHsFvfO^O1gY^(RlL7I<_VK7#u1UeWC&biSi6N4LF)+U7r?NpEoE-H9nlO`-junG!2 z`>ve@ZJ|&)MzB^3P^7IjUV6601}Ae=z3~Jnc+!F6f(*j}K%7k$$FQJM!DbBJsF>My z*yXT`9H?bxjq?fzA|Vs0#BwMnXiZVN!h3I&g`wVpa}NZT8w6sG)MAd=!Vx)`t_uqn zf|s^PU|WM(kN~9~=RqklKy&1iiIxG4M2#y0W!4bOf-m>s#zzTQ-jHGB!@LpL{~N*BgOH2Qno+(xfN>+3=JN?Rf(hNWEi{4` zn%Qy(orIQK`IoS*9tXJj}>f9R$B5;%G4&lY{v zH+lVp^55b^)%}rYL)+)iy{^7({`<4?OmfPN&y4-G*;l!c<@@EsZS~KpH?N494hG7> z$jOr*sXI8Bo)DY*z+Je*)c8;e8;1VXL!$&|H=QU!?Q#2Zak9c8O4d(7!u7p#^!wGS z?K}Bp^YA(6r&KR-dvC}rKQvc&)qi_Labj$qfJg1B#}S=m4mRMx#QK5OD>Ed?eu>;|$w-0Ib^cjT4@oblw3*yRuz6;IgIpiG* zkH=)h(B?;|Usrd_W-XZBpN~QA>#n_T-pJQ?S8oQ2%Zs)Jzf50_R=K$Q-Y^&WMO>}> P%#IGxiC3>qKA!#!2PTnP literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Contents.json new file mode 100644 index 000000000..022fa4a8f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Contents.json @@ -0,0 +1,22 @@ +{ + "images" : [ + { + "filename" : "Icon Boxlight-2.pdf", + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "Icon Box-2.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Box-2.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Box-2.pdf new file mode 100644 index 0000000000000000000000000000000000000000..96cf383e6c389b0cbd5883cff364b03c76654650 GIT binary patch literal 2679 zcmcguO>f*b5WVwP%*8-bz*>^xhX@1#8runqwy3-AEyzKYWqSj!l&+M*?XT|)MGd)G z11WNdV0gJtocCtlkV~FjU%ow8l@~&Rgz?Xh0^rpv*jzo$?{4OH?w4;WesnF!N?C~y zynem>iGH}HFrkm)f9Z$&`2lJKw>VKu^Pz9|VsqL5z3ckzyEkxgQ-13v@t4?KDY&16 zsz?Dfg7KIiM%Gp@10%I;YM8n~XtNS3y^i(;YOC67i<4DTIqi+| zIfWdN1qBB%#)H#WnW4i(Q;AuL1D?w=W1Yw$8O@{T-j>P_;!X_WcXa#I%4cl0RS1nV z9^9Jo*KMY$S}F@lR=TlX8Q6=ua<$QoD?nU!$}~(#}Z4~GkZ~C+5n8u%DDUC zn>L1=l#H{|7hv?nX-yJ| zt%S%XR88K+d5gu~k^A_T*is)T5ps%D8KTxxQz<(Ja}CUvA+9yL{2feQb7u3_W&VYu zxf$$xhS;fGNKxA}4y>wdO4%OJ__e>?wQt5Jc%Kho{>jN_T^_AW z+kP59AG&@5y3TA9-NiV}{eX&eM_Iw^_JA1J1mPWJt%0C?6Z&~~i>U%tu!U9UV*HG; z>LmXOk%Gw`F;RgN3+BQv+PQrk?~g;D4*i{w;KlN*N&mrFi-#n_=}~ymp$7(rJmz@> zX@x(EUqTk$Ii6MPlfXLU!1>Vb9{Yo!?)`L$cD$Izeg6_(>~3E!rfjz3I0F?N4c^@B Y{_QdQc=c-!b1X+2>&4mG)o*YA0|HYdxc~qF literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Boxlight-2.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Boxlight-2.pdf new file mode 100644 index 0000000000000000000000000000000000000000..0cf9c342359857a4a4538aa616b632c1d5785b84 GIT binary patch literal 2679 zcmcguO>f*b5WVwP%*8-bz*>^xmw+HZVmm?6265ND1vx0PY;WL|(v?!U{q>!ps3F%j z(4vPd3@`VI^JeDFP@I#?^LMAJ@4r&CqxKT{=p>OwMbKd{C>-z2cw{Uh<{^}<2huB;wxSfQm zq6>-6(&Cg?PoMFlZZBlj7^S>J%NoCor+94$+Q8HeLYtLP>2{AHYf}u{Z0b{&)`Y1DW80bpNp4i~IC^OcH99%~8>ba+-=R0vD2JsuJ{Zz_lWVTh) z1c^erHR6AlnYL=FEGSezSg#E1MP0et=->(v+fJF_G=!>luBp*rMY1;xGwmXVS~?4v ziXIVX_P8RQAkxO0M9Q8U<(kM4sbYi?Dm_xz5#+!!8K;zeGSrE?Tv;ZhwoKJ-uq|sZ z1L(>HuNninG?|ZkvlC?CLhXxv(Za}D0<&d^ono61P25M$oNiP!h-@4XJ7uI392;Z2 zU?xTihj)V6nl<4)V#ZtR$axaMRlzpKI4rwUP8);eV}$ByJ#=W7FeHdg1os)kuC!JK zvP|r@qCV3hw*n({Osx*aOJK}a$`~6gB8iC+_D6PUSHMM#>%PQN^vqslm<|9V)EPHF z{jY3|^2!jEo{CD*F_?2;whVEuQRN>X@)|RXx3>8s zMRPG&_YAR8Igui_XB1eyvM6PJ7|g|BwhR?Yl_1v&4>s|YHe1K2+0_ImvzU%U8 zW!m=B`2EoJ6VN!bO>}4DF!uv`q#0!eFWUoRU=xHh%9;Z~c@p|%ca5O}Ww3?S&)N7L zZPk b@aAgwcaPD>(XTzsF&%BJ7bhndAK(20tL7yo literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Contents.json new file mode 100644 index 000000000..7e36cc264 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Contents.json @@ -0,0 +1,22 @@ +{ + "images" : [ + { + "filename" : "Icon Boxlight-1.pdf", + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "Icon Box-1.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Icon Box-1.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Icon Box-1.pdf new file mode 100644 index 0000000000000000000000000000000000000000..68538fc7722e27d3ce8d74191e19a9fd8048e3da GIT binary patch literal 2434 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 K#nI8_=c|8u`By6d literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Icon Boxlight.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Icon Boxlight.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ee7d707d81c939d72afc209636860115b8a2c6ee GIT binary patch literal 1612 zcmah}+invv5PkPo%uA&f3CH8RrK%E5FG7GQDQ^`I%XXUvHM@}AqQcj6yh(PGwh~s9 zOpZNgW{$^maCLU^mSqrvNm29thafsWrpftJcX{0vUA6wl{ZCntl3L|OCnxKVsOsD7 zCiI^F$Eu!p_hbOha8R_}sw$RZa#sCbl-2C=l&06a|H@YU5|eYLc`I1C`Eg|czwcJ6SG(o#)h@d6Pht4l_D9LOpGBT>~P)z@!lJkJAnU@|87 zKw2heL(grkaoWHS$5RZ><9Ki?xPTlW6)S5M6S86Jtfj1;a~d(NL|vLQtx?e-xCL!A z;LmJ6Xrlu;sXgZiEH%=ABtTfB1%W^s=ncPUql-`-**k5SHBy9J3Q|6ZAi=Ie=vCDz zcwiBUC5CuOy1)hw5ZI)wbdo-LZxxK^H&hBV#+$w~@{8U)*X`TR&v-o>lF`G9w*#6d z#=E+1x|VLfVS->yzW(`H(d4R_R~z6{b-O4|n}N7u*XxxnBIOkbOVTi&fW` N!)QivaB%+l;vf1pS4RK< literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/Contents.json new file mode 100644 index 000000000..5bd0b230d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "socialIconTwitch.pdf", + "idiom" : "universal" + } + ], + "properties" : { + "template-rendering-intent" : "template" + } +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/socialIconTwitch.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/socialIconTwitch.pdf new file mode 100644 index 0000000000000000000000000000000000000000..cc8b13ceb1bf5efd4c97626e05402ab6f9697306 GIT binary patch literal 1645 zcmZuyO>f&U487}D@KT^XRMv+r+dxrZP1j-AhIQ#~#SWgMrWq1@v)!TFuP>>@l+#)# z`H6gd{0MV$dwp}RWiEsU1?|sY0^s5TE-!^|R`e;%6i+_;W<5NDMQ}-0{m}VpCz5Ob zcT@Z2hbvgzO~2}1{1IBJa6pZhbH2TOPMUZ=|jZAf3mSvm?R!|EzV+y|T6Pq(qi@;h?F&T`pnIb~Wfvzk(N{e*y zm0coKW0}b`3z3~P1&*5A_ft^;6j)hgG-BAgLK+oDb%NzmnUn_5NNRAf%VeI@{LW$% zUrZ|vRi49eqHGyt(GY7F0;5(E6(&3Co<}(wnxzNPh;M>6!{KK??g&~3``w|HN_lmp z4C6{k-Zf1-^l<+JR}7xyw(5K{Kt`+N0DbYRO?A~i!+mVvOebUMN3Nys+o!JfJV2B=QhmGL(f4@BiUwaHX*>j|W_h0g9vqGsr87yIpvS^=Bus(>5MEx<7J7S_p z{ZW>C$3-<%+jf2I`rP>kp&%Fg28AZMEVCIPd^j4XJ3KTD;l?~zW@LL literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/Contents.json new file mode 100644 index 000000000..91a81da9a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "properties" : { + "template-rendering-intent" : "template" + }, + "info" : { + "version" : 1, + "author" : "xcode" + }, + "images" : [ + { + "filename" : "socialIconTwitter.pdf", + "idiom" : "universal" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/socialIconTwitter.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/socialIconTwitter.pdf new file mode 100644 index 0000000000000000000000000000000000000000..b114e3464a5f4c468af8abd49e045cc862b72420 GIT binary patch literal 1677 zcmZWqO^*{f5WV|X)MX?%;JEy42_eDEvRVOJHtY@UA@npuRx{m@ZV>S6d1ZGe8OA5) zxxQZ2>&nI3tCvq$C#9GSjUWD3L{Fd6vuCOwuH~n)=lJGzKitfp$N}7n)ifXa-JRN8 z_22egzy0$CUA{a2)lKS)Vr}XnvtFJYZ^t**4##`4+Lx4#qwenHd1ki6nz});t4_{R z(IMEFnBZe|_BN#i5CL;>1jum+Ap+u@txd!r9W9PP)-p%x#MRlI}>j?_8F|$luBNeE_Q!G-Flvqq56%f!iaJE$L9kA#(e>IEX*#e_*cj=3EiF^l zF%@Z@(Zy!5LB^$TuVY6YxWAw1e# ztuikOgIfwUwoXs-1yix0Qve6U{Z6t5HXxLW)X#>&||ABJ(B=>30KK{%VYyF)+Bgr?ATf!_4j``wH2JH0=(@w7?ex?T8q zTVrkeY5aQV`iW%Ct>G@mVMdCHWXG-Gzdt_rlKiGe(z87%bsYEO=GFchrIIk%(wgOR z{EC8kDfSd-x*sXtizJz*dn}vdXbt(#B5Q;ZxGhlZxHs-1E`!F=fiG)+aHun@2@Mgfgc5WVlOm`kJ<; z&&PY?w>!JJx;{f0gg{WxeETi{&d=fELgaeMuR1~UDQg{# zU25wBD%u3EU9z-6t%B!1$bvY=XipO)L5@hI-Jvg@J0Da8MRe9Mw!yR#X=|S=dLE2i< zKYSZYEppd9wN>tbPsLbm-qbyH=zx#J2!8qfBXjSEOg#^d4bzy8Q}KSaB&NUu7BF_1 zH&4VD2d?`<-Ek!{!a*hO)E$Z3CCEkDO=g8{>4~xCT3+f3n z#Pb;PMy<^uU6* a<1KDie=@P(-ZN#}Z{?(<#BBEF)Ae7rtO!g1 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Contents.json new file mode 100644 index 000000000..5e974e19c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Wallet.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Wallet.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Wallet.pdf new file mode 100644 index 0000000000000000000000000000000000000000..6d31a81ec031b58c870ecc2ce87981edb2901de7 GIT binary patch literal 2125 zcmZuy!EV$r5WV{==2EFe!inS9Nu;V0-BN@AQMTMF4k4Sii*^&(q^R)qJSWcBZSi5{ zeHp)*c{BDLU0qzhR9TpvyO-ZGnHgtJ%|4uDGu{kMCjtu}+DBk6(>$*- zLrUhxqy;ucPTVQ!#Y=!1q4MQ(KzBk}nN{Gi(Q#GCVvZ7LCNKCJFb)Tt0adcHC6Xg> zRx&ll>Wq|YLNh~l1&`4F3RZ&rJqGe^Y$;v23 zEsa)S1YZb|RY8Oy?peK@f)F86R*a!WFbiX#TSyq=&C5?r&_vZ_O?Tp6pgvxIE%mGm zx`p?=f#VdpLppEUQuwmV3VXAUqBH{ zjQTErhE{p15fCg@g&lmNP;<0VcQO`<9SqS7(wNHTC>dL3OVS9)JBcA54Vr7Q<03dZ zFBtPi8~=&T**LyW3{L6#)EEr9FmHgE7<{ZB*K%qG{^v?HUkG#q=&jZnL|_z`&4-KX zT4jsE-9HaSwGW_`xh^LXrbE}v9T!T^5Ms1TXEKPK3z^S_Wl)uiUn47x7XWcG#P=F} z4Dt&AJ_ajkEUq>>hFwJIax4J@feS`U0`H{1HWf25l*2>1~Q&sW$jOzU>&9}Z1BkQ-8K zPq*s3vF+f|O{fLDst>@(cqp1<4&wQieAsRfD!B~SwD?)|4>+q{#6JLunCufKm*Bt- zL*lD?tatt0)1!}v_Ew}+h`Ht5FIj{75n#VmO4E)o-~7^u(=CRSDPBTV@!YB?o^z=Z zeYS9ohkCnf55iUN{RQMW9{PQILdV<9$t+5;?)#Bk!jr(s_4aRz=%>M7AI2#icbUb} J(c90L{{Unwvd{nk literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/Contents.json new file mode 100644 index 000000000..e648fc173 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "info" : { + "version" : 1, + "author" : "xcode" + }, + "properties" : { + "template-rendering-intent" : "template" + }, + "images" : [ + { + "idiom" : "universal", + "filename" : "iconWebsite.pdf" + } + ] +} \ No newline at end of file diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/iconWebsite.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Original/Website.imageset/iconWebsite.pdf new file mode 100644 index 0000000000000000000000000000000000000000..3069ea83e40bb33159c77ea589e596da8d1f3685 GIT binary patch literal 3244 zcmZWs!EPHj5WVkL@M0h-5Q^lGLlOuAGkeAJ6~P7T69gs_)a{do?YgL))Qebae66 z>h4%uW;=WytkWq)&#YL-V0=mn1dz5VS;`#*)zrY=$BZo);jwIyd?aH~NXlr;NNNt`*`i<<3E;GAmTv)rH!fleEB)jc z098%^c{bK9pwjD8?)E~d@PevYC7n!?>I}{6dUdAppTGu0`y-3M>KuBOvG<8f#wuqRJw^PSpM&>45T4OL&e1SkDOY_75BPo9s zrlUexlqlQER~ZQ+F#uzd&k|WDCk;59LQK7l7+5q!xnvhD5EYVBWR^*ZWEjV+qu{Rle_<&1<-kXZO_BeTvX%{gLzo&>y(9tyP!KC4U z-kXHIj+P*1fvSRGVAeox0yP1HdT~qW!Ro4C2i1_9nDkY?xGk`QoW$w?IL11}7?T{> z*#LC1&Xn_7*?`8ZgXMHCi!K2RI_I*`l$7g$lcol^tM$9jQCu z66n~zPG#wLWh&4PqN-1psh~I@%}&cy;?i}?Py+6YX3cFT3kPo_X-3~B(r$w`kj14@ z=7H1O?-m({!>L?cK+m`mFDYsdP%Wx=0V07*7qt_vCG==S)jB)sMS-l&YkIwVHRiJ$^yKwieqL zI$y7ZN9tlF+39@M<&=24xoq~whwId@r}5KZR2-&G=%QLtCoJ9T<$$PY9p|yg&o@)AWF70e4_9PCo^F58__b;?sZCRVuG1 zi0xefM1e9LrBy7gT==69#%i04;s$;f-VMQkfKv-#kc2})E~W%zDUljLE`Xz{|uHeAcpE;LkFH{UsgLPFQE2vySY9M zZ9n1NFdrws%v6HGZ^tDsg!olmH+@HUU+jXgPyG4UcSG^E+?xsbV0Kk`-8|DB&jPgD z;vbfeRG6-LYPIRet)OBGw{Gg*)Rxih9}jNJ)?#F*$N&Xf%0bv(@w;kgQzchHL7r#b zJlV7IB>&DLL8SaBk}I$SAs4d~~quJicq#>#QlH3xG}XVva}6eTX2rYBeM cAaHzJ{WdoHVXc>KKa?X^`GuIxUVps#1C8XXAOHXW literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/Contents.json new file mode 100644 index 000000000..30239b82b --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "4 dots.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/App.imageset/App.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/App.imageset/App.pdf new file mode 100644 index 0000000000000000000000000000000000000000..521c9c7481fbf4362da18625ad1097b9e1cc79f7 GIT binary patch literal 3502 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 jTpkSqL&v)w-1l995`KCo;~~Q+t2?6MuM=c literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Contents.json new file mode 100644 index 000000000..f6402c7b8 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Bars.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Bell.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Bell.pdf new file mode 100644 index 0000000000000000000000000000000000000000..50c9cefe6dec4a69cf259816cb1dff90f1ef06b4 GIT binary patch literal 4135 zcmZXXTW=i45ryC9SImn5+kl5%-PJe1Fknk@5F|kqI&X#_=+#=LLGH#}I&kvq^PQgE z;Y!*EVRYD+x|}*y{p#(T@4mF9PLs`HKK}IUG|yjsHGlo}v_HJlf2Vkj-~4TVc>ny% zoB(gN>h%1yzk8f+-t7N#zuVvb`P=#R_t*d1ou=O=Tf+Fw;qvk2_O<=ZmR3sXecq7W zKM2gNq_%>VqXVX;^ynT0hS(CI zEj^`FfPBfJ^uX5!5vQ)-yu+~bx_-ePuCZL*TVZQUp`|?cCA5&5fs}|zX>N=65NjM~ zdFmn6xh_2${;(=q?>T^Y^IT+C$T@Tai78nr>(?Ego6L3eX{wC?54JKYbAyktYb{7p@PH~Gv*s#G35>em&(0-kPW_T z=}vkVBhX%FBZgd{j6*DPOCnc@J2zX|3JF*ST{e(Rl6)_s!3J6;ST&KHv{=L{_?4Fy z3Mdd+!VQ@sreRAXkhxToO=4tmjL)PKKOly-k{9J5w!){j=B0XVn4)CWRHXmFy;-+RCJHp21ic3J58!uIHIoB@3`wgzO{A zy>_b(=vI=Pb3$NF9a9UC8|sW)gkqx1OUd{`&RX-U%JPwLqSu#8`CUOTmAirPp{>Lo zwumlL4HbYzMKG#(REA`*$Cyjx?Cw1`_=UJo;_zWN0mjzxLty47#Q~(|Rm_qhit++x z625{lk&1OCKCdcP;Is{}^*|-AE1{bNt1m5AGlIgIHG4X*q+CT7z!qze+>E%c2KAU) z5=83dUxj*!sv3qDxV4%CEd!SjyckH;SeL0@14<=EAEvaH8myJifk61UwR@;gr7eYQ zQ>@l5I=@!A0-boQ7z?`7(;U z!VW}(3PjpErj6M2lF#CT1m-mEZsvI{Us4Boaj_xvVk?^+5(PnOPe>I|PL6)+JVK*S zfu&~(p33J2m@KGUrnZ$is5rKELo&6MdPZ`MFk}v4vqXbp7z$lJCC3J-2RMyR25(@a zeyU_*oYv7YC>a8#4OQyI9v?(Wi)466pRR%?okog>tHG5nD}u+0DnSnU3bWP(PMM8N4o&8wn8ucOn%288IWR1wI@G(f=EV-fWLAq@cmbTtf2 z2BL8=X8~C#8oiv+OP&GI>5(YK6fi+Pb3Na{!jAc6o5 z0j+sbS!yL5rG`imz7ewlS|ii4PbwfvIDITJ_Rzek5NU)UVvG&}A$d@FwT}^mvwdOw z9Bl*FB1Wt4pT{MH;uKwtG<0Qkx{Ta`RC)+44?EH05wWK3 zrr3gYBBs>6g)DwF__!8`!n$O{k!|SZ;yY> zKU_xlZH6a`+gtDD>vGcV{&f8PX}3SkdVb!Xk9&PQJns+OsJG_@e0%ofC_3?N1+9&p(K(0-+e>iLq^Tme{1@H-^ruxyU3Ozr98r6P*o}cdSANEg^viFxa zgyXZ*@p1q8{Mr4x&)1;b+#Zk5vm71)zWM(Ce|xMSPx`y3=iyGGp--<~{play{U1#^ BLsb9( literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Contents.json new file mode 100644 index 000000000..c0a52e8cc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Bell.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Browser.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Browser.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5402a273b5d25beed4c74ecbea04ee525f7cf914 GIT binary patch literal 5500 zcmcJTTW=)Q6@}mHSJcZ$5Q*}+UnGPCGa-r+l!?h3;=%MZgVETX*d`+UdcL)*`gD2B zYm9_yR-fx$d#$~zUcG(u^=E#m)8uD2pMLmxn&;0ypTGEGI^Mt2Kc}$Aul|0#fB*E; z909L2>hbB}cyl*hy*d8(_HexZ%UAR3Z}4Y||`}*2lHxgQ903#FJ6LMGxi*G$~p=Vf5 zCH1P=`;oaiU$~yIP|KD%u|#$hmSVFNi-(G!*>S0*1yU7OA$xbNjm8Uf zn94$;bb@#R(-M4kfsI)%<{XtzFS7VB{WQ6yw~#u=A)~uEAi2YmV9L97Me-$!Ao87j z^X<&V2>b=IoAl~(VZkwQ_Y{{Gzm8>?Jf_qo))E>#*Cm(k$v24P2-T=>K9N9kB2hyp znVFiG02KxHmc}(a;U~qRhol-lF!mbAVItj9??hl=2sAX4-qIooN*E#Eg>E}0Uy^4> zhawsi?O=pxw}4KM*fF~ovC_OVhpd1Ta3ix0oja6*I-qLgBAawl92EoC_fple9;=7|TD(#N3L@J|P! zqJ{P6Sm_(=oLneL1GFcx;Y=2-TB*?zX(9C#SMG~I#N#Ghn{81bgJvpXh*Sj|xYo2z z8O$Ez(%dt&nG+iiuo1O}A=}peoLV1W-Pk`V}$D_auxew$p4ObZ0u#U0PaG2eO7b7~KYq-@o{4llM9ibg2pjM%f zrw}`OUPnx}c!_CRQ99-=tng-yCuU6=DEhQ0Vo(}}K~YqA!q0Qh89iXDYBtyA+Q%61 z9ubZekONEhv_PIwE;O@Ox+9;+ERv@?bvLTYw0@D;vR{r2WS)z3RXP86~Z_tGimyi`(&^dpqEr8Z4wcIV7vt2M5~f4lQ#`+a!WeO3svqg z6R&cSqD8u&6>j@|T*B2mRLV;#$V16UcSR`g0C7ZuU_uTwiaI6tjhq_^P~Fe~P@@cy z_)<1yh_EV^9458)tT-9brshyqv+^C56|)S)YHTYAN9!1wrnW%+H4u_3<&R{gvye%T zZg=GG1yZ>paES>Quv4wQ=x2*T*FIs3GD>Gna>JR2xKKz;=;C$CG!Gs6Q}{%8FN~%+CJefLDFI5+4!3Huq zX0<0H9jQ%vf5RvcB4By)4HQ?8y^^X5C?tSl$q>M<)iB3^$H46At>VwFd6WNdA+M(7k9d*dIf z=6#TU81WBLt5v4x?KG`I7xZ$ylQbzw|4j}JMQ?fQwp)|?1KH_$U_;JhrJ?5CenZUT zR71<-uD9i0pYETI_w1+-dS~$M%>&rXd$>Wn&whf&=fJDK-M-_fvul>$Iw0|DOx}cb@T27AoMpTX0Hzt&!ONi6Q3S#Za*9!Cb9R|H-zJp$J5>M)A^Izcb~37 mxw<}`o@QOx0(|xD?Qcg;Z{JC89-izvYEGwDum1dxuYU)m%tTQD literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Contents.json new file mode 100644 index 000000000..3f27bd6e6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Browser.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Chart.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Chart.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a95eb6c3a4d2d726ae694bfbf655dafebfa2fcd5 GIT binary patch literal 1656 zcmZuyO^*{t5WV-W=*vnFiFQ|4S68=$kYG1NQG(bQZYT%GJ1j=tnZz~`$*<3=_U97j zRDM&R@70vAZf{;cqoB@_kAC{&v-AG>bN}Ln8^$~P>Cz=W`*j%acb_~1oSWBnw;2`> zZgw;Ly;=_QpI-UvcbC7GTlbfv5c}if(Rg;UF5b!BDTP`&*X)-M=g5=W$=EJOM>RyL zRn!xO8dXd62m;EbCZH+ACe)fI4Yd)I7{(e~s)iL-%F!^%O-u4i2Q;^+TnsIewDf3B zB}p<&DYlB-8c13zy^1DHS@+Sg#FTUQWUUo-N@${qXpga2bO}|^$KH<++-s+hD6{nj zO-hMEe(hivWwK1LM1Y&ciCaS^3X~Kro0U1U`Nbf$aBkKSVYaLl??HN&M19_&r6;M$PsQ$|hFe3Sz3aC8`7(uveNPe}utF z8O32}k-|NjGK9h&WBViuRv=(KEENzI0`({aGNE7$84PknTnUs_#hOkn<FQb7+zY*h&A zs)AyGYG~Rjyr4wGm(thyJ0IBEeR3avaHIRp*^xM0faAHa%dkHqgt1Ro1d5!m%k1Si zPP?uD@H?&zp4t0<{v7=5c5y!(fH%Y4YVm6N>OXYV>@b{-WI}f6Y#lSrhwb!bvmCbG z?%Dj1?s^(`!-$G@%#PsgVgt;}0lGMO2Axjf?3dLYTJ<);+#l;)PhSvA|LcDX*@Y+=-18g(cyD)`&s+E`1n~o;KPGYxm$ibLALw$oFJlzdA@<5 z@;4Ai5cb%M@i88u-Da^`4;zR7hS|?IpySDQdKjMiC#$=sds1feY1(-kxDz~kxB7QL W_x(R&vDx);aNDxGy87|$>;C{0MPDHR literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Contents.json new file mode 100644 index 000000000..95d6931cd --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chart.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Chat Bubble.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Chat Bubble.pdf new file mode 100644 index 0000000000000000000000000000000000000000..116eee098939b9fb25d838c7c9e85acc6e71b76b GIT binary patch literal 3051 zcmZuzO>Y}F5WVwP@M0h-5Q^k*_yGg~8oMcqwy5j$7WAOX8^?t$wUSb#{q=oAa=Ggy zI#F+D$oY8l$cyW%H!qw?N;z%y;g3I+)-PY`SFhBxzm>nrukp=K)Bf)KK@-3mu{xcP z)AmtquBLzPchk-Hul42I^}pRo{jHp_^{4H;crjM1Z`_RJTVM)B?;aP|VK)}1-CiXl zPE@pu)hT)XsAQQE^9p1WO5&0#L^;@~+1MC817cGsWOjO|$V5wk1>{W01?^3UE{ba~ zA-IINym8Jl<5X`-Dvk-R9=RoJgMb`Tb_6@gNTPG5loUCxAPXxd1l(M!T`{(h&AFP@ z%`&Wf@vAd44tJbU9UR$1izbF#O3)*IgpX**E@`rH3^&OV%UlD*!pCGYtjOm?vT!Is zCM?+5L_s#lF>FHd|_-XO2<8l8B|67D;AKwP8{)Cs53ZQCGy#pq)aAI~4|qL(m`g|@)MEEN>2 z5q2r{f=QFV7{v$m0kE_Y^l`cRgMg0$mJvTzXDa3BPtjJ1&9E&8}mujq};)v{<708M4?d+m1ncGO%_w6;7+O zCCXwP45dKz7)d5W29m{GELkT6h)+q9#^+WZ2s2~&amJ`33QsAEx{h*_@gjOPlf&8K0&Z0lP&%QzEik#XBF@qxWgE!T+s>=|P0aaJ)5oqlDp#Tq++R=hl z)`<3jG=e$jEu;kUCVdyJKvQsCw9AjGXu{f-iX`M}5nD9ylKm~TGT;h=>=cd}qG=69 zLRvsFWD3e9tqwx2oeCy-lFAU27-GhVAwV8o@)D~n-c~J+!G@fGcLh1Hv@V*lDy0;YF4!pm$TQp>~;5@xANFzCnnra|0vOZhUxxYr-Mqx>F6r z^(F*FH#v7ZVSMAHllsp0=t?P{fWmUy?b>cK47Hr%+D?_J!4*6QEYYF=Mdpio#F7N) zROe96?a4w6#=wr6KsxJW%cb56w+O(f?^-F?_~Ih2_eD}5sznB>L!vxiQOq5L^!+z# zuYOhXF6)o3`GqErvG#KF!P)U}3j@Z3Zu9Mae>k7?yWjD^!*BE3zkf}7bG^NrI`H#! zd%t~s_@v+UIzkRxjj`}wSc|zXw?Jf`d^R&l_@_wAb>+KPk2J~H%k6plaJYNw`sp~m zS5_w_oM}HDnTa*v{&T2`{Pcc6cqBcApcJ25VT#bECyqWstUrSi#9)Tb$L;;YbX3y4 zAFfc2XQ#vC^jtr?zkS|{vbi}N&RP<#1>U^9|8GL{^;y0>o@+Wj`=Tx`zWe3P|CwfM Aa{vGU literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Contents.json new file mode 100644 index 000000000..905119baf --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chat Bubble.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Check Circle.imageset/Check Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Check Circle.imageset/Check Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..491fa136e8a5e026437fa6317a9799686607889c GIT binary patch literal 1737 zcmZvdU5^tt6o&8pE6&YIP>G3;zbzpo*ezAnqHaU)5Eo%~*bPc%+Dxb@zn=Fv89Phy zmGg}Ko==}#-QK)@#$8m3Nz?SSp+N+YjqsUeWd2%U}Jh{!!fNvPdtRXLVP<)s60QcEM!o_w8o=S~qh)s=VlNz|Pyq zv{$}k>#VWVpsD9fm!fttQAMI*Lh{tB%8EqFOic?;VI^uN7t$++YVaXO;sqAl67)$z zv>LiF*`SD=T)U8~VKuWA_3A;@G*-!dV{E$|onud~(6RZe<$PJy+<-u~L zMAGyct9Ef&gvvpfvpRc6O>Zf2%_c^Z zD9MEo3`q1b*#LrU$0$XQHgQG|D`W+x&~ad#JdVdMrW~9DNuE8FV&@YSBJAlLjFo#Z z6AFWX)6zgYu)xM-D~5tMMw|&DN5hgLZd+uP;<$A)&V>2tb@a+ z%rjDjNAQDcNh5#!Nsa1HB~#}-QkMB6qvkZ17`drq$yJPTwR$;@({ZME?=ilxR)78X z_du)L&HZo&Z-%?==GF9t-nAiA`^o%Zw1bF8|N}8RSAKJW`SX=W4J8e!V$vcGLait6vVo zN2MvM(*@WE4s#@&Ol?yr^Hrw5BP*S~L yZ;*~B^RyqH(v$7o(^FDb>uEZY1Y8oldb|BP!29y2vpF0~IE?qBuC9Lm^tow5uSQba{VZ(%lvCG z%hR_PG`ZP-n|0!+V5x>hYP&fdcY9|(S{D>)={cCdG<)1xj-QR2Zq^8nQag^?5nE|e zjLHy{x5>O6ZhbKf%req(aa&Y3xL{v)FA`3=I)+h}NTY8~c7mDIjNC*q+Q!LX1 zi#mFbXjTSig2FuhGq0I=5O=RcBR-3wxs9N<>MKH9tI|b1Y7!0IX|;OYG;QC}?N?|Q ztNQZ$N2cn!zRw%*G0zwEMf*&*=+B`P^@w)6t*2@3+NaelcT{f2bmMN)Hhpdov0RNU zyslSZ{s<-nO6dT zn(Eyp+Hu^qkNJd-7xR;KQ>tm(_EZWU8eH8h{$yl7{Bi14Ka|7pCXSBYe7gDzcwP#& literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Contents.json new file mode 100644 index 000000000..63f424bf4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Checkmark.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Chevron Left.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Chevron Left.pdf new file mode 100644 index 0000000000000000000000000000000000000000..43e32394867daac645a8cdb7d6a6bdc278a6ce7e GIT binary patch literal 1211 zcmZWpO>fgc5WVlOm`kJb)}@a|~5Z zOK;&oJeAIKB_hZ?QVN(LO_kx6S(s8aWtMX%p(KJTOyml8l{40Q*w1QE&xEuZv560R z63n9P_9ic4m#VV5zst3qMD+Q;I1>QXZqi3x|1@Vp9eu z+7m`O(^B^oh_IgGD6^wNaBcA9M!nNKCFTu>;i%QzdyP>8lgBM1HA7^m=PCEnIfK1h zI`lPZy+?3pA3n@lNCe z-LkH_P+`S*Ax3arG>8Fe*h8~x6QOjSvX8qBwhD2A9L74!`WbWiS^q5}GbVGw6bEcm z!D;Yi(G~l8dz$*vgh#@_lH-xbCm4;c0fdLe@wnrHDnY2qE67AMokkgV7Uj^5ucEv} z4Tr?8DR%qN5d6PnA66*GMOz=jC0y(_mq$^uyskTl1NQ=F_q%@qyYK%qMbq`;c+bdU I@$Spre{i}9w*UYD literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Contents.json new file mode 100644 index 000000000..80250da42 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Chevron Left.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Code.imageset/Code.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Code.imageset/Code.pdf new file mode 100644 index 0000000000000000000000000000000000000000..e0b8890bda96c4be056680fc085d10fad064252e GIT binary patch literal 1982 zcmZuyO>Y}F5WVwP%*8-bAQXq>@B;_}GBE=5XG7GaO#s-n@CiIx59vX#DV}B6|6fUcFNNa94gRyT&)a^uzt>6FGp}vTHgW z``v@u-1PtKyMFuQYr1~B{?$$DZ^hcoADPSIMO&@@=WUXdiFJrsjHm8liEP{2V(JFP zMkkkY65^n}$I=jjSi5Az&!}@EF%q!oI0j2BI++v&D`c|Hd!!U?L*#6!Q%T1VoCzSC z6Z@Fy04zw%*#q+~XU>!~JLZs!q?Dp@6g9{PHb6K>!{D!?HXck0=8QNSDCm$wa_|q# zEeiv|4lZQ1i!L%FF6$7iEnWyRXKy`7WF4ak#uTmAm|3;aHb-w~r6LwEean+heNv)x zw#h=a(~g~u7FGo~<(v=1R%dIYPvEmapdiW763RN|Y$SuD)t#PtlS)kMXm+bqYz7Ycl+Jz@e93My1TWs{l@BY(zc(*&&RHxsJsf>dffFmocaM7 z%ad>cZ+Ayvg!?l?tB0dN?Lpc6yuSlgDhjrA$#Xq^Ml3(!KLJ^tgju{gsR*1}!bSM? z?zB6M_m4xr9Q%*TP*mrOT>erJ%mM;jzcRDSM?-@gcs_#IV<>$M$&+0H*Y2xbcnTVH zI_~y|{;2T6ZhpFf9nYrmp?^-#_IJY}V486~&9Cp9wRR*| z-h(iDJ0u?;KlbYO=G`j}>KuFW+duwv-oJkB-@I|d=C1v9a*oe_8aDTbPd);iw_E$e zZdk0{>}L39wH)T(zxCJe&;Kp=?r+C|#>dlic-2q+-Q{7qK3QJA-7h!JCVyO})7q6F zm2)D00%I_V5{u^)Ql>)5OVAQoaZ3VMAY0N`%~Wyk$ek&0(psD85$fTa zd8T5{U5=DZdDQK3ec>4^$k#|NR zs>)arQPin|cMd8!S%i8Od@3PQ2}*+c027PI0g6^GRL{!Q#p#s+Zw{c9r8%3b8beiP zxQ!vP<~kOFpatARDk+AFz%++a66pDYEDiNLD})A(iQ_rc!^5=qW^17u4XVPOLbr?) zI?YrSg?%RfrV9nD5E~aDrZqxiIZ-)gXw|&Of@T6+;#>fsN%1K}kOs%T8SR5j$+dc_dBT}SJPjZ70fGVCzX zf+?^uAruC?athqCwu)OF>4clzR4jPFSV9R35sM5nhc2lFiZ$q>8(Ncm{KjqEudZ$F z<4T_PcU#qud!50suXQAUTKBVWH=FHY??3#G^^a%v+rNJees;UKACAD!!`*7}cKgMD zIC1ZU<(bpuX+G??pLfe)@4?;AkM6Fwo5Qd{#P)TWz}v+Rm`6EB=<(i(SV!4iU48e^r literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Contents.json new file mode 100644 index 000000000..fd03e841e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Coin.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Compass.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Compass.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a2e534bb6e532bd4dd8296db4d18261bfff4d7d8 GIT binary patch literal 1846 zcmZuyO>Y}V486~<;Ke{vAfqAY8wdh4c2g8>QCI0L$U#|eY!#Na)hb1rU*E@-G`mi^ z1`O_7@{xSQp{{Ok-n?L&jbU;$eE8E4y?jZpUYUM>r>{nq`0AH_e}8-+4{)ts}`%YluQj$j^No-hiqpzP*i4LsBy`u@9SP7x=*bD<0U8q%3oUc*{njjADwj1Pvz zM(;~Paj>FD5KI8<;y5`JASfjSc50Ox*)cKOQi=pLDK_WmlPHD*tgh%3uuT|67Als# z3!Ldu!5F*}Wm`NKd$e0Um4?2;|z9OV>bht*^Z{iT6ioiZfQYb;w>P{L#ORZ8htiEtP ziBz(4@Bms7rIO$TQer_CoPao&C+nM2(`l|&xZ;p-$*MrugtIJYG#96Jlp1Q(!tohx z;Q$ffv#?_9pk#t_q*n43xz+P)#z*A&_?_9C-;J)g^ZvRlJKbxiCCIoqZ3l)1V>hn8 z-|vUxNblZbSK?Xy@$X+ft!_8>{TcYRzuRtJ51;AXyz$!n%Kumwrgc9KpAKC=l5XSm zneKYnANxHr>MFi~x0?enif3rCuoY^HeD(A84yBTIu%=6%>){h(`J4JjAPc7Sgh?A5 zTf({V>&HTyAIi8Kfu76I?ws+4@qO8`#a3pPb5_t7?`=v+q(=XiS RaGcuVB*9!={qWnH{{Y}TgTep+ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Contents.json new file mode 100644 index 000000000..7eb503ec9 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Compass.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Contents.json new file mode 100644 index 000000000..6e965652d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Contents.json @@ -0,0 +1,9 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "provides-namespace" : true + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Contents.json new file mode 100644 index 000000000..7cd8eaf7e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Copy.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Copy.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Copy.pdf new file mode 100644 index 0000000000000000000000000000000000000000..228cc4aa4b119f6196ccd3e7c892e1a81cf82eaf GIT binary patch literal 5285 zcmZvgTW=*-5ryCTSMX&`^s;1S^VnO%isRKtn1fbuit#LoS#0(f0uBL-~8eH^zrr6 z8Ub%*)ywPi`R;MKd3XNT{po!B+i%ym-(Ual^s@YO@tf1X)$I>o&8Ms1LY7r53aR(l z*VE&%b1s_?FQ=!)`>ljtf?s{#WOwl^o8neotiD{K4~tJ*E-9C~qm|$D7HVn1?O5k2 zZ!PDPf?z2%U&4A?eA!a2HR?^VC-3>aZqEDCqO1&+gE+fxImFiZwQZe)VwBx&^D%n4 zyKN;l=k)gyYfo7)ehmS8bWak?^c-bj8K;LfZmdb|#R`|xIxG{*&0fce>H~zx-NsDh zM)S7y-CK`6%1X)nYU{)@<*$W&>=txz-B-A@wX)xB_}$!$fZRiHbAjwDi!iO$o|TNg z4b$7!YA&`;_`}1t#o()uJE^E!b3OaPji~7^4_$$yD8dDyLc2g)pG52FI<)Upqk9y8>%3 zkyM{xOKZZIoI1wXy54|7h(W>*k=v4^BT6)8hIvL zeGWds&(>@4Kx_?=%Q5WOB4&163tQ+NKPkjUX-OFo`cAG@pzKp_ni+ocwZ+t>U_(e! z8jf;IvCBH|igTJDgvq-GhK_0U+;5fHgJcleu8Q}bFM23v54QsTu(0>2K(=RH*@PXjo7_IW2p!Ln@i*6$#oj*P@J)vW~!uPb3Jrkcju;y5>xAwiT+B zAg3=7W zL~;$H;*Bs5Du})iv)N%(I8)XJGh2}gY>~b(dzQ(t z7_7=Htxe^+As;|T50tzpSybQjUwV$}f0cU;liu}zy7FoHv=gZ5GN^u(`VCH{ja|aO zBTCV^JX#KYBv%65&^4(jIUCXvQHop40t=X%cfGI<70D8FAgL}-z4gL4fPsEXKJ_RW z8Mv!8QEkt(ks95AObfoDDY(>oZP@_@yrl<7%J+^u>Q;}~HryoFlk>zVY_8>EoiDnU zRCW=sMi1y)L+eH^Q=&9&FnS36PBvQEQjG~Q>IXvbn1@vM<|@)CA#8=bo0#yIoZ3H5 z7y5!j(ph6R7<;PPU}mb3M+${)_@ms>R6vH?Mjf)lNE#MW(Ty? zG)5yJdJR+%q7gMSg&dl}RfB2u>=P&G77{*jOM9R=iqI<}%qShwTPJc_j5dUDVh@Xw zTPUH4Spd}Jak_>{CIHsZ!PEuk0b$M3otQhuyXnu!4cedbW^MzLLy|g^osnr8 z7wNR*p=D%4zy{O87$9+{XInCtr0XQVqX?alCxx$dAUQOGD?t*lM=H0bR``wv|bG$`_f-OfrhQ4o#DK85&Rq#4I$m!c`IN@-fXMX?#gb%0uj!F8^FIRm?tvBbGMF*(bOI&au5L_#p=Kan3?hRIP@su1 zU7ko@l#nS*KxBu)W?jgPG3aQ)eD9eVnZF=2KIYL}>-;gjuW{7Q}D5WfT&!>Af;2lc?}ENHPN9ax$qu zA#ossa65pKlYJvDb`7VG;0aURcX}1bh%s)}8f+X^FXUN#O*AV_pbYO(A%d)(N;sjn z86(P=3>mP8&P%xo+5FM8{apO>eClFPE3SPxnz}{WK z#hD9W@0b$S4%B;ox9X%EKxZ zCX~)mc%YQ3P&W9aLdTPo=qzO2qahgQXvKp{waS<^r2%Y&6b#EmLCju>yq z`}Xql`osPnw7*9(b_Il8|E`|)lWxy1m!F(w&rjSaU%qzm{oOOz z%4?rOSKr43n%~WCet-V~Q&;iecHQrJd-;jI{ulPYfLxu#3)R(0;^51?@NoR?-Rs@M z<>TjDe||pyxVW`0=Bxa>G6^6lz~hga)2H=mLa6!YP$J5|fSAAkXI1AD!{-oLacq2j zzPo=oKQDYpy!qWb==kF0@_7Do{o?+^mqyCX?d9^iio;6q&G+~JIb*$kP`rD7Rd;9| Mae4FRH-Gx>zXaADhX4Qo literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Contents.json new file mode 100644 index 000000000..6c3a2a408 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Desktop.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Desktop.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Desktop.pdf new file mode 100644 index 0000000000000000000000000000000000000000..227a9c132ffcd769c8b6b3fb25cad4e6190f1c13 GIT binary patch literal 3751 zcmb7HO>Y}F5WVlO;3Ys(z!bkffFM9)H$~AFb(P+N9#na4tB|EuQi`;{zHf%y*>!R# zx+m(1WA_0aCuZ7;F@Ng zFQ;+yG^}pMzjoVk{q0+I{eJmtdmjEAtTy~9GYzg}^yPm+2UkMPYWp;=lxZ?JZx4g@ zI>nfBRv5)>qjBnKNZNh^$sJaU2w*;3Fk}n*jJ}eO0vp2T}+OtVyV^MR9758r`@oWDJ(HhyTJfcSUm66{9p#N^}Jhmw-Hz) zZ1$L#KhOYV3Z3YyNE(qgF+}Wn=4_&o{(`eJ+q6M2$UEh!Cxy&-<2};UGsn#N;O7K0 zaSGCh=I_Ap`vR6dl011She%XWP)b4 zD>R=C6f8-xRhM8h{Op;7GNCW$A{^-nX2M%Mp_fttJ+6lsyIN?E1|daFRoDZ$5>Vu~ zpFkI9mG*fsQ8jBBsTWte=FusJ+2y%5fKg-tOQeK=O%yC@4fIW1Nl`8+ooiRPe^%s@ zBq(C)20fRpleDHWCwLiJA~lD>v+)z$W_*KLPKsJ=LAcNC;8H9}@jgNF(# zcN;|RZL|S-^Tt^!9jm!LRzM}ARY49`M-#IlRipi8mpx1a%*LYIq41+C1|AZGE=vsp zMMq^fL#-ePg>GeHtB8={&H_cyXs8aQGg|>Y7IlNNC2VpBXsYPj+#I{#z-lozGS$aL>*<*CWM0~smi@r$Z~Y# zWDETWr>F}PJw+kpI}JjNrxKsDM2*Fm2y!Kv4!Oor1{NjjPUBcCt+R?e02&*5Ni-D^ zWDMp}MKrkyw8i1yg((=H{iI(yw)@g9^27-5FSURp-9Cb-_!Y5oPVDEYjO&0&h1bU42`hIr@R~1FDR+F9U<43Hu zU-*9pve*gt;l)lA;8_gLfnRSfoBi?O`O;6P@qREW45Q*!m)4d{4zK0b}F)XUx7t47LdeLP+i e1V4S4!4;Eqn$W_EVsZhDj#i#Wh3aQozi)_LCkq<RpcazaoyO#z4~ z!`dlFfTcm8pBg2!;IC&#RRFIVahqcA`On58sihDv4`A0(&nuZ9GOf* z7D(bEpKC~@8RI2t%baz_csfJCGypP%dwUl5BsN4d?X-0kTTBye3bw`ET9FThJE|d% zixhl6AxmC5BV8fGmUt$G2ZOq01wHddNO2%4XHpA?WS0_xnNWe9k5?jUh@e(nx+rWC z5h0_rRR*D?VhLp#XE5tHXUjq&H1;BBsbp?2OR~Y)(jZy5JZ(lYDfwKyPFgvDs8(V* zA@O!6A@ezyg^UzR(0Bz3CFj6G$vIyZG8aXLk7^v~`0$3bT=4}?=ort#x1HCm&wAe0|&QSXLv98em_$;rDfH~#_lTVm<} literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Browser-1.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Browser-1.pdf new file mode 100644 index 0000000000000000000000000000000000000000..1ade5183fb6117737bf2f5c0b2d1ab33136de5bd GIT binary patch literal 5302 zcmZvgTW=i45ryC9SImn5JAj9MzW|1TSc-!n38K(`GxET!))E6=5|R#_{Q7*Sx_5TP zm=D6}YHgx9i*QFaLLVUjDWC&Dr1TP9Id6D%a)Mok|373lGZbnwp5*qX+11w zFm4@PQe>TrwezcwTIWkyv!qpi8_?LAwo-gd#lX^AtZUl5^DR#(x8&BimFjyyH>8Ew zS$|mK7BJWu7+Z{`v(BYjx}6$*%+0T1>n_(JEnr^=Yz<&sd1{`dPk)u2&`Z$5va|VYNtBqD;5gOICQM@ zp$3C|tzD-Qsh*JLwq9Fiy%Z)muCUI))VkIYxQ?^|6>astw1DS!NN(zg3mCS8d5eWe z$F*-cWF5aFN{vuz=FA<-TTjk`O;M2$rB<5hKTq5d)3rs1vv$n1R~!w&&BMqR^F%6H zD;wG6OnPdq2U|r<4DlJ)8G>IWJGScEh{$w5xj_ac?Xws)6ei6Rn$J+`qr2+UIL{(3 zp?HIM*+(j-9vR@wKFgjVAW${vDWTO-Xga2(7C9!BmMj1+WRk+vqhN-@v64fF1>?O_ zNyyOXvl*XKcO&MZQhRa`2{cScl3 z92NyUwx;ECm1RYBwJN$p)ESy5O8XNiHSkq{748-#vZo+tV4xpM||o*5Nd(sEk9-p0&y&rB49}U8<-;Yp1$Yw8V)TP#yE3ikiU$qI^jfAd9)v z*0_QBUa;125@ri(9_9fGnXDe175E;+6C<|T)>Kl;i6D6wsd!@}0-qJPQb-RY6mo&A zz{80Qr5NW{l=DW5J$jf|-YzLuV^mH>5dy8P{S2{H%v%b2ie$$+k#TC?D^CQDaB9PwbQ!6ys#ZMbfgs$c$!~e$}VZasFkfMhHO;T z95iFbn(HhTs9wszHp|C|p^tX*Nt|;E1~H&y9U8J{j~Q6<_!-%Ia4kdN<{4ef0(`lX zxP6fkdQLDpb)#_ zlMoj=*^I)pLneyDV)K}%!2>cBWWqH@w1BKc@F`B|pvDFx;-XY4?ywVGK#Cm6fy^#i z71f1sHZG#R3~9C|mf~n^V_$~ASe4n{6&=>83p=rkT%j3qU!*0i>DRr}6LqS)E=Cnd=q>dmQj**+T$sM;}P>@0PG z>?E~gJ4a1PqXK4Eo#$OL6f;R6@h%9;C>Unfs_r%L5V}Ul1_Irg&1zog$*Sf(?l%81 zj$yNCjKKPdF<~IY!S;|sIe}ix2iPMCVlko_+Q_9∫PHH2BAqGUwxDf%{N($uA zW~S8BWMY;QamY5lJHDM*DR{Y5-*b_Ih zHExXoUZe@g?~rqXM>82^P{Hql3jLq(XjLiEhB-=vj-mcgHa2FID%69T>*`^#aa);m z#;P6CY~yPYf1E)@fXS6&Jc|R@ zGuVbBE(p}paD#aULzytfyudl;K*KU}$eWX=6<@wRYC>+OkYIy?<4Wbk5joP6uTE?2 zd_~S9#B#PtS6dt>(s=k?B+g~a@*|52h^+#|eFoXGp=d(4-HZ^V@~}2X@DOx{jWynPvE&yW-djGt8NtR-)U1ctw1!b-v>6(UKu(jF3(N(zjLI zPsNi^AwDGB+Q~-s888|lX(5ccTinUy!cArnA(s<;HwF?|jf^0%XiEdpn5uojvUXrt zFs~R5Sr-_cGeC25l2I3aeW}@z!|CNBoL8waagEZg!6c38c_Q-?HJ>fi6HTu|mfwx1 zjKoMQ?djQSXpE-H6Rh^d;}Wv()zqX}N>2H_i`-jhb{aY~;6?605{tX=A;!|1m{4^1 z=N)Nw`Bxq3)AG}AmWSo9i=LR~`_bvKN$*PI5eg#p`x_LII=@X_{r2JE@#T5_@o&6U z@ptvZfBtz~uioE$JWk-x#}BtR-#-4b{wQ1R@B9&V==^n(bbWk&{Q2o{d|vU=dOgLx zeSCO1K5!ygzk}~@p1@YJ!=Q@?GeP@9+SMO#KcMO=3$EAGId30-X0QK0{hvWDBr$Pa zNRoli`+;Y}-`>33+&zB$eCsby$DbCr)@7Klf7g;TsR%s(=w|k{KJ1WcLVr8Nn**+R z1(9j5pw7d<=MZ=Q^TwB_o7=nN)56Q*)gRvBjxU}c?~h-uU)+B9ayaGc`tk8)mBHrq dtM70BdqjJCVZ3>IF>`p2a?6`Hzx&H~{{uWh9~=Mx literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Contents.json new file mode 100644 index 000000000..0877f604b --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Browser-1.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/Contents.json new file mode 100644 index 000000000..be6a2f0ba --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "External Link.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/External Link.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/External Link.pdf new file mode 100644 index 0000000000000000000000000000000000000000..a13bb0561b8b8b9c4ea493a2ce803dabd36f3cb1 GIT binary patch literal 1329 zcmZXUTTk0C6oB9TE6xiNOv3T;CAKAmG|HH!Z5k_kLwm?l1D)DrOTxtV>vxl-$Tt zlJ$N86&KbSB|vho5K#lFNl#_djA}-1w6qfKLU9+Vx84Z3pyX)QOi>mrr$auoCIxa* zO9SL`0fiE%MJypjA>)JIoK8mM54p42D@j#NdN?IR6(?^Cl(a_EDQUr}!=;lk7jA_` zVQD(b3sd@$DJ+enF^?0Yz6xGCrO_>k^wRmLlk931=jv^#XqmWmD7=OlQA$YVM;FPG zN)g&p7|M+-Q7dDB3QV)yv3W`hI8QUfc@dDhsCnC+V^@bB;vue+yH(o^p`nQJ3MY77b;N*XGNQ$;MwD;3__*Crst_w!!xU%LK9ViI z%D*SF@KiqY6btNgz`5{MHB`Iy{<-N>7w(t<%MM2$KcO^686cbZp*6Q4GG?zSCy?1r#-^&Zx%CjoTC=vy zkFCX!#9f00Uz3Q7V+xEENvaP+byNmjdnem@dEQ^ycI%dndntegiM zCI-(um(EG6i=`NZ+7*&vB{tU#P>;rrq@sjK#7P`;rUr#F2syM2l*cHw!Dk(7vT`|r zs5ca>!o+lfvP();)jLUJ4aFE^-xTkQok3Nle(ypBCS;@^Q&QK1>j6|FI#3WyY4i)e$1Q z5S~3ynIpWyERZ3&C>zwHcE*N z`BRf}>omBQo8Sf-kV&yIj0&Vh@uMXTA1kW_$w10YBgGmqi1)+?Vv5TlW;d_u;>vBZ zYTl_*gTA3d%X!=%RX3kEdsSgnDX zE=1d)mhq1Ye#|uEA9I=fJ_OE(ZB?`snFHPMC+R`ns|gdPXogM ztU98mP?S9F{W&b91}04l);5A;4h%7v1=idzI>Fu1JR=>mK}Gn(f=M!{d>R-~L$wPf z0^1~`ci6(b!T@K|Pim`)myV)|`3k5oXwWNwkb-IzhZy#j)=g2!YCls&Qmh*&42{b9 zVf3*9dXUoQ--Rzug=q zvwM!rbd7Oz1}8oMw%E$Vhlw?a3ge?G?!qo+cruGS{hntQ+H6qNXuEI~^nMY11 z2uIKDoMu{rYK*rOB5jfqVqHKxC{DDA(QG>tOwSDB zNdUhCT@+?@CY-D@icRa5-9q7I15cMzDKF-#>C`f!$P@>anIj^>I+UCKOl9)a5+*Gm z;v!@a_!@bo_SM>3p-_eZF09_RgN-=ks=F zyY1a(%Zc_5KY(v9ZowS0TZc|w>jo{a_|>;pm$>RIf^&B`=WO>GTY2RF9^_;vuJB|h z3vj<2cntjP;_l*l_wl~zpSPP21Mjb43g7;9CG#e6!1IUF=-=FSfuQewh`vMA_E}b; z2ZVSJLRA<>??Xns19W$Lado}99r$mJ)ik^ b?&|Li-uM6BxVXLR;UsA?JbCif4{!bf%cyoM literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Contents.json new file mode 100644 index 000000000..a2a6cb4c6 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Eye.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Eye.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Eye.pdf new file mode 100644 index 0000000000000000000000000000000000000000..5c167690cb05108ccf6913ecff1fad0d55a0e9c1 GIT binary patch literal 3906 zcmbVP+iqMn6n#Hm;g?7)QarY|uToWsCKMq+l$5uMhhcKs1|>5vGexCe&)T+U`y?q+ zVP1N=V(;tP7oWYle0gqlnkK7^+Wq$Xq|~!#>iP3&-d^*6C%42`Kg`>A$M=c=Uh%2J zaX+u`rq$*A*Ue_W`u2soc)k4J<}m#^S#9c1nbXI)d@cUwg0api>omUbQ=7YSRnE!B zVY8izPM)j{knAXVm(<;qHAUx*A6U|^or2n&ZH`tA2->0xiPUBqAnEAI<)B2^x!0+k z6P*LvOx9}aD8qn(vLjuu$Xj3w#S2s{91_Jh(JaVjdOy9Lw$so5Im%9_FAcKI+Lw}D z=BTwxNKDb*WikO^be4)$4Z>%GvWX2!B~pc)^8sP5=Thh(Iq%hN17papo(wSw2+^KF z!u8Zo+K?=p6N6*QwCg69%$bcblO@(orQn;PVu*Z&a!U17vMH6^%%MmnC!9;kC2Q(A zSCWr_vM)YWPh9rNvA@N8{IOlN_-iQOiKUQj4T6c*6{e0i&RY;VGwVX+Q^}T)Y7nvx z4!#EkGlMN`FeE3R9fTNd3rGx$5prvDf)o(nQ;Ah?&@ubKW+9K>ln9#%Y>U|>WxcLh zG7z0S5?2<`W{OB6s0}T0jx_8u2+I%$c5RXM$QW(7@*CVZFFvbhO#zy!6&+ zPq;@TC`Oa9CkqHih;t=5MSCfwAkdO}Mog@y zIzND9Dvhm;Mw26&Y;Rg)(b)Je0*f(@{)(5W&pgbA>#*CLn8*apokSRMa`;XiAm#P(!zj z?P%vft7;jFq9O&!`4?H;bG{c*#V9_$StG<4`sN9%kpvb~3e?WEhy(Kp<~6M41sK_g zDulF_J0J*g4}iJk3VYtU644e6hzg`LD(Vn|fn6Ng&bx>);cYHB z)wvm=I0X<_7#yI_c+@=K>pTzIde9qXb}9xBk;IXZnj!5&G^mr!G)fB%7g03`Z?8W% z+Qy=ksUT>QQqBU}QS~QTqdhECjy@ump#}ABGt8H+wD1x=vv)5E2B6;KBw~PiFI)tc z+imNa5`TtTXO$!|)H?7YmkhQ}Ehz`&TR#_GFx2`!phllQOX`FGc;XqKbaj>hJQ1>j zb?PwKncF~~PYi;lq0bVRd5$rd;eDH9b=p;k%jz>zk*BfK)_{Cmk#$yDY$U+Yb3jP0 zQfRi!6c99IXehxI3P5;%5F3(W^a0xs?!|~`Rm!-?BZAQVEDBHsw0L$6NWwo@U$CE` znbq+Sv4BC3{cWF#7R~cY9;q#o$y0k5Ed;w6|PA@7JTecd(7IpS$_4uR!hVY{THMB z3l{iMMdxy>FPC*~1j=lxc4)el z^_ibL{Vj8P`0yL2J%}*Tg1mnJN_4RhUJ08@VU-53jZ}rRHf6Qw2YW;5Rz>o9w z&HBaeqk4m}()+!9xX*l@Bwfvi-G}{VJ}7>fU3GC6yX|q_LL)!RPT;Hc9+<)_s6va! z8$v6!xCVIj`sULN>+5TGy+2lW(CqwlcJ|FrFaH4}MHD0e literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Contents.json new file mode 100644 index 000000000..fe1cdfcb8 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Filters.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Filters.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Filters.pdf new file mode 100644 index 0000000000000000000000000000000000000000..760623005b082f6c4fd132500624cd8c6c78c2d7 GIT binary patch literal 1661 zcmZXVUvJYe6vf~DDeg<94QWXn=U=615^EVkfG8br6AvNvx}r9LBtv7Lp6k>;cB!A7 zU#`!+_c*EF&9N z9k;Qt|H)}%6$^Xap~ zHI(ig2%D5f=}`=jO-iFGnZ8Xxsa%|dNdfXE0fyg!Rr8mQtU!%Gd0=~Hwh1sa4}B2W zVN7~_BUE?i)Rj8ER`Qx9HkYx17;TGzV98&y09POemOp24Nn? zA9ourl}ra~a(NcrGoO`b^$$z}rQ$@%G&mrkZ+uaY^}gGl9)0Qcqe!R}$J?Ji$s*5H zPK@o62~9iVd1#m7I?V!-@+?Y9#n*Hir4p|7KU8`7v9EV~-3xPjAC_###n2t}C0*<` lmq%0Lb=Qq#8lDV}?{}}7tDpWT>VBNsk(ru{+3ekyyMGnnTHgQw literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Contents.json new file mode 100644 index 000000000..21e5f2da1 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Fingerprint.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Fingerprint.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Fingerprint.pdf new file mode 100644 index 0000000000000000000000000000000000000000..43c622137f618f63917b1b012324b3250e3c9ba3 GIT binary patch literal 4485 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 z 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Contents.json new file mode 100644 index 000000000..7787fa776 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Mail.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Mail.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Mail.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ec752d5ad86572a3ca6ee38f9d62e8379eb426c1 GIT binary patch literal 3686 zcmZvfTaO$y5QX3SSNJ7Tf|MTLFH#hVYzRVt2pira9){UTvS>2{I~x@E^?YS}+`XI3 zQ_pFatLoILvis5Nm#?0hIZcyMS{?uRb5iQrGxhxWv_D+Q-^s4=%}@Ko`@0Xy0ba_g z)7|ZU`*GU5-2ZdE+h2bFLS4LB|J$9Wzb7;6`cwM+@N_(_-uY5;%F52VgkZJWeOxTZ zvhi@*9i}kHkZmx^ggNV+OIFyp*?CiJW2MU?DnhD;A0&dS%kAW7Mwtb~-py#5&C}S{JIv5`)RS&$Ge2 z5WAm!GRE^Z&z{$oy&aMHY@Jx=nZSK?f?}Wpe)61iHWIIu91MQI3ZWM*nA6!NE7k?h zeU241&O3<`4CfZ#2Ah&3FRW8ZmMD-z@=4dc#abJOwPDW`3sE$T0vSE0m~|xHhH0KO zdFceZ-M2QNtxzs13enBIf_-a?A&TxL0U2AekRr*Hkdkt+9D_y6z}?xs)Z+Q58LB@5p3TK0OERB6Y-c)LGBg#3FJVav)o( z9lfZf>jr5DYGlN;3oLczTk76)NNrjRz{y##xkEv`HpUP|TLyMBHNrfdTKfpo%2#pc zRqWsB3SQQn!>DWpBQATijjSxI&M8%{hHv68WmWEv?kk%9$xs6V0V*C8O<%81}9N(dKY9ur9vfAgh_8m9A1k z?7Jc1F6IhZ+5N;~&HVi}V_*ys%>A|+L0HL;&N zQ;KhGN&#v11{O&4CA6(NePOqc1hmmgK!5uAJUPylLULoojDiC8Sv0CHgRG6LAr67g zv#o20#KsWpLL<5c(am2OwY%xV#IR;QP!6G9C#Yls-v?trjSnEre7z5aKojj2Q;FF* z2)bD?!eUO^wwuvjgaXykTiMLpNcX!r`Cy~S0xUbi1G6P~#vPR-7$ZYPCypDL8rJJV z)UaiPrr*TQQyXTlof*)XlGlf##SO2hd0)=ltQ*Kk+D)=4EvLb7!}REmQw=!VLcldV z<`ruQIH2_%Z7oTZAeh#rSW!EPrp}S3`70d^@3uw|ri#4Fsj)BzpGo{_vNL#TEP|Ayq>2R%4`^r# z?gm(eTh#}7_t7XaeTY%nhnTP?^)PcJxeyhpb6^`U_0V*1&PbFF;ufI2$~+hs%YvlY zC6~A#48v6?ES+^j!%5CsE)z0eyw3(Pa_3>5FmiFtwSw}~us2g-rJ+PBaiC`iRh+Y& zt~?BcvobqQ#>K9BF0OF&E*_)_jdOuX3>c9P0RT}sT_;_lO_Hdjx04LN%w1&FPYBV? zoS!sqlLXNT40As+vbdWSNJq5&lj>}Dxgfx{vF~a21RrPq~ zxG$7)v=!_6b+Ppo94*kgu@-dQSqpk@t+kh>w^%pAIX4$)%7}aEF0h^+_3iBiHh2K- z{RP?y1Cs`m``+LctasSD0HE1$BY|!^_eu#SdaTv!1qJ&;TQcO|eKQ@VUnlt_==c5e z$ANqYw2ubI>>S?=+$)xEiOsi%!}0E<-u}+F1;5R2|NgaCo7da-`wslPzq;POIDS@d z`w`8|Zf7+Q_A5{4oi6vMz9Lj58C=iB|eiB6ql zkhh=W;H1ld`;X~bpVVPMjQRVJGnhPt;LvdU%v>qw|6xi$8~9X^ys@^Ui}Z&yykuY literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Contents.json new file mode 100644 index 000000000..9cba2f2bf --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Mobile.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Mobile.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Mobile.pdf new file mode 100644 index 0000000000000000000000000000000000000000..17c7a4460bb718dbd5793e7570dca84fc641a413 GIT binary patch literal 1803 zcmb7_O>fgc5QgvbE9MfZMT+h9*E&*FiKY}GK!lWA#lbk+HYl;dc2ViCXV&q)>x2Ws zhiLrl&O0Bwp3GL)H**zeBE=Cm-@X&`#RXqplBqZLmEtK6KbZQVf8<2q+V1N5)|7h+ zug$M*W!7)6czHX0t2+8gDu{-MBWKKEVJ&fMDtA`3_paCnqpNDtL80O-idbqGt^EYX z!9wXMUvTb>dE)kE&hV(BG|-V=B#J$R!yIZJA!J=OI2zdMZP|GUB1s@BCXHeK`7 zR;FV+V%MYGvZ;GhOGGIFwRCanZg!fI*0GK8%dRI1#5P3md%s+s=xB@giMt3 zBPCm4hk(BDW!aaz=Hb}&xi$9`v8Kb-vcH^XS(35f@lg>E7S}+Dl1 O<*2MsG@HHobn^$@Ty@+4 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Contents.json new file mode 100644 index 000000000..1513a9cc4 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Moon.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Moon.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Moon.pdf new file mode 100644 index 0000000000000000000000000000000000000000..75f7864c53ebd34128bca22427005075f7ccac47 GIT binary patch literal 1748 zcmZvdO^@3)5Qgvk6}&8v1PIL;k~1U_1ZZ}fqG*F|o!){TT&=Qk5nGMr6ls2aUdk5b zY*z<^dNkiN9ADkuynaqjjUnsp@YmnQ+7~bE%a^9#-_=*cmwfeWzrR0zumNygrN-l- z-|WolrvG=__3NKr+3UBLZ{27<8FGGlte+3h+o^ry`CB91ZqaP89mZ~N#N`r{gQes| zHA%EP6P-^|inkP<<{&ZH#Wp(%>_b^lnf-RAi6uxy@71gR@G8jih;6~IUaRFi6bopMxjW|P;6o_8#pO>$OYys zS`$wy33Yj-K%MzuTJ>8tyM@7EQIwEtOk85fmhv1_Q&><8vCLN2SKuN7$&jnSgOo^yzZL|ssVGw6bn=IkLUa3We$hh)x~ zQe{c9&!HOho)tdCaYjiql(Q3v1=vQ9OCo5rBvAo@VW=+XqVx?`8xm=X4<{~s>Q(I! zdT<{4sZ*z>0ZQY645+`GYmz_ z0S#prvyUXpZEi!+=Blf=@H9J(wZr+7K4PE_=lf@7Z+6UJYODyCr}Y8$WWIEv@@;_9e{r9S04*h%Mt(wz_)?X_rVIu*bA6(DrWcLl>wtSC>Fr*I< z^Fu`nxXcfvaIYIW9yZ&L{lV1k{d|LRJQ;^w|I|L&-aS1PWwjoLqpb-~1zx?~e(e$c U^#8Lt9H(@!E5%%0{rKDKZ@^z|tN;K2 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Contents.json new file mode 100644 index 000000000..b05898360 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Network.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Network.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Network.pdf new file mode 100644 index 0000000000000000000000000000000000000000..65c5fc3ce0450972daf53aeacf78f624737fc3c7 GIT binary patch literal 8042 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 X-@l5#|Ma<=gO=mzn{WQ^Uw-}n=Z!X+ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/Contents.json new file mode 100644 index 000000000..0abda80de --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "QR code.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/QR code.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/QR code.pdf new file mode 100644 index 0000000000000000000000000000000000000000..e1326f03638b5c00164693982ebe53f43277aec2 GIT binary patch literal 6287 zcmchcO^@6}5Qgvm6@7`69LD3e-ELcoB9RS22oTGLTf|}TI-5naGcYqjfnQIx-SxgT z6C}hUGAHljc6EK1-TUPF)$5fnV^Mflx&6<-6wW<=?q0korrmA&v#2d!e>?5&PVZeK z@FuM~o(|LIp;*6~e!m~5o3CEFt2g$q@mTy;__CURuF{JYu5gbRwXPZ;_$Y7d-Q&0` zurytSCVKZk)|6cs>M*#bY}zWe-UWTOEr+4)>Vae|I=zWiTVWy8bsxAca#h>L=z{}+ zfUz(v3xFhZD|-cGET9+IR_v*p&c~V?!Fg>NyQZ&uIu?Ey3#@|cwq#YAwKo@89V~}{ zQNobT0E6ct00aU?#sYe6i}%I5Vpsg|zvhL9GH|5il2@Yv1!b!dAB*xmu^;P#%Ahpl z3wH&QM;qM&a9j9Ra|^bCy@t;a0r@1+%Y*k>_!+xUR+|^ znsvRZOld&aRUQR|exeFs%1+bXhG# zsq}Jn5yIn?Muc5W)vgdyQ?{#KJ(;>fA7bZLHaD|UhMB%*sOfBm!s{zvX;Pdq)C1|D zS%v~y4eA?MKr|Mxm2g|64&C@xtii*KNz_^)f@ITT7`xAtG)#2vEKLUK&p@-pm=CN) zvbnf((UP*ZjYK$rd&|>7#+v+kHz!ZyyVglTCfe81Pgcp3F|^Um{b#A&Qd13eY$W|FHF`ERc6Es2 zfEmZCADno480M?Fdgj|Rqo-y`B9*a2mi~uaf{cHDk7>)M^70eC%QWm|+CRw4Kpm3H z5)>bW+B=J4A1dD(BrRcCpWY+%(YlPj9s2HU-O$E14uW*oru6b2Aukf?(Y6_SU%OSB zL!s}Ytn1s>H{xt*dtK%GUfzeYnu7e$_u}VN+F4D3d4K8ri<(58-Xls)DyvD@m03-q zsA>wrt|_T!H3eqvB#w)kw4v7r1i{uGs?@rfMOh__;9){}dtOYmC_93?BCcaW?J9LF zZIIEixSzIG8m8nX^+~0w({l!C^np@vG!lS}mq8j=vn%5d?U*I7f!Sniee}!TzbKxe z>_07@p^TTsV^Q`6ktrSva|&3LBfwovLJj3`Sv=B+n#<}D)-P3V6FGIgROV88s2^eS z`H|}UjHzu{H#h2fsdTflPK~%t{SYgqqo!{LsdZr}B5A1pvWkR-%Q6zyE#+?ONT_Or zLONsFjb{v{WGHIsjOAhyrhA(V6RKJw6@{ra$XH{yNo}F(A=H2{^(2{Smh%Zre9q{A znkbSn-ga+h2DD@X!5Ai*vHEk=6;ejt8?y0sC`HXoyDld%dqJm}ZYN8pCBe=jFDXmq zaIyrgYdcw_jV*CtKLg@q0kV??kX;mr-PY{Nt_&oh*QyEC%UhF}pJU z(2kP@HZYrvt<1V!OW309IU?ln`1liuM-3%p#X|vSNJZtWuqbDRMaT+5WQ9dJE7&WH zr`S{AQ8Sd_cr%ntgiJfbex~hNmUWf4e`sx5DX3|=mg!Kkd$WyGOSXGj!@*$8HX{TX za>jCs7-n+hjOM_cu^c~PI+PIT`TInN68eO!)S-lSBEC?&P2VvdLW44%B;!y5I~z)% zCW>SnN_KA!C1}Y6f-y`qW3>*YbatE%hV>LV9T+dC%b{yK94^bD6Azu&U+i}K)6u>C zNe-dqxBl^uUnjS|-rP+Yd^g?RZ(i;{y0<*6!e?duH&-g@W;*Ua9LDMB(lPf<7I(GZ zou-}an9jHrUT+S`7Th@9=W72!p7o#Te-vUQ$(fvylngv# zLmGayIc>K4yYojs9;SCio8518PLi^aBd95iKr|oRwdo zp%LGlt?H_Z51tO2`|Wfn~K_kT{J X{rs;T``3Q~8{5nt literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Contents.json new file mode 100644 index 000000000..1ccdc2fec --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Question Mark Circle.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Question Mark Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Question Mark Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..095cb4bdfb5f05e44a70676f6922765a5480b59e GIT binary patch literal 2630 zcmbVOO>Y}F5WVwP@M0h-V2VQyzknb>V>d<77Il^0f*#cM#!+EuTS+O>{`x+yc4uij zha`ItsK=S%%$pDL;^zAGC7GlYX{(1n{#07Oc%fguRQ>+8{#CBUS3mXpyVHB^0j{gm z@pR}nJGHv*|Jio^`ukV<>P`EvJF34G89RR3&WlS~HG4S)h-o4dJ$cT$+byahCyQgZ zSH;-C?1M%K&iWkn4p{Uyms~Mswoa2Z6q6$YyN5P>YjIY6^hE$FQ+ew4Gp+lYW+ zqYx!sOdy{;YXspqQG%m5lw)D%M=+DON#Cn%O29f)FeZq4osG>7_B2RGh>>gqIg`kd zudXa|-nhu@2y$@5I;SuFEQjzXYXVhQYCwe=IRv%{PUae{IrjnTQw|8E(o!P(qAwjH zj_HggA5uoZWU{wx=}chC)}~a^RHDla8jw&|K-q{QA2}j7ZcYifNiLTd8?4QV2s#ss zWn=>Wa5Ww@qRzx6ft!+ua9ZUd$KXZ^v1LO67Bjq0IvFNkN<~~oIbfkeX`YRMo*AA`>h&}3?XI+aY| z5>bK+m}WUK)*#65`N#&#oQVpEAnPfi<_-RO?||UfJERe{U(0c%CPW&kG@&?`YF%c} zP_0cvg8*HFW#Zt`BNzk?Ovpcb7vW?M2jH@^;&F#)qe6Nlww;nnQSLXvDjd8cukNnXQp8mFH#L`TLj?6RrUVLa{>V`5Zp8xXFJpC(50V#MTSpiit@ z6qksJ30cUNhzo-0`_$^n|bGf$$hK=4L17PMJ?Vpq&SS!^%IiN;e$1*!9Aa!)W>Jl$$eL{on=c6Gh-r~7=q z{Odh`eiTs2McxD~Fy0EQZ}bHOY>h^SWD=la?9_W7BV k)p{6Cx&}NFyn3_!uZQ>Ji*Iu{jo~=9SzTOw_si@50qpq~1ONa4 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Contents.json new file mode 100644 index 000000000..1822e94b0 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Question.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Question.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Question.pdf new file mode 100644 index 0000000000000000000000000000000000000000..6edc35e7e0a15333724c01328e01ee4f3e252715 GIT binary patch literal 2440 zcmcJRO^+Nk5Qgvm6~3&LAdSamyZj+Vk;pDV2oTGJTf|}L?Q8~RreS)50>7TuJ>4~) zuoB`xA6C6j+x78Q*)=!!cdu7ul2W9t9)9^%Y5n4be)&@Mhll#FaxGtf*B>5F@3jZq z)K%l@*l+i0eb@i7>-x>tuk`Jk_P=gazbi6!dbC|$R`Mp_c=;AhNQsiy-TtyumdVT5 z9aLWSB*RpKWxctCakfxS6^24oqV|Zz zC+{jE?{a4Cu$4k$4g0X=>rQ99D^#-1rZA;gSIsGBOGJTZl!lZg?)*NCD`RO1B;*{3PW5Q%MFgO$EA|aKrlicLQtBLIncCkt|VG4z)RG;R1$feS4oEpsXaGW zQdn60i6tS8KVjZD&ZrywdGsUK-u4!11jOml*rk55oG8>z1!Lk;D#Iaj^>p}TeVkV1 zNYDi&=aOm)WG!>;)MSE97J9PDIo6XVXRj_#2?s(*Q^5D?-52Vhe*Dk306{;*Oc3{9 zuYrhKO~-nL7Q+Eg6mbzW)SHw`C>GI|+ABe?D4;&c;(CA*R0=wzVYM(84FC}u>Y*%0 zNVOud*f8jYTr#a`4pp7S^dIN})|QVzFV3Z%F>XEB=&b`!;S-w~0|S zYgiL^LnXtflxTd5I#=})`cxGf*7$CyMA_6!vT1w^>y$Kk9h&n*T*hael;^QZsT7&2 zK`^H6`pd&%IF0)4&zQb=)<6CETd&vm+sA$e-}eu@?W^IFetVgra$mY9-WE%nejGj? zyMEMlzHer8x5MGoAKk6@Z-)cgdfNPZfuzui3`R9!RJ=*7?N@DY3IAMuYM zjiq>HsU|pz!%O0~+tc>L@OZuT)3JZ2aE+_;MO**s$c)hiJU@hiRvgnRHB5$?9n zQ6UI%wb5D3;Li~5O+lyQcK4w_s#?8o?jXmraoG3I^|Rf>^Rp=H%`lvFO?VP`{bu)9 XkLai0OxxpWO2;|M>gMLFA71|rl8N)p literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Contents.json new file mode 100644 index 000000000..09fbb7117 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Sliders.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Sliders.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Sliders.pdf new file mode 100644 index 0000000000000000000000000000000000000000..6758386feeb8a23e2a22564d376e0718f4a14f29 GIT binary patch literal 2434 zcmZuzU60c+5PbKq*q4(4i6nO7d`Jih?f@Y`96jC;4<#3lqBeo1AmGsu zuZEwye%QQtDwj9uzkXKVmClOgks>S}a>aLCn9Q!b`$M$kTQ25)RN4eWU4|8mbfz0^ zn^GdGi@*w-(zKOnCBbxf+p7dEvfA-fk}$@=qi7%SAVPuZ~%ez-!RGZaR)s>wy@**BomlcgQ8d;QCS0Nqi;;1xs7NTv?E#V}Fd=OD< ztv=gXWu2*-wn-UnR$5!sCUFhxCSmsh?Hy{ZflAy9W!hwC;oc(ihGZ>?9o;|E%oJ0{3GlE#QG8Pgs@#v2yP6&jQk{|{5WVOU|p;K5gW5&E!U~?%g zN8}5H)dg2ezD?{S6sF(R!!*8D1B;jGvDflNfazXD}Kj8Tz^=S!)RU*fTuy=#@~9>tktbjRWwy?{Uv87XTVBvW$HfL96DPSryW#^?q}|Qd?VE z0qh?PsAVN1p%QVrhmdYtoXI)V6$tDMGDU;>JcqQ6hNt6pw;zrQUrG7PE68zgo({u( pxwpH$zlxG?rs*Uu;YHy5X7^`6^vl=M_IO&-F-9A8aq;Z!^S`-Q>_7kj literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Contents.json new file mode 100644 index 000000000..001986496 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Squares.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Squares.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Squares.pdf new file mode 100644 index 0000000000000000000000000000000000000000..14e2d25c01500abf33470e9c3a1b2b7d9a02f9f5 GIT binary patch literal 8451 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Contents.json new file mode 100644 index 000000000..013c1fe05 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Verif.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Verif.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Verif.pdf new file mode 100644 index 0000000000000000000000000000000000000000..da23491b556a58a9df9607dc6079e2cf76a8c6ae GIT binary patch literal 3881 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 G^5%aY`o}f^ literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Contents.json new file mode 100644 index 000000000..aab64b29d --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Contents.json @@ -0,0 +1,15 @@ +{ + "images" : [ + { + "filename" : "Warning Circle.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + }, + "properties" : { + "template-rendering-intent" : "template" + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Warning Circle.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Warning Circle.pdf new file mode 100644 index 0000000000000000000000000000000000000000..02638e9a1c4b6511208d64fdd172c895e3be0374 GIT binary patch literal 2047 zcmbW2O>fjN5Qgvm6?3W7BCTV`ABm-^65UdS08zHwDh?s*wu^QX*rcfR*E7y0V=r5Y z51%HFJ@1S?&iLr+;&LW=!I%UA?U%0%;Pe#E&X{kO;gjVl&))gwuD=I`a1mB@{nl3- zmRvJf_f8OP?d6lwFKXDAYv>XSIeI!6GOR zfze~9mLdupVN5W}#ht{sk=6fy+S5h)^X;d=l5XFIX)bc7RRIyw?;sU-g)kO>-zf@d z)QlKOkU>+loCucZP&LLTiHJx8T`BP>l2|lLF3};JaDK3hO=L3Xr8UkeFkC7v1RjY! zaEJ)AA&*EC>zP@~3!OSazj?^6syjb|_kOvm&f7=0i5G?npFd+wN(v5*H3s_<;&EU*8Z2lCDaY;^3m)oSgxEL88!1s=z7*KYg?9IuuqyFf&U487}D@DiXMP+63$4+BMkHC=~c8%TB6; zAwQ9igM(Wxn&GNK=b1#1Gv0|t1IT~P55PUj%S~I{n$T&B5)n7y1w=0o@F=w z&$jaG_t&tzoBvfE`^}JxVSyMo7ipKy6c)6rXUMfQ0P6?0r^w3vhC zsHD{xvYae=A!JZu07pu$5lNN67$L!(b;m&j&z-|uQw*|;wNR%DYb2#Ac`SJj1%*kQ znQIbJbBj)^Arl_ePIi>t*px&UJ7>c^ImC<&KH?8|hfYbnRKf(|SZMOZQICpguBDRB z&V`$kdbO>#E57bz3gpW zH+={9-)R(SW#9h(@{p~{M<0RDezPsFn-{nbLY+*OOwhC&nby8*p4-ZI5Qcpn>6T61 z`~8zdQ})9HTDJXA4oYF!V)5?F F?SIJ{Ggbfq literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Contents.json new file mode 100644 index 000000000..022fa4a8f --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Contents.json @@ -0,0 +1,22 @@ +{ + "images" : [ + { + "filename" : "Icon Boxlight-2.pdf", + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "Icon Box-2.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Box-2.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Box-2.pdf new file mode 100644 index 0000000000000000000000000000000000000000..96cf383e6c389b0cbd5883cff364b03c76654650 GIT binary patch literal 2679 zcmcguO>f*b5WVwP%*8-bz*>^xhX@1#8runqwy3-AEyzKYWqSj!l&+M*?XT|)MGd)G z11WNdV0gJtocCtlkV~FjU%ow8l@~&Rgz?Xh0^rpv*jzo$?{4OH?w4;WesnF!N?C~y zynem>iGH}HFrkm)f9Z$&`2lJKw>VKu^Pz9|VsqL5z3ckzyEkxgQ-13v@t4?KDY&16 zsz?Dfg7KIiM%Gp@10%I;YM8n~XtNS3y^i(;YOC67i<4DTIqi+| zIfWdN1qBB%#)H#WnW4i(Q;AuL1D?w=W1Yw$8O@{T-j>P_;!X_WcXa#I%4cl0RS1nV z9^9Jo*KMY$S}F@lR=TlX8Q6=ua<$QoD?nU!$}~(#}Z4~GkZ~C+5n8u%DDUC zn>L1=l#H{|7hv?nX-yJ| zt%S%XR88K+d5gu~k^A_T*is)T5ps%D8KTxxQz<(Ja}CUvA+9yL{2feQb7u3_W&VYu zxf$$xhS;fGNKxA}4y>wdO4%OJ__e>?wQt5Jc%Kho{>jN_T^_AW z+kP59AG&@5y3TA9-NiV}{eX&eM_Iw^_JA1J1mPWJt%0C?6Z&~~i>U%tu!U9UV*HG; z>LmXOk%Gw`F;RgN3+BQv+PQrk?~g;D4*i{w;KlN*N&mrFi-#n_=}~ymp$7(rJmz@> zX@x(EUqTk$Ii6MPlfXLU!1>Vb9{Yo!?)`L$cD$Izeg6_(>~3E!rfjz3I0F?N4c^@B Y{_QdQc=c-!b1X+2>&4mG)o*YA0|HYdxc~qF literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Boxlight-2.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Boxlight-2.pdf new file mode 100644 index 0000000000000000000000000000000000000000..0cf9c342359857a4a4538aa616b632c1d5785b84 GIT binary patch literal 2679 zcmcguO>f*b5WVwP%*8-bz*>^xmw+HZVmm?6265ND1vx0PY;WL|(v?!U{q>!ps3F%j z(4vPd3@`VI^JeDFP@I#?^LMAJ@4r&CqxKT{=p>OwMbKd{C>-z2cw{Uh<{^}<2huB;wxSfQm zq6>-6(&Cg?PoMFlZZBlj7^S>J%NoCor+94$+Q8HeLYtLP>2{AHYf}u{Z0b{&)`Y1DW80bpNp4i~IC^OcH99%~8>ba+-=R0vD2JsuJ{Zz_lWVTh) z1c^erHR6AlnYL=FEGSezSg#E1MP0et=->(v+fJF_G=!>luBp*rMY1;xGwmXVS~?4v ziXIVX_P8RQAkxO0M9Q8U<(kM4sbYi?Dm_xz5#+!!8K;zeGSrE?Tv;ZhwoKJ-uq|sZ z1L(>HuNninG?|ZkvlC?CLhXxv(Za}D0<&d^ono61P25M$oNiP!h-@4XJ7uI392;Z2 zU?xTihj)V6nl<4)V#ZtR$axaMRlzpKI4rwUP8);eV}$ByJ#=W7FeHdg1os)kuC!JK zvP|r@qCV3hw*n({Osx*aOJK}a$`~6gB8iC+_D6PUSHMM#>%PQN^vqslm<|9V)EPHF z{jY3|^2!jEo{CD*F_?2;whVEuQRN>X@)|RXx3>8s zMRPG&_YAR8Igui_XB1eyvM6PJ7|g|BwhR?Yl_1v&4>s|YHe1K2+0_ImvzU%U8 zW!m=B`2EoJ6VN!bO>}4DF!uv`q#0!eFWUoRU=xHh%9;Z~c@p|%ca5O}Ww3?S&)N7L zZPk b@aAgwcaPD>(XTzsF&%BJ7bhndAK(20tL7yo literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Contents.json new file mode 100644 index 000000000..7e36cc264 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Contents.json @@ -0,0 +1,22 @@ +{ + "images" : [ + { + "filename" : "Icon Boxlight-1.pdf", + "idiom" : "universal" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "Icon Box-1.pdf", + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Icon Box-1.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Icon Box-1.pdf new file mode 100644 index 0000000000000000000000000000000000000000..68538fc7722e27d3ce8d74191e19a9fd8048e3da GIT binary patch literal 2434 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 K#nI8_=c|8u`By6d literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Icon Boxlight.pdf b/Sources/Web3ModalUI/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Icon Boxlight.pdf new file mode 100644 index 0000000000000000000000000000000000000000..ee7d707d81c939d72afc209636860115b8a2c6ee GIT binary patch literal 1612 zcmah}+invv5PkPo%uA&f3CH8RrK%E5FG7GQDQ^`I%XXUvHM@}AqQcj6yh(PGwh~s9 zOpZNgW{$^maCLU^mSqrvNm29thafsWrpftJcX{0vUA6wl{ZCntl3L|OCnxKVsOsD7 zCiI^F$Eu!p_hbOha8R_}sw$RZa#sCbl-2C=l&06a|H@YU5|eYLc`I1C`Eg|czwcJ6SG(o#)h@d6Pht4l_D9LOpGBT>~P)z@!lJkJAnU@|87 zKw2heL(grkaoWHS$5RZ><9Ki?xPTlW6)S5M6S86Jtfj1;a~d(NL|vLQtx?e-xCL!A z;LmJ6Xrlu;sXgZiEH%=ABtTfB1%W^s=ncPUql-`-**k5SHBy9J3Q|6ZAi=Ie=vCDz zcwiBUC5CuOy1)hw5ZI)wbdo-LZxxK^H&hBV#+$w~@{8U)*X`TR&v-o>lF`G9w*#6d z#=E+1x|VLfVS->yzW(`H(d4R_R~z6{b-O4|n}N7u*XxxnBIOkbOVTi&fW` N!)QivaB%+l;vf1pS4RK< literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/Contents.json new file mode 100644 index 000000000..73c00596a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/Contents.json new file mode 100644 index 000000000..205020a78 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageBrowserL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageBrowserL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageBrowserL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..c8c0e898140f22926ea11aa16ee8b23827eed115 GIT binary patch literal 2434 zcmV-|34Qj7P) zhe!sBpoa!Y5cE+k{d zao7!Qfx|1pWYe`Y^{Rn;mxd>>GfuLg)`hR8IO-;X7Hj!9lQ6Y>?Ch)6oa^~&DIm4` z#T01l8GgX8g3+D|gPpi-V)vG_*9Ol%>-98GSG^g1&+~xR$2#;qakZ>4vI}xMW5uM& z$GkLg*DI&~$|b@E^)L(R(2BB~xG?#E8+65JvmandbZtDOhdH*wt~sNt(yaezK=%Bx|BD5oL@8XYVc@X>TK7h5QpfSz_1D%sj$CL%`T^v3^(Re?>+Ts{gIcF0G z&(ZC(R3$;n?zdWZAPl@UqVb`?Juu!g2%TCx{3G>mIP=+sipSHK9B)}kk!6qW3}Ph~ zav>+FFSG*e_c|Yf@q35hX!myu`;LFPAMW>m1!h)GJDx}5cr`GB+{?H*u zIx75fj&}!OFGZlw_8x~L2Od(}S(%0R#eX3s)9`)mI}l(2c<%o%R(6{1(Mc1moHdXr zN;Lm-sdKb?B$+*owe7I8x*Ml%N0>wRabQ zRp!HGm<2T0ZMlJx2=+?uQ}}uNQMH}Q-*Nq3N@}>S89fWf4BO=bFr|6B9hJR+l5E&s zem9KxA5;5YO1$prZ>Y32ZxvitgcO;9Nn^L%rNDFi9>W!sWW$o44*p2JpS}@=tL6<) ze~WT-2Hc>*NOCNiRKU6rBeJczu$_7cp6EKP9HrX~={5$T%hrcwK}p51#qQ25p8?OJ zzKm6vknDH{i)7OZSTZ)+Om_)#{N6zYO(M|0TbJMpMqVcs!;*f{W~ldS+_gm|C$XM4 zfPll8`k5dN-h`?JIr--YCku}L&$PTC#KrE;n{OBPUouxIZO=?e5I7b7tgKo2G^v+IgMawe>^a zw@dc@vTdO3cNM$qmj70xh5|deTZ{6*xl7V%eio-J z>+Z*1+C7>QrfsN$kt_|xX zE3-A^Y*yc;k`K1#B#yCUOy&jDnk`WhPkF7AyKb-~?$h7^3&C$fKWSRurAj8=iDNpm z#78n;dwaI~?tHd3SkmJMABE>T#}#ZUzXm`1&onezw4y*T8PzpQk6L-TX?b;li~6nY zZe)kMUSO&3j~^U@BOPB?+vF_4)|3&s2^rV3>G$>cSR{FHX(Wo48_ZW7uO%*(JM zZWi{t!O|_Pxbi`++7Y`MQtL&8h!#pbOv4o+bW>8)T$p2Q}%WNI58ZFQt)Cq;o6sNkPofp0&J^+ zlE_^gHpde~3x&S3ZK{D>7U`U!b^9y!<%_8g)Oh$;{wHDGw+e?IzyNl)(K4X6)Y=b_ z+vbT&s8nALY6f?icA4mX3ZB~xT(m4-(ve%#_THPbpa<8lmEu1XgUqU5W_9SHd z?@2$-uU07E&Z2|Mcw0GwLra?2BG9G`7-|q@MzpF&nz@o8TUjDnE`U|O8Mmh0ijp)h ze9Hu3$rFh(tMtl7Ck)}USkjyock-~`w6PXb%qAR`Bszv;UsjvO5lW2u!hVsxDh~~F zT#D!jOk->ufenaEKE5BI#pY@}98rx`I?lt=!zaT``qgSY-lEHxieLv4V{gPO9qTC~ z5i}S6Io784@pi3c0vQD;xr(q^E0!@+1C$N9om177_bv_3NX94lm;BJk*@{}E)?%eh z6`(S?^t2aPQq@=8vp9T$F*dnZO#yZhSG&A#ad<>BHj9pjn+2{M&2Bv5f<=lbWj=|)g_;xT zhIGW9rLle{#1zv&Wm;;fP#u%(1W7e01jK5^MtP=QP+JX+Jn9xE{3AFZA7y;wK`r$I z*v~Lwpey^J7L~=ZRE$k^<6$j=B}l9?uA8f;yapsMYFenJ1te{O?nk)9q5?gNCu!mx zr*v@2viLZ}i{ri|{zx$djL~CxYi9aFBO#0R1(W{w^nwAm+W-In07*qoM6N<$g2Q~E Awg3PC literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..099be34c7e76f7859cf08ba4fa5f0d64092c3c5c GIT binary patch literal 4898 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�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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/Contents.json new file mode 100644 index 000000000..73c00596a --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json new file mode 100644 index 000000000..1777a61f7 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json @@ -0,0 +1,21 @@ +{ + "images" : [ + { + "idiom" : "universal", + "scale" : "1x" + }, + { + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "Polygon.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png new file mode 100644 index 0000000000000000000000000000000000000000..47e34581ab5b0632b6d70f98de7e435d19ee978c GIT binary patch literal 2543 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 JPDHLkV1noZ=Kufz literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..0922e99f067db2d893003f9f8697e32f4eca8733 GIT binary patch literal 2303 zcmV9Gz9^yr=nw6L3dt!sfazV%|~2ekPCPI@R%pf+;oQRzL+ zp+$fI$vud#x!8ddE0*lF^|4%%llK{N9CGLy>3RVhT`o;|?@sdZ^ox@0Zozd&I) z3}Iq}EDezB6vh=XvJI~gqt~m;^+cBJDF_jYgz6lKMvsx-8_PXBs6ymS0K)4_$I?eNxObUyw;e>0u##i#>d;>5}3Pnrbb1vk}lyk`=n~I?&a-5xRCq zOI~&8g23P*Iyx8>4$mY#y%tAZ(0#`x9mzT=J;v?qTOIU$a!D_|77g3#GjZG!SQT+8 zYz$#&w5W|JDCP^rsY9k@+lBMC3s=UV3|S0^5WV^cFig>Vmf^bGvdePnOLF#}+`YS^ z(ckT8eAo?f4-L@Ia9P|5fRrS551!19kOZ<`SImVbxi7aib?h;*eq8{yBbT<0hHMS(xOdDgHB! zJbP~7=Hmn(p(19HSJruv=jJuwkm0xrw8u$gC&k5Vh`(1YFJtg(e}L6l<@zaBXOTAw zA@O4lA@Brm1d674*^Nt8A-DDB%rYt7M?Lhm^6G@wg*O6aeE2hJg56Fe?CnYWw}&zT z)x0TXy}yAccq358iMP=N8Gbowm)M%M$t$nr53%XeKf%|-Ob<$ znp}(MhVTS`1ZsSW2I!i}jqNI{)AdpJTGTNlP=ZsRp(eD#S`ZPWy<9e9E_ z0%-x%X)G;=Dh-|2xKn3%kZZW*)1>n{iM$!(Z&gSnd2<1-RcR=ta4y6jtB^>EmTT}P zefAvi43ZcIxG}E5LL9r~t%U$r>PQL8l0*_TZa;5`cu8)^xo^NT)bH<@U)vRhAK)4N zT=cO_bUCUcGNW=*m^S8B0nM}>CG{Fyv>P<;_O!oA!$EY*pL2O6?koq}utRPfZ$Jb) zJ0H5&r3zY)^a0TlctErS9uO^o2SiKY0db_WuvKI7(zT>;k9O~&s4+&|_N8hhQSSRk zp~g5I34wIO)06z7GxVwa*E!ajMCSG)ed6BV7jqGR|0V-U5~%8R#w*%~3GW0lSj2e8 zq*r>lZ?_2iT&qeV<1M=kR!#6u+kg`Ak(~RISR;RhM|d3rHwSp%k~afvu#oskmEg}T z@lc+XQ^rB(aj9Kpv*W73=Oofhzf%X( z3y&K9f=W#TIeN0EIW*1cJf2ZG;7im5J;}Wg-%Q$nCc@n&;Zi>C22b!tAcH@s*^OyE z%q$budkl^@B?|mGTfGrT8#fH`Zq@P(K26L7Vdj5sVj`Anau zvz78S|L|x7Ovf3yE_!RSjBR}mg#=1R4%?Y{Hu%cFNS=K;iQH)>)KX=t6VpoJOoT~6 z9yud-Mb?g_Bv4@U(~t(4nuxPD*lov2-d_1x6<%F4OW4K*SD_^`z#tf$ zoMdG*VQGcYkZ|p!Mv`QB@Ws1oecG{AQ^Chf5$dvBIxrcb&S98$i;h{B(PuOV&Fhp3 zo7(pyinuUA|%O~+;1QPgqdTt); zb-wJ-*on%-jm)1Xc1;&g&`FBGRFPM7`1}(XuhZu+O6kf(yGT0B5v{O2=pmt3rRnD| ZegbxjgGrzo72N;;002ovPDHLkV1nyKLA(F} literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@3x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..5a34e94f8cd0328e395b56c39b4d13db8f834020 GIT binary patch literal 3561 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/Contents.json new file mode 100644 index 000000000..692659ec3 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/Contents.json @@ -0,0 +1,54 @@ +{ + "images" : [ + { + "idiom" : "universal", + "scale" : "1x" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "optionBrowserThemeLightL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "optionBrowserThemeDarkL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "optionBrowserThemeLightL@3x.png", + "idiom" : "universal", + "scale" : "3x" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "optionBrowserThemeDarkL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeDarkL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeDarkL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..fa17511701383ba5d5c6d855c361240ed417402e GIT binary patch literal 2888 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 aH@*i${)3t#0z&Kn0000 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeLightL@3x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeLightL@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..7867f4193cc9c2f65dee6b820bc585603b24c2db GIT binary patch literal 4669 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/Contents.json new file mode 100644 index 000000000..8d8cd679e --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/Contents.json @@ -0,0 +1,54 @@ +{ + "images" : [ + { + "idiom" : "universal", + "scale" : "1x" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "optionExtensionThemeLightL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "optionExtensionThemeDarkL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "optionExtensionThemeLightL@3x.png", + "idiom" : "universal", + "scale" : "3x" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "filename" : "optionExtensionThemeDarkL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeDarkL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeDarkL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..b3fcca3b64dc3b1be9fd62df0b3733e2710c889a GIT binary patch literal 2675 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeLightL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeLightL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..c89b6d3d00d7c821adfd3160a73be8ca36cf3f4f GIT binary patch literal 2795 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 O0000R4K~#7F?Oji7 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%0AnUfMo7Y-NmB>}yo&K|(5zo_<0)R)I+Pe4!YL z*PLYZ_Ne~p8vXRX`SmH|UW13w>dpE|zN@6g;w+R2?3~CxsUw1~KEJR3rvZfA5{@#*$RlyG$zy_y*YtOS5B1ngue78(&be~n!AWtHxH zDhf{$gIi{J>V(oP$y)(^f5t7e=f#?M$>dT0Fd@3LAp zG%J6)N`6U+N;~1I!QA;>u2NX=V)vS{Uxj@OeUzRlZ(ROxGukHQt=1_C*v~f{6P{z& zepP^3|4UDa7b23ny=K)mG<(m-nfrjW8Z|V+z&V4j$qCC#_n}RY&6^+gF8u0eKAFIv z#Qw8guQ)CaD1^SK4|8*JiTeKK)0{$k9#WDGsGce?;+(9&2jf7z{b7-pl!guH14|?6#H>hskEvYw*|-~PZ<`WRyx$I#>K-n+&!Qh$~8c6kSb z#2Ep;kc}swYz#_Mq#bn1n)jC#WYdRPWcHV{Gce};pZB@Q7G#VRX!w(33aMSiG(;y*c{r zs+ao2+jK3LTO@!W&1U_LUz=&^<)_?H+y)l}X4y(^$)=ch=Ldy|z2OG;tZXS5cuWe8 z6@0DO=kjSh$=L1XDzqV_o~AYUCFoW0ZJmC(_o!yadqQA}0=4A?^A&v#nRoG@@9p_H zy(P3oe=NgH>8THX$#|&1=#=?zNM`7&sG$wk`>y(a-^;bUFps+}o+hp_bTx7%<^)<^ zp@hRFmMcmAOKq-7Y>tfz8PJe<&`b(lX(-tF-7f+k_9f-}^4FVHGz{DOQ@lyFCZu4B zE)^7jJDimwjh>2}d_+|1N^Np|rn%iWf=3bY*z$!H87y0boBU}QuksJ}w|A{}m(1A3 z>kxFLwqT>ZHuOs(^9O!tYDUdoJ3`mNys-D-sb$z$1R*f;&o<}Vq@Q+K+>9PWf5tr9g-1hI!xF2nfel5)HL6!iO&}!Eck?NNCYp8q}PX`B5-)x z!EI6zf1z)B^MPG}*4{)iX=%)Hr^}2q4y$Z*Bfb;1*jpLv$9yXYnBb}#pU)dx%~V#d zZN9?%tFD{nuNkA;gW8@av+91@4LS*<{{#eXnzmK3+7lk~m`@buiFxmYUSUBc^X)mR1cZ$UN}&nrG8 z1t|6s@i4v#g+Sc|Ix(on7JY49*!|5?GuOB}JUVb$i9OHQ0ZhdCh5-YnF925vw)h%O z{G3nt)+y4w7=f4v+V_nEh5nga!1Go%bBP#>Yg0Pu=&;T)SP8w|7`B85;>^f>x(*?m zfx&azWA)lQ2SN4*Ny;jt#v8URy_5WZfmj>EhL8#&$k*)ctp{aAH4FtJco7j%d%{*I zH{?qg2b+dlr@?&mugEJmD(1_s3xI8{S=b(MJ0m1JzRTMZKW>M13=7FLZY@8AWXP6j^WBx!&#&klkm>oEI z<}OVndZ|+r>L2ze%lv}!y-vF=_+1O8zvF-FB=c`D11!x>?25akl70SqY$6~asG_*N zxHs=c=36qBtkHXPj@k3FrGL>r=bN74zcwr#z|O<>>YSCG^8J)AosY&;pN7cYf^y3| zS6ERi-QM@0KvO>7RPiCz;AbqUlESf3e$L|kAx{@OL#!WW-Ia_kweMh^;t^1TY$TF} zyc?4=NoZBvw_v-4w?umhLY+u_^PR-tu|E>A_o;1BBi}I!KOX+SgEO- zcc}nI%AybgDw`?Ud6bdhur$iSxR}^3SvY*h1f&9c?Xlb^NHTLgy7lC7O2chP*GhTd z{*BmJ`V+g-!K3i_Gdq*!F2~wo<3zB5+k%FMR-;zqKRaoOfN{*1Fn<^E;FH`pCYCDh z2qY@WXTL}nk?a#nsuS!#UsgXeYI_A1HhiP#aVjb2vzlo~L4dx`&$n! zZkS_InxLoGwV-*bu?2k6m#Iz9ko}7Mt4IL1$(v5SM6h#_isbuoO9ev8&&^4vs1*wU zQZOPV_j9Sj0nT4etD#J{z~~waV;h42iy&u+sq>ZU5g}G6iYuvlN5iWr#$0>gM)S63 z@YL#9y&0*VaHDC3Irtl*H5Rap3{iOy0B>eYfd7i)M?|xKN#`@PYx&j=l-&12H zcu%|8LJzlbJuZX(yz_m2nb7xK5Crg+g*7&dg6Bg(xJ<`jDiE z88w`H`+1e5Fb}Im$2!5H^XZA)POoS#;wU***x-Gh`)rR>^>rWK__U@L5C#Ke^)_c} z6Ojveq%lao$IIiZvp58>&ex7cSXO)AyyW+`{K`q@^nyo_50WmPfg+?LRM*`qQTuYy z$_d_F3HB{0J0SIxE0^Y0S@p0fx6|sOL;z9{(|o)kQ6LMkuZvjmcRKre)n>Y*5l;=k-n z1_YNG12*ZG!mu@VpA>Yg{Q`FwecxmfF1T2lN@}>z4BP?j2iW&yRp)hQGl6 z)Vu^j!ldzA?$Tu(P(UI83_v4LA=`1D4kcFMI)Juu!tST(zYibF-ND@jJ)+cQ%>>hC z;4_@yH;E6HC7!R{lT5fZn>&k*0y{6%sRt9M)Nr3hRg=QxRAfI$A^!ywQ%`h5XSFs& z8!Twy^OOF5c$0($U_dCG9|6$3?0RbXzP;Vg!# z5#}!EjYuVHAnfR?GQp&atMELD+5MGpcN}9*_m8SotXp!v@=O%hDYGyA13Hf^OL|_T z$6%WUxPsJtut~bWvatgY&kIq-Sz7?6QbBOQ1|T)h|4q~4ju*aKG`-}b*t-xZ8*8lg zpbiOxKz-nW%o>FfWXI@(#96|dJ82e^A)cI~x4$X|Uzkp?2O1=4K&i1fgcVOy1BSdQ z4O3Yf2RZ~+&D$-Evd&(g7Tp|3{+vfyEFzosGi8eqb`ei7YUaA^eEkz^6*y3b^ zOTMqD$$DHSbo|z#*Z$AG2~X}FPxg)^0Peu%LE`&)u%f9=%NX`eDp1k}y9Ax9uev2xRI+|riLMqq9|%8r0M?5wLvMUXL=AmM>;Bp2HLbvq*Atqi#vGOv>j}IN zVBfoWlk;TO5@mv+$FPD`L-PE+#F8Z)t6N&S!y?*F-q~VHJ!A7>QV5}og2Tp(_h;!3 zoPM;x*%I7BouL_Zk!f3zX^gj6Ro?R~&$r{W5TJ^Zy2u?Tkc`okw~jB+0Wt_v@z{-3 zzSBhY6p(`+_zlt0G^u(+th=(q8B3&VKC`X9m2?62UkZER+_`^=U`RF$?yiD&l zrUB-F&-G6pyn1C_DyWiLkqOeQUJRmp81xk}@}vHjb4Lr2M_q?goRLrJ2%#UbbkF28 z(W01ILtL3Nb2cxt%N-11`cp-2CY9Va_jTz^3%sp}{!swi87KW{KjZI6^pqP*;kU!U zjP@piu-^D)>gqz8?i5q-@2P|)d=L>IvFhdMU$_I^S^nj{Q#ZKR(Tw$O!DueOaKXLs zoxzovTWF33|KX)O8qAJo^&pmh_UEI`R=A%nK@+gr5kv#zyGq4j%xpN@2)_nhUKvE4mMJYB?oU zx(z18pNXfy$&eD=qZZw!mV@m|l2Rn~BQ=v|C!HzZ*Pqa;58yrzB)3y=T11DlgdH`| zuor0wrqpzJM&ncb_2rLTK=xLpvYKqHbFTuvB8;?jX3OtMI))Nt3!f44DGwY?Liaz@ z(f!4{r_81NsgZMa;>k=ZKHC<$T8s54U5tD<)34@VNb%C5Sun1nW+<`wCJqvm8%LYD zDiZb#_9)_wmbxk}u#%)rE z_&BB)KX-`*>r&^GRzxe0W@UYFv8+BfD&-#*Y*zbS$X+-jG>?Msj5kIcZMo_C*Ad`N znj4G7_HwMc-M!fPfpRQxv(;aG;rc{G^~QdRT*bRqeHI~DrL;DOQlWa4!eMM@4d`pH z@~V!+*}UAra`ZaS`Svx0RGuer@I}T&0p|4>`)+aRnT@x(g8~=&?jBf2&ZOd&a#Dla zA6W!0II5QOOw4N|jqP>YdCf*7B|UIARPi7!WT*kQJN>8T&`vvvgaTpHF$dvSb#JNk zs5PYNY!Se*Wm8E^PG=Edl-@p7_h>4;rHQt{DqS)4#?=Axvq&+iaor~rFIE|`7Bq_h zgy8^!QZ48O0r%oJZH<#oLlD4SCvc?`@&D-CzfG z%TK|*nmG^UIhR6e3n@XuLOx$0R@#hPQRLkmy@kCT3lEx{-2!b+kA`$-w7BxH6%?6o zNLR@^inP7H!}w9|02mzjPtSlPvV$|x@_TI5^*B=#Q5LPXI48Opwt<(tE;*Ha&;11S zO_b<;`G(poihI;$Qz|t9sJF9Y>Usb0p1s9p_a)PTb0TA*1l5nCu+81u7BvxyYaOul zEUWX#i;(CgJg3eR+58Y^2~O$6xT-A{z#W#Z&j5_ z_gD${iK&<}wFVGDPydY<21 z&_)lF&KwGyIqWf@3)@GDNxSx1j;u;XS2rCbl@=0)Vd=V6N|DuvuR}4hCqgamV1|#&e@OAWu>i9rs5)I<;)a&lVVYHVVL5 zGVDU1md}(xHo9Zj_vLujTGph{$*5DIzF>NYfWK0h^H+9G_-xojbl$d(P}awskS1Qu zdT!_7e5=<4+FJXoA+OGmrlb<5g+j-=NFfu9DnSD_|9EdMr_v1dYent|dqE67x~QH2 zH_@j~@mid1CTo%!TmcF zS2h}ZaW+R2pFT=thiW0ir@c49lGO?uV9D_v!{7#6vB+1ZfbBEhVc#%Z+z_ZSh{wre z9Y68|z^0G%P8DUM))s-^?J-`NDfc%G?=zY#BW*ic8JB3EST?tTaWBg_rq#O$VE zVd;3!?vkJ|Y3^)Q&y87}v9j@zEA%>aGU-PU?^zgDw(o+u!4;|v=vHk8`Uo67+sdcp zx>oDSY~iBV*sYIyyNwlF;8N#A#NyI3Avl+pY2uO)yQkf++XODyecob<(X%@92ap8d z*)6(WssP@uP@;3ittXrC4tyydt2JXmEr+YnkD%e2F$bYJnB?rE6i%_rDofBvs_ksU z9kR~-bs>uIEr%Dy_o@p=J53!L>gQ^)D%^sr0A#oRo!AVPUxK>6&TrLSn#qxCt=Zdj zcw42i?KSAEZsDxG@!RDF#o~p%%ALM__Z@jjk4YE+p;Vkjxbm^GIh3Q-ZxLpQ`;nW8 zAFoo}Qb#JL8DIxC3I}7s&tMm%wUOe;$78j0v{m7qK84s?X5((y%qP}x43{FMmLd|Y zhD>T*@&+TBZqjuW7kC!(42{rgjRg)veXi%ru~wkN98F;*69qT2=8+XgUIa4xSqVG= zMd?ZX<+KyQr{{zrwy*wZ6g@18d+8N>-=-m`pl&P4j7E>a0=aU>4%g9Vq-UW}sB}BL zSnr@NC^aF>JTLto`Fi{bzxSMBV5Dqnb6qmHasQ=Pw98(P5VSs2-7`&_RR2Jm$e@$-uxndt8^&}ZKAJem7AAVX12@d7;lURgt9LyL<$G$+xlJw6@VJGW+;l%cIKeZ-3=I*nLT} zKE3)XdjZN%66wl0T6JpMmP@QPSu%On2Ee}cKpX@(w=QnV<|Suf`bHssyQ1pT(N?K$ zd8i0xPTPNH?fXvM0k*%i5Z)Mi7)hf<;x*v5bD`cf%RrKLNlCQ^dbL4}cFjG-(6SG+ zInd201G-lo19lG1;=0)G^VlXx=A(%WcMx*tu}tV3Fd+SpbxvHj)+Ck4IU0G`54=rH zNuR4Yn|_JqQ|Mt#Ty@7!D?8Z3x6Ly%?pqD^OlHOK5xDN;SH_slv^wki1@dFqz(Tw+ zpqx%nAoTTpK4p~kgel~@hG95>Ph{;iWF(O+E+1p7ZUo8NtJN+eK=ncn5Pmyd?G11= zxN&XA3wMW%xH5yvE7pP_Ooodo#xUf(&h{r+B+Bn*n>Sem6e0vlm&VnusdblJ=vW1| zJmc}myqg-@DNCf+tQ=ir!C*$YZr5!hR%1Q!Rz1drn9dUR}TC^o&)Zi>|4$@pHJTJ zH@Q$i3ci}EtEn^NG@7$npH74U)n(8-Uy!z3#y$Jtw710FViC$Oe*Z+Y$vp{L6&GZ2 ziw-qUC0@7`8)c9MQb}~b#KAlbLazSi3vDNMhnPv-m?&`7)Tv;@tdB2}vu%Ced;RXh zdhPh%A6~te=_T<`oJgFXC0vaAV;s|rsDrFZ$CJ8)9K-3WpNxw_M?|?9B~phL9SmonmO_RQX_hP(+ zxy;Es-&1EH05-2pZ(f5_zT1;*7FLNRV)O%x3hx#P|AV+n>9;#u(B-P#7Hbf%Fs0t} zrHCxIp97HKOvN9PkVP8>&Dns)ZtsyL<##RNOgx+C+NAelzwoH7zTC9*DS@umyC_~S z00uqor{M@xa^c5RdCHj8U-9X5@%pF|sss78GpCa)ddFb-$gH`!?Y-{lHV$Yg?b%qrG44#_#8o@Z+0((vS+n)hinh+QVe- zC|RJ2tDk%w8N4PnrhTQ+ksHD&XM&vj4$f4it4>!sQOY==GgPq5S}ZZrMYXIoH80^U zO%0L_O9!w>R~U&xv{~!Md%XYpawWEvLHzxg(HonSiAKqk>YO+)gC4XbZO zD@#m6u(xl92%!vaR+NM!V#ADOBDlCgWNN|hYkh`EAY6Fu3Wnz~B}9^2F`<+fboV)b zPr~qLTVV<_SD{=J8ibv$;*74>@%XEW&77EHT8(q*Gn~C_Q%jRTwP)ld7ZCRRxIAJcgnWt3c?K9}EFLW-f22EVttZL8m!HNVunaoocCGqwcf;iL{ zgiX@q+f;N{v>$EYRGEB`R|*2gACh$aj&$L=Q_@|Sb=~J~@;2YqG!tz0!E!DQ>wn(- zGq+q$Til^fV%EfK-&3P-=S**0VtFvvZk7*@PLzmmBsiblS5VNsrO9iS(Aj#G?{3iJ zWZ5wp-C=vUZD2}Cb?9m%D*Guq3x=EqFl**Z2Olg05CM1&;LnUpA~c9~roI#J&5!Y8gK%C5-4eX5hEHkFzM%IZE7`83NbXSYQTgvLS& zcXBftT*n_ZCxg#hgLtM;N@g_VC z$nMNL;|<<$6hI5f0*wKy(8b)gN|&?;DgD+(xnW>kf&PiwvUI4w2iyB`$-{q>2_4>mG~$4B(hM}bxr-B+Rfpi-8P579?e{LC2D6IK$dk<69qXp) zZo?KjA+nOmzf)7&yXgx#`{Jf${p9C0PioyuYf%}sUERq)XHuCESN^s5b@WxpV}O(F z57hEY$NHw*hv7B-5y3|Wa}rOc<7*-YJgsf>xWsrPrXxQ>-BN7i+H*nQiu}3?LOm<} z)-`tayllPij_3f+vZj<@U(EjlrIU6QwmLtJ5nf)f*Ss6;^OA#te)5%d*AdD=E+U^| zP3-)dzr?0TVJ&}Ke<`1(ti#(`k+*_9b&ylpDQ;e3=ZPPV@^ahnrJiU=&;OzYskXIH z(yKG+GBM#r0DSaHZardmRkS`oOS!e;Ms#^9Nu zC})9X)4JCm(|BjD7CssdB6*Pj9U8RIr9S2;GWdslZz20xI=NRT9fItbqJG*Ov?#Dz zo{>KHA^6vy@xYaD)Y?JadUEpvTh09^jB+D?{`y69T=dJxC&BeP%1gl5mnUfuORme& zBq7-(+b*1jZfe$vL=3GhPOy#`8;#Mik*b2lur%GCB7JxXYM*5-Zhe!xm>ob>CTGn; z@-?+`Gx?_JGxl?4-k|@Tp1iGl)oendrovn%+_2g9->*w1wC7$wQ4^Ci8IVSXm`Hdl zLjn7-de7P>!r>)CVuw*pqX{^X0Nl;1l)?Pj+;&SFo&%Xw&%_)_@50bgo2%Zdk=+tk zU2vmeKpE<67>28EE_{Q)boS+y1a0pYMIE8SDW4?@a6;rcm2uex7*`)b&qTBP~K}pW}S5n|KX5hPXVb zoB=>Si!FWw!&guAChW`)6bP*wLU+q&X?uf_#!Qxp&l@_L?6JfG_`;Wx6Xt2Jdoj-K zVhx!`bOx-kaJS%_X17ICx&UZFRO#YF5mu&b86@2%cY$CeHjaI-&VvW_p!E__)OD%sRGiiP^2GMw>QKnQGSkY;?q? zI4XYlYY^p@ZI<0GO8sk`O!68=3p@0mzgUd`AkSz=g0sMq^nDtSO&mg+Ws$~Pv2}OR zNN|0`e3lM+^+Pg!G#c}li~Up}4`BE%XJ4RH zsm1#S+Pyxn3lKHdqGTh+0Kw6K%@n{RLO6`b$d9v1YFx1%p+e4)6~}y37k%94Ha_5X;*fuuGDG( z02TxGe9#ih4NtAMWthO5I8oG}&5)Wi$4j3$HkV5SqMyL3g5j5mrWZ}S!ZfO@dLvBkIu9ikUG4v2@OV4rGY z>fC}(B>SnRAZ10iyHxs~F(=_$+Xt1AhrQZsUm0&+SAQrdROCzFLsp0np}pO)Z<*6t zHBgKteO|n}&w7yyXEvm^Il7_*8t&-Hi~)W3S3+mV*#!H+)3%uV*=a#P(}WiKd}nn| zBh>6-KyCG=wY>ZA5rsM?EIk^F*mp;lFt0-;2|ZqMre$k8ROHeL6Q0=LCyydObhpy% zhm=Jowbcv;qYBoZ)j}}UR5Y#ilt|O&Ic?FfgZ0S}H~Wad+cW+CmEF9qS9|VBM0Q7T zBb8wlA zKlLT;55J0_^cqzq5fwWCo~G}qh1!^SuxDJURpQp~g{O?CwJQ}`)>F^(JlJ}E@x6DP z0Z!Z-nN&AECl68lGo7?1zuOvOG5T!=@Vr>YMsZI>>C(p1ua#hzLN{5PbaIHqua8~O z5Tr0!+bDB8T}-9K32*F8Ngxhou9=z#jUVA3b7*>d#(V8g`Spoh%TCub3d=q_ zb4tK6Ay5AV`{2N))f%g9@uB^t_V|<91LDfT6s2>9t7kFy0?s7wSXGMpiNX3cGUDji zuT*%Y#t+c5lX+Mu$e7FaOb;o0>!R`l5D#S6+I8AN(nFvv!(P3E%#h zC?37rI+92X$%EWlHI7u;19Thnd1JOm&p@S*j>xp5!GdYS#QQhk%BMUwT_`_E{*mHH z@i2qfe;N?Y^Ss~HR82e_4112m;DJ~@w0?JPS8*R}a9rdGpl zo9C+U-At|qS;w%4E`Hk+HTAWSPLxKv&%n-#9I4LDFwqr3xJAk7Bv4_M1oFV#J48wl zab>A9_b)JTEoiCsD=iH3N#%C9A{dxh-6{tthgQ%{hWPC=bN7Xdo%z2s6PY?8&e1$*DWu7 zw&Ct7(6bbqRHA)&U?>omLMhT|eOyfS+6v>7T;eHA@nK6Ear-_n+X3xkqshxd6ATfLLQ3G>>6HO=BkmZfhQ-JV;ra~21hokmEo20o#T zW1Y3OpSrlnme6DBE+JzuDslHP)d4oKM|YLvj3|) zlY>WwAk*>lrKpunmx&4~uz^mXE zml$@my$&Ds2C5=r`3Ec_cdB0b>iUnCP5Okv7Npn^t|hHhf??_pAkTBRrG;-+4y}pOjf{|2IQLQmkumJ&O>Vt=~Gas75d1ma`fvT{!N?t0-dlWNansu9 zxVHq-ASpF?O+`tEVxwE-m5oqX_rLET?gczM9p4&}NI9KU*S>(>b7dJZqg!b-Qat@J zd(q~YmM_X!2H|$mMm7~p{bMTk>-mjQ1!}NC8*(t|a-FfO`Gqo$>k9=IiA}Dwm5LTP zDd;>mWL-ymU`^cfCGlMq)A5mSH}o}xO?g-IRC-(?P2~cc`QuGLy@8Q+5V!>7pqrYt`4@%d)Qj+=;Jyd zywvb6``~lm#~ylj4Yr5ZcSxmc-_u5I^-K`AU5mHRX{c6=gp;@uyF+Yy2CIcWv_MX9 z)`L${4J23xv-c?fqALCiaIK#47Sf1#t=Y?K7+a$+fN-b2T6d#IJpJjGOIlMy zBh6pjTgeL8DP!{r_HF7RPY0RBU4J=Il_`XRoFkW*zQYFoS)Au};$40;<-=ua%%y+9 z7dOKDPjJFu-n&ycmfuIaCc~A!yI6CT+ zq4&09`3*JRsUa25LmD@Ej9{Ph%Y_^Nlwb9LXeLpmQw%yRWTKp+V+&n;LEyyhnyJOw zqsoW(vNHBzUhuc^npZe)^N7VbAPjd$Yk_?53$NG_jA%1R^TRdiI=Tad@|_Wi z8W-qM4|a`Kc+$HEFysX*`<(cKNh`;zF8ncqtI>+sVN&E@v7TGwtK+F-PwS>1ni;D? zzk)}+1!}f^PR<_DhcnP}iYKj`36FTAlPl?@9HJ3bl7GlRTe2pKjJ0GLHkVpQ;$&1W zZoMdX`{nlrXPQbiGWNqo)TME(1{PahAs=5UmcQ9DJ;`>Ra-_OG1a9Xsu_8XHVsCTP zJ$tjYGW+6|{t<2CB(wcX*`98zABt>)cgvkdJm3NPQ)4e;t0V+3!gDl1WFQS_zJx0D zi~6(izAi#W$(m~XBsd<1sw;t=@OH6pOnHxRsWH@5K)W^-^r6{Pq1@zy!tOu}tB2a- zL18`EtM*1^B3-G^WXSDjh}*wC9#Ioq4CBY`#Jy+;b&V0^7u}_T1{WFO4##mqWmH2D zd!I+ym8;R5-o~FxkOdm^&O#;05@37P+z{RpeYrB9Os(g8ihiX$uXp}JwpQWLNawa& zyH#nP@&yaZc)jogRs*x`AR;C+NewL z{#Un$@s+=db58UXU)u&9H>B{}e=>WAqtl?%yu~Ev^81NVAdJp+FDsjeX6DI`Uxvjt zNmPf0=baw3Q^kaLeP>b6n8oq>!@I)^4I|qY!7uwOgR^S%$pu=Uxd;9cX0opyk%9Hw zrOWbFm|W_ccz@TWL<6u!Ya865v21k9sYGj(hQ(Uxcb_;eJPeAwXKU&&&!9s27}+{u zPstNR7t9Q{q}hXhC;G85I!9wurwiWO+HU0>1ZbP;Snr+;JL(DfYKyqgPt9`2A$+&; zGv~~$8O&&P+A1G7He$%7@z}YKC3-C&w|DwCr1-O1J{Rmy(j z>o!FZM(#aB6d6TCG=nC}I8Lj;qV-209zyvNLd%$=$?nTT|3EXuSKWN>Sb~89yc|=Z z4>+a%bee_Wu09L03M5T`P9YqHpb>fsl0NR>3K_58YG)f%R9rMaNtwkSXNyK$ z0WH8>Ox3%5D3O&lxUH=Rmt#H8!fE%e$F`2&to}n#HX<)8lyKiN&Mn|kgCc*+;kPpb z7PFhGehuDqF}0sphf=eH?Rj%;Uva>CV#u)>pN3&>4zG2OHl{Dt{E+J2v_%0qbzK6F zGeT=2?VcW*V_O?6D#hcRW( z0d$!wOiBLmA&Lq#hd8O@U)}r=W(F%ce&2dc$JVp8;^EZs<*4@tdynipm7su z_R6i%!=)7cmHT`a4Qsg%H-+2Uk0*XOmad@_aeA-3oK>Kg*Ad$SIFdcoJhm~_i(S1l zlAtobi*{&ZXSx=UE{h48yS*A(LSnzFIQ(P%I)5^BBx2W5<>Wzlawa7~-pDvpgsvr& z9{#O%W=nP4tG-QOhm9gumGW_gh16Q$Zrs#Wp&cogN%?&s_ZJl$S9$`#^0)(5Ombb% z;^#xaEyVwH2e4_9Au|H^e%J3$dOY4Ty&AnCv-(v6*!u9-6;-)KW>R$UEXVTLfELC; zp8oj_u0Pz8?4n&KU(35af_)nMSfnN#E4XQHZMsOS&cm0o?aZK0LbkJgUO43+%-eso zFaa_I@mep|_$qmzA=?%OCDO>s^_z13K!)(SFOXu7)>Ev0`H;c3e>x>vJqHe*sxlwf zul3YbbBbj>7T5tS!hi%QuJTGczp$z0{7+7`{tL&0Z+iq11xocwJ|bQDQP=$wQ#&>!8cN%$2HiU2Pf?6uS>+ z@+a>p)#|TYmvwA9B*`N`*-%H`C05dAtlF)=cdD`l_-Rlxk2yuj-V+z*}#Xw=xiTlxsbsb(5{(H6#JTQp1HHP zB`f?HTSMdG2=>^D##u(I=+W>C{=2)w;rmr@9}-l&RE9AvSHOjwrHl`lpTGMdd7i{7-F(451E2O2rG!s9Xm_GN?at2s3KEh@FKIaJ zv2dafehE``F48dl)p2~iYw>KS+-j!MUUEB)*(YBnI?sMs{>8S}@Z-keuy?M=)4k)< zeTR*+9jg|x>cI~(FtI(Dm+oE#jqR4!OvnJScz*uNmMu=|Jo(UiB=T8x`6)pUii!5%NucQsaZ1mINK*76jB|V4nmXgtF*iZ z2Wr@Fb{d>&S5+vC-bb4eNK@!FypuY2=nN1B+Z2TvcT5pll|9Nye9fz{!lVZ7@+7Vx zXJLleW4oK>EFLDE?9)D%bs4z*6zo;al8G|_t5>v)rULJDKC~^J#10gzIu5IR$Dh_)xkODFy4Ks=9|h%RO#2} zG^$S3Gpz1hhv(T?%~JJW`v;o)%vkOupxH7eEb6bFWayjXpMO_As$;mkBgk(gsjGgo z2w49rn6dqK|EX0|tJ2dzw>QyKDNo*g0M?2xfq4 zIe%N`t5#ziYwy5&?Yt6gQtXx9?l!|w60n&L_C< z>v!JtUUOv@9$T|J*UIG)V}c=a|eQPX=T14wOrIX<`a6pzF%q)3LTPnSd!Hk3>f^ z$YgoTx#ngbI~V0A*y;5bFCH%j2B-98W}w^2NM|qBIPdLpGGoiJ_ByMuuYV}B=cHGHqD8cOY1e1yQJ;J|P3#6!75W*yus@{+KYZ^I3CJ* zI~aX37raxzwR?2KBI%FX?os33sKdwgZeZ^`lmmRtPp9qCzI7(I-yt2cbt`*}vv^R3 z@^8(2^8?2Dg+jgucxKP0b;4@O6!B@VUp@|!)cR}|)FWA%=JENMGl29stQ8!6Cw=j+ zFPM`edX-(weTLc;#_RWd;tW2G6`!rTphb;ees0w8+CBxs1(x*ixsLC7#toJSn*FXO z9zBu)NI{?v;Y-%cHih2KVT7Os{O-i^OM^IXM@Varx0@W`()1E|k>blS&o6FJjuZ2@ zR?hV*6M>UZcmC{kMmG;*F=up?qmR@!^aDb5PAZN|A>t10^p$=2H=LyO(SC~Av&X+# zrm>I>2*I#+!N_N0khyMGYV`B4g7_t@pZ$WI#=2|cQ{KeUlxP|+6Y}qUy)JZrB{q+0 zU3pDqAD(ykCdA5mAGFK}4!^Y{v;Il9etRT1TX&K4g1eD6Ds2M2`czay+x>8y%nm`lc zMZ}L=eB6m&S?UxZd4SijxPz<7Fv_ zNEXvO;8>|%;lD84D4XHBOYWe0pafGHfQc$9e);HGPEETpcdd$A?=h#Qre6zR$<1Ln zsf7z#Q>xg2t!}*`;B!cOYp-+uDNkNhc1ZAZ1@9V4Ahhv_6{)tw*=hfyVCfajrb~<} zj+#*ZEbFIEodLQx)82>Ky z;LS>U*~dq8C!%W=R}+6*O=d}qNKFmIfY7Nb@D84CUq2+e`oM=FH+p3#fNZ>l;$8NT zLxSC*>nx)B9=c3_xT1kVJxe~wzidk^*CeIfRBlUrpLO(v+P#=wgL{HzPmYo=*X>ab zZ_HrD#W`r}b*OcqSw8M3?YzdD5Rq)&$}$cQ7FGxGVZ=V>BhvoFw8g!LM9G;0sPP?LpbdDnd9vz(9Pnr12ekk+mj4f2R{q zBe$`{Ez<7ih@XS=>hR=rrGeYRv zFQ>Bl=L-zDPv-mM1Bu(y8(3LK`bKn!6@$y|Q$O0qUf$Ks>_2i_?pR!Qsoe>e@4>X> z?EIm~;)AysnMCq7h!Z8(Li$esOh$N<)peY7qJXVqR?uOW!kd_N8tv#gxpVM&1YQby8gkhMItO{JpnTE%h-@7at;47=ingj z;qx^gIgi{eGu;P@!KXl4>Gv(2k)w%GitGWcuMeU;Baf)fg|wj)Zo}s9TQRO>N>N9$ z{cP&$*cjMue+;x;tUo2$WEAsgp~PoOkC#VvKWX|T4!556^`z1rVF3-J-uC<8OAzSp@pgy&T_4fF_$kvYb})&Q28<$F zHAg%ZLbXn;1RLh2iLAWCe34J$W@#ir8fohngl~HJprcfkDH3hDrpVJ0<&V>mFVvTv zrSfSigg43L$@@96`W^QPPl^l$6S}`G+Z59lU8c9)BAEIc=+-6oT@!;@Oe(5sM|O^V z)gLZ+j7g*0GRD`8`BuD6mfQXL+f0OiR-u%_98?$aBeI#-X=88HXR6kt!+4JZN?Cp6 z{q&*ik?wJBx%+Ec*_oKAAa84$if)f|F-*W*@B=V~IWw^i`CKKX$Y9DWjbbUMFJ=Sw_y5E?*EjviWqRr*tRL^${9_GKj;PUn%cM`#Q z@J~;sq>!;UTbY@vMC9pt%@L$NKDap9f4CpzC@!VmvbnN5yj1;0jln|H-nIjN+GANf z1$ZSaIA52T!bBO|u1_Fg6&zbSBC|O-{8(5%ic4YNEPrA_1qb%jJMXfAO?!Wow-=F3 zP%8JBOY?l#CbayfW>`ZeMdQ%0;%?AIC;1diJZY@0Tn+LzR%L=FE6{mIZW2yszz!re z?jWN9?1n9b6lK6iI_0a$ypWhRM>R&jbZG&$+uUzIM7x}g$0*fG6I5OVzR4~lLnFWK zS4w`mIt+(#Xh*P1`L6~&t^TSpEB!O&5PJ*L@w1py?Lj$b;RS31+hE&qA*Ub0QEG<+ zpZ6)Y_8KF+N_E|~zA9x{m~~?Kec0S&C9U%PGH1ZtNbmFLpe!|Ufz}x`|4Jfoj+rb< z-Mbn8GHbW`j3-)R@Z~P9G}dG>Z^Gl*{!sS_T4Of0>c@z^c;$je;uP@rGzfezS30zt z1!HDNib5l_W5WtHQS|U#pfQ|DsPrB0tDCGxg!}mRz?b_8hXc8%b3{yG8S=tQf#me0 zhNIFna%-Psm}M7VdyF%gI!=?{)!`dR8lJEWrykb}W){^F!a$CEfAL#Pj_?mByzDy4 z2%x@xS>4^>$$EuF%^S6T&Z$#x1RW3FFz_APcPdB^Dw^(cEE4s!c~y(d!sTVv!AX>2 z8GdVLoKl!{v6M4o_t$K))S$~V02~60BI86xATLaZyV0TK)Ju6&oCi)3KUx3_Ge-;j zn4yE5OHhMh{m{yJQrv!L`MwHPJ_SZEH3^5)@>2Ri)~HpmG%?&-MN69&I=(lrnb`8U z-7go=U{~L*f5$kfUrDiSo1>$lw(hecDrsx-F~#v+kDQgcJ*Vc=KYTdfKei)e3Rn7X zwGH=_tFp^PsMs0~WtVbeRpj3A;(2$n5daL`yB?EKF9KU+JNrsYsq)1qyZs|!9F_`h zsq)-1{q3#0`opFJ(K^u!`N)p@^#NMP>tm}`#+JXIyM*9{!R*JY=l7w{RB zW}Nws+2```ZB^G#_Ua(FeF)T&*$+rY*RoR_O>F~7tr?^e|*#S_TlJ%03{ z8kAZWZ2wsb`q1P_+P#r1zLbH|Xf*29NT9gSGRN?K=S#I-DC%KuzbapbT|bG!Bzz&m zwyqYLmj%K@yK>bqV{R|a=s4(Zr-6W)-@5v1HTM)|+pch2Z7wGGIU1Nd*i^F3#1>aP zJsj7Wdkh}$!Atve@)k@SvANs>@={}L*A<871i_aWc%1B`M20EugU4@Fw%kW6D87rV zTtBJDKWYD~@Q%AYf{d89eR~U&2>L-c>aQ?zbBcnbrAzQ*hZZ5{uy-7hQfz@?4??EI z%Gl+otVfiJmfH5do{gr8Z9Y?-Uw`y&m1A1UQ>$0_Fg7#eVcpBV3>mwdtC2Je*5qHv z-w!2JLuEewicH+Z%qc`QFm7m+!kSxDZ4By$mSuF=Gz(UNM&F>d>_=eL2d%O~l55IkO7$Xl>mT=n(5{-I#G^e*eIr&Ydsct@H%>IMaB;Qf> zYr6y6HH5<0L3O%%EZ~&PoW-mCj<{&CwEZ06v+|%3!hOQE=vI?$aN&{5CA7x+>i!?> zhvVbdRwA$HNe-J9A1uP((2iF2-IBw9nVQ__Ja&$kPr135181HH)|<=l%%SCI5y!go znM^`at{zGPK_P!K>YFFX{jv-MsP|=nTotFb2CPl>H}|U~{zlYoR0Lxo?Gtp zO32}%8W5rbP23w9LobRf0 z2g~Rn-(eai+9QTmnBS-OTCfe3JKGnX@tc!llJPI^<$OUJ`cj|0u`ke*@`6TBV)2F8 zjJX~&+`xl!*ly$8W7{Ag`se<2VA&t*R(%{Gv8ebM*RJ5vQ1EzFD@x&4KsPkyQ?)gW z&e-?*`tReBuCrt%!utAM_C9?2sej062v+v?)*mgtvsHTd65$Vx-<8{adTKXgAarD` z)_GPWCy-bXK}n$fi9wr$lG?>R6TWAP6S}@iV|?=C*X(3}YFGn7VU2+r1LZaS9x z^IOP{MmOoj(O@9*Df$_TLqW$&;SL+o0gml9U>TRA2Hh3e;&WKYHqp>PO&SQ$qKOGH zrF=EqC;R+JzP5h(Adm?O4OW60@ln|d-g^#KRuYub0ABRwXY}-Ed3cYncHe`{<~{+5 z8!_WeOMria;0lEbM5G9Gy!9#Eh)rE>zS$~-l)HeN@seqpF+nCRX>N%k@}tcD zALp8v2ORi99>rXS=y^l%^@A|G+@+yM0qdE^)12|$i7Qv6VkCV4^jGfNWHSJG3xHmt z68(-wR-sm*w%Ct1R!gvYoqz21_BPJU&=w`10-T$GiN+}jlYlAq&~Zng2Jc?UY4DVoGn9+7DB_@SidM7$2K!$;!@Ab@V-oCG*14~AlAj#p;y8VfFHsT zPY=!-Tz%W{i@DK68XSIUCsn-zfa9?Mmg*+eoS>ODSUD6}DwJA3fT7NL19-V_Klqs6 z%1_w~Inm>78w%xZdQGb=ET9|NGMKTqoj%n(Ws3!i120*$04O4E^z&b^3uQc$^6#({ z;9-jB@1df}P&pU$GGC5v=0<7IQmOW2VIA6z!7t^HXmD@Z#_Nwa-F^8@z|LbMH#&3Y z6jEV4)qdBN1@6O(wsMSTHc1(Cw4?PuurJi4%5!;5yZV6Z8g|!)yixqANx6^UwbZed zlToX~3Aq6?lX2a#D=~TJ2s{A1aMGH3FHtae9w!4UDFs-o_tcDP))hvMBXdIXwZW-# z+4oqf{zcP5#e959V*TZL`?Hxutx;>8iz`pZT%J1i3_V%1k8P`2d@5g?$&s}ZzeYz! z#z&^o9v&(EIg3`#>@9Zu&9JD}voS5G+-!!#20>@si*{%;Z`)#HJm6D)&{ynv4A#4ld$j?~M#PB|~Vb7SzBsxAyzt z5W}EYPvT0wA>zCZBk>5;bk-MpfMfR$&YNa6AeD6nRUyt)bEN?G!lYJFGtlP!f?E^- z)N#y|%v@QYX;=9*C7;6T2X-?UEz+}9tvHkVAWRi0f_N%#-0u{Fy8qDp>kT!E>8ttK z<09^R<1SoM$EP(LkMP-^^Fh`3n7}ZDHrjGd!uREaMu|RBGyq36d zs?iHX^tI7Qk~x`jN^5c%m(`0v3>Ch#0W8)4P>#<9z^l`dUA`{}ApTmWu|eFxvAEx1 z>X*UT=CMc9CKW*I0g&VO3h*vl*g8+n=qi7A@-B)>u#P0HtsNX2C8NllGsi(B1Gm7>5y8Qe6n->|uJKHlN?UKnQnrr=GwGi=}kDXsgN zy}o@tTXI#!XCW;m=*`;Jo$@sv@%Fj_;oQ0US9}kBtSTmceXuiN&z5x1P94u8ow`IN z)9dsZtDy`OiF7f-+Z9=c@@1BUS+x8iZ9WPMoGNMzvU0;WJ|%i_O(+)PyU1YG)WwTa zn}<>`?tU#!EubrOw7GeV3c%E~DZWZ3P+FD9gg*d}#3`DNkl8p$oIX`0F_p3SI(P;L zDX1#6K*{=|+Fu?OYkbVIa7`CAH#MJzrf#!Jw58{iO;rj$2T*qh}-{ z($Y}1dO&zuW>!f~A_0;68#j{81aXcV881%vKXD_MT?95iSOFj@F#tGO{_xDz#~4EJ zQyz!PUkn`+dVVP^|6qOM1B=ly7XeUAOgIq~^A`F0woqe$UjSlMlx=0U<_jRReJnyr z(dSpL_Bzk;GES^r3dES=Hk>2s_3+qy35A9C_jVt|$)|5VdSM2<+Eouh>&w>W)0sq*Uh&hk|*E8&mEYIQKP1^^jYb(f96UX!Dnfv952t0<^Dhrld>fZ^U{ zR?3Ur#u&5DN6BxogRj#l{sm@@B>Bw!CG;x_ik-<&J1~}th!Ks_$ajP-5Y!m1A)=`a zO{R+k$Pkiiqb>9(IRqcZ5$!51Fsu)v2K5N_{I*F>K&OI@-goG{R}q{p z`kC@NYqL6sPCBM2{zR1C`u!re{r-E#s5%AO)0{C8-iV$fTit|`?ETUzbw#2wlM@LY zzjZB1Ub7VN6#E{9mg@U?`l$H*nD2QDAJ|{_$$oNn86?S4Tw{0=-EV8}91-T33|(mV z_O-k-)1&21@30_8s+Zoz%skOR?gR8_^oq4RbE7l;m_7&@sj{$0vj9gqX(th<*l)$P z7u=C~UG+c>f`>wUiK)!$0nWNQ)#Tfw*|(15rMwsJNzF%PIFC9F*LLAEX5UV@)n|z< z3Q9TedHPKLjNORXj;cLLmg#n?Ue$M=*c~ca4YCaqVQT-`t?<5-oVe;sLR78uQUrO2 zQX@|j4S;FmIp&4aB{baUXAh6cN{Lx5);3_`xFD<2N+G*0fY3W$c@IMMh zzgFy`VIup$QXIUriz}q)N0WoDQb{~AHvaBgVdWxS4twg?xtSiRNPwYJJ8T42*)siS z^QlJ##iAbUJa%zB(z7MvkzQ%L5Nm=QW8(aQl~-mFg~mGZ!ta&cIAREcf)tZE^UIrc zq^vKehC3tg3+3*1!Unr+;H( zr{&jNBov|;Z}d*A87^gc;V{X~s_q+4i`;eb*&u3G2>~&8^5Nf!0SdH0yA6Qy6~*Ax zHa28;?TDy(rT~LkV{hc969x}kB^TED(es|GGtu^z5>wC=fZaKEhlLIab%FX7O155@ zl#Ea!f|^TjYB$#pjXyQ{Q~`5V@A@s7D*3~U|H`HIH)dL3vbY(O-H7al)(drKN_-|_ zYt9rTHfD4x376b4R6GGzRxU%=2R5=7Wxpg9)6#PgCo76%jvLD0&gz%g-Bs({$LH1e z_>I4nP7{8L?|xA^oDl6||hMHkJJi_o?$m zXDotvf`eJUe^YX1q|x|AIyFGWYX0(z5C8+%thD$ycKf%RQx%gLEcE0ItkNc+$z-vE?XzC#uJv@IHbJ##=HSw)R&r-<&>wY8p^ z2fLB^&P^8xRJ2@FG%BrRw4CgI`3uNI!7-T@Baf0ACbG^jk~buX4$PA|ad+9|)7YE( z3Z5RGo=B4N%5}GWv{K_=o6UnFq)a!pUh1=HLpdXs?2FzpIQ@7! zR2Y@rV7JS!LWHl(Y*Q7ccl;L%-~ypXUR#|ntwrnVwfsdGm8UQn3d%r`N#=~Bah^-5 zA5ZI%balL`&{gW2ZZ1krZwSsKqax!ro8fW(_T!er?<*w+FO-?g+rNL)x~#8QfLLT0 zK1dWxEu!(7t*g7r5xs)N5V4w1LrI#sG0G8JR<@|-@!H|OD-?Nl5GpENDsG?I94*Ye z{QE0?R>)bV{wNDzv)^hI>2s&5L@S>Z#9a|oAOoJ}H{p65{-sDX?h0{r!s3A0mCjIe zrkQ-&Wy$f1>|+k_TcppNMQIZ3bK^C&UxHb0?ZW28pDJlr`}yP^&)qQF%Td} z&$kY%P~Q0Iz$`WHQE@X=kRN0Y%*#2Cg-gSY?nKhEHKqtrNO(mZmA(S40e)IYFw5jNr+QCm<)D69D z+4oA^iVuhXPy&+kfQq|CFSug9(n%q)<9)(#*c0@M--_R5P!K@B@!YKUkuzk@^+AT7 zOisa|`lWXb0A0*cv(lJIUscp@ve3o%J1pE&bd(wOBMSjJf8BZVWal!7xb=KkEPc2q zpV_=3B4-Y|QqJqGm=@gCXk2(qJS&uP7}_ff~K;3i#1bXFYRICyU?xQRJi}2f#as_U+N^B*Vl2`Vb-o z&v>44xEf!qd}j&E{Qbgv7Oe>)eTq~>UV%aAI6zqReDL57c%%1Pju=65xcU3{?-$$| z3FHhEe$SzF?zix=Pvt5B1Y06K34`*jhX2r$#A^YfqSc^BxIKybWu0MnDGnX~p|cwI z>gV`#=g2UEb!Z?P(@Oi8hj_$;$3eSV?OhlS7LC%Jf}8@8K2EAUN{DcZg_apEi#GPF zbVC=P?5*`Yk9Z|SkT8`eDTrfP?W_-+qMc0Qo%sC%ea1Zt$UV}CoO%)9*XKEu&V%|C z%(AHO=I@m(FRE+T^4CRGB+D`%TIGcRUfZ*r*BG6y$OvY7LM3KYOFFA4QK?#^V~ED7 zd{v#>>k5ct{nL)^i|^*n=r4uHY%~ zUTvnXEbqy0LUSb{tZ1;{&Ui%F5Fnz@IJKYy8v2>tYQYP7#ZC@y=hfcafFKX_ydTu8 z!xYYvZl5Lj6ox>OkXEv9({7z(+Too&y zN***@i%xxH_o@>!Y<8LG@6U0#<5WVB(QX%G*)=ddZyesP_dbQBNo%IeT zYaZ0}N@XMDXdw5&LDu7KHS)iis7U6nxlmvH41C_`;! z^N4L%ywZv|)s9I=5kDj8k-JT@Z7A#mtU;*soAqvqq^Vw)^cv@^Ax;HHRDA@?(1)VUFZC|n8xv!#Emr zUhI1DjmSM?%dq%#>Q^iCI8_tybBtd^=!QV< z36@G*Lyv7!wBo{ajg}^ln5Hnyb5sPf8XN!X1oE0IsE6yo;0@ez-itdq;aj|Q@?Hi9{ z3l{&SrR(5wG;3G7y}(sK<8q-{Q@S|%jwTyBO9*?V!=)1_En9eR+SiBMd45D+=~Q@o z;&fOhi%KLTG*C(ZRkuw?T(&C$UK&lwA$lTc!u6U-d1f^Vc!b6hhwA${TKW0mJ1(kBT*TGA2KAwmSPZfH{2 zllW5oiVxl!_7fXvI`!l;pvljb?ss1>J1Ho!kGfeECCoBImaW(opaIC(BOrigAO1&~ zh9?=JlkNK@wlu!iVc$02ajCsC8k%KJYBX$>w@P-;UrhN7+B`=LN7cv12JnCRHrp!% zDZ?ko_tY;~05>{f1+hGW=FIoV*QjoiTlW0^{>vu&x3N2xw*Um`qiI${MHBjWoGe&- z8W$P`$WUipfz@YTy?h{DK5j1E2i#H!E)4w~Tnhck_VohNC4$KUo?udibc9&t35oWl zg`>VBe2kVwL%&!9xj^moPiZ*Vhaji!;*e`Ufj1;#9{=;B$MQlp(*%<+)YDwiBM&tD zUihMNRjo+hSC*yGFt}@sE(4i7nXip)KJ}KX)MWpr_xp@CQ?H^w6#w4f{63znprz00 zmnayp&APszjebl>E=%7`8e2Q(<$7 z)iP^u!s1<}T5Ij@2;9?%d-va84#W&vDqMQIRGhBHHZdrV=(GRfq|S}yWA^)r7wN;3 z!BmtBfmyQT)Mg^IXR+%TK8xRR@4CT!qZ?|J`r?-BRS5-C1yjIH0uD+NqPN6Hl^38w zlOLaH(K&*8R#5$>r4t1A{)QoRCkdYg#*omo1O01E zyZVk(qk5eQ?cn)G|K5&x{O(y@m|);wG#4)n&kXL&5L;u7rV)~RJMNv36Ve!RdU8qz zjhM?PzH=V;ml#@BiDGSmFP5{iug!k?2}KBr%2^vm|79+dKKjlQ?l(AoZZ(`QuTn_I zg<7yIq!uCzt+gGW#h{a5jy>d1&$}zGXJA^}07?+hWCU8!fWA@_pa3bbSk~Q}`SH@^ zX~uI!Uej)qahaK#G+m0%P7mGGHI$8kBHMz<+-ylhcHh|uhJ1Eiqp0ILu}@o+E&ndx z_YQD2%>)extvPKrZT}?>I&->gIu0>C7m51*9o=3!-KD&xH%o&zLu4^^zW020u5vQnbw!9n>*v^pT2DVHX5ks&2r28m|t;qa94LKelc zcz5^*-brWWJn?_IZ1whKenCDkamttTTkIDlmiOT&7E_V2>@0n@^RHk?U2w*K&B1?m z#@{p2O>_jo@c$;?|Gdn9esD9AiCq;GA9x$UJaB$m{tspJ?}94*1^9BU(*GsQ|Ie#z zo0Zrri-BM zcmCIlLSvw!N&nXu|1%8Ye$5a;yhpHT{_hw4f14Ecw*PhJ{{KEHI{{R%&)+XPH~q!z zN!<9RzSEHt9g2IR`&-E&<3TfwxiLvV{HE0nR=f1(#}?KAprnFT{jwgk0m!#~@@-;y z(_M+m2VjBX-Z|^~dT>^Ag3p49j98XmtO@(0l*Da-5W+BD<0=>WXQODpAW>LC$v?X; z1ttMLvQ)CZ0HGM2F1(9N^CW7%<;fJRZTx{{09oYwnx;2kb8) zfk|E06s5qW$j5a07;(VN(<4n;V;JE*f6fjg)spgV%BB0PHg|BUXDPsk7sz}aaBP7I zu*uEn1Tpb(kr|OSRMg|8x@)0Nm#n%on45r8bx~Smqr2cj*$ac9mAiu=+VH+6X)mH9 zu+gEkboSC=>&)X6-%~(uVp-mVW=m|6- zwuq7|E|ttLgBZ727Evmtha`1tiG#Yx3+PN*B|EK_tjHNO$^qX^!{q?$ry@Y%rze8J z*uPQrAkNKt^96S@zwmM8Q-I?2-|74)Ve+)R*Otp}E}vcp179vFH~(h|YcGKO$;~(E z3a`XS5S6o$^#vOmNW9dkTMKrQz^@P|QY_M59FB}?8oC*7xE|+7yvW=7!eJ!4Y7WmZ z!UdjT$K&C47=tdPu}J|=c%n54+&eE>Brg_U5Ia00JVR8b0PCsut!7`aBh;DQN~A4O zpy4iAcx?6Yy2R4YDu4|NutAupxbcVpOe4Z9p-Zom+u*Cs>$Phm;^%AQ$pXsUq%rWl zPOaJVQ-Z??S zRhf^w4^~V5ndD0%dGL+zP=`A&7h{2sQkg(3w^)?Z_hUYP^$n(*EH*V7X^cALDCTKF!zDG!3Yl`P-|=>Qs)D!yavkreapbrK2fvh<7qX(Qf2cU;8r6= zT~lOH(7Ew7)t&wNVYNJQ#ChCgm@g6R>N)LCKGJIw33I2bd9b+vYH$7pi@jynEOeA5`gSW$iTF7{h&<

(RwmsyOi$>^fk7Dp#GRFWD))s8eOboDx?r*Y+C<}f`aN9A@h~|jb<<{aXtY4R@3M1uA5b3 zlfm0V0YB84uZGtjHvtM?qN#z2AzAY<3>nZdtt#aCnEv@{ktDaI)X^CoS!W_iGdn=F>{6l*#@6xl z)F}@~QWHZ@q0sRKr{~0=YiIqb&e^~=F&az8(nl)!iW^`dRs$v*&{UzVAJZAJDqNM~ zre_iiPsUekfOP{f$e{qyY9oVdmp&>R3XHH>=`xvw=yk@s+AViH^3N^-UDP%>yyW zFGSj43S%H`NY(d=thkdxh!`piU0-OI{qFzWXSu8VUo+GiFiczdRO1WDNr52?NRly` z*dj5{jDe#L%wV7KB>hLJF39pB-?e>E%eP^VpB`&aGQ`$q;A^tB0*F5{5rM7rX!a z>&HLeDcc;B0qc0cWY^$GyXIu(@T zD<b6uI?tAn=^d4~a}be2A)r6=b{ zCHF@bZrd>E2d4h2=_s~1EtC}M{1PA+Lx!OJK_@k*`QXXBqZ|K>(+{FW{&x)BlZ89_ zuaE17aq|_%K*J$W*zNSv;B$`=E_=7AZgQX3ONX}*X%$Ia3uIDt2jO1oCSyP6GgQ<+}@`HPtEG(j&v{d(W` zDzLpJSOng+ZeNwjv}Ci%OK;b(`#D%*D%COUuEUy>E}`wg>18Cfzm(9hoC5|C75hia z3w}*#``GFfG^!JuC*iKUs5M1Y%2s(gHhDTy`nGW@N#{zm_#$XN)mPr>ATvSqd(}r4 zfx*gfy2~oCema$}($N8KxaXrE9Ms5&qZYU17QBt%ce5#bO%<10HdWqneurn$R1#+4 zlo4r4@9fUqFeOu}RHK>MNv%ZfIAbmcWt#hUFGXE(dPY`Y7(`b?B+*W@yin7GHt80^ zF4$%9^A?PCK1+;lR|O<56R^Ny^fu|#OYcvA$zLq>Y0MBc)Q+tl*J2?7uoSK3JtI9R zgdwrMtOUF22_K)1Tz6F6%*v^A_owR{wRO&JLb<-b6#mSJZ;Vtwrksx*w(xB9-?;A6 zp}JpZqQmqp|HkmQfnNER^)DTq?>Cf9uMqekXdyJ)^KjQ+NFWCyLaWNu=E0kWQtp8T z3`#Ah6IC7$)smInl2yDb!!(r2mK4;Mdhm7Vkx)dK2`5kQs#Z%u{l0bDS9j8W#pCtW zo8MN%q=F8uefGDL>+U!DwJQ*gC^xpG9=jXVpL__|^KtpcJQ>hc|EEbVAAPzNu+d|n zxH%uRzxR%-ruyuakjufW5SPU~87zw-k!m5JUP+O&;SyR;fE}KDi~ox zo9BwP80NIBWKH;d!?SXNsHeiveGDwSuycvUSmnL?KYV>xDAq+@2NHg>dB_e~sARr~(AR!^$4bmkH-Ep2l-*3I^Tj!j`k6FYpd+%rO zd*5;0*G1j{&`^XFw&hg@?9TGwcH%PFJR2cg3tfn^=XcDil0f>5P46{PZ22YnZZe;C zmp~z?*%dHKNBTI$b2GzLLFm?6ij2>nnTvUfqpg+H%AwmKD7kPN0s@{kdIk5XjeV!~?1r{v5(j+CW2>lEY~U_BGLFQenPP3a0#Lwh*xXj~ zxL9yCXdah--$=36sWBa5q~VD@yD^3WR}6wCdoz`#D^tY7Aw zrwCe_R4(SvmMt3g9rNtp34LHR_E9QeHOjs%{uvYiO3lo;z5x2PXf40>glhc)U(%?{ zd)Ni}4bX<(-ATZX=lt}1|M}^O!>jzczUQO;A)s3@)3y|s;$%;Bx9zy;Q8h!V+m~#y zfsDes-vEM+^XS+>poZJ`ELoPTZkJ7Qz;lZ~l?JxkV-Z;DO%Db*t7W{--m)U<&pT76 zbbK#*6444Lf6nZfe&S_D*Pj5CCzmx_O{yMLP;T$l?41Gczjng{Fh)(a5nggVtf|oF zx1)qeRLm0-#_3riqk%mj!iu}!N57p0VGS3g0H%qc1+ybO_E+KD2;J(c2Sib&M=iVB+`TEcKnQk5;F*PKS@GmNcf&w%(^YJ+<&H&m9Olejnwz9iKJbTqq5I zzGH0~wqk9rMA2|cfI5$6t?qZ^e$`ovCzJQ#g;<)`8a_(k3c*JTnLS@fovygrPn5m) z1hbdhGet}<87nplYPibv02S1&!Fj_Ke7?xgn~N|qNITvBJAhNB(98(qVGWvoS(DHm z7$g62aE{qmbV8)u03m_vv@AQI;Rt93&c20#b_qFyN;d0Pm~B_{V786lB&Oz#mO@d# zBZufmT+SXuV+-TUuNi7^;jnkCfIa?1(o8=^^)H~ zKpW6vzZg=)Uy>lm+vsvX^=iFBTpqRuz;qqBr>oYbD@JELsbV1ePsC#tNk!P@zK9Z5 zSOJg+KX5Uy-y=goYueq}200o{WrBUUSWur(CwL-8xEK#h{R4(foyL^V+VpLaNUNO1 zXN7uVj+%64i04*G1w+;QPswM$^KBaykYEqDx7$j92*_H;?P=oZS+uRKdU@UM$*>=o zUV)E34N-b_+VrDx-QX(8!2{lY9ru4qPC`MR$w3pU8k4L-4Spe zSm`9QXC)co*XnVSsrlvnYJN8mzkA^Ka!;(J()N(5>FgB# zl||2VuRJ;JTTx*Dycs>QhBwnpwE(4P5tRMA(9TeZ5MkyKV zB}EF!J3stE5nWw(cz0iI{TH^O&d-2};bZIoq_HTH&EaP#2zVfaAh3#tucmhbZ5K6kY!-nh}!jtXM1R9{}Kg%BM z0Kxw*2b|k#=G)}-fHK;?(?ANb<#B%{(##l&xqpt7JUBE!aGEt&=_;3PrLe$K9P$oN zHaTiKzy02;O`}((WA+?zmCJ;wF%oW^MV}_cq>T{Vu``zo%3BF%+SM#vi)!i7!g(de zx*Osf;uZjMn+li%rnDJAlZSwI_8?L?F*_;T@9U;6ghTbih$ALkF>jTP15bEtSy}Bz>1TWX*bTgg$@*?#DbF4bU!DT-2F8f&AZrkTH`PFf^URzciR^M zRNR_=cb;{QU6X685bF&y#vANYi{tD>B5b(niU@D2;FdQ@%LSGnIfF`>?00u;2VSd= zl0s%UVCP^*FF-OSlMx=LTCE-h2%q>=^21x+L4ngim&#(Lj@TrT?AWshf4}HR)y>?T zl*QEp100Hh{S6-EYqOVaS1W+B=y}Ll>eZERrSH+1yKo243r@?ZNST^_fHZ)4p zG+F-vd^%QlvUYpxbNGE8*4W21sQl5uSS*iBH45B81$rW$>7={Ptd&G}kx%M^Q z4&kh>VHX|x+R8@$X;W{r{%mV2J0r@$BGoaf=9>nK>&(eYjcK$*&nB?T3it$c`}BHm zp7?(jN-{NAggZgU4Xy(L5hmPE1q$Ta>Xww&^ZlN8iL`?KOcXVBx}p^ggrw8o_Ie-L zXV`sS;VP_cRIl@NzhBzz3F@v!n`_+TCs7=zy=~`6xC4Gi4CRo~oK&0?sOC1HfHv$l zqIXZ=^N{im=lzr;C3Z7n4G><2EW7)yHQx*L)n@0F!&Nhd3S+Y>pbk|TYz-NTbRFcb z_d4ICY2<)ymy5}`&q^J%c5Z!OxyV+ZUFG)P0-KWTt^$3Qu7FCb?>+sQv+d?L_gt5# zmOYLG>w6paHMo#0 zNno*RCKgkByYGZ*3{NBDgpW12Df)_CMsXs+)zW}q(nWpp#5q@Oq~fF!=!q19*=N(; zA`Qyce;9(iUZ6bSH!(79lybOaBj$?aW@IQb?18HjnX9&)+i5LA|KuL|{>nWz7s?PG zEXz;UDg%0K+ku~|%#7u(RvncicBIe#EMTNb5xDlBUwLe#xK0THj4o`OxlTlffMi10 zDLLBU{HW_k+0OpW~gaWORLQWg(w!)z8h+ z!Ka*O@E{?@dO=?ffDfXh9^rj`+@t-zqTjr0R((T5jR`XJ1fNBKzg0BqSzX+tVB&`R zcnulb{@GNWAcZ{Gs_Te6YU7&4DH>XbFH+bgE0d=|frn`}DIht=>~l~h2_F(I-BdWT zWkpC6VuTj^hbQE94RV#q0f}!&3^=eNNtt|Q@mgr{F-B-{=13gjb9BNoHJLgO-{&)E^W!KmnY1pI1AY_^g^(?eft;Oik$_2cunKudIe zD9Xv$vHPjN&0vNyAh$?@lm-}ur)H3q{J}fsED9SHfMIyvovxh2(o`(?j2i2$1}Pbb z0N!7pkq8Sw%NH)?p-g}I=#1M|OuOJ6g`s6$}8`WohE(j*7&c7y4Id>+!eChGp0g||8P&ZSeKO}Lyo;!`mRGob3 zrUU_X;d3L$a(ds4{27OBp8n2=esy&dYsxr;Wvkj1%{+m(wm+D9agXt8v80#0(7@y3 z0Cr)uEEHivBpy&p1|RYfzyBI+iV2TjGh%tjzCOPR!=oU>-0)PUtT6EUJ6O3;&%7~| zCYpX#-`0>6%;5kkdIyL>tQt_eMT5|pPTaYbOY)P;lJ9ey`8pgx`ECv`lV47@$F_Wf z#yld0H0&5cVk8>^z`JagEI#pscAYB_fVo&(7=M5#&iBB;sEdJ@X5>(#F%~}>B$>Po znA)h}3D#W0i|r%7O7;#hMe@y$Wj6M5zTL8s^d_6rS3mK&LG+cQ0!CXZOYQWcUT*Ww z3L(U*A`z35J?{z{T>gxSLP4qO4-Zy9IU&Jij9CjlmwTeUcQo-ykRBm!3G2-ywMTuU zzNatbYP4le%*H<}2NrRQU%}-nK5HQ6bD)v>|W6;vQyv^!nJDS+jNI?l=<#WSm#KFZ@sE2{*iroJgBk9OlLLutZ+}4lW%=^7ubL! zUgzt>hk2uCit@*_%;qWL_hYl3LIb$J2aOs|#1rl;htKyP3e=qMR`2KXMH!!;uvsj^ zL6a(hm~5HZEv%$fv*k#Yx~`@w!5DrbMHq;~Ms(~=KsBwHy#jl;oxyY)7*yVt;{A!C z$^WA-f8nPCr zuf$IP)HlCEKc|$cMy-9AmlRC3L2KM)>aKfpn_9I=hM@%PYgz}s{Rfa@0 zxvpr5Na22}4@eSXJSZmU1f0k>w4vk>+6$00f9A34{*}k^Qh5ewfJDk&&}^KDr8R*N z$}uO38WjQad2B8C*D^`&$(_2`uz5Mga}K3Q?QYw}JeF z52>ir8K^PxLUbm!+_jzcp^_i=cSRgMVt3*2KYK1zG(a7@YjFrCN_q8t^N-v^%)34mXd z9R|MKApjvOgdT`S*r_R{FE4yMB;IB2@Xi2@pgWBesY zuum(6%nB4uaqW;u0`+gru`9|f`kK!Hs0fcksv&EoqIwv{O59$t~rW6;MhAxtepuA_&&uYiWn@d?4ZdP zD+w-B%|J{g){GjUtH~?*$q%L2E0LJnO!nR?)4j~CEnTQqtDL>`!O3qhxBB@+e z3rP)mIkx>QU6v7Nw>_jN2sM$v67)X`UjP+(s2KTCpe%tgR9a>LOW5oHKYEGheoK&r}r-wDvrVkD#ady8zX^5)TVAul=nz?R{xD z2g+@MF~!FZr(`^$He+4iCBAmCH-MJCoWI(v6)`wP#EIRVNziOCaywbNe{kpPnkzpL zIM(hFAnEW2I^8+u=mM2>a)kH~WVD}3Ts09+Ui|5dZ0td*T^ydFCre{pZNvG?v&ZXl znVKD-g)3KZv91m387_d9SD&366ASPP^~I(9%G=3K)N-T7)P;fkSoxGg=O;SR&4;oG za%k$q?Op8wOBX!T0Fm_uGZmzo$&%l4CAx`ZXkLewpt;vv?(2{%4uo;* zkRPqmLebmxEOUU2f#bRsB6jJven?4d%a)49p=EflB0O6UrO3)o@Nu+K?kEG zwhB=681s}5l2k{kd9;U=%|$v@*!9LhObJ3!`k*PKFjSu*fLh@Ua2<0!wg%0+c(ONi zq9qZ!I+~#jo#_FMpggthG!=XD8-*#FY|x>A+gj(z9f>m3CE0&3+qnI85WpH zsI-e21TAAG&6Ay8s1a4~iSDjdv$sU3Z7lO1$@hChS6GqEgG*tp|jpxxy%+ z!-e3J@Fxft8bbRTm#&Zgo(hLCom~22Y*5cce5;Ix+bmx1lQ*&#VifM!W7wE6UiVf_ z!+GZKtNyd^BpnJ*lO0g;k?3EZTadh1?9QLHDXgisRh#848&TUQS$SLLvxpc;=}Ywa z<ul@Dq^^E9}X9r;ALJ;*i$38mV082t93=>uLmcR zbH*s=8`MURkb=>bG+sQ(?(Fc8wIVS?q8Sa6)0oF#R1MN#6Cc%v1#?Q|hU>nxo%uzD zqo~OrDlPe7K6rmI=S8ltO|SUTlz;Wi#qWT0XU?EXInp9w14^ts2Wq>8VTIsQac&PE zCzb^%AAV+Tx6_vB#Is16;qpnS&Mu%L@A}H5&W-KKWPE8fcZbx`w9fmB>7yBg!wJ+W z{pOew19Wj)C0r)NBrSBL!S~Vj4}a_I01LYn%1QEHw7qFm1yXZ?#iLxqGjxQaf{teO`>ymCwcO8h zvIvN#;4kSbAShx(w#@ek%6Z%*lTlE<QbI+b?+73VM1Hh6#Y(E-b&@4r2omRUo9&eD|8{Uwnrb1_|+O4Rs>GgJ`e`IwfkEma-y}Yz5~&P zUE`R#FxpBSHt*m8S#_;JukB7AV2iOmJ?BLXJUp_`D_TW#(&CYkU>oKVIcW2 z*4R@4F9Tkz!#PeZ-qD>pN7YBt?(B5P3 z)C#K;3X;kVX2T@0;;yl8IPm>eJ6{9Y(*2FuhPxbzFH6#uN;YXa3C)5nfJ+Vc2*_{{ zuIGxR5*d4pM6FU6g4#K(6$TFTN_t&l)cZGVQYBS)ti#Bx7QJApxw9K(bQJPUHa1Yz zj|Sqx+`NFGkj~?JQdbwFN#@5vQIG$L`uyq!M182Ll9675F<>zu?~W-ViXTxfgYPb_#g34At*>Pf z60N@5D?e{qiHFhu`lHZ-vQpIyHK;8Z){stmjOyO1!h~ZJialwiGcNZskc&yBmK_Lx zAI_!Fy9qW^6Iq)cjeCDCqNVS;J++doLddgpoIUxd#rgKKDG2B2YH2NtMsmTSmvA1j zt;8o*pgV{6(+k~9LbxvGC3ASZ5EZz)w0{4fa-7T&qbtM z_Z>(=vJ%naMu6YNnN9L{n%`yzMl~m1S6G9CBVxC~pe}kMxM&HuDZl-Zo{IHS zC)JAqcQV(E^1GX5CVO-uZbbv0(&ST>ElI20#cvV%l5Sm($~SK#S;3|e)P(jW9(Y!h zroB=xhN71N|IF0^a#!7;V%&8{=34Z6FjnzM(mVV3y=Bmkfy%V#_`zM)5vLidK3qt01& zZ`-MIP9{7xc?>IW@)zujqqY3?6kxy~#o$;0+>#QAEG$6Yh%h}}J2;e%j(X&$%h+d# z?XO=9z(s)N9R<|0`KTj$S5)Y~o2dX^Oa^cw{dF{15eX~JQ_IJK74EsVB>0tup8H$B znJDoxM~0`i>Dh0(-1pVIUr5$M9;jI$d;dw;ktD&4@=Pqg-Pc#lAUxEo`yj%%3(QLF z@N>`cbx$mqA_Mi=_wwh2UxCOz0^-?rbh^|@NVMZlNUik}{Wj6a@YyI3mVc_gzdJ|y z;PUo}8*E>tmADCSo@b_`CYK{=TV?>y}!UuE1|wp zrp{8b92)IPYTRNBX}?xDqhy)zqx6#p5o+sF>+i&zmmDxPi-MnpU80MpdRqu_fPZ2+ z%DHYO+R>XvonX#(QKgu)!W!6Y##9yH(BvgG_L~)ONO*hl{+N_CUgqzVI6{R0>?Q>m zId{S>tD)dW`U~D>a}JBfO?#pKG~~w4QzV5vTUH>zr+=9dLQM*>k`(C()?kiN2KY%`nysJM9zR`xhoN0 zol#wn@{C|bIQUmNGrN=)0716&AQJJu{e-9E!4n`ODI5Z<&JglhxIO~|2=(w*N4bSj ze`k07mAM9&J76wBEc3W9ATx2&GD!w_&5jiF2?jr*euQS^9TgWUwsASG0sr2hmUgj>$dgxlcn{)DVwY`G9TGoaK}0tKR`Qs2lhtgCow(RCoLL{=)?jDMtOu4s;_;W(nbvRj2WA zg_DfBIhe$5u!4+3nY#3F4vSQ(2)#np`w%H}2#DY#+sboJ zoIgK%xvw;(+Af=;W$v$fW+Gk7Xq!C_ixAbAxWdc`b`9aYjw=KmaZ!f)#+YWe2rzrz zhrr26?T@No$urVEIr6*4l0lSHwjDK!r;sFe&3rlNc?cBnvSLs9k&KeD;Cg6oWn`uO zQ`XpmI_ES7&$IcF_$gb<*WJ*nWFU(xyQ-T#DX+oxJmOeL9$%PeQEV4Qo|`}SR7RrmjGBMF zRT@#OSiBdOYOv+189H!6WBBnK5)-`@G4+dba#r3S{i=Tedy_~$>$_43)tN917y8pB6gtCj z-EhEDs(u>kq=^X+^oc~EZHlZNgxA|C+>ZxthOdzk=3{|ATJ6suPAcBms;P3Hal|VG zQeJbfMY;-q2kQ)EO1JO>vaj0qrY|exRI|#0tGZnRtAHq1GD&e4%Cbyt)Xfi?tG`N+ z-3?TnlHQNlE~!mKkjQZmb;}P$yeZCS5}U`<;K1W0H0B7rvuj!2a2xq-uvVGU5TeB1 zUqRODyD=hN@yoUhEZrw%-sbys97jkLOhE**2(?VQ;Ac^`jAS~jbI%eQmQabHYvpHp9{b?_2OGMrx>&~!oOT*F19fX3h0~&ZeFZ= zGcUqBn69%k*W6;)*_i}AEKPx2L4KfS@|+zeNk#knK$Q7z&McznlQQ{aKcNNo04L3S z`BY>L6t+=e>A)J>o~T8-jGIK+kwmHOu!mH019+5qGJjmXj3@J^(i3@iLW;q26#^!mQJaWS0lbi}Naz zTl$g46KBI`l8cc`%H(j6x8ma*;8qmj$Nf}p%8po!#NbSme#(9Z`+o;Y2gI5Tq6eZP z2y)xh1;^X`2Zqwm3sJzPqhUihbW|)LAqfuv_AWwa>y4CB^OqHpX^T>!+w4sl+3Gtp zikL$66T+$l9#Z8-EMBGmC|(dE!7~c5&+6PpPA)g$TB;^Ddp}h^??u-gjdKr|%sQ2H zPqADcxA{N*`ZU$>@DvqO4menJ1su1BVrLXMX3DGfRuc1R?jdT$U}NIjUjj5=+qp?k z74}fuVX0QyHC!Cx97vw8X5g&I59z&LD&IdT6Pvx4ZMt$-p15;5x8#yUZ~Nz{5zT&) zroba>88?_r>VqE12L~Swq^!yTz+3rmLxK8Tm7hoR7v3w=u7vBKfb7q=>UUDXR;Px& zj+ibi49H87`8qv_0eOAYQ_vJB{LW8gMuXXb0!=)J40g5lcbmT=m6S?tiHIlOzC~Xg zI;(m~rv*u;KI`FI!*$){4{r*C23C&Wwbi*ti@s+>E*^WjLh-)WsX3vSz}Oc0Ph3KM z8&=7i5W!H$W-#3?33FH^J&8=uj2C>z`8ge_{OY!xqEK%Z?2tW!7NMNu zk7%E`Hb#^NIh_*#dsyk^9loM5^r=$6AiV?9zVEEQ?;AJ)K+CCA)4gA&O5+?YAgy#3 zPBC8VtJL7^N2ec6U!~T2D`e|%f=rc-+Qzu@ZEw44=ZGPsvM#Z3DI>=1q>zIin?h~V zRSub+hbJqOaiDYNt8gRAsqhugKlW{zt(2Sf9_=wL9zD`4pS2E#Jcyw8B&<6hys=f- z(v@R|uyhnir&|jcw!2N6QEM6VjbZecXOc5^GFm$(At(g9t*?>xyjx2 zzE9c{Mb2BtrFRY&Nhe&^J_`Yh6c!`Eo9I;oWLw0Ac@ZBN-+GM( zKdBRrib((pF&^^=KSQy0M?joR+$6(3fb?Krg{2Y13+V*Sv5;lis=K-rg?erMq@k$G zOg~y*-S{&TnC^X%B~xZ4(8~eU1S&|?KOfw)IuL75bD;HeGMFzSZSyITR3**DfLj_* zNV8%>`&~FU7u;jx7+_}sYa(X)QmukH`AqH+D?s0Fd3-3Q!>k<}SGd2Ui$2x^7G!74 znv8*6whs=#ai3Iq8e1B_SL}S=#e!<4Io<=O3ieL_v;8)7JPEAkcL?u<(nm&bt;4u((D>a}~h zw*rpHu*qS~+-FT_g{X7AX zVgGvjX)F>ct=;++q^se)a|{!QQq(>qUATp{V%|w60aqCpGH4 zTjD-DZ?Z?ozPgkvCN10kD&)!C4poec@QE1%C+UkqNeVJqy#Y-VBG^?xMKVjLI7l`9 z;q@dZPuAGhsp@v(LySDYYf)DP3Bl&=;1r-FbZc=BQ1e9xUR(76SeeNv7H~2kNDZFm3AV0ZKIh!blU$Fe?9p z(%M>+nHzDB#pQVJNnuenYk2+na&n80y;1vj3#4by92+JDvxPz8?7u>IFF2by(*Rv; zD=AMlzDzfGqNR@ZOM0pEv}w3$fg;2d;>e#U+^E?OoMQrAa09H36q^nrv~5qI@{5^) z>H)`TLyaUXR)m`IY=5s;VT^vv8z{u76D5`c!4Qj4xfD=V=l2lE4SBhS^qvb!N5`eK zxy;S~d<%#on9?%!MolUAu-e_ri{#%0<9_|a51a~M@$X=%kFw$O!Lc#f33mWM3hGoI z0*=KePiS!m7l7;OZ+O&`@5a6oU%Fr9Dc^(AlOD2()A$kzP{+bq;WnINyWD!&2D3k7 zo33`A`n#ns*2bFSkN~jabT&Kc!vqe02WC|z((#c{uHAdjABpL+e%<{!D#J?(?gWCO zMT!GPhaqE}3l!R_HG9Gld@m&qPyF3}!h}UxnZuExOEWQ!(xa1)zh2*lQ#FWHIfD;h zZ|O^ZX>Xuxs7K7Q_?#E1CTAy$a^?r?bX?%xVSZI^6fJqEYm&OXb@w3`lQ$Ez%67ci zzkD8N)X)yJ!9Dl9V#dd_QR*(;o*r-Q)E^(m$Y z0+Wj{H%bNwgCBH|+b^V09z83L5o?-Zjmwk8mb)7?Uzf1`O1QXPety^NdEg_0QBMu- z+LUaHfey*Uh|ucyZdd-7{VP$lMoraW?unPghYWI2t#(Ugq2G4Ejq#o}Wiq=C6BwOw`%!h?d%2(?1l9Z!7$Av;6lA8njFvrIZ zM1$oy)GKU8ilDbT=$M`y;JPxqgO#-L9goXB_pi^u`V>T`_u{@Wls^KdvhgL~p53Ye z%cFWJdU}!z;|G8ZrHbR#gnLn)`gO6ux@bFd$cf?nW0a5Cun4}j6U*num#??k-JW?) zE%5c3L*R2;U)zl`?KYcHfKYzN_4ps5eBmS4?&5J<0EEfA%Hmz%^!b}q>Z>PdeFg<7$dg=nL;@=Eg>8d)L@tjUDu+=M$imKoGnrwI9&32Jn zWdruYmT~@Sw!^dX!|d_55B(Nup=`#sG4D2a_Bld^`;42X3RB&`eu?fs82frr1 zDn}!Fd1kVrn46C;HV!0sF_iLV7O+>>Frc5ZgD!b%#82wtnhF5dm9kk@h&_kAx!kZ- zNwaR!wg!50+~L=_Mdf6wJIIZTe-8;!WvP>J<5J&AGj-$A>j8BpE0Wt11ZtvB7A68~ z$ac$vpM6?(n*zbCxHlTE+BcDGK@Xs0i9e%+4{QhXXBQUyEUUF(TXNJTb~{ zT#>JYMpOEa23n;1M|+s-v&CfE4*CXA%0!Xx}aDvrp*$_ z6e+?`-RIw4EOyA{gk-OUxg)y9AO!Z4gCQkdHQw&581{5+$K)fRZKAeUS!DOCdp@i( z>vkbW({y?uz*mbSkcqSKI!fykX>HuLR=OjQ1&xXbzrSkt79jlcV5NojF6E z1K^4c<{Fw9a0=CcxoK`b7zgR+~!%Jf`ZVIQ75^0Iltr4Mc7sX^`zp>K;v=TyU|D#FJcGR|@p2bwJ%v zajLx7p#8sS&zB&XCrI6NH-CJMOzCikpOT65lYXP>j?H=p`OanKWXNaq9t!u@L_q`0 zo@l*3pHr(9Zx7g`7OgPh zXw!!_ARg6sop#28n}O6lwF^|Nb+tTafZ8IZ_MLD*u$HU4-U?Q8^pm^Rbs!_(J=P%* zlOLPmYhekRQ)XzQyi51htIeRq@5 z-K;9^z71U*Kw_?9w4XDv)8{O_jOpItGX;8;ydu5)!19=pdUG~iZ%Ae=^;tQ(cyp%m@in$ypaX6{IQGtC)^wT_oia{FHI-_&9| zQJJ<=&~W+6WOv^2yLQy+=7x~O?t>Q1jWD|e1K4bpsp-^9Las`=8Nv>{jB}T9H8d>F zV0bgp+kX&2`jS_*)zKp4={?irpmTX(?cIhZf8oK{Y4w)Ay#Jen#VwF%?#> zv%k5f%kJf&lr(MkG{b`H^`3&7W_bdu;0#t@G`>m=6%HwleF`d=i)`@$f8W%xWLWM% zH9wUUEs88nmev}uNa170EEqk&sX(zTf$0o+90~xZ*#@3qR(DOPZ=VTJ3bCUEc0@ZP z#s;0?IYv-WdK21N2Y!}v+ask-yEVPvTlgY)NiZOZ8ld^TViJFfTe zJL(|Y)7CAr6{9|9pz=sjfH6D}DAL_}S14$}iyOny)k{6ndeEK>q61}Uieg%E0Hkw} z-`91u<%lPB5lw}_Pe7Q4%HBj%Lc2+maDMtGgWz*{B_B>Ql{Vx)q1eju+eQg|l1xl; zBu=}fHqN1CfXVjog3qf;JdT&o?tNU&N%0i=g+tq)t8yk0?>ve9RSt4|(1Ywa3J9)y zCT>*^jX6CTRy*0U)FQ#|&&B6LbY@qh+STFLgCUOg3r5QtTH;4|V46}{i53N)slnP* zaf4W*lbBq_(%3>l5q$L?liy?^X5?*AQgd!%Z#!O9>{hky=GKrMmZv`q83+r_(ws5i zb-OoLhFulMk>CKLP>hXFp6&wb;g_-cQyS6Y#XNqB43?%GZXOTQ8^4K$Tap0`Z@>bz zQ(y*V_WtjnPCxyB24!TOUp58wU(*0BgCsrHpaq*w{)&5$#lEZyk1e#vL7lK0FOFu; zuqv-IhMfBohMao@L(cuS{$8N&JATk6vyf}CMBV6#Et;LpW~!F}YKO*mPn9xB|jESkD^D2S$OT2^eHIA`!3KyYi}UhDs|DEGZ8g&_v-}$5dfpI&+8E0h9CRPv<>C=yMj(J2 z!_ozF<6zTC->rxv3PWajuR;Io5{6i1q5zoS$C-DI6h=1Pg*~7 zYCRZf136@IL>Wu=2luSjZ1Iv~4%K4{tajpMy+yo0atF@40Z^ZEci~f+%|iGvJz-=J z@H|8Ward|BkLSwBCe}l~V~Dqc{Tx&zRYfv>o8o=nR0}}W9kqU8%S-2I=h$kjqmTEp zM(b{Pz-fTd-M~%X#d0?(ZYy6hi%H4K-=_xV0vu#&EaJ)STWOr6>w4FH_A$+};+)c3 z@rt_g84RI;iOv8_DfKERp@rONItO617EWilka~U=GNNiD+!JLEdp<_m=s6S_S3Lz)3G0EQ>7o{1aO!cbMu~$t7_V`3L5zBDz&CXv)}r_SG@s0o_k}SKxQ6>$I}ctlTj)KraPJ$J8&gf>zaq>%N)5 zn^Ij|9v{h9IVDB*KOYnjVs+4t0c~=7hLF7a!Qn`{G7Ve|4jvDSDf;GOfIA1980bap z+i$H;7BF+AYy80Mq{Li`U4QM4fLne5sRxDxJ1+aXO1I_!CCSG#;K7g9T^Qq=3vk$e z@cNEDS^DC%#D?d3$ik6+YOaRz&w|UYKZ6--v4mBtQGN&iZtgYrL~+XfUtcF?TELsPQ>Oq4@IiAbF>SBTZ#yWT@JGOh0t{Mp z-*>Z?o|wdo%BOJ(WInhCvakXiiI$`ye?JrtOPt7QV}u__uhLioJoG}G0oSyPet(QV zoXqZGz`kBFd2#jE#3uksBkU$|pds${%me)%(vI1bbWbd*&R0aV|Dl6>EPE_B$+`&r zsAcI6Z?Ws>c<7*MnpSi@6j^2ndBpWR@c<%2o3deTKeY*~tQ3EtBA~xMTurn7FLRFY zhnvfuV9>I!Bs}J}@JBO|YpPLJq87m~H(|t~fp5FM3>~jBk>M7H_yH6God>J^3TB$P z5lZeUW}_R5y@tKgQ8x|Jy1}5u8@sX|vWNROq#UIjff4fr+$4UMbQ7^nS%jHQQp=5w z3P@!)jn&!XNI0384p<{0|KH?eKHMZ$Y5D@T4Ewvf zKTJPRdFbXSn`tgEz=Zb?h%kGE78lPV90Ar(Q$K|N;kaI?UvFfww9G%4sf9hmYy~yb z8_gUlTyrU?&k$j7I34QoeH%Qi$e^2@u$HMFWh{W$I&I%{9Q<#wI0e5n@(Mj7Prt4^ z%hGPs{>T;-?x@$dept~eObyV~xMP~A8L`SACod_I!$37)m%pc$7uX^y;?IP+p73D2 z+OI;gAAt(9uyBs&(blgdR3N6|7chCOxE~w%uTqv2O^}I(_a^^QCb8n+ihy}>A@VP= zF}@KV7BdzIQ1X~^nX+$t6DWH>zv1#!7{t&Q6XD6dS|O<&=(pVV1K>s=1wtowp=bqm zp+df*avSz>#p_Se0@h9&CxBBy^BUI-(z*WKv5}1s`kgFge zy8sU>#zqpFd^j0jewSR6)RuX>llnjJzlB9#dKXt+Ugvrgm`P1nJ9l!=l|QQhdN*gF zm2<(upqejiympAzL$3b4!M$8utgg1M&i-ejh<6WsRc|LS{o4)CIB`YZzr6D~u<#ne zND9!uf_thDMhq(OotxjV!E+tBJGS#%w}&4#MGE%$5D8xC%R`sVy8^&Pxs5CT04;}XpZ&dwK9(xQ z^u#v)C0|~meS>^k{}T&#lITsaCp?oe;QsdL+L*8s4dG$Yx6>1&0!#i)O<(B8FWJT4 zKRy&u`3u?{v)8YEO%8jedHMIqz6-s%{IWBElGxOg*<3oIfY0+k@XC4_D9(prqOJx&#q15xOsQo`_D`P&CcN zeKf%J&Y<6aSMeQCUU-89c}2R%p2RkJ(R0Rpv;*jE>*3zlTxYT=LSJqc?A_@6NSXH6 zptgN*=h15iKzj*9BSh)YifPf9r}tE+p9d#xaa=nR)xx+RN!UU@vOo*WI?p>KRg4Ye zZzF8z$3?DpyAvy}$QaY3vHu*sWufmQ`qovEVl$7to{Mqtz_gmc^SKhZL%|HTJSGsf z_rSXV7?)l0RjIzAC11V=yGGq!)G%8%jUVDZel{2!Sx$06?;VCn^b zO$LT5QJRvMSSUcV7mUVKd-FHqy>DX|n%>utl>}5yHK> zq8&8w$dWP8Z))ALzl!~F^mjYQ2xxdW#O3ozxO>D&gnQ&kr2Erd;OpP#+!Xv0GIWCk zq7oF!dA;soZ*DY)7aj&8wsBJ9!|^y8n{O1}B6_&TE{OGXa!N&m{&r-5;4=fFkFFeh zclJp3NcYJ0$oDArDEHz4l3SKynZIV_J<;k-(POMQd%c#*A;;kwOqt)F=zDShgmocP z#3P5u7z&(>sLx!KlDBwhJ>xJWF_aD|x{b7IcikwnEr|mC3Znf`M~S9~Q6*)rv&*-V z8EgvP%)GgL!|X?CV%Y!73L$Qvlrh_c5r`2H!rgzLd^{HhV08W&#DBiXf4!8o0CcWo zkn1DyZxjFTmmI;Eb(Fra&No%HznAa-^^YTA0G*ZzBXGZByu|D2{_ht}W7c7a2|hzC z=aA!|5_El85$Hpx)cxxq`RaW zhVB|rT97W4?nYt=$)UURJiPBd`>b`&T4%58V)%3Bd4754=d1AFe@}ql8%l_iCTGg? z2^Q8j|J|_Ws>K6#l>-PUW0QV@X|06l~8397HFtI;j zla%b)|MwgI*Vls0{%7w7*JV&)sNEO4tk-X>{W-i~gU8p@FV~Os%a=+3^HdKQI-@YaezpM` zu2!{ncXr@5le%HzxTE9qIw;k`%7PL$uB0|Z5W?*QR#o39zp_C9xKKJ>jr z-usxfeO!%o0H0@K2j~a4iIzD1?6F&K!S1owT#K~G@|p$s7+a@E+n?&E3qC%RKP=Q- zexc(89OlvAbh9M*oCo`SenxelK>y!+_>VCI)M6=lLu*}UUAMp`$3G`LCoaW1s4QqO zXgBClFqehvKpDX@AnSO8~yy09W}{P z#UuFw(U%q?Uxs;59dv}2tFto`gEbytm5vy- z4Mh8o>vUL<*Vqu{sV+OoZ|mR)c9e3Ic5FNEl5>RI4qdD#j-bMKt=dUN3n34tkwA>v zG@C;#A5W=WV~q!l(J>&rAYMn4#v`o89Ph_&6~OmPo0S}GHcf+uA!J(=)>u&a6_tzn zH%9!=DU=b2?kMLd@2KDiaqMCL9Z(iJh{y5xM4yS~5$$6Gt$;6|Y)!JQc!mXNN7_M$ z><*O1)r4=i8ANh99^+on-|h!5ZpFG$lXwSN^L?RTv_XA*{{BCome~@N;9A)(*-2TH zzzvxitK;Z;m!jiaN9|HdHfsF<&3{2=B8On^44yuCX-R>}Mb!DGf40!#z$Bx7EXk&w z%knAv!-ltE1^?;T1akn|0=fRV;i+AuqR$$N+@9sM<@V){_146~m;0niOz9w%qQo;z$ih_7JN;l1L9Pv*N-3arp)KxtpS8kk66RPC!^rcVyT^ zIU7oGS*BN*;;0^B5>EbACdGBHsEmAl1m?rQqcB|>WsC_?un>&=hWsq?7-NDn@b&+* zmVw=utx1qwoclv}Ue)oPQoV1~bE5oDNU=&6>fH-reSbMn4>iYY$|=jd$V0|Yp3S@% zp`5_rJ!^MrA%FFsA8W83P4v^7uYyD@((}V!a?kz|ix9_d@Wd314SCrM!q(w(+A6Jm zBuirR8`ym=`(P$JMy}Qjj%z1dj;#NDmhN<*0k6erc)H$@n2AoSQ{2>}N|7?2&pVt? zodm^@;*Q{{?_o__Ibw({Azu6leTaPi-KjZV@}DQ7qQInl7ZALEk{LssxYS9Uw;z~g zUPEq<6UamQ{6!xvx5sux@auciD>B&cys_WbV{&?i#@GSl$baB*KXpHSKXX5u{Jdkq zr|gUxO9I$e&Va@ovOXa=3`F1vC2;JKw`z@{&}8NPJ}A1i(i}s)+a42_O#GnyIqt>a z8y?5KPC?I;?c;4gC6Myh_qM4v+*yYqiMGiLpnY4|vlKw6%2s>otKUDs{e}ALx>elY zh4|>vyi~tTze2xKV&AvSBasF!QEr$NPR&1j;Bkr+hDJbzM-%vq9KmA5;P^p#AK3(& zY>X1rALT-Ew>avwTtu1GmJxP<|LCV{jAn)xjYc5wmb>-yb2(C4*S~(d+5V3nuKx8W za(;Dt5G^CJ5+gIK=6y)!vYrzhbU2oEJO1usddPdNgvNQwgv;>JtLx8Sb9sTFAU)=R zOWMNe?vH8_ztVq)2nd;%Ptmk_zK+N?%`|N>oi_zc_TsK!Rmk(ctN_*iCZ%1F<9iak z%DF&4E`L9+F=7=0rdYmk^tXjz2vY<}I_^iZ^lBd6H^C7`|4f=FFlqYzTb>)yaq{xy zCgUcvCi^A?tWPgAm}8H4aP#CDu}!Ly?Ya}M+Ld_yHM&-J03a!hpnc(en!5Z`=YXrvoDZ5eH}x^Kmdg+BRZp;a+;MRj#X+hxCK15n zWy|$2MTimzMMx3|wkq>vpH5q3c_xS2PYW1wQA_Yk{E+|U8#u-XI2AfAOl!<*ENfra zJv**D#5+Bouq7s+CErC{TSZ4mv(>yIDxl93%aaLLj-dr)tDa$to~)&!$uhiug1I7d zj}--|zt2L5)?Dvi?@bJ$rlm5_mHqO`%_Mt_ zXV^;kPdGOzu(B9T{sMO;H7+yOi!US{CA#RvTa{*r&39Yx@G%X@Fg-a?&zrnb*!lyA zNw2;{#|AETBsmSn@n#yB=>s9HmK2^}o}EqiZ+VxD15;fQKVmO>8^vog9=xkeyFRMe z%Bg24tN9i9O`G(0q*BI1LTiAD((I`TYbo2W4q{O&eq7X0W=)mg&gBl^t%ZPuW=w7; z`3i|Vk%Jfi)2Pkx5Mp4>um_REwTr^dc+W8xwyYK*89qZEth8Izp- zgtTeaBlRQADnyfSg;IFbg$c$>O`Crmir#Au-3!k$Oocp9fILfA>9oyPgab)1An@Md zyDA;#&R8*Ya7y{Q;caIfaEqEh#_Z4P&x<+K*aJmrKRb$0uCyL$21JNDDX=%A{2CU( z+?BZb{ieo0288fiW6o_`YAl^<1_iO7YbiUnWG3;%zzAY+6JzlD0%a?8T5=s;6nAD_ zaxUF-XMr+=HDG6~Y4>HcS16L%<(cto>kYCveg;mgqd>m~)9kW@tp`s+qYS61I~5<(~P56FQY8}zk_ zb@A}|{%bv}dC=$f>O^S_1ASnxd6{I}P=3?vaJQ3V0=9SwRmIIIvJo&|83TU2o2`lH z?&M`UDLF0)@Y@CyC02YfAK_y6Bvz!s%(RD$fUcEq+}Oz$cur>XfyAbC zLYnNQ$~B&d^}i)61uMwP6FJZXA*NID%O9XGzn&?>nos`xz6xQ1UgUn^QF@N%Wau2J zE#V>IVUm5s>pSv=*PldY{!uGuyn16xXI_Lu+5 zjzU3hT%S-JjFn*g0j5*o8}5=O;8gch5t;_!mH{Oz&8Cam*36_B__fAZ`+)iFACqSV z;ISO42C!;iBAs_3yeR#$Mcr8A4BM$cR1`&OLx2a{2~L;QlmtDkWo52@{Nz6W;Jd0) zl&D-;Pc!$#E!c*O>0Vw^-GN}dNxJ#l{WanTgf6)Qs-%AHKkmTNQJ{j&QZt2^`&Vna ze+w5aY-GO5^X$;b>A;MBKc)%(Ev^rBwvkMY79y|_>w<6Gi=#A&sFcV15x-z;Gr=Gmc ztiw4gauke=qQsfYJMFCQd}EgSfIx>mAn-@1>_<=Ls`*Ow6MW`Y@C^V6jT^8@oNY?TFuj=}54h_{fE--dEM;hzXVVgKgu`>i7n+c1TdHvp*O zl7HW|*XzHA4YJJWTHQIe{FC-thX65BlVlpe@?!k-g?nzIzhb8zyA`Kiif>vGk|%)D z{h}MI$ajhK*D!c~?Z`sFqeiyY*)(uHAf732lRd^aX)h`20oT?P@%kBGntj)k*w2oA z{FndouUt_+fz%5&o%=vCLpx+Wcne15_qIo5!jJ^SONO&Qo<9xv7>@f8xKzK9WA=}YB+NoO zGu}F9=kXKSOE!4S-ah}j*EKY0YlqtkRy5Pa%uiwg(BUjPK(;qGkejypv^{6O%1|mj zm`!7RjJ@=;iU*yOL$uSGvbo zkYc282Dksc6iCBE?Bw#4=bT2QM{ZR0eo=!>(T1rj32zh^hKdLg-hH>+|E9&B8J9SD z*YLbn{0=~VT0T!{M+vmP7!V;AvI=mvU}=yi{;G1WVl;aE4i)lG@0zw-e3&ZT$%?gz5 zImtTf7xVP=fBwdtV`=7gut;|*5bHJ4EA!_61pviOvn7)MRJW>GnEJXQ*KF60s_4!& zyd*N87sj`6Bf0fzvNByZQ5l!AB+m}#0XHZNFYz8HUUCa=5;S@_%6g+@2FmXVHm8GF zZ5E?MtR&(;?v!c`Nfz3~K5YdroBGxVJ@#UU9zE(x`N4^ZTsRR3;j!=D&8~2=5M`+%4nV~9Vau;YQ^Fs^Aud4b< zV!s-|1;yNY+L~BX3h+mAR90sUlqv^yOJU1Y*Y3{l&iB7WEK3r2vo5iZSg9)=eLKX% zZ7w6ijUZE#oHm&G8BM(;5f!9X_s4+Ws)YJ6TkMAt##q*&%tiJXNQ}amR|>CBR2r{s zR9dxhS(>1a%Hq_%2J;-Z+N)+zjx4np->WwwA~|>AuJ?zi0C3(1W!GxWE)|l0V}=4M z_53JC>fzOaKO6;nNPt^z@PdHcIQuX7HgMF~>QjK=dx;uIto%*jZE+%XmmU9hzuWVjD0WvxQ{=K zOtC6KNE>Nnz}9xZJ47)t`MTu%P7Cad zkp?$tJM+Hncjd7~_!CLKBo;qmQiWjYMaYVF2B#UguI88BtuMNfTCJZ8&O-vKR@Pxf$2#RAfHFpq7+5v zpJIRA<;azxw3H;^iI$n-FPC{F_p0Ve+=E0mB3e2F^bER2R_MYIyg9F>x261lr9ct7 zL5Fg355ig2%%;@?hR|_nVqBtO(Tlo+alz$m1|0FF`bJjP^|G@XCPrnFH?JBIzM0LL zUip;lAH?^osbu_T!IZQoJkRi|*%OI2%(K9aLm|ZmcZrKOf2$`~LJvFxsR=E@f`(FPt(n;Qi zfL~S%zX|7N&KGyp`BN1O0g;UZ*m#Q9*y|26T0$kNFu7;f^S;B?#=G_!=b3n;}qaZ5qT+1K_ijBoKQb#y< zlg*+y_EmGaPafWEeU$$;!)z)`Y3WHI>%cPo&<0xh%behnqmbi86XBd89drq+9q&zq zUl=!WA>2fhC7fF)9Wn!C$uTbcu3m-J;N^d;$%k7nSBx3Li&BLqE~zfndzXuv=?toE z$~VbUfI?Xz?4?fsrvx~3uEq??_tELxO!x$4d;kOlhjh{GxS#wSHEvr|1Gz;b z(uGF_8LM`}7X9`27%^ub%iuIfmda{I0VH!P^LgqX>6y-|gZr0V#YLpp1R3>2^7X|j z@V^^?)!gmiuZ(VA9Q_Gsyciaip8E&FZb{GQQZh70u127mRh6o@Og%MWtUI}0FHD8~ z>4ET?8!pqD*QNT4DngOyM?+5AdB|`GDO-%3SZ#*a6U!M9U#35)={n(L(78qzB8-QN z<8;wfvsOxY9~}l@*m;R9@teicvsB2>w%8FxL<9c6>khsHL3%8+CAL==PzF!M0lA6m zy{=cccIbEx_cwGnAOw-m7F%{W4{-&pw$23M3?U5tuNsta&hTYN6WXu=WaI5*$$|XC z`dD3=8F>{;LaQUU*ca)r(PJyd2trc4O5CLoK95YJW=>6p1dQJ+Ln*rs>?FJLx1b~C zFA&q!+C)1uQi-^AJwdZvYgyTU>=iS#!!$R#n{>CVt0ds4UA%aOAZut20oh?JVLj^v zcTj}9w6b54<<>yD0R39AF}7DbwM50z44yMGr|}Q1tUG1L^GU;MgJa0hhsCjcGxIaw zbMg=i(&5^D2O(W&d2A;~>lXW5X5)g>At(d4(5)SbsIs~bpBdmUUX4C(!)d_B(cj>D zIzDOO>=XqF3$E^PV18%6;|kGZh}D&di4afSl2B@OD)_%y0MWS}QPer@f-4HCNoR_O z7jW?ufq^*nHeGp9-0!YF>t>u?%1)ui_xGT?vG2v)n%kNezEzFeD=s78<>)Ut8k#u~ zZEowgmBBMJGE_v73K-Y|?0EjUJu>F+=ztbjtNZ9J*Y|*r(;tcKe#fu5aA*_yf(UIw1FA2sA)F+(0Jfisw{`R z#W9<88e&XdpMWhh;*hKt31Olqy$Y}-IgJt6d+YIn1F;h@rfQeu+WOC42YCMmqKGW9 z@`Y750ArdhxvL2P{^<(|W69rI_pK^WiFik_!8_|mK+~revC=xo6yp7Q!`o6qy#_?506_qSfPiVt~qc$yr&x)R^|mj2!A z@E7mTDO)6<=hU1g=uz8y`;Z-|KI*QHaOGqnf#T+WY^zXoV>VGwBQBmi1#)%{V+AS> z_&lOafF=Y`0aSc-vth=&TFMW>Jmk-jCDx|rrhIYY{%FLV@gq;zBZ=c-3`{P%4`1K` zraJf~V7eUR+vBgVI6aIAUJ^9uuKie|Rpjej_F5AGf0yejF}!L*+R=ZQI%Oeh zI`;;q9yj`U#4X4;vsN=gHOeRX&AoGc$U}5$nuLw(re~;j)EJun{Rc;bsQ2t&~ztAJi(A^K9*VzSF!d9uf$Wc{$)^^<3Ui5YR4=q0HURuQxiTiEnoI zP>}i}yZ5g6=4Hz3@+(lau(xfdOvP1g()ZLcR%>IV!|t&?8mBF8Ep` zzlXtJcft)67p*A6UaVu`nW|{xP`-5tD2tvWpr)D>su7J?4}&qAhSucClG4e=NV$R* z-k2EZ#G7776bAqpB>w27X%Mjh9u zRummmMJyo>R9X{g+dgkYa*N@TBlOl5oHhL!3A3+?QBTsAKOPW#6iKQ=T`+{F=oN2} z(c3YID9!yO>58#vbCpH;oNj#GU>M=N#J!8&dcp)0_ApL|P{m;pSgMm^%eAM3{1C@p zk|hm#Vg%0n!oDMkZNQsjU~5aWD`DOp19Z?#Rd@?#kL1mH+L}}5wC|m|v&2&qUFv?K zfk({SpJ-kBKw<=Xy_!QouU(5YFm|ZoyA>g{oh_Qo1G|ssmL6+u)H!&2>_s2ysYQ${ z*+tdX8=i$qG9#lG(opK#w?K6%AS+`p|GGki!#lnFLa3%jVi!Rs9y(r27%S_Fe5Y-& zG}!V?5mb5rEOA(*!srASaQae@E#(53E-!DyY#8jdw2rQ0wa_6$!VzRCUC<5wAwaad zRyKpIKo##Iwx1b~$*Q%#aCh7&^X>3ZRVKj!uhLbT#hbz6)=qINy}i@?9fjj2P!p(H zVh2EjZAc%64cJ+A)sMRw_(7OJ#i`NiBi;v64-MGECfB{0qZl1UC6Yt>GEe!L~Dh>SnpuG2g7aF?~E} z@EG#Nv;A+_Apg#^ntSlz?%Z?WTxJd(7P4o`aC=`4r-Kqh6PY-*6h<#elXkmmeSY-cB2#=lA-N)hCja=f8{%*bm1~|F+LjZ4@D1DA$svdA91q zP8(1r1*%xJjx><@HoZOl;|MgyD>)f_Q*MYft%q+yiw!=%#m&Si$yTW=~LOPPe?K-w76#ReY{=;XVNF?r4SG@ z(Nc`!PoiFZr20#}>PT~>D@cRQDQ?)~VSU_(A%Yy3D=0Eeayr9vrtpD-JZ~O<4{_;= zPK8S}ibAbKg*t2?w4a)CCSkTQ6U92vNLg=Onc6z5J#;FhG}n(l5n+3sil}e-(Z+6N zrrG#Q(p4sLM(kJO0u8r(tESPYgY7sk;#EJjh6wmBtjEXk(Q(Q8og65Xp7>SFeIXF3 z6`W*LmRn`<%2*a2NW_?2)U)a@41s5_B~Q>kHm#mlu*=}LP|bvhZhp%p8&1upPaY7HCIh6qEwTg6XcE5aaX~n?hoR(Y zK^k5L)V{0S!S@6{UYQ`J8n25Obih@)WeyJ7uVI{AdkdrHb#}zH#V@`;&Y#RD4#llF zP%T=So0DcjVM>G4Rw_Ek{_h`=vOh1Wok;k)!am1nOHBu*^NDum+2G6fcrHec6Y9^X0AL8~dhg7lfbiXC0B#7-O2 zdF9jegg=tHikq*tpL{EpnZX;>eOM@*6J{@K0Gx z)Me8{U-p>+W+9_7vCstN_m0+?BF6kMyf)3QgX0tdE6w>W%WFVDrJFgLzz9}Wzm|G^ zkiu_)Z5yNMG_mP(ECCfMZ0}=H(L3i$K)kdg_(GV^vvGIA0RN>r+T0rp0Y=zdlS4n% z6lnC94dhUDjz)0GDqib)kL@Ckmb)lXh%H`nr8#=FOjATKhxdU;HOi&JqdLjButue$ zQ-ae^d%NXilWoso)M57pQ%{6z_b{TqVASlOex*Av+8IUEG-^Q32RX$xgerS&UmHgT6bsc-(#y!~s^{V13}TR%f}euFbirMSH>)5C8n`xn{!*D(ToR z(1nk)UMnJ`DCw)7MMRF*wdt*bS~kyo#|mQu87ezGS(1qfdhL7uZxQ7Dw?Ek*n<|3< z+*Uv^Rx2xAfu{0Hxo8Szm2dp+h7xDoE$2((Cg%0l0;T-G(vcXb1l>G*$Wqeb)UZYQ2_1v5A zXT1;AHHC-dxQ6wYuZCDkqsav#tV|nwn#~j=73QkE%fBPas^s5}dYX5^3BJb-iVqm@ ztQY-_jmNj$LJe*^go>S1;?G(o8Lbamo+vNBB4zO4ea5s1pO5O3KM$lZ- z=7F$Y2cfjp8jTvmMJq49RT@jnUW%;Sc9w!2zflU4na6@H)Q|4Da}8V z<}DY)cd9<%u2FI4>L>gl{-m)iFRCk)Yi%j2p?3GR#Ps;nOaZG*ZTO4wc&sn|5q;)s zy#ier#T7e=){Hz zW}@L1n6}nZX+C>~_I$c4o1WKHR)f!Kw$6@`LXO3$2Bm*#_(@+mx%R7fqfi-7P6&yv z`5m|Xo6ngUuZuY!8Z}8=mj#H2`z+R6@_d8O;EkA}WNX<~p(qNmx7#hN-RY+D>Jf4k z9v#tX7SO7jZL?3EL$D!R5@=(UwYXc>@=(Y^#%gQ;n|`S{7(PG8&)wJ^2N7Y~V9H|K zFwLUIvqg+~UcBGKmvPnGhir}kQV~OOjyXiOK=9yi%Pt=v=m11aYJzGFGR_pkf@`IY zK>#e7Rf<^U=pqupisuNl1vkYK^+a`%eNupej^vr*ZR)s}EtCo8AwZ=4m=3yZ@H0o7 zLVQe-aMJWhyen=kL9sb=bo}?VrTlwG{8+6buaUdQ#s149N4ZyaZSQ9!7*zo zysG_nO=RSqDGM}R>*Ws?XGm@e&m<^uI$0%?w3Z^@eCq#=c|=P2A}|dhNhL*UtDQgZ z0^P&!g73cDsnCrusXkj1-G?pr>o}Ce+x+?=MNSdZd5AlcZZ^DjO*#Cp9_b_b$2UsR*2J~79*7fgJr=a-uFgATwBeLIegT?0 zHH4adRgM6du&uNGVtB3WhUfHwD>Ex{0KV-}U!*LA+QcznOv<=g`LL(iO9#1L7&qGu zU7r1ZkT(}A`PJ~axj26$^fyIm+KnQC^BOkpsw?ev6xAkWO~?G+x*PPcJBr1Ch!;HP ztm;XNpgpXi4{R2(? ztHW2iqwc$MTWXg)GHH3JDwm%UW>fPX4$T8M@>KuKR&wrg8W$^5VVwaeO~Z`rw=Xs` zA0<=2Z1Q7c;Eu^*VAxmsXRa*S@H!O^H<9qh zXT~f-YIG`|nQipXkQ;j+yI)60V-yI!uB};!c-4WM;l31F?r7)V-8s?nm*pg9YD$`m zCBtZ&@{Iih!35kU$uV#e;J52!>#OQZD=&`*%MlC5Mk=Y5mnTZ+*qC1|B@fz`LL~J7J22*{eHIX1zu8=+uOWq=SQDkQ0P;y z@kivrT%lLzv6wck_$ro$6m)vZ}`aTm=)yQG4NFH@xB`(Ld&sNNb&3^*J z7cql~%n!hC^9?$yNha5YIK>&jq@B-+P5Q+16R8N02ADY77vHhV7(A*OuwZUWx1jB(Nv-${CGyEKo;ZxF^ zboa4+-3+Jun=pQdBaCNvG!LD7RS%sf(nUA4od)BJL0moC-EFK-tk^w1sW=hI{$MA() zlcPM5PsWbiQ23ZA=6ikp20GIr?akTGJ5DrT0pj;|b`>}vbn%X59GwRHRmJjBdY|hG z*Ykao($9!Gm7U}YtKK%AX6q%pZ59T+Noy5!TGsVI;V5iFJJsdVn3h!Oo^y?y7B0w`bY3pnvrd=ITt#{TEy|oZLPdHSH%`e90=in;vpb`m zI(|1vy-|Y+mozY#7c3u^jhk~C?4b!1Zxhq`N?4eNe1e^KnwjMHKo_aS2#Zi!P8(Kw z$c_7}j1tj`R^VlBXn>g|`Pvs7wGr+76lV{wi}9xIhDMDu=gymbG18UG-W=BfG1t{x z5+`lj6cwXT7|qnLM!l!?k;_t#+Jc%-^YW9TO#RPNO-G`619Z>o6Y0SmB)?kj7-fw4 zx$h$8JMkE;o?mdUM~PE?aBm_k2*xL4-l912cTd?O{(k8&8R!^sMd5%oxtm~t;!v)p zof%Cc8HLtQEARaz&iNPmTje!^hr zaEslSJ!F7meqX;j)i!dq1%VMe<#go5wL&fuKGZoc`4kvoBH9)Wze{_s?-MFKLy7`T6X&t*RYc?VXN3yDU_z~Z@Xx; z#)<=xuKh}P$sp>F4z+6R{v@BL@(WWw!WSqcdum)0jsr~ClyR(;sXE5KCB6wV2NDn} z;kuuFKKb)jtAAkN@q+hN>4JHGgulArFBbGzM7u|*K9s%dMJ}3ZKxb^chqrgjIUum? z)yNKVA~-5)xIg>MN*iiRw>%y|q!+^p38Hutu@_m^Xyy|MJCv?Ia(Io=Hzms4#ebQ@ zVh=boCosV?u9NBh48LTvgd1iu=K6`ZDr0nFW4SAF!3|*0rZ~y+e@JKsTg#WA+ z83txeBLrzPgvcnf&?H`41Hi{ogp?p(P0GVHKjvR~yV$Pem=F{Doiw6dXDI|N5tD%f z_|HHv7h=#4BKAmj#{2k}pI+OALt4K^_j6a`fU2Rn$u(S�I0{p_gb{tsYe_58R0V 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 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalTests/__Snapshots__/AccountButtonSnapshotTests/test_snapshots.2.png b/Tests/Web3ModalTests/__Snapshots__/AccountButtonSnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..74037893fb02f651ac310ee459b0d5df1dda1d53 GIT binary patch literal 194340 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

;UuT`oo)bsgeIw-Wu2vU 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 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalTests/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.2.png b/Tests/Web3ModalTests/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..22cabfd4c111755c608b7a086452c9243682e76e GIT binary patch literal 416642 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 z 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 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/W3MActionEntrySnapshotTests.swift b/Tests/Web3ModalUITests/W3MActionEntrySnapshotTests.swift new file mode 100644 index 000000000..c18456586 --- /dev/null +++ b/Tests/Web3ModalUITests/W3MActionEntrySnapshotTests.swift @@ -0,0 +1,13 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MActionEntrySnapshotTests: XCTestCase { + + func test_snapshots() throws { + let view = W3MActionEntryStylePreviewView() + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .light))) + } +} diff --git a/Tests/Web3ModalUITests/W3MButtonSnapshotTests.swift b/Tests/Web3ModalUITests/W3MButtonSnapshotTests.swift new file mode 100644 index 000000000..a2e82db92 --- /dev/null +++ b/Tests/Web3ModalUITests/W3MButtonSnapshotTests.swift @@ -0,0 +1,13 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MButtonSnapshotTests: XCTestCase { + + func test_snapshots() throws { + let view = W3MButtonStylePreviewView() + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .light))) + } +} diff --git a/Tests/Web3ModalUITests/W3MCardSelectSnapshotTests.swift b/Tests/Web3ModalUITests/W3MCardSelectSnapshotTests.swift new file mode 100644 index 000000000..79530ec91 --- /dev/null +++ b/Tests/Web3ModalUITests/W3MCardSelectSnapshotTests.swift @@ -0,0 +1,13 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MCardSelectSnapshotTests: XCTestCase { + + func test_snapshots() throws { + let view = W3MCardSelectStylePreviewView() + assertSnapshot(matching: view, as: .image(traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(traits: .init(userInterfaceStyle: .light))) + } +} diff --git a/Tests/Web3ModalUITests/W3MChipButtonSnapshotTests.swift b/Tests/Web3ModalUITests/W3MChipButtonSnapshotTests.swift new file mode 100644 index 000000000..3138dac1a --- /dev/null +++ b/Tests/Web3ModalUITests/W3MChipButtonSnapshotTests.swift @@ -0,0 +1,13 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MChipButtonSnapshotTests: XCTestCase { + + func test_snapshots() throws { + let view = W3MChipButtonStylePreviewView() + assertSnapshot(matching: view, as: .image(layout: .fixed(width: 800, height: 800), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .fixed(width: 800, height: 800), traits: .init(userInterfaceStyle: .light))) + } +} diff --git a/Tests/Web3ModalUITests/W3MListItemSnapshotTests.swift b/Tests/Web3ModalUITests/W3MListItemSnapshotTests.swift new file mode 100644 index 000000000..3c47744ad --- /dev/null +++ b/Tests/Web3ModalUITests/W3MListItemSnapshotTests.swift @@ -0,0 +1,26 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MListItemSnapshotTests: XCTestCase { + func test_snapshots() throws { + let view = W3MListItemButtonStylePreviewView() + + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .light))) + + assertSnapshot( + matching: view, + as: .image( + layout: .device(config: .iPhone13), + traits: UITraitCollection( + traitsFrom: [ + .init(userInterfaceStyle: .dark), + .init(preferredContentSizeCategory: .accessibilityExtraExtraLarge) + ] + ) + ) + ) + } +} diff --git a/Tests/Web3ModalUITests/W3MListSelectSnapshotTests.swift b/Tests/Web3ModalUITests/W3MListSelectSnapshotTests.swift new file mode 100644 index 000000000..06c506ea7 --- /dev/null +++ b/Tests/Web3ModalUITests/W3MListSelectSnapshotTests.swift @@ -0,0 +1,25 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MListSelectSnapshotTests: XCTestCase { + func test_snapshots() throws { + let view = W3MListSelectStylePreviewView() + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .device(config: .iPhone13), traits: .init(userInterfaceStyle: .light))) + + assertSnapshot( + matching: view, + as: .image( + layout: .device(config: .iPhone13), + traits: UITraitCollection( + traitsFrom: [ + .init(userInterfaceStyle: .dark), + .init(preferredContentSizeCategory: .accessibilityExtraExtraLarge) + ] + ) + ) + ) + } +} diff --git a/Tests/Web3ModalUITests/W3MTagSnapshotTests.swift b/Tests/Web3ModalUITests/W3MTagSnapshotTests.swift new file mode 100644 index 000000000..37bf4b697 --- /dev/null +++ b/Tests/Web3ModalUITests/W3MTagSnapshotTests.swift @@ -0,0 +1,13 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MTagSnapshotTests: XCTestCase { + + func test_snapshots() throws { + let view = W3MTagPreviewView() + assertSnapshot(matching: view, as: .image(layout: .fixed(width: 150, height: 250), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .fixed(width: 150, height: 250), traits: .init(userInterfaceStyle: .light))) + } +} diff --git a/Tests/Web3ModalUITests/W3MToastSnapshotTests .swift b/Tests/Web3ModalUITests/W3MToastSnapshotTests .swift new file mode 100644 index 000000000..f2155ed09 --- /dev/null +++ b/Tests/Web3ModalUITests/W3MToastSnapshotTests .swift @@ -0,0 +1,13 @@ +import SnapshotTesting +import SwiftUI +@testable import Web3ModalUI +import XCTest + +final class W3MToastSnapshotTests: XCTestCase { + + func test_snapshots() throws { + let view = ToastViewPreviewView() + assertSnapshot(matching: view, as: .image(layout: .fixed(width: 250, height: 250), traits: .init(userInterfaceStyle: .dark))) + assertSnapshot(matching: view, as: .image(layout: .fixed(width: 250, height: 250), traits: .init(userInterfaceStyle: .light))) + } +} diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.1.png b/Tests/Web3ModalUITests/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..b2a8ed1600c975c93971a5e382ed1ea342589142 GIT binary patch literal 89777 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�-}j%{}NI2Gy<$1;kc zP6q}|VrU&MJ8M!lAeSqYxc4tNsi=_xXIchsxGQvKcS^@RsOZ{I>5X0_4the&G(Y>0 zZgV}7_}0{I9j|7m3Au!BKJ`YsBT4o;X_3q$eRwc0gRtNjI3n$N2cbPmd`Y0<9!k3i z;{+tY_GgeR?`C)~A`DmfXnnC~A&cG3AQbQXghcXzrAhT=LQM>6nB&E#UF~fq#y4+m2MNKJgi5HQ!lvga4NY~fuQ)JC>Y_l z^`d3wjO67(RsGm$$9i`HII#Dt;x17(%}u+`1gx{)*onCS@K=F|E>cqur|JI%T5_>ALtN@VhwhOoSZ*z z7LlCR8XgOTshLP|2YdgHn1hzZW+psnH0PDKrXw_S^+4Y*3M?AX4bc0ySBji4z;&O2 zsW`XU9nLQh-+uyxS*|pd$o^*mW#>4(mHY7P69;JSLxM^^|98 zER?!MC@`nV^dsy;RK0n;z72qE%QirgTv;aH2UBvS)Uv(h;-KqPlY) zXw;tP_(Ssq{Psqdxqsf?iJ1(m%Ati|uC;aU&q0?WVGHEtui-nE7jVneDvYz5$TzO# zPnb(KCx~F&tC(+*UThth1f~>V2X%)Vk%TY6kW+AT$LUKEKtC2zdFW5DUR+$i5>!zQ zJqFnd2L#E8(p=AaA6%BfmTgb2`#tGWC}{k?xPL%nUa;?<{In8*2)_Q;C!@@Hw8^RW z84(CFYTt#Q-t=AgKcJ@cZNTrm|19nOV8;96I2Z$*HrMe#KRI4%RjPg=0eto!uxr2> z4KOHC5lv4h7w1Vpz_0JV)(_9o$J!P1eOKqd)-I#Ua-ub8kHNkqdH5^x+x&t;9R}FRtESKRo-cU;$!0lWivu2D|J<&r{TrK~2zAU*YBx~fF>imwP70iJ!6;A4ZyYydyy z?>aM(-2VWlP{jB{3Wp=^e0hjqsX}#4NI3@X|lY$@j-_;L`Et_06ebN3HTZe;!gsQcc7Tz0II!s^!dZA zh)b3ifGJcfjiT?LcLAfr*0c?9Hvt)L(nR*UY0c`N@9i@-vv$y4v7^9XRy$Cwfaf|I zxKtj2_=%k9n(0nxy1-@Y6wOGNa7 zn?f5AiIWmt%UNXw6|#$@!y`PtybW=9p7xX zmn>9Q`>5v}2=hNQp9CYE{z&e{SE;u@zzyayI>*o;HvcQ8SGst_&%K{09g~8JDTS;i z#JrY|u#RM`Thgvhzb}C0WwZG*T+ne`9zx4);!{PNyp1u)FkLr)S zj3)i*7=P9KCXJ^Skf{-vmyC7an~N@9EA%?Zo-ej5wW#Qv)6qy6@(F38jO1kmAG^Hb zO`u7Awqk7+@6nab!;XX?00rO4asP%&)(t1$o}_=(iT)Rs7ZM+P@t8w$^UMhYg?3;> zo|w2~GsByJPEbkEq0mqbgi4P69Z`2N$!hF2Ys@>&ACwdLNTofewudu9;gOEKs91z~ z`E}QCqt`Dv1>iP4V6^i|e#nE^QB7s_K#Mj`O`luF*=AcJ6RH`dw~obEF@jZg^4_67 zEo={`w}(fe_ujLU*R}EhJ|Sa>syoJi3cE+#PnjqW&;J5YKtTttXDkTKrWF~8`BCV@zfMvKk% z{3FP8Ss@IyxwN72QQE7Wk3GMvw8k`CrM5KGRE_G81QjhhE*W`+atOI#ndbGXcniZ` zi*O=#He9Ya_FWJR?9R^lO&#D-CnG>F&X$Y8)M6`1eODf#tH@)2NUTnq9iv&DGOg0Oj%S^Ne{Wx|czX zWMo)a?AO_^-`(0{R5+*3Uv4Ki(NGrv#A~d5gH@{QhXG>VqA<|?{vnzBEW_&7K;rJc zPt~8iRSGv80-gpIa{h7PppD$)9O_c5nQuDQQ^F3Tu@`WiRjMM=DANy= zCrVD9=bzL)IijvTqBv2#g0Hj5cGu+Inkl7M-jtpW)vIHchra6Q|5@H%Z|YJpdtFTo zy1!dQ$l>l+*Y1@(OXouo)-w&hQPy5iA!6q8`1qsXl;pc9^3W#1z*C{h6J>!%rCYqE;u^r6*p*4cr>XgM{pMt!tPG~AXy+`9zFC?s0LrGif+tv_U(Mc`Gc zsf(-MThpXeu(zgF=~Yvnr*A@q-#C$4;hj{Welx9o%ackxj}6A4UF*sX6~0Mf&6Z-wY}R4kq{4q)PP3;6dVW&JzMEUACcu6KodjwWKmXj$7uS5WZ5f8%fSaCHe=`EH zCc$?b-`-1*#f*%lZlPkJCiUai0naD+_E(?#x;doYdS3?Phk!DWIdCL;{$Map9=e0r z33?)8ClE1!zgt>bUW|cTz{t`11RACgBBL4^3C0<>-bf=vm2sr1!_)7sxCoi>X1|0<+)2+d>mGyvo zZ$vP{bMppK6**4OEbE4p7aHdaKaSTWXmxd9O2+*jg40cZ$d@b6bCwLj zVEZpog`qqVa$k(p~|_4CEC*Ht4=N8i3y2>Ltyq%sR?$!~Dy3=gbe=DW)}H)-y1-N^!4l2FTYRx&KS@Eey>6V zUgl-&p~VP~xp9*%>5_=DfafLZ){LI5vY7*++8`>fqbwT7Q>)vk%Sasy65(jDK_l$% zipCUnn{eb6eB(`Eh~EuETahDofY*JtU>`H)RWgVmKC=OZzKBDj+rn*Y7=!aV7Fn4| z6#Nw*yeUx`>SoXF#P|i3m7iH#Ma2apU-7`TbF|tKp ziimqNxgr@9M^+|J&n07e{DqEVBIR-U5#lq3_3@^)RK5q!aT<`>~=iv6EI0&c%sdM02>FA@LvbCu5Y;%mXp1U81jQGj_&x*gii_`iy+4M&~kBWCfMC^s6 z6_hWmn#=-LXrZD?0(G9NFG~aKp+LDUQPsEjs&!b!rAvXsD>7AZUtEDIPS@Q1%=-Z@ zy)ngXnu7sby4iXH7!<%=c9*Eqp4x8xwTgB?3Dn?sk&#}M`)L73DbKd)^Q*4DOKUsE zuW>pi4OS*Kh%VHDyq>PQoNCL+c$K*ZwDW5DG@I_MRj>ogp8Ng)x9qfl*6$U0xA?gR z87^h5tjq;Ua%MeVpJPQuIUn@vR$piI3b~2vf!fy=$?bZOo=rJC6|Rh`YIPB;=nmx{ z?OfyDyT@S4x$oACZ<|c7hao2!>JVuyfE^tNOyG`Z{yT;s+FcgTF! zp_#ZcP6JsLeP7nDf&EqY-&_7}hs7YQoIySghrsV$vkLW>iJlGH-hMQF)op?tj{nu8 z*cRg5_13XG41h`e=oXHJfu;}CuvgCyeD(p{tL?|r^KM;|@LZMNT>j4u`GxNNN59~( zk^UH>iP0crGC`gG<%VqQzs#O9sldqW{jRXT(t(ufKOGX=eHeH8&fy<6q@leM#v?5? zQ9hPk(t5|^DXifawWn7`a zU)rVr0DJ_ub)VOPnRskm5J0%}pPY}>lj^5+Aa@7{E{qIB3NK!rT(qQBg`uaEanvtd zJT4e=|3Dle$+XwMSyiyH;oLzNJH0X?A61p*fd>y1(Uit2c1voH>n>HI|APO!D)NIIalI2o?a4q-ci4G`PA_*p{TqHN0w0avvY$kxSTPkPTNQ#SsG1q zBl#xASo&s7d!s2$$`zOb5+ToT8LN^yj3X}|If!*G761;j&Y(rSzW(w&mAz`AI}RB0 z+{J05hA_L+VF8c6Jw8W$pW=-R44j-pVk)jv`@DHvvM6|f(Or}^jbD) zmzKpTrx#Dw`RQ8vkEB$cN%m{y+tl;*V?TPb!}P%!G;O#FsCT^fl`0B@9ULpr@u19Y z6!y3Q*_QRi2R5DHaM5M#vx_)jb22b``>jeqO!=uj={wc&oxt@MN>n^mJ-Kslp6L3o zvv#_%+J%W1;qsmelsZzcJE`IUPkez-w6%ehdwl}EIk7#^a%&L)=y(JZ?HN+IJpRUR zx7!^qmw5y%7x;1D8aD4zh}F@N$vg8TKq4X?_15jnH*&+AfQf2dbfnDdfv{G!$7L?c z=KuvP3$mOKu{@FlIWoOl?8Q)PvEVVw5@NC8GUo?>q$~hEiNE+nK3U4>o4vDfj(M5= zQoPRY)~WoQ@}&jcYR8EkWC{%#D#fKTZv_SJp_#1FTkPqoa__?{5eHoR?qcHUzGjTx zUj>w+Lu3{={vM3wZG0bsD^MN>W0H!Xcoo{$m&({>LIc9=&!}&${eeCt__RLWI>dc#Zjt)&vbuH$Ez+P&JhX#^fhCizC`)HOQhst;0Bfydk501I0E>!Rf zSOfQITho>QQ@IKMG<)rL0^?x;$k*Bg4Wii9IBv<9LZU;Wdz`87GEBSFZFaP2BCu^% zoA-$1R)5+^YK{AeidOC71XLt?sal{WkBGqe0^n61C3eR)&wSbvc}r@T6w>I3aEE;| zw>Q-r`Y;Tbbl3pIRG@b*KmPJ5U<*N^0w3OdJ=1t50Vy(a{lqwM9b30ov&qr8n`Np3 zl1Q#>%7y=S|gkDVzK^u zvZdOSN{x*vg#B_r!EYPg`zpTUR==4r@TlH>YGYhbBL`@hgL?ZNPqunLWkY!TjF_A- zP-}!KiJAw_f4NQbr}T7U`UQge9Xe!_EsO^w^3tWnhn-$&ZEskAVM+yG*s$$o{kG(` z1nnEy@c?z!qWVG5BpspgLb2VVebDC|)~I+p3r8mZhc{OTYM>(Naa{POvWcGVC3TUJ zEN@(eh^YU_<1=1f%Nfn7BwUv)qBHiI+vG;{d{r|(;8F#S2R&D0sEYA>Z7weA z9oIWykyE4*Q?8~^)XASSt5h^b@bV4_OUVOn9+0KCj}0rf2yuIjIS>F=sG(xS5!W;F zd0tY@b?dJ-oht2Z2$}gB13+jdI8L6Lw&wIFzlN?zSIENza$We$P z4!Y>IIMyH5DDFiaynRz$E)GQ3QliZTgY}C##yMb%<|b7#y-ep+(F+#8WjV zgG=QjN=j^SClA-*X^#rfO*EY8Sg5^DfW}3RO}y38Li*^|4^9uY>3OSRa{Oj9cE6Hu zRSuJ;PF9e0fQi#|paN~nqy{)rf)^Fkz&`WdQ14*>JYF$e;$hQz#}hSx8*=j#H=u?( zz)I$uHZ()(;#7qdn~|zlEz$lHAw0zj0p8Oi?nE))dU6~|@4mFp^pl&OtqEEgotVJH9%$u@+qXuaII^WfI>mK!+y)&m>d;<6K#zqGv_`q2@^#W#I zR;8*hO-{nlF4ESHF4)^2XukJFMjmjfb@_axRp4({cvv9Nof?*Z938P9aNp57A*N3p1yW3k8gH9giNb!`lk0(S;UI(0+a_63y5}_&X?O52b*QLO_PI}nLAPQY4 z2NVOnHcw-Zcj1ebSUd$j3@cKC^MhZ`9V_BIlYy*X_6OFRVr)Ti;^-kf#R{e+cewuc z<~EnAN1Jg|_DC7&{gdI@t~si9D~bumtHYwdN#7qXC{So-WjuO zDwQ%;8lGKax>NxteP1u%-E4waYjgf4|7MqX!nO?a@VJ6!TNSB7_041bIILPRP_b&K zr@k0niSAuGx6j$s$$7gG>BV2esmdfe_^tUXZk z(WTtYr)z3Bm^f$e;@0#=_Fwe0L zsd&8-Q&mIp<5`~VQUG#u7|xcW$4}6fLeqSSWDQBJ9aGQH=hffLi5Ze0j zY_ zMed@vavO{8UDu@g6M56S(G{%+mQu~KQ#B1}9M89y5u zH0L^fJ@0XS?be{^81p6c7`%wr)Z*2mTJp8dqJVmJ-x7)_2FPNtsqrYk=osuARp+Ia z5Y$*C-CxZ$76$jUPd>BTbhj>E$}z^Yf>@^Q7D}w-{ zt>$Q;18Dr`G-@_k1t_n>_9{TF5?H6s4WLe?RUi%`M0{@I0Vl;KFMC!^Qgpbr z#3B`bdsIg_)rEq-O?+RB#&y>;yB|x|3pEWBqj)!I zNcuOR_kKKlZmJZ(`?;MJo^DLi>L`^`rY?--c&pVo-9^`wxe+fBNH&Yq0BBn>S?N0H zW`(Vd0gzwBlT1=dlFy6&F*a8T)zsitG+RS*z+CqW&wVB?_4D!c;%%-InDLg^Ufq-* zZMhAt2y{;L%Ysfl9ljcQuVA7f-uEd5F8AC;DyW_$why+IPnSRZROb84Vb8PUM@PtB zvpDza3&!P?5+xQpRhu4Ix`a+g`En8*o4iSQ^zu2p(6@M+yj9u<*2ZHko_zQ zicZO%^>xrGxsHwtPapGkQ|KODbfJfZ>3(Cn!sb?rZ-%})gF&OEkn?iHO4WZ-Fk3USI zGPA=rpnzMrqv}b;s2o^;1ot^)IOYbGeP_&V*fg&gX8M#nU(4tq0cYu=wgWvx#@Z^N zlF<=SdN4;)&d?kfNKg~FiF;OjZP`9gI#lf@pq@?(QiOdbxNO^w(=pk@(*@=sh-`V} zf{^@WSI+}er0n|5)FeYSqV%+ZXJ0eB>h!_ctng&zn{;4US38*b!Dckv4XvV)hM*<^ z5Gd}WxXtjVK6V`;2*GFghoOFTrkhl_queO%Qh3d}Zb;nMvas{0#uSA(Eod4nIk(00 zSYk49>S0V|lAhY{S&phnK%x;=y*nn?vro@BZG>G@EYeb1JvkVYUDHsmQD0w#^FIAB zwjsroC`W{eZy}YE{N7rXHAp#AU(|1oDTYm%p=bMj69@A&A*1}wb5P3rYV(Jw)UHJ| zHkRKI$o}us{i>a{4Rp7*En(1S{$yR{9IMeu1MveE0NlMpX?pj@1=vjoYl9~3I$LJ| z*?n2^_~kxhH3hYeua(#(H#Sp_%+IO0$6qX}_i;I!=#eNA$ud^&h$l)`kXnbQ*zAdK zXj8;j!W99~WvK@Tvy-t#|;Dw-xSu%G+)59VDV8W(8eP3uzc4XgDOBmiFim7!FMzzr37z4HQU(Jn}~ zeb{X3e$_~QLVljk#Ps#n2|K5lN5LM+AG_*-qaylZ}`U$xaN zDqt`R>3qq#t$xvnR4|4EF!Xi`s(Z2=RTdj?-;*0U?9-!70IhZ)!1)Y#2~GQDtN4g0 zSd1nTNB#CrU_j3|y0sVygFvFrel1z3WZ6h5YvpmZ=(E~7)V9#ndx&`b08VXkrcEHM zb}GTJo*XH!W7L@^E$VOku6|@;;DTC+^Qd2vjCj$(yqXOvVb{!d|Df89Ai!HW}7WwlzVJbU37i^hYZ!;xF3Lqn91J zRQ)qIC6gED@s+6SlLN<>lgzF*`HfI7&gwM(aVa2cXlpiFulo|GrvLghNBH<~&BaBu zOY20;)7YX?Cre13?fs1UY$`cMIFMFA>~kjf;K*hhOqe z#x5aIAqW-R!wa`8a5SUtfK<+OtTPuzF%hFwoB{)QeHq}R*h{Im^+H%Vj^CT|2zxe%D&P*Obt_o zr>Mbs!+*2}B!4S{eXSclPF&3Fw=e@zP;|uO`HtC8Gk@#If>0yj{mTrm3TwJpVWt*mJC%S%6-LL@rnVl$)nubd0?VGzV6il*98;?Q zz}3zhvti_q$vx4U6EU46Ac-FH6Y^23zwAQs_QRC<=jR=Y1~N=Vu(;vzPT(=BVx5Ym zGSG13eHmna2a!z(^yR)M_t;GU?pAzqQ)^jt)(CX$MRRAo<}<}mB_9i=$d{!2=V*D) z1@Xluh5dXPer^^5@|ftvnn!_zbwIBTy{^4Mv;glw0%e$@jRKJ5Z*bKVe3T3C9^Iq~JuQ|ylXziPW4abdA>8Tq!6iOnC>Vyp$$RP%F1W~6C#q>QLM1vwYK693biIaYPwXRyXu(L znm|z6_I>{4C^wUqDS;8eO!A`h+je4ON^pHW5(lMvHcGVLi9=uWG=S8lX4}SP`?$Gv z=qCZmUIvhcrI=$pk^b%{v-&NUDw^542}1DvFgaF#XiUZIL|Njd4w&gO480L(Xu*J@ z;`h2vOZwP9+JbLLo?hhl|D3!K~e3*B|ByD&BF&?aXpo_ z@XwsXjos3%N0ZP7sT#X^u06J#-R=QWToy-L0ND)nhxfJsqps)xR6$ zC6uVJL6m=7Zl;iXGhs=c(h~kiJ@KIXmxs1g!qz;3rC%P|>IS9qMkI;bcMyhS zws8d%32n=L^Dn9xWvaBEwjh+VNHJ_yF`QAs=6$feO(f0rsbNoLdQtp)|I|z-CCf=% z#Ccux*63F&en6%9mGQD$1AQVxx|{a(H&lGWbDwZI6%h4dz7MG(6@6ynPd-H6uG)~y z6CZwuRO)BnHjDn4U=G&{UKpxTS3{HZ;<1WP_vSyK_IsG?meES(Z!c`hrv?D2W41+^ z5lvAZde46`Oz{R6o+<>T5CE=N%eB5EGa(2w=V-klt$P4{2Tqa?Z+XRiMScF`NeQ(k zDQjqF>>t2lQ{AJxd>ex)=2+@Gyuqi|{~MZ^(uY9c;=dj0^R;@9xVCY_dt#$*&z^eN zfGVgp4v>f`9M*o?YwWvjVNu*@)_>cLM(g%$EKsICvb3Rej^gA_EyBZdPsPotDWd#e zqdc7BYZ~~}#A5bmvum0(zklKxc_$~^)C@L7>#^nL=iX~X%31V&aj|S1?Hqy-AY*-0 zk%K^5h)1G}To3eidbwj1ofQW!s{ne+LHETZm+|UvCvqQobpbY~z(P5nr+u%&&&c36 zeW2WGvRCO^bAo!D6_PYY!~?O!&&D5rs_u=QZy=Ezx*2I+eq5gnvWAY!u~zl;R|`Z}H$VGV+8$bmMd&P+#!9eM#BH zP<)>ynxuniE=4xm&d$|xN< zlyQ}mCC)11RF=H)lawpmiCz@R>%?j8kF|rAuqJrjQ5&Hb8i!X#odJ_(@?^(yk28f#}~sCqSde?Dazsu3f~N zH5is+PS`th-je?J2+|>__^=%E)3bJ=4>A4to9g7pK9Air45iqyRYyz17fo=7M2YUE ze$?AsM^Cmo>L9R$!BWy9MXtD--f4UWV5$Ivb(f$|gV>`OQE*lcsU!Yb_t04mu&qGT zl_J#jN``VHU6dsBJL5UkvAFn;mw*E!Tc-5Ig{a&`SYXb<@4az4j4Wbko!ijHh`U{` z*R=z4dDGe|Q}AuQQ<9dHdka7v!O{$m~9KHTrZ#p(n^3=Xak>t zKBe3@!bn-7%K@HN|6SpLIX0NEAIbNDcG@BkeWir_$MdSH9`KOoN~nG($I&~leaCm` z)0;8nUj#$UdDL`~Z~yn@($@^=3|&@WbMLSJ0k+4!L-GD@L!NW?Hgpbq$#~TU zZvkiuzibLtn`vd0^?+TlA3L9a0V00YQGU@o@v4{q%pe1RT*eLz&%f;NK14-d@-A9U zL;;KGzh-Bl`gBl-A62hJP+M6wfO_%EHZ7m~!J-KVhKqs#loWm2f7Md{73$;H9d|kW zC5OIG0e|n*-+Sg|4eCztTD+gXsdmF&io+d8_!-ccL9+kNL2D>#FU?q7v6H~Yj#q<@ z;g=k=I-+x3mg^zLD_*P*Ujy*}bPiGemg+x0+`v*8F-bDQf3w9R4khy>BxW$q3;wPU zLr!};D_7x8kNt&C_}|G2K-~aDi|w!jvmT1G?W+W~p0!vWppO}1Hwi`tBZ%K_vR5lNP%UaX5e4}#rhwpZavwzUe{Ew0?>h2 z06GEfL~HI>qRm4Fkij|@>~};Av?(Edsr|5YF44lOy0L^o(Au>CFG`F4ETYO!B#Gx$ zc#>8CB!Wf&EC-!a7mOG|SB|T|OjkZ_kmUE@3Dq<_F^uZcWZVrI9Tx7A%!4s_|I0I- z1fL+C>EG?>Gsyt|_^(PC%E^SV?h#ESzes3((CW@`^MutiBLGDt29@8rb0?}?XEP%z z=Vp)t=U*fykOan_(($K5#kLzO7rLJH&Uf0?R(MmA>i++tOBtTKn~_%CbCD4dksJ3H z=PHVG{WrUtVKI}8SRSh*EZm`x(94#wr?%VSM{ z!yq=DLe)fhxORyuM}RU=Sol#~;4$5fRs2xPoW}_R-7PFW@*k?}SA9utAPaYCrVeE4 zR`)V{HLrm6N`V9^0j9q%@flV{(@WdEU)E=Ww(?aThGFV&WQzy;e8SUe*69$oIe6p;ot`dvr(-5l*6!&Yk3eypshw z4B-n8q8*)(61%{+y+WdU{r(uzin+ zwG8tW2a<4}Lp*Ykc{$ zP1CpJ7)UC>cGR(+)x8$?QEvLk9!Y@)KTR()!+uvEXTOzS^iCkQwj4t2hM*Dw&~fCQ zz~kMaeC`Ztmd+o0`P5TO;Pvs!SEVe|bqQ=H?l?{7Z%TK~%3zvCf6Juppemz)o-7<1LiRhzKoOr!` z))R<5v41)>ztdecO1=*uH+^+rlV3FPz8E)Xm7wZtqjRb22^rJS)I{?zkkkvyxVA zlj{NHGh?;%(U|{uoNw|hO3{j;bLp2prU&@U9Z#>YklSu}G2gn_nnBiS^~WB4O7tmg zn=5Ej=8g_fLmG_Q3B*i24)PN9BtlkkS%40-pf9rJ1K$~6n5u7u`(=CE)`^5S+ddMF zuNYFdeCmp zO-ylfMloy}5Lo}@?Ap8CdD~;1HSV#a;~iJu<^%wwLGF*k0jmzpxK*JV2rEFemt@Rw z=$mnx_5Kb6@|`T-YV0bgX(b&7SjCWZ(v{)ahhr@#4)2f|L#%a+9SE-cIX5QV_g#nT zYLp`|K}G|}pnppJdCt!s>uF%e=q3SyfqBL+2vHT6$C6fq|A00ah~#8EIM5Xy=0HgYI4SSt; z(?r5{H7uAHME?FEb4y6zAJ#Qt0;hzU+p^21fA zXh6e2v-`P*G0pCWG#T(JbYIlYG`k;zCpZ;m+d-z;F@$$Ig_LP_|0E3b6DLS?Wk$Od zhi@QSgX~{sv|E`V0MnaJvooXJ8bS%!D!gOex}9${PaQwcOgMiye}iTPQq7qO=Ndv` zCY&ov2v*E<-ingS_l%A%6y`Z^MKK3t3*XP{ys}ar|J0nACafLq8klDjq=~b8|m6h`N7f-+}sjN{w_^*=6x8(xsy9(TkiCPm@0@Co- zL_+N1gY5BiF(uQmm{qy@=NCVNT|ih{zg}7IzGmm%>8Bldxd@HX{^AJ=GH@mE3wXxL z(?0{00J3PQ`VB9>7AB$Vr`Q6UU19ANu)b-RWd=+U5EUQ%LKZI{{NA9m7TO~Br??yd z^qTIAEhXTVRwBv3P38HOEO^*s^|Q0e9Jl+ z4wk%ej7Qm9clM}|c8M8p@8*K_t0P|JF&Qg_47^Kxt%2LS??*69H>StS&78dZHl-Zh zxB6a+TsmFp-$(lQFL;ngp#_#^>AET`tY>Xk5Md-nfceiZewp)vXFboaq%wf7SoMLV z6-Kl@xHeIik*gKO6wCl4&>na#4R(TmEdd;|N;?uYnzqKR52YYOijf!qCSyPtZn*)Q z4y;;zvlXvCHu%t5XTqzM`mTFFo%2~GfFMth6}5W!F^3G`DPGR@;Fs^OzT!gWSuvaa zsvHFnLCekO1NyIDPOTQe7|4WLeTf$!XgB!}%wif2GvY8K4m08~Q#EF)#!S_iXB_4khk3?f76+Kc z0cLT4Syf|J)tFT^W>t+@j%JplndN9^ABWk;VfJyD4NztSl-U4fA_thr0VZ;Q3AtfH zZkUi8Cgg^RRbyh+m{>I?$dd{3WP&`I=x8Q7dNn+piH>H{3YfG4Car+U$6@kun0y>2 zABRa~V-nfGD~y>$HYNiUWY99quw^npnG8@Sb^8A=)aft&;|JEQQ-2N)cK`11nKWwV z`~l|t0p|Px=HL$I;11^C4(8wv=ENK3#2e3zd_m*f|9A?k_phd~l6&y~4-I=| z{>=XZk;4=kQ)o={{GU&jX4(zYZkTq%w3}bdmuF@+YY*jTx=yC+WV%kK>two4=1KbJ zx3e&#Co_67OG9hUCSoQ~%mj*=Krs_2W&*`bpqL5N|MX5kX7pr6PiFLFMo(t+WJXVB z^khcQpWYA5tUxg%9h`u~fMQ4^dT9IXdlK0bcRa~<%X=4sti*(a=S F{U5w0ynX-x literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.2.png b/Tests/Web3ModalUITests/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..d8147f3f984ecf0b52c85d88be688142af86c767 GIT binary patch literal 86234 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
>iy1~S$oQ!>pe=5c+CBc*jdNK9tsxEwA9=6 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�e|x>x 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

    {)2Ew;m_80Nh+~(_T(WsCQiRBU8$bO9%~J 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 JQKW7g`agp4iEsb_ literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MButtonSnapshotTests/test_snapshots.2.png b/Tests/Web3ModalUITests/__Snapshots__/W3MButtonSnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..79f4f942bdf7a2b3ba9555d8d8d44b12d5015b7e GIT binary patch literal 217636 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�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≠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

    F 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 HET8@#gi>4I literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.1.png b/Tests/Web3ModalUITests/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..4c39f3dd0cf5e33d20e7b02f2a82634fdd43da7b GIT binary patch literal 190081 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%0DAX$fg`=$zQrG2I><}zsTo^QH8A(asp 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�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 N9w=)mmE5%q`5)zs0Yv}+ literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.2.png b/Tests/Web3ModalUITests/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..bf0e140b8e24c81544a74ba769602efd038fbb9b GIT binary patch literal 191000 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 IRUe1^KSiSGM*si- literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.1.png b/Tests/Web3ModalUITests/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..cfe1d3d5eb0f0dbdab4812a2939db3cf81ab7bb5 GIT binary patch literal 353415 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�G&X+`p{TBjs`qeQXne-7Qa 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 z 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 OUJMZ>4MC167?w^u}@+PpN4MspepP) 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

    w1ZE?*B^lmD>S?LsA@^5WAvumTxb)t9 zECKCkILokqu&UUy`M^z$V!ie)ng(}a$n$md!+1xoLd3}%JI7f>O(QTAKKkhUoc4b}nUM_HN(O?B9< z3Qj9f$`}g-{rAoBkNHN=qr-ciHwF{$x%&LC2b6;H1r|jkDsoH3Y198SS=1Z6%VChP zwlbob6vAl==3ig#!f$Q7 zZP50At7w~yn!JNJR^D=dL?UCCa<`nMXz?_)<P1cd5)`?L*DY1iHv&^@Oq=%>I$k;!#!vH9rK*p+7JhiWYXjwL^a5>-%S>wINTeTm*zu$r1 zk_Ufi3E2j0lWuf0=&=ei7Jp(HdO+ilM%qUx`0L8~Dc5$YAZ>Ss!Z>`l5lW!A9x48|2m#8Y}j^;+n zM#=|H{((xD)JV!t8ZFz;L&F;z0zUge)rd>Mt0$(*b)4tAuY{4Qq9Ek6i%EH2BEXaHV`@> zbU^5+#WoN+Aaq(l=%~?9fzSb=140Lc&gn?7(@|&K3xo~`9dLLJ99{#5*VG!t1EB*# z2Yjca&Z{F3Iv{jF=z!4C0^jL?6A8eH1Zs`qffEV9i3H$80(D*;fzbJ{K*x8k{nr&M z*250Ee0~g^$p%cA1G^ru>jAqSuAfX~4%kGNERfjswb47@Fp literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.2.png b/Tests/Web3ModalUITests/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..8d9d696fe4aa894c83f8e27019b625e933ba4e10 GIT binary patch literal 358143 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≪$z8O~!r`*fedr>)jSj3i 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

    okam{N>Awv6$k*uT_BT#z#)TyO+qr%zJM~ zyd#gypjm`|;^mq6KVtvm{{N%&{Ri`QnZL{YzuxvhHSF&E|EW24cmA&0-&Om6Y4&z) z{;tjcH^3LZ2jDMIW~cLCzPxx19Ghp&`KEt$;oqL&1cH0*H}I@~{ow8E&wv5F}`0v;MGjsKGOW_ADll&hQzx?yp{@WLwD*!W}d1RLN7sUJfGya7! zf9CqDz#TcSic|wt{6DdDo$YiEyR*lC=i)yeb>k-RH9pLN#%O>yH!_Rx=@-Me`pvEp}*?|JPpk)UN?1GlvOy|E_-rY3N z4(fC_4YY$g-Ax1SpiXzwKsy+e-89e+uHSAN=wHt7KMl}s8t9*-__r^+^(s5~fV)6t z7pUw&fnA`oTXpzvs&hAhxP$84&2;XdICe9gJE+dxOy>?h-v7r;XCnjJAAfJpo;{oo z*I{vo;@_|xn2OT5*~lcRT5xlRoxFn_YwQ&&5owp-;V(Pz_g6L*`!lX)KUqxvD4Yea zYx$Ec4Of`>3u>a z&&tpLT*pD9ZX*-vrPNR6_g;synERN&`8mD>98j^>{KI(%j_p9AC&%wMUhT?1{%>aQ zzq~C6;LD>j_8qE%cDU&oAl@g-#Gh+R`Fi4O_{xo>pNyye{}gKWvo!~Z7BBl?U?=Ul NqGxou=#u?!{|^sQ{uKZK literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.1.png b/Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..0322895cdc3cb461af624a1d171eed8196d5c4ef GIT binary patch literal 197177 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 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.3.png b/Tests/Web3ModalUITests/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.3.png new file mode 100644 index 0000000000000000000000000000000000000000..196f49128ce427302ddcd001d29566d763c387ce GIT binary patch literal 260814 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ԲJC#vqW{-v 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∋G$Q@h1fgC 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 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.3.png b/Tests/Web3ModalUITests/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.3.png new file mode 100644 index 0000000000000000000000000000000000000000..8c166f7dc3615f009391c82d88254f6834748845 GIT binary patch literal 330900 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 }XscEZbWdpE;3u`}y7-5^Rs83H0 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 IXcqMU0NYZm$p8QV literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MTagSnapshotTests/test_snapshots.2.png b/Tests/Web3ModalUITests/__Snapshots__/W3MTagSnapshotTests/test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..7a7e4b9a388bc5799e8354d39333a39a786f7d6c GIT binary patch literal 30907 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 T9eEA}{Hb5px>l@e75={fsP7D$ literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MToastSnapshotTests /test_snapshots.1.png b/Tests/Web3ModalUITests/__Snapshots__/W3MToastSnapshotTests /test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..d3f64851c23bf7ddd57c621bf37de96f811901e5 GIT binary patch literal 51989 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 V*eQYn3fUY|xuf|v^45bF{{vJ3_I&^V literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalUITests/__Snapshots__/W3MToastSnapshotTests /test_snapshots.2.png b/Tests/Web3ModalUITests/__Snapshots__/W3MToastSnapshotTests /test_snapshots.2.png new file mode 100644 index 0000000000000000000000000000000000000000..0a707e4f5f5031bd442b64db9d445ab3a90b18ce GIT binary patch literal 106572 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�RHJ_R1iIU2CihmRb>)vLoM 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 WQMGtbAD<5Z0000 Date: Fri, 16 Aug 2024 08:07:25 +0200 Subject: [PATCH 716/814] savepoint --- Example/ExampleApp.xcodeproj/project.pbxproj | 4 ++-- .../xcshareddata/swiftpm/Package.resolved | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 401737760..a984e0a53 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -3265,8 +3265,8 @@ isa = XCRemoteSwiftPackageReference; repositoryURL = "https://github.com/WalletConnect/web3modal-swift"; requirement = { - kind = upToNextMajorVersion; - minimumVersion = 1.0.0; + branch = "pairing-expiry"; + kind = branch; }; }; A5434021291E6A270068F706 /* XCRemoteSwiftPackageReference "solana-swift" */ = { diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 6c7d4562a..34a63bc5b 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -185,9 +185,9 @@ "package": "swift-web3modal", "repositoryURL": "https://github.com/WalletConnect/web3modal-swift", "state": { - "branch": null, - "revision": "2d94ebc9065d1602ddc7eb60dab34a853afb4186", - "version": "1.5.2" + "branch": "pairing-expiry", + "revision": "3088a08a43c490c24f1dfb1b858a67de089feef6", + "version": null } } ] From 62648e71dd3bf21d176ecf721af96104eeee4654 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 10:39:07 +0200 Subject: [PATCH 717/814] remove pairing on auth response --- Example/DApp/SceneDelegate.swift | 9 -------- Sources/Auth/AuthClient.swift | 10 --------- .../WalletConnectPairing/PairingClient.swift | 4 ---- .../PairingRegisterer.swift | 1 - .../Wallet/SessionAuthenticateResponder.swift | 22 +++++++++++++++++-- .../Sign/SignClientFactory.swift | 2 +- .../Mocks/PairingRegistererMock.swift | 4 ---- 7 files changed, 21 insertions(+), 31 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index f4ed47f2c..03d23797f 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -136,15 +136,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { mobileLink: "wcflutterwallet://", linkMode: "https://lab.web3modal.com/walletkit_flutter" ), - .init( - id: "flutter-sample-internal", - name: "Flutter Sample Wallet Internal", - homepage: "https://walletconnect.com/", - imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", - order: 1, - mobileLink: "wcflutterwallet-internal://", - linkMode: "https://lab.web3modal.com/walletkit_flutter_internal" - ), ] ) diff --git a/Sources/Auth/AuthClient.swift b/Sources/Auth/AuthClient.swift index d9551bdde..adacee96a 100644 --- a/Sources/Auth/AuthClient.swift +++ b/Sources/Auth/AuthClient.swift @@ -68,16 +68,6 @@ public class AuthClient: AuthClientProtocol { setUpPublishers() } - /// For a dapp to send an authentication request to a wallet - /// - Parameter params: Set of parameters required to request authentication - /// - Parameter topic: Pairing topic that wallet already subscribes for - @available(*, deprecated, message: "Use SignClient for sending authentication requests.") - public func request(_ params: RequestParams, topic: String) async throws { - logger.debug("Requesting Authentication on existing pairing") - try pairingRegisterer.validatePairingExistance(topic) - try await appRequestService.request(params: params, topic: topic) - } - /// For a wallet to respond on authentication request /// - Parameters: /// - requestId: authentication request id diff --git a/Sources/WalletConnectPairing/PairingClient.swift b/Sources/WalletConnectPairing/PairingClient.swift index 1f3ce81ae..7443adeee 100644 --- a/Sources/WalletConnectPairing/PairingClient.swift +++ b/Sources/WalletConnectPairing/PairingClient.swift @@ -103,10 +103,6 @@ public class PairingClient: PairingRegisterer, PairingInteracting, PairingClient @available(*, deprecated, message: "This method is deprecated. Pairing will disconnect automatically") public func disconnect(topic: String) async {} - public func validatePairingExistance(_ topic: String) throws { - _ = try pairingsProvider.getPairing(for: topic) - } - public func register(method: ProtocolMethod) -> AnyPublisher, Never> { logger.debug("Pairing Client - registering for \(method.method)") return pairingRequestsSubscriber.subscribeForRequest(method) diff --git a/Sources/WalletConnectPairing/PairingRegisterer.swift b/Sources/WalletConnectPairing/PairingRegisterer.swift index 5e5a27642..a6de58164 100644 --- a/Sources/WalletConnectPairing/PairingRegisterer.swift +++ b/Sources/WalletConnectPairing/PairingRegisterer.swift @@ -7,5 +7,4 @@ public protocol PairingRegisterer { ) -> AnyPublisher, Never> func setReceived(pairingTopic: String) - func validatePairingExistance(_ topic: String) throws } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index 8e1e399ef..0ec4e68a7 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -12,6 +12,7 @@ actor SessionAuthenticateResponder { private let metadata: AppMetadata private let util: ApproveSessionAuthenticateUtil private let eventsClient: EventsClientProtocol + private let pairingStore: WCPairingStorage init( networkingInteractor: NetworkInteracting, @@ -22,7 +23,8 @@ actor SessionAuthenticateResponder { pairingRegisterer: PairingRegisterer, metadata: AppMetadata, approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, - eventsClient: EventsClientProtocol + eventsClient: EventsClientProtocol, + pairingStore: WCPairingStorage ) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -33,6 +35,7 @@ actor SessionAuthenticateResponder { self.metadata = metadata self.util = approveSessionAuthenticateUtil self.eventsClient = eventsClient + self.pairingStore = pairingStore } func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { @@ -113,6 +116,9 @@ actor SessionAuthenticateResponder { protocolMethod: SessionAuthenticatedProtocolMethod.responseApprove(), envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation) ) + Task { + removePairing(pairingTopic: pairingTopic) + } eventsClient.saveEvent(SessionAuthenticateTraceEvents.responseSent) } catch { eventsClient.saveEvent(SessionAuthenticateErrorEvents.responseSendFailed) @@ -137,11 +143,23 @@ actor SessionAuthenticateResponder { } func respondError(requestId: RPCID) async throws { + let pairingTopic = try? util.getHistoryRecord(requestId: requestId).topic do { - try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + let _ = try await walletErrorResponder.respondError(AuthError.userRejeted, requestId: requestId) + Task { + if let pairingTopic = pairingTopic { + removePairing(pairingTopic: pairingTopic) + } + } } catch { throw error } verifyContextStore.delete(forKey: requestId.string) } + + func removePairing(pairingTopic: String) { + pairingStore.delete(topic: pairingTopic) + networkingInteractor.unsubscribe(topic: pairingTopic) + kms.deleteSymmetricKey(for: pairingTopic) + } } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index dfd4f6d35..ec294410a 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -128,7 +128,7 @@ public struct SignClientFactory { let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, eventsClient: eventsClient) + let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, eventsClient: eventsClient, pairingStore: pairingStore) let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder, verifyContextStore: verifyContextStore) diff --git a/Tests/TestingUtils/Mocks/PairingRegistererMock.swift b/Tests/TestingUtils/Mocks/PairingRegistererMock.swift index 3c21567c6..052b9ca43 100644 --- a/Tests/TestingUtils/Mocks/PairingRegistererMock.swift +++ b/Tests/TestingUtils/Mocks/PairingRegistererMock.swift @@ -16,10 +16,6 @@ public class PairingRegistererMock: PairingRegisterer where Reque public func activate(pairingTopic: String, peerMetadata: WalletConnectPairing.AppMetadata?) { isActivateCalled = true } - - public func validatePairingExistance(_ topic: String) throws { - - } public func setReceived(pairingTopic: String) { isReceivedCalled = true From 5eb9b22aa8c479955bd86fa14ac7941e72e5cdff Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 11:05:47 +0200 Subject: [PATCH 718/814] remove pairing or auth response --- .../Auth/Services/App/AuthResponseSubscriber.swift | 12 +++++++++++- .../Wallet/SessionAuthenticateResponder.swift | 2 +- .../Engine/Common/ApproveEngine.swift | 2 +- .../WalletConnectSign/Sign/SignClientFactory.swift | 2 +- 4 files changed, 14 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index 6ef9839b3..b4889b8e3 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -20,6 +20,7 @@ class AuthResponseSubscriber { private let authResponseTopicRecordsStore: CodableStore private let linkModeLinksStore: CodableStore private let supportLinkMode: Bool + private let pairingStore: WCPairingStorage init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -33,6 +34,7 @@ class AuthResponseSubscriber { authResponseTopicRecordsStore: CodableStore, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, linkModeLinksStore: CodableStore, + pairingStore: WCPairingStorage, supportLinkMode: Bool) { self.networkingInteractor = networkingInteractor self.logger = logger @@ -47,6 +49,7 @@ class AuthResponseSubscriber { self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.linkModeLinksStore = linkModeLinksStore self.supportLinkMode = supportLinkMode + self.pairingStore = pairingStore subscribeForResponse() subscribeForLinkResponse() } @@ -56,7 +59,8 @@ class AuthResponseSubscriber { .responseErrorSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in guard let error = AuthError(code: payload.error.code) else { return } - authResponsePublisherSubject.send((payload.id, .failure(error))) + Task { removePairing(pairingTopic: payload.topic) } + authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) networkingInteractor @@ -67,6 +71,7 @@ class AuthResponseSubscriber { let pairingTopic = payload.topic removeResponseTopicRecord(responseTopic: payload.topic) + Task { removePairing(pairingTopic: pairingTopic) } let requestId = payload.id let cacaos = payload.response.cacaos @@ -215,5 +220,10 @@ class AuthResponseSubscriber { authResponseTopicRecordsStore.delete(forKey: responseTopic) networkingInteractor.unsubscribe(topic: responseTopic) } + + private func removePairing(pairingTopic: String) { + pairingStore.delete(topic: pairingTopic) + kms.deleteSymmetricKey(for: pairingTopic) + } } diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index 0ec4e68a7..f33758a03 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -157,7 +157,7 @@ actor SessionAuthenticateResponder { verifyContextStore.delete(forKey: requestId.string) } - func removePairing(pairingTopic: String) { + private func removePairing(pairingTopic: String) { pairingStore.delete(topic: pairingTopic) networkingInteractor.unsubscribe(topic: pairingTopic) kms.deleteSymmetricKey(for: pairingTopic) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 3d4d12204..c02f1ae95 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -199,7 +199,7 @@ final class ApproveEngine { verifyContextStore.delete(forKey: proposerPubKey) } - func removePairing(pairingTopic: String) { + private func removePairing(pairingTopic: String) { pairingStore.delete(topic: pairingTopic) networkingInteractor.unsubscribe(topic: pairingTopic) kms.deleteSymmetricKey(for: pairingTopic) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index ec294410a..523eff3a4 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -115,7 +115,7 @@ public struct SignClientFactory { let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) let supportLinkMode = metadata.redirect?.linkMode ?? false - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, supportLinkMode: supportLinkMode) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, pairingStore: pairingStore, supportLinkMode: supportLinkMode) let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) From a669143d43a9b2bf8951093c981c086e35657642 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:17:01 +0200 Subject: [PATCH 719/814] fix auth build --- Sources/Auth/Services/App/AppRespondSubscriber.swift | 2 -- 1 file changed, 2 deletions(-) diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift index e7036bf5e..405c2117a 100644 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ b/Sources/Auth/Services/App/AppRespondSubscriber.swift @@ -37,8 +37,6 @@ class AppRespondSubscriber { networkingInteractor.responseSubscription(on: AuthRequestProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - pairingRegisterer.activate(pairingTopic: payload.topic, peerMetadata: nil) - networkingInteractor.unsubscribe(topic: payload.topic) let requestId = payload.id From fca72e1210c554ae95b3449fe4328b07649f8cbe Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:33:14 +0200 Subject: [PATCH 720/814] remove auth --- Package.swift | 7 -- Sources/Auth/Auth.swift | 46 -------- Sources/Auth/AuthClient.swift | 108 ------------------ Sources/Auth/AuthClientFactory.swift | 68 ----------- Sources/Auth/AuthClientProtocol.swift | 11 -- Sources/Auth/AuthConfig.swift | 7 -- Sources/Auth/AuthImports.swift | 5 - Sources/Auth/AuthProtocolMethod.swift | 25 ---- .../Auth/Services/App/AppRequestService.swift | 34 ------ .../Services/App/AppRespondSubscriber.swift | 73 ------------ .../Wallet/Auth_PendingRequestsProvider.swift | 25 ---- .../Wallet/Auth_WalletErrorResponder.swift | 52 --------- .../Wallet/WalletRequestSubscriber.swift | 60 ---------- .../Wallet/WalletRespondService.swift | 77 ------------- Sources/Auth/Types/AuthPayloadStruct.swift | 59 ---------- Sources/Auth/Types/AuthRespondParams.swift | 11 -- Sources/Auth/Types/Errors/AuthErrors.swift | 72 ------------ .../AuthResponseParams.swift | 4 - .../Auth_RequestParams.swift | 14 --- Sources/Auth/Types/Public/AuthRequest.swift | 8 -- Sources/Auth/Types/RequestParams.swift | 39 ------- 21 files changed, 805 deletions(-) delete mode 100644 Sources/Auth/Auth.swift delete mode 100644 Sources/Auth/AuthClient.swift delete mode 100644 Sources/Auth/AuthClientFactory.swift delete mode 100644 Sources/Auth/AuthClientProtocol.swift delete mode 100644 Sources/Auth/AuthConfig.swift delete mode 100644 Sources/Auth/AuthImports.swift delete mode 100644 Sources/Auth/AuthProtocolMethod.swift delete mode 100644 Sources/Auth/Services/App/AppRequestService.swift delete mode 100644 Sources/Auth/Services/App/AppRespondSubscriber.swift delete mode 100644 Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift delete mode 100644 Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift delete mode 100644 Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift delete mode 100644 Sources/Auth/Services/Wallet/WalletRespondService.swift delete mode 100644 Sources/Auth/Types/AuthPayloadStruct.swift delete mode 100644 Sources/Auth/Types/AuthRespondParams.swift delete mode 100644 Sources/Auth/Types/Errors/AuthErrors.swift delete mode 100644 Sources/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift delete mode 100644 Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift delete mode 100644 Sources/Auth/Types/Public/AuthRequest.swift delete mode 100644 Sources/Auth/Types/RequestParams.swift diff --git a/Package.swift b/Package.swift index 797d5622c..d674fea3c 100644 --- a/Package.swift +++ b/Package.swift @@ -13,9 +13,6 @@ let package = Package( .library( name: "WalletConnect", targets: ["WalletConnectSign"]), - .library( - name: "WalletConnectAuth", - targets: ["Auth"]), .library( name: "Web3Wallet", targets: ["Web3Wallet"]), @@ -54,10 +51,6 @@ let package = Package( dependencies: ["WalletConnectPairing", "WalletConnectVerify", "WalletConnectSigner", "Events"], path: "Sources/WalletConnectSign", resources: [.process("Resources/PrivacyInfo.xcprivacy")]), - .target( - name: "Auth", - dependencies: ["WalletConnectPairing", "WalletConnectSigner", "WalletConnectVerify"], - path: "Sources/Auth"), .target( name: "Web3Wallet", dependencies: ["WalletConnectSign", "WalletConnectPush", "WalletConnectVerify"], diff --git a/Sources/Auth/Auth.swift b/Sources/Auth/Auth.swift deleted file mode 100644 index 044e92bd8..000000000 --- a/Sources/Auth/Auth.swift +++ /dev/null @@ -1,46 +0,0 @@ -import Foundation -import Combine - -#if SWIFT_PACKAGE -public typealias VerifyContext = WalletConnectVerify.VerifyContext -#endif - -/// Auth instatnce wrapper -/// -/// ```Swift -/// let metadata = AppMetadata( -/// name: "Swift wallet", -/// description: "wallet", -/// url: "wallet.connect", -/// icons: ["https://my_icon.com/1"]) -/// Auth.configure(metadata: metadata, account: account) -/// try await Auth.instance.pair(uri: uri) -/// ``` -public class Auth { - - /// Auth client instance - public static var instance: AuthClient = { - guard let config = Auth.config else { - fatalError("Error - you must call Auth.configure(_:) before accessing the shared instance.") - } - return AuthClientFactory.create( - metadata: Pair.metadata, - projectId: Networking.projectId, - crypto: config.crypto, - networkingClient: Networking.interactor, - pairingRegisterer: Pair.registerer, - groupIdentifier: Networking.groupIdentifier - ) - }() - - private static var config: Config? - - private init() { } - - /// Auth instance wallet config method. For DApp usage - /// - Parameters: - /// - signerFactory: Auth signers factory - static public func configure(crypto: CryptoProvider) { - Auth.config = Auth.Config(crypto: crypto) - } -} diff --git a/Sources/Auth/AuthClient.swift b/Sources/Auth/AuthClient.swift deleted file mode 100644 index adacee96a..000000000 --- a/Sources/Auth/AuthClient.swift +++ /dev/null @@ -1,108 +0,0 @@ -import Foundation -import Combine - -/// WalletConnect Auth Client -/// -/// Cannot be instantiated outside of the SDK -/// -/// Access via `Auth.instance` -@available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") -public class AuthClient: AuthClientProtocol { - - // MARK: - Public Properties - - /// Publisher that sends authentication requests - /// - /// Wallet should subscribe on events in order to receive auth requests. - @available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") - public var authRequestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { - authRequestPublisherSubject.eraseToAnyPublisher() - } - - /// Publisher that sends authentication responses - /// - /// App should subscribe for events in order to receive CACAO object with a signature matching authentication request. - /// - /// Emited result may be an error. - @available(*, deprecated, message: "Use SignClient for dApps and Web3Wallet interface for wallets instead.") - public var authResponsePublisher: AnyPublisher<(id: RPCID, result: Result), Never> { - authResponsePublisherSubject.eraseToAnyPublisher() - } - - /// Publisher that sends web socket connection status - @available(*, deprecated, message: "Use Web3Wallet interface for managing socket connection status.") - public let socketConnectionStatusPublisher: AnyPublisher - - /// An object that loggs SDK's errors and info messages - public let logger: ConsoleLogging - - // MARK: - Private Properties - - private let pairingRegisterer: PairingRegisterer - - private var authResponsePublisherSubject = PassthroughSubject<(id: RPCID, result: Result), Never>() - private var authRequestPublisherSubject = PassthroughSubject<(request: AuthRequest, context: VerifyContext?), Never>() - private let appRequestService: AppRequestService - private let appRespondSubscriber: AppRespondSubscriber - private let walletRequestSubscriber: WalletRequestSubscriber - private let walletRespondService: WalletRespondService - private let pendingRequestsProvider: Auth_PendingRequestsProvider - - init(appRequestService: AppRequestService, - appRespondSubscriber: AppRespondSubscriber, - walletRequestSubscriber: WalletRequestSubscriber, - walletRespondService: WalletRespondService, - pendingRequestsProvider: Auth_PendingRequestsProvider, - logger: ConsoleLogging, - socketConnectionStatusPublisher: AnyPublisher, - pairingRegisterer: PairingRegisterer - ) { - self.appRequestService = appRequestService - self.walletRequestSubscriber = walletRequestSubscriber - self.walletRespondService = walletRespondService - self.appRespondSubscriber = appRespondSubscriber - self.pendingRequestsProvider = pendingRequestsProvider - self.logger = logger - self.socketConnectionStatusPublisher = socketConnectionStatusPublisher - self.pairingRegisterer = pairingRegisterer - setUpPublishers() - } - - /// For a wallet to respond on authentication request - /// - Parameters: - /// - requestId: authentication request id - /// - signature: CACAO signature of requested message - @available(*, deprecated, message: "Use Web3Wallet interface for responding to authentication requests.") - public func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws { - try await walletRespondService.respond(requestId: requestId, signature: signature, account: account) - } - - /// For wallet to reject authentication request - /// - Parameter requestId: authentication request id - @available(*, deprecated, message: "Use Web3Wallet interface for rejecting authentication requests.") - public func reject(requestId: RPCID) async throws { - try await walletRespondService.respondError(requestId: requestId) - } - - /// Query pending authentication requests - /// - Returns: Pending authentication requests - @available(*, deprecated, message: "Use SignClient for managing pending authentication requests.") - public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { - return try pendingRequestsProvider.getPendingRequests() - } - - @available(*, deprecated, message: "Use SignClient or Web3Wallet for message formatting.") - public func formatMessage(payload: AuthPayloadStruct, address: String) throws -> String { - return try SIWEFromCacaoPayloadFormatter().formatMessage(from: payload.cacaoPayload(address: address)) - } - - private func setUpPublishers() { - appRespondSubscriber.onResponse = { [unowned self] (id, result) in - authResponsePublisherSubject.send((id, result)) - } - - walletRequestSubscriber.onRequest = { [unowned self] request in - authRequestPublisherSubject.send(request) - } - } -} diff --git a/Sources/Auth/AuthClientFactory.swift b/Sources/Auth/AuthClientFactory.swift deleted file mode 100644 index 59b902602..000000000 --- a/Sources/Auth/AuthClientFactory.swift +++ /dev/null @@ -1,68 +0,0 @@ -import Foundation - -public struct AuthClientFactory { - public static func create( - metadata: AppMetadata, - projectId: String, - crypto: CryptoProvider, - networkingClient: NetworkingInteractor, - pairingRegisterer: PairingRegisterer, - groupIdentifier: String - ) -> AuthClient { - let logger = ConsoleLogger(loggingLevel: .off) - guard let keyValueStorage = UserDefaults(suiteName: groupIdentifier) else { - fatalError("Could not instantiate UserDefaults for a group identifier \(groupIdentifier)") - } - let keychainStorage = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: groupIdentifier) - let iatProvider = DefaultIATProvider() - - return AuthClientFactory.create( - metadata: metadata, - projectId: projectId, - crypto: crypto, - logger: logger, - keyValueStorage: keyValueStorage, - keychainStorage: keychainStorage, - networkingClient: networkingClient, - pairingRegisterer: pairingRegisterer, - iatProvider: iatProvider - ) - } - - static func create( - metadata: AppMetadata, - projectId: String, - crypto: CryptoProvider, - logger: ConsoleLogging, - keyValueStorage: KeyValueStorage, - keychainStorage: KeychainStorageProtocol, - networkingClient: NetworkingInteractor, - pairingRegisterer: PairingRegisterer, - iatProvider: IATProvider - ) -> AuthClient { - let kms = KeyManagementService(keychain: keychainStorage) - let history = RPCHistoryFactory.createForNetwork(keyValueStorage: keyValueStorage) - let messageFormatter = SIWEFromCacaoPayloadFormatter() - let appRequestService = AppRequestService(networkingInteractor: networkingClient, kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider) - let verifyClient = VerifyClientFactory.create() - let verifyContextStore = CodableStore(defaults: keyValueStorage, identifier: VerifyStorageIdentifiers.context.rawValue) - let messageVerifierFactory = MessageVerifierFactory(crypto: crypto) - let signatureVerifier = messageVerifierFactory.create(projectId: projectId) - let appRespondSubscriber = AppRespondSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: history, signatureVerifier: signatureVerifier, pairingRegisterer: pairingRegisterer, messageFormatter: messageFormatter) - let walletErrorResponder = Auth_WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history) - let walletRequestSubscriber = WalletRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer, verifyClient: verifyClient, verifyContextStore: verifyContextStore) - let walletRespondService = WalletRespondService(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: history, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingRegisterer) - let pendingRequestsProvider = Auth_PendingRequestsProvider(rpcHistory: history, verifyContextStore: verifyContextStore) - - return AuthClient( - appRequestService: appRequestService, - appRespondSubscriber: appRespondSubscriber, - walletRequestSubscriber: walletRequestSubscriber, - walletRespondService: walletRespondService, - pendingRequestsProvider: pendingRequestsProvider, - logger: logger, - socketConnectionStatusPublisher: networkingClient.socketConnectionStatusPublisher, - pairingRegisterer: pairingRegisterer - ) - } -} diff --git a/Sources/Auth/AuthClientProtocol.swift b/Sources/Auth/AuthClientProtocol.swift deleted file mode 100644 index d74cdbb7f..000000000 --- a/Sources/Auth/AuthClientProtocol.swift +++ /dev/null @@ -1,11 +0,0 @@ -import Foundation -import Combine - -public protocol AuthClientProtocol { - var authRequestPublisher: AnyPublisher<(request: AuthRequest, context: VerifyContext?), Never> { get } - - func formatMessage(payload: AuthPayloadStruct, address: String) throws -> String - func respond(requestId: RPCID, signature: CacaoSignature, from account: Account) async throws - func reject(requestId: RPCID) async throws - func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] -} diff --git a/Sources/Auth/AuthConfig.swift b/Sources/Auth/AuthConfig.swift deleted file mode 100644 index 183617159..000000000 --- a/Sources/Auth/AuthConfig.swift +++ /dev/null @@ -1,7 +0,0 @@ -import Foundation - -extension Auth { - struct Config { - let crypto: CryptoProvider - } -} diff --git a/Sources/Auth/AuthImports.swift b/Sources/Auth/AuthImports.swift deleted file mode 100644 index 91463cad3..000000000 --- a/Sources/Auth/AuthImports.swift +++ /dev/null @@ -1,5 +0,0 @@ -#if !CocoaPods -@_exported import WalletConnectPairing -@_exported import WalletConnectSigner -@_exported import WalletConnectVerify -#endif diff --git a/Sources/Auth/AuthProtocolMethod.swift b/Sources/Auth/AuthProtocolMethod.swift deleted file mode 100644 index a3a56117f..000000000 --- a/Sources/Auth/AuthProtocolMethod.swift +++ /dev/null @@ -1,25 +0,0 @@ -import Foundation - -struct AuthRequestProtocolMethod: ProtocolMethod { - let method: String = "wc_authRequest" - - let requestConfig = RelayConfig(tag: 3000, prompt: true, ttl: 86400) - - let responseConfig = RelayConfig(tag: 3001, prompt: false, ttl: 86400) -} - -struct PairingPingProtocolMethod: ProtocolMethod { - let method: String = "wc_pairingPing" - - let requestConfig = RelayConfig(tag: 1002, prompt: false, ttl: 30) - - let responseConfig = RelayConfig(tag: 1003, prompt: false, ttl: 30) -} - -struct PairingDeleteProtocolMethod: ProtocolMethod { - let method: String = "wc_pairingDelete" - - let requestConfig = RelayConfig(tag: 1000, prompt: false, ttl: 86400) - - let responseConfig = RelayConfig(tag: 1001, prompt: false, ttl: 86400) -} diff --git a/Sources/Auth/Services/App/AppRequestService.swift b/Sources/Auth/Services/App/AppRequestService.swift deleted file mode 100644 index 325c515b5..000000000 --- a/Sources/Auth/Services/App/AppRequestService.swift +++ /dev/null @@ -1,34 +0,0 @@ -import Foundation - -actor AppRequestService { - private let networkingInteractor: NetworkInteracting - private let appMetadata: AppMetadata - private let kms: KeyManagementService - private let logger: ConsoleLogging - private let iatProvader: IATProvider - - init(networkingInteractor: NetworkInteracting, - kms: KeyManagementService, - appMetadata: AppMetadata, - logger: ConsoleLogging, - iatProvader: IATProvider) { - self.networkingInteractor = networkingInteractor - self.kms = kms - self.appMetadata = appMetadata - self.logger = logger - self.iatProvader = iatProvader - } - - func request(params: RequestParams, topic: String) async throws { - let pubKey = try kms.createX25519KeyPair() - let responseTopic = pubKey.rawRepresentation.sha256().toHexString() - let requester = Auth_RequestParams.Requester(publicKey: pubKey.hexRepresentation, metadata: appMetadata) - let payload = AuthPayloadStruct(requestParams: params, iat: iatProvader.iat) - let params = Auth_RequestParams(requester: requester, payloadParams: payload) - let request = RPCRequest(method: "wc_authRequest", params: params) - try kms.setPublicKey(publicKey: pubKey, for: responseTopic) - logger.debug("AppRequestService: Subscribibg for response topic: \(responseTopic)") - try await networkingInteractor.request(request, topic: topic, protocolMethod: AuthRequestProtocolMethod()) - try await networkingInteractor.subscribe(topic: responseTopic) - } -} diff --git a/Sources/Auth/Services/App/AppRespondSubscriber.swift b/Sources/Auth/Services/App/AppRespondSubscriber.swift deleted file mode 100644 index 405c2117a..000000000 --- a/Sources/Auth/Services/App/AppRespondSubscriber.swift +++ /dev/null @@ -1,73 +0,0 @@ -import Foundation -import Combine - -class AppRespondSubscriber { - private let networkingInteractor: NetworkInteracting - private let logger: ConsoleLogging - private let rpcHistory: RPCHistory - private let signatureVerifier: MessageVerifier - private let messageFormatter: SIWEFromCacaoPayloadFormatter - private let pairingRegisterer: PairingRegisterer - private var publishers = [AnyCancellable]() - - var onResponse: ((_ id: RPCID, _ result: Result) -> Void)? - - init(networkingInteractor: NetworkInteracting, - logger: ConsoleLogging, - rpcHistory: RPCHistory, - signatureVerifier: MessageVerifier, - pairingRegisterer: PairingRegisterer, - messageFormatter: SIWEFromCacaoPayloadFormatter) { - self.networkingInteractor = networkingInteractor - self.logger = logger - self.rpcHistory = rpcHistory - self.signatureVerifier = signatureVerifier - self.messageFormatter = messageFormatter - self.pairingRegisterer = pairingRegisterer - subscribeForResponse() - } - - private func subscribeForResponse() { - networkingInteractor.responseErrorSubscription(on: AuthRequestProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in - guard let error = AuthErrors(code: payload.error.code) else { return } - onResponse?(payload.id, .failure(error)) - }.store(in: &publishers) - - networkingInteractor.responseSubscription(on: AuthRequestProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - - networkingInteractor.unsubscribe(topic: payload.topic) - - let requestId = payload.id - let cacao = payload.response - let requestPayload = payload.request - - guard - let address = try? DIDPKH(did: cacao.p.iss).account.address, - let message = try? messageFormatter.formatMessage(from: cacao.p) - else { self.onResponse?(requestId, .failure(.malformedResponseParams)); return } - - guard - let recovered = try? messageFormatter.formatMessage( - from: requestPayload.payloadParams.cacaoPayload(address: address) - ), recovered == message - else { self.onResponse?(requestId, .failure(.messageCompromised)); return } - - Task(priority: .high) { - do { - try await signatureVerifier.verify( - signature: cacao.s, - message: message, - address: address, - chainId: requestPayload.payloadParams.chainId - ) - onResponse?(requestId, .success(cacao)) - } catch { - logger.error("Signature verification failed with: \(error.localizedDescription)") - onResponse?(requestId, .failure(.signatureVerificationFailed)) - } - } - }.store(in: &publishers) - } -} diff --git a/Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift b/Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift deleted file mode 100644 index f646835e4..000000000 --- a/Sources/Auth/Services/Wallet/Auth_PendingRequestsProvider.swift +++ /dev/null @@ -1,25 +0,0 @@ -import Foundation - -class Auth_PendingRequestsProvider { - private let rpcHistory: RPCHistory - private let verifyContextStore: CodableStore - - init( - rpcHistory: RPCHistory, - verifyContextStore: CodableStore - ) { - self.rpcHistory = rpcHistory - self.verifyContextStore = verifyContextStore - } - - public func getPendingRequests() throws -> [(AuthRequest, VerifyContext?)] { - let pendingRequests: [AuthRequest] = rpcHistory.getPending() - .filter {$0.request.method == "wc_authRequest"} - .compactMap { - guard let params = try? $0.request.params?.get(Auth_RequestParams.self) else { return nil } - return AuthRequest(id: $0.request.id!, topic: $0.topic, payload: params.payloadParams, requester: params.requester.metadata) - } - - return pendingRequests.map { ($0, try? verifyContextStore.get(key: $0.id.string)) } - } -} diff --git a/Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift b/Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift deleted file mode 100644 index 895f41d9d..000000000 --- a/Sources/Auth/Services/Wallet/Auth_WalletErrorResponder.swift +++ /dev/null @@ -1,52 +0,0 @@ -import Foundation - -actor Auth_WalletErrorResponder { - enum Errors: Error { - case recordForIdNotFound - case malformedAuthRequestParams - } - - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - private let rpcHistory: RPCHistory - private let logger: ConsoleLogging - - init(networkingInteractor: NetworkInteracting, - logger: ConsoleLogging, - kms: KeyManagementServiceProtocol, - rpcHistory: RPCHistory) { - self.networkingInteractor = networkingInteractor - self.logger = logger - self.kms = kms - self.rpcHistory = rpcHistory - } - - func respondError(_ error: AuthErrors, requestId: RPCID) async throws { - let authRequestParams = try getAuthRequestParams(requestId: requestId) - let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) - - try kms.setAgreementSecret(keys, topic: topic) - - let envelopeType = Envelope.EnvelopeType.type1(pubKey: keys.publicKey.rawRepresentation) - try await networkingInteractor.respondError(topic: topic, requestId: requestId, protocolMethod: AuthRequestProtocolMethod(), reason: error, envelopeType: envelopeType) - } - - private func getAuthRequestParams(requestId: RPCID) throws -> Auth_RequestParams { - guard let request = rpcHistory.get(recordId: requestId)?.request - else { throw Errors.recordForIdNotFound } - - guard let authRequestParams = try request.params?.get(Auth_RequestParams.self) - else { throw Errors.malformedAuthRequestParams } - - return authRequestParams - } - - private func generateAgreementKeys(requestParams: Auth_RequestParams) throws -> (topic: String, keys: AgreementKeys) { - let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) - let topic = peerPubKey.rawRepresentation.sha256().toHexString() - let selfPubKey = try kms.createX25519KeyPair() - let keys = try kms.performKeyAgreement(selfPublicKey: selfPubKey, peerPublicKey: peerPubKey.hexRepresentation) - // TODO - remove keys - return (topic, keys) - } -} diff --git a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift b/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift deleted file mode 100644 index c8697ec5d..000000000 --- a/Sources/Auth/Services/Wallet/WalletRequestSubscriber.swift +++ /dev/null @@ -1,60 +0,0 @@ -import Foundation -import Combine - -class WalletRequestSubscriber { - private let networkingInteractor: NetworkInteracting - private let logger: ConsoleLogging - private let kms: KeyManagementServiceProtocol - private var publishers = [AnyCancellable]() - private let walletErrorResponder: Auth_WalletErrorResponder - private let pairingRegisterer: PairingRegisterer - private let verifyClient: VerifyClientProtocol - private let verifyContextStore: CodableStore - - var onRequest: (((request: AuthRequest, context: VerifyContext?)) -> Void)? - - init( - networkingInteractor: NetworkInteracting, - logger: ConsoleLogging, - kms: KeyManagementServiceProtocol, - walletErrorResponder: Auth_WalletErrorResponder, - pairingRegisterer: PairingRegisterer, - verifyClient: VerifyClientProtocol, - verifyContextStore: CodableStore - ) { - self.networkingInteractor = networkingInteractor - self.logger = logger - self.kms = kms - self.walletErrorResponder = walletErrorResponder - self.pairingRegisterer = pairingRegisterer - self.verifyClient = verifyClient - self.verifyContextStore = verifyContextStore - subscribeForRequest() - } - - private func subscribeForRequest() { - pairingRegisterer.register(method: AuthRequestProtocolMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in - logger.debug("WalletRequestSubscriber: Received request") - - pairingRegisterer.setReceived(pairingTopic: payload.topic) - - let request = AuthRequest(id: payload.id, topic: payload.topic, payload: payload.request.payloadParams, requester: payload.request.requester.metadata) - - Task(priority: .high) { - let assertionId = payload.decryptedPayload.sha256().toHexString() - do { - let response = try await verifyClient.verify(.v1(assertionId: assertionId)) - let verifyContext = verifyClient.createVerifyContext(origin: response.origin, domain: payload.request.payloadParams.domain, isScam: response.isScam, isVerified: nil) - verifyContextStore.set(verifyContext, forKey: request.id.string) - onRequest?((request, verifyContext)) - } catch { - let verifyContext = verifyClient.createVerifyContext(origin: nil, domain: payload.request.payloadParams.domain, isScam: nil, isVerified: nil) - verifyContextStore.set(verifyContext, forKey: request.id.string) - onRequest?((request, verifyContext)) - return - } - } - }.store(in: &publishers) - } -} diff --git a/Sources/Auth/Services/Wallet/WalletRespondService.swift b/Sources/Auth/Services/Wallet/WalletRespondService.swift deleted file mode 100644 index 529ef2a79..000000000 --- a/Sources/Auth/Services/Wallet/WalletRespondService.swift +++ /dev/null @@ -1,77 +0,0 @@ -import Foundation - -actor WalletRespondService { - enum Errors: Error { - case recordForIdNotFound - case malformedAuthRequestParams - } - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementService - private let rpcHistory: RPCHistory - private let verifyContextStore: CodableStore - private let logger: ConsoleLogging - private let walletErrorResponder: Auth_WalletErrorResponder - private let pairingRegisterer: PairingRegisterer - - init( - networkingInteractor: NetworkInteracting, - logger: ConsoleLogging, - kms: KeyManagementService, - rpcHistory: RPCHistory, - verifyContextStore: CodableStore, - walletErrorResponder: Auth_WalletErrorResponder, - pairingRegisterer: PairingRegisterer - ) { - self.networkingInteractor = networkingInteractor - self.logger = logger - self.kms = kms - self.rpcHistory = rpcHistory - self.verifyContextStore = verifyContextStore - self.walletErrorResponder = walletErrorResponder - self.pairingRegisterer = pairingRegisterer - } - - func respond(requestId: RPCID, signature: CacaoSignature, account: Account) async throws { - let authRequestParams = try getAuthRequestParams(requestId: requestId) - let (topic, keys) = try generateAgreementKeys(requestParams: authRequestParams) - - try kms.setAgreementSecret(keys, topic: topic) - - let header = CacaoHeader(t: "eip4361") - let payload = try authRequestParams.payloadParams.cacaoPayload(address: account.address) - let responseParams = AuthResponseParams(h: header, p: payload, s: signature) - - let response = RPCResponse(id: requestId, result: responseParams) - try await networkingInteractor.respond(topic: topic, response: response, protocolMethod: AuthRequestProtocolMethod(), envelopeType: .type1(pubKey: keys.publicKey.rawRepresentation)) - - pairingRegisterer.activate( - pairingTopic: topic, - peerMetadata: authRequestParams.requester.metadata - ) - - verifyContextStore.delete(forKey: requestId.string) - } - - func respondError(requestId: RPCID) async throws { - try await walletErrorResponder.respondError(AuthErrors.userRejeted, requestId: requestId) - verifyContextStore.delete(forKey: requestId.string) - } - - private func getAuthRequestParams(requestId: RPCID) throws -> Auth_RequestParams { - guard let request = rpcHistory.get(recordId: requestId)?.request - else { throw Errors.recordForIdNotFound } - - guard let authRequestParams = try request.params?.get(Auth_RequestParams.self) - else { throw Errors.malformedAuthRequestParams } - - return authRequestParams - } - - private func generateAgreementKeys(requestParams: Auth_RequestParams) throws -> (topic: String, keys: AgreementKeys) { - let peerPubKey = try AgreementPublicKey(hex: requestParams.requester.publicKey) - let topic = peerPubKey.rawRepresentation.sha256().toHexString() - let selfPubKey = try kms.createX25519KeyPair() - let keys = try kms.performKeyAgreement(selfPublicKey: selfPubKey, peerPublicKey: peerPubKey.hexRepresentation) - return (topic, keys) - } -} diff --git a/Sources/Auth/Types/AuthPayloadStruct.swift b/Sources/Auth/Types/AuthPayloadStruct.swift deleted file mode 100644 index b7a1494c4..000000000 --- a/Sources/Auth/Types/AuthPayloadStruct.swift +++ /dev/null @@ -1,59 +0,0 @@ -import Foundation - -public struct AuthPayloadStruct: Codable, Equatable { - public let domain: String - public let aud: String - public let version: String - public let nonce: String - public let chainId: String - public let type: String - public let iat: String - public let nbf: String? - public let exp: String? - public let statement: String? - public let requestId: String? - public let resources: [String]? - - init(requestParams: RequestParams, iat: String) { - self.type = "eip4361" - self.chainId = requestParams.chainId - self.domain = requestParams.domain - self.aud = requestParams.aud - self.version = "1" - self.nonce = requestParams.nonce - self.iat = iat - self.nbf = requestParams.nbf - self.exp = requestParams.exp - self.statement = requestParams.statement - self.requestId = requestParams.requestId - self.resources = requestParams.resources - } - - public func cacaoPayload(address: String) throws -> CacaoPayload { - guard - let blockchain = Blockchain(chainId), - let account = Account(blockchain: blockchain, address: address) else { - throw Errors.invalidChainID - } - return CacaoPayload( - iss: account.did, - domain: domain, - aud: aud, - version: version, - nonce: nonce, - iat: iat, - nbf: nbf, - exp: exp, - statement: statement, - requestId: requestId, - resources: resources - ) - } -} - -private extension AuthPayloadStruct { - - enum Errors: Error { - case invalidChainID - } -} diff --git a/Sources/Auth/Types/AuthRespondParams.swift b/Sources/Auth/Types/AuthRespondParams.swift deleted file mode 100644 index fce3414eb..000000000 --- a/Sources/Auth/Types/AuthRespondParams.swift +++ /dev/null @@ -1,11 +0,0 @@ -import Foundation - -public struct AuthRespondParams: Equatable { - let id: RPCID - let signature: CacaoSignature - - public init(id: RPCID, signature: CacaoSignature) { - self.id = id - self.signature = signature - } -} diff --git a/Sources/Auth/Types/Errors/AuthErrors.swift b/Sources/Auth/Types/Errors/AuthErrors.swift deleted file mode 100644 index 9cfda6bd1..000000000 --- a/Sources/Auth/Types/Errors/AuthErrors.swift +++ /dev/null @@ -1,72 +0,0 @@ -import Foundation - -/// Authentication error -public enum AuthErrors: Codable, Equatable, Error { - case methodUnsupported - case userDisconnected - case userRejeted - case malformedResponseParams - case malformedRequestParams - case messageCompromised - case signatureVerificationFailed -} - -extension AuthErrors: Reason { - - init?(code: Int) { - switch code { - case Self.methodUnsupported.code: - self = .methodUnsupported - case Self.userRejeted.code: - self = .userRejeted - case Self.malformedResponseParams.code: - self = .malformedResponseParams - case Self.malformedRequestParams.code: - self = .malformedRequestParams - case Self.messageCompromised.code: - self = .messageCompromised - case Self.signatureVerificationFailed.code: - self = .signatureVerificationFailed - default: - return nil - } - } - - public var code: Int { - switch self { - case .methodUnsupported: - return 10001 - case .userDisconnected: - return 6000 - case .userRejeted: - return 14001 - case .malformedResponseParams: - return 12001 - case .malformedRequestParams: - return 12002 - case .messageCompromised: - return 12003 - case .signatureVerificationFailed: - return 12004 - } - } - - public var message: String { - switch self { - case .methodUnsupported: - return "Method Unsupported" - case .userRejeted: - return "Auth request rejected by user" - case .malformedResponseParams: - return "Response params malformed" - case .malformedRequestParams: - return "Request params malformed" - case .messageCompromised: - return "Original message compromised" - case .signatureVerificationFailed: - return "Message verification failed" - case .userDisconnected: - return "User Disconnected" - } - } -} diff --git a/Sources/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift b/Sources/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift deleted file mode 100644 index e2d097c01..000000000 --- a/Sources/Auth/Types/ProtocolRPCParams/AuthResponseParams.swift +++ /dev/null @@ -1,4 +0,0 @@ -import Foundation - -/// wc_authRequest RPC method respond param -typealias AuthResponseParams = Cacao diff --git a/Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift b/Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift deleted file mode 100644 index 4a72728ed..000000000 --- a/Sources/Auth/Types/ProtocolRPCParams/Auth_RequestParams.swift +++ /dev/null @@ -1,14 +0,0 @@ -import Foundation - -/// wc_authRequest RPC method request param -struct Auth_RequestParams: Codable, Equatable { - let requester: Requester - let payloadParams: AuthPayloadStruct -} - -extension Auth_RequestParams { - struct Requester: Codable, Equatable { - let publicKey: String - let metadata: AppMetadata - } -} diff --git a/Sources/Auth/Types/Public/AuthRequest.swift b/Sources/Auth/Types/Public/AuthRequest.swift deleted file mode 100644 index 63e553cc5..000000000 --- a/Sources/Auth/Types/Public/AuthRequest.swift +++ /dev/null @@ -1,8 +0,0 @@ -import Foundation - -public struct AuthRequest: Equatable, Codable { - public let id: RPCID - public let topic: String - public let payload: AuthPayloadStruct - public let requester: AppMetadata -} diff --git a/Sources/Auth/Types/RequestParams.swift b/Sources/Auth/Types/RequestParams.swift deleted file mode 100644 index 1f57884a9..000000000 --- a/Sources/Auth/Types/RequestParams.swift +++ /dev/null @@ -1,39 +0,0 @@ -import Foundation - -/// Parameters required to construct authentication request -/// for details read CAIP-74 and EIP-4361 specs -/// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-74.md -/// https://eips.ethereum.org/EIPS/eip-4361 -public struct RequestParams { - public let domain: String - public let chainId: String - public let nonce: String - public let aud: String - public let nbf: String? - public let exp: String? - public let statement: String? - public let requestId: String? - public let resources: [String]? - - public init( - domain: String, - chainId: String, - nonce: String, - aud: String, - nbf: String?, - exp: String?, - statement: String?, - requestId: String?, - resources: [String]? - ) { - self.domain = domain - self.chainId = chainId - self.nonce = nonce - self.aud = aud - self.nbf = nbf - self.exp = exp - self.statement = statement - self.requestId = requestId - self.resources = resources - } -} From 8b20fd2e3c4825b2c117717a7f150b83a38b18f2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:38:14 +0200 Subject: [PATCH 721/814] remove irrelevant test --- .../AppProposalServiceTests.swift | 28 ------------------- 1 file changed, 28 deletions(-) diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index ae3a4772d..6e493ba9a 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -161,32 +161,4 @@ final class AppProposalServiceTests: XCTestCase { XCTAssertFalse(cryptoMock.hasSymmetricKey(for: pairing.topic), "Proposer must delete symmetric key if pairing is inactive.") XCTAssertFalse(cryptoMock.hasPrivateKey(for: proposal.proposer.publicKey), "Proposer must remove private key for rejected session") } - - func testSessionProposeErrorOnActivePairing() async { - let uri = try! await appPairService.create(supportedMethods: nil) - let pairing = storageMock.getPairing(forTopic: uri.topic)! - let topicA = pairing.topic - let relayOptions = RelayProtocolOptions(protocol: "", data: nil) - - // Client propose session - // FIXME: namespace stub - try? await service.propose(pairingTopic: pairing.topic, namespaces: ProposalNamespace.stubDictionary(), relay: relayOptions) - - guard let request = networkingInteractor.requests.first?.request, - let proposal = try? networkingInteractor.requests.first?.request.params?.get(SessionType.ProposeParams.self) else { - XCTFail("Proposer must publish session proposal request"); return - } - - var storedPairing = storageMock.getPairing(forTopic: topicA)! - storedPairing.activate() - storageMock.setPairing(storedPairing) - - let response = RPCResponse.stubError(forRequest: request) - networkingInteractor.responsePublisherSubject.send((topicA, request, response, Date(), nil)) - - XCTAssertFalse(networkingInteractor.didUnsubscribe(to: pairing.topic), "Proposer must not unsubscribe if pairing is active.") - XCTAssert(storageMock.hasPairing(forTopic: pairing.topic), "Proposer must not delete an active pairing.") - XCTAssert(cryptoMock.hasSymmetricKey(for: pairing.topic), "Proposer must not delete symmetric key if pairing is active.") - XCTAssertFalse(cryptoMock.hasPrivateKey(for: proposal.proposer.publicKey), "Proposer must remove private key for rejected session") - } } From 47c69d22fcb3596d327e087a8bdc8a6c53e101ac Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:41:43 +0200 Subject: [PATCH 722/814] remove irrelevant tests --- .../AppPairActivationServiceTests.swift | 42 -------- .../AppPairServiceTests.swift | 1 - .../WCPairingTests.swift | 102 ------------------ 3 files changed, 145 deletions(-) delete mode 100644 Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift delete mode 100644 Tests/WalletConnectPairingTests/WCPairingTests.swift diff --git a/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift b/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift deleted file mode 100644 index 601862ad6..000000000 --- a/Tests/WalletConnectPairingTests/AppPairActivationServiceTests.swift +++ /dev/null @@ -1,42 +0,0 @@ -import XCTest -@testable import WalletConnectPairing -@testable import TestingUtils -import WalletConnectUtils - -final class AppPairActivationServiceTests: XCTestCase { - - var service: AppPairActivationService! - var storageMock: WCPairingStorage! - var logger: ConsoleLogger! - - override func setUp() { - storageMock = WCPairingStorageMock() - logger = ConsoleLogger() - service = AppPairActivationService(pairingStorage: storageMock, logger: logger) - } - - override func tearDown() { - storageMock = nil - logger = nil - service = nil - } - - func testActivate() { - let pairing = WCPairing(uri: WalletConnectURI.stub()) - let topic = pairing.topic - let date = pairing.expiryDate - - storageMock.setPairing(pairing) - - XCTAssertFalse(pairing.active) - XCTAssertNil(pairing.peerMetadata) - - service.activate(for: topic, peerMetadata: .stub()) - - let activated = storageMock.getPairing(forTopic: topic)! - - XCTAssertTrue(activated.active) - XCTAssertNotNil(activated.peerMetadata) - XCTAssertTrue(activated.expiryDate > date) - } -} diff --git a/Tests/WalletConnectPairingTests/AppPairServiceTests.swift b/Tests/WalletConnectPairingTests/AppPairServiceTests.swift index 9839d5192..304bb2697 100644 --- a/Tests/WalletConnectPairingTests/AppPairServiceTests.swift +++ b/Tests/WalletConnectPairingTests/AppPairServiceTests.swift @@ -30,6 +30,5 @@ final class AppPairServiceTests: XCTestCase { XCTAssert(cryptoMock.hasSymmetricKey(for: uri.topic), "Proposer must store the symmetric key matching the URI.") XCTAssert(storageMock.hasPairing(forTopic: uri.topic), "The engine must store a pairing after creating one") XCTAssert(networkingInteractor.didSubscribe(to: uri.topic), "Proposer must subscribe to pairing topic.") - XCTAssert(storageMock.getPairing(forTopic: uri.topic)?.active == false, "Recently created pairing must be inactive.") } } diff --git a/Tests/WalletConnectPairingTests/WCPairingTests.swift b/Tests/WalletConnectPairingTests/WCPairingTests.swift deleted file mode 100644 index 8565b5bfa..000000000 --- a/Tests/WalletConnectPairingTests/WCPairingTests.swift +++ /dev/null @@ -1,102 +0,0 @@ -import XCTest -@testable import WalletConnectPairing -@testable import WalletConnectUtils -@testable import WalletConnectUtils - -final class WCPairingTests: XCTestCase { - - var referenceDate: Date! - - override func setUp() { - referenceDate = Date() - func getDate() -> Date { return referenceDate } - WCPairing.dateInitializer = getDate - } - - override func tearDown() { - WCPairing.dateInitializer = Date.init - } - - func testAbsoluteValues() { - XCTAssertEqual(WCPairing.timeToLiveInactive, 5 * .minute, "Inactive time-to-live is 5 minutes.") - XCTAssertEqual(WCPairing.timeToLiveActive, 30 * .day, "Active time-to-live is 30 days.") - } - - func testInitInactiveFromTopic() { - let pairing = WCPairing(uri: WalletConnectURI.stub()) - let inactiveExpiry = referenceDate.advanced(by: WCPairing.timeToLiveInactive) - XCTAssertFalse(pairing.active) - XCTAssertEqual(pairing.expiryDate.timeIntervalSince1970, inactiveExpiry.timeIntervalSince1970, accuracy: 1) - } - - func testInitInactiveFromURI() { - let pairing = WCPairing(uri: WalletConnectURI.stub()) - let inactiveExpiry = referenceDate.advanced(by: WCPairing.timeToLiveInactive) - XCTAssertFalse(pairing.active) - XCTAssertEqual(pairing.expiryDate.timeIntervalSince1970, inactiveExpiry.timeIntervalSince1970, accuracy: 1) - } - - func testUpdateExpiryForTopic() { - var pairing = WCPairing(uri: WalletConnectURI.stub()) - let activeExpiry = referenceDate.advanced(by: WCPairing.timeToLiveActive) - try? pairing.updateExpiry() - XCTAssertEqual(pairing.expiryDate, activeExpiry) - } - - func testUpdateExpiryForUri() { - var pairing = WCPairing(uri: WalletConnectURI.stub()) - let activeExpiry = referenceDate.advanced(by: WCPairing.timeToLiveActive) - try? pairing.updateExpiry() - XCTAssertEqual(pairing.expiryDate, activeExpiry) - } - - func testActivateTopic() { - var pairing = WCPairing(uri: WalletConnectURI.stub()) - let activeExpiry = referenceDate.advanced(by: WCPairing.timeToLiveActive) - XCTAssertFalse(pairing.active) - pairing.activate() - XCTAssertTrue(pairing.active) - XCTAssertEqual(pairing.expiryDate, activeExpiry) - } - - func testActivateURI() { - var pairing = WCPairing(uri: WalletConnectURI.stub()) - let activeExpiry = referenceDate.advanced(by: WCPairing.timeToLiveActive) - XCTAssertFalse(pairing.active) - pairing.activate() - XCTAssertTrue(pairing.active) - XCTAssertEqual(pairing.expiryDate, activeExpiry) - } - - func testUpdateExpiryWhenValueIsGreaterThanMax() { - var pairing = WCPairing(topic: "", relay: .stub(), peerMetadata: .stub(), expiryDate: referenceDate) - XCTAssertThrowsError(try pairing.updateExpiry(40 * .day)) { error in - XCTAssertEqual(error as! WCPairing.Errors, WCPairing.Errors.invalidUpdateExpiryValue) - } - } - - func testUpdateExpiryWhenNewExpiryDateIsLessThanExpiryDate() { - let expiryDate = referenceDate.advanced(by: 40 * .day) - var pairing = WCPairing(topic: "", relay: .stub(), peerMetadata: .stub(), expiryDate: expiryDate) - XCTAssertThrowsError(try pairing.updateExpiry(10 * .minute)) { error in - XCTAssertEqual(error as! WCPairing.Errors, WCPairing.Errors.invalidUpdateExpiryValue) - } - } - - func testActivateWhenCanUpdateExpiry() { - var pairing = WCPairing(topic: "", relay: .stub(), peerMetadata: .stub(), expiryDate: referenceDate) - XCTAssertFalse(pairing.active) - pairing.activate() - XCTAssertTrue(pairing.active) - XCTAssertEqual(referenceDate.advanced(by: 30 * .day), pairing.expiryDate) - } - - func testActivateWhenUpdateExpiryIsInvalid() { - let expiryDate = referenceDate.advanced(by: 40 * .day) - var pairing = WCPairing(topic: "", relay: .stub(), peerMetadata: .stub(), expiryDate: expiryDate) - XCTAssertFalse(pairing.active) - pairing.activate() - XCTAssertTrue(pairing.active) - XCTAssertEqual(expiryDate, pairing.expiryDate) - } -} From 25bc2981d5b965c4fe3d5111e48885705f2919b0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:46:13 +0200 Subject: [PATCH 723/814] fix sign tests --- Tests/TestingUtils/Mocks/PairingRegistererMock.swift | 5 ----- Tests/WalletConnectSignTests/AppProposalServiceTests.swift | 3 --- Tests/WalletConnectSignTests/ApproveEngineTests.swift | 1 - 3 files changed, 9 deletions(-) diff --git a/Tests/TestingUtils/Mocks/PairingRegistererMock.swift b/Tests/TestingUtils/Mocks/PairingRegistererMock.swift index 052b9ca43..36915f594 100644 --- a/Tests/TestingUtils/Mocks/PairingRegistererMock.swift +++ b/Tests/TestingUtils/Mocks/PairingRegistererMock.swift @@ -6,16 +6,11 @@ import WalletConnectNetworking public class PairingRegistererMock: PairingRegisterer where RequestParams: Codable { public let subject = PassthroughSubject, Never>() - public var isActivateCalled: Bool = false public var isReceivedCalled: Bool = false public func register(method: ProtocolMethod) -> AnyPublisher, Never> where RequestParams: Decodable, RequestParams: Encodable { subject.eraseToAnyPublisher() as! AnyPublisher, Never> } - - public func activate(pairingTopic: String, peerMetadata: WalletConnectPairing.AppMetadata?) { - isActivateCalled = true - } public func setReceived(pairingTopic: String) { isReceivedCalled = true diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index 6e493ba9a..54e01da15 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -128,7 +128,6 @@ final class AppProposalServiceTests: XCTestCase { networkingInteractor.responsePublisherSubject.send((topicA, request, response, Date(), nil)) let privateKey = try! cryptoMock.getPrivateKey(for: proposal.proposer.publicKey)! let topicB = deriveTopic(publicKey: responder.publicKey, privateKey: privateKey) - _ = storageMock.getPairing(forTopic: topicA)! await fulfillment(of: [exp], timeout: 5) @@ -156,8 +155,6 @@ final class AppProposalServiceTests: XCTestCase { let response = RPCResponse.stubError(forRequest: request) networkingInteractor.responsePublisherSubject.send((topicA, request, response, Date(), nil)) - XCTAssert(networkingInteractor.didUnsubscribe(to: pairing.topic), "Proposer must unsubscribe if pairing is inactive.") - XCTAssertFalse(storageMock.hasPairing(forTopic: pairing.topic), "Proposer must delete an inactive pairing.") XCTAssertFalse(cryptoMock.hasSymmetricKey(for: pairing.topic), "Proposer must delete symmetric key if pairing is inactive.") XCTAssertFalse(cryptoMock.hasPrivateKey(for: proposal.proposer.publicKey), "Proposer must remove private key for rejected session") } diff --git a/Tests/WalletConnectSignTests/ApproveEngineTests.swift b/Tests/WalletConnectSignTests/ApproveEngineTests.swift index 1d36d7902..552c8b1aa 100644 --- a/Tests/WalletConnectSignTests/ApproveEngineTests.swift +++ b/Tests/WalletConnectSignTests/ApproveEngineTests.swift @@ -83,7 +83,6 @@ final class ApproveEngineTests: XCTestCase { XCTAssert(cryptoMock.hasAgreementSecret(for: topicB), "Responder must store agreement key for topic B") XCTAssertEqual(networkingInteractor.didRespondOnTopic!, topicA, "Responder must respond on topic A") XCTAssertTrue(sessionStorageMock.hasSession(forTopic: topicB), "Responder must persist session on topic B") - XCTAssertTrue(pairingRegisterer.isActivateCalled) } func testReceiveProposal() { From 2674ef4a75aa96a80c9d2839e6023ce4d9f6c2d8 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:54:56 +0200 Subject: [PATCH 724/814] fix test --- Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 4 +--- Tests/WalletConnectSignTests/AppProposalServiceTests.swift | 1 + 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index c02f1ae95..70aa776e6 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -344,9 +344,7 @@ private extension ApproveEngine { } func handleSessionProposeResponseError(payload: ResponseSubscriptionErrorPayload) { - Task { - removePairing(pairingTopic: payload.topic) - } + removePairing(pairingTopic: payload.topic) logger.debug("Session Proposal has been rejected") kms.deletePrivateKey(for: payload.request.proposer.publicKey) diff --git a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift index 54e01da15..d11d3644c 100644 --- a/Tests/WalletConnectSignTests/AppProposalServiceTests.swift +++ b/Tests/WalletConnectSignTests/AppProposalServiceTests.swift @@ -155,6 +155,7 @@ final class AppProposalServiceTests: XCTestCase { let response = RPCResponse.stubError(forRequest: request) networkingInteractor.responsePublisherSubject.send((topicA, request, response, Date(), nil)) + XCTAssertFalse(storageMock.hasPairing(forTopic: pairing.topic), "Proposer must delete the pairing.") XCTAssertFalse(cryptoMock.hasSymmetricKey(for: pairing.topic), "Proposer must delete symmetric key if pairing is inactive.") XCTAssertFalse(cryptoMock.hasPrivateKey(for: proposal.proposer.publicKey), "Proposer must remove private key for rejected session") } From 12f24eacc52a01eb96210c3a3e27d0669b3a79ff Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 16 Aug 2024 12:56:18 +0200 Subject: [PATCH 725/814] fix modal tests --- .../Mocks/ModalSheetInteractorMock.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift index e22c5d5f3..216685982 100644 --- a/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift +++ b/Tests/WalletConnectModalTests/Mocks/ModalSheetInteractorMock.swift @@ -17,7 +17,7 @@ final class ModalSheetInteractorMock: ModalSheetInteractor { (1, wallets) } - func createPairingAndConnect() async throws -> WalletConnectURI? { + func createPairingAndConnect() async throws -> WalletConnectURI { .init(topic: "foo", symKey: "bar", relay: .init(protocol: "irn", data: nil), expiryTimestamp: 1706001526) } From 34e0bac25a233ee3eed0a36db2a00992a3441a26 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Aug 2024 07:14:39 +0200 Subject: [PATCH 726/814] remove comment --- Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift | 1 - 1 file changed, 1 deletion(-) diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 70aa776e6..0c8d7530b 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -188,7 +188,6 @@ final class ApproveEngine { reason: reason ) - // todo - delete and unsubscribe if let pairingTopic = rpcHistory.get(recordId: payload.id)?.topic { Task { removePairing(pairingTopic: pairingTopic) From 969a002db68e709f048b6d4a819003643cbe3dde Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Aug 2024 08:41:25 +0200 Subject: [PATCH 727/814] reorder methods execution --- .../Sign/SignClientTests.swift | 2 ++ .../Engine/Common/ApproveEngine.swift | 22 ++++++++++--------- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 4575da2db..6cec32d42 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -89,6 +89,7 @@ final class SignClientTests: XCTestCase { } func testSessionPropose() async throws { + //start measuring here let dappSettlementExpectation = expectation(description: "Dapp expects to settle a session") let walletSettlementExpectation = expectation(description: "Wallet expects to settle a session") let requiredNamespaces = ProposalNamespace.stubRequired() @@ -104,6 +105,7 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) dapp.sessionSettlePublisher.sink { _ in + //end measuring here dappSettlementExpectation.fulfill() }.store(in: &publishers) wallet.sessionSettlePublisher.sink { _ in diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 0c8d7530b..1b2dc96d4 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -149,23 +149,25 @@ final class ApproveEngine { pairingTopic: pairingTopic ) - do { - _ = try await proposeResponseTask - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.responseApproveSent) - } catch { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) - throw error - } - do { let session: WCSession = try await settleRequestTask + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionSettleSuccess) + logger.debug("Session settle request has been successfully processed") + + do { + _ = try await proposeResponseTask + eventsClient.saveEvent(SessionApproveExecutionTraceEvents.responseApproveSent) + } catch { + eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) + throw error + } + sessionStore.setSession(session) + Task { removePairing(pairingTopic: pairingTopic) } onSessionSettle?(session.publicRepresentation()) - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionSettleSuccess) - logger.debug("Session proposal response and settle request have been sent") proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) From f5e3d114e53cf00b91f2e3e458ef78484eaf8532 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Aug 2024 12:00:17 +0200 Subject: [PATCH 728/814] savepoint --- Example/DApp/Modules/Sign/SignPresenter.swift | 7 ++ Example/ExampleApp.xcodeproj/project.pbxproj | 4 -- .../ConnectionDetailsInteractor.swift | 9 --- .../ConnectionDetailsModule.swift | 2 - .../ConnectionDetailsPresenter.swift | 66 +++++++++++++++++-- .../ConnectionDetailsView.swift | 9 +++ 6 files changed, 77 insertions(+), 20 deletions(-) delete mode 100644 Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 0b2e86e7d..85541d69e 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -169,6 +169,13 @@ extension SignPresenter { } .store(in: &subscriptions) + Sign.instance.sessionUpdatePublisher + .receive(on: DispatchQueue.main) + .sink { [unowned self] (topic, namespace) in + print(namespace) + } + .store(in: &subscriptions) + Sign.instance.authResponsePublisher .receive(on: DispatchQueue.main) .sink { [unowned self] response in diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index a984e0a53..f7829209b 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -314,7 +314,6 @@ C5DD5BE1294E09E3008FD3A4 /* Web3Wallet in Frameworks */ = {isa = PBXBuildFile; productRef = C5DD5BE0294E09E3008FD3A4 /* Web3Wallet */; }; C5F32A2C2954814200A6476E /* ConnectionDetailsModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5F32A2B2954814200A6476E /* ConnectionDetailsModule.swift */; }; C5F32A2E2954814A00A6476E /* ConnectionDetailsRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5F32A2D2954814A00A6476E /* ConnectionDetailsRouter.swift */; }; - C5F32A302954816100A6476E /* ConnectionDetailsInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5F32A2F2954816100A6476E /* ConnectionDetailsInteractor.swift */; }; C5F32A322954816C00A6476E /* ConnectionDetailsPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5F32A312954816C00A6476E /* ConnectionDetailsPresenter.swift */; }; C5F32A342954817600A6476E /* ConnectionDetailsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C5F32A332954817600A6476E /* ConnectionDetailsView.swift */; }; C5F32A362954FE3C00A6476E /* Colors.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C5F32A352954FE3C00A6476E /* Colors.xcassets */; }; @@ -654,7 +653,6 @@ C5BE021A2AF79B960064FC88 /* SessionAccountModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SessionAccountModule.swift; sourceTree = ""; }; C5F32A2B2954814200A6476E /* ConnectionDetailsModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConnectionDetailsModule.swift; sourceTree = ""; }; C5F32A2D2954814A00A6476E /* ConnectionDetailsRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConnectionDetailsRouter.swift; sourceTree = ""; }; - C5F32A2F2954816100A6476E /* ConnectionDetailsInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConnectionDetailsInteractor.swift; sourceTree = ""; }; C5F32A312954816C00A6476E /* ConnectionDetailsPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConnectionDetailsPresenter.swift; sourceTree = ""; }; C5F32A332954817600A6476E /* ConnectionDetailsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConnectionDetailsView.swift; sourceTree = ""; }; C5F32A352954FE3C00A6476E /* Colors.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Colors.xcassets; sourceTree = ""; }; @@ -1805,7 +1803,6 @@ children = ( C5F32A2B2954814200A6476E /* ConnectionDetailsModule.swift */, C5F32A2D2954814A00A6476E /* ConnectionDetailsRouter.swift */, - C5F32A2F2954816100A6476E /* ConnectionDetailsInteractor.swift */, C5F32A312954816C00A6476E /* ConnectionDetailsPresenter.swift */, C5F32A332954817600A6476E /* ConnectionDetailsView.swift */, ); @@ -2533,7 +2530,6 @@ C55D34AF2965FB750004314A /* SessionProposalPresenter.swift in Sources */, A5D610D22AB35B1100C20083 /* Listings.swift in Sources */, A5B4F7C82ABB21190099AF7C /* CacheAsyncImage.swift in Sources */, - C5F32A302954816100A6476E /* ConnectionDetailsInteractor.swift in Sources */, 847BD1E8298A806800076C90 /* NotificationsView.swift in Sources */, ); runOnlyForDeploymentPostprocessing = 0; diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift deleted file mode 100644 index aafd41678..000000000 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsInteractor.swift +++ /dev/null @@ -1,9 +0,0 @@ -import Combine - -import Web3Wallet - -final class ConnectionDetailsInteractor { - func disconnectSession(session: Session) async throws { - try await Web3Wallet.instance.disconnect(topic: session.topic) - } -} diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsModule.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsModule.swift index d42807d98..860400ab0 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsModule.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsModule.swift @@ -6,9 +6,7 @@ final class ConnectionDetailsModule { @discardableResult static func create(app: Application, session: Session) -> UIViewController { let router = ConnectionDetailsRouter(app: app) - let interactor = ConnectionDetailsInteractor() let presenter = ConnectionDetailsPresenter( - interactor: interactor, router: router, session: session ) diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift index 50d6f1d59..084f6fd18 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift @@ -4,7 +4,6 @@ import Combine import Web3Wallet final class ConnectionDetailsPresenter: ObservableObject { - private let interactor: ConnectionDetailsInteractor private let router: ConnectionDetailsRouter let session: Session @@ -12,11 +11,9 @@ final class ConnectionDetailsPresenter: ObservableObject { private var disposeBag = Set() init( - interactor: ConnectionDetailsInteractor, router: ConnectionDetailsRouter, session: Session ) { - self.interactor = interactor self.router = router self.session = session } @@ -25,7 +22,7 @@ final class ConnectionDetailsPresenter: ObservableObject { Task { do { ActivityIndicatorManager.shared.start() - try await interactor.disconnectSession(session: session) + try await Web3Wallet.instance.disconnect(topic: session.topic) ActivityIndicatorManager.shared.stop() DispatchQueue.main.async { self.router.dismiss() @@ -36,10 +33,69 @@ final class ConnectionDetailsPresenter: ObservableObject { } } } - + + func accountReferences(namespace: String) -> [String] { session.namespaces[namespace]?.accounts.map { "\($0.namespace):\(($0.reference))" } ?? [] } + + + func createUpdatedSessionNamespaces(existingNamespaces: [String: SessionNamespace]) -> [String: SessionNamespace] { + // Define the Arbitrum chain identifier + let arbitrumChainIdentifier = "eip155:1" + let arbitrumChain = Blockchain(arbitrumChainIdentifier)! + + var updatedNamespaces = existingNamespaces + + for (key, namespace) in existingNamespaces { + // Use the address of the first account in the namespace + let newAccountAddress = namespace.accounts.first!.address + let newAccount = Account(chainIdentifier: arbitrumChainIdentifier, address: newAccountAddress)! + + var updatedChains = namespace.chains ?? [] + var updatedAccounts = namespace.accounts + + // Ensure Arbitrum chain is at the first position + if let index = updatedChains.firstIndex(of: arbitrumChain) { + updatedChains.remove(at: index) + } + updatedChains.insert(arbitrumChain, at: 0) + + // Ensure the new account for Arbitrum is at the first position + if let index = updatedAccounts.firstIndex(of: newAccount) { + updatedAccounts.remove(at: index) + } + updatedAccounts.insert(newAccount, at: 0) + + // Update the session namespace with the modified chains and accounts + let updatedNamespace = SessionNamespace(chains: updatedChains, accounts: updatedAccounts, methods: namespace.methods, events: namespace.events) + updatedNamespaces[key] = updatedNamespace + } + + return updatedNamespaces + } + + func onUpdate() { + Task { + do { + ActivityIndicatorManager.shared.start() + + let existingNamespaces = session.namespaces + + let updatedNamespaces = createUpdatedSessionNamespaces(existingNamespaces: existingNamespaces) + + try await Web3Wallet.instance.update(topic: session.topic, namespaces: updatedNamespaces) + + ActivityIndicatorManager.shared.stop() + DispatchQueue.main.async { + self.router.dismiss() + } + } catch { + ActivityIndicatorManager.shared.stop() + print(error) + } + } + } } // MARK: - Private functions diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift index 5174bc80e..6245ae88f 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift @@ -184,6 +184,15 @@ struct ConnectionDetailsView: View { .padding(.horizontal, 20) .padding(.top, 30) + Button { + presenter.onUpdate() + } label: { + Text("Update") + .foregroundColor(.grey50) + .font(.system(size: 20, weight: .semibold, design: .rounded)) + } + .padding(.top, 20) + Button { presenter.onDelete() } label: { From 80f15e0f530773641a1381fd890147cd2daa4139 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Aug 2024 12:20:16 +0200 Subject: [PATCH 729/814] emit event --- .../ConnectionDetailsPresenter.swift | 47 +------------------ .../ConnectionDetailsView.swift | 4 +- 2 files changed, 4 insertions(+), 47 deletions(-) diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift index 084f6fd18..9ca9a33aa 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsPresenter.swift @@ -39,57 +39,14 @@ final class ConnectionDetailsPresenter: ObservableObject { session.namespaces[namespace]?.accounts.map { "\($0.namespace):\(($0.reference))" } ?? [] } - - func createUpdatedSessionNamespaces(existingNamespaces: [String: SessionNamespace]) -> [String: SessionNamespace] { - // Define the Arbitrum chain identifier - let arbitrumChainIdentifier = "eip155:1" - let arbitrumChain = Blockchain(arbitrumChainIdentifier)! - - var updatedNamespaces = existingNamespaces - - for (key, namespace) in existingNamespaces { - // Use the address of the first account in the namespace - let newAccountAddress = namespace.accounts.first!.address - let newAccount = Account(chainIdentifier: arbitrumChainIdentifier, address: newAccountAddress)! - - var updatedChains = namespace.chains ?? [] - var updatedAccounts = namespace.accounts - - // Ensure Arbitrum chain is at the first position - if let index = updatedChains.firstIndex(of: arbitrumChain) { - updatedChains.remove(at: index) - } - updatedChains.insert(arbitrumChain, at: 0) - - // Ensure the new account for Arbitrum is at the first position - if let index = updatedAccounts.firstIndex(of: newAccount) { - updatedAccounts.remove(at: index) - } - updatedAccounts.insert(newAccount, at: 0) - - // Update the session namespace with the modified chains and accounts - let updatedNamespace = SessionNamespace(chains: updatedChains, accounts: updatedAccounts, methods: namespace.methods, events: namespace.events) - updatedNamespaces[key] = updatedNamespace - } - - return updatedNamespaces - } - - func onUpdate() { + func changeForMainnet() { Task { do { ActivityIndicatorManager.shared.start() - let existingNamespaces = session.namespaces - - let updatedNamespaces = createUpdatedSessionNamespaces(existingNamespaces: existingNamespaces) - - try await Web3Wallet.instance.update(topic: session.topic, namespaces: updatedNamespaces) + try await Web3Wallet.instance.emit(topic: session.topic, event: Session.Event(name: "chainChanged", data: AnyCodable("1")), chainId: Blockchain("eip155:1")!) ActivityIndicatorManager.shared.stop() - DispatchQueue.main.async { - self.router.dismiss() - } } catch { ActivityIndicatorManager.shared.stop() print(error) diff --git a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift index 6245ae88f..86fcf1020 100644 --- a/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift +++ b/Example/WalletApp/PresentationLayer/Wallet/ConnectionDetails/ConnectionDetailsView.swift @@ -185,9 +185,9 @@ struct ConnectionDetailsView: View { .padding(.top, 30) Button { - presenter.onUpdate() + presenter.changeForMainnet() } label: { - Text("Update") + Text("Change for Mainnet") .foregroundColor(.grey50) .font(.system(size: 20, weight: .semibold, design: .rounded)) } From 8cf911b48d277d2e237543bb5e83698a3aee41cc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 19 Aug 2024 12:21:48 +0200 Subject: [PATCH 730/814] remove print --- Example/DApp/Modules/Sign/SignPresenter.swift | 7 ------- 1 file changed, 7 deletions(-) diff --git a/Example/DApp/Modules/Sign/SignPresenter.swift b/Example/DApp/Modules/Sign/SignPresenter.swift index 85541d69e..0b2e86e7d 100644 --- a/Example/DApp/Modules/Sign/SignPresenter.swift +++ b/Example/DApp/Modules/Sign/SignPresenter.swift @@ -169,13 +169,6 @@ extension SignPresenter { } .store(in: &subscriptions) - Sign.instance.sessionUpdatePublisher - .receive(on: DispatchQueue.main) - .sink { [unowned self] (topic, namespace) in - print(namespace) - } - .store(in: &subscriptions) - Sign.instance.authResponsePublisher .receive(on: DispatchQueue.main) .sink { [unowned self] response in From 4e948b952d4e78172af537731f750c8fd07baff0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 09:17:55 +0200 Subject: [PATCH 731/814] add message events --- Sources/Events/Event.swift | 19 ---- Sources/Events/EventStorage.swift | 18 ++-- Sources/Events/EventsClient.swift | 41 ++++++-- Sources/Events/EventsClientFactory.swift | 5 +- Sources/Events/EventsCollector.swift | 12 +-- Sources/Events/EventsDispatcher.swift | 2 +- .../PairingExecutionTraceEvents.swift | 2 +- .../SessionApproveExecutionTraceEvents.swift | 2 +- .../SessionAuthenticateTraceEvents.swift | 2 +- Sources/Events/MessageEventProperties.swift | 95 +++++++++++++++++++ Sources/Events/NetworkingService.swift | 6 +- Sources/Events/TraceEvent.swift | 19 ++++ .../Services/Wallet/WalletPairService.swift | 16 ++-- .../Wallet/SessionAuthenticateResponder.swift | 34 +++---- .../Engine/Common/ApproveEngine.swift | 28 +++--- Tests/EventsTests/EventsDispatcherTests.swift | 2 +- 16 files changed, 210 insertions(+), 93 deletions(-) delete mode 100644 Sources/Events/Event.swift create mode 100644 Sources/Events/MessageEventProperties.swift create mode 100644 Sources/Events/TraceEvent.swift diff --git a/Sources/Events/Event.swift b/Sources/Events/Event.swift deleted file mode 100644 index cc8c4d3c1..000000000 --- a/Sources/Events/Event.swift +++ /dev/null @@ -1,19 +0,0 @@ -import Foundation - -struct Event: Codable { - let eventId: String - let bundleId: String - let timestamp: Int64 - let props: Props -} - -struct Props: Codable { - let event: String - let type: String - let properties: Properties? -} - -struct Properties: Codable { - let topic: String? - let trace: [String]? -} diff --git a/Sources/Events/EventStorage.swift b/Sources/Events/EventStorage.swift index 691ef903e..78afe55e2 100644 --- a/Sources/Events/EventStorage.swift +++ b/Sources/Events/EventStorage.swift @@ -2,16 +2,16 @@ import Foundation protocol EventStorage { - func saveErrorEvent(_ event: Event) - func fetchErrorEvents() -> [Event] + func saveErrorEvent(_ event: TraceEvent) + func fetchErrorEvents() -> [TraceEvent] func clearErrorEvents() } -class UserDefaultsEventStorage: EventStorage { +class UserDefaultsTraceEventStorage: EventStorage { private let errorEventsKey = "com.walletconnect.sdk.errorEvents" private let maxEvents = 30 - func saveErrorEvent(_ event: Event) { + func saveErrorEvent(_ event: TraceEvent) { var existingEvents = fetchErrorEvents() existingEvents.append(event) // Ensure we keep only the last 30 events @@ -23,9 +23,9 @@ class UserDefaultsEventStorage: EventStorage { } } - func fetchErrorEvents() -> [Event] { + func fetchErrorEvents() -> [TraceEvent] { if let data = UserDefaults.standard.data(forKey: errorEventsKey), - let events = try? JSONDecoder().decode([Event].self, from: data) { + let events = try? JSONDecoder().decode([TraceEvent].self, from: data) { // Return only the last 30 events return Array(events.suffix(maxEvents)) } @@ -39,13 +39,13 @@ class UserDefaultsEventStorage: EventStorage { #if DEBUG class MockEventStorage: EventStorage { - private(set) var savedEvents: [Event] = [] + private(set) var savedEvents: [TraceEvent] = [] - func saveErrorEvent(_ event: Event) { + func saveErrorEvent(_ event: TraceEvent) { savedEvents.append(event) } - func fetchErrorEvents() -> [Event] { + func fetchErrorEvents() -> [TraceEvent] { return savedEvents } diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index f0bcb32c3..bc8907df4 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -2,7 +2,7 @@ import Foundation public protocol EventsClientProtocol { func startTrace(topic: String) - func saveEvent(_ event: TraceEvent) + func saveTraceEvent(_ event: TraceEventItem) func setTopic(_ topic: String) func setTelemetryEnabled(_ enabled: Bool) } @@ -12,17 +12,20 @@ public class EventsClient: EventsClientProtocol { private let eventsDispatcher: EventsDispatcher private let logger: ConsoleLogging private var stateStorage: TelemetryStateStorage + private let messageEventsStorage: MessageEventsStorage init( eventsCollector: EventsCollector, eventsDispatcher: EventsDispatcher, logger: ConsoleLogging, - stateStorage: TelemetryStateStorage + stateStorage: TelemetryStateStorage, + messageEventsStorage: MessageEventsStorage ) { self.eventsCollector = eventsCollector self.eventsDispatcher = eventsDispatcher self.logger = logger self.stateStorage = stateStorage + self.messageEventsStorage = messageEventsStorage if stateStorage.telemetryEnabled { Task { await sendStoredEvents() } @@ -48,12 +51,18 @@ public class EventsClient: EventsClientProtocol { } // Public method to save event - public func saveEvent(_ event: TraceEvent) { + public func saveTraceEvent(_ event: TraceEventItem) { guard stateStorage.telemetryEnabled else { return } - logger.debug("Will store an event: \(event)") + logger.debug("Will store a trace event: \(event)") eventsCollector.saveEvent(event) } + public func saveMessageEvent(_ event: MessageEventProperties) { + guard stateStorage.telemetryEnabled else { return } + logger.debug("Will store a message event: \(event)") + messageEventsStorage.saveMessageEvent(event) + } + // Public method to set telemetry enabled or disabled public func setTelemetryEnabled(_ enabled: Bool) { stateStorage.telemetryEnabled = enabled @@ -66,15 +75,27 @@ public class EventsClient: EventsClientProtocol { private func sendStoredEvents() async { guard stateStorage.telemetryEnabled else { return } - let events = eventsCollector.storage.fetchErrorEvents() - guard !events.isEmpty else { return } - logger.debug("Will send events") + let traceEvents = eventsCollector.storage.fetchErrorEvents() + let messageEvents = messageEventsStorage.fetchMessageEvents() + + guard !traceEvents.isEmpty || !messageEvents.isEmpty else { return } + + var combinedEvents: [AnyCodable] = [] + + // Wrap trace events + combinedEvents.append(contentsOf: traceEvents.map { AnyCodable($0) }) + + // Wrap message events + combinedEvents.append(contentsOf: messageEvents.map { AnyCodable($0) }) + + logger.debug("Will send combined events") do { - let success: Bool = try await eventsDispatcher.executeWithRetry(events: events) + let success: Bool = try await eventsDispatcher.executeWithRetry(events: combinedEvents) if success { - logger.debug("Events sent successfully") + logger.debug("Combined events sent successfully") self.eventsCollector.storage.clearErrorEvents() + self.messageEventsStorage.clearMessageEvents() } } catch { logger.debug("Failed to send events after multiple attempts: \(error)") @@ -96,7 +117,7 @@ public class MockEventsClient: EventsClientProtocol { public func setTopic(_ topic: String) {} - public func saveEvent(_ event: TraceEvent) { + public func saveTraceEvent(_ event: TraceEventItem) { saveEventCalled = true } diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift index 43bff4c76..b45df2f26 100644 --- a/Sources/Events/EventsClientFactory.swift +++ b/Sources/Events/EventsClientFactory.swift @@ -4,7 +4,7 @@ public class EventsClientFactory { static func create( projectId: String, sdkVersion: String, - storage: EventStorage = UserDefaultsEventStorage() + storage: EventStorage = UserDefaultsTraceEventStorage() ) -> EventsClient { let networkingService = NetworkingService( projectId: projectId, @@ -18,7 +18,8 @@ public class EventsClientFactory { eventsCollector: eventsCollector, eventsDispatcher: eventsDispatcher, logger: logger, - stateStorage: UserDefaultsTelemetryStateStorage() + stateStorage: UserDefaultsTelemetryStateStorage(), + messageEventsStorage: UserDefaultsMessageEventsStorage() ) } } diff --git a/Sources/Events/EventsCollector.swift b/Sources/Events/EventsCollector.swift index 2ace98002..92e1d286c 100644 --- a/Sources/Events/EventsCollector.swift +++ b/Sources/Events/EventsCollector.swift @@ -1,12 +1,12 @@ import Foundation // Protocol for TraceEvent -public protocol TraceEvent: CustomStringConvertible { +public protocol TraceEventItem: CustomStringConvertible { var description: String { get } } // Protocol for ErrorEvent -protocol ErrorEvent: TraceEvent {} +protocol ErrorEvent: TraceEventItem {} class EventsCollector { @@ -34,7 +34,7 @@ class EventsCollector { } // Function to save event - func saveEvent(_ event: TraceEvent) { + func saveEvent(_ event: TraceEventItem) { trace.append(event.description) if let errorEvent = event as? ErrorEvent { saveErrorEvent(errorEvent) @@ -51,14 +51,14 @@ class EventsCollector { // Private function to save error event private func saveErrorEvent(_ errorEvent: ErrorEvent) { let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" - let event = Event( + let event = TraceEvent( eventId: UUID().uuidString, bundleId: bundleId, timestamp: Int64(Date().timeIntervalSince1970 * 1000), - props: Props( + props: TraceEvent.Props( event: "ERROR", type: errorEvent.description, - properties: Properties( + properties: TraceEvent.Properties( topic: topic, trace: trace ) diff --git a/Sources/Events/EventsDispatcher.swift b/Sources/Events/EventsDispatcher.swift index 0c347958b..f1ae135e1 100644 --- a/Sources/Events/EventsDispatcher.swift +++ b/Sources/Events/EventsDispatcher.swift @@ -17,7 +17,7 @@ class EventsDispatcher { self.retryPolicy = retryPolicy } - func executeWithRetry(events: [Event]) async throws -> Bool { + func executeWithRetry(events: [T]) async throws -> Bool { var attempts = 0 var delay = retryPolicy.initialDelay diff --git a/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift index 5b924af0f..4244b1674 100644 --- a/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/PairingExecutionTraceEvents.swift @@ -1,7 +1,7 @@ import Foundation -public enum PairingExecutionTraceEvents: String, TraceEvent { +public enum PairingExecutionTraceEvents: String, TraceEventItem { case pairingUriValidationSuccess = "pairing_uri_validation_success" case pairingStarted = "pairing_started" case noWssConnection = "no_wss_connection" diff --git a/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift b/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift index 95cc48ca6..6879efa28 100644 --- a/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/SessionApproveExecutionTraceEvents.swift @@ -1,7 +1,7 @@ import Foundation -public enum SessionApproveExecutionTraceEvents: String, TraceEvent { +public enum SessionApproveExecutionTraceEvents: String, TraceEventItem { case approvingSessionProposal = "approving_session_proposal" case sessionNamespacesValidationStarted = "session_namespaces_validation_started" case sessionNamespacesValidationSuccess = "session_namespaces_validation_success" diff --git a/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift b/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift index 88b2f0696..dd2aa13f9 100644 --- a/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift +++ b/Sources/Events/ExecutionTraces/SessionAuthenticateTraceEvents.swift @@ -1,7 +1,7 @@ import Foundation -public enum SessionAuthenticateTraceEvents: String, TraceEvent { +public enum SessionAuthenticateTraceEvents: String, TraceEventItem { case signatureVerificationStarted = "signature_verification_started" case signatureVerificationSuccess = "signature_verification_success" case requestParamsRetrieved = "request_params_retrieved" diff --git a/Sources/Events/MessageEventProperties.swift b/Sources/Events/MessageEventProperties.swift new file mode 100644 index 000000000..81e5345fd --- /dev/null +++ b/Sources/Events/MessageEventProperties.swift @@ -0,0 +1,95 @@ +import Foundation + +import Foundation + +public struct MessageEventProperties { + let tag: Int + let rpcId: RPCID +} + +struct MessageEvent: Codable { + struct Props: Codable { + let event: String = "SUCCESS" + let type: String + let properties: Properties + } + + struct Properties: Codable { + let correlationId: Int64 + let clientId: String + + // Custom CodingKeys to map Swift property names to JSON keys + enum CodingKeys: String, CodingKey { + case correlationId = "correlation_id" + case clientId = "client_id" + } + } + + let eventId: String + let bundleId: String + let timestamp: Int64 + let props: Props +} + + + +protocol MessageEventsStorage { + func saveMessageEvent(_ event: MessageEventProperties) + func fetchMessageEvents() -> [MessageEvent] + func clearMessageEvents() +} + +class UserDefaultsMessageEventsStorage: MessageEventsStorage { + private let messageEventsKey = "com.walletconnect.sdk.messageEvents" + private let maxEvents = 200 + + func saveMessageEvent(_ event: MessageEventProperties) { + // Create the correlation_id from rpcId + let correlationId = event.rpcId.integer + + let type = "\(event.tag)" + + let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" + + let props = MessageEvent.Props( + type: type, + properties: MessageEvent.Properties( + correlationId: correlationId, + clientId: bundleId + ) + ) + + let eventObject = MessageEvent( + eventId: UUID().uuidString, + bundleId: bundleId, + timestamp: Int64(Date().timeIntervalSince1970 * 1000), + props: props + ) + + // Fetch existing events from UserDefaults + var existingEvents = fetchMessageEvents() + existingEvents.append(eventObject) + + // Ensure we keep only the last 200 events + if existingEvents.count > maxEvents { + existingEvents = Array(existingEvents.suffix(maxEvents)) + } + + // Save updated events back to UserDefaults + if let encoded = try? JSONEncoder().encode(existingEvents) { + UserDefaults.standard.set(encoded, forKey: messageEventsKey) + } + } + + func fetchMessageEvents() -> [MessageEvent] { + if let data = UserDefaults.standard.data(forKey: messageEventsKey), + let events = try? JSONDecoder().decode([MessageEvent].self, from: data) { + return events + } + return [] + } + + func clearMessageEvents() { + UserDefaults.standard.removeObject(forKey: messageEventsKey) + } +} diff --git a/Sources/Events/NetworkingService.swift b/Sources/Events/NetworkingService.swift index a8a03b620..233500a16 100644 --- a/Sources/Events/NetworkingService.swift +++ b/Sources/Events/NetworkingService.swift @@ -1,7 +1,7 @@ import Foundation protocol NetworkingServiceProtocol { - func sendEvents(_ events: [Event]) async throws -> Bool + func sendEvents(_ events: [T]) async throws -> Bool } class NetworkingService: NetworkingServiceProtocol { @@ -16,7 +16,7 @@ class NetworkingService: NetworkingServiceProtocol { self.sdkVersion = sdkVersion } - func sendEvents(_ events: [Event]) async throws -> Bool { + func sendEvents(_ events: [T]) async throws -> Bool { var request = URLRequest(url: apiURL) request.httpMethod = "POST" request.setValue("application/json", forHTTPHeaderField: "Content-Type") @@ -51,7 +51,7 @@ class MockNetworkingService: NetworkingServiceProtocol { var shouldFail = false var attemptCount = 0 - func sendEvents(_ events: [Event]) async throws -> Bool { + func sendEvents(_ events: [T]) async throws -> Bool where T : Encodable { attemptCount += 1 if shouldFail { throw NSError(domain: "MockError", code: -1, userInfo: nil) diff --git a/Sources/Events/TraceEvent.swift b/Sources/Events/TraceEvent.swift new file mode 100644 index 000000000..5127891d7 --- /dev/null +++ b/Sources/Events/TraceEvent.swift @@ -0,0 +1,19 @@ +import Foundation + +struct TraceEvent: Codable { + struct Props: Codable { + let event: String + let type: String + let properties: Properties? + } + + struct Properties: Codable { + let topic: String? + let trace: [String]? + } + let eventId: String + let bundleId: String + let timestamp: Int64 + let props: Props +} + diff --git a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift index 8fc8b43c4..a025e49e1 100644 --- a/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift +++ b/Sources/WalletConnectPairing/Services/Wallet/WalletPairService.swift @@ -30,35 +30,35 @@ actor WalletPairService { func pair(_ uri: WalletConnectURI) async throws { eventsClient.startTrace(topic: uri.topic) - eventsClient.saveEvent(PairingExecutionTraceEvents.pairingStarted) + eventsClient.saveTraceEvent(PairingExecutionTraceEvents.pairingStarted) logger.debug("Pairing with uri: \(uri)") guard try !pairingHasPendingRequest(for: uri.topic) else { - eventsClient.saveEvent(PairingExecutionTraceEvents.pairingHasPendingRequest) + eventsClient.saveTraceEvent(PairingExecutionTraceEvents.pairingHasPendingRequest) logger.debug("Pairing with topic (\(uri.topic)) has pending request") return } if !networkingInteractor.isSocketConnected { - eventsClient.saveEvent(PairingExecutionTraceEvents.noWssConnection) + eventsClient.saveTraceEvent(PairingExecutionTraceEvents.noWssConnection) } let pairing = WCPairing(uri: uri) let symKey = try SymmetricKey(hex: uri.symKey) try kms.setSymmetricKey(symKey, for: pairing.topic) pairingStorage.setPairing(pairing) - eventsClient.saveEvent(PairingExecutionTraceEvents.storeNewPairing) + eventsClient.saveTraceEvent(PairingExecutionTraceEvents.storeNewPairing) let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { logger.debug("Pairing failed - Network is not connected") - eventsClient.saveEvent(PairingTraceErrorEvents.noInternetConnection) + eventsClient.saveTraceEvent(PairingTraceErrorEvents.noInternetConnection) throw Errors.networkNotConnected } - eventsClient.saveEvent(PairingExecutionTraceEvents.subscribingPairingTopic) + eventsClient.saveTraceEvent(PairingExecutionTraceEvents.subscribingPairingTopic) do { try await networkingInteractor.subscribe(topic: pairing.topic) } catch { logger.debug("Failed to subscribe to topic: \(pairing.topic)") - eventsClient.saveEvent(PairingTraceErrorEvents.subscribePairingTopicFailure) + eventsClient.saveTraceEvent(PairingTraceErrorEvents.subscribePairingTopicFailure) throw error } } @@ -78,7 +78,7 @@ extension WalletPairService { guard !pendingRequests.isEmpty else { return false } pendingRequests.forEach { request in - eventsClient.saveEvent(PairingExecutionTraceEvents.emitSessionProposal) + eventsClient.saveTraceEvent(PairingExecutionTraceEvents.emitSessionProposal) networkingInteractor.handleHistoryRequest(topic: topic, request: request) } return true diff --git a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift index f33758a03..3dae4def8 100644 --- a/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Services/Wallet/SessionAuthenticateResponder.swift @@ -39,12 +39,12 @@ actor SessionAuthenticateResponder { } func respond(requestId: RPCID, auths: [Cacao]) async throws -> Session? { - eventsClient.saveEvent(SessionAuthenticateTraceEvents.signatureVerificationStarted) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.signatureVerificationStarted) do { try await util.recoverAndVerifySignature(cacaos: auths) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.signatureVerificationSuccess) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.signatureVerificationSuccess) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.signatureVerificationFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.signatureVerificationFailed) throw error } @@ -53,9 +53,9 @@ actor SessionAuthenticateResponder { do { (sessionAuthenticateRequestParams, pairingTopic) = try util.getsessionAuthenticateRequestParams(requestId: requestId) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.requestParamsRetrieved) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.requestParamsRetrieved) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.requestParamsRetrievalFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.requestParamsRetrievalFailed) throw error } @@ -64,17 +64,17 @@ actor SessionAuthenticateResponder { do { (responseTopic, responseKeys) = try util.generateAgreementKeys(requestParams: sessionAuthenticateRequestParams) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.agreementKeysGenerated) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.agreementKeysGenerated) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.agreementKeysGenerationFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.agreementKeysGenerationFailed) throw error } do { try kms.setAgreementSecret(responseKeys, topic: responseTopic) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.agreementSecretSet) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.agreementSecretSet) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.agreementSecretSetFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.agreementSecretSetFailed) throw error } @@ -88,24 +88,24 @@ actor SessionAuthenticateResponder { sessionSelfPubKey = try kms.createX25519KeyPair() sessionSelfPubKeyHex = sessionSelfPubKey.hexRepresentation sessionKeys = try kms.performKeyAgreement(selfPublicKey: sessionSelfPubKey, peerPublicKey: peerParticipant.publicKey) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.sessionKeysGenerated) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.sessionKeysGenerated) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionKeysGenerationFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.sessionKeysGenerationFailed) throw error } let sessionTopic = sessionKeys.derivedTopic() do { try kms.setAgreementSecret(sessionKeys, topic: sessionTopic) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.sessionSecretSet) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.sessionSecretSet) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionSecretSetFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.sessionSecretSetFailed) throw error } let selfParticipant = Participant(publicKey: sessionSelfPubKeyHex, metadata: metadata) let responseParams = SessionAuthenticateResponseParams(responder: selfParticipant, cacaos: auths) - eventsClient.saveEvent(SessionAuthenticateTraceEvents.responseParamsCreated) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.responseParamsCreated) let response = RPCResponse(id: requestId, result: responseParams) @@ -119,9 +119,9 @@ actor SessionAuthenticateResponder { Task { removePairing(pairingTopic: pairingTopic) } - eventsClient.saveEvent(SessionAuthenticateTraceEvents.responseSent) + eventsClient.saveTraceEvent(SessionAuthenticateTraceEvents.responseSent) } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.responseSendFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.responseSendFailed) throw error } @@ -137,7 +137,7 @@ actor SessionAuthenticateResponder { verifyContextStore.delete(forKey: requestId.string) return session } catch { - eventsClient.saveEvent(SessionAuthenticateErrorEvents.sessionCreationFailed) + eventsClient.saveTraceEvent(SessionAuthenticateErrorEvents.sessionCreationFailed) throw error } } diff --git a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift index 0c8d7530b..464500fd3 100644 --- a/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/ApproveEngine.swift @@ -74,15 +74,15 @@ final class ApproveEngine { func approveProposal(proposerPubKey: String, validating sessionNamespaces: [String: SessionNamespace], sessionProperties: [String: String]? = nil) async throws -> Session { eventsClient.startTrace(topic: "") logger.debug("Approving session proposal") - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.approvingSessionProposal) + eventsClient.saveTraceEvent(SessionApproveExecutionTraceEvents.approvingSessionProposal) guard !sessionNamespaces.isEmpty else { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionNamespacesValidationFailure) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.sessionNamespacesValidationFailure) throw Errors.emtySessionNamespacesForbidden } guard let payload = try proposalPayloadsStore.get(key: proposerPubKey) else { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.proposalNotFound) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.proposalNotFound) throw Errors.proposalNotFound } let pairingTopic = payload.topic @@ -93,24 +93,24 @@ final class ApproveEngine { guard !proposal.isExpired() else { logger.debug("Proposal has expired, topic: \(payload.topic)") - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.proposalExpired) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.proposalExpired) proposalPayloadsStore.delete(forKey: proposerPubKey) throw Errors.proposalExpired } let networkConnectionStatus = await resolveNetworkConnectionStatus() guard networkConnectionStatus == .connected else { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.networkNotConnected) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.networkNotConnected) throw Errors.networkNotConnected } do { - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationStarted) + eventsClient.saveTraceEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationStarted) try Namespace.validate(sessionNamespaces) try Namespace.validateApproved(sessionNamespaces, against: proposal.requiredNamespaces) - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationSuccess) + eventsClient.saveTraceEvent(SessionApproveExecutionTraceEvents.sessionNamespacesValidationSuccess) } catch { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionNamespacesValidationFailure) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.sessionNamespacesValidationFailure) throw error } @@ -120,7 +120,7 @@ final class ApproveEngine { selfPublicKey: selfPublicKey, peerPublicKey: proposal.proposer.publicKey ) else { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.agreementMissingOrInvalid) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.agreementMissingOrInvalid) throw Errors.agreementMissingOrInvalid } @@ -128,7 +128,7 @@ final class ApproveEngine { try kms.setAgreementSecret(agreementKey, topic: sessionTopic) guard let relay = proposal.relays.first else { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.relayNotFound) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.relayNotFound) throw Errors.relayNotFound } @@ -151,9 +151,9 @@ final class ApproveEngine { do { _ = try await proposeResponseTask - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.responseApproveSent) + eventsClient.saveTraceEvent(SessionApproveExecutionTraceEvents.responseApproveSent) } catch { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) throw error } @@ -164,14 +164,14 @@ final class ApproveEngine { removePairing(pairingTopic: pairingTopic) } onSessionSettle?(session.publicRepresentation()) - eventsClient.saveEvent(SessionApproveExecutionTraceEvents.sessionSettleSuccess) + eventsClient.saveTraceEvent(SessionApproveExecutionTraceEvents.sessionSettleSuccess) logger.debug("Session proposal response and settle request have been sent") proposalPayloadsStore.delete(forKey: proposerPubKey) verifyContextStore.delete(forKey: proposerPubKey) return session.publicRepresentation() } catch { - eventsClient.saveEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) + eventsClient.saveTraceEvent(ApproveSessionTraceErrorEvents.sessionSettleFailure) throw error } } diff --git a/Tests/EventsTests/EventsDispatcherTests.swift b/Tests/EventsTests/EventsDispatcherTests.swift index e7b980e5a..3ffc2f5d4 100644 --- a/Tests/EventsTests/EventsDispatcherTests.swift +++ b/Tests/EventsTests/EventsDispatcherTests.swift @@ -4,7 +4,7 @@ import XCTest class EventsDispatcherTests: XCTestCase { var mockNetworkingService: MockNetworkingService! var eventsDispatcher: EventsDispatcher! - let events = [Event(eventId: UUID().uuidString, bundleId: "com.wallet.example", timestamp: Int64(Date().timeIntervalSince1970 * 1000), props: Props(event: "ERROR", type: "test_error", properties: Properties(topic: "test_topic", trace: ["test_trace"])))] + let events = [TraceEvent(eventId: UUID().uuidString, bundleId: "com.wallet.example", timestamp: Int64(Date().timeIntervalSince1970 * 1000), props: TraceEvent.Props(event: "ERROR", type: "test_error", properties: TraceEvent.Properties(topic: "test_topic", trace: ["test_trace"])))] override func setUp() { super.setUp() From 93796db22d1d7a442b6ac033e45167845df8cc30 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 09:28:35 +0200 Subject: [PATCH 732/814] savepoint --- Sources/Events/EventsClient.swift | 7 ++-- Sources/Events/MessageEventProperties.swift | 1 - Sources/Events/MessageEventType.swift | 36 +++++++++++++++++++++ 3 files changed, 40 insertions(+), 4 deletions(-) create mode 100644 Sources/Events/MessageEventType.swift diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index bc8907df4..f304eb4f4 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -57,10 +57,11 @@ public class EventsClient: EventsClientProtocol { eventsCollector.saveEvent(event) } - public func saveMessageEvent(_ event: MessageEventProperties) { + public func saveMessageEvent(_ event: MessageEventType) { guard stateStorage.telemetryEnabled else { return } - logger.debug("Will store a message event: \(event)") - messageEventsStorage.saveMessageEvent(event) + let messageEventProperties = event.toMessageEventProperties() + logger.debug("Will store a message event: \(messageEventProperties)") + messageEventsStorage.saveMessageEvent(messageEventProperties) } // Public method to set telemetry enabled or disabled diff --git a/Sources/Events/MessageEventProperties.swift b/Sources/Events/MessageEventProperties.swift index 81e5345fd..7b5e191f1 100644 --- a/Sources/Events/MessageEventProperties.swift +++ b/Sources/Events/MessageEventProperties.swift @@ -1,4 +1,3 @@ -import Foundation import Foundation diff --git a/Sources/Events/MessageEventType.swift b/Sources/Events/MessageEventType.swift new file mode 100644 index 000000000..d0620226e --- /dev/null +++ b/Sources/Events/MessageEventType.swift @@ -0,0 +1,36 @@ + +import Foundation + +public enum MessageEventType { + case sessionAuthenticateLinkMode(RPCID) + case sessionAuthenticateLinkModeResponseApprove(RPCID) + case sessionAuthenticateLinkModeResponseReject(RPCID) + case sessionRequestLinkMode(RPCID) + case sessionRequestLinkModeResponse(RPCID) + + var tag: Int { + switch self { + case .sessionAuthenticateLinkMode: + return 1122 + case .sessionAuthenticateLinkModeResponseApprove: + return 1123 + case .sessionAuthenticateLinkModeResponseReject: + return 1124 + case .sessionRequestLinkMode: + return 1125 + case .sessionRequestLinkModeResponse: + return 1126 + } + } + + func toMessageEventProperties() -> MessageEventProperties { + switch self { + case let .sessionAuthenticateLinkMode(rpcId), + let .sessionAuthenticateLinkModeResponseApprove(rpcId), + let .sessionAuthenticateLinkModeResponseReject(rpcId), + let .sessionRequestLinkMode(rpcId), + let .sessionRequestLinkModeResponse(rpcId): + return MessageEventProperties(tag: self.tag, rpcId: rpcId) + } + } +} From dde96be32bc858b6b5622ebeb95f0d8090de550c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 11:56:08 +0200 Subject: [PATCH 733/814] add direction property --- Sources/Events/MessageEventProperties.swift | 20 +++++--- Sources/Events/MessageEventType.swift | 51 ++++++++++++++------- 2 files changed, 49 insertions(+), 22 deletions(-) diff --git a/Sources/Events/MessageEventProperties.swift b/Sources/Events/MessageEventProperties.swift index 7b5e191f1..c7c976202 100644 --- a/Sources/Events/MessageEventProperties.swift +++ b/Sources/Events/MessageEventProperties.swift @@ -4,6 +4,12 @@ import Foundation public struct MessageEventProperties { let tag: Int let rpcId: RPCID + let direction: Direction +} + +enum Direction: String, Codable { + case send + case received } struct MessageEvent: Codable { @@ -16,11 +22,13 @@ struct MessageEvent: Codable { struct Properties: Codable { let correlationId: Int64 let clientId: String + let direction: Direction // Custom CodingKeys to map Swift property names to JSON keys enum CodingKeys: String, CodingKey { case correlationId = "correlation_id" case clientId = "client_id" + case direction } } @@ -31,9 +39,8 @@ struct MessageEvent: Codable { } - protocol MessageEventsStorage { - func saveMessageEvent(_ event: MessageEventProperties) + func saveMessageEvent(_ eventProperties: MessageEventProperties) func fetchMessageEvents() -> [MessageEvent] func clearMessageEvents() } @@ -42,11 +49,11 @@ class UserDefaultsMessageEventsStorage: MessageEventsStorage { private let messageEventsKey = "com.walletconnect.sdk.messageEvents" private let maxEvents = 200 - func saveMessageEvent(_ event: MessageEventProperties) { + func saveMessageEvent(_ eventProperties: MessageEventProperties) { // Create the correlation_id from rpcId - let correlationId = event.rpcId.integer + let correlationId = eventProperties.rpcId.integer - let type = "\(event.tag)" + let type = "\(eventProperties.tag)" let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" @@ -54,7 +61,8 @@ class UserDefaultsMessageEventsStorage: MessageEventsStorage { type: type, properties: MessageEvent.Properties( correlationId: correlationId, - clientId: bundleId + clientId: bundleId, + direction: eventProperties.direction ) ) diff --git a/Sources/Events/MessageEventType.swift b/Sources/Events/MessageEventType.swift index d0620226e..670f35627 100644 --- a/Sources/Events/MessageEventType.swift +++ b/Sources/Events/MessageEventType.swift @@ -2,35 +2,54 @@ import Foundation public enum MessageEventType { - case sessionAuthenticateLinkMode(RPCID) - case sessionAuthenticateLinkModeResponseApprove(RPCID) - case sessionAuthenticateLinkModeResponseReject(RPCID) - case sessionRequestLinkMode(RPCID) - case sessionRequestLinkModeResponse(RPCID) + case sessionAuthenticateLinkModeSent(RPCID) + case sessionAuthenticateLinkModeReceived(RPCID) + case sessionAuthenticateLinkModeResponseApproveSent(RPCID) + case sessionAuthenticateLinkModeResponseApproveReceived(RPCID) + case sessionAuthenticateLinkModeResponseRejectSent(RPCID) + case sessionAuthenticateLinkModeResponseRejectReceived(RPCID) + case sessionRequestLinkModeSent(RPCID) + case sessionRequestLinkModeReceived(RPCID) + case sessionRequestLinkModeResponseSent(RPCID) + case sessionRequestLinkModeResponseReceived(RPCID) var tag: Int { switch self { - case .sessionAuthenticateLinkMode: + case .sessionAuthenticateLinkModeSent, .sessionAuthenticateLinkModeReceived: return 1122 - case .sessionAuthenticateLinkModeResponseApprove: + case .sessionAuthenticateLinkModeResponseApproveSent, .sessionAuthenticateLinkModeResponseApproveReceived: return 1123 - case .sessionAuthenticateLinkModeResponseReject: + case .sessionAuthenticateLinkModeResponseRejectSent, .sessionAuthenticateLinkModeResponseRejectReceived: return 1124 - case .sessionRequestLinkMode: + case .sessionRequestLinkModeSent, .sessionRequestLinkModeReceived: return 1125 - case .sessionRequestLinkModeResponse: + case .sessionRequestLinkModeResponseSent, .sessionRequestLinkModeResponseReceived: return 1126 } } + var direction: Direction { + switch self { + case .sessionAuthenticateLinkModeSent, .sessionAuthenticateLinkModeResponseApproveSent, .sessionAuthenticateLinkModeResponseRejectSent, .sessionRequestLinkModeSent, .sessionRequestLinkModeResponseSent: + return .send + case .sessionAuthenticateLinkModeReceived, .sessionAuthenticateLinkModeResponseApproveReceived, .sessionAuthenticateLinkModeResponseRejectReceived, .sessionRequestLinkModeReceived, .sessionRequestLinkModeResponseReceived: + return .received + } + } + func toMessageEventProperties() -> MessageEventProperties { switch self { - case let .sessionAuthenticateLinkMode(rpcId), - let .sessionAuthenticateLinkModeResponseApprove(rpcId), - let .sessionAuthenticateLinkModeResponseReject(rpcId), - let .sessionRequestLinkMode(rpcId), - let .sessionRequestLinkModeResponse(rpcId): - return MessageEventProperties(tag: self.tag, rpcId: rpcId) + case let .sessionAuthenticateLinkModeSent(rpcId), + let .sessionAuthenticateLinkModeReceived(rpcId), + let .sessionAuthenticateLinkModeResponseApproveSent(rpcId), + let .sessionAuthenticateLinkModeResponseApproveReceived(rpcId), + let .sessionAuthenticateLinkModeResponseRejectSent(rpcId), + let .sessionAuthenticateLinkModeResponseRejectReceived(rpcId), + let .sessionRequestLinkModeSent(rpcId), + let .sessionRequestLinkModeReceived(rpcId), + let .sessionRequestLinkModeResponseSent(rpcId), + let .sessionRequestLinkModeResponseReceived(rpcId): + return MessageEventProperties(tag: self.tag, rpcId: rpcId, direction: self.direction) } } } From a15b923a62648ddd9812dc2c4903af2e99085e33 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 12:19:52 +0200 Subject: [PATCH 734/814] remove event properties type --- Sources/Events/EventsClient.swift | 5 +- Sources/Events/MessageEvent.swift | 33 +++++++++++ Sources/Events/MessageEventProperties.swift | 61 ++++----------------- Sources/Events/MessageEventType.swift | 46 +++++++++------- 4 files changed, 73 insertions(+), 72 deletions(-) create mode 100644 Sources/Events/MessageEvent.swift diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index f304eb4f4..22c4651fc 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -59,9 +59,8 @@ public class EventsClient: EventsClientProtocol { public func saveMessageEvent(_ event: MessageEventType) { guard stateStorage.telemetryEnabled else { return } - let messageEventProperties = event.toMessageEventProperties() - logger.debug("Will store a message event: \(messageEventProperties)") - messageEventsStorage.saveMessageEvent(messageEventProperties) + logger.debug("Will store a message event: \(event)") + messageEventsStorage.saveMessageEvent(event) } // Public method to set telemetry enabled or disabled diff --git a/Sources/Events/MessageEvent.swift b/Sources/Events/MessageEvent.swift new file mode 100644 index 000000000..dcc4aee56 --- /dev/null +++ b/Sources/Events/MessageEvent.swift @@ -0,0 +1,33 @@ + +import Foundation + +struct MessageEvent: Codable { + struct Props: Codable { + let event: String = "SUCCESS" + let type: String + let properties: Properties + } + + struct Properties: Codable { + let correlationId: Int64 + let clientId: String + let direction: Direction + + // Custom CodingKeys to map Swift property names to JSON keys + enum CodingKeys: String, CodingKey { + case correlationId = "correlation_id" + case clientId = "client_id" + case direction + } + } + + enum Direction: String, Codable { + case send + case received + } + + let eventId: String + let bundleId: String + let timestamp: Int64 + let props: Props +} diff --git a/Sources/Events/MessageEventProperties.swift b/Sources/Events/MessageEventProperties.swift index c7c976202..19d6ae2be 100644 --- a/Sources/Events/MessageEventProperties.swift +++ b/Sources/Events/MessageEventProperties.swift @@ -1,60 +1,20 @@ import Foundation -public struct MessageEventProperties { - let tag: Int - let rpcId: RPCID - let direction: Direction -} - -enum Direction: String, Codable { - case send - case received -} - -struct MessageEvent: Codable { - struct Props: Codable { - let event: String = "SUCCESS" - let type: String - let properties: Properties - } - - struct Properties: Codable { - let correlationId: Int64 - let clientId: String - let direction: Direction - - // Custom CodingKeys to map Swift property names to JSON keys - enum CodingKeys: String, CodingKey { - case correlationId = "correlation_id" - case clientId = "client_id" - case direction - } - } - - let eventId: String - let bundleId: String - let timestamp: Int64 - let props: Props -} - protocol MessageEventsStorage { - func saveMessageEvent(_ eventProperties: MessageEventProperties) - func fetchMessageEvents() -> [MessageEvent] - func clearMessageEvents() + func saveMessageEvent(_ eventType: MessageEventType) + func fetchMessageEvents() -> [MessageEvent] + func clearMessageEvents() } class UserDefaultsMessageEventsStorage: MessageEventsStorage { private let messageEventsKey = "com.walletconnect.sdk.messageEvents" private let maxEvents = 200 - func saveMessageEvent(_ eventProperties: MessageEventProperties) { - // Create the correlation_id from rpcId - let correlationId = eventProperties.rpcId.integer - - let type = "\(eventProperties.tag)" - + func saveMessageEvent(_ eventType: MessageEventType) { + let correlationId = eventType.rpcId.integer + let type = "\(eventType.tag)" let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" let props = MessageEvent.Props( @@ -62,11 +22,11 @@ class UserDefaultsMessageEventsStorage: MessageEventsStorage { properties: MessageEvent.Properties( correlationId: correlationId, clientId: bundleId, - direction: eventProperties.direction + direction: eventType.direction ) ) - let eventObject = MessageEvent( + let event = MessageEvent( eventId: UUID().uuidString, bundleId: bundleId, timestamp: Int64(Date().timeIntervalSince1970 * 1000), @@ -75,7 +35,7 @@ class UserDefaultsMessageEventsStorage: MessageEventsStorage { // Fetch existing events from UserDefaults var existingEvents = fetchMessageEvents() - existingEvents.append(eventObject) + existingEvents.append(event) // Ensure we keep only the last 200 events if existingEvents.count > maxEvents { @@ -91,7 +51,8 @@ class UserDefaultsMessageEventsStorage: MessageEventsStorage { func fetchMessageEvents() -> [MessageEvent] { if let data = UserDefaults.standard.data(forKey: messageEventsKey), let events = try? JSONDecoder().decode([MessageEvent].self, from: data) { - return events + // Return only the last 200 events + return Array(events.suffix(maxEvents)) } return [] } diff --git a/Sources/Events/MessageEventType.swift b/Sources/Events/MessageEventType.swift index 670f35627..fe27cbf31 100644 --- a/Sources/Events/MessageEventType.swift +++ b/Sources/Events/MessageEventType.swift @@ -13,6 +13,22 @@ public enum MessageEventType { case sessionRequestLinkModeResponseSent(RPCID) case sessionRequestLinkModeResponseReceived(RPCID) + var rpcId: RPCID { + switch self { + case .sessionAuthenticateLinkModeSent(let rpcId), + .sessionAuthenticateLinkModeReceived(let rpcId), + .sessionAuthenticateLinkModeResponseApproveSent(let rpcId), + .sessionAuthenticateLinkModeResponseApproveReceived(let rpcId), + .sessionAuthenticateLinkModeResponseRejectSent(let rpcId), + .sessionAuthenticateLinkModeResponseRejectReceived(let rpcId), + .sessionRequestLinkModeSent(let rpcId), + .sessionRequestLinkModeReceived(let rpcId), + .sessionRequestLinkModeResponseSent(let rpcId), + .sessionRequestLinkModeResponseReceived(let rpcId): + return rpcId + } + } + var tag: Int { switch self { case .sessionAuthenticateLinkModeSent, .sessionAuthenticateLinkModeReceived: @@ -28,28 +44,20 @@ public enum MessageEventType { } } - var direction: Direction { + var direction: MessageEvent.Direction { switch self { - case .sessionAuthenticateLinkModeSent, .sessionAuthenticateLinkModeResponseApproveSent, .sessionAuthenticateLinkModeResponseRejectSent, .sessionRequestLinkModeSent, .sessionRequestLinkModeResponseSent: + case .sessionAuthenticateLinkModeSent, + .sessionAuthenticateLinkModeResponseApproveSent, + .sessionAuthenticateLinkModeResponseRejectSent, + .sessionRequestLinkModeSent, + .sessionRequestLinkModeResponseSent: return .send - case .sessionAuthenticateLinkModeReceived, .sessionAuthenticateLinkModeResponseApproveReceived, .sessionAuthenticateLinkModeResponseRejectReceived, .sessionRequestLinkModeReceived, .sessionRequestLinkModeResponseReceived: + case .sessionAuthenticateLinkModeReceived, + .sessionAuthenticateLinkModeResponseApproveReceived, + .sessionAuthenticateLinkModeResponseRejectReceived, + .sessionRequestLinkModeReceived, + .sessionRequestLinkModeResponseReceived: return .received } } - - func toMessageEventProperties() -> MessageEventProperties { - switch self { - case let .sessionAuthenticateLinkModeSent(rpcId), - let .sessionAuthenticateLinkModeReceived(rpcId), - let .sessionAuthenticateLinkModeResponseApproveSent(rpcId), - let .sessionAuthenticateLinkModeResponseApproveReceived(rpcId), - let .sessionAuthenticateLinkModeResponseRejectSent(rpcId), - let .sessionAuthenticateLinkModeResponseRejectReceived(rpcId), - let .sessionRequestLinkModeSent(rpcId), - let .sessionRequestLinkModeReceived(rpcId), - let .sessionRequestLinkModeResponseSent(rpcId), - let .sessionRequestLinkModeResponseReceived(rpcId): - return MessageEventProperties(tag: self.tag, rpcId: rpcId, direction: self.direction) - } - } } From e11e1d994c08dab3eedc4fda6075ae258270be07 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 13:21:08 +0200 Subject: [PATCH 735/814] integrate SR link mode into sign client --- Sources/Events/EventsClient.swift | 6 ++++++ .../Auth/Link/LinkAuthRequestSubscriber.swift | 8 +++++++- .../Auth/Link/LinkAuthRequester.swift | 11 +++++++---- .../Link/LinkSessionAuthenticateResponder.swift | 7 ++++++- .../Link/LinkSessionRequestResponseSubscriber.swift | 8 +++++++- .../Auth/Link/LinkSessionRequestSubscriber.swift | 7 ++++++- .../Auth/Services/App/AuthResponseSubscriber.swift | 10 +++++++++- .../LinkSessionRequester.swift | 9 +++++++-- .../LinkSessionResponder.swift | 10 +++++++++- .../WalletErrorResponder.swift | 13 ++++++++++--- .../WalletConnectSign/Sign/SignClientFactory.swift | 2 +- 11 files changed, 75 insertions(+), 16 deletions(-) diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 22c4651fc..b283b60ac 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -5,6 +5,7 @@ public protocol EventsClientProtocol { func saveTraceEvent(_ event: TraceEventItem) func setTopic(_ topic: String) func setTelemetryEnabled(_ enabled: Bool) + func saveMessageEvent(_ event: MessageEventType) } public class EventsClient: EventsClientProtocol { @@ -124,5 +125,10 @@ public class MockEventsClient: EventsClientProtocol { public func setTelemetryEnabled(_ enabled: Bool) { telemetryEnabled = enabled } + + public func saveMessageEvent(_ event: MessageEventType) { + + } + } #endif diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift index c245a19d2..99000ef64 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequestSubscriber.swift @@ -8,6 +8,7 @@ class LinkAuthRequestSubscriber { private let envelopesDispatcher: LinkEnvelopesDispatcher private let verifyClient: VerifyClientProtocol private let verifyContextStore: CodableStore + private let eventsClient: EventsClientProtocol var onRequest: (((request: AuthenticationRequest, context: VerifyContext?)) -> Void)? @@ -17,13 +18,16 @@ class LinkAuthRequestSubscriber { kms: KeyManagementServiceProtocol, envelopesDispatcher: LinkEnvelopesDispatcher, verifyClient: VerifyClientProtocol, - verifyContextStore: CodableStore + verifyContextStore: CodableStore, + eventsClient: EventsClientProtocol ) { self.logger = logger self.kms = kms self.envelopesDispatcher = envelopesDispatcher self.verifyClient = verifyClient self.verifyContextStore = verifyContextStore + self.eventsClient = eventsClient + subscribeForRequest() } @@ -33,6 +37,8 @@ class LinkAuthRequestSubscriber { .requestSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove().method) .sink { [unowned self] (payload: RequestSubscriptionPayload) in + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionAuthenticateLinkModeReceived(payload.id)) } + logger.debug("LinkAuthRequestSubscriber: Received request") diff --git a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift index 228baef25..4b5ed89e2 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkAuthRequester.swift @@ -13,6 +13,7 @@ actor LinkAuthRequester { private let authResponseTopicRecordsStore: CodableStore private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let linkModeLinksStore: CodableStore + private let eventsClient: EventsClientProtocol init(kms: KeyManagementService, appMetadata: AppMetadata, @@ -20,7 +21,8 @@ actor LinkAuthRequester { iatProvader: IATProvider, authResponseTopicRecordsStore: CodableStore, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, - linkModeLinksStore: CodableStore) { + linkModeLinksStore: CodableStore, + eventsClient: EventsClientProtocol) { self.kms = kms self.appMetadata = appMetadata self.logger = logger @@ -28,6 +30,7 @@ actor LinkAuthRequester { self.authResponseTopicRecordsStore = authResponseTopicRecordsStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.linkModeLinksStore = linkModeLinksStore + self.eventsClient = eventsClient } func request(params: AuthRequestParams, walletUniversalLink: String) async throws -> String { @@ -50,8 +53,6 @@ actor LinkAuthRequester { let requester = Participant(publicKey: pubKey.hexRepresentation, metadata: appMetadata) let payload = AuthPayload(requestParams: params, iat: iatProvader.iat) - - let sessionAuthenticateRequestParams = SessionAuthenticateRequestParams(requester: requester, authPayload: payload, ttl: params.ttl) let authResponseTopicRecord = AuthResponseTopicRecord(topic: responseTopic, unixTimestamp: sessionAuthenticateRequestParams.expiryTimestamp) authResponseTopicRecordsStore.set(authResponseTopicRecord, forKey: responseTopic) @@ -60,8 +61,10 @@ actor LinkAuthRequester { logger.debug("LinkAuthRequester: sending request") - return try await linkEnvelopesDispatcher.request(topic: UUID().uuidString,request: request, peerUniversalLink: walletUniversalLink, envelopeType: .type2) + let envelope = try await linkEnvelopesDispatcher.request(topic: UUID().uuidString,request: request, peerUniversalLink: walletUniversalLink, envelopeType: .type2) + Task { eventsClient.saveMessageEvent(.sessionAuthenticateLinkModeSent(request.id!)) } + return envelope } private func createRecapUrn(methods: [String]) throws -> String { diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift index 31d6ba9fe..f5eb9f0c3 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionAuthenticateResponder.swift @@ -12,6 +12,7 @@ actor LinkSessionAuthenticateResponder { private let util: ApproveSessionAuthenticateUtil private let walletErrorResponder: WalletErrorResponder private let verifyContextStore: CodableStore + private let eventsClient: EventsClientProtocol init( linkEnvelopesDispatcher: LinkEnvelopesDispatcher, @@ -20,7 +21,8 @@ actor LinkSessionAuthenticateResponder { metadata: AppMetadata, approveSessionAuthenticateUtil: ApproveSessionAuthenticateUtil, walletErrorResponder: WalletErrorResponder, - verifyContextStore: CodableStore + verifyContextStore: CodableStore, + eventsClient: EventsClientProtocol ) { self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.logger = logger @@ -29,6 +31,7 @@ actor LinkSessionAuthenticateResponder { self.metadata = metadata self.util = approveSessionAuthenticateUtil self.walletErrorResponder = walletErrorResponder + self.eventsClient = eventsClient } func respond(requestId: RPCID, auths: [Cacao]) async throws -> (Session?, String) { @@ -60,6 +63,8 @@ actor LinkSessionAuthenticateResponder { let url = try await linkEnvelopesDispatcher.respond(topic: responseTopic, response: response, peerUniversalLink: peerUniversalLink, envelopeType: .type1(pubKey: responseKeys.publicKey.rawRepresentation)) + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionAuthenticateLinkModeResponseApproveSent(requestId)) } + let session = try util.createSession( response: responseParams, pairingTopic: pairingTopic, diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift index e0581269a..536f03937 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestResponseSubscriber.swift @@ -5,17 +5,22 @@ import Combine class LinkSessionRequestResponseSubscriber { private var publishers = [AnyCancellable]() private let envelopesDispatcher: LinkEnvelopesDispatcher + private let eventsClient: EventsClientProtocol var onSessionResponse: ((Response) -> Void)? - init(envelopesDispatcher: LinkEnvelopesDispatcher) { + init(envelopesDispatcher: LinkEnvelopesDispatcher, + eventsClient: EventsClientProtocol + ) { self.envelopesDispatcher = envelopesDispatcher + self.eventsClient = eventsClient setupRequestSubscription() } func setupRequestSubscription() { envelopesDispatcher.responseErrorSubscription(on: SessionRequestProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionRequestLinkModeReceived(payload.id)) } onSessionResponse?(Response( id: payload.id, topic: payload.topic, @@ -27,6 +32,7 @@ class LinkSessionRequestResponseSubscriber { envelopesDispatcher.responseSubscription(on: SessionRequestProtocolMethod()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionRequestLinkModeReceived(payload.id)) } Task(priority: .high) { onSessionResponse?(Response( id: payload.id, diff --git a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift index 08827346d..be398636d 100644 --- a/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Link/LinkSessionRequestSubscriber.swift @@ -8,17 +8,20 @@ class LinkSessionRequestSubscriber { private var publishers = [AnyCancellable]() private let logger: ConsoleLogging private let envelopesDispatcher: LinkEnvelopesDispatcher + private let eventsClient: EventsClientProtocol init( sessionRequestsProvider: SessionRequestsProvider, sessionStore: WCSessionStorage, logger: ConsoleLogging, - envelopesDispatcher: LinkEnvelopesDispatcher + envelopesDispatcher: LinkEnvelopesDispatcher, + eventsClient: EventsClientProtocol ) { self.sessionRequestsProvider = sessionRequestsProvider self.sessionStore = sessionStore self.logger = logger self.envelopesDispatcher = envelopesDispatcher + self.eventsClient = eventsClient setupRequestSubscription() } @@ -29,6 +32,8 @@ class LinkSessionRequestSubscriber { private func setupRequestSubscription() { envelopesDispatcher.requestSubscription(on: SessionRequestProtocolMethod().method) .sink { [unowned self] (payload: RequestSubscriptionPayload) in + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionRequestLinkModeReceived(payload.id)) } + Task(priority: .high) { onSessionRequest(payload: payload) } diff --git a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift index b4889b8e3..e3e600aeb 100644 --- a/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift +++ b/Sources/WalletConnectSign/Auth/Services/App/AuthResponseSubscriber.swift @@ -21,6 +21,7 @@ class AuthResponseSubscriber { private let linkModeLinksStore: CodableStore private let supportLinkMode: Bool private let pairingStore: WCPairingStorage + private let eventsClient: EventsClientProtocol init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, @@ -35,7 +36,9 @@ class AuthResponseSubscriber { linkEnvelopesDispatcher: LinkEnvelopesDispatcher, linkModeLinksStore: CodableStore, pairingStore: WCPairingStorage, - supportLinkMode: Bool) { + supportLinkMode: Bool, + eventsClient: EventsClientProtocol + ) { self.networkingInteractor = networkingInteractor self.logger = logger self.rpcHistory = rpcHistory @@ -50,6 +53,8 @@ class AuthResponseSubscriber { self.linkModeLinksStore = linkModeLinksStore self.supportLinkMode = supportLinkMode self.pairingStore = pairingStore + self.eventsClient = eventsClient + subscribeForResponse() subscribeForLinkResponse() } @@ -94,6 +99,7 @@ class AuthResponseSubscriber { private func subscribeForLinkResponse() { linkEnvelopesDispatcher.responseErrorSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in + Task { eventsClient.saveMessageEvent(.sessionAuthenticateLinkModeResponseRejectReceived(payload.id)) } guard let error = AuthError(code: payload.error.code) else { return } authResponsePublisherSubject.send((payload.id, .failure(error))) }.store(in: &publishers) @@ -101,6 +107,8 @@ class AuthResponseSubscriber { linkEnvelopesDispatcher.responseSubscription(on: SessionAuthenticatedProtocolMethod.responseApprove()) .sink { [unowned self] (payload: ResponseSubscriptionPayload) in + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionAuthenticateLinkModeResponseApproveReceived(payload.id)) } + _ = getTransportTypeUpgradeIfPossible(peerMetadata: payload.response.responder.metadata, requestId: payload.id) let pairingTopic = payload.topic diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift index 684e5522a..2b1d78d0a 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionRequester.swift @@ -5,15 +5,18 @@ final class LinkSessionRequester { private let sessionStore: WCSessionStorage private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let logger: ConsoleLogging + private let eventsClient: EventsClientProtocol init( sessionStore: WCSessionStorage, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, - logger: ConsoleLogging + logger: ConsoleLogging, + eventsClient: EventsClientProtocol ) { self.sessionStore = sessionStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.logger = logger + self.eventsClient = eventsClient } func request(_ request: Request) async throws -> String? { @@ -33,6 +36,8 @@ final class LinkSessionRequester { let ttl = try request.calculateTtl() let protocolMethod = SessionRequestProtocolMethod(ttl: ttl) let rpcRequest = RPCRequest(method: protocolMethod.method, params: sessionRequestParams, rpcid: request.id) - return try await linkEnvelopesDispatcher.request(topic: session.topic, request: rpcRequest, peerUniversalLink: peerUniversalLink, envelopeType: .type0) + let envelope = try await linkEnvelopesDispatcher.request(topic: session.topic, request: rpcRequest, peerUniversalLink: peerUniversalLink, envelopeType: .type0) + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionRequestLinkModeSent(request.id)) } + return envelope } } diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift index 5d215be7a..ea6df02c7 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/LinkSessionResponder.swift @@ -10,19 +10,22 @@ class LinkSessionResponder { private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher private let sessionRequestsProvider: SessionRequestsProvider private let historyService: HistoryService + private let eventsClient: EventsClientProtocol init( logger: ConsoleLogging, sessionStore: WCSessionStorage, linkEnvelopesDispatcher: LinkEnvelopesDispatcher, sessionRequestsProvider: SessionRequestsProvider, - historyService: HistoryService + historyService: HistoryService, + eventsClient: EventsClientProtocol ) { self.logger = logger self.sessionStore = sessionStore self.linkEnvelopesDispatcher = linkEnvelopesDispatcher self.sessionRequestsProvider = sessionRequestsProvider self.historyService = historyService + self.eventsClient = eventsClient } func respondSessionRequest(topic: String, requestId: RPCID, response: RPCResult) async throws -> String { @@ -41,6 +44,7 @@ class LinkSessionResponder { guard sessionRequestNotExpired(requestId: requestId) else { logger.debug("request expired") + try await linkEnvelopesDispatcher.respondError( topic: topic, requestId: requestId, @@ -48,6 +52,8 @@ class LinkSessionResponder { reason: SignReasonCode.sessionRequestExpired, envelopeType: .type0 ) + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionRequestLinkModeResponseSent(requestId)) } + throw Errors.sessionRequestExpired } @@ -58,6 +64,8 @@ class LinkSessionResponder { peerUniversalLink: peerUniversalLink, envelopeType: .type0 ) + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionRequestLinkModeResponseSent(requestId)) } + DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in guard let self = self else {return} sessionRequestsProvider.emitRequestIfPending() diff --git a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift index 36708c376..53f5221cc 100644 --- a/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift +++ b/Sources/WalletConnectSign/LinkAndRelayDispatchers/WalletErrorResponder.swift @@ -13,20 +13,23 @@ actor WalletErrorResponder { private let rpcHistory: RPCHistory private let logger: ConsoleLogging private let linkEnvelopesDispatcher: LinkEnvelopesDispatcher + private let eventsClient: EventsClientProtocol init(networkingInteractor: NetworkInteracting, logger: ConsoleLogging, kms: KeyManagementServiceProtocol, rpcHistory: RPCHistory, - linkEnvelopesDispatcher: LinkEnvelopesDispatcher) { + linkEnvelopesDispatcher: LinkEnvelopesDispatcher, + eventsClient: EventsClientProtocol + ) { self.networkingInteractor = networkingInteractor self.logger = logger self.kms = kms self.rpcHistory = rpcHistory self.linkEnvelopesDispatcher = linkEnvelopesDispatcher + self.eventsClient = eventsClient } - func respondError(_ error: AuthError, requestId: RPCID) async throws -> String? { let transportType = try getHistoryRecord(requestId: requestId).transportType ?? .relay @@ -69,7 +72,11 @@ actor WalletErrorResponder { throw Errors.peerUniversalLinkNotFound } - return try await linkEnvelopesDispatcher.respondError(topic: topic, requestId: requestId, peerUniversalLink: peerUniversalLink, reason: error, envelopeType: .type1(pubKey: type1EnvelopeKey)) + let envelope = try await linkEnvelopesDispatcher.respondError(topic: topic, requestId: requestId, peerUniversalLink: peerUniversalLink, reason: error, envelopeType: .type1(pubKey: type1EnvelopeKey)) + + Task(priority: .low) { eventsClient.saveMessageEvent(.sessionAuthenticateLinkModeResponseRejectSent(requestId)) } + + return envelope } diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 523eff3a4..3c8c61271 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -125,7 +125,7 @@ public struct SignClientFactory { let pendingRequestsProvider = PendingRequestsProvider(rpcHistory: rpcHistory, verifyContextStore: verifyContextStore) let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) - let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore) + let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, eventsClient: eventsClient) let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher, verifyClient: verifyClient, verifyContextStore: verifyContextStore) let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, eventsClient: eventsClient, pairingStore: pairingStore) From 9e7744dd7117f14801796d6a36a522b02fc479f0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 13:27:47 +0200 Subject: [PATCH 736/814] fix build --- .../Sign/SignClientFactory.swift | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 3c8c61271..0b2628f01 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -115,9 +115,9 @@ public struct SignClientFactory { let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) let supportLinkMode = metadata.redirect?.linkMode ?? false - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, pairingStore: pairingStore, supportLinkMode: supportLinkMode) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, pairingStore: pairingStore, supportLinkMode: supportLinkMode, eventsClient: <#any EventsClientProtocol#>) - let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher) + let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher, eventsClient: <#any EventsClientProtocol#>) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder, networkingInteractor: networkingClient, verifyContextStore: verifyContextStore, verifyClient: verifyClient) @@ -126,24 +126,24 @@ public struct SignClientFactory { let authResponseTopicResubscriptionService = AuthResponseTopicResubscriptionService(networkingInteractor: networkingClient, logger: logger, authResponseTopicRecordsStore: authResponseTopicRecordsStore) let linkAuthRequester = LinkAuthRequester(kms: kms, appMetadata: metadata, logger: logger, iatProvader: iatProvider, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, eventsClient: eventsClient) - let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher, verifyClient: verifyClient, verifyContextStore: verifyContextStore) + let linkAuthRequestSubscriber = LinkAuthRequestSubscriber(logger: logger, kms: kms, envelopesDispatcher: linkEnvelopesDispatcher, verifyClient: verifyClient, verifyContextStore: verifyContextStore, eventsClient: eventsClient) let relaySessionAuthenticateResponder = SessionAuthenticateResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, verifyContextStore: verifyContextStore, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, eventsClient: eventsClient, pairingStore: pairingStore) - let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder, verifyContextStore: verifyContextStore) + let linkSessionAuthenticateResponder = LinkSessionAuthenticateResponder(linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, kms: kms, metadata: metadata, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, walletErrorResponder: walletErrorResponder, verifyContextStore: verifyContextStore, eventsClient: eventsClient) let approveSessionAuthenticateDispatcher = ApproveSessionAuthenticateDispatcher(relaySessionAuthenticateResponder: relaySessionAuthenticateResponder, logger: logger, rpcHistory: rpcHistory, approveSessionAuthenticateUtil: approveSessionAuthenticateUtil, linkSessionAuthenticateResponder: linkSessionAuthenticateResponder) let relaySessionRequester = SessionRequester(sessionStore: sessionStore, networkingInteractor: networkingClient, logger: logger) - let linkSessionRequester = LinkSessionRequester(sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger) + let linkSessionRequester = LinkSessionRequester(sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, logger: logger, eventsClient: eventsClient) let sessionRequestDispatcher = SessionRequestDispatcher(relaySessionRequester: relaySessionRequester, linkSessionRequester: linkSessionRequester, logger: logger, sessionStore: sessionStore) - let linkSessionRequestSubscriber = LinkSessionRequestSubscriber(sessionRequestsProvider: sessionRequestsProvider, sessionStore: sessionStore, logger: logger, envelopesDispatcher: linkEnvelopesDispatcher) + let linkSessionRequestSubscriber = LinkSessionRequestSubscriber(sessionRequestsProvider: sessionRequestsProvider, sessionStore: sessionStore, logger: logger, envelopesDispatcher: linkEnvelopesDispatcher, eventsClient: eventsClient) let relaySessionResponder = SessionResponder(logger: logger, sessionStore: sessionStore, networkingInteractor: networkingClient, verifyContextStore: verifyContextStore, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService) - let linkSessionResponder = LinkSessionResponder(logger: logger, sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService) + let linkSessionResponder = LinkSessionResponder(logger: logger, sessionStore: sessionStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, sessionRequestsProvider: sessionRequestsProvider, historyService: historyService, eventsClient: eventsClient) let sessionResponderDispatcher = SessionResponderDispatcher(relaySessionResponder: relaySessionResponder, linkSessionResponder: linkSessionResponder, logger: logger, sessionStore: sessionStore) - let linkSessionRequestResponseSubscriber = LinkSessionRequestResponseSubscriber(envelopesDispatcher: linkEnvelopesDispatcher) + let linkSessionRequestResponseSubscriber = LinkSessionRequestResponseSubscriber(envelopesDispatcher: linkEnvelopesDispatcher, eventsClient: eventsClient) let authenticateTransportTypeSwitcher = AuthenticateTransportTypeSwitcher(linkAuthRequester: linkAuthRequester, pairingClient: pairingClient, logger: logger, appRequestService: appRequestService, appProposeService: appProposerService) From 783c99250e3aaa90fda54b1eb1d27a6c32b91e70 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 20 Aug 2024 14:54:07 +0200 Subject: [PATCH 737/814] fix build --- Sources/Events/EventsClient.swift | 1 + Sources/WalletConnectSign/Sign/SignClientFactory.swift | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index b283b60ac..1668c117c 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -59,6 +59,7 @@ public class EventsClient: EventsClientProtocol { } public func saveMessageEvent(_ event: MessageEventType) { +// always enable? guard stateStorage.telemetryEnabled else { return } logger.debug("Will store a message event: \(event)") messageEventsStorage.saveMessageEvent(event) diff --git a/Sources/WalletConnectSign/Sign/SignClientFactory.swift b/Sources/WalletConnectSign/Sign/SignClientFactory.swift index 0b2628f01..fca63020d 100644 --- a/Sources/WalletConnectSign/Sign/SignClientFactory.swift +++ b/Sources/WalletConnectSign/Sign/SignClientFactory.swift @@ -115,9 +115,9 @@ public struct SignClientFactory { let linkModeLinksStore = CodableStore(defaults: keyValueStorage, identifier: SignStorageIdentifiers.linkModeLinks.rawValue) let supportLinkMode = metadata.redirect?.linkMode ?? false - let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, pairingStore: pairingStore, supportLinkMode: supportLinkMode, eventsClient: <#any EventsClientProtocol#>) + let appRespondSubscriber = AuthResponseSubscriber(networkingInteractor: networkingClient, logger: logger, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, pairingRegisterer: pairingClient, kms: kms, sessionStore: sessionStore, messageFormatter: messageFormatter, sessionNamespaceBuilder: sessionNameSpaceBuilder, authResponseTopicRecordsStore: authResponseTopicRecordsStore, linkEnvelopesDispatcher: linkEnvelopesDispatcher, linkModeLinksStore: linkModeLinksStore, pairingStore: pairingStore, supportLinkMode: supportLinkMode, eventsClient: eventsClient) - let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher, eventsClient: <#any EventsClientProtocol#>) + let walletErrorResponder = WalletErrorResponder(networkingInteractor: networkingClient, logger: logger, kms: kms, rpcHistory: rpcHistory, linkEnvelopesDispatcher: linkEnvelopesDispatcher, eventsClient: eventsClient) let authRequestSubscriber = AuthRequestSubscriber(networkingInteractor: networkingClient, logger: logger, kms: kms, walletErrorResponder: walletErrorResponder, pairingRegisterer: pairingClient, verifyClient: verifyClient, verifyContextStore: verifyContextStore, pairingStore: pairingStore) let approveSessionAuthenticateUtil = ApproveSessionAuthenticateUtil(logger: logger, kms: kms, rpcHistory: rpcHistory, signatureVerifier: signatureVerifier, messageFormatter: messageFormatter, sessionStore: sessionStore, sessionNamespaceBuilder: sessionNameSpaceBuilder, networkingInteractor: networkingClient, verifyContextStore: verifyContextStore, verifyClient: verifyClient) From 09aef59296e0f96b1d31a058a1ecdc2a314aec58 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 08:21:30 +0200 Subject: [PATCH 738/814] always enable for messages --- Sources/Events/EventsClient.swift | 2 -- 1 file changed, 2 deletions(-) diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index 1668c117c..da0dd30bd 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -59,8 +59,6 @@ public class EventsClient: EventsClientProtocol { } public func saveMessageEvent(_ event: MessageEventType) { -// always enable? - guard stateStorage.telemetryEnabled else { return } logger.debug("Will store a message event: \(event)") messageEventsStorage.saveMessageEvent(event) } From 35f95c883007bb561abda4968a9b21d7987ee0d6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 08:32:02 +0200 Subject: [PATCH 739/814] rename direction enum case --- Sources/Events/MessageEvent.swift | 2 +- Sources/Events/MessageEventType.swift | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/Events/MessageEvent.swift b/Sources/Events/MessageEvent.swift index dcc4aee56..5c884aee2 100644 --- a/Sources/Events/MessageEvent.swift +++ b/Sources/Events/MessageEvent.swift @@ -22,7 +22,7 @@ struct MessageEvent: Codable { } enum Direction: String, Codable { - case send + case sent case received } diff --git a/Sources/Events/MessageEventType.swift b/Sources/Events/MessageEventType.swift index fe27cbf31..53aa30d83 100644 --- a/Sources/Events/MessageEventType.swift +++ b/Sources/Events/MessageEventType.swift @@ -51,7 +51,7 @@ public enum MessageEventType { .sessionAuthenticateLinkModeResponseRejectSent, .sessionRequestLinkModeSent, .sessionRequestLinkModeResponseSent: - return .send + return .sent case .sessionAuthenticateLinkModeReceived, .sessionAuthenticateLinkModeResponseApproveReceived, .sessionAuthenticateLinkModeResponseRejectReceived, From e6dd8e08285c7ecd4373e702c2a9bac8d1c3caa0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 11:26:14 +0200 Subject: [PATCH 740/814] savepoint --- Sources/WalletConnectRelay/Dispatching.swift | 9 ++++++--- Sources/WalletConnectRelay/RelayClient.swift | 6 +++++- .../AutomaticSocketConnectionHandler.swift | 16 ++++++++++++---- .../ManualSocketConnectionHandler.swift | 6 +++++- .../SocketConnectionHandler.swift | 3 +++ 5 files changed, 31 insertions(+), 9 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 3af72ce97..bece016f4 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -6,7 +6,6 @@ protocol Dispatching { var isSocketConnected: Bool { get } var networkConnectionStatusPublisher: AnyPublisher { get } var socketConnectionStatusPublisher: AnyPublisher { get } - func send(_ string: String, completion: @escaping (Error?) -> Void) func protectedSend(_ string: String, completion: @escaping (Error?) -> Void) func protectedSend(_ string: String) async throws func connect() throws @@ -59,7 +58,7 @@ final class Dispatcher: NSObject, Dispatching { setUpSocketConnectionObserving() } - func send(_ string: String, completion: @escaping (Error?) -> Void) { + private func send(_ string: String, completion: @escaping (Error?) -> Void) { guard socket.isConnected else { completion(NetworkError.connectionFailed) return @@ -74,12 +73,16 @@ final class Dispatcher: NSObject, Dispatching { return send(string, completion: completion) } + if !socket.isConnected { + socketConnectionHandler.handleInternalConnect() + } + var cancellable: AnyCancellable? cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) .filter { $0.0 == .connected && $0.1 == .connected } .setFailureType(to: NetworkError.self) .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) - .sink(receiveCompletion: { [unowned self] result in + .sink(receiveCompletion: { result in switch result { case .failure(let error): cancellable?.cancel() diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index f51f69c84..63279a80b 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -55,6 +55,7 @@ public final class RelayClient { private var dispatcher: Dispatching private let rpcHistory: RPCHistory private let logger: ConsoleLogging + private let subscriptionsTracker: SubscriptionsTracker private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.relay_client", qos: .utility, attributes: .concurrent) @@ -69,15 +70,18 @@ public final class RelayClient { dispatcher: Dispatching, logger: ConsoleLogging, rpcHistory: RPCHistory, - clientIdStorage: ClientIdStoring + clientIdStorage: ClientIdStoring, + subscriptionsTracker: SubscriptionsTracker ) { self.logger = logger self.dispatcher = dispatcher self.rpcHistory = rpcHistory self.clientIdStorage = clientIdStorage + self.subscriptionsTracker = subscriptionsTracker setUpBindings() } + private func setUpBindings() { dispatcher.onMessage = { [weak self] payload in self?.handlePayloadMessage(payload) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index c9ea12219..763af0025 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -35,9 +35,6 @@ class AutomaticSocketConnectionHandler { setUpStateObserving() setUpNetworkMonitoring() - - connect() - } func connect() { @@ -97,8 +94,9 @@ class AutomaticSocketConnectionHandler { } private func reconnectIfNeeded() { + check if it is subscribed to anything and only then subscribe if !socket.isConnected { - socket.connect() + connect() } } } @@ -106,6 +104,10 @@ class AutomaticSocketConnectionHandler { // MARK: - SocketConnectionHandler extension AutomaticSocketConnectionHandler: SocketConnectionHandler { + func handleInternalConnect() { + connect() + } + func handleConnect() throws { throw Errors.manualSocketConnectionForbidden } @@ -119,3 +121,9 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { reconnectIfNeeded() } } + + +class SubscriptionsTracker { + var subscriptions: [String: String] = [:] + +} diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift index 04152bd21..daf2d1c76 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/ManualSocketConnectionHandler.swift @@ -1,7 +1,6 @@ import Foundation class ManualSocketConnectionHandler: SocketConnectionHandler { - private let socket: WebSocketConnecting private let logger: ConsoleLogging private let defaultTimeout: Int = 60 @@ -37,6 +36,11 @@ class ManualSocketConnectionHandler: SocketConnectionHandler { socket.disconnect() } + func handleInternalConnect() { + // No operation + } + + func handleDisconnection() async { // No operation // ManualSocketConnectionHandler does not support reconnection logic diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift index 4ac3046dd..808ee43df 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift @@ -1,7 +1,10 @@ import Foundation protocol SocketConnectionHandler { + /// handles connection request from the sdk consumes func handleConnect() throws + /// handles connection request from sdk's internal function + func handleInternalConnect() func handleDisconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws func handleDisconnection() async } From e7a29f0bf290eb4a4595fade397b7f8d9fa71e08 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 11:40:15 +0200 Subject: [PATCH 741/814] add SubscriptionsTracker --- Sources/WalletConnectRelay/RelayClient.swift | 25 ++++++-------- .../AutomaticSocketConnectionHandler.swift | 5 --- .../SubscriptionsTracker.swift | 34 +++++++++++++++++++ 3 files changed, 44 insertions(+), 20 deletions(-) create mode 100644 Sources/WalletConnectRelay/SubscriptionsTracker.swift diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 63279a80b..fd075a6ec 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -187,14 +187,13 @@ public final class RelayClient { } public func unsubscribe(topic: String, completion: ((Error?) -> Void)?) { - guard let subscriptionId = subscriptions[topic] else { + guard let subscriptionId = subscriptionsTracker.getSubscription(for: topic) else { completion?(Errors.subscriptionIdNotFound) return } logger.debug("Unsubscribing from topic: \(topic)") let rpc = Unsubscribe(params: .init(id: subscriptionId, topic: topic)) - let request = rpc - .asRPCRequest() + let request = rpc.asRPCRequest() let message = try! request.asJSONEncodedString() rpcHistory.deleteAll(forTopic: topic) dispatcher.protectedSend(message) { [weak self] error in @@ -202,9 +201,7 @@ public final class RelayClient { self?.logger.debug("Failed to unsubscribe from topic") completion?(error) } else { - self?.concurrentQueue.async(flags: .barrier) { - self?.subscriptions[topic] = nil - } + self?.subscriptionsTracker.removeSubscription(for: topic) completion?(nil) } } @@ -217,15 +214,13 @@ public final class RelayClient { .filter { $0.0 == requestId } .sink { [unowned self] (_, subscriptionIds) in cancellable?.cancel() - concurrentQueue.async(flags: .barrier) { [unowned self] in - logger.debug("Subscribed to topics: \(topics)") - guard topics.count == subscriptionIds.count else { - logger.warn("Number of topics in (batch)subscribe does not match number of subscriptions") - return - } - for i in 0.. String? { + var result: String? + concurrentQueue.sync { + result = self.subscriptions[topic] + } + return result + } + + func removeSubscription(for topic: String) { + concurrentQueue.async(flags: .barrier) { + self.subscriptions[topic] = nil + } + } + + func isSubscribed() -> Bool { + var result = false + concurrentQueue.sync { + result = !self.subscriptions.isEmpty + } + return result + } +} From b82a9b5d57c56f854afe0af6ac88517a61c81dc0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 12:49:06 +0200 Subject: [PATCH 742/814] fix relay tests --- .../xcschemes/RelayerTests.xcscheme | 54 ++++++++++ Sources/WalletConnectRelay/Dispatching.swift | 3 +- Sources/WalletConnectRelay/RelayClient.swift | 6 +- .../RelayClientFactory.swift | 5 +- .../AutomaticSocketConnectionHandler.swift | 9 +- .../SubscriptionsTracker.swift | 37 ++++++- ...utomaticSocketConnectionHandlerTests.swift | 98 +++++++++++++++++++ Tests/RelayerTests/RelayClientTests.swift | 8 +- 8 files changed, 206 insertions(+), 14 deletions(-) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/RelayerTests.xcscheme diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/RelayerTests.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/RelayerTests.xcscheme new file mode 100644 index 000000000..f4fc9ed05 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/RelayerTests.xcscheme @@ -0,0 +1,54 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index bece016f4..37ae0884e 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -6,6 +6,7 @@ protocol Dispatching { var isSocketConnected: Bool { get } var networkConnectionStatusPublisher: AnyPublisher { get } var socketConnectionStatusPublisher: AnyPublisher { get } + func send(_ string: String, completion: @escaping (Error?) -> Void) func protectedSend(_ string: String, completion: @escaping (Error?) -> Void) func protectedSend(_ string: String) async throws func connect() throws @@ -58,7 +59,7 @@ final class Dispatcher: NSObject, Dispatching { setUpSocketConnectionObserving() } - private func send(_ string: String, completion: @escaping (Error?) -> Void) { + func send(_ string: String, completion: @escaping (Error?) -> Void) { guard socket.isConnected else { completion(NetworkError.connectionFailed) return diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index fd075a6ec..5212b8ccb 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -20,8 +20,6 @@ public final class RelayClient { case subscriptionIdNotFound } - var subscriptions: [String: String] = [:] - public var isSocketConnected: Bool { return dispatcher.isSocketConnected } @@ -55,7 +53,7 @@ public final class RelayClient { private var dispatcher: Dispatching private let rpcHistory: RPCHistory private let logger: ConsoleLogging - private let subscriptionsTracker: SubscriptionsTracker + private let subscriptionsTracker: SubscriptionsTracking private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.relay_client", qos: .utility, attributes: .concurrent) @@ -71,7 +69,7 @@ public final class RelayClient { logger: ConsoleLogging, rpcHistory: RPCHistory, clientIdStorage: ClientIdStoring, - subscriptionsTracker: SubscriptionsTracker + subscriptionsTracker: SubscriptionsTracking ) { self.logger = logger self.dispatcher = dispatcher diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index 2120b720e..f00295fe0 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -61,10 +61,11 @@ public struct RelayClientFactory { if let bundleId = Bundle.main.bundleIdentifier { socket.request.addValue(bundleId, forHTTPHeaderField: "Origin") } + let subscriptionsTracker = SubscriptionsTracker() var socketConnectionHandler: SocketConnectionHandler! switch socketConnectionType { - case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger) + case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, subscriptionsTracker: subscriptionsTracker, logger: logger) case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket, logger: logger) } @@ -79,6 +80,6 @@ public struct RelayClientFactory { let rpcHistory = RPCHistoryFactory.createForRelay(keyValueStorage: keyValueStorage) - return RelayClient(dispatcher: dispatcher, logger: logger, rpcHistory: rpcHistory, clientIdStorage: clientIdStorage) + return RelayClient(dispatcher: dispatcher, logger: logger, rpcHistory: rpcHistory, clientIdStorage: clientIdStorage, subscriptionsTracker: subscriptionsTracker) } } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 5789e8a76..0e7b982bf 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -16,6 +16,7 @@ class AutomaticSocketConnectionHandler { private let backgroundTaskRegistrar: BackgroundTaskRegistering private let defaultTimeout: Int = 60 private let logger: ConsoleLogging + private let subscriptionsTracker: SubscriptionsTracking private var publishers = Set() private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", qos: .utility, attributes: .concurrent) @@ -25,6 +26,7 @@ class AutomaticSocketConnectionHandler { networkMonitor: NetworkMonitoring = NetworkMonitor(), appStateObserver: AppStateObserving = AppStateObserver(), backgroundTaskRegistrar: BackgroundTaskRegistering = BackgroundTaskRegistrar(), + subscriptionsTracker: SubscriptionsTracking, logger: ConsoleLogging ) { self.appStateObserver = appStateObserver @@ -32,6 +34,7 @@ class AutomaticSocketConnectionHandler { self.networkMonitor = networkMonitor self.backgroundTaskRegistrar = backgroundTaskRegistrar self.logger = logger + self.subscriptionsTracker = subscriptionsTracker setUpStateObserving() setUpNetworkMonitoring() @@ -93,9 +96,9 @@ class AutomaticSocketConnectionHandler { } } - private func reconnectIfNeeded() { - check if it is subscribed to anything and only then subscribe - if !socket.isConnected { + func reconnectIfNeeded() { + // Check if client has active subscriptions and only then subscribe + if !socket.isConnected && subscriptionsTracker.isSubscribed() { connect() } } diff --git a/Sources/WalletConnectRelay/SubscriptionsTracker.swift b/Sources/WalletConnectRelay/SubscriptionsTracker.swift index d0a8e777b..71aaeebf5 100644 --- a/Sources/WalletConnectRelay/SubscriptionsTracker.swift +++ b/Sources/WalletConnectRelay/SubscriptionsTracker.swift @@ -1,6 +1,13 @@ import Foundation -public final class SubscriptionsTracker { +protocol SubscriptionsTracking { + func setSubscription(for topic: String, id: String) + func getSubscription(for topic: String) -> String? + func removeSubscription(for topic: String) + func isSubscribed() -> Bool +} + +public final class SubscriptionsTracker: SubscriptionsTracking { private var subscriptions: [String: String] = [:] private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.subscriptions_tracker", attributes: .concurrent) @@ -32,3 +39,31 @@ public final class SubscriptionsTracker { return result } } + +#if DEBUG +final class SubscriptionsTrackerMock: SubscriptionsTracking { + var isSubscribedReturnValue: Bool = false + private var subscriptions: [String: String] = [:] + + func setSubscription(for topic: String, id: String) { + subscriptions[topic] = id + } + + func getSubscription(for topic: String) -> String? { + return subscriptions[topic] + } + + func removeSubscription(for topic: String) { + subscriptions[topic] = nil + } + + func isSubscribed() -> Bool { + return isSubscribedReturnValue + } + + func reset() { + subscriptions.removeAll() + isSubscribedReturnValue = false + } +} +#endif diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index 368d25da4..101fdf3ad 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -8,6 +8,7 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { var networkMonitor: NetworkMonitoringMock! var appStateObserver: AppStateObserverMock! var backgroundTaskRegistrar: BackgroundTaskRegistrarMock! + var subscriptionsTracker: SubscriptionsTrackerMock! override func setUp() { webSocketSession = WebSocketMock() @@ -28,17 +29,21 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { socketAuthenticator: socketAuthenticator ) backgroundTaskRegistrar = BackgroundTaskRegistrarMock() + subscriptionsTracker = SubscriptionsTrackerMock() + sut = AutomaticSocketConnectionHandler( socket: webSocketSession, networkMonitor: networkMonitor, appStateObserver: appStateObserver, backgroundTaskRegistrar: backgroundTaskRegistrar, + subscriptionsTracker: subscriptionsTracker, logger: ConsoleLoggerMock() ) } func testConnectsOnConnectionSatisfied() { webSocketSession.disconnect() + subscriptionsTracker.isSubscribedReturnValue = true // Simulate that there are active subscriptions XCTAssertFalse(webSocketSession.isConnected) networkMonitor.networkConnectionStatusPublisherSubject.send(.connected) XCTAssertTrue(webSocketSession.isConnected) @@ -53,11 +58,19 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { } func testReconnectsOnEnterForeground() { + subscriptionsTracker.isSubscribedReturnValue = true // Simulate that there are active subscriptions webSocketSession.disconnect() appStateObserver.onWillEnterForeground?() XCTAssertTrue(webSocketSession.isConnected) } + func testReconnectsOnEnterForegroundWhenNoSubscriptions() { + subscriptionsTracker.isSubscribedReturnValue = false // Simulate no active subscriptions + webSocketSession.disconnect() + appStateObserver.onWillEnterForeground?() + XCTAssertFalse(webSocketSession.isConnected) // The connection should not be re-established + } + func testRegisterTaskOnEnterBackground() { XCTAssertNil(backgroundTaskRegistrar.completion) appStateObserver.onWillEnterBackground?() @@ -66,12 +79,15 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { func testDisconnectOnEndBackgroundTask() { appStateObserver.onWillEnterBackground?() + webSocketSession.connect() XCTAssertTrue(webSocketSession.isConnected) backgroundTaskRegistrar.completion!() XCTAssertFalse(webSocketSession.isConnected) } func testReconnectOnDisconnectForeground() async { + subscriptionsTracker.isSubscribedReturnValue = true // Simulate that there are active subscriptions + webSocketSession.connect() appStateObserver.currentState = .foreground XCTAssertTrue(webSocketSession.isConnected) webSocketSession.disconnect() @@ -79,11 +95,93 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { XCTAssertTrue(webSocketSession.isConnected) } + func testNotReconnectOnDisconnectForegroundWhenNoSubscriptions() async { + subscriptionsTracker.isSubscribedReturnValue = false // Simulate no active subscriptions + webSocketSession.connect() + appStateObserver.currentState = .foreground + XCTAssertTrue(webSocketSession.isConnected) + webSocketSession.disconnect() + await sut.handleDisconnection() + XCTAssertFalse(webSocketSession.isConnected) // The connection should not be re-established + } + func testReconnectOnDisconnectBackground() async { + subscriptionsTracker.isSubscribedReturnValue = true // Simulate that there are active subscriptions + webSocketSession.connect() + appStateObserver.currentState = .background + XCTAssertTrue(webSocketSession.isConnected) + webSocketSession.disconnect() + await sut.handleDisconnection() + XCTAssertFalse(webSocketSession.isConnected) + } + + func testNotReconnectOnDisconnectBackgroundWhenNoSubscriptions() async { + subscriptionsTracker.isSubscribedReturnValue = false // Simulate no active subscriptions + webSocketSession.connect() appStateObserver.currentState = .background XCTAssertTrue(webSocketSession.isConnected) webSocketSession.disconnect() await sut.handleDisconnection() + XCTAssertFalse(webSocketSession.isConnected) // The connection should not be re-established + } + + func testReconnectIfNeededWhenSubscribed() { + // Simulate that there are active subscriptions + subscriptionsTracker.isSubscribedReturnValue = true + + // Ensure socket is disconnected initially + webSocketSession.disconnect() XCTAssertFalse(webSocketSession.isConnected) + + // Trigger reconnect logic + sut.reconnectIfNeeded() + + // Expect the socket to be connected since there are subscriptions + XCTAssertTrue(webSocketSession.isConnected) + } + + func testReconnectIfNeededWhenNotSubscribed() { + // Simulate that there are no active subscriptions + subscriptionsTracker.isSubscribedReturnValue = false + + // Ensure socket is disconnected initially + webSocketSession.disconnect() + XCTAssertFalse(webSocketSession.isConnected) + + // Trigger reconnect logic + sut.reconnectIfNeeded() + + // Expect the socket to remain disconnected since there are no subscriptions + XCTAssertFalse(webSocketSession.isConnected) + } + + func testReconnectsOnConnectionSatisfiedWhenSubscribed() { + // Simulate that there are active subscriptions + subscriptionsTracker.isSubscribedReturnValue = true + + // Ensure socket is disconnected initially + webSocketSession.disconnect() + XCTAssertFalse(webSocketSession.isConnected) + + // Simulate network connection becomes satisfied + networkMonitor.networkConnectionStatusPublisherSubject.send(.connected) + + // Expect the socket to reconnect since there are subscriptions + XCTAssertTrue(webSocketSession.isConnected) + } + + func testReconnectsOnEnterForegroundWhenSubscribed() { + // Simulate that there are active subscriptions + subscriptionsTracker.isSubscribedReturnValue = true + + // Ensure socket is disconnected initially + webSocketSession.disconnect() + XCTAssertFalse(webSocketSession.isConnected) + + // Simulate entering foreground + appStateObserver.onWillEnterForeground?() + + // Expect the socket to reconnect since there are subscriptions + XCTAssertTrue(webSocketSession.isConnected) } } diff --git a/Tests/RelayerTests/RelayClientTests.swift b/Tests/RelayerTests/RelayClientTests.swift index d767623e4..884c8047f 100644 --- a/Tests/RelayerTests/RelayClientTests.swift +++ b/Tests/RelayerTests/RelayClientTests.swift @@ -10,13 +10,15 @@ final class RelayClientTests: XCTestCase { var sut: RelayClient! var dispatcher: DispatcherMock! var publishers = Set() + var subscriptionsTracker: SubscriptionsTrackerMock! override func setUp() { dispatcher = DispatcherMock() let logger = ConsoleLogger() let clientIdStorage = ClientIdStorageMock() let rpcHistory = RPCHistoryFactory.createForRelay(keyValueStorage: RuntimeKeyValueStorage()) - sut = RelayClient(dispatcher: dispatcher, logger: logger, rpcHistory: rpcHistory, clientIdStorage: clientIdStorage) + subscriptionsTracker = SubscriptionsTrackerMock() + sut = RelayClient(dispatcher: dispatcher, logger: logger, rpcHistory: rpcHistory, clientIdStorage: clientIdStorage, subscriptionsTracker: subscriptionsTracker) } override func tearDown() { @@ -50,7 +52,7 @@ final class RelayClientTests: XCTestCase { func testUnsubscribeRequest() { let topic = String.randomTopic() - sut.subscriptions[topic] = "" + subscriptionsTracker.setSubscription(for: topic, id: "") sut.unsubscribe(topic: topic) { error in XCTAssertNil(error) } @@ -78,7 +80,7 @@ final class RelayClientTests: XCTestCase { func testSendOnUnsubscribe() { let topic = "123" - sut.subscriptions[topic] = "" + subscriptionsTracker.setSubscription(for: topic, id: "") sut.unsubscribe(topic: topic) {_ in } XCTAssertTrue(dispatcher.sent) } From 83b3bea0000d438e9e4dff087ea12088ddea8f23 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 13:44:02 +0200 Subject: [PATCH 743/814] fix tests --- Example/RelayIntegrationTests/RelayClientEndToEndTests.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index e52094049..5e69702cc 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -52,7 +52,7 @@ final class RelayClientEndToEndTests: XCTestCase { socketAuthenticator: socketAuthenticator ) - let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, logger: logger) + let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, subscriptionsTracker: SubscriptionsTracker(), logger: logger) let dispatcher = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: urlFactory, From 4d8181e3773ec2fb3488e69d09c23c91bf64eb94 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 21 Aug 2024 13:48:06 +0200 Subject: [PATCH 744/814] update rn link mode --- Example/DApp/SceneDelegate.swift | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 03d23797f..448c3bd66 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -125,7 +125,7 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", order: 1, mobileLink: "rn-web3wallet://", - linkMode: "https://lab.web3modal.com/walletkit_rn" + linkMode: "https://lab.web3modal.com/rn_walletkit" ), .init( id: "flutter-sample", From e588da52a386939db33b3fbbff1cb5352e55c415 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Aug 2024 06:45:51 +0200 Subject: [PATCH 745/814] fix message event --- Sources/Events/MessageEventProperties.swift | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/Sources/Events/MessageEventProperties.swift b/Sources/Events/MessageEventProperties.swift index 19d6ae2be..7bb3aea50 100644 --- a/Sources/Events/MessageEventProperties.swift +++ b/Sources/Events/MessageEventProperties.swift @@ -1,7 +1,5 @@ - import Foundation - protocol MessageEventsStorage { func saveMessageEvent(_ eventType: MessageEventType) func fetchMessageEvents() -> [MessageEvent] @@ -16,12 +14,13 @@ class UserDefaultsMessageEventsStorage: MessageEventsStorage { let correlationId = eventType.rpcId.integer let type = "\(eventType.tag)" let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" + let clientId = (try? Networking.interactor.getClientId()) ?? "Unknown" let props = MessageEvent.Props( type: type, properties: MessageEvent.Properties( correlationId: correlationId, - clientId: bundleId, + clientId: clientId, direction: eventType.direction ) ) From 794ed319c7bf8211965150375f653a19442b9d61 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Aug 2024 07:54:20 +0200 Subject: [PATCH 746/814] remove comments --- Example/IntegrationTests/Sign/SignClientTests.swift | 2 -- 1 file changed, 2 deletions(-) diff --git a/Example/IntegrationTests/Sign/SignClientTests.swift b/Example/IntegrationTests/Sign/SignClientTests.swift index 6cec32d42..4575da2db 100644 --- a/Example/IntegrationTests/Sign/SignClientTests.swift +++ b/Example/IntegrationTests/Sign/SignClientTests.swift @@ -89,7 +89,6 @@ final class SignClientTests: XCTestCase { } func testSessionPropose() async throws { - //start measuring here let dappSettlementExpectation = expectation(description: "Dapp expects to settle a session") let walletSettlementExpectation = expectation(description: "Wallet expects to settle a session") let requiredNamespaces = ProposalNamespace.stubRequired() @@ -105,7 +104,6 @@ final class SignClientTests: XCTestCase { } }.store(in: &publishers) dapp.sessionSettlePublisher.sink { _ in - //end measuring here dappSettlementExpectation.fulfill() }.store(in: &publishers) wallet.sessionSettlePublisher.sink { _ in From 4df3bb54c7d9e7cdf30dbeecc128dac9c5f7bbdb Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Thu, 22 Aug 2024 12:50:54 +0200 Subject: [PATCH 747/814] resubscribe after disconnecting socket --- Sources/WalletConnectRelay/RelayClient.swift | 15 ++++++++++- .../AutomaticSocketConnectionHandler.swift | 2 ++ .../SubscriptionsTracker.swift | 27 ++++++++++++++----- ...thResponseTopicResubscriptionService.swift | 17 +++++------- .../Engine/Common/SessionEngine.swift | 17 +++++------- 5 files changed, 48 insertions(+), 30 deletions(-) diff --git a/Sources/WalletConnectRelay/RelayClient.swift b/Sources/WalletConnectRelay/RelayClient.swift index 5212b8ccb..a3088bca9 100644 --- a/Sources/WalletConnectRelay/RelayClient.swift +++ b/Sources/WalletConnectRelay/RelayClient.swift @@ -47,6 +47,7 @@ public final class RelayClient { private var requestAcknowledgePublisher: AnyPublisher { requestAcknowledgePublisherSubject.eraseToAnyPublisher() } + private var publishers = [AnyCancellable]() private let clientIdStorage: ClientIdStoring @@ -77,15 +78,27 @@ public final class RelayClient { self.clientIdStorage = clientIdStorage self.subscriptionsTracker = subscriptionsTracker setUpBindings() + setupConnectionSubscriptions() } - private func setUpBindings() { dispatcher.onMessage = { [weak self] payload in self?.handlePayloadMessage(payload) } } + private func setupConnectionSubscriptions() { + socketConnectionStatusPublisher + .sink { [unowned self] status in + guard status == .connected else { return } + let topics = subscriptionsTracker.getTopics() + Task(priority: .high) { + try await batchSubscribe(topics: topics) + } + } + .store(in: &publishers) + } + public func setLogging(level: LoggingLevel) { logger.setLogging(level: level) } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 0e7b982bf..6727c373b 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -96,7 +96,9 @@ class AutomaticSocketConnectionHandler { } } + func reconnectIfNeeded() { + // Check if client has active subscriptions and only then subscribe if !socket.isConnected && subscriptionsTracker.isSubscribed() { connect() diff --git a/Sources/WalletConnectRelay/SubscriptionsTracker.swift b/Sources/WalletConnectRelay/SubscriptionsTracker.swift index 71aaeebf5..2684de202 100644 --- a/Sources/WalletConnectRelay/SubscriptionsTracker.swift +++ b/Sources/WalletConnectRelay/SubscriptionsTracker.swift @@ -5,6 +5,7 @@ protocol SubscriptionsTracking { func getSubscription(for topic: String) -> String? func removeSubscription(for topic: String) func isSubscribed() -> Bool + func getTopics() -> [String] } public final class SubscriptionsTracker: SubscriptionsTracking { @@ -12,32 +13,40 @@ public final class SubscriptionsTracker: SubscriptionsTracking { private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.subscriptions_tracker", attributes: .concurrent) func setSubscription(for topic: String, id: String) { - concurrentQueue.async(flags: .barrier) { + concurrentQueue.async(flags: .barrier) { [unowned self] in self.subscriptions[topic] = id } } func getSubscription(for topic: String) -> String? { var result: String? - concurrentQueue.sync { - result = self.subscriptions[topic] + concurrentQueue.sync { [unowned self] in + result = subscriptions[topic] } return result } func removeSubscription(for topic: String) { - concurrentQueue.async(flags: .barrier) { - self.subscriptions[topic] = nil + concurrentQueue.async(flags: .barrier) { [unowned self] in + subscriptions[topic] = nil } } func isSubscribed() -> Bool { var result = false - concurrentQueue.sync { - result = !self.subscriptions.isEmpty + concurrentQueue.sync { [unowned self] in + result = !subscriptions.isEmpty } return result } + + func getTopics() -> [String] { + var topics: [String] = [] + concurrentQueue.sync { [unowned self] in + topics = Array(subscriptions.keys) + } + return topics + } } #if DEBUG @@ -65,5 +74,9 @@ final class SubscriptionsTrackerMock: SubscriptionsTracking { subscriptions.removeAll() isSubscribedReturnValue = false } + + func getTopics() -> [String] { + return Array(subscriptions.keys) + } } #endif diff --git a/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift b/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift index 4d8af4005..e17ef6426 100644 --- a/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift +++ b/Sources/WalletConnectSign/Auth/Services/AuthResponseTopicResubscriptionService.swift @@ -30,19 +30,14 @@ class AuthResponseTopicResubscriptionService { self.logger = logger self.authResponseTopicRecordsStore = authResponseTopicRecordsStore cleanExpiredRecordsIfNeeded() - setupConnectionSubscriptions() + subscribeResponsTopics() } - func setupConnectionSubscriptions() { - networkingInteractor.socketConnectionStatusPublisher - .sink { [unowned self] status in - guard status == .connected else { return } - let topics = authResponseTopicRecordsStore.getAll().map{$0.topic} - Task(priority: .high) { - try await networkingInteractor.batchSubscribe(topics: topics) - } - } - .store(in: &publishers) + func subscribeResponsTopics() { + let topics = authResponseTopicRecordsStore.getAll().map{$0.topic} + Task(priority: .background) { + try await networkingInteractor.batchSubscribe(topics: topics) + } } func cleanExpiredRecordsIfNeeded() { diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index a18c922c8..7bba80c19 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -45,7 +45,7 @@ final class SessionEngine { self.sessionRequestsProvider = sessionRequestsProvider self.invalidRequestsSanitiser = invalidRequestsSanitiser - setupConnectionSubscriptions() + subscribeActiveSessions() setupRequestSubscriptions() setupResponseSubscriptions() setupUpdateSubscriptions() @@ -88,16 +88,11 @@ final class SessionEngine { private extension SessionEngine { - func setupConnectionSubscriptions() { - networkingInteractor.socketConnectionStatusPublisher - .sink { [unowned self] status in - guard status == .connected else { return } - let topics = sessionStore.getAll().map{$0.topic} - Task(priority: .high) { - try await networkingInteractor.batchSubscribe(topics: topics) - } - } - .store(in: &publishers) + func subscribeActiveSessions() { + let topics = sessionStore.getAll().map{$0.topic} + Task(priority: .background) { + try await networkingInteractor.batchSubscribe(topics: topics) + } } func setupRequestSubscriptions() { From ec680e9082e50052e650fe6e9dbef55a6d8a6142 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Aug 2024 07:00:03 +0200 Subject: [PATCH 748/814] Add SocketStatusProvider --- .../WalletConnectNetworking/Networking.swift | 2 +- Sources/WalletConnectRelay/Dispatching.swift | 33 +++++--- .../AutomaticSocketConnectionHandler.swift | 78 +++++++++++++++---- .../Engine/Common/SessionEngine.swift | 1 - 4 files changed, 86 insertions(+), 28 deletions(-) diff --git a/Sources/WalletConnectNetworking/Networking.swift b/Sources/WalletConnectNetworking/Networking.swift index 0b5277ea1..c52a03e89 100644 --- a/Sources/WalletConnectNetworking/Networking.swift +++ b/Sources/WalletConnectNetworking/Networking.swift @@ -40,7 +40,7 @@ public class Networking { /// - socketFactory: web socket factory /// - socketConnectionType: socket connection type static public func configure( - relayHost: String = "relay.walletconnect.com", + relayHost: String = "relayx.walletconnect.com", groupIdentifier: String, projectId: String, socketFactory: WebSocketFactory, diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 37ae0884e..d39453194 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -23,8 +23,6 @@ final class Dispatcher: NSObject, Dispatching { private let networkMonitor: NetworkMonitoring private let logger: ConsoleLogging - private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) - var socketConnectionStatusPublisher: AnyPublisher { socketConnectionStatusPublisherSubject.eraseToAnyPublisher() } @@ -56,7 +54,6 @@ final class Dispatcher: NSObject, Dispatching { super.init() setUpWebSocketSession() - setUpSocketConnectionObserving() } func send(_ string: String, completion: @escaping (Error?) -> Void) { @@ -132,18 +129,36 @@ extension Dispatcher { } } + +} + +protocol SocketStatusProviding { + var socketConnectionStatusPublisher: AnyPublisher { get } +} + +class SocketStatusProvider: SocketStatusProviding { + private var socket: WebSocketConnecting + private let logger: ConsoleLogging + private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) + + var socketConnectionStatusPublisher: AnyPublisher { + socketConnectionStatusPublisherSubject.eraseToAnyPublisher() + } + + init(socket: WebSocketConnecting, + logger: ConsoleLogging) { + self.socket = socket + self.logger = logger + setUpSocketConnectionObserving() + } + private func setUpSocketConnectionObserving() { socket.onConnect = { [unowned self] in self.socketConnectionStatusPublisherSubject.send(.connected) } socket.onDisconnect = { [unowned self] error in + logger.debug("Socket disconnected with error: \(error?.localizedDescription ?? "Unknown error")") self.socketConnectionStatusPublisherSubject.send(.disconnected) - if error != nil { - self.socket.request.url = relayUrlFactory.create() - } - Task(priority: .high) { - await self.socketConnectionHandler.handleDisconnection() - } } } } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 6727c373b..8cc57dbc9 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -17,17 +17,25 @@ class AutomaticSocketConnectionHandler { private let defaultTimeout: Int = 60 private let logger: ConsoleLogging private let subscriptionsTracker: SubscriptionsTracking + private let socketStatusProvider: SocketStatusProviding private var publishers = Set() private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", qos: .utility, attributes: .concurrent) + private var reconnectionAttempts = 0 + private let maxImmediateAttempts = 3 + private let periodicReconnectionInterval: TimeInterval = 5.0 + private var reconnectionTimer: DispatchSourceTimer? + private var isConnecting = false + init( socket: WebSocketConnecting, networkMonitor: NetworkMonitoring = NetworkMonitor(), appStateObserver: AppStateObserving = AppStateObserver(), backgroundTaskRegistrar: BackgroundTaskRegistering = BackgroundTaskRegistrar(), subscriptionsTracker: SubscriptionsTracking, - logger: ConsoleLogging + logger: ConsoleLogging, + socketStatusProvider: SocketStatusProviding ) { self.appStateObserver = appStateObserver self.socket = socket @@ -35,30 +43,65 @@ class AutomaticSocketConnectionHandler { self.backgroundTaskRegistrar = backgroundTaskRegistrar self.logger = logger self.subscriptionsTracker = subscriptionsTracker + self.socketStatusProvider = socketStatusProvider setUpStateObserving() setUpNetworkMonitoring() } func connect() { - // Attempt to handle connection + // Start the connection process + isConnecting = true socket.connect() - // Start a timer for the fallback mechanism - let timer = DispatchSource.makeTimerSource(queue: concurrentQueue) - timer.schedule(deadline: .now() + .seconds(defaultTimeout)) - timer.setEventHandler { [weak self] in - guard let self = self else { - timer.cancel() - return - } - if !self.socket.isConnected { - self.logger.debug("Connection timed out, will rety to connect...") - retryToConnect() + // Monitor the onConnect event to reset flags when connected + socket.onConnect = { [unowned self] in + isConnecting = false + reconnectionAttempts = 0 // Reset reconnection attempts on successful connection + stopPeriodicReconnectionTimer() // Stop any ongoing periodic reconnection attempts + } + + // Monitor the onDisconnect event to handle reconnections + socket.onDisconnect = { [unowned self] error in + logger.debug("Socket disconnected: \(error?.localizedDescription ?? "Unknown error")") + + if isConnecting { + // Handle reconnection logic + handleFailedConnectionAndReconnectIfNeeded() } - timer.cancel() } - timer.resume() + } + + private func stopPeriodicReconnectionTimer() { + reconnectionTimer?.cancel() + reconnectionTimer = nil + } + + private func startPeriodicReconnectionTimer() { + reconnectionTimer?.cancel() // Cancel any existing timer + reconnectionTimer = DispatchSource.makeTimerSource(queue: concurrentQueue) + reconnectionTimer?.schedule(deadline: .now(), repeating: periodicReconnectionInterval) + + reconnectionTimer?.setEventHandler { [weak self] in + guard let self = self else { return } + self.logger.debug("Periodic reconnection attempt...") + self.socket.connect() // Attempt to reconnect + + // The onConnect handler will stop the timer and reset states if connection is successful + } + + reconnectionTimer?.resume() + } + + private func handleFailedConnectionAndReconnectIfNeeded() { + if reconnectionAttempts < maxImmediateAttempts { + reconnectionAttempts += 1 + logger.debug("Immediate reconnection attempt \(reconnectionAttempts) of \(maxImmediateAttempts)") + socket.connect() + } else { + logger.debug("Max immediate reconnection attempts reached. Switching to periodic reconnection every \(periodicReconnectionInterval) seconds.") + startPeriodicReconnectionTimer() + } } private func setUpStateObserving() { @@ -96,10 +139,10 @@ class AutomaticSocketConnectionHandler { } } - func reconnectIfNeeded() { - + // Check if client has active subscriptions and only then subscribe + if !socket.isConnected && subscriptionsTracker.isSubscribed() { connect() } @@ -121,6 +164,7 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { throw Errors.manualSocketDisconnectionForbidden } + no longer called from dispatcher func handleDisconnection() async { guard await appStateObserver.currentState == .foreground else { return } reconnectIfNeeded() diff --git a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift index 7bba80c19..203cd6d16 100644 --- a/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift +++ b/Sources/WalletConnectSign/Engine/Common/SessionEngine.swift @@ -87,7 +87,6 @@ final class SessionEngine { // MARK: - Privates private extension SessionEngine { - func subscribeActiveSessions() { let topics = sessionStore.getAll().map{$0.topic} Task(priority: .background) { From 40c85f3e547a503998a5c5c1c8f932552fbc96e4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Aug 2024 07:15:19 +0200 Subject: [PATCH 749/814] fix build --- Sources/WalletConnectRelay/Dispatching.swift | 40 ++---------- .../RelayClientFactory.swift | 6 +- .../AutomaticSocketConnectionHandler.swift | 62 +++++++++---------- .../SocketStatusProvider.swift | 34 ++++++++++ 4 files changed, 72 insertions(+), 70 deletions(-) create mode 100644 Sources/WalletConnectRelay/SocketStatusProvider.swift diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index d39453194..9d2198cee 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -22,9 +22,10 @@ final class Dispatcher: NSObject, Dispatching { private let relayUrlFactory: RelayUrlFactory private let networkMonitor: NetworkMonitoring private let logger: ConsoleLogging + private let socketStatusProvider: SocketStatusProviding var socketConnectionStatusPublisher: AnyPublisher { - socketConnectionStatusPublisherSubject.eraseToAnyPublisher() + socketStatusProvider.socketConnectionStatusPublisher } var networkConnectionStatusPublisher: AnyPublisher { @@ -43,14 +44,15 @@ final class Dispatcher: NSObject, Dispatching { networkMonitor: NetworkMonitoring, socket: WebSocketConnecting, logger: ConsoleLogging, - socketConnectionHandler: SocketConnectionHandler + socketConnectionHandler: SocketConnectionHandler, + socketStatusProvider: SocketStatusProviding ) { self.socketConnectionHandler = socketConnectionHandler self.relayUrlFactory = relayUrlFactory self.networkMonitor = networkMonitor self.logger = logger - self.socket = socket + self.socketStatusProvider = socketStatusProvider super.init() setUpWebSocketSession() @@ -71,6 +73,7 @@ final class Dispatcher: NSObject, Dispatching { return send(string, completion: completion) } + // Always connect when there is a message to be sent if !socket.isConnected { socketConnectionHandler.handleInternalConnect() } @@ -131,34 +134,3 @@ extension Dispatcher { } - -protocol SocketStatusProviding { - var socketConnectionStatusPublisher: AnyPublisher { get } -} - -class SocketStatusProvider: SocketStatusProviding { - private var socket: WebSocketConnecting - private let logger: ConsoleLogging - private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) - - var socketConnectionStatusPublisher: AnyPublisher { - socketConnectionStatusPublisherSubject.eraseToAnyPublisher() - } - - init(socket: WebSocketConnecting, - logger: ConsoleLogging) { - self.socket = socket - self.logger = logger - setUpSocketConnectionObserving() - } - - private func setUpSocketConnectionObserving() { - socket.onConnect = { [unowned self] in - self.socketConnectionStatusPublisherSubject.send(.connected) - } - socket.onDisconnect = { [unowned self] error in - logger.debug("Socket disconnected with error: \(error?.localizedDescription ?? "Unknown error")") - self.socketConnectionStatusPublisherSubject.send(.disconnected) - } - } -} diff --git a/Sources/WalletConnectRelay/RelayClientFactory.swift b/Sources/WalletConnectRelay/RelayClientFactory.swift index f00295fe0..0091d496c 100644 --- a/Sources/WalletConnectRelay/RelayClientFactory.swift +++ b/Sources/WalletConnectRelay/RelayClientFactory.swift @@ -63,9 +63,10 @@ public struct RelayClientFactory { } let subscriptionsTracker = SubscriptionsTracker() + let socketStatusProvider = SocketStatusProvider(socket: socket, logger: logger) var socketConnectionHandler: SocketConnectionHandler! switch socketConnectionType { - case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, subscriptionsTracker: subscriptionsTracker, logger: logger) + case .automatic: socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, subscriptionsTracker: subscriptionsTracker, logger: logger, socketStatusProvider: socketStatusProvider) case .manual: socketConnectionHandler = ManualSocketConnectionHandler(socket: socket, logger: logger) } @@ -75,7 +76,8 @@ public struct RelayClientFactory { networkMonitor: networkMonitor, socket: socket, logger: logger, - socketConnectionHandler: socketConnectionHandler + socketConnectionHandler: socketConnectionHandler, + socketStatusProvider: socketStatusProvider ) let rpcHistory = RPCHistoryFactory.createForRelay(keyValueStorage: keyValueStorage) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 8cc57dbc9..3a4bb774c 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -14,7 +14,6 @@ class AutomaticSocketConnectionHandler { private let appStateObserver: AppStateObserving private let networkMonitor: NetworkMonitoring private let backgroundTaskRegistrar: BackgroundTaskRegistering - private let defaultTimeout: Int = 60 private let logger: ConsoleLogging private let subscriptionsTracker: SubscriptionsTracking private let socketStatusProvider: SocketStatusProviding @@ -47,29 +46,35 @@ class AutomaticSocketConnectionHandler { setUpStateObserving() setUpNetworkMonitoring() + setUpSocketStatusObserving() // Set up to observe socket status changes } func connect() { // Start the connection process isConnecting = true socket.connect() + } - // Monitor the onConnect event to reset flags when connected - socket.onConnect = { [unowned self] in - isConnecting = false - reconnectionAttempts = 0 // Reset reconnection attempts on successful connection - stopPeriodicReconnectionTimer() // Stop any ongoing periodic reconnection attempts - } - - // Monitor the onDisconnect event to handle reconnections - socket.onDisconnect = { [unowned self] error in - logger.debug("Socket disconnected: \(error?.localizedDescription ?? "Unknown error")") - - if isConnecting { - // Handle reconnection logic - handleFailedConnectionAndReconnectIfNeeded() + private func setUpSocketStatusObserving() { + socketStatusProvider.socketConnectionStatusPublisher + .sink { [unowned self] status in + switch status { + case .connected: + isConnecting = false + reconnectionAttempts = 0 // Reset reconnection attempts on successful connection + stopPeriodicReconnectionTimer() // Stop any ongoing periodic reconnection attempts + case .disconnected: + if isConnecting { + // Handle reconnection logic + handleFailedConnectionAndReconnectIfNeeded() + } else { + Task(priority: .high) { + await handleDisconnection() + } + } + } } - } + .store(in: &publishers) } private func stopPeriodicReconnectionTimer() { @@ -82,10 +87,9 @@ class AutomaticSocketConnectionHandler { reconnectionTimer = DispatchSource.makeTimerSource(queue: concurrentQueue) reconnectionTimer?.schedule(deadline: .now(), repeating: periodicReconnectionInterval) - reconnectionTimer?.setEventHandler { [weak self] in - guard let self = self else { return } - self.logger.debug("Periodic reconnection attempt...") - self.socket.connect() // Attempt to reconnect + reconnectionTimer?.setEventHandler { [unowned self] in + logger.debug("Periodic reconnection attempt...") + socket.connect() // Attempt to reconnect // The onConnect handler will stop the timer and reset states if connection is successful } @@ -115,9 +119,9 @@ class AutomaticSocketConnectionHandler { } private func setUpNetworkMonitoring() { - networkMonitor.networkConnectionStatusPublisher.sink { [weak self] networkConnectionStatus in + networkMonitor.networkConnectionStatusPublisher.sink { [unowned self] networkConnectionStatus in if networkConnectionStatus == .connected { - self?.reconnectIfNeeded() + reconnectIfNeeded() } } .store(in: &publishers) @@ -133,16 +137,8 @@ class AutomaticSocketConnectionHandler { socket.disconnect() } - private func retryToConnect() { - if !socket.isConnected { - connect() - } - } - func reconnectIfNeeded() { - - // Check if client has active subscriptions and only then subscribe - + // Check if client has active subscriptions and only then attempt to reconnect if !socket.isConnected && subscriptionsTracker.isSubscribed() { connect() } @@ -155,7 +151,7 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { func handleInternalConnect() { connect() } - + func handleConnect() throws { throw Errors.manualSocketConnectionForbidden } @@ -164,10 +160,8 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { throw Errors.manualSocketDisconnectionForbidden } - no longer called from dispatcher func handleDisconnection() async { guard await appStateObserver.currentState == .foreground else { return } reconnectIfNeeded() } } - diff --git a/Sources/WalletConnectRelay/SocketStatusProvider.swift b/Sources/WalletConnectRelay/SocketStatusProvider.swift new file mode 100644 index 000000000..1da3fa37d --- /dev/null +++ b/Sources/WalletConnectRelay/SocketStatusProvider.swift @@ -0,0 +1,34 @@ + +import Foundation +import Combine + +protocol SocketStatusProviding { + var socketConnectionStatusPublisher: AnyPublisher { get } +} + +class SocketStatusProvider: SocketStatusProviding { + private var socket: WebSocketConnecting + private let logger: ConsoleLogging + private let socketConnectionStatusPublisherSubject = CurrentValueSubject(.disconnected) + + var socketConnectionStatusPublisher: AnyPublisher { + socketConnectionStatusPublisherSubject.eraseToAnyPublisher() + } + + init(socket: WebSocketConnecting, + logger: ConsoleLogging) { + self.socket = socket + self.logger = logger + setUpSocketConnectionObserving() + } + + private func setUpSocketConnectionObserving() { + socket.onConnect = { [unowned self] in + self.socketConnectionStatusPublisherSubject.send(.connected) + } + socket.onDisconnect = { [unowned self] error in + logger.debug("Socket disconnected with error: \(error?.localizedDescription ?? "Unknown error")") + self.socketConnectionStatusPublisherSubject.send(.disconnected) + } + } +} From 600b408c310323fe214cb71fe124b303c9ee5ad4 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Aug 2024 07:18:01 +0200 Subject: [PATCH 750/814] savepoint --- .../AutomaticSocketConnectionHandler.swift | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 3a4bb774c..b0a2f8706 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -46,7 +46,7 @@ class AutomaticSocketConnectionHandler { setUpStateObserving() setUpNetworkMonitoring() - setUpSocketStatusObserving() // Set up to observe socket status changes + setUpSocketStatusObserving() } func connect() { @@ -77,6 +77,17 @@ class AutomaticSocketConnectionHandler { .store(in: &publishers) } + private func handleFailedConnectionAndReconnectIfNeeded() { + if reconnectionAttempts < maxImmediateAttempts { + reconnectionAttempts += 1 + logger.debug("Immediate reconnection attempt \(reconnectionAttempts) of \(maxImmediateAttempts)") + socket.connect() + } else { + logger.debug("Max immediate reconnection attempts reached. Switching to periodic reconnection every \(periodicReconnectionInterval) seconds.") + startPeriodicReconnectionTimer() + } + } + private func stopPeriodicReconnectionTimer() { reconnectionTimer?.cancel() reconnectionTimer = nil @@ -97,17 +108,6 @@ class AutomaticSocketConnectionHandler { reconnectionTimer?.resume() } - private func handleFailedConnectionAndReconnectIfNeeded() { - if reconnectionAttempts < maxImmediateAttempts { - reconnectionAttempts += 1 - logger.debug("Immediate reconnection attempt \(reconnectionAttempts) of \(maxImmediateAttempts)") - socket.connect() - } else { - logger.debug("Max immediate reconnection attempts reached. Switching to periodic reconnection every \(periodicReconnectionInterval) seconds.") - startPeriodicReconnectionTimer() - } - } - private func setUpStateObserving() { appStateObserver.onWillEnterBackground = { [unowned self] in registerBackgroundTask() From d1bbfe83fc3111afafc2eec171d53caa81c51adc Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Aug 2024 08:09:05 +0200 Subject: [PATCH 751/814] clean up tests --- .../SocketConnectionHandler/WebSocket.swift | 40 +++++++++++++ .../SocketStatusProvider.swift | 14 +++++ ...utomaticSocketConnectionHandlerTests.swift | 14 ++--- Tests/RelayerTests/DispatcherTests.swift | 57 +++---------------- 4 files changed, 66 insertions(+), 59 deletions(-) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/WebSocket.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/WebSocket.swift index fd9d96a56..d4042ee19 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/WebSocket.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/WebSocket.swift @@ -14,3 +14,43 @@ public protocol WebSocketConnecting: AnyObject { public protocol WebSocketFactory { func create(with url: URL) -> WebSocketConnecting } + +#if DEBUG +class WebSocketMock: WebSocketConnecting { + var request: URLRequest = URLRequest(url: URL(string: "wss://relay.walletconnect.com")!) + + var onText: ((String) -> Void)? + var onConnect: (() -> Void)? + var onDisconnect: ((Error?) -> Void)? + var sendCallCount: Int = 0 + var isConnected: Bool = false + + func connect() { + isConnected = true + onConnect?() + } + + func disconnect() { + isConnected = false + onDisconnect?(nil) + } + + func write(string: String, completion: (() -> Void)?) { + sendCallCount+=1 + } +} +#endif + +#if DEBUG +class WebSocketFactoryMock: WebSocketFactory { + private let webSocket: WebSocketMock + + init(webSocket: WebSocketMock) { + self.webSocket = webSocket + } + + func create(with url: URL) -> WebSocketConnecting { + return webSocket + } +} +#endif diff --git a/Sources/WalletConnectRelay/SocketStatusProvider.swift b/Sources/WalletConnectRelay/SocketStatusProvider.swift index 1da3fa37d..1003fe01e 100644 --- a/Sources/WalletConnectRelay/SocketStatusProvider.swift +++ b/Sources/WalletConnectRelay/SocketStatusProvider.swift @@ -32,3 +32,17 @@ class SocketStatusProvider: SocketStatusProviding { } } } + +#if DEBUG +final class SocketStatusProviderMock: SocketStatusProviding { + private var socketConnectionStatusPublisherSubject = PassthroughSubject() + + var socketConnectionStatusPublisher: AnyPublisher { + socketConnectionStatusPublisherSubject.eraseToAnyPublisher() + } + + func simulateConnectionStatus(_ status: SocketConnectionStatus) { + socketConnectionStatusPublisherSubject.send(status) + } +} +#endif diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index 101fdf3ad..0da827d1b 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -9,35 +9,31 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { var appStateObserver: AppStateObserverMock! var backgroundTaskRegistrar: BackgroundTaskRegistrarMock! var subscriptionsTracker: SubscriptionsTrackerMock! + var socketStatusProviderMock: SocketStatusProviderMock! override func setUp() { webSocketSession = WebSocketMock() networkMonitor = NetworkMonitoringMock() appStateObserver = AppStateObserverMock() - let webSocket = WebSocketMock() let defaults = RuntimeKeyValueStorage() let logger = ConsoleLoggerMock() let keychainStorageMock = DispatcherKeychainStorageMock() let clientIdStorage = ClientIdStorage(defaults: defaults, keychain: keychainStorageMock, logger: logger) - - let socketAuthenticator = ClientIdAuthenticator(clientIdStorage: clientIdStorage) - let relayUrlFactory = RelayUrlFactory( - relayHost: "relay.walletconnect.com", - projectId: "1012db890cf3cfb0c1cdc929add657ba", - socketAuthenticator: socketAuthenticator - ) backgroundTaskRegistrar = BackgroundTaskRegistrarMock() subscriptionsTracker = SubscriptionsTrackerMock() + socketStatusProviderMock = SocketStatusProviderMock() + sut = AutomaticSocketConnectionHandler( socket: webSocketSession, networkMonitor: networkMonitor, appStateObserver: appStateObserver, backgroundTaskRegistrar: backgroundTaskRegistrar, subscriptionsTracker: subscriptionsTracker, - logger: ConsoleLoggerMock() + logger: logger, + socketStatusProvider: socketStatusProviderMock // Use the mock ) } diff --git a/Tests/RelayerTests/DispatcherTests.swift b/Tests/RelayerTests/DispatcherTests.swift index e8b0de168..3b41c4600 100644 --- a/Tests/RelayerTests/DispatcherTests.swift +++ b/Tests/RelayerTests/DispatcherTests.swift @@ -14,48 +14,13 @@ class DispatcherKeychainStorageMock: KeychainStorageProtocol { func deleteAll() throws {} } -class WebSocketMock: WebSocketConnecting { - var request: URLRequest = URLRequest(url: URL(string: "wss://relay.walletconnect.com")!) - - var onText: ((String) -> Void)? - var onConnect: (() -> Void)? - var onDisconnect: ((Error?) -> Void)? - var sendCallCount: Int = 0 - var isConnected: Bool = false - - func connect() { - isConnected = true - onConnect?() - } - - func disconnect() { - isConnected = false - onDisconnect?(nil) - } - - func write(string: String, completion: (() -> Void)?) { - sendCallCount+=1 - } -} - -class WebSocketFactoryMock: WebSocketFactory { - private let webSocket: WebSocketMock - - init(webSocket: WebSocketMock) { - self.webSocket = webSocket - } - - func create(with url: URL) -> WebSocketConnecting { - return webSocket - } -} - final class DispatcherTests: XCTestCase { var publishers = Set() var sut: Dispatcher! var webSocket: WebSocketMock! var networkMonitor: NetworkMonitoringMock! - + var socketStatusProviderMock: SocketStatusProviderMock! + override func setUp() { webSocket = WebSocketMock() let webSocketFactory = WebSocketFactoryMock(webSocket: webSocket) @@ -72,13 +37,15 @@ final class DispatcherTests: XCTestCase { socketAuthenticator: socketAuthenticator ) let socketConnectionHandler = ManualSocketConnectionHandler(socket: webSocket, logger: logger) + socketStatusProviderMock = SocketStatusProviderMock() sut = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: relayUrlFactory, networkMonitor: networkMonitor, socket: webSocket, logger: ConsoleLoggerMock(), - socketConnectionHandler: socketConnectionHandler + socketConnectionHandler: socketConnectionHandler, + socketStatusProvider: socketStatusProviderMock ) } @@ -88,16 +55,6 @@ final class DispatcherTests: XCTestCase { XCTAssertEqual(webSocket.sendCallCount, 1) } -// func testTextFramesSentAfterReconnectingSocket() { -// try! sut.disconnect(closeCode: .normalClosure) -// sut.send("1"){_ in} -// sut.send("2"){_ in} -// XCTAssertEqual(webSocketSession.sendCallCount, 0) -// try! sut.connect() -// socketConnectionObserver.onConnect?() -// XCTAssertEqual(webSocketSession.sendCallCount, 2) -// } - func testOnMessage() { let expectation = expectation(description: "on message") sut.onMessage = { message in @@ -114,7 +71,7 @@ final class DispatcherTests: XCTestCase { guard status == .connected else { return } expectation.fulfill() }.store(in: &publishers) - webSocket.onConnect?() + socketStatusProviderMock.simulateConnectionStatus(.connected) waitForExpectations(timeout: 0.001) } @@ -125,7 +82,7 @@ final class DispatcherTests: XCTestCase { guard status == .disconnected else { return } expectation.fulfill() }.store(in: &publishers) - webSocket.onDisconnect?(nil) + socketStatusProviderMock.simulateConnectionStatus(.disconnected) waitForExpectations(timeout: 0.001) } } From 4f7591ea3c8dd9659f12942427bcb433c7b1fbed Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Aug 2024 09:57:32 +0200 Subject: [PATCH 752/814] test periodic reconnection --- .../AutomaticSocketConnectionHandler.swift | 10 +-- ...utomaticSocketConnectionHandlerTests.swift | 62 ++++++++++++++++++- 2 files changed, 66 insertions(+), 6 deletions(-) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index b0a2f8706..ec16596db 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -21,11 +21,11 @@ class AutomaticSocketConnectionHandler { private var publishers = Set() private let concurrentQueue = DispatchQueue(label: "com.walletconnect.sdk.automatic_socket_connection", qos: .utility, attributes: .concurrent) - private var reconnectionAttempts = 0 - private let maxImmediateAttempts = 3 - private let periodicReconnectionInterval: TimeInterval = 5.0 - private var reconnectionTimer: DispatchSourceTimer? - private var isConnecting = false + var reconnectionAttempts = 0 + let maxImmediateAttempts = 3 + var periodicReconnectionInterval: TimeInterval = 5.0 + var reconnectionTimer: DispatchSourceTimer? + var isConnecting = false init( socket: WebSocketConnecting, diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index 0da827d1b..6b1809b35 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -33,7 +33,7 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { backgroundTaskRegistrar: backgroundTaskRegistrar, subscriptionsTracker: subscriptionsTracker, logger: logger, - socketStatusProvider: socketStatusProviderMock // Use the mock + socketStatusProvider: socketStatusProviderMock ) } @@ -180,4 +180,64 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { // Expect the socket to reconnect since there are subscriptions XCTAssertTrue(webSocketSession.isConnected) } + + func testSwitchesToPeriodicReconnectionAfterMaxImmediateAttempts() { + sut.connect() // Start connection process + + // Simulate immediate reconnection attempts + for _ in 0...sut.maxImmediateAttempts { + socketStatusProviderMock.simulateConnectionStatus(.disconnected) + } + + // Now we should be switching to periodic reconnection attempts + // Check reconnectionAttempts is set to maxImmediateAttempts + XCTAssertEqual(sut.reconnectionAttempts, sut.maxImmediateAttempts) + XCTAssertNotNil(sut.reconnectionTimer) // Periodic reconnection timer should be started + } + + func testPeriodicReconnectionStopsAfterSuccessfulConnection() { + sut.connect() // Start connection process + + // Simulate immediate reconnection attempts + for _ in 0...sut.maxImmediateAttempts { + socketStatusProviderMock.simulateConnectionStatus(.disconnected) + } + + // Check that periodic reconnection starts + XCTAssertNotNil(sut.reconnectionTimer) + + // Now simulate the connection being successful + socketStatusProviderMock.simulateConnectionStatus(.connected) + + // Periodic reconnection timer should stop + XCTAssertNil(sut.reconnectionTimer) + XCTAssertEqual(sut.reconnectionAttempts, 0) // Attempts should be reset + } + + func testPeriodicReconnectionAttempts() { + subscriptionsTracker.isSubscribedReturnValue = true // Simulate that there are active subscriptions + webSocketSession.disconnect() + sut.periodicReconnectionInterval = 0.0001 + sut.connect() // Start connection process + + // Simulate immediate reconnection attempts to switch to periodic + for _ in 0...sut.maxImmediateAttempts { + socketStatusProviderMock.simulateConnectionStatus(.disconnected) + } + + // Ensure we have switched to periodic reconnection + XCTAssertNotNil(sut.reconnectionTimer) + + // Simulate the periodic timer firing without waiting for real time + let expectation = XCTestExpectation(description: "Periodic reconnection attempt made") + sut.reconnectionTimer?.setEventHandler { + self.socketStatusProviderMock.simulateConnectionStatus(.connected) + expectation.fulfill() + } + + wait(for: [expectation], timeout: 1) + + // Check that the periodic reconnection attempt was made + XCTAssertTrue(webSocketSession.isConnected) // Assume that connection would have been attempted + } } From 8edd4a1034ff55976a592dcd677b5cd83fff023f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Fri, 23 Aug 2024 12:55:22 +0200 Subject: [PATCH 753/814] fix tests --- .../RelayIntegrationTests/RelayClientEndToEndTests.swift | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift index 5e69702cc..4eccebd9b 100644 --- a/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift +++ b/Example/RelayIntegrationTests/RelayClientEndToEndTests.swift @@ -52,14 +52,16 @@ final class RelayClientEndToEndTests: XCTestCase { socketAuthenticator: socketAuthenticator ) - let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, subscriptionsTracker: SubscriptionsTracker(), logger: logger) + let socketStatusProvider = SocketStatusProvider(socket: socket, logger: logger) + let socketConnectionHandler = AutomaticSocketConnectionHandler(socket: socket, subscriptionsTracker: SubscriptionsTracker(), logger: logger, socketStatusProvider: socketStatusProvider) let dispatcher = Dispatcher( socketFactory: webSocketFactory, relayUrlFactory: urlFactory, networkMonitor: networkMonitor, socket: socket, logger: logger, - socketConnectionHandler: socketConnectionHandler + socketConnectionHandler: socketConnectionHandler, + socketStatusProvider: socketStatusProvider ) let keychain = KeychainStorageMock() let relayClient = RelayClientFactory.create( From b184ab7d6fd327760309afc1cda2ab093587ab70 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Sat, 24 Aug 2024 11:58:10 +0200 Subject: [PATCH 754/814] fix bug when url does not have scheme --- .../VerifyContextFactory.swift | 16 ++++++++++++++-- .../VerifyTests/VerifyContextFactoryTests.swift | 10 ++++++++++ 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectVerify/VerifyContextFactory.swift b/Sources/WalletConnectVerify/VerifyContextFactory.swift index 629973e38..6c280f2ef 100644 --- a/Sources/WalletConnectVerify/VerifyContextFactory.swift +++ b/Sources/WalletConnectVerify/VerifyContextFactory.swift @@ -1,7 +1,15 @@ - import Foundation class VerifyContextFactory { + + private func ensureUrlHasScheme(_ urlString: String) -> String { + if urlString.hasPrefix("http://") || urlString.hasPrefix("https://") { + return urlString + } else { + return "https://" + urlString + } + } + public func createVerifyContext(origin: String?, domain: String, isScam: Bool?, isVerified: Bool?) -> VerifyContext { guard isScam != true else { @@ -19,7 +27,11 @@ class VerifyContextFactory { ) } - if let origin, let originUrl = URL(string: origin), let domainUrl = URL(string: domain) { + // Ensure both origin and domain have a scheme + let originWithScheme = origin.map { ensureUrlHasScheme($0) } + let domainWithScheme = ensureUrlHasScheme(domain) + + if let originWithScheme, let originUrl = URL(string: originWithScheme), let domainUrl = URL(string: domainWithScheme) { return VerifyContext( origin: origin, validation: (originUrl.host == domainUrl.host) ? .valid : .invalid diff --git a/Tests/VerifyTests/VerifyContextFactoryTests.swift b/Tests/VerifyTests/VerifyContextFactoryTests.swift index 0d43c2aed..026bfba67 100644 --- a/Tests/VerifyTests/VerifyContextFactoryTests.swift +++ b/Tests/VerifyTests/VerifyContextFactoryTests.swift @@ -49,6 +49,16 @@ class VerifyContextFactoryTests: XCTestCase { XCTAssertEqual(contextWithFalseVerification.validation, .scam) } + func testValidOriginAndDomainWithoutScheme() { + let context = factory.createVerifyContext(origin: "https://dev.lab.web3modal.com", domain: "dev.lab.web3modal.com", isScam: false, isVerified: nil) + XCTAssertEqual(context.validation, .valid) + } + + func testInvalidOriginAndDomainWithoutScheme() { + let context = factory.createVerifyContext(origin: "https://dev.lab.web3modal.com", domain: "different.com", isScam: false, isVerified: nil) + XCTAssertEqual(context.validation, .invalid) + } + // tests for createVerifyContextForLinkMode func testValidUniversalLink() { From 0bc1bae9b2ccf507036adde6aafb14bf4c25ca98 Mon Sep 17 00:00:00 2001 From: llbartekll Date: Sat, 24 Aug 2024 10:12:00 +0000 Subject: [PATCH 755/814] Set User Agent --- Sources/WalletConnectRelay/PackageConfig.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Sources/WalletConnectRelay/PackageConfig.json b/Sources/WalletConnectRelay/PackageConfig.json index 0aa2b143b..3e93c0cec 100644 --- a/Sources/WalletConnectRelay/PackageConfig.json +++ b/Sources/WalletConnectRelay/PackageConfig.json @@ -1 +1 @@ -{"version": "1.19.6"} +{"version": "1.20.0"} From 6df02aa579fd55cbab5ee2fa6bdead3c4943fa6f Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Aug 2024 09:23:14 +0200 Subject: [PATCH 756/814] fix reconnection issue --- Sources/WalletConnectNetworking/Networking.swift | 2 +- .../AutomaticSocketConnectionHandler.swift | 9 ++++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/Sources/WalletConnectNetworking/Networking.swift b/Sources/WalletConnectNetworking/Networking.swift index c52a03e89..0b5277ea1 100644 --- a/Sources/WalletConnectNetworking/Networking.swift +++ b/Sources/WalletConnectNetworking/Networking.swift @@ -40,7 +40,7 @@ public class Networking { /// - socketFactory: web socket factory /// - socketConnectionType: socket connection type static public func configure( - relayHost: String = "relayx.walletconnect.com", + relayHost: String = "relay.walletconnect.com", groupIdentifier: String, projectId: String, socketFactory: WebSocketFactory, diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index ec16596db..ccafbbb8b 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -94,15 +94,18 @@ class AutomaticSocketConnectionHandler { } private func startPeriodicReconnectionTimer() { - reconnectionTimer?.cancel() // Cancel any existing timer + guard reconnectionTimer == nil else {return} + reconnectionTimer = DispatchSource.makeTimerSource(queue: concurrentQueue) - reconnectionTimer?.schedule(deadline: .now(), repeating: periodicReconnectionInterval) + let initialDelay: DispatchTime = .now() + periodicReconnectionInterval + + reconnectionTimer?.schedule(deadline: initialDelay, repeating: periodicReconnectionInterval) reconnectionTimer?.setEventHandler { [unowned self] in logger.debug("Periodic reconnection attempt...") socket.connect() // Attempt to reconnect - // The onConnect handler will stop the timer and reset states if connection is successful + // The socketConnectionStatusPublisher handler will stop the timer and reset states if connection is successful } reconnectionTimer?.resume() From daf5258c19c604d31feb23131a5364dabb39bba1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Aug 2024 12:29:04 +0200 Subject: [PATCH 757/814] rename method --- .../AutomaticSocketConnectionHandler.swift | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index ccafbbb8b..e1edd574b 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -84,7 +84,7 @@ class AutomaticSocketConnectionHandler { socket.connect() } else { logger.debug("Max immediate reconnection attempts reached. Switching to periodic reconnection every \(periodicReconnectionInterval) seconds.") - startPeriodicReconnectionTimer() + startPeriodicReconnectionTimerIfNeeded() } } @@ -93,7 +93,7 @@ class AutomaticSocketConnectionHandler { reconnectionTimer = nil } - private func startPeriodicReconnectionTimer() { + private func startPeriodicReconnectionTimerIfNeeded() { guard reconnectionTimer == nil else {return} reconnectionTimer = DispatchSource.makeTimerSource(queue: concurrentQueue) From 2ed2d17a9dd7333c1981868bfe5f9dcfdaca30c2 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Aug 2024 08:59:30 +0200 Subject: [PATCH 758/814] add init event --- Sources/Events/EventsClient.swift | 47 +++++++++++++++++++----- Sources/Events/EventsClientFactory.swift | 3 +- Sources/Events/InitEvent.swift | 25 +++++++++++++ Sources/Events/InitEventsStorage.swift | 42 +++++++++++++++++++++ 4 files changed, 107 insertions(+), 10 deletions(-) create mode 100644 Sources/Events/InitEvent.swift create mode 100644 Sources/Events/InitEventsStorage.swift diff --git a/Sources/Events/EventsClient.swift b/Sources/Events/EventsClient.swift index da0dd30bd..5d1664c29 100644 --- a/Sources/Events/EventsClient.swift +++ b/Sources/Events/EventsClient.swift @@ -14,25 +14,28 @@ public class EventsClient: EventsClientProtocol { private let logger: ConsoleLogging private var stateStorage: TelemetryStateStorage private let messageEventsStorage: MessageEventsStorage + private let initEventsStorage: InitEventsStorage init( eventsCollector: EventsCollector, eventsDispatcher: EventsDispatcher, logger: ConsoleLogging, stateStorage: TelemetryStateStorage, - messageEventsStorage: MessageEventsStorage + messageEventsStorage: MessageEventsStorage, + initEventsStorage: InitEventsStorage ) { self.eventsCollector = eventsCollector self.eventsDispatcher = eventsDispatcher self.logger = logger self.stateStorage = stateStorage self.messageEventsStorage = messageEventsStorage + self.initEventsStorage = initEventsStorage - if stateStorage.telemetryEnabled { - Task { await sendStoredEvents() } - } else { + if !stateStorage.telemetryEnabled { self.eventsCollector.storage.clearErrorEvents() } + saveInitEvent() + Task { await sendStoredEvents() } } public func setLogging(level: LoggingLevel) { @@ -63,6 +66,30 @@ public class EventsClient: EventsClientProtocol { messageEventsStorage.saveMessageEvent(event) } + public func saveInitEvent() { + logger.debug("Will store an init event") + + let bundleId = Bundle.main.bundleIdentifier ?? "Unknown" + let clientId = (try? Networking.interactor.getClientId()) ?? "Unknown" + let userAgent = EnvironmentInfo.userAgent + + let props = InitEvent.Props( + properties: InitEvent.Properties( + clientId: clientId, + userAgent: userAgent + ) + ) + + let event = InitEvent( + eventId: UUID().uuidString, + bundleId: bundleId, + timestamp: Int64(Date().timeIntervalSince1970 * 1000), + props: props + ) + + initEventsStorage.saveInitEvent(event) + } + // Public method to set telemetry enabled or disabled public func setTelemetryEnabled(_ enabled: Bool) { stateStorage.telemetryEnabled = enabled @@ -78,24 +105,26 @@ public class EventsClient: EventsClientProtocol { let traceEvents = eventsCollector.storage.fetchErrorEvents() let messageEvents = messageEventsStorage.fetchMessageEvents() + let initEvents = initEventsStorage.fetchInitEvents() - guard !traceEvents.isEmpty || !messageEvents.isEmpty else { return } + guard !traceEvents.isEmpty || !messageEvents.isEmpty || !initEvents.isEmpty else { return } var combinedEvents: [AnyCodable] = [] - // Wrap trace events combinedEvents.append(contentsOf: traceEvents.map { AnyCodable($0) }) - // Wrap message events combinedEvents.append(contentsOf: messageEvents.map { AnyCodable($0) }) + combinedEvents.append(contentsOf: initEvents.map { AnyCodable($0) }) + logger.debug("Will send combined events") do { let success: Bool = try await eventsDispatcher.executeWithRetry(events: combinedEvents) if success { logger.debug("Combined events sent successfully") - self.eventsCollector.storage.clearErrorEvents() - self.messageEventsStorage.clearMessageEvents() + eventsCollector.storage.clearErrorEvents() + messageEventsStorage.clearMessageEvents() + initEventsStorage.clearInitEvents() } } catch { logger.debug("Failed to send events after multiple attempts: \(error)") diff --git a/Sources/Events/EventsClientFactory.swift b/Sources/Events/EventsClientFactory.swift index b45df2f26..c7cf66f2d 100644 --- a/Sources/Events/EventsClientFactory.swift +++ b/Sources/Events/EventsClientFactory.swift @@ -19,7 +19,8 @@ public class EventsClientFactory { eventsDispatcher: eventsDispatcher, logger: logger, stateStorage: UserDefaultsTelemetryStateStorage(), - messageEventsStorage: UserDefaultsMessageEventsStorage() + messageEventsStorage: UserDefaultsMessageEventsStorage(), + initEventsStorage: UserDefaultsInitEventsStorage() ) } } diff --git a/Sources/Events/InitEvent.swift b/Sources/Events/InitEvent.swift new file mode 100644 index 000000000..9c1718d29 --- /dev/null +++ b/Sources/Events/InitEvent.swift @@ -0,0 +1,25 @@ +import Foundation + +struct InitEvent: Codable { + struct Props: Codable { + let event: String = "INIT" + let type: String = "None" + let properties: Properties + } + + struct Properties: Codable { + let clientId: String + let userAgent: String + + // Custom CodingKeys to map Swift property names to JSON keys + enum CodingKeys: String, CodingKey { + case clientId = "client_id" + case userAgent = "user_agent" + } + } + + let eventId: String + let bundleId: String + let timestamp: Int64 + let props: Props +} diff --git a/Sources/Events/InitEventsStorage.swift b/Sources/Events/InitEventsStorage.swift new file mode 100644 index 000000000..ae6216554 --- /dev/null +++ b/Sources/Events/InitEventsStorage.swift @@ -0,0 +1,42 @@ +import Foundation + +protocol InitEventsStorage { + func saveInitEvent(_ event: InitEvent) + func fetchInitEvents() -> [InitEvent] + func clearInitEvents() +} + + +class UserDefaultsInitEventsStorage: InitEventsStorage { + private let initEventsKey = "com.walletconnect.sdk.initEvents" + private let maxEvents = 100 + + func saveInitEvent(_ event: InitEvent) { + // Fetch existing events from UserDefaults + var existingEvents = fetchInitEvents() + existingEvents.append(event) + + // Ensure we keep only the last 100 events + if existingEvents.count > maxEvents { + existingEvents = Array(existingEvents.suffix(maxEvents)) + } + + // Save updated events back to UserDefaults + if let encoded = try? JSONEncoder().encode(existingEvents) { + UserDefaults.standard.set(encoded, forKey: initEventsKey) + } + } + + func fetchInitEvents() -> [InitEvent] { + if let data = UserDefaults.standard.data(forKey: initEventsKey), + let events = try? JSONDecoder().decode([InitEvent].self, from: data) { + // Return only the last 100 events + return Array(events.suffix(maxEvents)) + } + return [] + } + + func clearInitEvents() { + UserDefaults.standard.removeObject(forKey: initEventsKey) + } +} From 9b6eb1ac59562c955469f4b3a1a8b7f8f0b9dc7c Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Mon, 26 Aug 2024 13:14:26 +0200 Subject: [PATCH 759/814] savepoint --- Sources/WalletConnectRelay/Dispatching.swift | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 9d2198cee..cd239e12c 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -73,12 +73,18 @@ final class Dispatcher: NSObject, Dispatching { return send(string, completion: completion) } + var cancellable: AnyCancellable? + // Always connect when there is a message to be sent if !socket.isConnected { - socketConnectionHandler.handleInternalConnect() + do { + try socketConnectionHandler.handleInternalConnect() + } catch { + cancellable?.cancel() + completion(error) + } } - var cancellable: AnyCancellable? cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) .filter { $0.0 == .connected && $0.1 == .connected } .setFailureType(to: NetworkError.self) From 5a92b97a3e7849c072a1634c52d7c76e7f1895e6 Mon Sep 17 00:00:00 2001 From: Alfreedom <00tango.bromine@icloud.com> Date: Tue, 27 Aug 2024 11:16:57 +0200 Subject: [PATCH 760/814] Added Flutter Internal wallet so testers can test Link Mode --- Example/DApp/SceneDelegate.swift | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 448c3bd66..e0b717820 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -129,13 +129,22 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { ), .init( id: "flutter-sample", - name: "Flutter Sample Wallet", + name: "FL Sample Wallet", homepage: "https://walletconnect.com/", imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", order: 1, mobileLink: "wcflutterwallet://", linkMode: "https://lab.web3modal.com/walletkit_flutter" ), + .init( + id: "flutter-sample-internal", + name: "FL Sample Wallet (internal)", + homepage: "https://walletconnect.com/", + imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", + order: 1, + mobileLink: "wcflutterwallet-internal://", + linkMode: "https://dev.lab.web3modal.com/flutter_walletkit_internal" + ), ] ) From bc10874c33bc3e80ae7bfbaf2328708c7c2a9eb0 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Aug 2024 15:29:56 +0200 Subject: [PATCH 761/814] savepoint --- Sources/Events/InitEvent.swift | 1 + Sources/WalletConnectRelay/Dispatching.swift | 35 +++--- .../AutomaticSocketConnectionHandler.swift | 51 ++++++++- .../SocketConnectionHandler.swift | 2 +- ...utomaticSocketConnectionHandlerTests.swift | 100 ++++++++++++++++++ 5 files changed, 169 insertions(+), 20 deletions(-) diff --git a/Sources/Events/InitEvent.swift b/Sources/Events/InitEvent.swift index 9c1718d29..a3bd7f7fa 100644 --- a/Sources/Events/InitEvent.swift +++ b/Sources/Events/InitEvent.swift @@ -1,3 +1,4 @@ + import Foundation struct InitEvent: Codable { diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index cd239e12c..79d29b5c8 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -18,7 +18,7 @@ final class Dispatcher: NSObject, Dispatching { var socket: WebSocketConnecting var socketConnectionHandler: SocketConnectionHandler - private let defaultTimeout: Int = 5 + private let defaultTimeout: Int = 15 private let relayUrlFactory: RelayUrlFactory private let networkMonitor: NetworkMonitoring private let logger: ConsoleLogging @@ -78,28 +78,29 @@ final class Dispatcher: NSObject, Dispatching { // Always connect when there is a message to be sent if !socket.isConnected { do { - try socketConnectionHandler.handleInternalConnect() + Task { try await socketConnectionHandler.handleInternalConnect() } } catch { cancellable?.cancel() completion(error) } } - cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) - .filter { $0.0 == .connected && $0.1 == .connected } - .setFailureType(to: NetworkError.self) - .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) - .sink(receiveCompletion: { result in - switch result { - case .failure(let error): - cancellable?.cancel() - completion(error) - case .finished: break - } - }, receiveValue: { [unowned self] _ in - cancellable?.cancel() - send(string, completion: completion) - }) + // in progress +// cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) +// .filter { $0.0 == .connected && $0.1 == .connected } +// .setFailureType(to: NetworkError.self) +// .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) +// .sink(receiveCompletion: { result in +// switch result { +// case .failure(let error): +// cancellable?.cancel() +// completion(error) +// case .finished: break +// } +// }, receiveValue: { [unowned self] _ in +// cancellable?.cancel() +// send(string, completion: completion) +// }) } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index e1edd574b..64ae45838 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -151,10 +151,57 @@ class AutomaticSocketConnectionHandler { // MARK: - SocketConnectionHandler extension AutomaticSocketConnectionHandler: SocketConnectionHandler { - func handleInternalConnect() { - connect() + func handleInternalConnect() async throws { + let maxAttempts = maxImmediateAttempts + let timeout: TimeInterval = 15 + var attempts = 0 + + // Start the connection process immediately + connect() // This will set isConnecting = true and attempt to connect + + // Use Combine publisher to monitor connection status + let connectionStatusPublisher = socketStatusProvider.socketConnectionStatusPublisher + .share() + .makeConnectable() + + let connection = connectionStatusPublisher.connect() + + // Ensure connection is canceled when done + defer { connection.cancel() } + + // Use a Combine publisher to monitor disconnection and timeout + try await withCheckedThrowingContinuation { (continuation: CheckedContinuation) in + var cancellable: AnyCancellable? + + cancellable = connectionStatusPublisher.sink(receiveCompletion: { completion in + switch completion { + case .finished: + continuation.resume() // Connection successful + case .failure(let error): + continuation.resume(throwing: error) // Timeout or connection failure + } + }, receiveValue: { [weak self] status in + guard let self = self else { return } + + if status == .connected { + continuation.resume() // Successfully connected + } else if status == .disconnected { + attempts += 1 + self.logger.debug("Disconnection observed, incrementing attempts to \(attempts)") + + if attempts >= maxAttempts { + self.logger.debug("Max attempts reached. Failing with connection failed error.") + continuation.resume(throwing: NetworkError.connectionFailed) + } + } + }) + + // Store cancellable to keep it alive + self.publishers.insert(cancellable!) + } } + func handleConnect() throws { throw Errors.manualSocketConnectionForbidden } diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift index 808ee43df..9b47eb4a0 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/SocketConnectionHandler.swift @@ -4,7 +4,7 @@ protocol SocketConnectionHandler { /// handles connection request from the sdk consumes func handleConnect() throws /// handles connection request from sdk's internal function - func handleInternalConnect() + func handleInternalConnect() async throws func handleDisconnect(closeCode: URLSessionWebSocketTask.CloseCode) throws func handleDisconnection() async } diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index 6b1809b35..346722b82 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -240,4 +240,104 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { // Check that the periodic reconnection attempt was made XCTAssertTrue(webSocketSession.isConnected) // Assume that connection would have been attempted } + + func testHandleInternalConnectThrowsAfterThreeDisconnections() async { + // Start a task to call handleInternalConnect and await its result + let handleConnectTask = Task { + do { + try await sut.handleInternalConnect() + XCTFail("Expected handleInternalConnect to throw NetworkError.connectionFailed after three disconnections") + } catch NetworkError.connectionFailed { + // Expected behavior + XCTAssertEqual(sut.reconnectionAttempts, sut.maxImmediateAttempts) + } catch { + XCTFail("Expected NetworkError.connectionFailed, but got \(error)") + } + } + + let startObservingExpectation = XCTestExpectation(description: "Start observing connection status") + + // Allow handleInternalConnect() to start observing + DispatchQueue.main.asyncAfter(deadline: .now() + 0.001) { + startObservingExpectation.fulfill() + } + await fulfillment(of: [startObservingExpectation], timeout: 0.02) + + // Simulate three disconnections + for _ in 0.. Date: Tue, 27 Aug 2024 15:56:04 +0200 Subject: [PATCH 762/814] add more tests --- .../AutomaticSocketConnectionHandler.swift | 55 ++++++++++--------- ...utomaticSocketConnectionHandlerTests.swift | 29 ++++++++++ 2 files changed, 59 insertions(+), 25 deletions(-) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 64ae45838..3b7ae52f1 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -146,6 +146,8 @@ class AutomaticSocketConnectionHandler { connect() } } + var requestTimeout: TimeInterval = 15 + } // MARK: - SocketConnectionHandler @@ -153,11 +155,12 @@ class AutomaticSocketConnectionHandler { extension AutomaticSocketConnectionHandler: SocketConnectionHandler { func handleInternalConnect() async throws { let maxAttempts = maxImmediateAttempts - let timeout: TimeInterval = 15 var attempts = 0 - // Start the connection process immediately - connect() // This will set isConnecting = true and attempt to connect + // Start the connection process immediately if not already connecting + if !isConnecting { + connect() // This will set isConnecting = true and attempt to connect + } // Use Combine publisher to monitor connection status let connectionStatusPublisher = socketStatusProvider.socketConnectionStatusPublisher @@ -173,35 +176,37 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { try await withCheckedThrowingContinuation { (continuation: CheckedContinuation) in var cancellable: AnyCancellable? - cancellable = connectionStatusPublisher.sink(receiveCompletion: { completion in - switch completion { - case .finished: - continuation.resume() // Connection successful - case .failure(let error): - continuation.resume(throwing: error) // Timeout or connection failure - } - }, receiveValue: { [weak self] status in - guard let self = self else { return } - - if status == .connected { - continuation.resume() // Successfully connected - } else if status == .disconnected { - attempts += 1 - self.logger.debug("Disconnection observed, incrementing attempts to \(attempts)") - - if attempts >= maxAttempts { - self.logger.debug("Max attempts reached. Failing with connection failed error.") - continuation.resume(throwing: NetworkError.connectionFailed) + cancellable = connectionStatusPublisher + .setFailureType(to: NetworkError.self) // Now set failure type after makeConnectable + .timeout(.seconds(requestTimeout), scheduler: concurrentQueue, customError: { NetworkError.connectionFailed }) + .sink(receiveCompletion: { completion in + switch completion { + case .finished: + continuation.resume() // Connection successful + case .failure(let error): + continuation.resume(throwing: error) // Timeout or connection failure } - } - }) + }, receiveValue: { [weak self] status in + guard let self = self else { return } + + if status == .connected { + continuation.resume() // Successfully connected + } else if status == .disconnected { + attempts += 1 + self.logger.debug("Disconnection observed, incrementing attempts to \(attempts)") + + if attempts >= maxAttempts { + self.logger.debug("Max attempts reached. Failing with connection failed error.") + continuation.resume(throwing: NetworkError.connectionFailed) + } + } + }) // Store cancellable to keep it alive self.publishers.insert(cancellable!) } } - func handleConnect() throws { throw Errors.manualSocketConnectionForbidden } diff --git a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift index 346722b82..54e5fd0ae 100644 --- a/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift +++ b/Tests/RelayerTests/AutomaticSocketConnectionHandlerTests.swift @@ -340,4 +340,33 @@ final class AutomaticSocketConnectionHandlerTests: XCTestCase { XCTAssertNil(sut.reconnectionTimer) XCTAssertEqual(sut.reconnectionAttempts, 0) // Attempts should reset after success } + + func testHandleInternalConnectTimeout() async { + // Set a short timeout for testing purposes + sut.requestTimeout = 0.001 + // Start a task to call handleInternalConnect and await its result + let handleConnectTask = Task { + do { + try await sut.handleInternalConnect() + XCTFail("Expected handleInternalConnect to throw NetworkError.connectionFailed due to timeout") + } catch NetworkError.connectionFailed { + // Expected behavior + XCTAssertEqual(sut.reconnectionAttempts, 0) // No reconnection attempts should be recorded for timeout + } catch { + XCTFail("Expected NetworkError.connectionFailed due to timeout, but got \(error)") + } + } + + // Expectation to ensure handleInternalConnect() is observing + let startObservingExpectation = XCTestExpectation(description: "Start observing connection status") + + // Allow handleInternalConnect() to start observing + DispatchQueue.main.asyncAfter(deadline: .now() + 0.001) { + startObservingExpectation.fulfill() + } + await fulfillment(of: [startObservingExpectation], timeout: 0.02) + + // No connection simulation to allow timeout to trigger + await handleConnectTask.value + } } From d81ec99ff469737dd81c2b96bb3de41e7ec1d517 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Aug 2024 20:10:45 +0200 Subject: [PATCH 763/814] update dispatcher --- Sources/WalletConnectRelay/Dispatching.swift | 39 +++++++------------- 1 file changed, 13 insertions(+), 26 deletions(-) diff --git a/Sources/WalletConnectRelay/Dispatching.swift b/Sources/WalletConnectRelay/Dispatching.swift index 79d29b5c8..48010907f 100644 --- a/Sources/WalletConnectRelay/Dispatching.swift +++ b/Sources/WalletConnectRelay/Dispatching.swift @@ -69,40 +69,27 @@ final class Dispatcher: NSObject, Dispatching { } func protectedSend(_ string: String, completion: @escaping (Error?) -> Void) { - guard !socket.isConnected || !networkMonitor.isConnected else { - return send(string, completion: completion) + // Check if the socket is already connected and ready to send + if socket.isConnected && networkMonitor.isConnected { + send(string, completion: completion) + return } - var cancellable: AnyCancellable? - - // Always connect when there is a message to be sent - if !socket.isConnected { + // Start the connection process if not already connected + Task { do { - Task { try await socketConnectionHandler.handleInternalConnect() } + // Await the connection handler to establish the connection + try await socketConnectionHandler.handleInternalConnect() + + // If successful, send the message + send(string, completion: completion) } catch { - cancellable?.cancel() + // If an error occurs during connection, complete with that error completion(error) } } - - // in progress -// cancellable = Publishers.CombineLatest(socketConnectionStatusPublisher, networkConnectionStatusPublisher) -// .filter { $0.0 == .connected && $0.1 == .connected } -// .setFailureType(to: NetworkError.self) -// .timeout(.seconds(defaultTimeout), scheduler: concurrentQueue, customError: { .connectionFailed }) -// .sink(receiveCompletion: { result in -// switch result { -// case .failure(let error): -// cancellable?.cancel() -// completion(error) -// case .finished: break -// } -// }, receiveValue: { [unowned self] _ in -// cancellable?.cancel() -// send(string, completion: completion) -// }) } - + func protectedSend(_ string: String) async throws { var isResumed = false From 086116a4a663c755dc90b02eb3f3ce99dbfb8ac1 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Tue, 27 Aug 2024 20:27:56 +0200 Subject: [PATCH 764/814] update socket connection --- .../AutomaticSocketConnectionHandler.swift | 26 ++++++++++++------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift index 3b7ae52f1..6b17bd42d 100644 --- a/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift +++ b/Sources/WalletConnectRelay/SocketConnectionHandler/AutomaticSocketConnectionHandler.swift @@ -156,6 +156,8 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { func handleInternalConnect() async throws { let maxAttempts = maxImmediateAttempts var attempts = 0 + var isResumed = false // Track if continuation has been resumed + let requestTimeout = self.requestTimeout // Timeout set at the class level // Start the connection process immediately if not already connecting if !isConnecting { @@ -177,26 +179,30 @@ extension AutomaticSocketConnectionHandler: SocketConnectionHandler { var cancellable: AnyCancellable? cancellable = connectionStatusPublisher - .setFailureType(to: NetworkError.self) // Now set failure type after makeConnectable + .setFailureType(to: NetworkError.self) // Set failure type to NetworkError .timeout(.seconds(requestTimeout), scheduler: concurrentQueue, customError: { NetworkError.connectionFailed }) .sink(receiveCompletion: { completion in - switch completion { - case .finished: - continuation.resume() // Connection successful - case .failure(let error): + guard !isResumed else { return } // Ensure continuation is only resumed once + isResumed = true + cancellable?.cancel() // Cancel the subscription to prevent further events + + // Handle only the failure case, as .finished is not expected to be meaningful here + if case .failure(let error) = completion { continuation.resume(throwing: error) // Timeout or connection failure } - }, receiveValue: { [weak self] status in - guard let self = self else { return } - + }, receiveValue: { [unowned self] status in + guard !isResumed else { return } // Ensure continuation is only resumed once if status == .connected { + isResumed = true + cancellable?.cancel() // Cancel the subscription to prevent further events continuation.resume() // Successfully connected } else if status == .disconnected { attempts += 1 - self.logger.debug("Disconnection observed, incrementing attempts to \(attempts)") + logger.debug("Disconnection observed, incrementing attempts to \(attempts)") if attempts >= maxAttempts { - self.logger.debug("Max attempts reached. Failing with connection failed error.") + isResumed = true + cancellable?.cancel() // Cancel the subscription to prevent further events continuation.resume(throwing: NetworkError.connectionFailed) } } From 3d99108cd32e1aeba5f53a602b80fdc5fcada9d6 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Aug 2024 08:13:57 +0200 Subject: [PATCH 765/814] update package --- .../xcshareddata/xcschemes/Web3Modal.xcscheme | 67 +++++++++++++++++++ .../xcschemes/WalletConnect.xcscheme | 20 ++++++ Package.swift | 14 ++++ 3 files changed, 101 insertions(+) create mode 100644 .swiftpm/xcode/xcshareddata/xcschemes/Web3Modal.xcscheme diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/Web3Modal.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/Web3Modal.xcscheme new file mode 100644 index 000000000..ab76cc547 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/Web3Modal.xcscheme @@ -0,0 +1,67 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme index 16ee2100a..491ef2107 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme @@ -268,6 +268,26 @@ ReferencedContainer = "container:.."> + + + + + + + + Date: Wed, 28 Aug 2024 08:28:07 +0200 Subject: [PATCH 766/814] integrate w3m snapshot tests --- .../xcshareddata/swiftpm/Package.resolved | 9 +++ .../xcschemes/WalletConnectAuth.xcscheme | 77 ------------------- Package.swift | 4 +- 3 files changed, 12 insertions(+), 78 deletions(-) delete mode 100644 Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectAuth.xcscheme diff --git a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved index 85f611418..176a84034 100644 --- a/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved +++ b/Example/ExampleApp.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved @@ -118,6 +118,15 @@ "version": "1.0.3" } }, + { + "package": "swift-snapshot-testing", + "repositoryURL": "https://github.com/pointfreeco/swift-snapshot-testing", + "state": { + "branch": null, + "revision": "f29e2014f6230cf7d5138fc899da51c7f513d467", + "version": "1.10.0" + } + }, { "package": "SwiftImageReadWrite", "repositoryURL": "https://github.com/dagronf/SwiftImageReadWrite", diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectAuth.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectAuth.xcscheme deleted file mode 100644 index 3a5aff949..000000000 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnectAuth.xcscheme +++ /dev/null @@ -1,77 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Package.swift b/Package.swift index f0566332b..326a0b216 100644 --- a/Package.swift +++ b/Package.swift @@ -50,7 +50,9 @@ let package = Package( dependencies: [ .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.3.0"), .package(url: "https://github.com/WalletConnect/QRCode", from: "14.3.1"), - .package(name: "CoinbaseWalletSDK", url: "https://github.com/WalletConnect/wallet-mobile-sdk", from: "1.0.0") + .package(name: "CoinbaseWalletSDK", url: "https://github.com/WalletConnect/wallet-mobile-sdk", from: "1.0.0"), + .package(url: "https://github.com/pointfreeco/swift-snapshot-testing", .upToNextMinor(from: "1.10.0") + ), ], targets: [ .target( From 6ecf1508c4b51541a62eee8e3391cd9fb48f9200 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Aug 2024 08:31:40 +0200 Subject: [PATCH 767/814] delete sync and chat --- Example/ExampleApp.xcodeproj/project.pbxproj | 2 +- Sources/Chat/Chat.swift | 34 -- Sources/Chat/ChatClient.swift | 221 ------------ Sources/Chat/ChatClientFactory.swift | 65 ---- Sources/Chat/ChatImports.swift | 5 - Sources/Chat/ChatStorageIdentifiers.swift | 12 - .../Common/LeaveService.swift | 7 - .../Common/MessagingService.swift | 127 ------- .../Common/ResubscriptionService.swift | 31 -- .../History/HistoryService.swift | 16 - .../Invitee/InvitationHandlingService.swift | 138 -------- .../Inviter/InviteService.swift | 140 -------- .../Sync/SyncRegisterService.swift | 32 -- Sources/Chat/Storage/ChatStorage.swift | 322 ------------------ Sources/Chat/Storage/InviteKeyDelegate.swift | 54 --- .../ReceiviedInviteStatusDelegate.swift | 20 -- .../Storage/SentInviteStoreDelegate.swift | 44 --- .../Chat/Storage/ThreadStoreDelegate.swift | 38 --- Sources/Chat/Types/ChatError.swift | 20 -- Sources/Chat/Types/ChatProtocolMethod.swift | 19 -- .../Chat/Types/Payloads/AcceptPayload.swift | 59 ---- .../Chat/Types/Payloads/InvitePayload.swift | 64 ---- .../Chat/Types/Payloads/MessagePayload.swift | 62 ---- .../Chat/Types/Payloads/ReceiptPayload.swift | 59 ---- Sources/Chat/Types/Plain/Contact.swift | 7 - Sources/Chat/Types/Plain/Invite.swift | 20 -- Sources/Chat/Types/Plain/InviteKey.swift | 15 - Sources/Chat/Types/Plain/Message.swift | 35 -- Sources/Chat/Types/Plain/ReceivedInvite.swift | 58 ---- .../Types/Plain/ReceivedInviteStatus.swift | 10 - Sources/Chat/Types/Plain/SentInvite.swift | 69 ---- Sources/Chat/Types/Plain/Thread.swift | 15 - .../Services/SyncDerivationService.swift | 63 ---- .../Services/SyncService.swift | 101 ------ .../Stores/SyncHistoryStore.swift | 29 -- .../Stores/SyncIndexStore.swift | 44 --- .../Stores/SyncSignatureStore.swift | 39 --- .../WalletConnectSync/Stores/SyncStore.swift | 142 -------- .../Stores/SyncStoreFactory.swift | 12 - Sources/WalletConnectSync/Sync.swift | 27 -- Sources/WalletConnectSync/SyncClient.swift | 66 ---- .../WalletConnectSync/SyncClientFactory.swift | 33 -- Sources/WalletConnectSync/SyncConfig.swift | 7 - Sources/WalletConnectSync/SyncImports.swift | 3 - .../SyncStorageIdentifiers.swift | 18 - .../Types/Methods/SyncDeleteMethod.swift | 9 - .../Types/Methods/SyncSetMethod.swift | 9 - .../WalletConnectSync/Types/StoreMap.swift | 3 - .../WalletConnectSync/Types/StoreUpdate.swift | 15 - .../WalletConnectSync/Types/SyncRecord.swift | 7 - .../Mocks/IdentityNetwotkServiceMock.swift | 43 --- 51 files changed, 1 insertion(+), 2489 deletions(-) delete mode 100644 Sources/Chat/Chat.swift delete mode 100644 Sources/Chat/ChatClient.swift delete mode 100644 Sources/Chat/ChatClientFactory.swift delete mode 100644 Sources/Chat/ChatImports.swift delete mode 100644 Sources/Chat/ChatStorageIdentifiers.swift delete mode 100644 Sources/Chat/ProtocolServices/Common/LeaveService.swift delete mode 100644 Sources/Chat/ProtocolServices/Common/MessagingService.swift delete mode 100644 Sources/Chat/ProtocolServices/Common/ResubscriptionService.swift delete mode 100644 Sources/Chat/ProtocolServices/History/HistoryService.swift delete mode 100644 Sources/Chat/ProtocolServices/Invitee/InvitationHandlingService.swift delete mode 100644 Sources/Chat/ProtocolServices/Inviter/InviteService.swift delete mode 100644 Sources/Chat/ProtocolServices/Sync/SyncRegisterService.swift delete mode 100644 Sources/Chat/Storage/ChatStorage.swift delete mode 100644 Sources/Chat/Storage/InviteKeyDelegate.swift delete mode 100644 Sources/Chat/Storage/ReceiviedInviteStatusDelegate.swift delete mode 100644 Sources/Chat/Storage/SentInviteStoreDelegate.swift delete mode 100644 Sources/Chat/Storage/ThreadStoreDelegate.swift delete mode 100644 Sources/Chat/Types/ChatError.swift delete mode 100644 Sources/Chat/Types/ChatProtocolMethod.swift delete mode 100644 Sources/Chat/Types/Payloads/AcceptPayload.swift delete mode 100644 Sources/Chat/Types/Payloads/InvitePayload.swift delete mode 100644 Sources/Chat/Types/Payloads/MessagePayload.swift delete mode 100644 Sources/Chat/Types/Payloads/ReceiptPayload.swift delete mode 100644 Sources/Chat/Types/Plain/Contact.swift delete mode 100644 Sources/Chat/Types/Plain/Invite.swift delete mode 100644 Sources/Chat/Types/Plain/InviteKey.swift delete mode 100644 Sources/Chat/Types/Plain/Message.swift delete mode 100644 Sources/Chat/Types/Plain/ReceivedInvite.swift delete mode 100644 Sources/Chat/Types/Plain/ReceivedInviteStatus.swift delete mode 100644 Sources/Chat/Types/Plain/SentInvite.swift delete mode 100644 Sources/Chat/Types/Plain/Thread.swift delete mode 100644 Sources/WalletConnectSync/Services/SyncDerivationService.swift delete mode 100644 Sources/WalletConnectSync/Services/SyncService.swift delete mode 100644 Sources/WalletConnectSync/Stores/SyncHistoryStore.swift delete mode 100644 Sources/WalletConnectSync/Stores/SyncIndexStore.swift delete mode 100644 Sources/WalletConnectSync/Stores/SyncSignatureStore.swift delete mode 100644 Sources/WalletConnectSync/Stores/SyncStore.swift delete mode 100644 Sources/WalletConnectSync/Stores/SyncStoreFactory.swift delete mode 100644 Sources/WalletConnectSync/Sync.swift delete mode 100644 Sources/WalletConnectSync/SyncClient.swift delete mode 100644 Sources/WalletConnectSync/SyncClientFactory.swift delete mode 100644 Sources/WalletConnectSync/SyncConfig.swift delete mode 100644 Sources/WalletConnectSync/SyncImports.swift delete mode 100644 Sources/WalletConnectSync/SyncStorageIdentifiers.swift delete mode 100644 Sources/WalletConnectSync/Types/Methods/SyncDeleteMethod.swift delete mode 100644 Sources/WalletConnectSync/Types/Methods/SyncSetMethod.swift delete mode 100644 Sources/WalletConnectSync/Types/StoreMap.swift delete mode 100644 Sources/WalletConnectSync/Types/StoreUpdate.swift delete mode 100644 Sources/WalletConnectSync/Types/SyncRecord.swift delete mode 100644 Tests/ChatTests/Mocks/IdentityNetwotkServiceMock.swift diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 53c3daf0a..3fd2d31cf 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -1441,11 +1441,11 @@ A5E03DEE286464DB00888481 /* IntegrationTests */ = { isa = PBXGroup; children = ( + 84D2A66728A4F5260088AE09 /* Auth */, 847F07FE2A25DBC700B2A5A4 /* XPlatform */, 849D7A91292E2115006A2BD4 /* Push */, A5E03E0A28646A8A00888481 /* Stubs */, A5E03E0928646A8100888481 /* Sign */, - 84D2A66728A4F5260088AE09 /* Auth */, ); path = IntegrationTests; sourceTree = ""; diff --git a/Sources/Chat/Chat.swift b/Sources/Chat/Chat.swift deleted file mode 100644 index 003b64335..000000000 --- a/Sources/Chat/Chat.swift +++ /dev/null @@ -1,34 +0,0 @@ -import Foundation - -/// Chat instatnce wrapper -public class Chat { - - /// Chat client instance - public static var instance: ChatClient = { - guard let keyserverUrl = keyserverUrl else { - fatalError("Error - you must call Chat.configure(_:) before accessing the shared instance.") - } - return ChatClientFactory.create( - keyserverUrl: keyserverUrl, - relayClient: Relay.instance, - networkingInteractor: Networking.interactor, - syncClient: Sync.instance - ) - }() - - private static var keyserverUrl: String? - - private init() { } - - /// Chat instance config method - /// - Parameters: - /// - account: Chat initial account - /// - crypto: Crypto utils implementation - static public func configure( - keyserverUrl: String = "https://keys.walletconnect.com", - bip44: BIP44Provider - ) { - Chat.keyserverUrl = keyserverUrl - Sync.configure(bip44: bip44) - } -} diff --git a/Sources/Chat/ChatClient.swift b/Sources/Chat/ChatClient.swift deleted file mode 100644 index 80199e507..000000000 --- a/Sources/Chat/ChatClient.swift +++ /dev/null @@ -1,221 +0,0 @@ -import Foundation -import Combine - -public class ChatClient { - private var publishers = [AnyCancellable]() - private let identityClient: IdentityClient - private let messagingService: MessagingService - private let resubscriptionService: ResubscriptionService - private let invitationHandlingService: InvitationHandlingService - private let inviteService: InviteService - private let leaveService: LeaveService - private let kms: KeyManagementService - private let chatStorage: ChatStorage - private let syncRegisterService: SyncRegisterService - - public let socketConnectionStatusPublisher: AnyPublisher - - public var messagesPublisher: AnyPublisher<[Message], Never> { - return chatStorage.messagesPublisher - } - - public var receivedInvitesPublisher: AnyPublisher<[ReceivedInvite], Never> { - return chatStorage.receivedInvitesPublisher - } - - public var sentInvitesPublisher: AnyPublisher<[SentInvite], Never> { - return chatStorage.sentInvitesPublisher - } - - public var threadsPublisher: AnyPublisher<[Thread], Never> { - return chatStorage.threadsPublisher - } - - public var newMessagePublisher: AnyPublisher { - return chatStorage.newMessagePublisher - } - - public var newReceivedInvitePublisher: AnyPublisher { - return chatStorage.newReceivedInvitePublisher - } - - public var newSentInvitePublisher: AnyPublisher { - return chatStorage.newSentInvitePublisher - } - - public var newThreadPublisher: AnyPublisher { - return chatStorage.newThreadPublisher - } - - public var acceptPublisher: AnyPublisher<(String, SentInvite), Never> { - return chatStorage.acceptPublisher - } - - public var rejectPublisher: AnyPublisher { - return chatStorage.rejectPublisher - } - - // MARK: - Initialization - - init(identityClient: IdentityClient, - messagingService: MessagingService, - resubscriptionService: ResubscriptionService, - invitationHandlingService: InvitationHandlingService, - inviteService: InviteService, - leaveService: LeaveService, - kms: KeyManagementService, - chatStorage: ChatStorage, - syncRegisterService: SyncRegisterService, - socketConnectionStatusPublisher: AnyPublisher - ) { - self.identityClient = identityClient - self.messagingService = messagingService - self.resubscriptionService = resubscriptionService - self.invitationHandlingService = invitationHandlingService - self.inviteService = inviteService - self.leaveService = leaveService - self.kms = kms - self.chatStorage = chatStorage - self.syncRegisterService = syncRegisterService - self.socketConnectionStatusPublisher = socketConnectionStatusPublisher - } - - // MARK: - Public interface - - /// Registers a blockchain account with an identity key if not yet registered on this client - /// Registers invite key if not yet registered on this client and starts listening on invites if private is false - /// - Parameter onSign: Callback for signing CAIP-122 message to verify blockchain account ownership - /// - Returns: Returns the public identity key - @discardableResult - public func register(account: Account, - isPrivate: Bool = false, - domain: String, - onSign: @escaping SigningCallback - ) async throws -> String { - - let params = try await identityClient.prepareRegistration( - account: account, - domain: domain, - statement: "statement", - resources: ["https://keys.walletconnect.com"] - ) - - switch await onSign(params.message) { - case .signed(let signature): - let publicKey = try await identityClient.register(params: params, signature: signature) - - if !syncRegisterService.isRegistered(account: account) { - try await chatStorage.initializeHistory(account: account) - try await syncRegisterService.register(account: account, onSign: onSign) - } - - guard !isPrivate else { - return publicKey - } - - try await goPublic(account: account) - - return publicKey - - case .rejected: - fatalError("Not implemented") - } - } - - /// Unregisters a blockchain account with previously registered identity key - /// Must not unregister invite key but must stop listening for invites - public func unregister(account: Account) async throws { - try await identityClient.unregister(account: account) - } - - /// Queries the keyserver with a blockchain account - /// - Parameter account: CAIP10 blockachain account - /// - Returns: Returns the invite key - public func resolve(account: Account) async throws -> String { - try await identityClient.resolveInvite(account: account) - } - - /// Sends a chat invite - /// Creates and stores SentInvite with `pending` state - /// - Parameter invite: An Invite object - /// - Returns: Returns an invite id - @discardableResult - public func invite(invite: Invite) async throws -> Int64 { - return try await inviteService.invite(invite: invite) - } - - /// Unregisters an invite key from keyserver - /// Stops listening for invites - /// - Parameter account: CAIP10 blockachain account - public func goPrivate(account: Account) async throws { - let inviteKey = try await identityClient.goPrivate(account: account) - resubscriptionService.unsubscribeFromInvites(inviteKey: inviteKey) - try await chatStorage.removeInviteKey(inviteKey, account: account) - } - - /// Registers an invite key if not yet registered on this client from keyserver - /// Starts listening for invites - /// - Parameter account: CAIP10 blockachain account - /// - Returns: The public invite key - public func goPublic(account: Account) async throws { - let inviteKey = try await identityClient.goPublic(account: account) - try await resubscriptionService.subscribeForInvites(inviteKey: inviteKey) - try await chatStorage.initializeStores(for: account) - try await chatStorage.initializeDelegates() - try await chatStorage.setInviteKey(inviteKey, account: account) - } - - /// Accepts a chat invite by id from account specified as inviteeAccount in Invite - /// - Parameter inviteId: Invite id - /// - Returns: Thread topic - @discardableResult - public func accept(inviteId: Int64) async throws -> String { - return try await invitationHandlingService.accept(inviteId: inviteId) - } - - /// Rejects a chat invite by id from account specified as inviteeAccount in Invite - /// - Parameter inviteId: Invite id - public func reject(inviteId: Int64) async throws { - try await invitationHandlingService.reject(inviteId: inviteId) - } - - /// Sends a chat message to an active chat thread from account specified as selfAccount in Thread - /// - Parameters: - /// - topic: thread topic - /// - message: chat message - public func message(topic: String, message: String) async throws { - try await messagingService.send(topic: topic, messageString: message) - } - - /// Ping its peer to evaluate if it's currently online - /// - Parameter topic: chat thread topic - public func ping(topic: String) { - fatalError("not implemented") - } - - /// Leaves a chat thread and stops receiving messages - /// - Parameter topic: chat thread topic - public func leave(topic: String) async throws { - try await leaveService.leave(topic: topic) - } - - public func getReceivedInvites(account: Account) -> [ReceivedInvite] { - return chatStorage.getReceivedInvites(account: account) - } - - public func getSentInvites(account: Account) -> [SentInvite] { - return chatStorage.getSentInvites(account: account) - } - - public func getThreads(account: Account) -> [Thread] { - return chatStorage.getThreads(account: account) - } - - public func getMessages(topic: String) -> [Message] { - return chatStorage.getMessages(topic: topic) - } - - public func setupSubscriptions(account: Account) throws { - try chatStorage.setupSubscriptions(account: account) - } -} diff --git a/Sources/Chat/ChatClientFactory.swift b/Sources/Chat/ChatClientFactory.swift deleted file mode 100644 index 52bd97024..000000000 --- a/Sources/Chat/ChatClientFactory.swift +++ /dev/null @@ -1,65 +0,0 @@ -import Foundation - -public struct ChatClientFactory { - - static func create(keyserverUrl: String, relayClient: RelayClient, networkingInteractor: NetworkingInteractor, syncClient: SyncClient) -> ChatClient { - fatalError("fix access group") - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") - let keyserverURL = URL(string: keyserverUrl)! - return ChatClientFactory.create( - keyserverURL: keyserverURL, - relayClient: relayClient, - networkingInteractor: networkingInteractor, - keychain: keychain, - logger: ConsoleLogger(loggingLevel: .debug), - storage: UserDefaults.standard, - syncClient: syncClient - ) - } - - public static func create( - keyserverURL: URL, - relayClient: RelayClient, - networkingInteractor: NetworkingInteractor, - keychain: KeychainStorageProtocol, - logger: ConsoleLogging, - storage: KeyValueStorage, - syncClient: SyncClient - ) -> ChatClient { - let kms = KeyManagementService(keychain: keychain) - let historyService = HistoryService() - let messageStore = KeyedDatabase(storage: storage, identifier: ChatStorageIdentifiers.messages.rawValue) - let receivedInviteStore = KeyedDatabase(storage: storage, identifier: ChatStorageIdentifiers.receivedInvites.rawValue) - let threadStore: SyncStore = SyncStoreFactory.create(name: ChatStorageIdentifiers.thread.rawValue, syncClient: syncClient, storage: storage) - let identityClient = IdentityClientFactory.create(keyserver: keyserverURL, keychain: keychain, logger: logger) - let inviteKeyDelegate = InviteKeyDelegate(networkingInteractor: networkingInteractor, kms: kms, identityClient: identityClient) - let sentInviteDelegate = SentInviteStoreDelegate(networkingInteractor: networkingInteractor, kms: kms) - let threadDelegate = ThreadStoreDelegate(networkingInteractor: networkingInteractor, kms: kms, historyService: historyService) - let sentInviteStore: SyncStore = SyncStoreFactory.create(name: ChatStorageIdentifiers.sentInvite.rawValue, syncClient: syncClient, storage: storage) - let inviteKeyStore: SyncStore = SyncStoreFactory.create(name: ChatStorageIdentifiers.inviteKey.rawValue, syncClient: syncClient, storage: storage) - let receivedInviteStatusStore: SyncStore = SyncStoreFactory.create(name: ChatStorageIdentifiers.receivedInviteStatus.rawValue, syncClient: syncClient, storage: storage) - let receivedInviteStatusDelegate = ReceiviedInviteStatusDelegate() - let chatStorage = ChatStorage(kms: kms, messageStore: messageStore, receivedInviteStore: receivedInviteStore, sentInviteStore: sentInviteStore, threadStore: threadStore, inviteKeyStore: inviteKeyStore, receivedInviteStatusStore: receivedInviteStatusStore, historyService: historyService, sentInviteStoreDelegate: sentInviteDelegate, threadStoreDelegate: threadDelegate, inviteKeyDelegate: inviteKeyDelegate, receiviedInviteStatusDelegate: receivedInviteStatusDelegate) - let resubscriptionService = ResubscriptionService(networkingInteractor: networkingInteractor, kms: kms, logger: logger) - let invitationHandlingService = InvitationHandlingService(keyserverURL: keyserverURL, networkingInteractor: networkingInteractor, identityClient: identityClient, kms: kms, logger: logger, chatStorage: chatStorage) - let inviteService = InviteService(keyserverURL: keyserverURL, networkingInteractor: networkingInteractor, identityClient: identityClient, kms: kms, chatStorage: chatStorage, logger: logger) - let leaveService = LeaveService() - let messagingService = MessagingService(keyserverURL: keyserverURL, networkingInteractor: networkingInteractor, identityClient: identityClient, chatStorage: chatStorage, logger: logger) - let syncRegisterService = SyncRegisterService(syncClient: syncClient) - - let client = ChatClient( - identityClient: identityClient, - messagingService: messagingService, - resubscriptionService: resubscriptionService, - invitationHandlingService: invitationHandlingService, - inviteService: inviteService, - leaveService: leaveService, - kms: kms, - chatStorage: chatStorage, - syncRegisterService: syncRegisterService, - socketConnectionStatusPublisher: relayClient.socketConnectionStatusPublisher - ) - - return client - } -} diff --git a/Sources/Chat/ChatImports.swift b/Sources/Chat/ChatImports.swift deleted file mode 100644 index 24dfe29a5..000000000 --- a/Sources/Chat/ChatImports.swift +++ /dev/null @@ -1,5 +0,0 @@ -#if !CocoaPods -@_exported import WalletConnectSigner -@_exported import WalletConnectIdentity -@_exported import WalletConnectSync -#endif diff --git a/Sources/Chat/ChatStorageIdentifiers.swift b/Sources/Chat/ChatStorageIdentifiers.swift deleted file mode 100644 index f20d9f2e1..000000000 --- a/Sources/Chat/ChatStorageIdentifiers.swift +++ /dev/null @@ -1,12 +0,0 @@ -import Foundation - -enum ChatStorageIdentifiers: String { - case topicToInvitationPubKey = "com.walletconnect.chat.topicToInvitationPubKey" - case messages = "com.walletconnect.chat.messages" - case receivedInvites = "com.walletconnect.chat.receivedInvites" - - case thread = "com.walletconnect.chat.threads" - case sentInvite = "com.walletconnect.chat.sentInvites" - case inviteKey = "com.walletconnect.chat.inviteKeys" - case receivedInviteStatus = "com.walletconnect.chat.receivedInviteStatuses" -} diff --git a/Sources/Chat/ProtocolServices/Common/LeaveService.swift b/Sources/Chat/ProtocolServices/Common/LeaveService.swift deleted file mode 100644 index 54e724b96..000000000 --- a/Sources/Chat/ProtocolServices/Common/LeaveService.swift +++ /dev/null @@ -1,7 +0,0 @@ -import Foundation - -class LeaveService { - func leave(topic: String) async throws { - fatalError("not implemented") - } -} diff --git a/Sources/Chat/ProtocolServices/Common/MessagingService.swift b/Sources/Chat/ProtocolServices/Common/MessagingService.swift deleted file mode 100644 index f032b3b97..000000000 --- a/Sources/Chat/ProtocolServices/Common/MessagingService.swift +++ /dev/null @@ -1,127 +0,0 @@ -import Foundation -import Combine - -class MessagingService { - - private let keyserverURL: URL - private let networkingInteractor: NetworkInteracting - private let identityClient: IdentityClient - private let chatStorage: ChatStorage - private let logger: ConsoleLogging - - private var publishers = [AnyCancellable]() - - init( - keyserverURL: URL, - networkingInteractor: NetworkInteracting, - identityClient: IdentityClient, - chatStorage: ChatStorage, - logger: ConsoleLogging - ) { - self.keyserverURL = keyserverURL - self.networkingInteractor = networkingInteractor - self.identityClient = identityClient - self.chatStorage = chatStorage - self.logger = logger - setUpResponseHandling() - setUpRequestHandling() - } - - func send(topic: String, messageString: String) async throws { - guard let thread = chatStorage.getThread(topic: topic) else { - throw Errors.threadDoNotExist - } - let payload = MessagePayload(keyserver: keyserverURL, message: messageString, recipientAccount: thread.peerAccount) - let wrapper = try identityClient.signAndCreateWrapper( - payload: payload, - account: thread.selfAccount - ) - - let protocolMethod = ChatMessageProtocolMethod() - let request = RPCRequest(method: protocolMethod.method, params: wrapper) - try await networkingInteractor.request(request, topic: topic, protocolMethod: protocolMethod) - - logger.debug("Message sent on topic: \(topic)") - } -} - -private extension MessagingService { - - enum Errors: Error { - case threadDoNotExist - } - - func setUpResponseHandling() { - networkingInteractor.responseSubscription(on: ChatMessageProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - - logger.debug("Received Receipt response") - - guard - let (message, _) = try? MessagePayload.decodeAndVerify(from: payload.request), - let (receipt, _) = try? ReceiptPayload.decodeAndVerify(from: payload.response) - else { fatalError() /* TODO: Handle error */ } - - let newMessage = Message( - topic: payload.topic, - message: message.message, - authorAccount: receipt.senderAccount, - timestamp: payload.publishedAt.millisecondsSince1970 - ) - - chatStorage.set(message: newMessage, account: receipt.senderAccount) - }.store(in: &publishers) - } - - func setUpRequestHandling() { - networkingInteractor.requestSubscription(on: ChatMessageProtocolMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in - - logger.debug("Received Message Request") - - guard let (message, messageClaims) = try? MessagePayload.decodeAndVerify(from: payload.request) - else { fatalError() /* TODO: Handle error */ } - - // TODO: Compare message hash - - Task(priority: .high) { - - let authorAccount = try await identityClient.resolveIdentity(iss: messageClaims.iss) - - let newMessage = Message( - topic: payload.topic, - message: message.message, - authorAccount: authorAccount, - timestamp: payload.publishedAt.millisecondsSince1970 - ) - - chatStorage.set(message: newMessage, account: message.recipientAccount) - - let messageHash = message.message - .data(using: .utf8)! - .sha256() - .toHexString() - - let receiptPayload = ReceiptPayload( - keyserver: keyserverURL, - messageHash: messageHash, - senderAccount: authorAccount - ) - let wrapper = try identityClient.signAndCreateWrapper( - payload: receiptPayload, - account: message.recipientAccount - ) - - let response = RPCResponse(id: payload.id, result: wrapper) - - try await networkingInteractor.respond( - topic: payload.topic, - response: response, - protocolMethod: ChatMessageProtocolMethod() - ) - - logger.debug("Sent Receipt Response") - } - }.store(in: &publishers) - } -} diff --git a/Sources/Chat/ProtocolServices/Common/ResubscriptionService.swift b/Sources/Chat/ProtocolServices/Common/ResubscriptionService.swift deleted file mode 100644 index 215a2c8bd..000000000 --- a/Sources/Chat/ProtocolServices/Common/ResubscriptionService.swift +++ /dev/null @@ -1,31 +0,0 @@ -import Foundation -import Combine - -class ResubscriptionService { - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - private let logger: ConsoleLogging - private var publishers = [AnyCancellable]() - - init( - networkingInteractor: NetworkInteracting, - kms: KeyManagementServiceProtocol, - logger: ConsoleLogging - ) { - self.networkingInteractor = networkingInteractor - self.kms = kms - self.logger = logger - } - - func subscribeForInvites(inviteKey: AgreementPublicKey) async throws { - let topic = inviteKey.rawRepresentation.sha256().toHexString() - try kms.setPublicKey(publicKey: inviteKey, for: topic) - try await networkingInteractor.subscribe(topic: topic) - } - - func unsubscribeFromInvites(inviteKey: AgreementPublicKey) { - let topic = inviteKey.rawRepresentation.sha256().toHexString() - kms.deletePublicKey(for: topic) - networkingInteractor.unsubscribe(topic: topic) - } -} diff --git a/Sources/Chat/ProtocolServices/History/HistoryService.swift b/Sources/Chat/ProtocolServices/History/HistoryService.swift deleted file mode 100644 index 13f014333..000000000 --- a/Sources/Chat/ProtocolServices/History/HistoryService.swift +++ /dev/null @@ -1,16 +0,0 @@ -import Foundation - -final class HistoryService { - - init() { - - } - - func register() async throws { - fatalError() - } - - func fetchMessageHistory(thread: Thread) async throws -> [Message] { - fatalError() - } -} diff --git a/Sources/Chat/ProtocolServices/Invitee/InvitationHandlingService.swift b/Sources/Chat/ProtocolServices/Invitee/InvitationHandlingService.swift deleted file mode 100644 index 6226f8704..000000000 --- a/Sources/Chat/ProtocolServices/Invitee/InvitationHandlingService.swift +++ /dev/null @@ -1,138 +0,0 @@ -import Foundation -import Combine - -class InvitationHandlingService { - - private let keyserverURL: URL - private let networkingInteractor: NetworkInteracting - private let identityClient: IdentityClient - private let chatStorage: ChatStorage - private let logger: ConsoleLogging - private let kms: KeyManagementService - private var publishers = [AnyCancellable]() - - init( - keyserverURL: URL, - networkingInteractor: NetworkInteracting, - identityClient: IdentityClient, - kms: KeyManagementService, - logger: ConsoleLogging, - chatStorage: ChatStorage - ) { - self.keyserverURL = keyserverURL - self.kms = kms - self.networkingInteractor = networkingInteractor - self.identityClient = identityClient - self.logger = logger - self.chatStorage = chatStorage - setUpRequestHandling() - } - - func accept(inviteId: Int64) async throws -> String { - guard let invite = chatStorage.getReceivedInvite(id: inviteId) - else { throw Errors.inviteForIdNotFound } - - let inviteePublicKeyHex = try DIDKey(did: invite.inviteePublicKey).hexString - let inviteePublicKey = try AgreementPublicKey(hex: inviteePublicKeyHex) - let inviterPublicKey = try DIDKey(did: invite.inviterPublicKey).hexString - - let symmetricKey = try kms.performKeyAgreement(selfPublicKey: inviteePublicKey, peerPublicKey: inviterPublicKey) - let acceptTopic = symmetricKey.derivedTopic() - try kms.setSymmetricKey(symmetricKey.sharedKey, for: acceptTopic) - - let publicKey = try kms.createX25519KeyPair() - - let payload = AcceptPayload( - keyserver: keyserverURL, - inviterAccount: invite.inviterAccount, - inviteePublicKey: DIDKey(rawData: publicKey.rawRepresentation) - ) - let wrapper = try identityClient.signAndCreateWrapper( - payload: payload, - account: invite.inviteeAccount - ) - try await networkingInteractor.respond( - topic: acceptTopic, - response: RPCResponse(id: inviteId, result: wrapper), - protocolMethod: ChatInviteProtocolMethod() - ) - - let threadSymmetricKey = try kms.performKeyAgreement(selfPublicKey: publicKey, peerPublicKey: inviterPublicKey) - let threadTopic = threadSymmetricKey.derivedTopic() - try kms.setSymmetricKey(threadSymmetricKey.sharedKey, for: threadTopic) - try await networkingInteractor.subscribe(topic: threadTopic) - - logger.debug("Accepting an invite on topic: \(threadTopic)") - - let thread = Thread( - topic: threadTopic, - selfAccount: invite.inviteeAccount, - peerAccount: invite.inviterAccount, - symKey: threadSymmetricKey.sharedKey.hexRepresentation - ) - - try await chatStorage.set(thread: thread, account: invite.inviteeAccount) - - chatStorage.accept(receivedInvite: invite, account: invite.inviteeAccount) - - return thread.topic - } - - func reject(inviteId: Int64) async throws { - guard let invite = chatStorage.getReceivedInvite(id: inviteId) - else { throw Errors.inviteForIdNotFound } - - let inviteePublicKey = try identityClient.getInviteKey(for: invite.inviteeAccount) - let inviterPublicKey = try DIDKey(did: invite.inviterPublicKey) - let symmAgreementKey = try kms.performKeyAgreement(selfPublicKey: inviteePublicKey, peerPublicKey: inviterPublicKey.hexString) - - let rejectTopic = symmAgreementKey.derivedTopic() - try kms.setSymmetricKey(symmAgreementKey.sharedKey, for: rejectTopic) - - try await networkingInteractor.respondError( - topic: rejectTopic, - requestId: RPCID(inviteId), - protocolMethod: ChatInviteProtocolMethod(), - reason: ChatError.userRejected - ) - - chatStorage.reject(receivedInvite: invite, account: invite.inviteeAccount) - - try await chatStorage.syncRejectedReceivedInviteStatus(id: inviteId, account: invite.inviteeAccount) - } -} - -private extension InvitationHandlingService { - - enum Errors: Error { - case inviteForIdNotFound - } - - func setUpRequestHandling() { - networkingInteractor.requestSubscription(on: ChatInviteProtocolMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in - logger.debug("Did receive an invite") - - guard let (invite, claims) = try? InvitePayload.decodeAndVerify(from: payload.request) - else { fatalError() /* TODO: Handle error */ } - - Task(priority: .high) { - let inviterAccount = try await identityClient.resolveIdentity(iss: claims.iss) - // TODO: Should we cache it? - let inviteePublicKey = try await identityClient.resolveInvite(account: invite.inviteeAccount) - let inviterPublicKey = invite.inviterPublicKey.did(variant: .X25519) - - let invite = ReceivedInvite( - id: payload.id.integer, - message: invite.message, - inviterAccount: inviterAccount, - inviteeAccount: invite.inviteeAccount, - inviterPublicKey: inviterPublicKey, - inviteePublicKey: inviteePublicKey, - timestamp: payload.publishedAt.millisecondsSince1970 - ) - chatStorage.set(receivedInvite: invite, account: invite.inviteeAccount) - } - }.store(in: &publishers) - } -} diff --git a/Sources/Chat/ProtocolServices/Inviter/InviteService.swift b/Sources/Chat/ProtocolServices/Inviter/InviteService.swift deleted file mode 100644 index f1f09d31f..000000000 --- a/Sources/Chat/ProtocolServices/Inviter/InviteService.swift +++ /dev/null @@ -1,140 +0,0 @@ -import Foundation -import Combine - -class InviteService { - - private var publishers = [AnyCancellable]() - private let keyserverURL: URL - private let networkingInteractor: NetworkInteracting - private let identityClient: IdentityClient - private let logger: ConsoleLogging - private let kms: KeyManagementService - private let chatStorage: ChatStorage - - init( - keyserverURL: URL, - networkingInteractor: NetworkInteracting, - identityClient: IdentityClient, - kms: KeyManagementService, - chatStorage: ChatStorage, - logger: ConsoleLogging - ) { - self.kms = kms - self.keyserverURL = keyserverURL - self.networkingInteractor = networkingInteractor - self.identityClient = identityClient - self.logger = logger - self.chatStorage = chatStorage - setUpResponseHandling() - } - - @discardableResult - func invite(invite: Invite) async throws -> Int64 { - let protocolMethod = ChatInviteProtocolMethod() - - let selfPubKeyY = try kms.createX25519KeyPair() - let selfPrivKeyY = try kms.getPrivateKey(for: selfPubKeyY)! - - let inviteePublicKey = try DIDKey(did: invite.inviteePublicKey) - - let symKeyI = try kms.performKeyAgreement( - selfPublicKey: selfPubKeyY, - peerPublicKey: inviteePublicKey.hexString - ) - - let pubKeyX = try AgreementPublicKey(hex: inviteePublicKey.hexString) - let inviteTopic = pubKeyX.rawRepresentation.sha256().toHexString() - let responseTopic = symKeyI.derivedTopic() - - try kms.setSymmetricKey(symKeyI.sharedKey, for: inviteTopic) - try kms.setSymmetricKey(symKeyI.sharedKey, for: responseTopic) - - let wrapper = try identityClient.signAndCreateWrapper( - payload: InvitePayload( - keyserver: keyserverURL, - message: invite.message, - inviteeAccount: invite.inviteeAccount, - inviterPublicKey: DIDKey(rawData: selfPubKeyY.rawRepresentation) - ), - account: invite.inviterAccount - ) - - let inviteId = RPCID() - let request = RPCRequest(method: protocolMethod.method, params: wrapper, rpcid: inviteId) - - try await networkingInteractor.subscribe(topic: responseTopic) - try await networkingInteractor.request(request, topic: inviteTopic, protocolMethod: protocolMethod, envelopeType: .type1(pubKey: selfPubKeyY.rawRepresentation)) - - let sentInvite = SentInvite( - id: inviteId.integer, - message: invite.message, - inviterAccount: invite.inviterAccount, - inviteeAccount: invite.inviteeAccount, - inviterPubKeyY: selfPubKeyY.hexRepresentation, - inviterPrivKeyY: selfPrivKeyY.rawRepresentation.toHexString(), - responseTopic: responseTopic, - symKey: symKeyI.sharedKey.hexRepresentation, - timestamp: Date().millisecondsSince1970 - ) - - try await chatStorage.set(sentInvite: sentInvite, account: invite.inviterAccount) - - logger.debug("invite sent on topic: \(inviteTopic)") - - return inviteId.integer - } -} - -private extension InviteService { - - func setUpResponseHandling() { - networkingInteractor.responseSubscription(on: ChatInviteProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionPayload) in - logger.debug("Invite has been accepted") - - guard - let (invite, _) = try? InvitePayload.decodeAndVerify(from: payload.request), - let (accept, _) = try? AcceptPayload.decodeAndVerify(from: payload.response) - else { fatalError() /* TODO: Handle error */ } - - Task(priority: .high) { - try await createThread( - sentInviteId: payload.id.integer, - selfPubKeyHex: invite.inviterPublicKey.hexString, - peerPubKey: accept.inviteePublicKey, - account: accept.inviterAccount, - peerAccount: invite.inviteeAccount - ) - } - }.store(in: &publishers) - - networkingInteractor.responseErrorSubscription(on: ChatInviteProtocolMethod()) - .sink { [unowned self] (payload: ResponseSubscriptionErrorPayload) in - - Task(priority: .high) { - try await chatStorage.reject(sentInviteId: payload.id.integer) - } - }.store(in: &publishers) - } - - func createThread(sentInviteId: Int64, selfPubKeyHex: String, peerPubKey: DIDKey, account: Account, peerAccount: Account) async throws { - let selfPubKey = try AgreementPublicKey(hex: selfPubKeyHex) - let agreementKeys = try kms.performKeyAgreement(selfPublicKey: selfPubKey, peerPublicKey: peerPubKey.hexString) - let threadTopic = agreementKeys.derivedTopic() - try kms.setSymmetricKey(agreementKeys.sharedKey, for: threadTopic) - - try await networkingInteractor.subscribe(topic: threadTopic) - - let thread = Thread( - topic: threadTopic, - selfAccount: account, - peerAccount: peerAccount, - symKey: agreementKeys.sharedKey.hexRepresentation - ) - - try await chatStorage.set(thread: thread, account: account) - try await chatStorage.accept(sentInviteId: sentInviteId, topic: threadTopic) - - // TODO - remove symKeyI - } -} diff --git a/Sources/Chat/ProtocolServices/Sync/SyncRegisterService.swift b/Sources/Chat/ProtocolServices/Sync/SyncRegisterService.swift deleted file mode 100644 index 8bffdfbbe..000000000 --- a/Sources/Chat/ProtocolServices/Sync/SyncRegisterService.swift +++ /dev/null @@ -1,32 +0,0 @@ -import Foundation - -final class SyncRegisterService { - - private let syncClient: SyncClient - - init(syncClient: SyncClient) { - self.syncClient = syncClient - } - - func register(account: Account, onSign: @escaping SigningCallback) async throws { - let message = syncClient.getMessage(account: account) - - switch await onSign(message) { - case .signed(let signature): - try await syncClient.register(account: account, signature: signature) - case .rejected: - throw Errors.signatureRejected - } - } - - func isRegistered(account: Account) -> Bool { - return syncClient.isRegistered(account: account) - } -} - -private extension SyncRegisterService { - - enum Errors: Error { - case signatureRejected - } -} diff --git a/Sources/Chat/Storage/ChatStorage.swift b/Sources/Chat/Storage/ChatStorage.swift deleted file mode 100644 index 67ff84402..000000000 --- a/Sources/Chat/Storage/ChatStorage.swift +++ /dev/null @@ -1,322 +0,0 @@ -import Foundation -import Combine - -final class ChatStorage { - - private var publishers = Set() - - private let kms: KeyManagementServiceProtocol - private let messageStore: KeyedDatabase - private let receivedInviteStore: KeyedDatabase - private let sentInviteStore: SyncStore - private let threadStore: SyncStore - private let inviteKeyStore: SyncStore - private let receivedInviteStatusStore: SyncStore - private let historyService: HistoryService - - private let sentInviteStoreDelegate: SentInviteStoreDelegate - private let threadStoreDelegate: ThreadStoreDelegate - private let inviteKeyDelegate: InviteKeyDelegate - private let receiviedInviteStatusDelegate: ReceiviedInviteStatusDelegate - - private var messagesPublisherSubject = PassthroughSubject<[Message], Never>() - private var receivedInvitesPublisherSubject = PassthroughSubject<[ReceivedInvite], Never>() - private var newMessagePublisherSubject = PassthroughSubject() - private var newReceivedInvitePublisherSubject = PassthroughSubject() - private var newSentInvitePublisherSubject = PassthroughSubject() - private var newThreadPublisherSubject = PassthroughSubject() - - private var acceptPublisherSubject = PassthroughSubject<(String, SentInvite), Never>() - private var rejectPublisherSubject = PassthroughSubject<(SentInvite), Never>() - - var messagesPublisher: AnyPublisher<[Message], Never> { - messagesPublisherSubject.eraseToAnyPublisher() - } - - var receivedInvitesPublisher: AnyPublisher<[ReceivedInvite], Never> { - receivedInvitesPublisherSubject.eraseToAnyPublisher() - } - - var sentInvitesPublisher: AnyPublisher<[SentInvite], Never> { - sentInviteStore.dataUpdatePublisher - } - - var threadsPublisher: AnyPublisher<[Thread], Never> { - threadStore.dataUpdatePublisher - } - - var newMessagePublisher: AnyPublisher { - newMessagePublisherSubject.eraseToAnyPublisher() - } - - var newReceivedInvitePublisher: AnyPublisher { - newReceivedInvitePublisherSubject.eraseToAnyPublisher() - } - - var newSentInvitePublisher: AnyPublisher { - newSentInvitePublisherSubject.eraseToAnyPublisher() - } - - var newThreadPublisher: AnyPublisher { - newThreadPublisherSubject.eraseToAnyPublisher() - } - - var acceptPublisher: AnyPublisher<(String, SentInvite), Never> { - acceptPublisherSubject.eraseToAnyPublisher() - } - - var rejectPublisher: AnyPublisher { - rejectPublisherSubject.eraseToAnyPublisher() - } - - init( - kms: KeyManagementServiceProtocol, - messageStore: KeyedDatabase, - receivedInviteStore: KeyedDatabase, - sentInviteStore: SyncStore, - threadStore: SyncStore, - inviteKeyStore: SyncStore, - receivedInviteStatusStore: SyncStore, - historyService: HistoryService, - sentInviteStoreDelegate: SentInviteStoreDelegate, - threadStoreDelegate: ThreadStoreDelegate, - inviteKeyDelegate: InviteKeyDelegate, - receiviedInviteStatusDelegate: ReceiviedInviteStatusDelegate - ) { - self.kms = kms - self.messageStore = messageStore - self.receivedInviteStore = receivedInviteStore - self.sentInviteStore = sentInviteStore - self.threadStore = threadStore - self.inviteKeyStore = inviteKeyStore - self.receivedInviteStatusStore = receivedInviteStatusStore - self.historyService = historyService - self.sentInviteStoreDelegate = sentInviteStoreDelegate - self.threadStoreDelegate = threadStoreDelegate - self.inviteKeyDelegate = inviteKeyDelegate - self.receiviedInviteStatusDelegate = receiviedInviteStatusDelegate - - setupSyncSubscriptions() - } - - // MARK: - Configuration - - func initializeStores(for account: Account) async throws { - try await sentInviteStore.create(for: account) - try await threadStore.create(for: account) - try await inviteKeyStore.create(for: account) - try await receivedInviteStatusStore.create(for: account) - - try await sentInviteStore.subscribe(for: account) - try await threadStore.subscribe(for: account) - try await inviteKeyStore.subscribe(for: account) - try await receivedInviteStatusStore.subscribe(for: account) - } - - func initializeDelegates() async throws { - try await sentInviteStoreDelegate.onInitialization(sentInviteStore.getAll()) - try await threadStoreDelegate.onInitialization(storage: self) - try await inviteKeyDelegate.onInitialization(inviteKeyStore.getAll()) - try await receiviedInviteStatusDelegate.onInitialization() - } - - func initializeHistory(account: Account) async throws { - try await historyService.register() - - for thread in getAllThreads() { - let messages = try await historyService.fetchMessageHistory(thread: thread) - set(messages: messages, account: account) - } - } - - func setupSubscriptions(account: Account) throws { - messageStore.onUpdate = { [unowned self] in - messagesPublisherSubject.send(getMessages(account: account)) - } - receivedInviteStore.onUpdate = { [unowned self] in - receivedInvitesPublisherSubject.send(getReceivedInvites(account: account)) - } - - try sentInviteStore.setupDatabaseSubscriptions(account: account) - try threadStore.setupDatabaseSubscriptions(account: account) - try inviteKeyStore.setupDatabaseSubscriptions(account: account) - } - - // MARK: - Invites - - func getReceivedInvite(id: Int64) -> ReceivedInvite? { - return receivedInviteStore.getAll() - .first(where: { $0.id == id }) - } - - func getSentInvite(id: Int64) -> SentInvite? { - return sentInviteStore.getAll() - .first(where: { $0.id == id }) - } - - func set(receivedInvite: ReceivedInvite, account: Account) { - receivedInviteStore.set(element: receivedInvite, for: account.absoluteString) - newReceivedInvitePublisherSubject.send(receivedInvite) - } - - func set(sentInvite: SentInvite, account: Account) async throws { - try await sentInviteStore.set(object: sentInvite, for: account) - newSentInvitePublisherSubject.send(sentInvite) - } - - func getReceivedInvites(account: Account) -> [ReceivedInvite] { - return receivedInviteStore.getAll(for: account.absoluteString) - } - - func syncRejectedReceivedInviteStatus(id: Int64, account: Account) async throws { - let status = ReceivedInviteStatus(id: id, status: .rejected) - try await receivedInviteStatusStore.set(object: status, for: account) - } - - func getReceivedInvites(thread: Thread) -> [ReceivedInvite] { - return getReceivedInvites(account: thread.selfAccount) - .filter { $0.inviterAccount == thread.peerAccount } - } - - func getSentInvites(account: Account) -> [SentInvite] { - do { - return try sentInviteStore.getAll(for: account) - } catch { - // TODO: remove fatalError - fatalError(error.localizedDescription) - } - } - - func accept(receivedInvite: ReceivedInvite, account: Account) { - receivedInviteStore.delete(id: receivedInvite.databaseId, for: account.absoluteString) - - let accepted = ReceivedInvite(invite: receivedInvite, status: .approved) - receivedInviteStore.set(element: accepted, for: account.absoluteString) - } - - func reject(receivedInvite: ReceivedInvite, account: Account) { - receivedInviteStore.delete(id: receivedInvite.databaseId, for: account.absoluteString) - - let rejected = ReceivedInvite(invite: receivedInvite, status: .rejected) - receivedInviteStore.set(element: rejected, for: account.absoluteString) - } - - func accept(sentInviteId: Int64, topic: String) async throws { - guard let invite = getSentInvite(id: sentInviteId) - else { return } - - let approved = SentInvite(invite: invite, status: .approved) - try await sentInviteStore.set(object: approved, for: invite.inviterAccount) - - acceptPublisherSubject.send((topic, approved)) - } - - func reject(sentInviteId: Int64) async throws { - guard let invite = getSentInvite(id: sentInviteId) - else { return } - - let rejected = SentInvite(invite: invite, status: .rejected) - try await sentInviteStore.set(object: rejected, for: invite.inviterAccount) - - rejectPublisherSubject.send(rejected) - } - - // MARK: InviteKeys - - func setInviteKey(_ inviteKey: AgreementPublicKey, account: Account) async throws { - if let privateKey = try kms.getPrivateKey(for: inviteKey) { - let pubKeyHex = inviteKey.hexRepresentation - let privKeyHex = privateKey.rawRepresentation.toHexString() - let key = InviteKey(publicKey: pubKeyHex, privateKey: privKeyHex, account: account) - try await inviteKeyStore.set(object: key, for: account) - } - } - - func removeInviteKey(_ inviteKey: AgreementPublicKey, account: Account) async throws { - try await inviteKeyStore.delete(id: inviteKey.hexRepresentation, for: account) - } - - // MARK: - Threads - - func getAllThreads() -> [Thread] { - return threadStore.getAll() - } - - func getThreads(account: Account) -> [Thread] { - do { - return try threadStore.getAll(for: account) - } catch { - // TODO: remove fatalError - fatalError(error.localizedDescription) - } - } - - func getThread(topic: String) -> Thread? { - return getAllThreads().first(where: { $0.topic == topic }) - } - - func set(thread: Thread, account: Account) async throws { - try await threadStore.set(object: thread, for: account) - newThreadPublisherSubject.send(thread) - } - - // MARK: - Messages - - func set(message: Message, account: Account) { - messageStore.set(element: message, for: account.absoluteString) - newMessagePublisherSubject.send(message) - } - - func set(messages: [Message], account: Account) { - messageStore.set(elements: messages, for: account.absoluteString) - } - - func getMessages(topic: String) -> [Message] { - return messageStore.getAll().filter { $0.topic == topic } - } - - func getMessages(account: Account) -> [Message] { - return messageStore.getAll(for: account.absoluteString) - } -} - -private extension ChatStorage { - - func setupSyncSubscriptions() { - sentInviteStore.syncUpdatePublisher.sink { [unowned self] topic, account, update in - switch update { - case .set(let object), .update(let object): - self.sentInviteStoreDelegate.onUpdate(object) - case .delete(let object): - self.sentInviteStoreDelegate.onDelete(object) - } - }.store(in: &publishers) - - threadStore.syncUpdatePublisher.sink { [unowned self] topic, account, update in - switch update { - case .set(let object), .update(let object): - self.threadStoreDelegate.onUpdate(object, storage: self) - case .delete(let object): - self.threadStoreDelegate.onDelete(object) - } - }.store(in: &publishers) - - inviteKeyStore.syncUpdatePublisher.sink { [unowned self] topic, account, update in - switch update { - case .set(let object), .update(let object): - self.inviteKeyDelegate.onUpdate(object, account: account) - case .delete(let object): - self.inviteKeyDelegate.onDelete(object) - } - }.store(in: &publishers) - - receivedInviteStatusStore.syncUpdatePublisher.sink { [unowned self] topic, account, update in - switch update { - case .set(let object), .update(let object): - self.receiviedInviteStatusDelegate.onUpdate(object, storage: self, account: account) - case .delete(let object): - self.receiviedInviteStatusDelegate.onDelete(object) - } - }.store(in: &publishers) - } -} diff --git a/Sources/Chat/Storage/InviteKeyDelegate.swift b/Sources/Chat/Storage/InviteKeyDelegate.swift deleted file mode 100644 index dabe45016..000000000 --- a/Sources/Chat/Storage/InviteKeyDelegate.swift +++ /dev/null @@ -1,54 +0,0 @@ -import Foundation - -final class InviteKeyDelegate { - - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - private let identityClient: IdentityClient - - init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, identityClient: IdentityClient) { - self.networkingInteractor = networkingInteractor - self.kms = kms - self.identityClient = identityClient - } - - func onInitialization(_ keys: [InviteKey]) async throws { - for key in keys { - try syncKms(key: key) - } - - let topics = keys.map { $0.topic } - try await networkingInteractor.batchSubscribe(topics: topics) - } - - func onUpdate(_ key: InviteKey, account: Account) { - Task(priority: .high) { - try syncKms(key: key) - try syncIdentityStorage(key: key, account: account) - try await networkingInteractor.subscribe(topic: key.topic) - } - } - - func onDelete(_ key: InviteKey) { - Task(priority: .high) { - kms.deletePublicKey(for: key.topic) - networkingInteractor.unsubscribe(topic: key.topic) - } - } -} - -private extension InviteKeyDelegate { - - func syncKms(key: InviteKey) throws { - let inviteKey = try AgreementPublicKey(hex: key.publicKey) - let privateKey = try AgreementPrivateKey(hex: key.privateKey) - try kms.setPublicKey(publicKey: inviteKey, for: key.topic) - try kms.setPrivateKey(privateKey) - } - - func syncIdentityStorage(key: InviteKey, account: Account) throws { - let inviteKey = try AgreementPublicKey(hex: key.publicKey) - try identityClient.setInviteKey(inviteKey, account: account) - } -} - diff --git a/Sources/Chat/Storage/ReceiviedInviteStatusDelegate.swift b/Sources/Chat/Storage/ReceiviedInviteStatusDelegate.swift deleted file mode 100644 index 3f1e0e8d4..000000000 --- a/Sources/Chat/Storage/ReceiviedInviteStatusDelegate.swift +++ /dev/null @@ -1,20 +0,0 @@ -import Foundation - -final class ReceiviedInviteStatusDelegate { - - func onInitialization() async throws { - - } - - func onUpdate(_ status: ReceivedInviteStatus, storage: ChatStorage, account: Account) { - guard status.status == .rejected else { return } - - if let receivedInvite = storage.getReceivedInvite(id: status.id) { - storage.reject(receivedInvite: receivedInvite, account: account) - } - } - - func onDelete(_ status: ReceivedInviteStatus) { - - } -} diff --git a/Sources/Chat/Storage/SentInviteStoreDelegate.swift b/Sources/Chat/Storage/SentInviteStoreDelegate.swift deleted file mode 100644 index d921e546d..000000000 --- a/Sources/Chat/Storage/SentInviteStoreDelegate.swift +++ /dev/null @@ -1,44 +0,0 @@ -import Foundation - -final class SentInviteStoreDelegate { - - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - - init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol) { - self.networkingInteractor = networkingInteractor - self.kms = kms - } - - func onInitialization(_ objects: [SentInvite]) async throws { - for invite in objects { - try syncKeychain(invite: invite) - } - - let topics = objects.map { $0.responseTopic } - try await networkingInteractor.batchSubscribe(topics: topics) - } - - func onUpdate(_ object: SentInvite) { - Task(priority: .high) { - try syncKeychain(invite: object) - try await networkingInteractor.subscribe(topic: object.responseTopic) - } - } - - func onDelete(_ object: SentInvite) { - // TODO: Implement unsubscribe - } -} - -private extension SentInviteStoreDelegate { - - func syncKeychain(invite: SentInvite) throws { - let symmetricKey = try SymmetricKey(hex: invite.symKey) - let agreementPrivateKey = try AgreementPrivateKey(hex: invite.inviterPrivKeyY) - - // TODO: Should we set symKey for inviteTopic??? - try kms.setSymmetricKey(symmetricKey, for: invite.responseTopic) - try kms.setPrivateKey(agreementPrivateKey) - } -} diff --git a/Sources/Chat/Storage/ThreadStoreDelegate.swift b/Sources/Chat/Storage/ThreadStoreDelegate.swift deleted file mode 100644 index 9107ba4f6..000000000 --- a/Sources/Chat/Storage/ThreadStoreDelegate.swift +++ /dev/null @@ -1,38 +0,0 @@ -import Foundation - -final class ThreadStoreDelegate { - - private let networkingInteractor: NetworkInteracting - private let kms: KeyManagementServiceProtocol - private let historyService: HistoryService - - init(networkingInteractor: NetworkInteracting, kms: KeyManagementServiceProtocol, historyService: HistoryService) { - self.networkingInteractor = networkingInteractor - self.kms = kms - self.historyService = historyService - } - - func onInitialization(storage: ChatStorage) async throws { - let threads = storage.getAllThreads() - try await networkingInteractor.batchSubscribe(topics: threads.map { $0.topic }) - } - - func onUpdate(_ thread: Thread, storage: ChatStorage) { - Task(priority: .high) { - for receivedInvite in storage.getReceivedInvites(thread: thread) { - storage.accept(receivedInvite: receivedInvite, account: thread.selfAccount) - } - - let symmetricKey = try SymmetricKey(hex: thread.symKey) - try kms.setSymmetricKey(symmetricKey, for: thread.topic) - try await networkingInteractor.subscribe(topic: thread.topic) - - let messages = try await historyService.fetchMessageHistory(thread: thread) - storage.set(messages: messages, account: thread.selfAccount) - } - } - - func onDelete(_ object: Thread) { - - } -} diff --git a/Sources/Chat/Types/ChatError.swift b/Sources/Chat/Types/ChatError.swift deleted file mode 100644 index 7f4a8109d..000000000 --- a/Sources/Chat/Types/ChatError.swift +++ /dev/null @@ -1,20 +0,0 @@ -import Foundation - -enum ChatError: Error { - case noInviteForId - case recordNotFound - case userRejected -} - -extension ChatError: Reason { - - var code: Int { - // Errors not in specs yet - return 0 - } - - var message: String { - // Errors not in specs yet - return localizedDescription - } -} diff --git a/Sources/Chat/Types/ChatProtocolMethod.swift b/Sources/Chat/Types/ChatProtocolMethod.swift deleted file mode 100644 index cd4129938..000000000 --- a/Sources/Chat/Types/ChatProtocolMethod.swift +++ /dev/null @@ -1,19 +0,0 @@ -import Foundation - -struct ChatInviteProtocolMethod: ProtocolMethod { - let method: String = "wc_chatInvite" - - let requestConfig = RelayConfig(tag: 2000, prompt: true, ttl: 86400) - - let responseConfig = RelayConfig(tag: 2001, prompt: false, ttl: 86400) - -} - -struct ChatMessageProtocolMethod: ProtocolMethod { - let method: String = "wc_chatMessage" - - let requestConfig = RelayConfig(tag: 2002, prompt: true, ttl: 86400) - - let responseConfig = RelayConfig(tag: 2003, prompt: false, ttl: 86400) - -} diff --git a/Sources/Chat/Types/Payloads/AcceptPayload.swift b/Sources/Chat/Types/Payloads/AcceptPayload.swift deleted file mode 100644 index be06d1aa6..000000000 --- a/Sources/Chat/Types/Payloads/AcceptPayload.swift +++ /dev/null @@ -1,59 +0,0 @@ -import Foundation - -struct AcceptPayload: JWTClaimsCodable { - - struct Claims: JWTClaims { - let iss: String - let iat: UInt64 - let exp: UInt64 - let ksu: String - - let aud: String // proposer/inviter blockchain account (did:pkh) - let sub: String // public key sent by the responder/invitee - let act: String? // description of action intent - - static var action: String? { - return "invite_approval" - } - } - - struct Wrapper: JWTWrapper { - let responseAuth: String - - init(jwtString: String) { - self.responseAuth = jwtString - } - - var jwtString: String { - return responseAuth - } - } - - let keyserver: URL - let inviterAccount: Account - let inviteePublicKey: DIDKey - - init(keyserver: URL, inviterAccount: Account, inviteePublicKey: DIDKey) { - self.keyserver = keyserver - self.inviterAccount = inviterAccount - self.inviteePublicKey = inviteePublicKey - } - - init(claims: Claims) throws { - self.keyserver = try claims.ksu.asURL() - self.inviterAccount = try Account(DIDPKHString: claims.aud) - self.inviteePublicKey = try DIDKey(did: claims.sub) - } - - func encode(iss: String) throws -> Claims { - return Claims( - iss: iss, - iat: defaultIatMilliseconds(), - exp: expiry(days: 30), - ksu: keyserver.absoluteString, - aud: inviterAccount.did, - sub: inviteePublicKey.did(variant: .X25519), - act: Claims.action - ) - } -} diff --git a/Sources/Chat/Types/Payloads/InvitePayload.swift b/Sources/Chat/Types/Payloads/InvitePayload.swift deleted file mode 100644 index bd6fdef67..000000000 --- a/Sources/Chat/Types/Payloads/InvitePayload.swift +++ /dev/null @@ -1,64 +0,0 @@ -import Foundation - -struct InvitePayload: JWTClaimsCodable { - - struct Wrapper: JWTWrapper { - let inviteAuth: String - - init(jwtString: String) { - self.inviteAuth = jwtString - } - - var jwtString: String { - return inviteAuth - } - } - - struct Claims: JWTClaims { - let iss: String - let iat: UInt64 - let exp: UInt64 - let ksu: String - - let aud: String // responder/invitee blockchain account (did:pkh) - let sub: String // opening message included in the invite - let pke: String // proposer/inviter public key (did:key) - let act: String? // description of action intent - - static var action: String? { - return "invite_proposal" - } - } - - let keyserver: URL - let message: String - let inviteeAccount: Account - let inviterPublicKey: DIDKey - - init(keyserver: URL, message: String, inviteeAccount: Account, inviterPublicKey: DIDKey) { - self.keyserver = keyserver - self.message = message - self.inviteeAccount = inviteeAccount - self.inviterPublicKey = inviterPublicKey - } - - init(claims: Claims) throws { - self.keyserver = try claims.ksu.asURL() - self.message = claims.sub - self.inviteeAccount = try Account(DIDPKHString: claims.aud) - self.inviterPublicKey = try DIDKey(did: claims.pke) - } - - func encode(iss: String) throws -> Claims { - return Claims( - iss: iss, - iat: defaultIatMilliseconds(), - exp: expiry(days: 30), - ksu: keyserver.absoluteString, - aud: inviteeAccount.did, - sub: message, - pke: inviterPublicKey.did(variant: .X25519), - act: Claims.action - ) - } -} diff --git a/Sources/Chat/Types/Payloads/MessagePayload.swift b/Sources/Chat/Types/Payloads/MessagePayload.swift deleted file mode 100644 index 1452b2160..000000000 --- a/Sources/Chat/Types/Payloads/MessagePayload.swift +++ /dev/null @@ -1,62 +0,0 @@ -import Foundation - -struct MessagePayload: JWTClaimsCodable { - - struct Claims: JWTClaims { - let iss: String - let iat: UInt64 - let exp: UInt64 - let ksu: String - - let aud: String // recipient blockchain account (did:pkh) - let sub: String // message sent by the author account - let act: String? // description of action intent - - // TODO: Media not implemented - // public let xma: Media? - - static var action: String? { - return "chat_message" - } - } - - struct Wrapper: JWTWrapper { - let messageAuth: String - - init(jwtString: String) { - self.messageAuth = jwtString - } - - var jwtString: String { - return messageAuth - } - } - - let keyserver: URL - let message: String - let recipientAccount: Account - - init(keyserver: URL, message: String, recipientAccount: Account) { - self.keyserver = keyserver - self.message = message - self.recipientAccount = recipientAccount - } - - init(claims: Claims) throws { - self.keyserver = try claims.ksu.asURL() - self.message = claims.sub - self.recipientAccount = try Account(DIDPKHString: claims.aud) - } - - func encode(iss: String) throws -> Claims { - return Claims( - iss: iss, - iat: defaultIatMilliseconds(), - exp: expiry(days: 30), - ksu: keyserver.absoluteString, - aud: recipientAccount.did, - sub: message, - act: Claims.action - ) - } -} diff --git a/Sources/Chat/Types/Payloads/ReceiptPayload.swift b/Sources/Chat/Types/Payloads/ReceiptPayload.swift deleted file mode 100644 index 304b4662a..000000000 --- a/Sources/Chat/Types/Payloads/ReceiptPayload.swift +++ /dev/null @@ -1,59 +0,0 @@ -import Foundation - -struct ReceiptPayload: JWTClaimsCodable { - - struct Claims: JWTClaims { - let iss: String - let iat: UInt64 - let exp: UInt64 - let ksu: String - - let sub: String // hash of the message received - let aud: String // sender blockchain account (did:pkh) - let act: String? // description of action intent - - static var action: String? { - return "chat_receipt" - } - } - - struct Wrapper: JWTWrapper { - let receiptAuth: String - - init(jwtString: String) { - self.receiptAuth = jwtString - } - - var jwtString: String { - return receiptAuth - } - } - - let keyserver: URL - let messageHash: String - let senderAccount: Account - - init(keyserver: URL, messageHash: String, senderAccount: Account) { - self.keyserver = keyserver - self.messageHash = messageHash - self.senderAccount = senderAccount - } - - init(claims: Claims) throws { - self.keyserver = try claims.ksu.asURL() - self.messageHash = claims.sub - self.senderAccount = try Account(DIDPKHString: claims.aud) - } - - func encode(iss: String) throws -> Claims { - return Claims( - iss: iss, - iat: defaultIatMilliseconds(), - exp: expiry(days: 30), - ksu: keyserver.absoluteString, - sub: messageHash, - aud: senderAccount.did, - act: Claims.action - ) - } -} diff --git a/Sources/Chat/Types/Plain/Contact.swift b/Sources/Chat/Types/Plain/Contact.swift deleted file mode 100644 index 0f26340b5..000000000 --- a/Sources/Chat/Types/Plain/Contact.swift +++ /dev/null @@ -1,7 +0,0 @@ -import Foundation - -public struct Contact { - public let account: Account - public let publicKey: String - public let displayName: String -} diff --git a/Sources/Chat/Types/Plain/Invite.swift b/Sources/Chat/Types/Plain/Invite.swift deleted file mode 100644 index b4974db74..000000000 --- a/Sources/Chat/Types/Plain/Invite.swift +++ /dev/null @@ -1,20 +0,0 @@ -import Foundation - -public struct Invite: Codable, Equatable { - public let message: String - public let inviterAccount: Account - public let inviteeAccount: Account - public let inviteePublicKey: String - - public init( - message: String, - inviterAccount: Account, - inviteeAccount: Account, - inviteePublicKey: String - ) { - self.message = message - self.inviterAccount = inviterAccount - self.inviteeAccount = inviteeAccount - self.inviteePublicKey = inviteePublicKey - } -} diff --git a/Sources/Chat/Types/Plain/InviteKey.swift b/Sources/Chat/Types/Plain/InviteKey.swift deleted file mode 100644 index bf5cb4796..000000000 --- a/Sources/Chat/Types/Plain/InviteKey.swift +++ /dev/null @@ -1,15 +0,0 @@ -import Foundation - -struct InviteKey: DatabaseObject { - let publicKey: String - let privateKey: String - let account: Account - - var topic: String { - return Data(hex: publicKey).sha256().toHexString() - } - - var databaseId: String { - return account.absoluteString - } -} diff --git a/Sources/Chat/Types/Plain/Message.swift b/Sources/Chat/Types/Plain/Message.swift deleted file mode 100644 index f6bd8e70c..000000000 --- a/Sources/Chat/Types/Plain/Message.swift +++ /dev/null @@ -1,35 +0,0 @@ -import Foundation - -public struct Message: DatabaseObject { - public let topic: String - public let message: String - public let authorAccount: Account - public let timestamp: UInt64 - public let media: Media? - - public var databaseId: String { - return String(timestamp) - } - - init( - topic: String, - message: String, - authorAccount: Account, - timestamp: UInt64, - media: Message.Media? = nil // TODO: Implement media - ) { - self.topic = topic - self.message = message - self.authorAccount = authorAccount - self.timestamp = timestamp - self.media = media - } -} - -extension Message { - - public struct Media: Codable, Equatable { - let type: String - let data: String // Character limit is 500. Must be checked by SDK before sending - } -} diff --git a/Sources/Chat/Types/Plain/ReceivedInvite.swift b/Sources/Chat/Types/Plain/ReceivedInvite.swift deleted file mode 100644 index 64d20f357..000000000 --- a/Sources/Chat/Types/Plain/ReceivedInvite.swift +++ /dev/null @@ -1,58 +0,0 @@ -import Foundation - -public struct ReceivedInvite: DatabaseObject { - public let id: Int64 - public let message: String - public let inviterAccount: Account - public let inviteeAccount: Account - public let inviterPublicKey: String - public let inviteePublicKey: String - public let timestamp: UInt64 - public var status: Status - - public var databaseId: String { - return String(id) - } - - public init( - id: Int64, - message: String, - inviterAccount: Account, - inviteeAccount: Account, - inviterPublicKey: String, - inviteePublicKey: String, - timestamp: UInt64, - status: Status = .pending - ) { - self.id = id - self.message = message - self.inviterAccount = inviterAccount - self.inviteeAccount = inviteeAccount - self.inviterPublicKey = inviterPublicKey - self.inviteePublicKey = inviteePublicKey - self.timestamp = timestamp - self.status = status - } - - init(invite: ReceivedInvite, status: Status) { - self.init( - id: invite.id, - message: invite.message, - inviterAccount: invite.inviterAccount, - inviteeAccount: invite.inviteeAccount, - inviterPublicKey: invite.inviterPublicKey, - inviteePublicKey: invite.inviteePublicKey, - timestamp: invite.timestamp, - status: status - ) - } -} - -extension ReceivedInvite { - - public enum Status: String, Codable, Equatable { - case pending - case rejected - case approved - } -} diff --git a/Sources/Chat/Types/Plain/ReceivedInviteStatus.swift b/Sources/Chat/Types/Plain/ReceivedInviteStatus.swift deleted file mode 100644 index 3263669b7..000000000 --- a/Sources/Chat/Types/Plain/ReceivedInviteStatus.swift +++ /dev/null @@ -1,10 +0,0 @@ -import Foundation - -struct ReceivedInviteStatus: DatabaseObject { - let id: Int64 - let status: ReceivedInvite.Status - - var databaseId: String { - return String(id) - } -} diff --git a/Sources/Chat/Types/Plain/SentInvite.swift b/Sources/Chat/Types/Plain/SentInvite.swift deleted file mode 100644 index 011cf96dc..000000000 --- a/Sources/Chat/Types/Plain/SentInvite.swift +++ /dev/null @@ -1,69 +0,0 @@ -import Foundation - -public struct SentInvite: Codable, Equatable { - public let id: Int64 - public let message: String - public let inviterAccount: Account - public let inviteeAccount: Account - public let inviterPubKeyY: String - public let inviterPrivKeyY: String - public let responseTopic: String - public let symKey: String - public let timestamp: UInt64 - public var status: Status - - init( - id: Int64, - message: String, - inviterAccount: Account, - inviteeAccount: Account, - inviterPubKeyY: String, - inviterPrivKeyY: String, - responseTopic: String, - symKey: String, - timestamp: UInt64, - status: SentInvite.Status = .pending - ) { - self.id = id - self.message = message - self.inviterAccount = inviterAccount - self.inviteeAccount = inviteeAccount - self.inviterPubKeyY = inviterPubKeyY - self.inviterPrivKeyY = inviterPrivKeyY - self.responseTopic = responseTopic - self.symKey = symKey - self.timestamp = timestamp - self.status = status - } - - init(invite: SentInvite, status: Status) { - self.init( - id: invite.id, - message: invite.message, - inviterAccount: invite.inviterAccount, - inviteeAccount: invite.inviteeAccount, - inviterPubKeyY: invite.inviterPubKeyY, - inviterPrivKeyY: invite.inviterPrivKeyY, - responseTopic: invite.responseTopic, - symKey: invite.symKey, - timestamp: invite.timestamp, - status: status - ) - } -} - -extension SentInvite: DatabaseObject { - - public var databaseId: String { - return responseTopic - } -} - -extension SentInvite { - - public enum Status: String, Codable, Equatable { - case pending - case approved - case rejected - } -} diff --git a/Sources/Chat/Types/Plain/Thread.swift b/Sources/Chat/Types/Plain/Thread.swift deleted file mode 100644 index 1c1015377..000000000 --- a/Sources/Chat/Types/Plain/Thread.swift +++ /dev/null @@ -1,15 +0,0 @@ -import Foundation - -public struct Thread: Codable, Equatable { - public let topic: String - public let selfAccount: Account - public let peerAccount: Account - public let symKey: String -} - -extension Thread: DatabaseObject { - - public var databaseId: String { - return topic - } -} diff --git a/Sources/WalletConnectSync/Services/SyncDerivationService.swift b/Sources/WalletConnectSync/Services/SyncDerivationService.swift deleted file mode 100644 index d859f00fc..000000000 --- a/Sources/WalletConnectSync/Services/SyncDerivationService.swift +++ /dev/null @@ -1,63 +0,0 @@ -import Foundation - -final class SyncDerivationService { - - private let syncStorage: SyncSignatureStore - private let bip44: BIP44Provider - private let kms: KeyManagementServiceProtocol - - init( - syncStorage: SyncSignatureStore, - bip44: BIP44Provider, - kms: KeyManagementServiceProtocol - ) { - self.syncStorage = syncStorage - self.bip44 = bip44 - self.kms = kms - } - - func deriveTopic(account: Account, store: String) throws -> String { - let signature = try syncStorage.getSignature(for: account) - - guard let signatureData = signature.data(using: .utf8) else { - throw Errors.signatureIsNotUTF8 - } - - let slice = store.components(withMaxLength: 4) - .compactMap { $0.data(using: .utf8) } - .compactMap { UInt32($0.toHexString(), radix: 16) } - - let path: [DerivationPath] = [ - .hardened(77), - .hardened(0), - .notHardened(0) - ] + slice.map { .notHardened($0) } - - let entropy = signatureData.sha256() - let storeKey = bip44.derive(entropy: entropy, path: path) - let topic = storeKey.sha256().toHexString() - - let symmetricKey = try SymmetricKey(rawRepresentation: storeKey) - try kms.setSymmetricKey(symmetricKey, for: topic) - - return topic - } -} - -private extension SyncDerivationService { - - enum Errors: Error { - case signatureIsNotUTF8 - } -} - -fileprivate extension String { - - func components(withMaxLength length: Int) -> [String] { - return stride(from: 0, to: count, by: length).map { - let start = index(startIndex, offsetBy: $0) - let end = index(start, offsetBy: length, limitedBy: endIndex) ?? endIndex - return String(self[start..() - - var updatePublisher: AnyPublisher<(String, StoreUpdate), Never> { - return updateSubject.eraseToAnyPublisher() - } - - private var publishers: Set = [] - - private let networkInteractor: NetworkInteracting - private let derivationService: SyncDerivationService - private let signatureStore: SyncSignatureStore - private let historyStore: SyncHistoryStore - private let logger: ConsoleLogging - - /// `account` to `Record` keyValue store - private let indexStore: SyncIndexStore - - init(networkInteractor: NetworkInteracting, derivationService: SyncDerivationService, signatureStore: SyncSignatureStore, indexStore: SyncIndexStore, historyStore: SyncHistoryStore, logger: ConsoleLogging) { - self.networkInteractor = networkInteractor - self.derivationService = derivationService - self.signatureStore = signatureStore - self.indexStore = indexStore - self.historyStore = historyStore - self.logger = logger - - setupSubscriptions() - } - - func create(account: Account, store: String) async throws { - if let _ = try? indexStore.getRecord(account: account, name: store) { - return - } - - let topic = try derivationService.deriveTopic(account: account, store: store) - indexStore.set(topic: topic, name: store, account: account) - } - - func subscribe(account: Account, store: String) async throws { - guard let record = try? indexStore.getRecord(account: account, name: store) else { - throw Errors.recordNotFoundForAccount - } - try await networkInteractor.subscribe(topic: record.topic) - } - - func set(account: Account, store: String, object: Object) async throws { - let protocolMethod = SyncSetMethod() - let params = StoreSet(key: object.databaseId, value: try object.json()) - let rpcid = RPCID() - let request = RPCRequest(method: protocolMethod.method, params: params, rpcid: rpcid) - let record = try indexStore.getRecord(account: account, name: store) - - try await networkInteractor.request(request, topic: record.topic, protocolMethod: protocolMethod) - - historyStore.set(rpcid: rpcid.integer, topic: record.topic) - - logger.debug("Did set value for \(store). Sent on \(record.topic). Object: \n\(object)\n") - } - - func delete(account: Account, store: String, key: String) async throws { - let protocolMethod = SyncDeleteMethod() - let rpcid = RPCID() - let request = RPCRequest(method: protocolMethod.method, params: ["key": key], rpcid: rpcid) - let record = try indexStore.getRecord(account: account, name: store) - - try await networkInteractor.request(request, topic: record.topic, protocolMethod: protocolMethod) - - historyStore.set(rpcid: rpcid.integer, topic: record.topic) - - logger.debug("Did delete value for \(store). Sent on: \(record.topic). Key: \n\(key)\n") - } -} - -private extension SyncService { - - enum Errors: Error { - case recordNotFoundForAccount - } - - func setupSubscriptions() { - networkInteractor.requestSubscription(on: SyncSetMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in - if historyStore.update(topic: payload.topic, rpcid: payload.id) { - self.updateSubject.send((payload.topic, .set(payload.request))) - } - } - .store(in: &publishers) - - networkInteractor.requestSubscription(on: SyncDeleteMethod()) - .sink { [unowned self] (payload: RequestSubscriptionPayload) in - if historyStore.update(topic: payload.topic, rpcid: payload.id) { - self.updateSubject.send((payload.topic, .delete(payload.request))) - } - } - .store(in: &publishers) - } -} diff --git a/Sources/WalletConnectSync/Stores/SyncHistoryStore.swift b/Sources/WalletConnectSync/Stores/SyncHistoryStore.swift deleted file mode 100644 index a2f290074..000000000 --- a/Sources/WalletConnectSync/Stores/SyncHistoryStore.swift +++ /dev/null @@ -1,29 +0,0 @@ -import Foundation - -final class SyncHistoryStore { - - /// `topic` to `rpcid` keyValue store - private let store: CodableStore - - init(store: CodableStore) { - self.store = store - } - - func set(rpcid: Int64, topic: String) { - store.set(rpcid, forKey: topic) - } - - func update(topic: String, rpcid: RPCID) -> Bool { - guard isNew(topic: topic, rpcid: rpcid) else { return false } - store.set(rpcid.integer, forKey: topic) - return true - } -} - -private extension SyncHistoryStore { - - func isNew(topic: String, rpcid: RPCID) -> Bool { - guard let old = try? store.get(key: topic) else { return true } - return old < rpcid.integer - } -} diff --git a/Sources/WalletConnectSync/Stores/SyncIndexStore.swift b/Sources/WalletConnectSync/Stores/SyncIndexStore.swift deleted file mode 100644 index e92def273..000000000 --- a/Sources/WalletConnectSync/Stores/SyncIndexStore.swift +++ /dev/null @@ -1,44 +0,0 @@ -import Foundation - -final class SyncIndexStore { - - /// `account-store` to SyncRecord map keyValue store - private let store: CodableStore - - init(store: CodableStore) { - self.store = store - } - - func getRecord(account: Account, name: String) throws -> SyncRecord { - let identifier = identifier(account: account, name: name) - guard let record = try store.get(key: identifier) else { - throw Errors.recordNotFoundForAccount - } - return record - } - - func getRecord(topic: String) throws -> SyncRecord { - guard let record = store.getAll().first(where: { $0.topic == topic }) else { - throw Errors.accountNotFoundForTopic - } - return record - } - - func set(topic: String, name: String, account: Account) { - let identifier = identifier(account: account, name: name) - let record = SyncRecord(topic: topic, store: name, account: account) - store.set(record, forKey: identifier) - } -} - -private extension SyncIndexStore { - - enum Errors: Error { - case recordNotFoundForAccount - case accountNotFoundForTopic - } - - func identifier(account: Account, name: String) -> String { - return "\(account.absoluteString)-\(name)" - } -} diff --git a/Sources/WalletConnectSync/Stores/SyncSignatureStore.swift b/Sources/WalletConnectSync/Stores/SyncSignatureStore.swift deleted file mode 100644 index e8c5b69c0..000000000 --- a/Sources/WalletConnectSync/Stores/SyncSignatureStore.swift +++ /dev/null @@ -1,39 +0,0 @@ -import Foundation -import Combine - -final class SyncSignatureStore { - - private let keychain: KeychainStorageProtocol - - init(keychain: KeychainStorageProtocol) { - self.keychain = keychain - } - - func saveSignature(_ key: String, for account: Account) throws { - try keychain.add(key, forKey: signatureIdentifier(for: account)) - } - - func getSignature(for account: Account) throws -> String { - let identifier = signatureIdentifier(for: account) - - guard let key: String = try? keychain.read(key: identifier) - else { throw Errors.signatureNotFound } - - return key - } - - func isSignatureExists(account: Account) -> Bool { - return (try? getSignature(for: account)) != nil - } -} - -private extension SyncSignatureStore { - - enum Errors: Error { - case signatureNotFound - } - - func signatureIdentifier(for account: Account) -> String { - return "com.walletconnect.sync.signature.\(account.absoluteString)" - } -} diff --git a/Sources/WalletConnectSync/Stores/SyncStore.swift b/Sources/WalletConnectSync/Stores/SyncStore.swift deleted file mode 100644 index e6d93f32c..000000000 --- a/Sources/WalletConnectSync/Stores/SyncStore.swift +++ /dev/null @@ -1,142 +0,0 @@ -import Foundation -import Combine - -public enum SyncUpdate { - case set(object: Object) - case delete(object: Object) - case update(object: Object) -} - -public final class SyncStore { - - private var publishers = Set() - - private let name: String - private let syncClient: SyncClient - - /// `account` to `Record` keyValue store - private let indexStore: SyncIndexStore - - /// `storeTopic` to [`id`: `Object`] map keyValue store - private let objectStore: KeyedDatabase - - private let dataUpdateSubject = PassthroughSubject<[Object], Never>() - private let syncUpdateSubject = PassthroughSubject<(String, Account, SyncUpdate), Never>() - - public var dataUpdatePublisher: AnyPublisher<[Object], Never> { - return dataUpdateSubject.eraseToAnyPublisher() - } - - public var syncUpdatePublisher: AnyPublisher<(String, Account, SyncUpdate), Never> { - return syncUpdateSubject.eraseToAnyPublisher() - } - - init(name: String, syncClient: SyncClient, indexStore: SyncIndexStore, objectStore: KeyedDatabase) { - self.name = name - self.syncClient = syncClient - self.indexStore = indexStore - self.objectStore = objectStore - - setupSubscriptions() - } - - public func create(for account: Account) async throws { - try await syncClient.create(account: account, store: name) - } - - public func subscribe(for account: Account) async throws { - try await syncClient.subscribe(account: account, store: name) - } - - public func setupDatabaseSubscriptions(account: Account) throws { - let record = try indexStore.getRecord(account: account, name: name) - - objectStore.onUpdate = { [unowned self] in - dataUpdateSubject.send(objectStore.getAll(for: record.topic)) - } - } - - public func getAll(for account: Account) throws -> [Object] { - let record = try indexStore.getRecord(account: account, name: name) - return objectStore.getAll(for: record.topic) - } - - public func getAll() -> [Object] { - return objectStore.getAll() - } - - public func get(for id: String) -> Object? { - return getAll().first(where: { $0.databaseId == id }) - } - - public func set(object: Object, for account: Account) async throws { - let record = try indexStore.getRecord(account: account, name: name) - - if objectStore.set(element: object, for: record.topic) { - try await syncClient.set(account: account, store: record.store, object: object) - } - } - - public func delete(id: String, for account: Account) async throws { - let record = try indexStore.getRecord(account: account, name: name) - - if objectStore.delete(id: id, for: record.topic) { - try await syncClient.delete(account: account, store: record.store, key: id) - } - } - - public func delete(id: String) async throws { - guard let result = objectStore.find(id: id) else { - return - } - let record = try indexStore.getRecord(topic: result.key) - try await delete(id: id, for: record.account) - } - - public func getStoreTopic(account: Account) throws -> String { - let record = try indexStore.getRecord(account: account, name: name) - return record.topic - } - - public func replaceInStore(objects: [Object], for account: Account) throws { - let record = try indexStore.getRecord(account: account, name: name) - objectStore.deleteAll(for: record.topic) - objectStore.set(elements: objects, for: record.topic) - } -} - -private extension SyncStore { - - func setupSubscriptions() { - syncClient.updatePublisher.sink { [unowned self] (topic, update) in - - let record = try! indexStore.getRecord(topic: topic) - - guard record.store == name else { return } - - switch update { - case .set(let set): - let object = try! JSONDecoder().decode(Object.self, from: Data(set.value.utf8)) - let exists = objectStore.exists(for: record.topic, id: object.databaseId) - if try! setInStore(object: object, for: record.account) { - let update: SyncUpdate = exists ? .update(object: object) : .set(object: object) - syncUpdateSubject.send((topic, record.account, update)) - } - case .delete(let delete): - if let object = get(for: delete.key), try! deleteInStore(id: delete.key, for: record.account) { - syncUpdateSubject.send((topic, record.account, .delete(object: object))) - } - } - }.store(in: &publishers) - } - - func setInStore(object: Object, for account: Account) throws -> Bool { - let record = try indexStore.getRecord(account: account, name: name) - return objectStore.set(element: object, for: record.topic) - } - - func deleteInStore(id: String, for account: Account) throws -> Bool { - let record = try indexStore.getRecord(account: account, name: name) - return objectStore.delete(id: id, for: record.topic) - } -} diff --git a/Sources/WalletConnectSync/Stores/SyncStoreFactory.swift b/Sources/WalletConnectSync/Stores/SyncStoreFactory.swift deleted file mode 100644 index cfd55b22d..000000000 --- a/Sources/WalletConnectSync/Stores/SyncStoreFactory.swift +++ /dev/null @@ -1,12 +0,0 @@ -import Foundation - -public final class SyncStoreFactory { - - public static func create(name: String, syncClient: SyncClient, storage: KeyValueStorage) -> SyncStore { - let indexDatabase = CodableStore(defaults: UserDefaults.standard, identifier: SyncStorageIdentifiers.index.identifier) - let indexStore = SyncIndexStore(store: indexDatabase) - let objectIdentifier = SyncStorageIdentifiers.object(store: name).identifier - let objectStore = KeyedDatabase(storage: storage, identifier: objectIdentifier) - return SyncStore(name: name, syncClient: syncClient, indexStore: indexStore, objectStore: objectStore) - } -} diff --git a/Sources/WalletConnectSync/Sync.swift b/Sources/WalletConnectSync/Sync.swift deleted file mode 100644 index 6144b16e5..000000000 --- a/Sources/WalletConnectSync/Sync.swift +++ /dev/null @@ -1,27 +0,0 @@ -import Foundation - -/// Sync instatnce wrapper -public class Sync { - - /// Sync client instance - public static var instance: SyncClient = { - guard let config = config else { - fatalError("Error - you must call Sync.configure(_:) before accessing the shared instance.") - } - return SyncClientFactory.create( - networkInteractor: Networking.interactor, - bip44: config.bip44 - ) - }() - - private static var config: Config? - - private init() { } - - /// Auth instance wallet config method. For DApp usage - /// - Parameters: - /// - crypto: Crypto utils implementation - static public func configure(bip44: BIP44Provider) { - Sync.config = Sync.Config(bip44: bip44) - } -} diff --git a/Sources/WalletConnectSync/SyncClient.swift b/Sources/WalletConnectSync/SyncClient.swift deleted file mode 100644 index e7e336d8e..000000000 --- a/Sources/WalletConnectSync/SyncClient.swift +++ /dev/null @@ -1,66 +0,0 @@ -import Foundation -import Combine - -public final class SyncClient { - - public var updatePublisher: AnyPublisher<(String, StoreUpdate), Never> { - return syncService.updatePublisher - } - - private let syncService: SyncService - private let syncSignatureStore: SyncSignatureStore - - init(syncService: SyncService, syncSignatureStore: SyncSignatureStore) { - self.syncService = syncService - self.syncSignatureStore = syncSignatureStore - } - - /// Get message to sign for an account - public func getMessage(account: Account) -> String { - return """ - I authorize this app to sync my account: \(account.absoluteString) - - Read more about it here: https://walletconnect.com/faq - """ - } - - /// Checks if account is already registered in sync - public func isRegistered(account: Account) -> Bool { - return syncSignatureStore.isSignatureExists(account: account) - } - - /// Register an account to sync - public func register(account: Account, signature: CacaoSignature) async throws { - // TODO: Signature verify - try syncSignatureStore.saveSignature(signature.s, for: account) - } - - /// Create a store - public func create(account: Account, store: String) async throws { - try await syncService.create(account: account, store: store) - } - - /// Subscribe for sync topic - public func subscribe(account: Account, store: String) async throws { - try await syncService.subscribe(account: account, store: store) - } - - // Set value to store - public func set( - account: Account, - store: String, - object: Object - ) async throws { - try await syncService.set(account: account, store: store, object: object) - } - - // Set value from store by key - public func delete(account: Account, store: String, key: String) async throws { - try await syncService.delete(account: account, store: store, key: key) - } - - // Get stores - public func getStores(account: Account) -> StoreMap { - fatalError() - } -} diff --git a/Sources/WalletConnectSync/SyncClientFactory.swift b/Sources/WalletConnectSync/SyncClientFactory.swift deleted file mode 100644 index bd92adba8..000000000 --- a/Sources/WalletConnectSync/SyncClientFactory.swift +++ /dev/null @@ -1,33 +0,0 @@ -import Foundation - -final class SyncClientFactory { - - static func create(networkInteractor: NetworkInteracting, bip44: BIP44Provider) -> SyncClient { - fatalError("fix access group") - let keychain = KeychainStorage(serviceIdentifier: "com.walletconnect.sdk", accessGroup: "") - return create(networkInteractor: networkInteractor, bip44: bip44, keychain: keychain) - } - - static func create(networkInteractor: NetworkInteracting, bip44: BIP44Provider, keychain: KeychainStorageProtocol) -> SyncClient { - let signatureStore = SyncSignatureStore(keychain: keychain) - let kms = KeyManagementService(keychain: keychain) - let deriviationService = SyncDerivationService( - syncStorage: signatureStore, - bip44: bip44, - kms: kms - ) - let indexStore = CodableStore(defaults: UserDefaults.standard, identifier: SyncStorageIdentifiers.index.identifier) - let syncIndexStore = SyncIndexStore(store: indexStore) - let historyStore = CodableStore(defaults: UserDefaults.standard, identifier: SyncStorageIdentifiers.history.identifier) - let syncHistoryStore = SyncHistoryStore(store: historyStore) - let syncService = SyncService( - networkInteractor: networkInteractor, - derivationService: deriviationService, - signatureStore: signatureStore, - indexStore: syncIndexStore, - historyStore: syncHistoryStore, - logger: ConsoleLogger(loggingLevel: .debug) - ) - return SyncClient(syncService: syncService, syncSignatureStore: signatureStore) - } -} diff --git a/Sources/WalletConnectSync/SyncConfig.swift b/Sources/WalletConnectSync/SyncConfig.swift deleted file mode 100644 index a77e2d800..000000000 --- a/Sources/WalletConnectSync/SyncConfig.swift +++ /dev/null @@ -1,7 +0,0 @@ -import Foundation - -extension Sync { - struct Config { - let bip44: BIP44Provider - } -} diff --git a/Sources/WalletConnectSync/SyncImports.swift b/Sources/WalletConnectSync/SyncImports.swift deleted file mode 100644 index 338babe27..000000000 --- a/Sources/WalletConnectSync/SyncImports.swift +++ /dev/null @@ -1,3 +0,0 @@ -#if !CocoaPods -@_exported import WalletConnectSigner -#endif diff --git a/Sources/WalletConnectSync/SyncStorageIdentifiers.swift b/Sources/WalletConnectSync/SyncStorageIdentifiers.swift deleted file mode 100644 index 59cb06f23..000000000 --- a/Sources/WalletConnectSync/SyncStorageIdentifiers.swift +++ /dev/null @@ -1,18 +0,0 @@ -import Foundation - -enum SyncStorageIdentifiers { - case index - case history - case object(store: String) - - var identifier: String { - switch self { - case .index: - return "com.walletconnect.sync.index" - case .history: - return "com.walletconnect.sync.history" - case .object(let store): - return "com.walletconnect.sync.object.\(store)" - } - } -} diff --git a/Sources/WalletConnectSync/Types/Methods/SyncDeleteMethod.swift b/Sources/WalletConnectSync/Types/Methods/SyncDeleteMethod.swift deleted file mode 100644 index 59a602fd3..000000000 --- a/Sources/WalletConnectSync/Types/Methods/SyncDeleteMethod.swift +++ /dev/null @@ -1,9 +0,0 @@ -import Foundation - -struct SyncDeleteMethod: ProtocolMethod { - let method: String = "wc_syncDel" - - let requestConfig = RelayConfig(tag: 5002, prompt: false, ttl: 2592000) - - let responseConfig = RelayConfig(tag: 5003, prompt: false, ttl: 2592000) -} diff --git a/Sources/WalletConnectSync/Types/Methods/SyncSetMethod.swift b/Sources/WalletConnectSync/Types/Methods/SyncSetMethod.swift deleted file mode 100644 index fb69c2ad1..000000000 --- a/Sources/WalletConnectSync/Types/Methods/SyncSetMethod.swift +++ /dev/null @@ -1,9 +0,0 @@ -import Foundation - -struct SyncSetMethod: ProtocolMethod { - let method: String = "wc_syncSet" - - let requestConfig = RelayConfig(tag: 5000, prompt: false, ttl: 2592000) - - let responseConfig = RelayConfig(tag: 5001, prompt: false, ttl: 2592000) -} diff --git a/Sources/WalletConnectSync/Types/StoreMap.swift b/Sources/WalletConnectSync/Types/StoreMap.swift deleted file mode 100644 index 62f9ac2c7..000000000 --- a/Sources/WalletConnectSync/Types/StoreMap.swift +++ /dev/null @@ -1,3 +0,0 @@ -import Foundation - -public typealias StoreMap = Dictionary diff --git a/Sources/WalletConnectSync/Types/StoreUpdate.swift b/Sources/WalletConnectSync/Types/StoreUpdate.swift deleted file mode 100644 index d0cf82ff0..000000000 --- a/Sources/WalletConnectSync/Types/StoreUpdate.swift +++ /dev/null @@ -1,15 +0,0 @@ -import Foundation - -public enum StoreUpdate { - case set(StoreSet) - case delete(StoreDelete) -} - -public struct StoreSet: Codable, Equatable { - public let key: String - public let value: String -} - -public struct StoreDelete: Codable, Equatable { - public let key: String -} diff --git a/Sources/WalletConnectSync/Types/SyncRecord.swift b/Sources/WalletConnectSync/Types/SyncRecord.swift deleted file mode 100644 index ddde0b38b..000000000 --- a/Sources/WalletConnectSync/Types/SyncRecord.swift +++ /dev/null @@ -1,7 +0,0 @@ -import Foundation - -struct SyncRecord: Codable & Equatable { - let topic: String - let store: String - let account: Account -} diff --git a/Tests/ChatTests/Mocks/IdentityNetwotkServiceMock.swift b/Tests/ChatTests/Mocks/IdentityNetwotkServiceMock.swift deleted file mode 100644 index 2a0f65768..000000000 --- a/Tests/ChatTests/Mocks/IdentityNetwotkServiceMock.swift +++ /dev/null @@ -1,43 +0,0 @@ -import Foundation -@testable import WalletConnectChat -@testable import WalletConnectIdentity - -final class IdentityNetwotkServiceMock: IdentityNetworking { - - private(set) var callRegisterIdentity: Bool = false - private(set) var callRemoveIdentity: Bool = false - private(set) var callRegisterInvite: Bool = false - private(set) var callRemoveInvite: Bool = false - - private let cacao: Cacao - private let inviteKey: String - - init(cacao: Cacao, inviteKey: String) { - self.cacao = cacao - self.inviteKey = inviteKey - } - - func registerIdentity(cacao: WalletConnectUtils.Cacao) async throws { - callRegisterIdentity = true - } - - func resolveIdentity(publicKey: String) async throws -> WalletConnectUtils.Cacao { - return cacao - } - - func removeIdentity(idAuth: String) async throws { - callRemoveIdentity = true - } - - func registerInvite(idAuth: String) async throws { - callRegisterInvite = true - } - - func resolveInvite(account: String) async throws -> String { - return inviteKey - } - - func removeInvite(idAuth: String) async throws { - callRemoveInvite = true - } -} From edc4db6696e1272f96c7f15f1ec0795d074d11dd Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Aug 2024 08:35:24 +0200 Subject: [PATCH 768/814] savepoint --- Example/DApp/SceneDelegate.swift | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index 448c3bd66..c7e502c8a 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -108,7 +108,8 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { projectId: InputConfig.projectId, metadata: metadata, crypto: DefaultCryptoProvider(), - authRequestParams: .stub(), customWallets: [ + authRequestParams: .stub(), // set to nil for non SIWE + customWallets: [ .init( id: "swift-sample", name: "Swift Sample Wallet", From 661b295c62b2acd28060e6ad60d6b5847d943254 Mon Sep 17 00:00:00 2001 From: Alfreedom <00tango.bromine@icloud.com> Date: Wed, 28 Aug 2024 11:13:19 +0200 Subject: [PATCH 769/814] Removed production wallet --- Example/DApp/SceneDelegate.swift | 9 --------- 1 file changed, 9 deletions(-) diff --git a/Example/DApp/SceneDelegate.swift b/Example/DApp/SceneDelegate.swift index e0b717820..185793b3a 100644 --- a/Example/DApp/SceneDelegate.swift +++ b/Example/DApp/SceneDelegate.swift @@ -127,15 +127,6 @@ class SceneDelegate: UIResponder, UIWindowSceneDelegate { mobileLink: "rn-web3wallet://", linkMode: "https://lab.web3modal.com/rn_walletkit" ), - .init( - id: "flutter-sample", - name: "FL Sample Wallet", - homepage: "https://walletconnect.com/", - imageUrl: "https://avatars.githubusercontent.com/u/37784886?s=200&v=4", - order: 1, - mobileLink: "wcflutterwallet://", - linkMode: "https://lab.web3modal.com/walletkit_flutter" - ), .init( id: "flutter-sample-internal", name: "FL Sample Wallet (internal)", From 958de26146514200c7a4deedf234a415eac6af11 Mon Sep 17 00:00:00 2001 From: Bartosz Rozwarski Date: Wed, 28 Aug 2024 15:19:31 +0200 Subject: [PATCH 770/814] renam w3m --- Example/ExampleApp.xcodeproj/project.pbxproj | 526 ------------------ .../xcshareddata/xcschemes/Showcase.xcscheme | 78 --- .../xcshareddata/xcschemes/Wallet.xcscheme | 127 ----- .../xcschemes/WalletConnect.xcscheme | 12 +- .../ApplicationLayer/AppDelegate.swift | 20 - .../ApplicationLayer/Application.swift | 13 - .../Configurator/AppearanceConfigurator.swift | 19 - .../ApplicationConfigurator.swift | 16 - .../Configurator/Configurator.swift | 9 - .../Configurator/MigrationConfigurator.swift | 12 - .../Configurator/ThirdPartyConfigurator.swift | 21 - .../ApplicationLayer/SceneDelegate.swift | 41 -- .../DomainLayer/Chat/ChatService.swift | 185 ------ .../Chat/Chat/ChatInteractor.swift | 23 - .../Chat/Chat/ChatModule.swift | 19 - .../Chat/Chat/ChatPresenter.swift | 61 -- .../Chat/Chat/ChatRouter.swift | 12 - .../Chat/Chat/ChatView.swift | 37 -- .../Chat/Chat/Models/MessageViewModel.swift | 32 -- .../Chat/Chat/Views/ChatScrollView.swift | 25 - .../Chat/Chat/Views/ContentMessageView.swift | 35 -- .../Chat/Chat/Views/MessageView.swift | 28 - .../Chat/ChatList/ChatListInteractor.swift | 51 -- .../Chat/ChatList/ChatListModule.swift | 18 - .../Chat/ChatList/ChatListPresenter.swift | 131 ----- .../Chat/ChatList/ChatListRouter.swift | 36 -- .../Chat/ChatList/ChatListView.swift | 153 ----- .../Chat/ChatList/Models/AlertError.swift | 9 - .../ChatList/Models/ThreadViewModel.swift | 22 - .../Chat/Import/ImportInteractor.swift | 18 - .../Chat/Import/ImportModule.swift | 18 - .../Chat/Import/ImportPresenter.swift | 79 --- .../Chat/Import/ImportRouter.swift | 22 - .../Chat/Import/ImportView.swift | 48 -- .../Chat/Invite/InviteInteractor.swift | 22 - .../Chat/Invite/InviteModule.swift | 18 - .../Chat/Invite/InvitePresenter.swift | 92 --- .../Chat/Invite/InviteRouter.swift | 16 - .../Chat/Invite/InviteView.swift | 43 -- .../InviteList/InviteListInteractor.swift | 33 -- .../Chat/InviteList/InviteListModule.swift | 18 - .../Chat/InviteList/InviteListPresenter.swift | 92 --- .../Chat/InviteList/InviteListRouter.swift | 16 - .../Chat/InviteList/InviteListView.swift | 80 --- .../Chat/InviteList/Models/InviteType.swift | 15 - .../InviteList/Models/InviteViewModel.swift | 34 -- .../Chat/Main/MainModule.swift | 16 - .../Chat/Main/MainPresenter.swift | 24 - .../Chat/Main/MainRouter.swift | 20 - .../Chat/Main/MainViewController.swift | 38 -- .../Chat/Main/Model/TabPage.swift | 32 -- .../Chat/Welcome/WelcomeInteractor.swift | 49 -- .../Chat/Welcome/WelcomeModule.swift | 18 - .../Chat/Welcome/WelcomePresenter.swift | 40 -- .../Chat/Welcome/WelcomeRouter.swift | 27 - .../Chat/Welcome/WelcomeView.swift | 61 -- .../Web3Inbox/Web3InboxModule.swift | 13 - .../Web3Inbox/Web3InboxRouter.swift | 12 - .../Web3Inbox/Web3InboxViewController.swift | 40 -- .../Common/Components/BrandButton.swift | 25 - .../Common/Components/InputView.swift | 28 - .../Common/Components/PlainButton.swift | 16 - .../Common/Components/TextFieldView.swift | 50 -- .../Common/Extensions/SwiftUI/View.swift | 17 - .../Common/Extensions/UIKit/String.swift | 8 - .../Common/Extensions/UIKit/UIColor.swift | 20 - .../Extensions/UIKit/UIViewController.swift | 50 -- Example/Showcase/Common/InputConfig.swift | 20 - Example/Showcase/Common/Style/Color.swift | 32 -- Example/Showcase/Common/Types/Types.swift | 3 - .../Common/VIPER/SceneViewController.swift | 73 --- .../AccentColor.colorset/Contents.json | 20 - .../AppIcon.appiconset/Contents.json | 116 ---- .../AppIcon.appiconset/Icon-App-20x20@1x.png | Bin 909 -> 0 bytes .../Icon-App-20x20@2x-1.png | Bin 1706 -> 0 bytes .../AppIcon.appiconset/Icon-App-20x20@2x.png | Bin 1706 -> 0 bytes .../AppIcon.appiconset/Icon-App-20x20@3x.png | Bin 2303 -> 0 bytes .../AppIcon.appiconset/Icon-App-29x29@1x.png | Bin 1247 -> 0 bytes .../Icon-App-29x29@2x-1.png | Bin 2260 -> 0 bytes .../AppIcon.appiconset/Icon-App-29x29@2x.png | Bin 2260 -> 0 bytes .../AppIcon.appiconset/Icon-App-29x29@3x.png | Bin 3370 -> 0 bytes .../AppIcon.appiconset/Icon-App-40x40@1x.png | Bin 1706 -> 0 bytes .../Icon-App-40x40@2x-1.png | Bin 3211 -> 0 bytes .../AppIcon.appiconset/Icon-App-40x40@2x.png | Bin 3211 -> 0 bytes .../AppIcon.appiconset/Icon-App-40x40@3x.png | Bin 4313 -> 0 bytes .../AppIcon.appiconset/Icon-App-60x60@2x.png | Bin 4313 -> 0 bytes .../AppIcon.appiconset/Icon-App-60x60@3x.png | Bin 6262 -> 0 bytes .../AppIcon.appiconset/Icon-App-76x76@1x.png | Bin 2990 -> 0 bytes .../AppIcon.appiconset/Icon-App-76x76@2x.png | Bin 5312 -> 0 bytes .../Icon-App-83.5x83.5@2x.png | Bin 6074 -> 0 bytes .../AppIcon.appiconset/ItunesArtwork@2x.png | Bin 39006 -> 0 bytes .../LaunchLogo.imageset/Contents.json | 21 - .../LaunchLogo.imageset/LaunchLogo.png | Bin 337330 -> 0 bytes .../LaunchScreen.imageset/Contents.json | 21 - .../LaunchScreen.imageset/Group 1.png | Bin 3639624 -> 0 bytes .../avatar.imageset/Contents.json | 12 - .../avatar.imageset/avatar.svg | 13 - .../checkmark_icon.imageset/Contents.json | 21 - .../checkmark_icon.imageset/Icon.png | Bin 1941 -> 0 bytes .../cross_icon.imageset/Contents.json | 21 - .../cross_icon.imageset/Icon-1.png | Bin 1718 -> 0 bytes .../plus_icon.imageset/Contents.json | 21 - .../plus_icon.imageset/Icon.png | Bin 914 -> 0 bytes .../profile_icon.imageset/Contents.json | 21 - .../profile_icon.imageset/profile_icon.png | Bin 82018 -> 0 bytes .../Other/Base.lproj/LaunchScreen.storyboard | 54 -- Example/Showcase/Other/Info.plist | 47 -- Package.swift | 32 +- .../Analytics/AnalyticsEvent.swift | 0 .../Analytics/AnalyticsEventMapper.swift | 0 .../Analytics/AnalyticsProvider.swift | 0 .../AnalyticsEvent+ResultBuilders.swift | 0 .../Convenience/AnalyticsEventGroup.swift | 0 .../AnalyticsEventTrackingModifier.swift | 0 .../Convenience/AnalyticsEventTrigger.swift | 0 .../Analytics/Convenience/View+Track.swift | 0 .../Analytics/Private/AnalyticsService.swift | 0 .../ClickstreamAnalyticsProvider.swift | 0 .../Private/DefaultAnalyticsEventMapper.swift | 0 .../Private/LoggingAnalyticsProvider.swift | 0 .../Components/AccountButton.swift | 0 .../Components/ConnectButton.swift | 0 .../Components/Web3ModalButton.swift | 0 .../Components/Web3ModalNetworkButton.swift | 0 .../Core/BlockchainAPIInteractor.swift | 0 .../Core/SignInteractor.swift | 0 .../Core/W3MAPIInteractor.swift | 0 .../Core/W3MJSONRPC+Coinbase.swift | 0 .../Core/W3MJSONRPC.swift | 0 .../Core/W3MResponse.swift | 0 .../Core/Web3Modal.swift | 0 .../Core/Web3ModalClient.swift | 0 .../Extensions/Collection.swift | 0 .../Extensions/Sequence.swift | 0 .../Extensions/View+RoundedCorners.swift | 0 .../Helpers/EnvironmentInfo.swift | 0 .../Models/Chain.swift | 0 .../Models/Helpers/AccountStorage.swift | 0 .../Models/Helpers/AsyncSemaphore.swift | 0 .../Models/Helpers/Bundle+extension.swift | 0 .../Models/Helpers/RecentWalletStorage.swift | 0 .../Models/Helpers/Session+Stub.swift | 0 .../Models/Wallet.swift | 0 .../Networking/BlockchainAPI.swift | 0 .../Networking/GetWalletsResponse.swift | 0 .../Networking/Web3ModalAPI.swift | 0 .../PackageConfig.json | 0 .../Resources}/Assets.xcassets/Contents.json | 0 .../Assets.xcassets/Mocks}/Contents.json | 0 .../MockChainImage.imageset/Contents.json | 0 .../Mocks/MockChainImage.imageset/Polygon.png | Bin .../MockWalletImage.imageset/Contents.json | 0 .../MockWalletImage.imageset/Rainbow.png | Bin .../imageLogo.imageset/Contents.json | 0 .../Square Image Editor.png | Bin .../{Web3Modal => ReownAppKit}/Router.swift | 0 .../Screens/AccountView.swift | 0 .../Screens/ChainSwitch/ChainSelectView.swift | 0 .../NetworkDetail/NetworkDetailView.swift | 0 .../NetworkDetailViewModel.swift | 0 .../ChainSwitch/WhatIsNetworkView.swift | 0 .../ConnectWallet/AllWalletsView.swift | 0 .../ConnectWallet/ConnectWalletView.swift | 0 .../ConnectWallet/ConnectWithQRCode.swift | 0 .../ConnectWallet/GetAWalletView.swift | 0 .../Screens/ConnectWallet/QRCodeView.swift | 0 .../WalletDetail/WalletDetailView.swift | 0 .../WalletDetail/WalletDetailViewModel.swift | 0 .../ConnectWallet/WhatIsWalletView.swift | 0 .../Sheets/ModalContainerView.swift | 0 .../Sheets/Web3ModalSheetController.swift | 0 .../Sheets/Web3ModalView.swift | 0 .../Sheets/Web3ModalViewModel.swift | 0 .../{Web3Modal => ReownAppKit}/Store.swift | 0 .../Web3ModalImports.swift | 0 .../Wrappers/UIApplicationWrapper.swift | 0 .../AsyncImage.swift | 0 .../Background.swift | 0 .../Backport.swift | 0 .../ContentSizeCategory.swift | 0 .../OnChange.swift | 0 .../Overlay.swift | 0 .../ScaledMetric.swift | 0 .../StateObject.swift | 0 .../Components/W3MActionEntryStyle.swift | 0 .../Components/W3MAvatarGradient.swift | 0 .../Components/W3MButtonStyle.swift | 0 .../Components/W3MCardSelectButtonStyle.swift | 0 .../Components/W3MChipButtonStyle.swift | 0 .../Components/W3MListItemButtonStyle.swift | 0 .../Components/W3MListSelectButtonStyle.swift | 0 .../Components/W3MPicker.swift | 0 .../Components/W3MTag.swift | 0 .../Components/W3MTextField.swift | 0 .../Helpers/Bundle.swift | 0 .../Helpers/Extensions/Color+extension.swift | 0 .../Helpers/Extensions/Font+extension.swift | 0 .../Extensions/ImageResource_generated.swift | 0 .../Helpers/Radius.swift | 0 .../Helpers/Spacing.swift | 0 .../Miscellaneous/AdaptiveStack.swift | 0 .../Miscellaneous/Binding+extension.swift | 0 .../Miscellaneous/DrawingProgressView.swift | 0 .../Miscellaneous/Polygon.swift | 0 .../Miscellaneous/Shape+extension.swift | 0 .../Miscellaneous/Toast.swift | 0 .../Modifiers/Conditional.swift | 0 .../Modifiers/Shimmer.swift | 0 .../Background100.colorset/Contents.json | 0 .../Background125.colorset/Contents.json | 0 .../Background150.colorset/Contents.json | 0 .../Background175.colorset/Contents.json | 0 .../Background200.colorset/Contents.json | 0 .../Background225.colorset/Contents.json | 0 .../Background250.colorset/Contents.json | 0 .../Background275.colorset/Contents.json | 0 .../Background300.colorset/Contents.json | 0 .../BlackAndWhite100.colorset/Contents.json | 0 .../Colors/Blue080.colorset/Contents.json | 0 .../Colors/Blue090.colorset/Contents.json | 0 .../Colors/Blue100.colorset/Contents.json | 0 .../Assets.xcassets/Colors}/Contents.json | 0 .../Colors/Error100.colorset/Contents.json | 0 .../Foreground100.colorset/Contents.json | 0 .../Foreground125.colorset/Contents.json | 0 .../Foreground150.colorset/Contents.json | 0 .../Foreground175.colorset/Contents.json | 0 .../Foreground200.colorset/Contents.json | 0 .../Foreground225.colorset/Contents.json | 0 .../Foreground250.colorset/Contents.json | 0 .../Foreground275.colorset/Contents.json | 0 .../Foreground300.colorset/Contents.json | 0 .../Colors/Glass75.colorset/Contents.json | 0 .../Colors/Glass88.colorset/Contents.json | 0 .../GrayGlass002.colorset/Contents.json | 0 .../GrayGlass005.colorset/Contents.json | 0 .../GrayGlass010.colorset/Contents.json | 0 .../GrayGlass020.colorset/Contents.json | 0 .../Colors/Grey18.colorset/Contents.json | 0 .../Colors/Grey20.colorset/Contents.json | 0 .../Colors/Grey22.colorset/Contents.json | 0 .../Colors/Indigo100.colorset/Contents.json | 0 .../Colors/Inverse000.colorset/Contents.json | 0 .../Colors/Inverse100.colorset/Contents.json | 0 .../Colors/Magenta100.colorset/Contents.json | 0 .../Colors/Orange100.colorset/Contents.json | 0 .../Colors/Overblue002.colorset/Contents.json | 0 .../Colors/Overblue005.colorset/Contents.json | 0 .../Colors/Overblue010.colorset/Contents.json | 0 .../Colors/Overblue015.colorset/Contents.json | 0 .../Colors/Overblue020.colorset/Contents.json | 0 .../Colors/Overblue080.colorset/Contents.json | 0 .../Colors/Overblue090.colorset/Contents.json | 0 .../Colors/Overgray001.colorset/Contents.json | 0 .../Colors/Overgray002.colorset/Contents.json | 0 .../Colors/Overgray005.colorset/Contents.json | 0 .../Colors/Overgray010.colorset/Contents.json | 0 .../Colors/Overgray015.colorset/Contents.json | 0 .../Colors/Overgray020.colorset/Contents.json | 0 .../Colors/Overgray025.colorset/Contents.json | 0 .../Colors/Overgray030.colorset/Contents.json | 0 .../Colors/Purple100.colorset/Contents.json | 0 .../Colors/Success100.colorset/Contents.json | 0 .../Colors/Teal100.colorset/Contents.json | 0 .../Colors/Yellow100.colorset/Contents.json | 0 .../Resources/Assets.xcassets}/Contents.json | 0 .../Arrow Bottom.imageset/Arrow Bottom.pdf | Bin .../Bold/Arrow Bottom.imageset/Contents.json | 0 .../Bold/Arrow Left.imageset/Arrow Left.pdf | Bin .../Bold/Arrow Left.imageset/Contents.json | 0 .../Bold/Arrow Right.imageset/Arrow Right.pdf | Bin .../Bold/Arrow Right.imageset/Contents.json | 0 .../Bold/Arrow Top.imageset/Arrow Top.pdf | Bin .../Bold/Arrow Top.imageset/Contents.json | 0 .../Icons/Bold/Bars.imageset/Bars.pdf | Bin .../Icons/Bold/Bars.imageset/Contents.json | 0 .../Icons/Bold/Bin.imageset/Bin.pdf | Bin .../Icons/Bold/Bin.imageset/Contents.json | 0 .../Icons/Bold/Browser.imageset/Browser.pdf | Bin .../Icons/Bold/Browser.imageset/Contents.json | 0 .../Bold/Checkmark.imageset/Checkmark.pdf | Bin .../Bold/Checkmark.imageset/Contents.json | 0 .../Chevron Bottom.pdf | Bin .../Chevron Bottom.imageset/Contents.json | 0 .../Chevron Left.imageset/Chevron Left.pdf | Bin .../Bold/Chevron Left.imageset/Contents.json | 0 .../Chevron Right.imageset/Chevron Right.pdf | Bin .../Bold/Chevron Right.imageset/Contents.json | 0 .../Bold/Chevron Top.imageset/Chevron Top.pdf | Bin .../Bold/Chevron Top.imageset/Contents.json | 0 .../Icons/Bold/Clock.imageset/Clock.pdf | Bin .../Icons/Bold/Clock.imageset/Contents.json | 0 .../Icons/Bold/Code.imageset/Code.pdf | Bin .../Icons/Bold/Code.imageset/Contents.json | 0 .../Icons/Bold/Compass.imageset/Compass.pdf | Bin .../Icons/Bold/Compass.imageset/Contents.json | 0 .../Assets.xcassets/Icons/Bold/Contents.json | 0 .../Icons/Bold/Copy.imageset/Contents.json | 0 .../Icons/Bold/Copy.imageset/Copy.pdf | Bin .../Icons/Bold/Desktop.imageset/Contents.json | 0 .../Icons/Bold/Desktop.imageset/Desktop.pdf | Bin .../Bold/Disconnect.imageset/Contents.json | 0 .../Bold/Disconnect.imageset/Disconnect.pdf | Bin .../Icons/Bold/Doc.imageset/Contents.json | 0 .../Icons/Bold/Doc.imageset/Doc.pdf | Bin .../Contents.json | 0 .../Double Chevron Vertical.pdf | Bin .../Bold/External Link.imageset/Contents.json | 0 .../External Link.imageset/External Link.pdf | Bin .../Bold/Eye Crossed.imageset/Contents.json | 0 .../Bold/Eye Crossed.imageset/Eye Crossed.pdf | Bin .../Icons/Bold/Eye.imageset/Contents.json | 0 .../Icons/Bold/Eye.imageset/Eye.pdf | Bin .../Icons/Bold/Filters.imageset/Contents.json | 0 .../Icons/Bold/Filters.imageset/Filters.pdf | Bin .../Icons/Bold/Image.imageset/Contents.json | 0 .../Icons/Bold/Image.imageset/Image.pdf | Bin .../Icons/Bold/Info.imageset/Contents.json | 0 .../Icons/Bold/Info.imageset/Info.pdf | Bin .../Bold/Light Bulb.imageset/Contents.json | 0 .../Bold/Light Bulb.imageset/Light Bulb.pdf | Bin .../Icons/Bold/Link.imageset/Contents.json | 0 .../Icons/Bold/Link.imageset/Link.pdf | Bin .../Icons/Bold/Mail.imageset/Contents.json | 0 .../Icons/Bold/Mail.imageset/Mail.pdf | Bin .../Icons/Bold/Mobile.imageset/Contents.json | 0 .../Icons/Bold/Mobile.imageset/Mobile.pdf | Bin .../Icons/Bold/Moon.imageset/Contents.json | 0 .../Icons/Bold/Moon.imageset/Moon.pdf | Bin .../Icons/Bold/Network.imageset/Contents.json | 0 .../Icons/Bold/Network.imageset/Network.pdf | Bin .../Icons/Bold/Nut.imageset/Contents.json | 0 .../Icons/Bold/Nut.imageset/Nut.pdf | Bin .../Icons/Bold/Off.imageset/Contents.json | 0 .../Icons/Bold/Off.imageset/Off.pdf | Bin .../Icons/Bold/Pen.imageset/Contents.json | 0 .../Icons/Bold/Pen.imageset/Pen.pdf | Bin .../Icons/Bold/Plus.imageset/Contents.json | 0 .../Icons/Bold/Plus.imageset/Plus.pdf | Bin .../Contents.json | 0 .../Question Mark Circle.pdf | Bin .../Icons/Bold/Refresh.imageset/Contents.json | 0 .../Icons/Bold/Refresh.imageset/Refresh.pdf | Bin .../Sliders Horizontal.imageset/Contents.json | 0 .../Sliders Horizontal.pdf | Bin .../Sliders Vertical.imageset/Contents.json | 0 .../Sliders Vertical.pdf | Bin .../Icons/Bold/Squares.imageset/Contents.json | 0 .../Icons/Bold/Squares.imageset/Squares.pdf | Bin .../Icons/Bold/Sun.imageset/Contents.json | 0 .../Icons/Bold/Sun.imageset/Sun.pdf | Bin .../Swap Horizontal.imageset/Contents.json | 0 .../Swap Horizontal.pdf | Bin .../Bold/Swap Vertical.imageset/Contents.json | 0 .../Swap Vertical.imageset/Swap Vertical.pdf | Bin .../Icons/Bold/Users.imageset/Contents.json | 0 .../Icons/Bold/Users.imageset/Users.pdf | Bin .../Icons/Bold/Wallet.imageset/Contents.json | 0 .../Icons/Bold/Wallet.imageset/Wallet.pdf | Bin .../Warning Circle.imageset/Contents.json | 0 .../Warning Circle.pdf | Bin .../Icons/Bold/Web.imageset/Contents.json | 0 .../Icons/Bold/Web.imageset/Web.pdf | Bin .../Icons/Bold/X Mark.imageset/Contents.json | 0 .../Icons/Bold/X Mark.imageset/X Mark.pdf | Bin .../Assets.xcassets/Icons}/Contents.json | 0 .../Icons/Error.imageset/Contents.json | 0 .../Icons/Error.imageset/error.pdf | Bin .../Icons/Error.imageset/error_light.pdf | Bin .../Icons/Medium/Android.imageset/Android.pdf | Bin .../Medium/Android.imageset/Contents.json | 0 .../Icons/Medium/App.imageset/App.pdf | Bin .../Icons/Medium/App.imageset/Contents.json | 0 .../Medium/Arrow Left.imageset/Arrow Left.pdf | Bin .../Medium/Arrow Left.imageset/Contents.json | 0 .../Arrow Right.imageset/Arrow Right.pdf | Bin .../Medium/Arrow Right.imageset/Contents.json | 0 .../Icons/Medium/Auth.imageset/Auth.pdf | Bin .../Icons/Medium/Auth.imageset/Contents.json | 0 .../Icons/Medium/Bell.imageset/Bell.pdf | Bin .../Icons/Medium/Bell.imageset/Contents.json | 0 .../Icons/Medium/Bin.imageset/Bin.pdf | Bin .../Icons/Medium/Bin.imageset/Contents.json | 0 .../Medium/Checkmark.imageset/Checkmark.pdf | Bin .../Medium/Checkmark.imageset/Contents.json | 0 .../Chevron Bottom.pdf | Bin .../Chevron Bottom.imageset/Contents.json | 0 .../Chevron Left.imageset/Chevron Left.pdf | Bin .../Chevron Left.imageset/Contents.json | 0 .../Chevron Right.imageset/Chevron Right.pdf | Bin .../Chevron Right.imageset/Contents.json | 0 .../Chevron Top.imageset/Chevron Top.pdf | Bin .../Medium/Chevron Top.imageset/Contents.json | 0 .../Icons/Medium/Compass.imageset/Compass.pdf | Bin .../Medium/Compass.imageset/Contents.json | 0 .../Icons/Medium/Contents.json | 0 .../Icons/Medium/Copy.imageset/Contents.json | 0 .../Icons/Medium/Copy.imageset/Copy.pdf | Bin .../Medium/Desktop.imageset/Contents.json | 0 .../Icons/Medium/Desktop.imageset/Desktop.pdf | Bin .../Medium/Disconnect.imageset/Contents.json | 0 .../Medium/Disconnect.imageset/Disconnect.pdf | Bin .../Icons/Medium/Doc.imageset/Contents.json | 0 .../Icons/Medium/Doc.imageset/Doc.pdf | Bin .../Dots Horizontal.imageset/Contents.json | 0 .../Dots Horizontal.pdf | Bin .../Dots Vertical.imageset/Contents.json | 0 .../Dots Vertical.imageset/Dots Vertical.pdf | Bin .../Contents.json | 0 .../Double Chevron Vertical.pdf | Bin .../Medium/Etherscan.imageset/Contents.json | 0 .../Medium/Etherscan.imageset/Etherscan.pdf | Bin .../External Link.imageset/Contents.json | 0 .../External Link.imageset/External Link.pdf | Bin .../Medium/Eye Crossed.imageset/Contents.json | 0 .../Eye Crossed.imageset/Eye Crossed.pdf | Bin .../Icons/Medium/Eye.imageset/Contents.json | 0 .../Icons/Medium/Eye.imageset/Eye.pdf | Bin .../Icons/Medium/File.imageset/Contents.json | 0 .../Icons/Medium/File.imageset/File.pdf | Bin .../Medium/Filters.imageset/Contents.json | 0 .../Icons/Medium/Filters.imageset/Filters.pdf | Bin .../Medium/Info Circle.imageset/Contents.json | 0 .../Info Circle.imageset/Info Circle.pdf | Bin .../Icons/Medium/Info.imageset/Contents.json | 0 .../Icons/Medium/Info.imageset/Info.pdf | Bin .../Medium/Light Bulb.imageset/Contents.json | 0 .../Medium/Light Bulb.imageset/Light Bulb.pdf | Bin .../Medium/Magnifier.imageset/Contents.json | 0 .../Medium/Magnifier.imageset/Magnifier.pdf | Bin .../Icons/Medium/Mail.imageset/Contents.json | 0 .../Icons/Medium/Mail.imageset/Mail.pdf | Bin .../Medium/Mobile.imageset/Contents.json | 0 .../Icons/Medium/Mobile.imageset/Mobile.pdf | Bin .../Icons/Medium/Moon.imageset/Contents.json | 0 .../Icons/Medium/Moon.imageset/Moon.pdf | Bin .../Icons/Medium/Nut.imageset/Contents.json | 0 .../Icons/Medium/Nut.imageset/Nut.pdf | Bin .../Icons/Medium/Off.imageset/Contents.json | 0 .../Icons/Medium/Off.imageset/Off.pdf | Bin .../Icons/Medium/Paste.imageset/Contents.json | 0 .../Icons/Medium/Paste.imageset/Paste.pdf | Bin .../Icons/Medium/Pen.imageset/Contents.json | 0 .../Icons/Medium/Pen.imageset/Pen.pdf | Bin .../Icons/Medium/Plus.imageset/Contents.json | 0 .../Icons/Medium/Plus.imageset/Plus.pdf | Bin .../Medium/QR code.imageset/Contents.json | 0 .../Icons/Medium/QR code.imageset/QR code.pdf | Bin .../Contents.json | 0 .../Question Mark Circle-1.pdf | Bin .../Medium/Refresh.imageset/Contents.json | 0 .../Icons/Medium/Refresh.imageset/Refresh.pdf | Bin .../Medium/Sliders.imageset/Contents.json | 0 .../Icons/Medium/Sliders.imageset/Sliders.pdf | Bin .../Medium/Squares.imageset/Contents.json | 0 .../Icons/Medium/Squares.imageset/Squares.pdf | Bin .../Icons/Medium/Sun.imageset/Contents.json | 0 .../Icons/Medium/Sun.imageset/MediumSun.pdf | Bin .../Swap Horizontal.imageset/Contents.json | 0 .../Swap Horizontal.pdf | Bin .../Swap Vertical.imageset/Contents.json | 0 .../Swap Vertical.imageset/Swap Vertical.pdf | Bin .../Medium/Twitter.imageset/Contents.json | 0 .../Icons/Medium/Twitter.imageset/Twitter.pdf | Bin .../Medium/Wallet.imageset/Contents.json | 0 .../Icons/Medium/Wallet.imageset/Wallet.pdf | Bin .../Warning Circle.imageset/Contents.json | 0 .../Warning Circle.pdf | Bin .../Icons/Medium/Web.imageset/Contents.json | 0 .../Icons/Medium/Web.imageset/Web.pdf | Bin .../Medium/X mark.imageset/Contents.json | 0 .../Icons/Medium/X mark.imageset/X mark.pdf | Bin .../Icons/Medium/iOS.imageset/Contents.json | 0 .../Icons/Medium/iOS.imageset/iOS.pdf | Bin .../Icons/Original/Add.imageset/Contents.json | 0 .../Icons/Original/Add.imageset/iconAdd.pdf | Bin .../Original/Apple.imageset/Contents.json | 0 .../Apple.imageset/socialIconApple.pdf | Bin .../Original/ArrowDown.imageset/Contents.json | 0 .../ArrowDown.imageset/iconArrowDown.pdf | Bin .../ArrowExchange.imageset/Contents.json | 0 .../iconArrowExchange.pdf | Bin .../Original/ArrowLeft.imageset/Contents.json | 0 .../ArrowLeft.imageset/iconArrowLeft.pdf | Bin .../ArrowRight.imageset/Contents.json | 0 .../ArrowRight.imageset/iconArrowRight.pdf | Bin .../Original/ArrowUp.imageset/Contents.json | 0 .../Original/ArrowUp.imageset/iconArrowUp.pdf | Bin .../BackwardChevron.imageset/Contents.json | 0 .../iconBackwardChevron.pdf | Bin .../Original/Checkmark.imageset/Contents.json | 0 .../Checkmark.imageset/iconCheckmark.pdf | Bin .../Original/Compass.imageset/Compass.pdf | Bin .../Original/Compass.imageset/Contents.json | 0 .../Icons/Original/Contents.json | 0 .../Original/Desktop.imageset/Contents.json | 0 .../Original/Desktop.imageset/iconDesktop.pdf | Bin .../Disconnect.imageset/Contents.json | 0 .../Disconnect.imageset/iconDisconnect.pdf | Bin .../Original/Discord.imageset/Contents.json | 0 .../Discord.imageset/socialIconDiscord.pdf | Bin .../DownwardChevron.imageset/Contents.json | 0 .../iconDownwardChevron.pdf | Bin .../Original/Error.imageset/Contents.json | 0 .../Icons/Original/Error.imageset/error.pdf | Bin .../Original/Error.imageset/error_light.pdf | Bin .../Original/Extension.imageset/Contents.json | 0 .../Extension.imageset/iconExtension.pdf | Bin .../ExternalLink.imageset/Contents.json | 0 .../iconExternalLink.pdf | Bin .../Original/Facebook.imageset/Contents.json | 0 .../Facebook.imageset/socialIconFacebook.pdf | Bin .../ForwardChevron.imageset/Contents.json | 0 .../iconForwardChevron.pdf | Bin .../Original/Github.imageset/Contents.json | 0 .../Github.imageset/socialIconGithub.pdf | Bin .../Original/Google.imageset/Contents.json | 0 .../Google.imageset/socialIconGoogle.pdf | Bin .../Original/Help.imageset/Contents.json | 0 .../Icons/Original/Help.imageset/iconHelp.pdf | Bin .../Original/HelpSmall.imageset/Contents.json | 0 .../HelpSmall.imageset/iconHelpSmall.pdf | Bin .../Original/History.imageset/Contents.json | 0 .../Original/History.imageset/iconHistory.pdf | Bin .../LargeBackward.imageset/Contents.json | 0 .../iconLargeBackward.pdf | Bin .../LargeClose.imageset/Contents.json | 0 .../LargeClose.imageset/iconLargeClose.pdf | Bin .../Original/LargeCopy.imageset/Contents.json | 0 .../LargeCopy.imageset/iconLargeCopy.pdf | Bin .../LargeDesktop.imageset/Contents.json | 0 .../iconLargeDesktop.pdf | Bin .../LargeEmail.imageset/Contents.json | 0 .../LargeEmail.imageset/iconLargeEmail.pdf | Bin .../LargeEmoji.imageset/Contents.json | 0 .../LargeEmoji.imageset/iconLargeEmoji.pdf | Bin .../Original/LargeMoon.imageset/Contents.json | 0 .../LargeMoon.imageset/iconLargeMoon.pdf | Bin .../LargePhone.imageset/Contents.json | 0 .../LargePhone.imageset/iconLargePhone.pdf | Bin .../LargeQrcode.imageset/Contents.json | 0 .../LargeQrcode.imageset/iconLargeQrcode.pdf | Bin .../Original/LargeSun.imageset/Contents.json | 0 .../LargeSun.imageset/iconLargeSun.pdf | Bin .../LargeTwitter.imageset/Contents.json | 0 .../LargeTwitter.imageset/iconTwitter.pdf | Bin .../Original/Mail.imageset/Contents.json | 0 .../Icons/Original/Mail.imageset/iconMail.pdf | Bin .../Icons/Original/Off.imageset/Contents.json | 0 .../Icons/Original/Off.imageset/iconOff.pdf | Bin .../Icons/Original/Pen.imageset/Contents.json | 0 .../Icons/Original/Pen.imageset/iconPen.pdf | Bin .../Original/Phone.imageset/Contents.json | 0 .../Original/Phone.imageset/iconPhone.pdf | Bin .../Original/Popular.imageset/Contents.json | 0 .../Original/Popular.imageset/iconPopular.pdf | Bin .../Original/Qrcode.imageset/Contents.json | 0 .../Original/Qrcode.imageset/iconQrcode.pdf | Bin .../QuestionMarkCircle.imageset/Contents.json | 0 .../Question Mark Circle.pdf | Bin .../Original/Recent.imageset/Contents.json | 0 .../Original/Recent.imageset/iconRecent.pdf | Bin .../Original/Retry.imageset/Contents.json | 0 .../Original/Retry.imageset/iconRetry.pdf | Bin .../Original/Scan.imageset/Contents.json | 0 .../Icons/Original/Scan.imageset/iconScan.pdf | Bin .../Original/Search.imageset/Contents.json | 0 .../Original/Search.imageset/iconSearch.pdf | Bin .../Original/Telegram.imageset/Contents.json | 0 .../Telegram.imageset/socialIconTelegram.pdf | Bin .../ToastError.imageset/Contents.json | 0 .../ToastError.imageset/Icon Box-2.pdf | Bin .../ToastError.imageset/Icon Boxlight-2.pdf | Bin .../Original/ToastInfo.imageset/Contents.json | 0 .../ToastInfo.imageset/Icon Box-1.pdf | Bin .../ToastInfo.imageset/Icon Boxlight-1.pdf | Bin .../ToastSuccess.imageset/Contents.json | 0 .../ToastSuccess.imageset/Icon Box.pdf | Bin .../ToastSuccess.imageset/Icon Boxlight.pdf | Bin .../Original/Twitch.imageset/Contents.json | 0 .../Twitch.imageset/socialIconTwitch.pdf | Bin .../Original/Twitter.imageset/Contents.json | 0 .../Twitter.imageset/socialIconTwitter.pdf | Bin .../UpwardChevron.imageset/Contents.json | 0 .../iconUpwardChevron.pdf | Bin .../Original/Wallet.imageset/Contents.json | 0 .../Icons/Original/Wallet.imageset/Wallet.pdf | Bin .../Original/Website.imageset/Contents.json | 0 .../Original/Website.imageset/iconWebsite.pdf | Bin .../Icons/Regular/4 dots.imageset/4 dots.pdf | Bin .../Regular/4 dots.imageset/Contents.json | 0 .../Icons/Regular/App.imageset/App.pdf | Bin .../Icons/Regular/App.imageset/Contents.json | 0 .../Arrow Bottom.imageset/Arrow Bottom.pdf | Bin .../Arrow Bottom.imageset/Contents.json | 0 .../Icons/Regular/Bars.imageset/Bars.pdf | Bin .../Icons/Regular/Bars.imageset/Contents.json | 0 .../Icons/Regular/Bell.imageset/Bell.pdf | Bin .../Icons/Regular/Bell.imageset/Contents.json | 0 .../Regular/Browser.imageset/Browser.pdf | Bin .../Regular/Browser.imageset/Contents.json | 0 .../Icons/Regular/Chart.imageset/Chart.pdf | Bin .../Regular/Chart.imageset/Contents.json | 0 .../Chat Bubble.imageset/Chat Bubble.pdf | Bin .../Chat Bubble.imageset/Contents.json | 0 .../Check Circle.imageset/Check Circle.pdf | Bin .../Check Circle.imageset/Contents.json | 0 .../Regular/Checkmark.imageset/Checkmark.pdf | Bin .../Regular/Checkmark.imageset/Contents.json | 0 .../Chevron Left.imageset/Chevron Left.pdf | Bin .../Chevron Left.imageset/Contents.json | 0 .../Icons/Regular/Code.imageset/Code.pdf | Bin .../Icons/Regular/Code.imageset/Contents.json | 0 .../Icons/Regular/Coin.imageset/Coin.pdf | Bin .../Icons/Regular/Coin.imageset/Contents.json | 0 .../Regular/Compass.imageset/Compass.pdf | Bin .../Regular/Compass.imageset/Contents.json | 0 .../Icons/Regular/Contents.json | 0 .../Icons/Regular/Copy.imageset/Contents.json | 0 .../Icons/Regular/Copy.imageset/Copy.pdf | Bin .../Regular/Desktop.imageset/Contents.json | 0 .../Regular/Desktop.imageset/Desktop.pdf | Bin .../Contents.json | 0 .../Double Chevron Right.pdf | Bin .../Regular/Extension.imageset/Browser-1.pdf | Bin .../Regular/Extension.imageset/Contents.json | 0 .../External Link.imageset/Contents.json | 0 .../External Link.imageset/External Link.pdf | Bin .../Eye Crossed.imageset/Contents.json | 0 .../Eye Crossed.imageset/Eye Crossed.pdf | Bin .../Icons/Regular/Eye.imageset/Contents.json | 0 .../Icons/Regular/Eye.imageset/Eye.pdf | Bin .../Regular/Filters.imageset/Contents.json | 0 .../Regular/Filters.imageset/Filters.pdf | Bin .../Fingerprint.imageset/Contents.json | 0 .../Fingerprint.imageset/Fingerprint.pdf | Bin .../Regular/Image.imageset/Contents.json | 0 .../Icons/Regular/Image.imageset/Image.pdf | Bin .../Icons/Regular/Info.imageset/Contents.json | 0 .../Icons/Regular/Info.imageset/Info.pdf | Bin .../Icons/Regular/Link.imageset/Contents.json | 0 .../Icons/Regular/Link.imageset/Link.pdf | Bin .../Icons/Regular/Load.imageset/Contents.json | 0 .../Icons/Regular/Load.imageset/Load.pdf | Bin .../Regular/Locker.imageset/Contents.json | 0 .../Icons/Regular/Locker.imageset/Locker.pdf | Bin .../Regular/Magnifier.imageset/Contents.json | 0 .../Magnifier.imageset/Magnifier-1.pdf | Bin .../Icons/Regular/Mail.imageset/Contents.json | 0 .../Icons/Regular/Mail.imageset/Mail.pdf | Bin .../Regular/Mobile.imageset/Contents.json | 0 .../Icons/Regular/Mobile.imageset/Mobile.pdf | Bin .../Icons/Regular/Moon.imageset/Contents.json | 0 .../Icons/Regular/Moon.imageset/Moon.pdf | Bin .../Regular/Network.imageset/Contents.json | 0 .../Regular/Network.imageset/Network.pdf | Bin .../Regular/QR code.imageset/Contents.json | 0 .../Regular/QR code.imageset/QR code.pdf | Bin .../Contents.json | 0 .../Question Mark Circle.pdf | Bin .../Regular/Question.imageset/Contents.json | 0 .../Regular/Question.imageset/Question.pdf | Bin .../Regular/Sliders.imageset/Contents.json | 0 .../Regular/Sliders.imageset/Sliders.pdf | Bin .../Regular/Squares.imageset/Contents.json | 0 .../Regular/Squares.imageset/Squares.pdf | Bin .../Icons/Regular/Sun.imageset/Contents.json | 0 .../Icons/Regular/Sun.imageset/Sun.pdf | Bin .../Swap Horizontal.imageset/Contents.json | 0 .../Swap Horizontal.pdf | Bin .../Regular/Verif.imageset/Contents.json | 0 .../Icons/Regular/Verif.imageset/Verif.pdf | Bin .../Regular/Wallet.imageset/Contents.json | 0 .../Regular/Wallet.imageset/Wallet-1.pdf | Bin .../Warning Circle.imageset/Contents.json | 0 .../Warning Circle.pdf | Bin .../Regular/X mark.imageset/Contents.json | 0 .../Icons/Regular/X mark.imageset/X mark.pdf | Bin .../Icons/ToastError.imageset/Contents.json | 0 .../Icons/ToastError.imageset/Icon Box-2.pdf | Bin .../ToastError.imageset/Icon Boxlight-2.pdf | Bin .../Icons/ToastInfo.imageset/Contents.json | 0 .../Icons/ToastInfo.imageset/Icon Box-1.pdf | Bin .../ToastInfo.imageset/Icon Boxlight-1.pdf | Bin .../Icons/ToastSuccess.imageset/Contents.json | 0 .../Icons/ToastSuccess.imageset/Icon Box.pdf | Bin .../ToastSuccess.imageset/Icon Boxlight.pdf | Bin .../Assets.xcassets/Images}/Contents.json | 0 .../imageBrowser.imageset/Contents.json | 0 .../imageBrowserL@1x.png | Bin .../imageBrowserL@2x.png | Bin .../imageBrowserL@3x.png | Bin .../Images/imageDao.imageset/Contents.json | 0 .../Images/imageDao.imageset/imageDaoL@1x.png | Bin .../Images/imageDao.imageset/imageDaoL@2x.png | Bin .../Images/imageDao.imageset/imageDaoL@3x.png | Bin .../Images/imageDeFi.imageset/Contents.json | 0 .../imageDeFi.imageset/imageDeFiL@1x.png | Bin .../imageDeFi.imageset/imageDeFiL@2x.png | Bin .../imageDeFi.imageset/imageDeFiL@3x.png | Bin .../imageDefiAlt.imageset/Contents.json | 0 .../imageDefiAltL@1x.png | Bin .../imageDefiAltL@2x.png | Bin .../imageDefiAltL@3x.png | Bin .../Images/imageEth.imageset/Contents.json | 0 .../Images/imageEth.imageset/imageEthL@1x.png | Bin .../Images/imageEth.imageset/imageEthL@2x.png | Bin .../Images/imageEth.imageset/imageEthL@3x.png | Bin .../Images/imageLayers.imageset/Contents.json | 0 .../imageLayers.imageset/imageLayersL@1x.png | Bin .../imageLayers.imageset/imageLayersL@2x.png | Bin .../imageLayers.imageset/imageLayersL@3x.png | Bin .../Images/imageLock.imageset/Contents.json | 0 .../imageLock.imageset/imageLockL@1x.png | Bin .../imageLock.imageset/imageLockL@2x.png | Bin .../imageLock.imageset/imageLockL@3x.png | Bin .../Images/imageLogin.imageset/Contents.json | 0 .../imageLogin.imageset/imageLoginL@1x.png | Bin .../imageLogin.imageset/imageLoginL@2x.png | Bin .../imageLogin.imageset/imageLoginL@3x.png | Bin .../imageNetwork.imageset/Contents.json | 0 .../imageNetworkL@1x.png | Bin .../imageNetworkL@2x.png | Bin .../imageNetworkL@3x.png | Bin .../Images/imageNft.imageset/Contents.json | 0 .../Images/imageNft.imageset/imageNftL@1x.png | Bin .../Images/imageNft.imageset/imageNftL@2x.png | Bin .../Images/imageNft.imageset/imageNftL@3x.png | Bin .../Images/imageNoun.imageset/Contents.json | 0 .../imageNoun.imageset/imageNounL@1x.png | Bin .../imageNoun.imageset/imageNounL@2x.png | Bin .../imageNoun.imageset/imageNounL@3x.png | Bin .../imageProfile.imageset/Contents.json | 0 .../imageProfileL@1x.png | Bin .../imageProfileL@2x.png | Bin .../imageProfileL@3x.png | Bin .../Images/imageSystem.imageset/Contents.json | 0 .../imageSystem.imageset/imageSystemL@1x.png | Bin .../imageSystem.imageset/imageSystemL@2x.png | Bin .../imageSystem.imageset/imageSystemL@3x.png | Bin .../Assets.xcassets/Mocks}/Contents.json | 0 .../MockChainImage.imageset/Contents.json | 0 .../Mocks/MockChainImage.imageset/Polygon.png | Bin .../MockWalletImage.imageset/Contents.json | 0 .../MockWalletImage.imageset/Rainbow.png | Bin .../Assets.xcassets/OptionIcon}/Contents.json | 0 .../optionAll.imageset/Contents.json | 0 .../OptionIcon/optionAll.imageset/all@2x.png | Bin .../OptionIcon/optionAll.imageset/all@3x.png | Bin .../optionAll.imageset/all_dark@2x.png | Bin .../optionAll.imageset/all_dark@3x.png | Bin .../optionBrowser.imageset/Contents.json | 0 .../optionBrowserThemeDarkL@2x.png | Bin .../optionBrowserThemeDarkL@3x.png | Bin .../optionBrowserThemeLightL@2x.png | Bin .../optionBrowserThemeLightL@3x.png | Bin .../optionExtension.imageset/Contents.json | 0 .../optionExtensionThemeDarkL@2x.png | Bin .../optionExtensionThemeDarkL@3x.png | Bin .../optionExtensionThemeLightL@2x.png | Bin .../optionExtensionThemeLightL@3x.png | Bin .../optionQrCode.imageset/Contents.json | 0 .../optionQrCodeThemeDarkL@2x.png | Bin .../optionQrCodeThemeDarkL@3x.png | Bin .../optionQrCodeThemeLightL@2x.png | Bin .../optionQrCodeThemeLightL@3x.png | Bin .../Web3ModalImports copy.swift | 0 .../Assets.xcassets/OptionIcon/Contents.json | 6 - .../AccountButtonSnapshotTests.swift | 0 .../NetworkButtonSnapshotTests.swift | 0 .../QRCodeViewSnapshotTests.swift | 0 .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../W3MActionEntrySnapshotTests.swift | 0 .../W3MButtonSnapshotTests.swift | 0 .../W3MCardSelectSnapshotTests.swift | 0 .../W3MChipButtonSnapshotTests.swift | 0 .../W3MListItemSnapshotTests.swift | 0 .../W3MListSelectSnapshotTests.swift | 0 .../W3MTagSnapshotTests.swift | 0 .../W3MToastSnapshotTests .swift | 0 .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.3.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin .../test_snapshots.3.png | Bin .../W3MTagSnapshotTests/test_snapshots.1.png | Bin .../W3MTagSnapshotTests/test_snapshots.2.png | Bin .../test_snapshots.1.png | Bin .../test_snapshots.2.png | Bin 803 files changed, 24 insertions(+), 3569 deletions(-) delete mode 100644 Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Showcase.xcscheme delete mode 100644 Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme delete mode 100644 Example/Showcase/Classes/ApplicationLayer/AppDelegate.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/Application.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/Configurator/AppearanceConfigurator.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/Configurator/ApplicationConfigurator.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/Configurator/Configurator.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/Configurator/MigrationConfigurator.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/Configurator/ThirdPartyConfigurator.swift delete mode 100644 Example/Showcase/Classes/ApplicationLayer/SceneDelegate.swift delete mode 100644 Example/Showcase/Classes/DomainLayer/Chat/ChatService.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatInteractor.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatPresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/Models/MessageViewModel.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ChatScrollView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ContentMessageView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/MessageView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListInteractor.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListPresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/AlertError.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/ThreadViewModel.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportInteractor.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportPresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteInteractor.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Invite/InvitePresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListInteractor.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListPresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteType.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteViewModel.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Main/MainModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Main/MainPresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Main/MainRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Main/MainViewController.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Main/Model/TabPage.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeInteractor.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomePresenter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeView.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxModule.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxRouter.swift delete mode 100644 Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxViewController.swift delete mode 100644 Example/Showcase/Common/Components/BrandButton.swift delete mode 100644 Example/Showcase/Common/Components/InputView.swift delete mode 100644 Example/Showcase/Common/Components/PlainButton.swift delete mode 100644 Example/Showcase/Common/Components/TextFieldView.swift delete mode 100644 Example/Showcase/Common/Extensions/SwiftUI/View.swift delete mode 100644 Example/Showcase/Common/Extensions/UIKit/String.swift delete mode 100644 Example/Showcase/Common/Extensions/UIKit/UIColor.swift delete mode 100644 Example/Showcase/Common/Extensions/UIKit/UIViewController.swift delete mode 100644 Example/Showcase/Common/InputConfig.swift delete mode 100644 Example/Showcase/Common/Style/Color.swift delete mode 100644 Example/Showcase/Common/Types/Types.swift delete mode 100644 Example/Showcase/Common/VIPER/SceneViewController.swift delete mode 100644 Example/Showcase/Other/Assets.xcassets/AccentColor.colorset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x-1.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x-1.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x-1.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/AppIcon.appiconset/ItunesArtwork@2x.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/LaunchLogo.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/LaunchLogo.imageset/LaunchLogo.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/LaunchScreen.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/LaunchScreen.imageset/Group 1.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/avatar.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/avatar.imageset/avatar.svg delete mode 100644 Example/Showcase/Other/Assets.xcassets/checkmark_icon.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/checkmark_icon.imageset/Icon.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/cross_icon.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/cross_icon.imageset/Icon-1.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/plus_icon.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/plus_icon.imageset/Icon.png delete mode 100644 Example/Showcase/Other/Assets.xcassets/profile_icon.imageset/Contents.json delete mode 100644 Example/Showcase/Other/Assets.xcassets/profile_icon.imageset/profile_icon.png delete mode 100644 Example/Showcase/Other/Base.lproj/LaunchScreen.storyboard delete mode 100644 Example/Showcase/Other/Info.plist rename Sources/{Web3Modal => ReownAppKit}/Analytics/AnalyticsEvent.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/AnalyticsEventMapper.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/AnalyticsProvider.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Convenience/AnalyticsEvent+ResultBuilders.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Convenience/AnalyticsEventGroup.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Convenience/AnalyticsEventTrackingModifier.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Convenience/AnalyticsEventTrigger.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Convenience/View+Track.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Private/AnalyticsService.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Private/ClickstreamAnalyticsProvider.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Private/DefaultAnalyticsEventMapper.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Analytics/Private/LoggingAnalyticsProvider.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Components/AccountButton.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Components/ConnectButton.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Components/Web3ModalButton.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Components/Web3ModalNetworkButton.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/BlockchainAPIInteractor.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/SignInteractor.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/W3MAPIInteractor.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/W3MJSONRPC+Coinbase.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/W3MJSONRPC.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/W3MResponse.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/Web3Modal.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Core/Web3ModalClient.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Extensions/Collection.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Extensions/Sequence.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Extensions/View+RoundedCorners.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Helpers/EnvironmentInfo.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Chain.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Helpers/AccountStorage.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Helpers/AsyncSemaphore.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Helpers/Bundle+extension.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Helpers/RecentWalletStorage.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Helpers/Session+Stub.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Models/Wallet.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Networking/BlockchainAPI.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Networking/GetWalletsResponse.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Networking/Web3ModalAPI.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/PackageConfig.json (100%) rename {Example/Showcase/Other => Sources/ReownAppKit/Resources}/Assets.xcassets/Contents.json (100%) rename Sources/{Web3Modal/Resources/Assets.xcassets => ReownAppKit/Resources/Assets.xcassets/Mocks}/Contents.json (100%) rename Sources/{Web3Modal => ReownAppKit}/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json (100%) rename Sources/{Web3Modal => ReownAppKit}/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png (100%) rename Sources/{Web3Modal => ReownAppKit}/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Contents.json (100%) rename Sources/{Web3Modal => ReownAppKit}/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Rainbow.png (100%) rename Sources/{Web3Modal => ReownAppKit}/Resources/Assets.xcassets/imageLogo.imageset/Contents.json (100%) rename Sources/{Web3Modal => ReownAppKit}/Resources/Assets.xcassets/imageLogo.imageset/Square Image Editor.png (100%) rename Sources/{Web3Modal => ReownAppKit}/Router.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/AccountView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ChainSwitch/ChainSelectView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ChainSwitch/NetworkDetail/NetworkDetailView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ChainSwitch/NetworkDetail/NetworkDetailViewModel.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ChainSwitch/WhatIsNetworkView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/AllWalletsView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/ConnectWalletView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/ConnectWithQRCode.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/GetAWalletView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/QRCodeView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/WalletDetail/WalletDetailView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/WalletDetail/WalletDetailViewModel.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Screens/ConnectWallet/WhatIsWalletView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Sheets/ModalContainerView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Sheets/Web3ModalSheetController.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Sheets/Web3ModalView.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Sheets/Web3ModalViewModel.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Store.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Web3ModalImports.swift (100%) rename Sources/{Web3Modal => ReownAppKit}/Wrappers/UIApplicationWrapper.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/AsyncImage.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/Background.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/Backport.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/ContentSizeCategory.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/OnChange.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/Overlay.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/ScaledMetric.swift (100%) rename Sources/{Web3ModalBackport => ReownAppKitBackport}/StateObject.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MActionEntryStyle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MAvatarGradient.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MButtonStyle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MCardSelectButtonStyle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MChipButtonStyle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MListItemButtonStyle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MListSelectButtonStyle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MPicker.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MTag.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Components/W3MTextField.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Helpers/Bundle.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Helpers/Extensions/Color+extension.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Helpers/Extensions/Font+extension.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Helpers/Extensions/ImageResource_generated.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Helpers/Radius.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Helpers/Spacing.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Miscellaneous/AdaptiveStack.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Miscellaneous/Binding+extension.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Miscellaneous/DrawingProgressView.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Miscellaneous/Polygon.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Miscellaneous/Shape+extension.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Miscellaneous/Toast.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Modifiers/Conditional.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Modifiers/Shimmer.swift (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background125.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background150.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background175.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background200.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background225.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background250.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background275.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Background300.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/BlackAndWhite100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Blue080.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Blue090.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Blue100.colorset/Contents.json (100%) rename Sources/{Web3Modal/Resources/Assets.xcassets/Mocks => ReownAppKitUI/Resources/Assets.xcassets/Colors}/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Error100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground125.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground150.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground175.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground200.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground225.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground250.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground275.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Foreground300.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Glass75.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Glass88.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/GrayGlass002.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/GrayGlass005.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/GrayGlass010.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/GrayGlass020.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Grey18.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Grey20.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Grey22.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Indigo100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Inverse000.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Inverse100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Magenta100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Orange100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue002.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue005.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue010.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue015.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue020.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue080.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overblue090.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray001.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray002.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray005.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray010.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray015.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray020.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray025.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Overgray030.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Purple100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Success100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Teal100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Colors/Yellow100.colorset/Contents.json (100%) rename Sources/{Web3ModalUI/Resources/Assets.xcassets/Colors => ReownAppKitUI/Resources/Assets.xcassets}/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Bottom.imageset/Arrow Bottom.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Bottom.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Arrow Left.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Left.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Right.imageset/Arrow Right.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Right.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Arrow Top.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Arrow Top.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Bars.imageset/Bars.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Bars.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Bin.imageset/Bin.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Bin.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Browser.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Browser.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Checkmark.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Checkmark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Chevron Bottom.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Bottom.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Chevron Left.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Left.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Right.imageset/Chevron Right.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Right.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Chevron Top.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Chevron Top.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Clock.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Clock.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Code.imageset/Code.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Code.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Compass.imageset/Compass.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Compass.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Copy.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Copy.imageset/Copy.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Desktop.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Desktop.imageset/Desktop.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Disconnect.imageset/Disconnect.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Doc.imageset/Doc.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/External Link.imageset/External Link.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Eye Crossed.imageset/Eye Crossed.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Eye.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Eye.imageset/Eye.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Filters.imageset/Filters.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Image.imageset/Image.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Info.imageset/Info.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Light Bulb.imageset/Light Bulb.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Link.imageset/Link.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Mail.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Mail.imageset/Mail.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Mobile.imageset/Mobile.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Moon.imageset/Moon.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Network.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Network.imageset/Network.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Nut.imageset/Nut.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Off.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Off.imageset/Off.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Pen.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Pen.imageset/Pen.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Plus.imageset/Plus.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Question Mark Circle.imageset/Question Mark Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Refresh.imageset/Refresh.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Sliders Horizontal.imageset/Sliders Horizontal.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Sliders Vertical.imageset/Sliders Vertical.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Squares.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Squares.imageset/Squares.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Sun.imageset/Sun.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Swap Horizontal.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Swap Horizontal.imageset/Swap Horizontal.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Swap Vertical.imageset/Swap Vertical.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Users.imageset/Users.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Wallet.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Wallet.imageset/Wallet.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Warning Circle.imageset/Warning Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/Web.imageset/Web.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Bold/X Mark.imageset/X Mark.pdf (100%) rename Sources/{Web3ModalUI/Resources/Assets.xcassets => ReownAppKitUI/Resources/Assets.xcassets/Icons}/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Error.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Error.imageset/error.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Error.imageset/error_light.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Android.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Android.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/App.imageset/App.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/App.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Arrow Left.imageset/Arrow Left.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Arrow Left.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Arrow Right.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Arrow Right.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Auth.imageset/Auth.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Auth.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Bell.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Bell.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Bin.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Bin.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Checkmark.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Checkmark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Chevron Bottom.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Bottom.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Chevron Left.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Left.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Chevron Right.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Right.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Chevron Top.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Chevron Top.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Compass.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Compass.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Copy.imageset/Copy.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Desktop.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Desktop.imageset/Desktop.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Disconnect.imageset/Disconnect.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Doc.imageset/Doc.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Dots Horizontal.imageset/Dots Horizontal.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Dots Vertical.imageset/Dots Vertical.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Double Chevron Vertical.imageset/Double Chevron Vertical.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Etherscan.imageset/Etherscan.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/External Link.imageset/External Link.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Eye Crossed.imageset/Eye Crossed.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Eye.imageset/Eye.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/File.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/File.imageset/File.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Filters.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Filters.imageset/Filters.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Info Circle.imageset/Info Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Info.imageset/Info.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Light Bulb.imageset/Light Bulb.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Magnifier.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Magnifier.imageset/Magnifier.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Mail.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Mail.imageset/Mail.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Mobile.imageset/Mobile.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Moon.imageset/Moon.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Nut.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Nut.imageset/Nut.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Off.imageset/Off.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Paste.imageset/Paste.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Pen.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Pen.imageset/Pen.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Plus.imageset/Plus.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/QR code.imageset/QR code.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Question Mark Circle.imageset/Question Mark Circle-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Refresh.imageset/Refresh.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Sliders.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Sliders.imageset/Sliders.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Squares.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Squares.imageset/Squares.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Sun.imageset/MediumSun.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Swap Horizontal.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Swap Horizontal.imageset/Swap Horizontal.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Swap Vertical.imageset/Swap Vertical.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Twitter.imageset/Twitter.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Wallet.imageset/Wallet.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Warning Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Warning Circle.imageset/Warning Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/Web.imageset/Web.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/X mark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/X mark.imageset/X mark.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Medium/iOS.imageset/iOS.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Add.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Add.imageset/iconAdd.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Apple.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Apple.imageset/socialIconApple.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowDown.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowDown.imageset/iconArrowDown.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowExchange.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowExchange.imageset/iconArrowExchange.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowLeft.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowLeft.imageset/iconArrowLeft.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowRight.imageset/iconArrowRight.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowUp.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ArrowUp.imageset/iconArrowUp.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/BackwardChevron.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/BackwardChevron.imageset/iconBackwardChevron.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Checkmark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Checkmark.imageset/iconCheckmark.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Compass.imageset/Compass.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Compass.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Desktop.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Desktop.imageset/iconDesktop.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Disconnect.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Disconnect.imageset/iconDisconnect.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Discord.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Discord.imageset/socialIconDiscord.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/DownwardChevron.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/DownwardChevron.imageset/iconDownwardChevron.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Error.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Error.imageset/error.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Error.imageset/error_light.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Extension.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Extension.imageset/iconExtension.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ExternalLink.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ExternalLink.imageset/iconExternalLink.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Facebook.imageset/socialIconFacebook.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ForwardChevron.imageset/iconForwardChevron.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Github.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Github.imageset/socialIconGithub.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Google.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Google.imageset/socialIconGoogle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Help.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Help.imageset/iconHelp.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/HelpSmall.imageset/iconHelpSmall.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/History.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/History.imageset/iconHistory.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeBackward.imageset/iconLargeBackward.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeClose.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeClose.imageset/iconLargeClose.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeCopy.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeCopy.imageset/iconLargeCopy.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeDesktop.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeDesktop.imageset/iconLargeDesktop.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeEmail.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeEmail.imageset/iconLargeEmail.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeEmoji.imageset/iconLargeEmoji.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeMoon.imageset/iconLargeMoon.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargePhone.imageset/iconLargePhone.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeQrcode.imageset/iconLargeQrcode.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeSun.imageset/iconLargeSun.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeTwitter.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/LargeTwitter.imageset/iconTwitter.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Mail.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Mail.imageset/iconMail.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Off.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Off.imageset/iconOff.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Pen.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Pen.imageset/iconPen.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Phone.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Phone.imageset/iconPhone.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Popular.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Popular.imageset/iconPopular.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Qrcode.imageset/iconQrcode.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/QuestionMarkCircle.imageset/Question Mark Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Recent.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Recent.imageset/iconRecent.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Retry.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Retry.imageset/iconRetry.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Scan.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Scan.imageset/iconScan.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Search.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Search.imageset/iconSearch.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Telegram.imageset/socialIconTelegram.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Box-2.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastError.imageset/Icon Boxlight-2.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Icon Box-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastInfo.imageset/Icon Boxlight-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Icon Box.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/ToastSuccess.imageset/Icon Boxlight.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Twitch.imageset/socialIconTwitch.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Twitter.imageset/socialIconTwitter.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/UpwardChevron.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/UpwardChevron.imageset/iconUpwardChevron.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Wallet.imageset/Wallet.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Website.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Original/Website.imageset/iconWebsite.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/4 dots.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/4 dots.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/App.imageset/App.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/App.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Arrow Bottom.imageset/Arrow Bottom.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Arrow Bottom.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Bars.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Bars.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Bell.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Bell.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Browser.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Browser.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Chart.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Chart.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Chat Bubble.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Chat Bubble.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Check Circle.imageset/Check Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Check Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Checkmark.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Checkmark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Chevron Left.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Chevron Left.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Code.imageset/Code.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Code.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Coin.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Coin.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Compass.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Compass.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Copy.imageset/Copy.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Desktop.imageset/Desktop.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Double Chevron Right.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Double Chevron Right.imageset/Double Chevron Right.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Browser-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Extension.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/External Link.imageset/External Link.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Eye Crossed.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Eye Crossed.imageset/Eye Crossed.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Eye.imageset/Eye.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Filters.imageset/Filters.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Fingerprint.imageset/Fingerprint.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Image.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Image.imageset/Image.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Info.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Info.imageset/Info.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Link.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Link.imageset/Link.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Load.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Load.imageset/Load.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Locker.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Locker.imageset/Locker.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Magnifier.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Magnifier.imageset/Magnifier-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Mail.imageset/Mail.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Mobile.imageset/Mobile.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Moon.imageset/Moon.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Network.imageset/Network.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/QR code.imageset/QR code.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Question Mark Circle.imageset/Question Mark Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Question.imageset/Question.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Sliders.imageset/Sliders.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Squares.imageset/Squares.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Sun.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Sun.imageset/Sun.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Swap Horizontal.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Swap Horizontal.imageset/Swap Horizontal.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Verif.imageset/Verif.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Wallet.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Wallet.imageset/Wallet-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/Warning Circle.imageset/Warning Circle.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/X mark.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/Regular/X mark.imageset/X mark.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastError.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Box-2.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastError.imageset/Icon Boxlight-2.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Icon Box-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastInfo.imageset/Icon Boxlight-1.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Icon Box.pdf (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Icons/ToastSuccess.imageset/Icon Boxlight.pdf (100%) rename Sources/{Web3ModalUI/Resources/Assets.xcassets/Icons => ReownAppKitUI/Resources/Assets.xcassets/Images}/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageBrowser.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageBrowser.imageset/imageBrowserL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDao.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDeFi.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageEth.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageEth.imageset/imageEthL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageEth.imageset/imageEthL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageEth.imageset/imageEthL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLayers.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLock.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLogin.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNetwork.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNft.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNft.imageset/imageNftL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNft.imageset/imageNftL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNft.imageset/imageNftL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNoun.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageProfile.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageSystem.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageSystem.imageset/imageSystemL@1x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageSystem.imageset/imageSystemL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Images/imageSystem.imageset/imageSystemL@3x.png (100%) rename Sources/{Web3ModalUI/Resources/Assets.xcassets/Images => ReownAppKitUI/Resources/Assets.xcassets/Mocks}/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Mocks/MockChainImage.imageset/Polygon.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/Mocks/MockWalletImage.imageset/Rainbow.png (100%) rename Sources/{Web3ModalUI/Resources/Assets.xcassets/Mocks => ReownAppKitUI/Resources/Assets.xcassets/OptionIcon}/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionAll.imageset/all_dark@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeDarkL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeDarkL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeLightL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionBrowser.imageset/optionBrowserThemeLightL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeDarkL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeDarkL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeLightL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionExtension.imageset/optionExtensionThemeLightL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/Contents.json (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeDarkL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeDarkL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeLightL@2x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Resources/Assets.xcassets/OptionIcon/optionQrCode.imageset/optionQrCodeThemeLightL@3x.png (100%) rename Sources/{Web3ModalUI => ReownAppKitUI}/Web3ModalImports copy.swift (100%) delete mode 100644 Sources/Web3ModalUI/Resources/Assets.xcassets/OptionIcon/Contents.json rename Tests/{Web3ModalTests => ReownAppKitTests}/AccountButtonSnapshotTests.swift (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/NetworkButtonSnapshotTests.swift (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/QRCodeViewSnapshotTests.swift (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/__Snapshots__/AccountButtonSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/__Snapshots__/AccountButtonSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/__Snapshots__/NetworkButtonSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/__Snapshots__/NetworkButtonSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalTests => ReownAppKitTests}/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MActionEntrySnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MButtonSnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MCardSelectSnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MChipButtonSnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MListItemSnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MListSelectSnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MTagSnapshotTests.swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/W3MToastSnapshotTests .swift (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MActionEntrySnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MButtonSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MButtonSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MCardSelectSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MChipButtonSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MListItemSnapshotTests/test_snapshots.3.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MListSelectSnapshotTests/test_snapshots.3.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MTagSnapshotTests/test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MTagSnapshotTests/test_snapshots.2.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MToastSnapshotTests /test_snapshots.1.png (100%) rename Tests/{Web3ModalUITests => ReownAppKitUITests}/__Snapshots__/W3MToastSnapshotTests /test_snapshots.2.png (100%) diff --git a/Example/ExampleApp.xcodeproj/project.pbxproj b/Example/ExampleApp.xcodeproj/project.pbxproj index 3fd2d31cf..d166e0d5f 100644 --- a/Example/ExampleApp.xcodeproj/project.pbxproj +++ b/Example/ExampleApp.xcodeproj/project.pbxproj @@ -72,7 +72,6 @@ A50D53C32ABA055700A4FD8B /* NotifyPreferencesRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BE2ABA055700A4FD8B /* NotifyPreferencesRouter.swift */; }; A50D53C42ABA055700A4FD8B /* NotifyPreferencesInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53BF2ABA055700A4FD8B /* NotifyPreferencesInteractor.swift */; }; A50D53C52ABA055700A4FD8B /* NotifyPreferencesView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50D53C02ABA055700A4FD8B /* NotifyPreferencesView.swift */; }; - A50F3946288005B200064555 /* Types.swift in Sources */ = {isa = PBXBuildFile; fileRef = A50F3945288005B200064555 /* Types.swift */; }; A51606F82A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */; }; A51606F92A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */; }; A51606FA2A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */; }; @@ -83,11 +82,7 @@ A51811A12A52E83100A52B15 /* SettingsRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518119C2A52E83100A52B15 /* SettingsRouter.swift */; }; A51811A22A52E83100A52B15 /* SettingsInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518119D2A52E83100A52B15 /* SettingsInteractor.swift */; }; A51811A32A52E83100A52B15 /* SettingsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518119E2A52E83100A52B15 /* SettingsView.swift */; }; - A518A98729683FB60035247E /* Web3InboxViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518A98429683FB60035247E /* Web3InboxViewController.swift */; }; - A518A98829683FB60035247E /* Web3InboxModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518A98529683FB60035247E /* Web3InboxModule.swift */; }; - A518A98929683FB60035247E /* Web3InboxRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518A98629683FB60035247E /* Web3InboxRouter.swift */; }; A518B31428E33A6500A2CE93 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A518B31328E33A6500A2CE93 /* InputConfig.swift */; }; - A51AC0DF28E4379F001BACF9 /* InputConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = A51AC0DE28E4379F001BACF9 /* InputConfig.swift */; }; A5417BBE299BFC3E00B469F3 /* ImportAccount.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */; }; A541959E2934BFEF0035AD19 /* CacaoSignerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959A2934BFEF0035AD19 /* CacaoSignerTests.swift */; }; A541959F2934BFEF0035AD19 /* SignerTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959B2934BFEF0035AD19 /* SignerTests.swift */; }; @@ -95,24 +90,6 @@ A54195A12934BFEF0035AD19 /* EIP191VerifierTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A541959D2934BFEF0035AD19 /* EIP191VerifierTests.swift */; }; A54195A52934E83F0035AD19 /* Web3 in Frameworks */ = {isa = PBXBuildFile; productRef = A54195A42934E83F0035AD19 /* Web3 */; }; A561C80029DF32CE00DF540D /* HDWalletKit in Frameworks */ = {isa = PBXBuildFile; productRef = A561C7FF29DF32CE00DF540D /* HDWalletKit */; }; - A5629AA92876A23100094373 /* ChatService.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AA82876A23100094373 /* ChatService.swift */; }; - A5629ABD2876CBC000094373 /* ChatListModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AB82876CBC000094373 /* ChatListModule.swift */; }; - A5629ABE2876CBC000094373 /* ChatListPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AB92876CBC000094373 /* ChatListPresenter.swift */; }; - A5629ABF2876CBC000094373 /* ChatListRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ABA2876CBC000094373 /* ChatListRouter.swift */; }; - A5629AC02876CBC000094373 /* ChatListInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ABB2876CBC000094373 /* ChatListInteractor.swift */; }; - A5629AC12876CBC000094373 /* ChatListView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ABC2876CBC000094373 /* ChatListView.swift */; }; - A5629AD32876CC5700094373 /* InviteModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ACE2876CC5700094373 /* InviteModule.swift */; }; - A5629AD42876CC5700094373 /* InvitePresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ACF2876CC5700094373 /* InvitePresenter.swift */; }; - A5629AD52876CC5700094373 /* InviteRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AD02876CC5700094373 /* InviteRouter.swift */; }; - A5629AD62876CC5700094373 /* InviteInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AD12876CC5700094373 /* InviteInteractor.swift */; }; - A5629AD72876CC5700094373 /* InviteView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AD22876CC5700094373 /* InviteView.swift */; }; - A5629ADE2876CC6E00094373 /* InviteListModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AD92876CC6E00094373 /* InviteListModule.swift */; }; - A5629ADF2876CC6E00094373 /* InviteListPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ADA2876CC6E00094373 /* InviteListPresenter.swift */; }; - A5629AE02876CC6E00094373 /* InviteListRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ADB2876CC6E00094373 /* InviteListRouter.swift */; }; - A5629AE12876CC6E00094373 /* InviteListInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ADC2876CC6E00094373 /* InviteListInteractor.swift */; }; - A5629AE22876CC6E00094373 /* InviteListView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629ADD2876CC6E00094373 /* InviteListView.swift */; }; - A5629AE42876E6D200094373 /* ThreadViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AE32876E6D200094373 /* ThreadViewModel.swift */; }; - A5629AE828772A0100094373 /* InviteViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5629AE728772A0100094373 /* InviteViewModel.swift */; }; A5629AEA2877F2D600094373 /* WalletConnectChat in Frameworks */ = {isa = PBXBuildFile; productRef = A5629AE92877F2D600094373 /* WalletConnectChat */; }; A5629AF22877F75100094373 /* Starscream in Frameworks */ = {isa = PBXBuildFile; productRef = A5629AF12877F75100094373 /* Starscream */; }; A56AC8F22AD88A5A001C8FAA /* Sequence.swift in Sources */ = {isa = PBXBuildFile; fileRef = A56AC8F12AD88A5A001C8FAA /* Sequence.swift */; }; @@ -122,40 +99,8 @@ A57879712A4EDC8100F8D10B /* TextFieldView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A57879702A4EDC8100F8D10B /* TextFieldView.swift */; }; A57879722A4F225E00F8D10B /* ImportAccount.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */; }; A57879732A4F248200F8D10B /* AccountStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20228287EB34C007E3188 /* AccountStorage.swift */; }; - A578FA322873036400AA7720 /* InputView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A578FA312873036400AA7720 /* InputView.swift */; }; - A578FA35287304A300AA7720 /* Color.swift in Sources */ = {isa = PBXBuildFile; fileRef = A578FA34287304A300AA7720 /* Color.swift */; }; - A578FA372873D8EE00AA7720 /* UIColor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A578FA362873D8EE00AA7720 /* UIColor.swift */; }; - A578FA392873FCE000AA7720 /* ChatScrollView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A578FA382873FCE000AA7720 /* ChatScrollView.swift */; }; - A578FA3D2874002400AA7720 /* View.swift in Sources */ = {isa = PBXBuildFile; fileRef = A578FA3C2874002400AA7720 /* View.swift */; }; A58A1ECC29BF458600A82A20 /* ENSResolverTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58A1ECB29BF458600A82A20 /* ENSResolverTests.swift */; }; - A58E7CEB28729F550082D443 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7CEA28729F550082D443 /* AppDelegate.swift */; }; - A58E7CED28729F550082D443 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7CEC28729F550082D443 /* SceneDelegate.swift */; }; - A58E7CF428729F550082D443 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = A58E7CF328729F550082D443 /* Assets.xcassets */; }; - A58E7CF728729F550082D443 /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = A58E7CF528729F550082D443 /* LaunchScreen.storyboard */; }; - A58E7D002872A1050082D443 /* SceneViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7CFF2872A1050082D443 /* SceneViewController.swift */; }; - A58E7D032872A1630082D443 /* String.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D022872A1630082D443 /* String.swift */; }; - A58E7D0C2872A45B0082D443 /* MainModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D072872A45B0082D443 /* MainModule.swift */; }; - A58E7D0D2872A45B0082D443 /* MainPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D082872A45B0082D443 /* MainPresenter.swift */; }; - A58E7D0E2872A45B0082D443 /* MainRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D092872A45B0082D443 /* MainRouter.swift */; }; - A58E7D132872A4A80082D443 /* Application.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D122872A4A80082D443 /* Application.swift */; }; - A58E7D152872A5410082D443 /* UIViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D142872A5410082D443 /* UIViewController.swift */; }; - A58E7D1D2872A57B0082D443 /* Configurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D172872A57B0082D443 /* Configurator.swift */; }; - A58E7D1E2872A57B0082D443 /* ThirdPartyConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D182872A57B0082D443 /* ThirdPartyConfigurator.swift */; }; - A58E7D1F2872A57B0082D443 /* ApplicationConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D192872A57B0082D443 /* ApplicationConfigurator.swift */; }; - A58E7D212872A57B0082D443 /* MigrationConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D1B2872A57B0082D443 /* MigrationConfigurator.swift */; }; - A58E7D222872A57B0082D443 /* AppearanceConfigurator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D1C2872A57B0082D443 /* AppearanceConfigurator.swift */; }; - A58E7D242872AB130082D443 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D232872AB130082D443 /* MainViewController.swift */; }; - A58E7D392872D55F0082D443 /* ChatModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D342872D55F0082D443 /* ChatModule.swift */; }; - A58E7D3A2872D55F0082D443 /* ChatRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D352872D55F0082D443 /* ChatRouter.swift */; }; - A58E7D3B2872D55F0082D443 /* ChatInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D362872D55F0082D443 /* ChatInteractor.swift */; }; - A58E7D3C2872D55F0082D443 /* ChatPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D372872D55F0082D443 /* ChatPresenter.swift */; }; - A58E7D3D2872D55F0082D443 /* ChatView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D382872D55F0082D443 /* ChatView.swift */; }; - A58E7D3F2872E99A0082D443 /* TabPage.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D3E2872E99A0082D443 /* TabPage.swift */; }; - A58E7D432872EE320082D443 /* MessageView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D422872EE320082D443 /* MessageView.swift */; }; - A58E7D452872EE570082D443 /* ContentMessageView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D442872EE570082D443 /* ContentMessageView.swift */; }; - A58E7D482872EF610082D443 /* MessageViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58E7D472872EF610082D443 /* MessageViewModel.swift */; }; A58EC611299D57B800F3452A /* AsyncButton in Frameworks */ = {isa = PBXBuildFile; productRef = A58EC610299D57B800F3452A /* AsyncButton */; }; - A58EC616299D5C6400F3452A /* PlainButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = A58EC615299D5C6400F3452A /* PlainButton.swift */; }; A58EC618299D665A00F3452A /* Web3Inbox in Frameworks */ = {isa = PBXBuildFile; productRef = A58EC617299D665A00F3452A /* Web3Inbox */; }; A59CF4F6292F83D50031A42F /* DefaultSignerFactory.swift in Sources */ = {isa = PBXBuildFile; fileRef = A59CF4F5292F83D50031A42F /* DefaultSignerFactory.swift */; }; A59D25EE2AB3672700D7EA3A /* AsyncButton in Frameworks */ = {isa = PBXBuildFile; productRef = A59D25ED2AB3672700D7EA3A /* AsyncButton */; }; @@ -183,20 +128,7 @@ A5B6C0F52A6EAB2800927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F42A6EAB2800927332 /* WalletConnectNotify */; }; A5B6C0F72A6EAB3200927332 /* WalletConnectNotify in Frameworks */ = {isa = PBXBuildFile; productRef = A5B6C0F62A6EAB3200927332 /* WalletConnectNotify */; }; A5BB7FAD28B6AA7D00707FC6 /* QRCodeGenerator.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */; }; - A5C2020B287D9DEE007E3188 /* WelcomeModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20206287D9DEE007E3188 /* WelcomeModule.swift */; }; - A5C2020C287D9DEE007E3188 /* WelcomePresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20207287D9DEE007E3188 /* WelcomePresenter.swift */; }; - A5C2020D287D9DEE007E3188 /* WelcomeRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20208287D9DEE007E3188 /* WelcomeRouter.swift */; }; - A5C2020F287D9DEE007E3188 /* WelcomeView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C2020A287D9DEE007E3188 /* WelcomeView.swift */; }; - A5C20219287E1FD8007E3188 /* ImportModule.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20214287E1FD8007E3188 /* ImportModule.swift */; }; - A5C2021A287E1FD8007E3188 /* ImportPresenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20215287E1FD8007E3188 /* ImportPresenter.swift */; }; - A5C2021B287E1FD8007E3188 /* ImportRouter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20216287E1FD8007E3188 /* ImportRouter.swift */; }; - A5C2021C287E1FD8007E3188 /* ImportInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20217287E1FD8007E3188 /* ImportInteractor.swift */; }; - A5C2021D287E1FD8007E3188 /* ImportView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20218287E1FD8007E3188 /* ImportView.swift */; }; - A5C20221287EA5B8007E3188 /* TextFieldView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20220287EA5B8007E3188 /* TextFieldView.swift */; }; - A5C20223287EA7E2007E3188 /* BrandButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20222287EA7E2007E3188 /* BrandButton.swift */; }; A5C20229287EB34C007E3188 /* AccountStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C20228287EB34C007E3188 /* AccountStorage.swift */; }; - A5C2022B287EB89A007E3188 /* WelcomeInteractor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C2022A287EB89A007E3188 /* WelcomeInteractor.swift */; }; - A5C5153329BB7A6A004210BA /* InviteType.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5C5153229BB7A6A004210BA /* InviteType.swift */; }; A5C8BE85292FE20B006CC85C /* Web3 in Frameworks */ = {isa = PBXBuildFile; productRef = A5C8BE84292FE20B006CC85C /* Web3 */; }; A5D610C82AB31EE800C20083 /* SegmentedPicker.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5D610C72AB31EE800C20083 /* SegmentedPicker.swift */; }; A5D610CA2AB3249100C20083 /* ListingViewModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5D610C92AB3249100C20083 /* ListingViewModel.swift */; }; @@ -217,7 +149,6 @@ A5E22D222840C8D300E36487 /* WalletEngine.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D212840C8D300E36487 /* WalletEngine.swift */; }; A5E22D242840C8DB00E36487 /* SafariEngine.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D232840C8DB00E36487 /* SafariEngine.swift */; }; A5E22D2C2840EAC300E36487 /* XCUIElement.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E22D2B2840EAC300E36487 /* XCUIElement.swift */; }; - A5E776BA29F4362D00172091 /* AlertError.swift in Sources */ = {isa = PBXBuildFile; fileRef = A5E776B929F4362D00172091 /* AlertError.swift */; }; A74D32BA2A1E25AD00CB8536 /* QueryParameters.swift in Sources */ = {isa = PBXBuildFile; fileRef = A74D32B92A1E25AD00CB8536 /* QueryParameters.swift */; }; C5133A78294125CC00A8314C /* Web3 in Frameworks */ = {isa = PBXBuildFile; productRef = C5133A77294125CC00A8314C /* Web3 */; }; C53AA4362941251C008EA57C /* DefaultSignerFactory.swift in Sources */ = {isa = PBXBuildFile; fileRef = A59CF4F5292F83D50031A42F /* DefaultSignerFactory.swift */; }; @@ -454,7 +385,6 @@ A50D53BE2ABA055700A4FD8B /* NotifyPreferencesRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyPreferencesRouter.swift; sourceTree = ""; }; A50D53BF2ABA055700A4FD8B /* NotifyPreferencesInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyPreferencesInteractor.swift; sourceTree = ""; }; A50D53C02ABA055700A4FD8B /* NotifyPreferencesView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NotifyPreferencesView.swift; sourceTree = ""; }; - A50F3945288005B200064555 /* Types.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Types.swift; sourceTree = ""; }; A51606F72A2F47BD00CACB92 /* DefaultBIP44Provider.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = DefaultBIP44Provider.swift; sourceTree = ""; }; A51811972A52E21A00A52B15 /* ConfigurationService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConfigurationService.swift; sourceTree = ""; }; A518119A2A52E83100A52B15 /* SettingsModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsModule.swift; sourceTree = ""; }; @@ -462,74 +392,19 @@ A518119C2A52E83100A52B15 /* SettingsRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsRouter.swift; sourceTree = ""; }; A518119D2A52E83100A52B15 /* SettingsInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsInteractor.swift; sourceTree = ""; }; A518119E2A52E83100A52B15 /* SettingsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsView.swift; sourceTree = ""; }; - A518A98429683FB60035247E /* Web3InboxViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Web3InboxViewController.swift; sourceTree = ""; }; - A518A98529683FB60035247E /* Web3InboxModule.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Web3InboxModule.swift; sourceTree = ""; }; - A518A98629683FB60035247E /* Web3InboxRouter.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Web3InboxRouter.swift; sourceTree = ""; }; A518B31328E33A6500A2CE93 /* InputConfig.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; - A51AC0DE28E4379F001BACF9 /* InputConfig.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputConfig.swift; sourceTree = ""; }; A5417BBD299BFC3E00B469F3 /* ImportAccount.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ImportAccount.swift; sourceTree = ""; }; A541959A2934BFEF0035AD19 /* CacaoSignerTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = CacaoSignerTests.swift; sourceTree = ""; }; A541959B2934BFEF0035AD19 /* SignerTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SignerTests.swift; sourceTree = ""; }; A541959C2934BFEF0035AD19 /* EIP1271VerifierTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = EIP1271VerifierTests.swift; sourceTree = ""; }; A541959D2934BFEF0035AD19 /* EIP191VerifierTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = EIP191VerifierTests.swift; sourceTree = ""; }; - A5629AA82876A23100094373 /* ChatService.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatService.swift; sourceTree = ""; }; - A5629AB82876CBC000094373 /* ChatListModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListModule.swift; sourceTree = ""; }; - A5629AB92876CBC000094373 /* ChatListPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListPresenter.swift; sourceTree = ""; }; - A5629ABA2876CBC000094373 /* ChatListRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListRouter.swift; sourceTree = ""; }; - A5629ABB2876CBC000094373 /* ChatListInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListInteractor.swift; sourceTree = ""; }; - A5629ABC2876CBC000094373 /* ChatListView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatListView.swift; sourceTree = ""; }; - A5629ACE2876CC5700094373 /* InviteModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteModule.swift; sourceTree = ""; }; - A5629ACF2876CC5700094373 /* InvitePresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InvitePresenter.swift; sourceTree = ""; }; - A5629AD02876CC5700094373 /* InviteRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteRouter.swift; sourceTree = ""; }; - A5629AD12876CC5700094373 /* InviteInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteInteractor.swift; sourceTree = ""; }; - A5629AD22876CC5700094373 /* InviteView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteView.swift; sourceTree = ""; }; - A5629AD92876CC6E00094373 /* InviteListModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteListModule.swift; sourceTree = ""; }; - A5629ADA2876CC6E00094373 /* InviteListPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteListPresenter.swift; sourceTree = ""; }; - A5629ADB2876CC6E00094373 /* InviteListRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteListRouter.swift; sourceTree = ""; }; - A5629ADC2876CC6E00094373 /* InviteListInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteListInteractor.swift; sourceTree = ""; }; - A5629ADD2876CC6E00094373 /* InviteListView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteListView.swift; sourceTree = ""; }; - A5629AE32876E6D200094373 /* ThreadViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ThreadViewModel.swift; sourceTree = ""; }; - A5629AE728772A0100094373 /* InviteViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteViewModel.swift; sourceTree = ""; }; A5629AEF2877F73000094373 /* DefaultSocketFactory.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DefaultSocketFactory.swift; sourceTree = ""; }; A56AC8F12AD88A5A001C8FAA /* Sequence.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Sequence.swift; sourceTree = ""; }; A57879702A4EDC8100F8D10B /* TextFieldView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TextFieldView.swift; sourceTree = ""; }; - A578FA312873036400AA7720 /* InputView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InputView.swift; sourceTree = ""; }; - A578FA34287304A300AA7720 /* Color.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Color.swift; sourceTree = ""; }; - A578FA362873D8EE00AA7720 /* UIColor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = UIColor.swift; sourceTree = ""; }; - A578FA382873FCE000AA7720 /* ChatScrollView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChatScrollView.swift; sourceTree = ""; }; - A578FA3C2874002400AA7720 /* View.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = View.swift; sourceTree = ""; }; A57E71A5291CF76400325797 /* ETHSigner.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ETHSigner.swift; sourceTree = ""; }; A57E71A7291CF8A500325797 /* SOLSigner.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SOLSigner.swift; sourceTree = ""; }; A58A1ECB29BF458600A82A20 /* ENSResolverTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ENSResolverTests.swift; sourceTree = ""; }; A58E7CE828729F550082D443 /* Showcase.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Showcase.app; sourceTree = BUILT_PRODUCTS_DIR; }; - A58E7CEA28729F550082D443 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; - A58E7CEC28729F550082D443 /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SceneDelegate.swift; sourceTree = ""; }; - A58E7CF328729F550082D443 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; - A58E7CF628729F550082D443 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; - A58E7CF828729F550082D443 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; - A58E7CFF2872A1050082D443 /* SceneViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SceneViewController.swift; sourceTree = ""; }; - A58E7D022872A1630082D443 /* String.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = String.swift; sourceTree = ""; }; - A58E7D072872A45B0082D443 /* MainModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainModule.swift; sourceTree = ""; }; - A58E7D082872A45B0082D443 /* MainPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainPresenter.swift; sourceTree = ""; }; - A58E7D092872A45B0082D443 /* MainRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainRouter.swift; sourceTree = ""; }; - A58E7D122872A4A80082D443 /* Application.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Application.swift; sourceTree = ""; }; - A58E7D142872A5410082D443 /* UIViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = UIViewController.swift; sourceTree = ""; }; - A58E7D172872A57B0082D443 /* Configurator.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Configurator.swift; sourceTree = ""; }; - A58E7D182872A57B0082D443 /* ThirdPartyConfigurator.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ThirdPartyConfigurator.swift; sourceTree = ""; }; - A58E7D192872A57B0082D443 /* ApplicationConfigurator.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ApplicationConfigurator.swift; sourceTree = ""; }; - A58E7D1B2872A57B0082D443 /* MigrationConfigurator.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = MigrationConfigurator.swift; sourceTree = ""; }; - A58E7D1C2872A57B0082D443 /* AppearanceConfigurator.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppearanceConfigurator.swift; sourceTree = ""; }; - A58E7D232872AB130082D443 /* MainViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainViewController.swift; sourceTree = ""; }; - A58E7D342872D55F0082D443 /* ChatModule.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ChatModule.swift; sourceTree = ""; }; - A58E7D352872D55F0082D443 /* ChatRouter.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ChatRouter.swift; sourceTree = ""; }; - A58E7D362872D55F0082D443 /* ChatInteractor.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ChatInteractor.swift; sourceTree = ""; }; - A58E7D372872D55F0082D443 /* ChatPresenter.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ChatPresenter.swift; sourceTree = ""; }; - A58E7D382872D55F0082D443 /* ChatView.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ChatView.swift; sourceTree = ""; }; - A58E7D3E2872E99A0082D443 /* TabPage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TabPage.swift; sourceTree = ""; }; - A58E7D422872EE320082D443 /* MessageView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MessageView.swift; sourceTree = ""; }; - A58E7D442872EE570082D443 /* ContentMessageView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ContentMessageView.swift; sourceTree = ""; }; - A58E7D472872EF610082D443 /* MessageViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MessageViewModel.swift; sourceTree = ""; }; - A58EC615299D5C6400F3452A /* PlainButton.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PlainButton.swift; sourceTree = ""; }; A59CF4F5292F83D50031A42F /* DefaultSignerFactory.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DefaultSignerFactory.swift; sourceTree = ""; }; A5A0843B29D2F60A000B9B17 /* DefaultCryptoProvider.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DefaultCryptoProvider.swift; sourceTree = ""; }; A5A4FC722840C12C00BBEC1E /* UITests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = UITests.xctest; sourceTree = BUILT_PRODUCTS_DIR; }; @@ -541,20 +416,7 @@ A5B4F7C12ABB20AE0099AF7C /* SubscriptionView.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SubscriptionView.swift; sourceTree = ""; }; A5B4F7C72ABB21190099AF7C /* CacheAsyncImage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CacheAsyncImage.swift; sourceTree = ""; }; A5BB7FAC28B6AA7D00707FC6 /* QRCodeGenerator.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = QRCodeGenerator.swift; sourceTree = ""; }; - A5C20206287D9DEE007E3188 /* WelcomeModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WelcomeModule.swift; sourceTree = ""; }; - A5C20207287D9DEE007E3188 /* WelcomePresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WelcomePresenter.swift; sourceTree = ""; }; - A5C20208287D9DEE007E3188 /* WelcomeRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WelcomeRouter.swift; sourceTree = ""; }; - A5C2020A287D9DEE007E3188 /* WelcomeView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WelcomeView.swift; sourceTree = ""; }; - A5C20214287E1FD8007E3188 /* ImportModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ImportModule.swift; sourceTree = ""; }; - A5C20215287E1FD8007E3188 /* ImportPresenter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ImportPresenter.swift; sourceTree = ""; }; - A5C20216287E1FD8007E3188 /* ImportRouter.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ImportRouter.swift; sourceTree = ""; }; - A5C20217287E1FD8007E3188 /* ImportInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ImportInteractor.swift; sourceTree = ""; }; - A5C20218287E1FD8007E3188 /* ImportView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ImportView.swift; sourceTree = ""; }; - A5C20220287EA5B8007E3188 /* TextFieldView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TextFieldView.swift; sourceTree = ""; }; - A5C20222287EA7E2007E3188 /* BrandButton.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BrandButton.swift; sourceTree = ""; }; A5C20228287EB34C007E3188 /* AccountStorage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AccountStorage.swift; sourceTree = ""; }; - A5C2022A287EB89A007E3188 /* WelcomeInteractor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WelcomeInteractor.swift; sourceTree = ""; }; - A5C5153229BB7A6A004210BA /* InviteType.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InviteType.swift; sourceTree = ""; }; A5D610C72AB31EE800C20083 /* SegmentedPicker.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SegmentedPicker.swift; sourceTree = ""; }; A5D610C92AB3249100C20083 /* ListingViewModel.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ListingViewModel.swift; sourceTree = ""; }; A5D610CD2AB3594100C20083 /* ListingsAPI.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ListingsAPI.swift; sourceTree = ""; }; @@ -572,7 +434,6 @@ A5E22D212840C8D300E36487 /* WalletEngine.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = WalletEngine.swift; sourceTree = ""; }; A5E22D232840C8DB00E36487 /* SafariEngine.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SafariEngine.swift; sourceTree = ""; }; A5E22D2B2840EAC300E36487 /* XCUIElement.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = XCUIElement.swift; sourceTree = ""; }; - A5E776B929F4362D00172091 /* AlertError.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertError.swift; sourceTree = ""; }; A5F48A0528E43D3F0034CBFB /* Configuration.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Configuration.xcconfig; path = ../Configuration.xcconfig; sourceTree = ""; }; A74D32B92A1E25AD00CB8536 /* QueryParameters.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = QueryParameters.swift; sourceTree = ""; }; C55D347A295DD7140004314A /* AuthRequestModule.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AuthRequestModule.swift; sourceTree = ""; }; @@ -792,7 +653,6 @@ 84CE641D27981DED00142511 /* DApp */, A5A4FC732840C12C00BBEC1E /* UITests */, A5E03DEE286464DB00888481 /* IntegrationTests */, - A58E7CE928729F550082D443 /* Showcase */, C56EE21C293F55ED004840D1 /* WalletApp */, 84E6B84829787A8000428BAF /* PNDecryptionService */, 844749F429B9E5B9005F520B /* RelayIntegrationTests */, @@ -1003,14 +863,6 @@ path = NotifySettings; sourceTree = ""; }; - A50F3944288005A700064555 /* Types */ = { - isa = PBXGroup; - children = ( - A50F3945288005B200064555 /* Types.swift */, - ); - path = Types; - sourceTree = ""; - }; A51811992A52E82100A52B15 /* Settings */ = { isa = PBXGroup; children = ( @@ -1035,78 +887,6 @@ path = Signer; sourceTree = ""; }; - A5629AA42876A19D00094373 /* DomainLayer */ = { - isa = PBXGroup; - children = ( - A5629AEB2877F69C00094373 /* Chat */, - ); - path = DomainLayer; - sourceTree = ""; - }; - A5629AB72876CBA700094373 /* ChatList */ = { - isa = PBXGroup; - children = ( - A5629AE5287729EF00094373 /* Models */, - A5629AB82876CBC000094373 /* ChatListModule.swift */, - A5629AB92876CBC000094373 /* ChatListPresenter.swift */, - A5629ABA2876CBC000094373 /* ChatListRouter.swift */, - A5629ABB2876CBC000094373 /* ChatListInteractor.swift */, - A5629ABC2876CBC000094373 /* ChatListView.swift */, - ); - path = ChatList; - sourceTree = ""; - }; - A5629ACD2876CC4A00094373 /* Invite */ = { - isa = PBXGroup; - children = ( - A5629ACE2876CC5700094373 /* InviteModule.swift */, - A5629ACF2876CC5700094373 /* InvitePresenter.swift */, - A5629AD02876CC5700094373 /* InviteRouter.swift */, - A5629AD12876CC5700094373 /* InviteInteractor.swift */, - A5629AD22876CC5700094373 /* InviteView.swift */, - ); - path = Invite; - sourceTree = ""; - }; - A5629AD82876CC5B00094373 /* InviteList */ = { - isa = PBXGroup; - children = ( - A5629AE6287729F800094373 /* Models */, - A5629AD92876CC6E00094373 /* InviteListModule.swift */, - A5629ADA2876CC6E00094373 /* InviteListPresenter.swift */, - A5629ADB2876CC6E00094373 /* InviteListRouter.swift */, - A5629ADC2876CC6E00094373 /* InviteListInteractor.swift */, - A5629ADD2876CC6E00094373 /* InviteListView.swift */, - ); - path = InviteList; - sourceTree = ""; - }; - A5629AE5287729EF00094373 /* Models */ = { - isa = PBXGroup; - children = ( - A5629AE32876E6D200094373 /* ThreadViewModel.swift */, - A5E776B929F4362D00172091 /* AlertError.swift */, - ); - path = Models; - sourceTree = ""; - }; - A5629AE6287729F800094373 /* Models */ = { - isa = PBXGroup; - children = ( - A5629AE728772A0100094373 /* InviteViewModel.swift */, - A5C5153229BB7A6A004210BA /* InviteType.swift */, - ); - path = Models; - sourceTree = ""; - }; - A5629AEB2877F69C00094373 /* Chat */ = { - isa = PBXGroup; - children = ( - A5629AA82876A23100094373 /* ChatService.swift */, - ); - path = Chat; - sourceTree = ""; - }; A56AC8F02AD88A4B001C8FAA /* Foundation */ = { isa = PBXGroup; children = ( @@ -1115,16 +895,6 @@ path = Foundation; sourceTree = ""; }; - A574B3592964570000C2BB91 /* Web3Inbox */ = { - isa = PBXGroup; - children = ( - A518A98529683FB60035247E /* Web3InboxModule.swift */, - A518A98629683FB60035247E /* Web3InboxRouter.swift */, - A518A98429683FB60035247E /* Web3InboxViewController.swift */, - ); - path = Web3Inbox; - sourceTree = ""; - }; A578796F2A4EDC6B00F8D10B /* Views */ = { isa = PBXGroup; children = ( @@ -1133,32 +903,6 @@ path = Views; sourceTree = ""; }; - A578FA332873049400AA7720 /* Style */ = { - isa = PBXGroup; - children = ( - A578FA34287304A300AA7720 /* Color.swift */, - ); - path = Style; - sourceTree = ""; - }; - A578FA3A2874001100AA7720 /* UIKit */ = { - isa = PBXGroup; - children = ( - A58E7D142872A5410082D443 /* UIViewController.swift */, - A58E7D022872A1630082D443 /* String.swift */, - A578FA362873D8EE00AA7720 /* UIColor.swift */, - ); - path = UIKit; - sourceTree = ""; - }; - A578FA3B2874001900AA7720 /* SwiftUI */ = { - isa = PBXGroup; - children = ( - A578FA3C2874002400AA7720 /* View.swift */, - ); - path = SwiftUI; - sourceTree = ""; - }; A57E71A4291CF73300325797 /* Signer */ = { isa = PBXGroup; children = ( @@ -1177,164 +921,6 @@ path = ENS; sourceTree = ""; }; - A58E7CE928729F550082D443 /* Showcase */ = { - isa = PBXGroup; - children = ( - A58E7D052872A4330082D443 /* Classes */, - A58E7CFD2872A0F80082D443 /* Common */, - A58E7CFC28729F9E0082D443 /* Other */, - ); - path = Showcase; - sourceTree = ""; - }; - A58E7CFC28729F9E0082D443 /* Other */ = { - isa = PBXGroup; - children = ( - A58E7CF328729F550082D443 /* Assets.xcassets */, - A58E7CF528729F550082D443 /* LaunchScreen.storyboard */, - A58E7CF828729F550082D443 /* Info.plist */, - ); - path = Other; - sourceTree = ""; - }; - A58E7CFD2872A0F80082D443 /* Common */ = { - isa = PBXGroup; - children = ( - A51AC0DE28E4379F001BACF9 /* InputConfig.swift */, - A50F3944288005A700064555 /* Types */, - A5C2021F287EA5AF007E3188 /* Components */, - A578FA332873049400AA7720 /* Style */, - A58E7D012872A1430082D443 /* Extensions */, - A58E7CFE2872A1050082D443 /* VIPER */, - ); - path = Common; - sourceTree = ""; - }; - A58E7CFE2872A1050082D443 /* VIPER */ = { - isa = PBXGroup; - children = ( - A58E7CFF2872A1050082D443 /* SceneViewController.swift */, - ); - path = VIPER; - sourceTree = ""; - }; - A58E7D012872A1430082D443 /* Extensions */ = { - isa = PBXGroup; - children = ( - A578FA3B2874001900AA7720 /* SwiftUI */, - A578FA3A2874001100AA7720 /* UIKit */, - ); - path = Extensions; - sourceTree = ""; - }; - A58E7D052872A4330082D443 /* Classes */ = { - isa = PBXGroup; - children = ( - A5629AA42876A19D00094373 /* DomainLayer */, - A58E7D112872A49E0082D443 /* ApplicationLayer */, - A58E7D062872A4390082D443 /* PresentationLayer */, - ); - path = Classes; - sourceTree = ""; - }; - A58E7D062872A4390082D443 /* PresentationLayer */ = { - isa = PBXGroup; - children = ( - A574B3592964570000C2BB91 /* Web3Inbox */, - A59F876828B53E6400A9CD80 /* Chat */, - ); - path = PresentationLayer; - sourceTree = ""; - }; - A58E7D112872A49E0082D443 /* ApplicationLayer */ = { - isa = PBXGroup; - children = ( - A58E7D162872A57B0082D443 /* Configurator */, - A58E7D122872A4A80082D443 /* Application.swift */, - A58E7CEA28729F550082D443 /* AppDelegate.swift */, - A58E7CEC28729F550082D443 /* SceneDelegate.swift */, - ); - path = ApplicationLayer; - sourceTree = ""; - }; - A58E7D162872A57B0082D443 /* Configurator */ = { - isa = PBXGroup; - children = ( - A58E7D172872A57B0082D443 /* Configurator.swift */, - A58E7D182872A57B0082D443 /* ThirdPartyConfigurator.swift */, - A58E7D192872A57B0082D443 /* ApplicationConfigurator.swift */, - A58E7D1B2872A57B0082D443 /* MigrationConfigurator.swift */, - A58E7D1C2872A57B0082D443 /* AppearanceConfigurator.swift */, - ); - path = Configurator; - sourceTree = ""; - }; - A58E7D282872D52A0082D443 /* Main */ = { - isa = PBXGroup; - children = ( - A58E7D402872E9A10082D443 /* Model */, - A58E7D072872A45B0082D443 /* MainModule.swift */, - A58E7D082872A45B0082D443 /* MainPresenter.swift */, - A58E7D092872A45B0082D443 /* MainRouter.swift */, - A58E7D232872AB130082D443 /* MainViewController.swift */, - ); - path = Main; - sourceTree = ""; - }; - A58E7D332872D55F0082D443 /* Chat */ = { - isa = PBXGroup; - children = ( - A58E7D462872EF5B0082D443 /* Models */, - A58E7D412872EE270082D443 /* Views */, - A58E7D342872D55F0082D443 /* ChatModule.swift */, - A58E7D352872D55F0082D443 /* ChatRouter.swift */, - A58E7D362872D55F0082D443 /* ChatInteractor.swift */, - A58E7D372872D55F0082D443 /* ChatPresenter.swift */, - A58E7D382872D55F0082D443 /* ChatView.swift */, - ); - path = Chat; - sourceTree = ""; - }; - A58E7D402872E9A10082D443 /* Model */ = { - isa = PBXGroup; - children = ( - A58E7D3E2872E99A0082D443 /* TabPage.swift */, - ); - path = Model; - sourceTree = ""; - }; - A58E7D412872EE270082D443 /* Views */ = { - isa = PBXGroup; - children = ( - A58E7D422872EE320082D443 /* MessageView.swift */, - A58E7D442872EE570082D443 /* ContentMessageView.swift */, - A578FA382873FCE000AA7720 /* ChatScrollView.swift */, - ); - path = Views; - sourceTree = ""; - }; - A58E7D462872EF5B0082D443 /* Models */ = { - isa = PBXGroup; - children = ( - A58E7D472872EF610082D443 /* MessageViewModel.swift */, - ); - path = Models; - sourceTree = ""; - }; - A59F876828B53E6400A9CD80 /* Chat */ = { - isa = PBXGroup; - children = ( - A5C20213287E1FC8007E3188 /* Import */, - A5C20205287D9DB9007E3188 /* Welcome */, - A5629AD82876CC5B00094373 /* InviteList */, - A5629ACD2876CC4A00094373 /* Invite */, - A5629AB72876CBA700094373 /* ChatList */, - A58E7D332872D55F0082D443 /* Chat */, - A58E7D282872D52A0082D443 /* Main */, - ); - path = Chat; - sourceTree = ""; - }; A5A4FC732840C12C00BBEC1E /* UITests */ = { isa = PBXGroup; children = ( @@ -1385,41 +971,6 @@ path = Common; sourceTree = ""; }; - A5C20205287D9DB9007E3188 /* Welcome */ = { - isa = PBXGroup; - children = ( - A5C20206287D9DEE007E3188 /* WelcomeModule.swift */, - A5C20207287D9DEE007E3188 /* WelcomePresenter.swift */, - A5C2022A287EB89A007E3188 /* WelcomeInteractor.swift */, - A5C20208287D9DEE007E3188 /* WelcomeRouter.swift */, - A5C2020A287D9DEE007E3188 /* WelcomeView.swift */, - ); - path = Welcome; - sourceTree = ""; - }; - A5C20213287E1FC8007E3188 /* Import */ = { - isa = PBXGroup; - children = ( - A5C20214287E1FD8007E3188 /* ImportModule.swift */, - A5C20215287E1FD8007E3188 /* ImportPresenter.swift */, - A5C20216287E1FD8007E3188 /* ImportRouter.swift */, - A5C20217287E1FD8007E3188 /* ImportInteractor.swift */, - A5C20218287E1FD8007E3188 /* ImportView.swift */, - ); - path = Import; - sourceTree = ""; - }; - A5C2021F287EA5AF007E3188 /* Components */ = { - isa = PBXGroup; - children = ( - A578FA312873036400AA7720 /* InputView.swift */, - A5C20220287EA5B8007E3188 /* TextFieldView.swift */, - A5C20222287EA7E2007E3188 /* BrandButton.swift */, - A58EC615299D5C6400F3452A /* PlainButton.swift */, - ); - path = Components; - sourceTree = ""; - }; A5D610CB2AB358ED00C20083 /* BusinessLayer */ = { isa = PBXGroup; children = ( @@ -2175,8 +1726,6 @@ isa = PBXResourcesBuildPhase; buildActionMask = 2147483647; files = ( - A58E7CF728729F550082D443 /* LaunchScreen.storyboard in Resources */, - A58E7CF428729F550082D443 /* Assets.xcassets in Resources */, ); runOnlyForDeploymentPostprocessing = 0; }; @@ -2281,79 +1830,12 @@ isa = PBXSourcesBuildPhase; buildActionMask = 2147483647; files = ( - A58E7D3B2872D55F0082D443 /* ChatInteractor.swift in Sources */, A5417BBE299BFC3E00B469F3 /* ImportAccount.swift in Sources */, - A58E7D1F2872A57B0082D443 /* ApplicationConfigurator.swift in Sources */, - A51AC0DF28E4379F001BACF9 /* InputConfig.swift in Sources */, - A58E7D452872EE570082D443 /* ContentMessageView.swift in Sources */, - A5C20223287EA7E2007E3188 /* BrandButton.swift in Sources */, - A5629ADF2876CC6E00094373 /* InviteListPresenter.swift in Sources */, - A58E7D392872D55F0082D443 /* ChatModule.swift in Sources */, - A58E7D222872A57B0082D443 /* AppearanceConfigurator.swift in Sources */, - A50F3946288005B200064555 /* Types.swift in Sources */, - A58E7D212872A57B0082D443 /* MigrationConfigurator.swift in Sources */, - A5629ABE2876CBC000094373 /* ChatListPresenter.swift in Sources */, - A58E7D0E2872A45B0082D443 /* MainRouter.swift in Sources */, - A58E7D432872EE320082D443 /* MessageView.swift in Sources */, - A58E7D3F2872E99A0082D443 /* TabPage.swift in Sources */, - A58EC616299D5C6400F3452A /* PlainButton.swift in Sources */, - A58E7D3C2872D55F0082D443 /* ChatPresenter.swift in Sources */, - A5C2020B287D9DEE007E3188 /* WelcomeModule.swift in Sources */, - A58E7D152872A5410082D443 /* UIViewController.swift in Sources */, - A58E7D132872A4A80082D443 /* Application.swift in Sources */, - A58E7D002872A1050082D443 /* SceneViewController.swift in Sources */, - A58E7D242872AB130082D443 /* MainViewController.swift in Sources */, - A5629AE02876CC6E00094373 /* InviteListRouter.swift in Sources */, - A58E7D032872A1630082D443 /* String.swift in Sources */, - A58E7D3D2872D55F0082D443 /* ChatView.swift in Sources */, - A5629ABD2876CBC000094373 /* ChatListModule.swift in Sources */, - A58E7CEB28729F550082D443 /* AppDelegate.swift in Sources */, A51606FA2A2F47BD00CACB92 /* DefaultBIP44Provider.swift in Sources */, - A578FA35287304A300AA7720 /* Color.swift in Sources */, - A5629ADE2876CC6E00094373 /* InviteListModule.swift in Sources */, - A5E776BA29F4362D00172091 /* AlertError.swift in Sources */, - A578FA322873036400AA7720 /* InputView.swift in Sources */, A5A0843F29D2F625000B9B17 /* DefaultCryptoProvider.swift in Sources */, - A5C2021B287E1FD8007E3188 /* ImportRouter.swift in Sources */, - A5629AE42876E6D200094373 /* ThreadViewModel.swift in Sources */, - A58E7D0C2872A45B0082D443 /* MainModule.swift in Sources */, - A5C2021C287E1FD8007E3188 /* ImportInteractor.swift in Sources */, - A58E7D0D2872A45B0082D443 /* MainPresenter.swift in Sources */, - A518A98829683FB60035247E /* Web3InboxModule.swift in Sources */, - A5C20219287E1FD8007E3188 /* ImportModule.swift in Sources */, - A5629AD62876CC5700094373 /* InviteInteractor.swift in Sources */, - A5629AE12876CC6E00094373 /* InviteListInteractor.swift in Sources */, - A58E7CED28729F550082D443 /* SceneDelegate.swift in Sources */, - A5C2020F287D9DEE007E3188 /* WelcomeView.swift in Sources */, - A518A98929683FB60035247E /* Web3InboxRouter.swift in Sources */, - A5C5153329BB7A6A004210BA /* InviteType.swift in Sources */, - A5C2020D287D9DEE007E3188 /* WelcomeRouter.swift in Sources */, - A578FA372873D8EE00AA7720 /* UIColor.swift in Sources */, - A518A98729683FB60035247E /* Web3InboxViewController.swift in Sources */, - A5C2021D287E1FD8007E3188 /* ImportView.swift in Sources */, - A5C2021A287E1FD8007E3188 /* ImportPresenter.swift in Sources */, - A5629AE828772A0100094373 /* InviteViewModel.swift in Sources */, - A5629AA92876A23100094373 /* ChatService.swift in Sources */, A5C20229287EB34C007E3188 /* AccountStorage.swift in Sources */, - A5629AC02876CBC000094373 /* ChatListInteractor.swift in Sources */, - A5629AE22876CC6E00094373 /* InviteListView.swift in Sources */, A5A8E47F293A1D0000FEB97D /* DefaultSocketFactory.swift in Sources */, - A578FA3D2874002400AA7720 /* View.swift in Sources */, - A5629AD72876CC5700094373 /* InviteView.swift in Sources */, - A5C20221287EA5B8007E3188 /* TextFieldView.swift in Sources */, A5A8E480293A1D0000FEB97D /* DefaultSignerFactory.swift in Sources */, - A5C2022B287EB89A007E3188 /* WelcomeInteractor.swift in Sources */, - A5C2020C287D9DEE007E3188 /* WelcomePresenter.swift in Sources */, - A58E7D1D2872A57B0082D443 /* Configurator.swift in Sources */, - A58E7D482872EF610082D443 /* MessageViewModel.swift in Sources */, - A5629AD32876CC5700094373 /* InviteModule.swift in Sources */, - A5629AD52876CC5700094373 /* InviteRouter.swift in Sources */, - A5629ABF2876CBC000094373 /* ChatListRouter.swift in Sources */, - A5629AC12876CBC000094373 /* ChatListView.swift in Sources */, - A578FA392873FCE000AA7720 /* ChatScrollView.swift in Sources */, - A58E7D1E2872A57B0082D443 /* ThirdPartyConfigurator.swift in Sources */, - A5629AD42876CC5700094373 /* InvitePresenter.swift in Sources */, - A58E7D3A2872D55F0082D443 /* ChatRouter.swift in Sources */, ); runOnlyForDeploymentPostprocessing = 0; }; @@ -2585,14 +2067,6 @@ name = LaunchScreen.storyboard; sourceTree = ""; }; - A58E7CF528729F550082D443 /* LaunchScreen.storyboard */ = { - isa = PBXVariantGroup; - children = ( - A58E7CF628729F550082D443 /* Base */, - ); - name = LaunchScreen.storyboard; - sourceTree = ""; - }; /* End PBXVariantGroup section */ /* Begin XCBuildConfiguration section */ diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Showcase.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Showcase.xcscheme deleted file mode 100644 index f9350d24d..000000000 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Showcase.xcscheme +++ /dev/null @@ -1,78 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme deleted file mode 100644 index 9619bb4be..000000000 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/Wallet.xcscheme +++ /dev/null @@ -1,127 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme index 491ef2107..2b4bed66f 100644 --- a/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme +++ b/Example/ExampleApp.xcodeproj/xcshareddata/xcschemes/WalletConnect.xcscheme @@ -272,9 +272,9 @@ skipped = "NO"> @@ -282,9 +282,9 @@ skipped = "NO"> diff --git a/Example/Showcase/Classes/ApplicationLayer/AppDelegate.swift b/Example/Showcase/Classes/ApplicationLayer/AppDelegate.swift deleted file mode 100644 index 0eaa58f26..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/AppDelegate.swift +++ /dev/null @@ -1,20 +0,0 @@ -import UIKit - -@main -class AppDelegate: UIResponder, UIApplicationDelegate { - - func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { - // Override point for customization after application launch. - return true - } - - // MARK: UISceneSession Lifecycle - - func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration { - return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role) - } - - func application(_ application: UIApplication, didDiscardSceneSessions sceneSessions: Set) { - - } -} diff --git a/Example/Showcase/Classes/ApplicationLayer/Application.swift b/Example/Showcase/Classes/ApplicationLayer/Application.swift deleted file mode 100644 index 3cc8d8713..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/Application.swift +++ /dev/null @@ -1,13 +0,0 @@ -import Foundation -import WalletConnectChat - -final class Application { - - lazy var chatService: ChatService = { - return ChatService() - }() - - lazy var accountStorage: AccountStorage = { - return AccountStorage(defaults: .standard) - }() -} diff --git a/Example/Showcase/Classes/ApplicationLayer/Configurator/AppearanceConfigurator.swift b/Example/Showcase/Classes/ApplicationLayer/Configurator/AppearanceConfigurator.swift deleted file mode 100644 index 5ad69dfb5..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/Configurator/AppearanceConfigurator.swift +++ /dev/null @@ -1,19 +0,0 @@ -import UIKit - -struct AppearanceConfigurator: Configurator { - - func configure() { - let appearance = UINavigationBarAppearance() - appearance.backgroundColor = .w_background - appearance.shadowColor = .clear - appearance.titleTextAttributes = [ - .foregroundColor: UIColor.w_foreground - ] - - UINavigationBar.appearance().standardAppearance = appearance - UINavigationBar.appearance().scrollEdgeAppearance = appearance - UINavigationBar.appearance().compactAppearance = appearance - - UIApplication.currentWindow.overrideUserInterfaceStyle = .dark - } -} diff --git a/Example/Showcase/Classes/ApplicationLayer/Configurator/ApplicationConfigurator.swift b/Example/Showcase/Classes/ApplicationLayer/Configurator/ApplicationConfigurator.swift deleted file mode 100644 index 810260eef..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/Configurator/ApplicationConfigurator.swift +++ /dev/null @@ -1,16 +0,0 @@ -import Combine - -struct ApplicationConfigurator: Configurator { - - private var publishers = Set() - - private let app: Application - - init(app: Application) { - self.app = app - } - - func configure() { - WelcomeModule.create(app: app).present() - } -} diff --git a/Example/Showcase/Classes/ApplicationLayer/Configurator/Configurator.swift b/Example/Showcase/Classes/ApplicationLayer/Configurator/Configurator.swift deleted file mode 100644 index 2eb6d30cb..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/Configurator/Configurator.swift +++ /dev/null @@ -1,9 +0,0 @@ -protocol Configurator { - func configure() -} - -extension Array where Element == Configurator { - func configure() { - forEach { $0.configure() } - } -} diff --git a/Example/Showcase/Classes/ApplicationLayer/Configurator/MigrationConfigurator.swift b/Example/Showcase/Classes/ApplicationLayer/Configurator/MigrationConfigurator.swift deleted file mode 100644 index 629308aa7..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/Configurator/MigrationConfigurator.swift +++ /dev/null @@ -1,12 +0,0 @@ -struct MigrationConfigurator: Configurator { - - let app: Application - - init(app: Application) { - self.app = app - } - - func configure() { - - } -} diff --git a/Example/Showcase/Classes/ApplicationLayer/Configurator/ThirdPartyConfigurator.swift b/Example/Showcase/Classes/ApplicationLayer/Configurator/ThirdPartyConfigurator.swift deleted file mode 100644 index bdd34c7e1..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/Configurator/ThirdPartyConfigurator.swift +++ /dev/null @@ -1,21 +0,0 @@ -import WalletConnectNetworking -import WalletConnectPairing -import Auth -import WalletConnectModal - -struct ThirdPartyConfigurator: Configurator { - - func configure() { - - let metadata = AppMetadata( - name: "Showcase App", - description: "Showcase description", - url: "example.wallet", - icons: ["https://avatars.githubusercontent.com/u/37784886"] - ) - - Networking.configure(projectId: InputConfig.projectId, socketFactory: DefaultSocketFactory()) - Auth.configure(crypto: DefaultCryptoProvider()) - WalletConnectModal.configure(projectId: InputConfig.projectId, metadata: metadata) - } -} diff --git a/Example/Showcase/Classes/ApplicationLayer/SceneDelegate.swift b/Example/Showcase/Classes/ApplicationLayer/SceneDelegate.swift deleted file mode 100644 index 537e88926..000000000 --- a/Example/Showcase/Classes/ApplicationLayer/SceneDelegate.swift +++ /dev/null @@ -1,41 +0,0 @@ -import UIKit -import Auth -import WalletConnectPairing - -class SceneDelegate: UIResponder, UIWindowSceneDelegate { - - var window: UIWindow? - - private let app = Application() - - private var configurators: [Configurator] { - return [ - MigrationConfigurator(app: app), - ThirdPartyConfigurator(), - ApplicationConfigurator(app: app), - AppearanceConfigurator() - ] - } - - func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { - guard let windowScene = (scene as? UIWindowScene) else { return } - - window = UIWindow(windowScene: windowScene) - window?.makeKeyAndVisible() - - configurators.configure() - } - - func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { - guard let context = URLContexts.first else { return } - - let uri = context.url.absoluteString.replacingOccurrences(of: "showcase://wc?uri=", with: "") - guard let walletConnectUri = WalletConnectURI(string: uri) else { - return - } - - Task { - try await Pair.instance.pair(uri: walletConnectUri) - } - } -} diff --git a/Example/Showcase/Classes/DomainLayer/Chat/ChatService.swift b/Example/Showcase/Classes/DomainLayer/Chat/ChatService.swift deleted file mode 100644 index 265ac3a56..000000000 --- a/Example/Showcase/Classes/DomainLayer/Chat/ChatService.swift +++ /dev/null @@ -1,185 +0,0 @@ -import Foundation -import Combine -import WalletConnectChat -import WalletConnectRelay -import WalletConnectSign - -typealias Stream = AnyPublisher - -final class ChatService { - - private var client: ChatClient = { - Chat.configure(bip44: DefaultBIP44Provider()) - return Chat.instance - }() - - private lazy var networking: NetworkingClient = { - return Networking.instance - }() - - var connectionPublisher: Stream { - return networking.socketConnectionStatusPublisher - .receive(on: DispatchQueue.main) - .eraseToAnyPublisher() - } - - var threadPublisher: Stream<[WalletConnectChat.Thread]> { - return client.threadsPublisher - .receive(on: DispatchQueue.main) - .eraseToAnyPublisher() - } - - var receivedInvitePublisher: Stream<[ReceivedInvite]> { - return client.receivedInvitesPublisher - .receive(on: DispatchQueue.main) - .eraseToAnyPublisher() - } - - var sentInvitePublisher: Stream<[SentInvite]> { - return client.sentInvitesPublisher - .receive(on: DispatchQueue.main) - .eraseToAnyPublisher() - } - - func messagePublisher(thread: WalletConnectChat.Thread) -> Stream<[Message]> { - return client.messagesPublisher - .map { - $0.filter { $0.topic == thread.topic } - } - .receive(on: DispatchQueue.main) - .eraseToAnyPublisher() - } - - func getMessages(thread: WalletConnectChat.Thread) -> [WalletConnectChat.Message] { - client.getMessages(topic: thread.topic) - } - - func getThreads(account: Account) -> [WalletConnectChat.Thread] { - return client.getThreads(account: account) - } - - func getReceivedInvites(account: Account) -> [ReceivedInvite] { - return client.getReceivedInvites(account: account) - } - - func getSentInvites(account: Account) -> [SentInvite] { - return client.getSentInvites(account: account) - } - - func setupSubscriptions(account: Account) { - try! client.setupSubscriptions(account: account) - } - - func sendMessage(topic: String, message: String) async throws { - try await client.message(topic: topic, message: message) - } - - func accept(invite: ReceivedInvite) async throws { - try await client.accept(inviteId: invite.id) - } - - func reject(invite: ReceivedInvite) async throws { - try await client.reject(inviteId: invite.id) - } - - func goPublic(account: Account) async throws { - try await client.goPublic(account: account) - } - - func invite(inviterAccount: Account, inviteeAccount: Account, message: String) async throws { - let inviteePublicKey = try await client.resolve(account: inviteeAccount) - let invite = Invite(message: message, inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, inviteePublicKey: inviteePublicKey) - try await client.invite(invite: invite) - } - - func register(account: Account, importAccount: ImportAccount) async throws { - _ = try await client.register(account: account) { message in - return await self.onSign(message: message, importAccount: importAccount) - } - } - - func unregister(account: Account, importAccount: ImportAccount) async throws { - try await client.unregister(account: account) { message in - return await self.onSign(message: message, importAccount: importAccount) - } - } - - func goPrivate(account: Account) async throws { - try await client.goPrivate(account: account) - } - - func resolve(account: Account) async throws -> String { - return try await client.resolve(account: account) - } -} - -private extension ChatService { - - func onSign(message: String, importAccount: ImportAccount) async -> SigningResult { - switch importAccount { - case .swift, .kotlin, .js, .custom: - return .signed(onSign(message: message, privateKey: importAccount.privateKey)) - case .web3Modal(let account, let topic): - return await onWalletConnectModalSign(message: message, account: account, topic: topic) - } - } - - func onSign(message: String, privateKey: String) -> CacaoSignature { - let privateKey = Data(hex: privateKey) - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() - return try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - } - - func onWalletConnectModalSign(message: String, account: Account, topic: String) async -> SigningResult { - guard let session = Sign.instance.getSessions().first(where: { $0.topic == topic }) else { return .rejected } - - do { - let request = makeRequest(session: session, message: message, account: account) - try await Sign.instance.request(params: request) - - let signature: CacaoSignature = try await withCheckedThrowingContinuation { continuation in - var cancellable: AnyCancellable? - cancellable = Sign.instance.sessionResponsePublisher - .sink { response in - defer { cancellable?.cancel() } - switch response.result { - case .response(let value): - do { - let string = try value.get(String.self) - let signature = CacaoSignature(t: .eip191, s: string.deleting0x()) - continuation.resume(returning: signature) - } catch { - continuation.resume(throwing: error) - } - case .error(let error): - continuation.resume(throwing: error) - } - } - } - - return .signed(signature) - } catch { - return .rejected - } - } - - func makeRequest(session: WalletConnectSign.Session, message: String, account: Account) -> Request { - return Request( - topic: session.topic, - method: "personal_sign", - params: AnyCodable(["0x" + message.data(using: .utf8)!.toHexString(), account.address]), - chainId: Blockchain("eip155:1")! - ) - } -} - -fileprivate extension String { - - func deleting0x() -> String { - var string = self - if starts(with: "0x") { - string.removeFirst(2) - } - return string - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatInteractor.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatInteractor.swift deleted file mode 100644 index dab663f14..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatInteractor.swift +++ /dev/null @@ -1,23 +0,0 @@ -import Foundation -import WalletConnectChat - -final class ChatInteractor { - - private let chatService: ChatService - - init(chatService: ChatService) { - self.chatService = chatService - } - - func getMessages(thread: WalletConnectChat.Thread) -> [Message] { - return chatService.getMessages(thread: thread) - } - - func messagesSubscription(thread: WalletConnectChat.Thread) -> Stream<[Message]> { - return chatService.messagePublisher(thread: thread) - } - - func sendMessage(topic: String, message: String) async throws { - try await chatService.sendMessage(topic: topic, message: message) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatModule.swift deleted file mode 100644 index a58326276..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatModule.swift +++ /dev/null @@ -1,19 +0,0 @@ -import SwiftUI -import WalletConnectChat - -final class ChatModule { - - @discardableResult - static func create(thread: WalletConnectChat.Thread, app: Application) -> UIViewController { - let router = ChatRouter(app: app) - let interactor = ChatInteractor(chatService: app.chatService) - let presenter = ChatPresenter(thread: thread, interactor: interactor, router: router) - let view = ChatView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatPresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatPresenter.swift deleted file mode 100644 index e19db581b..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatPresenter.swift +++ /dev/null @@ -1,61 +0,0 @@ -import UIKit -import Combine -import WalletConnectChat - -final class ChatPresenter: ObservableObject { - - private let thread: WalletConnectChat.Thread - private let interactor: ChatInteractor - private let router: ChatRouter - private var disposeBag = Set() - - @Published private var messages: [Message] = [] - @Published var input: String = .empty - - var messageViewModels: [MessageViewModel] { - return messages.sorted(by: { $0.timestamp < $1.timestamp }) - .map { MessageViewModel(message: $0, thread: thread) } - } - - init(thread: WalletConnectChat.Thread, interactor: ChatInteractor, router: ChatRouter) { - defer { setupInitialState() } - self.thread = thread - self.interactor = interactor - self.router = router - } - - func didPressSend() { - Task(priority: .userInitiated) { - try await sendMessage() - } - } -} - -// MARK: SceneViewModel - -extension ChatPresenter: SceneViewModel { - - var sceneTitle: String? { - return thread.peerAccount.address - } -} - -// MARK: Privates - -private extension ChatPresenter { - - func setupInitialState() { - messages = interactor.getMessages(thread: thread) - - interactor.messagesSubscription(thread: thread) - .sink { [unowned self] messages in - self.messages = messages - }.store(in: &disposeBag) - } - - @MainActor - func sendMessage() async throws { - try await interactor.sendMessage(topic: thread.topic, message: input) - input = .empty - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatRouter.swift deleted file mode 100644 index 83a77a59f..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatRouter.swift +++ /dev/null @@ -1,12 +0,0 @@ -import UIKit - -final class ChatRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatView.swift deleted file mode 100644 index 279a30a99..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/ChatView.swift +++ /dev/null @@ -1,37 +0,0 @@ -import SwiftUI - -struct ChatView: View { - - @EnvironmentObject var presenter: ChatPresenter - - var body: some View { - ZStack { - ChatScrollView { - ForEach(presenter.messageViewModels) { message in - MessageView(message: message) - } - - Spacer().frame(height: 72) - } - - VStack { - Spacer() - - HStack { - InputView(title: "Message...", text: $presenter.input) { - presenter.didPressSend() - } - .padding(16.0) - } - } - } - } -} - -#if DEBUG -struct ChatView_Previews: PreviewProvider { - static var previews: some View { - ChatView() - } -} -#endif diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Models/MessageViewModel.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Models/MessageViewModel.swift deleted file mode 100644 index 62387c1f7..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Models/MessageViewModel.swift +++ /dev/null @@ -1,32 +0,0 @@ -import Foundation -import WalletConnectChat - -struct MessageViewModel: Identifiable { - private let message: Message - private let thread: WalletConnectChat.Thread - - var id: UInt64 { - return message.timestamp - } - - init(message: Message, thread: WalletConnectChat.Thread) { - self.message = message - self.thread = thread - } - - var currentAccount: Account { - return thread.selfAccount - } - - var isCurrentUser: Bool { - return currentAccount == message.authorAccount - } - - var text: String { - return message.message - } - - var showAvatar: Bool { - return !isCurrentUser - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ChatScrollView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ChatScrollView.swift deleted file mode 100644 index afd5b24bc..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ChatScrollView.swift +++ /dev/null @@ -1,25 +0,0 @@ -import SwiftUI - -struct ChatScrollView: View where Content: View { - - @ViewBuilder let content: () -> Content - - var body: some View { - ScrollView(showsIndicators: false) { - VStack(alignment: .leading, spacing: 12) { - Spacer() - .frame( - minWidth: 0, - maxWidth: .infinity, - minHeight: 0, - maxHeight: .infinity, - alignment: .topLeading - ) - - content() - } - .rotationEffect(Angle(degrees: 180)) - } - .rotationEffect(Angle(degrees: 180)) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ContentMessageView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ContentMessageView.swift deleted file mode 100644 index e58deb30e..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/ContentMessageView.swift +++ /dev/null @@ -1,35 +0,0 @@ -import SwiftUI - -struct ContentMessageView: View { - - let text: String - let isCurrentUser: Bool - - var body: some View { - Text(text) - .font(.body) - .padding(.horizontal, 16.0) - .padding(.vertical, 10.0) - .foregroundColor(.white) - .background( - // TODO: Add border - overlayView - .foregroundColor(backgroundColor) - ) - } - - private var overlayView: some View { - return Rectangle() - .cornerRadius(22, corners: [.topLeft, .topRight]) - .cornerRadius(22, corners: isCurrentUser ? .bottomLeft : .bottomRight) - .cornerRadius(4, corners: isCurrentUser ? .bottomRight : .bottomLeft) - } - - private var backgroundColor: Color { - return isCurrentUser ? .w_secondaryBackground : .w_purpleBackground - } - - private var borderColor: Color { - return isCurrentUser ? .w_tertiaryBackground : .w_purpleForeground - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/MessageView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/MessageView.swift deleted file mode 100644 index 31bc7afd7..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Chat/Views/MessageView.swift +++ /dev/null @@ -1,28 +0,0 @@ -import SwiftUI - -struct MessageView: View { - - let message: MessageViewModel - - var body: some View { - HStack(spacing: 8.0) { - if message.isCurrentUser { - Spacer() - } - - if message.showAvatar { - Image("avatar") - .resizable() - .frame(width: 44, height: 44, alignment: .center) - .cornerRadius(22) - } - - ContentMessageView(text: message.text, isCurrentUser: message.isCurrentUser) - - if !message.isCurrentUser { - Spacer() - } - } - .padding(.horizontal, 16.0) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListInteractor.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListInteractor.swift deleted file mode 100644 index 0ddb01a9c..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListInteractor.swift +++ /dev/null @@ -1,51 +0,0 @@ -import WalletConnectChat - -final class ChatListInteractor { - - private let chatService: ChatService - private let accountStorage: AccountStorage - - var account: Account? { - return accountStorage.importAccount?.account - } - - init(chatService: ChatService, accountStorage: AccountStorage) { - self.chatService = chatService - self.accountStorage = accountStorage - } - - func getThreads(account: Account) -> [WalletConnectChat.Thread] { - return chatService.getThreads(account: account) - } - - func threadsSubscription() -> Stream<[WalletConnectChat.Thread]> { - return chatService.threadPublisher - } - - func getReceivedInvites(account: Account) -> [ReceivedInvite] { - return chatService.getReceivedInvites(account: account) - } - - func getSentInvites(account: Account) -> [SentInvite] { - return chatService.getSentInvites(account: account) - } - - func receivedInvitesSubscription() -> Stream<[ReceivedInvite]> { - return chatService.receivedInvitePublisher - } - - func sentInvitesSubscription() -> Stream<[SentInvite]> { - return chatService.sentInvitePublisher - } - - func setupSubscriptions(account: Account) { - chatService.setupSubscriptions(account: account) - } - - func logout() async throws { - guard let importAccount = accountStorage.importAccount else { return } - try await chatService.goPrivate(account: importAccount.account) - try await chatService.unregister(account: importAccount.account, importAccount: importAccount) - accountStorage.importAccount = nil - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListModule.swift deleted file mode 100644 index 4d1ec3480..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListModule.swift +++ /dev/null @@ -1,18 +0,0 @@ -import SwiftUI - -final class ChatListModule { - - @discardableResult - static func create(app: Application, account: Account) -> UIViewController { - let router = ChatListRouter(app: app) - let interactor = ChatListInteractor(chatService: app.chatService, accountStorage: app.accountStorage) - let presenter = ChatListPresenter(account: account, interactor: interactor, router: router) - let view = ChatListView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListPresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListPresenter.swift deleted file mode 100644 index 56a3a0f9c..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListPresenter.swift +++ /dev/null @@ -1,131 +0,0 @@ -import UIKit -import Combine -import WalletConnectChat - -final class ChatListPresenter: ObservableObject { - - private let interactor: ChatListInteractor - private let router: ChatListRouter - private let account: Account - private var disposeBag = Set() - - @Published private var threads: [WalletConnectChat.Thread] = [] - @Published private var receivedInvites: [ReceivedInvite] = [] - @Published private var sentInvites: [SentInvite] = [] - - var threadViewModels: [ThreadViewModel] { - return threads - .sorted(by: { $0.topic < $1.topic }) - .map { ThreadViewModel(thread: $0) } - } - - var receivedInviteViewModels: [InviteViewModel] { - return receivedInvites - .sorted(by: { $0.timestamp < $1.timestamp }) - .map { InviteViewModel(invite: $0) } - } - - var sentInviteViewModels: [InviteViewModel] { - return sentInvites - .sorted(by: { $0.timestamp < $1.timestamp }) - .map { InviteViewModel(invite: $0) } - } - - init(account: Account, interactor: ChatListInteractor, router: ChatListRouter) { - defer { setupInitialState() } - self.account = account - self.interactor = interactor - self.router = router - } - - var showReceivedInvites: Bool { - return !receivedInviteViewModels.isEmpty - } - - var showSentInvites: Bool { - return !sentInviteViewModels.isEmpty - } - - func didPressThread(_ thread: ThreadViewModel) { - router.presentChat(thread: thread.thread) - } - - func didPressReceivedInvites() { - router.presentReceivedInviteList(account: account) - } - - func didPressSentInvites() { - router.presentSentInviteList(account: account) - } - - @MainActor - func didLogoutPress() async throws { - try await interactor.logout() - router.presentWelcome() - } - - @MainActor - func didCopyPress() async throws { - guard let account = interactor.account else { return } - UIPasteboard.general.string = account.absoluteString - - throw AlertError(message: "Account copied to clipboard") - } - - func didPressNewChat() { - presentInvite() - } -} - -// MARK: SceneViewModel - -extension ChatListPresenter: SceneViewModel { - - var sceneTitle: String? { - return "Chat" - } - - var largeTitleDisplayMode: UINavigationItem.LargeTitleDisplayMode { - return .always - } - - var rightBarButtonItem: UIBarButtonItem? { - return UIBarButtonItem( - barButtonSystemItem: .add, - target: self, - action: #selector(presentInvite) - ) - } -} - -// MARK: Privates - -private extension ChatListPresenter { - - func setupInitialState() { - interactor.setupSubscriptions(account: account) - - threads = interactor.getThreads(account: account) - receivedInvites = interactor.getReceivedInvites(account: account) - sentInvites = interactor.getSentInvites(account: account) - - interactor.threadsSubscription() - .sink { [unowned self] threads in - self.threads = threads - }.store(in: &disposeBag) - - interactor.receivedInvitesSubscription() - .sink { [unowned self] receivedInvites in - self.receivedInvites = receivedInvites - }.store(in: &disposeBag) - - interactor.sentInvitesSubscription() - .sink { [unowned self] sentInvites in - self.sentInvites = sentInvites - }.store(in: &disposeBag) - } - - @objc func presentInvite() { - router.presentInvite(account: account) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListRouter.swift deleted file mode 100644 index bd2d8407f..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListRouter.swift +++ /dev/null @@ -1,36 +0,0 @@ -import UIKit -import WalletConnectChat - -final class ChatListRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func presentInvite(account: Account) { - InviteModule.create(app: app, account: account) - .wrapToNavigationController() - .present(from: viewController) - } - - func presentReceivedInviteList(account: Account) { - InviteListModule.create(app: app, account: account, type: .received).push(from: viewController) - } - - func presentSentInviteList(account: Account) { - InviteListModule.create(app: app, account: account, type: .sent).push(from: viewController) - } - - func presentChat(thread: WalletConnectChat.Thread) { - ChatModule.create(thread: thread, app: app).push(from: viewController) - } - - func presentWelcome() { - WelcomeModule.create(app: app).present() - } -} - diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListView.swift deleted file mode 100644 index 979d1fe6d..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/ChatListView.swift +++ /dev/null @@ -1,153 +0,0 @@ -import SwiftUI - -struct ChatListView: View { - - @EnvironmentObject var presenter: ChatListPresenter - - var body: some View { - GeometryReader { geometry in - VStack { - ScrollView(showsIndicators: false) { - VStack { - HStack { - if presenter.showReceivedInvites { - invitesButton(title: "Received Invites", count: presenter.receivedInviteViewModels.count, textColor: .w_greenForground, backgroundColor: .w_greenBackground) { - presenter.didPressReceivedInvites() - } - } - - if presenter.showSentInvites { - invitesButton(title: "Sent Invites", count: presenter.sentInviteViewModels.count, textColor: .w_foreground, backgroundColor: .w_purpleBackground) { - presenter.didPressSentInvites() - } - } - - Spacer() - } - .padding(16.0) - - if presenter.threadViewModels.isEmpty { - Spacer() - emptyView(size: geometry.size) - Spacer() - } else { - chatsList() - } - } - } - - PlainButton { - try await presenter.didCopyPress() - } label: { - Text("Copy account") - .foregroundColor(.white) - } - .padding(.bottom, 16) - - PlainButton { - try await presenter.didLogoutPress() - } label: { - Text("Log out") - .foregroundColor(.red) - } - .padding(.bottom, 16) - } - } - } - - private func invitesButton( - title: String, - count: Int, - textColor: Color, - backgroundColor: Color, - action: @escaping () -> Void - ) -> some View { - Button(action: action) { - HStack(spacing: 8.0) { - Text(String(count)) - .frame(width: 24.0, height: 24.0) - .background(textColor) - .foregroundColor(backgroundColor) - .font(.system(size: 15.0, weight: .bold)) - .clipShape(Circle()) - - Text(title) - .foregroundColor(textColor) - .font(.system(size: 15.0, weight: .bold)) - } - .padding(.vertical, 8) - .padding(.horizontal, 16) - } - .frame(height: 44.0) - .background(backgroundColor) - .clipShape(Capsule()) - } - - private func chatsList() -> some View { - ForEach(presenter.threadViewModels) { thread in - Button(action: { - presenter.didPressThread(thread) - }) { - HStack(spacing: 16.0) { - Image("avatar") - .resizable() - .frame(width: 64.0, height: 64.0) - - VStack(alignment: .leading) { - Text(thread.title) - .font(.title3) - .foregroundColor(.w_foreground) - .lineLimit(1) - - Text(thread.subtitle) - .font(.subheadline) - .foregroundColor(.w_secondaryForeground) - .multilineTextAlignment(.leading) - } - } - .frame(height: 64.0) - } - } - .padding(16.0) - } - - private func emptyView(size: CGSize) -> some View { - VStack(spacing: 8.0) { - Text("It’s empty in here") - .font(.system(.title3)) - .foregroundColor(.w_foreground) - - Text("Start a conversation with your web3 frens") - .font(.body) - .foregroundColor(.w_secondaryForeground) - .padding(.bottom, 8.0) - - Button(action: { presenter.didPressNewChat() }, label: { - HStack(spacing: 8.0) { - Image("plus_icon") - .resizable() - .frame(width: 24, height: 24) - Text("New chat") - .foregroundColor(.w_foreground) - .font(.system(size: 18, weight: .semibold)) - } - .padding(.trailing, 8.0) - }) - .frame(width: 128, height: 44) - .background( - Capsule() - .foregroundColor(.w_greenForground) - ) - } - .frame(width: size.width) - .frame(minHeight: size.height) - } -} - -#if DEBUG -struct ChatListView_Previews: PreviewProvider { - static var previews: some View { - ChatListView() - } -} -#endif diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/AlertError.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/AlertError.swift deleted file mode 100644 index c7cc4f270..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/AlertError.swift +++ /dev/null @@ -1,9 +0,0 @@ -import Foundation - -struct AlertError: Error, LocalizedError { - let message: String - - var errorDescription: String? { - return message - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/ThreadViewModel.swift b/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/ThreadViewModel.swift deleted file mode 100644 index 1c37f30d8..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/ChatList/Models/ThreadViewModel.swift +++ /dev/null @@ -1,22 +0,0 @@ -import Foundation -import WalletConnectChat - -struct ThreadViewModel: Identifiable { - let thread: WalletConnectChat.Thread - - var topic: String { - return thread.topic - } - - var id: String { - return thread.topic - } - - var title: String { - return thread.peerAccount.address - } - - var subtitle: String { - return thread.topic - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportInteractor.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportInteractor.swift deleted file mode 100644 index c412afe30..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportInteractor.swift +++ /dev/null @@ -1,18 +0,0 @@ -final class ImportInteractor { - - private let chatService: ChatService - private let accountStorage: AccountStorage - - init(chatService: ChatService, accountStorage: AccountStorage) { - self.chatService = chatService - self.accountStorage = accountStorage - } - - func save(importAccount: ImportAccount) { - accountStorage.importAccount = importAccount - } - - func register(importAccount: ImportAccount) async throws { - try await chatService.register(account: importAccount.account, importAccount: importAccount) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportModule.swift deleted file mode 100644 index 4a567ca90..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportModule.swift +++ /dev/null @@ -1,18 +0,0 @@ -import SwiftUI - -final class ImportModule { - - @discardableResult - static func create(app: Application) -> UIViewController { - let router = ImportRouter(app: app) - let interactor = ImportInteractor(chatService: app.chatService, accountStorage: app.accountStorage) - let presenter = ImportPresenter(interactor: interactor, router: router) - let view = ImportView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportPresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportPresenter.swift deleted file mode 100644 index cecd2569f..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportPresenter.swift +++ /dev/null @@ -1,79 +0,0 @@ -import UIKit -import Combine -import WalletConnectModal - -final class ImportPresenter: ObservableObject { - - private let interactor: ImportInteractor - private let router: ImportRouter - private var disposeBag = Set() - - @Published var input: String = .empty - - init(interactor: ImportInteractor, router: ImportRouter) { - defer { setupInitialState() } - self.interactor = interactor - self.router = router - } - - @MainActor - func didPressWalletConnectModal() async throws { - router.presentWalletConnectModal() - - let session: Session = try await withCheckedThrowingContinuation { continuation in - var cancellable: AnyCancellable? - cancellable = WalletConnectModal.instance.sessionSettlePublisher.sink { session in - defer { cancellable?.cancel() } - return continuation.resume(returning: session) - } - } - - guard let account = session.accounts.first(where: { $0.blockchain.absoluteString == "eip155:1" }) else { - throw AlertError(message: "No matching accounts found in namespaces") - } - - try await importAccount(.web3Modal(account: account, topic: session.topic)) - } - - @MainActor - func didPressImport() async throws { - guard let account = ImportAccount(input: input) - else { return input = .empty } - try await importAccount(account) - } - - - func didPressRandom() async throws { - let account = ImportAccount.new() - try await importAccount(account) - } -} - -// MARK: SceneViewModel - -extension ImportPresenter: SceneViewModel { - - var sceneTitle: String? { - return "Import account" - } - - var largeTitleDisplayMode: UINavigationItem.LargeTitleDisplayMode { - return .always - } -} - -// MARK: Privates - -private extension ImportPresenter { - - func setupInitialState() { - - } - - @MainActor - func importAccount(_ importAccount: ImportAccount) async throws { - try await interactor.register(importAccount: importAccount) - interactor.save(importAccount: importAccount) - router.presentChat(importAccount: importAccount) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportRouter.swift deleted file mode 100644 index db0aec97f..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportRouter.swift +++ /dev/null @@ -1,22 +0,0 @@ -import UIKit -import WalletConnectModal -import WalletConnectPairing - -final class ImportRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func presentWalletConnectModal() { - WalletConnectModal.present(from: viewController) - } - - func presentChat(importAccount: ImportAccount) { - MainModule.create(app: app, importAccount: importAccount).present() - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportView.swift deleted file mode 100644 index e7aac0269..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Import/ImportView.swift +++ /dev/null @@ -1,48 +0,0 @@ -import SwiftUI -import WalletConnectModal - -struct ImportView: View { - - @EnvironmentObject var presenter: ImportPresenter - - var body: some View { - VStack(spacing: 8.0) { - Image("profile_icon") - .resizable() - .frame(width: 128, height: 128) - .padding(.top, 24.0) - - TextFieldView(title: "Private key", placeholder: "4dc0055d1831…", input: $presenter.input) - - Spacer() - - VStack { - - BrandButton(title: "WalletConnectModal WIP") { - try await presenter.didPressWalletConnectModal() - } - - BrandButton(title: "Ok, done" ) { - try await presenter.didPressImport() - } - } - .padding(16.0) - - PlainButton { - try await presenter.didPressRandom() - } label: { - Text("Create new account") - .foregroundColor(.white) - } - .padding(.bottom, 16) - } - } -} - -#if DEBUG -struct ImportView_Previews: PreviewProvider { - static var previews: some View { - ImportView() - } -} -#endif diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteInteractor.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteInteractor.swift deleted file mode 100644 index f56f3b6eb..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteInteractor.swift +++ /dev/null @@ -1,22 +0,0 @@ -import WalletConnectSigner - -final class InviteInteractor { - - private let accountStorage: AccountStorage - private let chatService: ChatService - - init(accountStorage: AccountStorage, chatService: ChatService) { - self.accountStorage = accountStorage - self.chatService = chatService - } - - func invite(inviterAccount: Account, inviteeAccount: Account, message: String) async throws { - try await chatService.invite(inviterAccount: inviterAccount, inviteeAccount: inviteeAccount, message: message) - } - - func resolve(ens: String) async throws -> Account { - let resolver = ENSResolverFactory(crypto: DefaultCryptoProvider()).create() - let blochain = Blockchain("eip155:1")! - return try await resolver.resolveAddress(ens: ens, blockchain: Blockchain("eip155:1")!) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteModule.swift deleted file mode 100644 index a114a92c3..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteModule.swift +++ /dev/null @@ -1,18 +0,0 @@ -import SwiftUI - -final class InviteModule { - - @discardableResult - static func create(app: Application, account: Account) -> UIViewController { - let router = InviteRouter(app: app) - let interactor = InviteInteractor(accountStorage: app.accountStorage, chatService: app.chatService) - let presenter = InvitePresenter(interactor: interactor, router: router, account: account) - let view = InviteView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InvitePresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InvitePresenter.swift deleted file mode 100644 index 7cc915aac..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InvitePresenter.swift +++ /dev/null @@ -1,92 +0,0 @@ -import UIKit -import Combine -import Web3 - -final class InvitePresenter: ObservableObject { - - private let interactor: InviteInteractor - private let router: InviteRouter - private let account: Account - private var disposeBag = Set() - - @Published var input: String = .empty { - didSet { didInputChanged() } - } - - var showButton: Bool { - return validation(from: input) - } - - init(interactor: InviteInteractor, router: InviteRouter, account: Account) { - self.interactor = interactor - self.router = router - self.account = account - } - - @MainActor - func invite() async throws { - let inviteeAccount = try await resolveAccount(from: input) - - try await interactor.invite(inviterAccount: account, inviteeAccount: inviteeAccount, message: "Welcome to WalletConnect Chat!") - - await dismiss() - } -} - -// MARK: SceneViewModel - -extension InvitePresenter: SceneViewModel { - - var sceneTitle: String? { - return "New Chat" - } - - var largeTitleDisplayMode: UINavigationItem.LargeTitleDisplayMode { - return .always - } -} - -// MARK: Privates - -private extension InvitePresenter { - - @MainActor - func dismiss() async { - router.dismiss() - } - - func didInputChanged() { - rightBarButtonItem?.isEnabled = !input.isEmpty - } - - func validation(from input: String) -> Bool { - if let _ = Account(input) { - return true - } - if let _ = ImportAccount(input: input)?.account { - return true - } - if let _ = try? EthereumAddress(hex: input, eip55: false) { - return true - } - - let components = input.components(separatedBy: ".") - if components.count > 1, !components.contains("") { - return true - } - return false - } - - func resolveAccount(from input: String) async throws -> Account { - if let account = Account(input) { - return account - } - if let account = ImportAccount(input: input)?.account { - return account - } - if let address = try? EthereumAddress(hex: input, eip55: false) { - return Account("eip155:1:\(address.hex(eip55: true))")! - } - return try await interactor.resolve(ens: input) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteRouter.swift deleted file mode 100644 index 5ef3c420b..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteRouter.swift +++ /dev/null @@ -1,16 +0,0 @@ -import UIKit - -final class InviteRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func dismiss() { - viewController.dismiss() - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteView.swift deleted file mode 100644 index 178faed50..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Invite/InviteView.swift +++ /dev/null @@ -1,43 +0,0 @@ -import SwiftUI - -struct InviteView: View { - - @EnvironmentObject var presenter: InvitePresenter - - var body: some View { - VStack(spacing: 32) { - TextFieldView(title: "ENS Name or Public Key", placeholder: "username.eth or 0x0…", input: $presenter.input) - - if presenter.showButton { - PlainButton { - try await presenter.invite() - } label: { - HStack(spacing: 8.0) { - Image("plus_icon") - .resizable() - .frame(width: 24, height: 24) - Text("Invite") - .foregroundColor(.w_foreground) - .font(.system(size: 18, weight: .semibold)) - } - .padding(.trailing, 8.0) - } - .frame(width: 128, height: 44) - .background( - Capsule() - .foregroundColor(.w_greenForground) - ) - } - - Spacer() - } - } -} - -#if DEBUG -struct InviteView_Previews: PreviewProvider { - static var previews: some View { - InviteView() - } -} -#endif diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListInteractor.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListInteractor.swift deleted file mode 100644 index 0444c487d..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListInteractor.swift +++ /dev/null @@ -1,33 +0,0 @@ -import WalletConnectChat - -final class InviteListInteractor { - private let chatService: ChatService - - init(chatService: ChatService) { - self.chatService = chatService - } - - func getReceivedInvites(account: Account) -> [ReceivedInvite] { - return chatService.getReceivedInvites(account: account) - } - - func getSentInvites(account: Account) -> [SentInvite] { - return chatService.getSentInvites(account: account) - } - - func receivedInvitesSubscription() -> Stream<[ReceivedInvite]> { - return chatService.receivedInvitePublisher - } - - func sentInvitesSubscription() -> Stream<[SentInvite]> { - return chatService.sentInvitePublisher - } - - func accept(invite: ReceivedInvite) async throws { - try await chatService.accept(invite: invite) - } - - func reject(invite: ReceivedInvite) async throws { - try await chatService.reject(invite: invite) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListModule.swift deleted file mode 100644 index 91d870eb2..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListModule.swift +++ /dev/null @@ -1,18 +0,0 @@ -import SwiftUI - -final class InviteListModule { - - @discardableResult - static func create(app: Application, account: Account, type: InviteType) -> UIViewController { - let router = InviteListRouter(app: app) - let interactor = InviteListInteractor(chatService: app.chatService) - let presenter = InviteListPresenter(interactor: interactor, router: router, account: account, inviteType: type) - let view = InviteListView().environmentObject(presenter) - let viewController = SceneViewController(viewModel: presenter, content: view) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListPresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListPresenter.swift deleted file mode 100644 index 69116cc9b..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListPresenter.swift +++ /dev/null @@ -1,92 +0,0 @@ -import UIKit -import Combine -import WalletConnectChat - -final class InviteListPresenter: ObservableObject { - - private let interactor: InviteListInteractor - private let router: InviteListRouter - private let account: Account - private let inviteType: InviteType - private var disposeBag = Set() - - var invites: [InviteViewModel] { - switch inviteType { - case .received: - return receivedInviteViewModels - case .sent: - return sentInviteViewModels - } - } - - @Published private var receivedInvites: [ReceivedInvite] = [] - @Published private var sentInvites: [SentInvite] = [] - - private var receivedInviteViewModels: [InviteViewModel] { - return receivedInvites - .sorted(by: { $0.timestamp > $1.timestamp }) - .map { InviteViewModel(invite: $0) } - } - - private var sentInviteViewModels: [InviteViewModel] { - return sentInvites - .sorted(by: { $0.timestamp > $1.timestamp }) - .map { InviteViewModel(invite: $0) } - } - - init(interactor: InviteListInteractor, router: InviteListRouter, account: Account, inviteType: InviteType) { - defer { setupInitialState() } - self.interactor = interactor - self.router = router - self.account = account - self.inviteType = inviteType - } - - func didPressAccept(invite: InviteViewModel) async throws { - guard let invite = invite.receivedInvite else { return } - try await interactor.accept(invite: invite) - } - - func didPressReject(invite: InviteViewModel) async throws { - guard let invite = invite.receivedInvite else { return } - try await interactor.reject(invite: invite) - } -} - -// MARK: SceneViewModel - -extension InviteListPresenter: SceneViewModel { - - var sceneTitle: String? { - return inviteType.title - } - - var largeTitleDisplayMode: UINavigationItem.LargeTitleDisplayMode { - return .always - } -} - -// MARK: Privates - -private extension InviteListPresenter { - - func setupInitialState() { - receivedInvites = interactor.getReceivedInvites(account: account) - sentInvites = interactor.getSentInvites(account: account) - - interactor.receivedInvitesSubscription() - .sink { [unowned self] receivedInvites in - self.receivedInvites = receivedInvites - }.store(in: &disposeBag) - - interactor.sentInvitesSubscription() - .sink { [unowned self] sentInvites in - self.sentInvites = sentInvites - }.store(in: &disposeBag) - } - - @MainActor - func dismiss() { - router.dismiss() - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListRouter.swift deleted file mode 100644 index f153598f7..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListRouter.swift +++ /dev/null @@ -1,16 +0,0 @@ -import UIKit - -final class InviteListRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func dismiss() { - viewController.pop() - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListView.swift deleted file mode 100644 index e4adb21a3..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/InviteListView.swift +++ /dev/null @@ -1,80 +0,0 @@ -import SwiftUI - -struct InviteListView: View { - - @EnvironmentObject var presenter: InviteListPresenter - - var body: some View { - ScrollView { - VStack { - Spacer() - .frame(height: 16.0) - - ForEach(presenter.invites) { invite in - HStack(spacing: 16.0) { - Image("avatar") - .resizable() - .frame(width: 64.0, height: 64.0) - - VStack(alignment: .leading) { - Text(invite.title) - .font(.title3) - .foregroundColor(.w_foreground) - .lineLimit(1) - - Text(invite.subtitle) - .font(.subheadline) - .foregroundColor(.w_secondaryForeground) - .multilineTextAlignment(.leading) - } - - Spacer() - - if invite.showActions { - HStack(spacing: 8.0) { - PlainButton { - try await presenter.didPressAccept(invite: invite) - } label: { - Image("checkmark_icon") - .resizable() - .frame(width: 32, height: 32) - } - - PlainButton { - try await presenter.didPressReject(invite: invite) - } label: { - Image("cross_icon") - .resizable() - .frame(width: 32, height: 32) - } - } - .padding(4.0) - .background( - Capsule() - .foregroundColor(.w_secondaryBackground) - ) - .overlay( - Capsule() - .stroke(Color.w_tertiaryBackground, lineWidth: 0.5) - ) - } else { - Text(invite.statusTitle) - .font(.subheadline) - .foregroundColor(.w_secondaryForeground) - } - } - .frame(height: 64.0) - } - .padding(16.0) - } - } - } -} - -#if DEBUG -struct InviteListView_Previews: PreviewProvider { - static var previews: some View { - InviteListView() - } -} -#endif diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteType.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteType.swift deleted file mode 100644 index 1191f5a9e..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteType.swift +++ /dev/null @@ -1,15 +0,0 @@ -import Foundation - -enum InviteType { - case received - case sent - - var title: String { - switch self { - case .received: - return "Chat Requests" - case .sent: - return "Sent Invites" - } - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteViewModel.swift b/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteViewModel.swift deleted file mode 100644 index e91092042..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/InviteList/Models/InviteViewModel.swift +++ /dev/null @@ -1,34 +0,0 @@ -import Foundation -import WalletConnectChat - -struct InviteViewModel: Identifiable { - - let id: Int64 - let title: String - let subtitle: String - let showActions: Bool - let statusTitle: String - - let receivedInvite: ReceivedInvite? - let sentInvite: SentInvite? - - init(invite: ReceivedInvite) { - self.id = invite.id - self.title = invite.inviterAccount.address - self.subtitle = invite.message - self.showActions = invite.status == .pending - self.statusTitle = invite.status.rawValue.capitalized - self.receivedInvite = invite - self.sentInvite = nil - } - - init(invite: SentInvite) { - self.id = invite.id - self.title = invite.inviteeAccount.address - self.subtitle = invite.message - self.showActions = false - self.statusTitle = invite.status.rawValue.capitalized - self.sentInvite = invite - self.receivedInvite = nil - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainModule.swift deleted file mode 100644 index 2139862bf..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainModule.swift +++ /dev/null @@ -1,16 +0,0 @@ -import SwiftUI - -final class MainModule { - - @discardableResult - static func create(app: Application, importAccount: ImportAccount) -> UIViewController { - let router = MainRouter(app: app) - let presenter = MainPresenter(router: router, importAccount: importAccount) - let viewController = MainViewController(presenter: presenter) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainPresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainPresenter.swift deleted file mode 100644 index fc52791a8..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainPresenter.swift +++ /dev/null @@ -1,24 +0,0 @@ -import UIKit -import Combine - -final class MainPresenter { - - private let importAccount: ImportAccount - private let router: MainRouter - - var tabs: [TabPage] { - return TabPage.allCases - } - - var viewControllers: [UIViewController] { - return [ - router.chatViewController(account: importAccount.account), - router.web3InboxViewController(importAccount: importAccount), - ] - } - - init(router: MainRouter, importAccount: ImportAccount) { - self.importAccount = importAccount - self.router = router - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainRouter.swift deleted file mode 100644 index e0fc6d0e6..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainRouter.swift +++ /dev/null @@ -1,20 +0,0 @@ -import UIKit - -final class MainRouter { - - weak var viewController: UIViewController! - - private let app: Application - - func chatViewController(account: Account) -> UIViewController { - return ChatListModule.create(app: app, account: account).wrapToNavigationController() - } - - func web3InboxViewController(importAccount: ImportAccount) -> UIViewController { - return Web3InboxModule.create(app: app, importAccount: importAccount).wrapToNavigationController() - } - - init(app: Application) { - self.app = app - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainViewController.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainViewController.swift deleted file mode 100644 index 5fd88ac40..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Main/MainViewController.swift +++ /dev/null @@ -1,38 +0,0 @@ -import UIKit - -final class MainViewController: UITabBarController { - - private let presenter: MainPresenter - - init(presenter: MainPresenter) { - self.presenter = presenter - super.init(nibName: nil, bundle: nil) - } - - override func viewDidLoad() { - super.viewDidLoad() - - setupTabs() - } - - private func setupTabs() { - let viewControllers = presenter.viewControllers - - for (index, viewController) in viewControllers.enumerated() { - let model = presenter.tabs[index] - let item = UITabBarItem() - item.title = model.title - item.image = model.icon - item.isEnabled = TabPage.enabledTabs.contains(model) - viewController.tabBarItem = item - viewController.view.backgroundColor = .w_background - } - - self.viewControllers = viewControllers - self.selectedIndex = TabPage.selectedIndex - } - - required init?(coder: NSCoder) { - fatalError("init(coder:) has not been implemented") - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Main/Model/TabPage.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Main/Model/TabPage.swift deleted file mode 100644 index 2e6e3b43b..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Main/Model/TabPage.swift +++ /dev/null @@ -1,32 +0,0 @@ -import UIKit - -enum TabPage: CaseIterable { - case chat - case web3Inbox - - var title: String { - switch self { - case .chat: - return "Chat" - case .web3Inbox: - return "Web3Inbox" - } - } - - var icon: UIImage { - switch self { - case .chat: - return UIImage(systemName: "message.fill")! - case .web3Inbox: - return UIImage(systemName: "safari.fill")! - } - } - - static var selectedIndex: Int { - return 0 - } - - static var enabledTabs: [TabPage] { - return [.chat, .web3Inbox] - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeInteractor.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeInteractor.swift deleted file mode 100644 index cb76537c5..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeInteractor.swift +++ /dev/null @@ -1,49 +0,0 @@ -import Foundation -import Combine - -import WalletConnectRelay -import WalletConnectPairing -import Auth - -final class WelcomeInteractor { - private var disposeBag = Set() - - private let chatService: ChatService - private let accountStorage: AccountStorage - - init(chatService: ChatService, accountStorage: AccountStorage) { - self.chatService = chatService - self.accountStorage = accountStorage - } - - var importAccount: ImportAccount? { - return accountStorage.importAccount - } - - func isAuthorized() -> Bool { - accountStorage.importAccount != nil - } - - func trackConnection() -> Stream { - return chatService.connectionPublisher - } - - func generateUri() async -> WalletConnectURI { - return try! await Pair.instance.create() - } - - func goPublic() async throws { - guard let importAccount = importAccount else { return } - try await chatService.goPublic(account: importAccount.account) - } -} - -protocol IATProvider { - var iat: String { get } -} - -struct DefaultIATProvider: IATProvider { - var iat: String { - return ISO8601DateFormatter().string(from: Date()) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeModule.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeModule.swift deleted file mode 100644 index 47922543d..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeModule.swift +++ /dev/null @@ -1,18 +0,0 @@ -import SwiftUI - -final class WelcomeModule { - - @discardableResult - static func create(app: Application) -> UIViewController { - let router = WelcomeRouter(app: app) - let interactor = WelcomeInteractor(chatService: app.chatService, accountStorage: app.accountStorage) - let presenter = WelcomePresenter(router: router, interactor: interactor) - let view = WelcomeView().environmentObject(presenter) - let viewController = UIHostingController(rootView: view) - - router.viewController = viewController - - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomePresenter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomePresenter.swift deleted file mode 100644 index 2cf58ec21..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomePresenter.swift +++ /dev/null @@ -1,40 +0,0 @@ -import UIKit -import Combine -import Auth - -final class WelcomePresenter: ObservableObject { - - private let router: WelcomeRouter - private let interactor: WelcomeInteractor - - private var disposeBag = Set() - - init(router: WelcomeRouter, interactor: WelcomeInteractor) { - defer { setupInitialState() } - self.router = router - self.interactor = interactor - } - - var buttonTitle: String { - return interactor.isAuthorized() ? "Start Messaging" : "Connect wallet" - } - - @MainActor - func didPressImport() async throws { - if let importAccount = interactor.importAccount { - try await interactor.goPublic() - router.presentMain(importAccount: importAccount) - } else { - router.presentImport() - } - } -} - -private extension WelcomePresenter { - - func setupInitialState() { - interactor.trackConnection().sink { status in - print("Socket connection status: \(status)") - }.store(in: &disposeBag) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeRouter.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeRouter.swift deleted file mode 100644 index da574fb23..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeRouter.swift +++ /dev/null @@ -1,27 +0,0 @@ -import UIKit - -final class WelcomeRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } - - func presentImport() { - ImportModule.create(app: app) - .wrapToNavigationController() - .present() - } - - func presentMain(importAccount: ImportAccount) { - MainModule.create(app: app, importAccount: importAccount) - .present() - } - - func openWallet(uri: String) { - UIApplication.shared.open(URL(string: "walletapp://wc?uri=\(uri)")!) - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeView.swift b/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeView.swift deleted file mode 100644 index 05609b612..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Chat/Welcome/WelcomeView.swift +++ /dev/null @@ -1,61 +0,0 @@ -import SwiftUI - -struct WelcomeView: View { - - @State private var offset: CGFloat = 0 - - @EnvironmentObject var presenter: WelcomePresenter - - var body: some View { - GeometryReader { _ in - ZStack { - Image("LaunchScreen") - .resizable() - .frame(width: UIScreen.main.bounds.width, height: UIScreen.main.bounds.height) - .scaledToFill() - - VStack { - Spacer() - Image("LaunchLogo") - .offset(y: offset) - Spacer() - } - - VStack(spacing: 16) { - Text("Chat") - .foregroundColor(.w_greenForground) - .font(.system(size: 50.0, weight: .bold)) - - Text("Direct messaging between users, using their web3 wallets.") - .font(.title2) - .foregroundColor(.w_foreground) - .multilineTextAlignment(.center) - - BrandButton(title: presenter.buttonTitle) { - try await presenter.didPressImport() - } - - Text("By connecting your wallet you agree with our\nTerms of Service") - .font(.footnote) - .foregroundColor(.white.opacity(0.7)) - .multilineTextAlignment(.center) - } - .padding(.horizontal, 16.0) - } - .edgesIgnoringSafeArea(.all) - .onAppear { - withAnimation(.spring()) { - offset = -(UIScreen.main.bounds.height / 4) - } - } - } - } -} - -#if DEBUG -struct WelcomeView_Previews: PreviewProvider { - static var previews: some View { - WelcomeView() - } -} -#endif diff --git a/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxModule.swift b/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxModule.swift deleted file mode 100644 index 9b96061fd..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxModule.swift +++ /dev/null @@ -1,13 +0,0 @@ -import SwiftUI - -final class Web3InboxModule { - - @discardableResult - static func create(app: Application, importAccount: ImportAccount) -> UIViewController { - let router = Web3InboxRouter(app: app) - let viewController = Web3InboxViewController(importAccount: importAccount) - router.viewController = viewController - return viewController - } - -} diff --git a/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxRouter.swift b/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxRouter.swift deleted file mode 100644 index 3631c35be..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxRouter.swift +++ /dev/null @@ -1,12 +0,0 @@ -import UIKit - -final class Web3InboxRouter { - - weak var viewController: UIViewController! - - private let app: Application - - init(app: Application) { - self.app = app - } -} diff --git a/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxViewController.swift b/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxViewController.swift deleted file mode 100644 index c6a2d32d6..000000000 --- a/Example/Showcase/Classes/PresentationLayer/Web3Inbox/Web3InboxViewController.swift +++ /dev/null @@ -1,40 +0,0 @@ -import UIKit -import WebKit -import Web3Inbox - -final class Web3InboxViewController: UIViewController { - - private let importAccount: ImportAccount - - init(importAccount: ImportAccount) { - self.importAccount = importAccount - super.init(nibName: nil, bundle: nil) - } - - required init?(coder: NSCoder) { - fatalError("init(coder:) has not been implemented") - } - - override func viewDidLoad() { - super.viewDidLoad() - - Web3Inbox.configure(account: importAccount.account, bip44: DefaultBIP44Provider(), config: [.notifyEnabled: false], environment: .sandbox, crypto: DefaultCryptoProvider(), onSign: onSing) - - edgesForExtendedLayout = [] - navigationItem.title = "Web3Inbox SDK" - navigationItem.largeTitleDisplayMode = .never - view = Web3Inbox.instance.getWebView() - } -} - -private extension Web3InboxViewController { - - func onSing(_ message: String) -> SigningResult { - - let privateKey = Data(hex: importAccount.privateKey) - let signer = MessageSignerFactory(signerFactory: DefaultSignerFactory()).create() - let signature = try! signer.sign(message: message, privateKey: privateKey, type: .eip191) - - return .signed(signature) - } -} diff --git a/Example/Showcase/Common/Components/BrandButton.swift b/Example/Showcase/Common/Components/BrandButton.swift deleted file mode 100644 index 6fee139db..000000000 --- a/Example/Showcase/Common/Components/BrandButton.swift +++ /dev/null @@ -1,25 +0,0 @@ -import SwiftUI -import AsyncButton - -struct BrandButton: View { - let title: String - let action: () async throws -> Void - - var body: some View { - AsyncButton(options: [.automatic]) { - try await action() - } label: { - Text(title) - .foregroundColor(.w_foreground) - .font(.system(size: 20, weight: .bold)) - .frame(maxWidth: .infinity) - .frame(height: 56) - .background( - Capsule() - .foregroundColor(.w_greenForground) - ) - } - } -} - - diff --git a/Example/Showcase/Common/Components/InputView.swift b/Example/Showcase/Common/Components/InputView.swift deleted file mode 100644 index 059f9ac6a..000000000 --- a/Example/Showcase/Common/Components/InputView.swift +++ /dev/null @@ -1,28 +0,0 @@ -import SwiftUI - -struct InputView: View { - - let title: String - let text: Binding - let action: () -> Void - - var body: some View { - ZStack { - TextField(title, text: text) - .disableAutocorrection(true) - .frame(minHeight: 44.0) - .padding(EdgeInsets(top: 0, leading: 16, bottom: 0, trailing: 16)) - .background( - Capsule() - .foregroundColor(.w_secondaryBackground) - ) - .overlay( - Capsule() - .stroke(Color.w_tertiaryBackground, lineWidth: 0.5) - ) - .onSubmit { - action() - } - } - } -} diff --git a/Example/Showcase/Common/Components/PlainButton.swift b/Example/Showcase/Common/Components/PlainButton.swift deleted file mode 100644 index 1baa3cb9c..000000000 --- a/Example/Showcase/Common/Components/PlainButton.swift +++ /dev/null @@ -1,16 +0,0 @@ -import SwiftUI -import AsyncButton - -struct PlainButton

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 =lOh9alvkvmfTygD z4C4K9l}L&d7ZOeM`<=+Y$2mA439Bx=5^LHs4sK7=igb362M!VnsPwal%hekkm>8eA z{~f*A=6=V#@mcso-PlrX)oi7(1VLo~eT}Ou5}AB60l{#-WQ?iOX;gjScku~IAL09d zUu@M~h3NcoE=hlCp)9==@bW+nUp3godJH7UxXOICrU)ghYOw0E9lh(f)@!YevjerO zeCs1M8kB72`fiFIJ_Zf$nmdx)=i*cB;uX0^=O#B47*E)EyE@L{+RP>tn0H%kRrEpVoY z5(suQJ733AxTX}Z+HUFg=kRPkt(-T&d}0*aS}h0P`XyBV&gLq|tfV?K&~$0)qw1w2 z$Ws78C`z?lzA*-LCtQn<7x=iHUpQ-{ga?BHtH55y8*C4uE_apuJ4S@X&6!y&?~HvL zcZ6<@#npZ@TN8$Eg_<90yMwRRJ-a%n&D>43AWwU>TSp!vIpg@H3l}vr=(xX@Pb1rP z?bi(~L@+Xo>oVausJa5@4@595WYunJc}MrU5URGZlF2~*^Pm~d+@j`2=jg2DK66vJ z+puKG*c_MEQO8_k?t`^;sqNK{JAzY}lb_US{3X20D3D^}L0#^8AnEvOdwO0_hJ1mW zTjdnXK6k=%`SU!kHr>ud2rZWWV5dz7#4vM-OMT<*Bp;ljM)GLTEZQt9RS@K#)HjpmQu znqY4}bgyz3(wFGe!4c52v8|36%ou$z^)PCLiHv|~bxEW}Vg_q2mpl-ozizG%6-(ty z1MA-Xb%PyM8h?apI@s49&TsX+j$>+LTAe4A(ydMs0$!$n3FQXk$Ud$`(WnAtooC>y zoK{!)n)`|qy*1R>aVzZc$!(mNN;S6-CP-i5X2C25Xh#lJR7hWs3tnTx^(KC*!FUuCNGz6&{x&%<>*d| z9)1(ZL71Q~{pOc}`o`?i6SI2?6s`iRz#W6@=o_B0)c7e_`P-n34S4LO;hbU(HE-ln zz+^5fH2VzM@v%t!_(QP#)#mprREf^=zLLUJgjeVU=|t(V1uHX7c~hnZs=|NBBVq4l?AV!n8*O0wT;5X4HE8M)cc zWeTfnW$I4!1IjlAVk;Yf3F^_6VdB~a;5y1E?6~@n&j|FhVI?K(Dnv2?sWzPe{z%nRD&5P~PIyMlEXZ4UdBt)+k z));65jL_oI%Z9G(F~`olF~_>bVtaXV>NUhn466N!EW3P#ex2Vp5v*lENX58*2tyZI zZe>MF&;QR(xIRxPBx^=>vS!9YxdbaXfWf42bSWCxT(a*@5M0ekYt* zBg3?RuLoy>1^ol?~_x6v;dhO2~QS z-s|_}I<7bswcdlTeI*|}Sez)YmNy=xaq?aRn3>XMVobdmt-~JuorND93$VVt;clZ!fz^__-=902&gK3ap|MNPXrcxk2fCO+3&L4B5f(t zUgrOg2QbOz_J4}}|6Pv2$1aUn*wULrBpP{xet$rsEqnyT52mUl`UK!LVZgbsI@*>* zaV`(BQRlEvo=fu|P7=TTUe8?195uPh;r5sroGr2yZ6G<8%&lUM=AJ_7GhenPgvsuR zBBvT%s;%nnFdA;n42qE>tYliq)fHyX}fuANA!X-WP@OzD?C7&1> zDK-I94D&FAvQTg{{&)wyIR5hfeFjlm9)eQELJW8I>~gfZp3|`)2_OSd>NQC8vlY}^ z%dSff^lj946v&KRSMpn@1~{r;6x{pptqqJ@tPGu5@+cMwSw7~T5thhdk-(JwALiaX zo~pO~AB|K*nTk-xZ7L!{<}o%hE3?cpXP!bt2w|Hklqs2qZJU)0nKNy}wkh+p$(;Gz zOV8)|KF>M7@9Vr?=dbfey;@q(3>HUbewb$he2FE8q^Gd&T~#5)ZRTHk0+Y6qP&wu^+vT^HU6C@T2Y?s)^CUL zTHhoCd&$&kcG>D})F6*TQV#>f^d(iDlQ zHZPb8!AU7@h8_N(8jrWn>dpDBd=YkD{NcqLD4HgwkQ;qlZMTs-BKvyZ*d<%hhaE3K z*^o@;%a>s=#UL_{K&i6uIUH*0>Rqe)9TUEYhU2x!@;51W<9zNR+Wc7 zGqKNQy-W|KC+2)#yn3p8yxPXoHpKdFA`A;E(k-uK99=V5XWv>fBqR*P2Yw8UNG6j2 zKZlK~>dIWtMJHi;|3AMBt;~A4~Od`ojBO zafnbkr3KUJT$M`F6-JMI6ABgmyP(y?pM}($Q+CYF&%03v!&h+gUAzv#E1+&;6fWLa zN8EL+#}>c-sHJ+VI_bTb_rNV-muwYbKGysSh2?C=no`9;9tE}polVU?zAq2nyV;oE z?Bk!T$hC~>JrJ~t3g%O{ZFs6_s(z8_hXshRY|AeduO&uHrH8kgv2L^_h4><}JNUoO z^_(BmDz;RopU%_w25PYz!!Q@u%mdLSk3{$9V@zw*MqOPz2O+~`@?av=ooR0t&KI9^ zHCBQ7e68|Z_op4kMZnvn0of#*uDXsZb}pUe^43wQZ=)V2YQ6 zrHBZ6GbGp3{dUJ<9z^?#G_Fj+&#^CWGM9DHb~J9$d4D%h#dhAYe9Fg2v#1FC ziS9q$4|)LWy!TW!d66Bd$CG2uGFB_m=QFjr%s~(gSh(XQ*(X~3l7?MB8sHYnAHLlSci0^${25D90e~&}KeQ#>YXcyOUYSkscGjnx1V@P=pwfPsD38Z?kN( zZd-DhW-gPrROubRX$M0u9}wa(sox^7h}FJz^Kk?jAz}URW@6Ki(^2=F)NX4$yUqD+ z7H-H)MbXL?`gwzH@29bgXtadC;3IQUff;>c_2 z`{mCExeIq_J~`2t+_Vz2GPHVO_3p0qafkjyXQ}*%0+57dCZJw?bU(8({hWNU)kDV6 zf$vlywPc$^G-wo-ZmWM=gW5e+@43#N;$B(MD$PGw0F?XCE{F6%6cm;fST2)k7pu5a zWb)?RkF8je`&A@2!dtw$0X+?SMXv2w+;B>t8$+eoE5#mJv1vDq9FOS|h2#0q+9?>0+8AL}m7 zmn+Qx-=0s=(J`v1@J-~8tpt*x3=-ZonR&YKmTE&)jtl70!moNO1`J~=*h zBbw4L1Qr{3Q2w`hfp@it^LRlER_e)5QaGaXzLQTkbA8Zp_+q3ACfxB zc~u}h@wFR|E@zZdJo#5>B{VfZZ-rOAe>bG8_Hx$mYw6I>ft|FD3qFwAAP5eA{dIc!48N1H_XDr`cXd3(g~v>R#G;*KE$-TiuUFim2?| zguQT-i|h7ce<{vQbECiJn(5j9{t%||I@)Oe_NVhfmseM9%Erj|%zD?Gb`G88yKS`L z$ZDv+d*~w2LddU=k(UEsez{XpPr=4#MtZM|Jb+`};?s*^9g>iI-UMK+I%Dy!kyoW! z9Z7hs>N3WKjeV$Ae6K~D<3=nA7W)FkIo|m?MYwa~Mxt}l2I}2Ls(_%So~u@(z~5!A zLd$%6B0vn50k94?*ecuUeG4(KoRavN?vz|}JbUBcaizb`Idy5M!*hS@GU{l(c8fRT z0=x#lxY>0MEgP9d2B*?ayO+38HBr+ZWLJTHEoX)+iUxKb`4AL4I&3_~$$V+p>J?oB z_?5(zbWXa-_q&K_b=NFDA8DSjo`;COWBGG+tinOM+S!?ZF7!*OCjHi(=w>BdMPSGx z)8sq((`6XRwbPudCic7FunIG?o}O_7=nTg;0_5?>rwhhIq@-T{#PmrV+B3!_i*;cG zKTaq<-Y+PTyR2n;8@w%9$u~o+`U`sZCA1PB{A==rHSN+4) z@@IZtx^0Cjb8h5REx-NXi`dlzLW80w8{I~nz za<|4ms3;|oEs8+LoVU=mab(XS)K5`Jh{Sbb3oZJy_lz6>15lg;0<8 znt3~i;G!(&rVNfM1;X7(@_TxSE9M3r4ZA~krI&m{cf@?JRU&-oEA1JLYN5|;6pCDf z5#Zx1@^zT8*$AQ9H16KfBg>CWZ?ec-===gk>IE6R=2YNNvicxLLN;05g)7>)ZWYVy z(}oBPBH^99x28t|Yx@QZY*~*?OX&42Oz|eSyBGUO0fva@V*0TI<#>I%-4&R~9yxJa zAsYIv_TDJ5KTcSwQTmkrKK;E#<~@s-LbDujc@AeWms$ApxzaBa)vjVkzrTG&C@STJ zT>^y4B)53!&NV|jlNPHG=^Yu+u@SQo>s-$7N^fVmeBX`@J>X&;XU0lUdkO3a`>Jm3 zHh~PU6s8B)!Ja`v$@2ALhWC7ms!I9$l+4Ff_pa%SD~Ky}NbPl;!!sXiOcmP9mHS}w zK|3XfLWwHS%3C>LbGE~zKR9TJP$}nt(M68$M>Vj(t@;Vh5gT2CH%%Uyzc7DS@kb#t zAo5jYXad22YOi@Uh3nI0i=J*z^pDGh+#yPYZct*Wmed!kM;MG#1oIkOd6}RgjbF9* zK7`UQZ_}mC&K7K~X>o)!lqQkfFCqD@`Ld|6r{^1-^{qS?YXWbDK65%@Q`XCS3_lyC zZ`B7o0+i61h0Cg9S?{K3kVq z^UyrwqLHF8GenJgDVlYBXN?!QR&oDp@Id0D`hA6b7KVMrcve$ZDVcp1*7a`_2vv?Z zN*dw*?2a~#Q z^3(Iu^DHv0fy=z4QT@EX^bfNQD{nrTOS<-Djm1YavtD4nd1!ERlJ->%GG)&2T(0HO z^g>Gd<}CKEm&fa__XkqSzP7!Y{bNc{8Fg=|48)wyozwOA{O`Se{B4;-JgIEg@=AAu z9%Y3f8>yY;nSLh)WE*aGRlgGqw8_grC8#^SaAxcS$=cYpnxj2;m<&G+R`^Mh|*=68{ivXKgr z%0?Szamc%N#^cSj$w*!pg`Ih;ETSAnung4@@9c;T(E^G*2snAc_%>NA<%`}CZ%xHq z{IQmIsVM6sOy3r$#uHo^@Z8*3*Gg$2K?KE$6Hf%p%1c53N63)Xowm5 zAiysG`IO{E2h`=sYh`4g3Cp3(QPhyve%uzq*k&Y>*M>y?GX%uVk)ZBQwVl#S5*uje2F#rVF^3f2H`H{v>l zrQYE(3qi1y9~5FWW<=|=1C8a>bnG#j(`-oVW zb0)OXqse-rX&)W?sqs(5EIY~({{KZ(oaGmEdZ7R=hiyd-{jqA-B1*}ur*k|(pb#=; z+lGM4cP6a!5{Uyn2ur)@a=-S8?-|nNx6m+QvRf}g%&ZTr={78PN`D0 zxYDT~FOYxsBJ|LUtfzcdkjXrc-*hy`g9&4$^6ThGcdalq+xXHP$QZVSdQ|nil*K7i zSKFky+brneMN4>|>if&Yq*M$;56#MARinWSr3ltZD^8;G|3z&zxe=wpjDeNgjhNa9 zfg9lhDMfv{1!Y#|xHj6mHYye?qN1C0bDyG-Om;1mIk83TdIq%4EvZ_N}vAtoAntlmOXiO z%?!L-?{_A&yOnpko1${@1!3!=@2TViVFEBaMRYtA{QP(U1)Gi5#q`91j|g;0ezPqt zNS=C^nwSYiWt?p1t+i4=CHYFOC-xhie`6`$*lp35sXF^P+139LpP@98(p+u!MU?qnW(J@z zK7`ljFqfTU0u@Y?_?k0|)9fSXT`~O_d5?bWZmw2Q9?S>wx^W4gBa~bvjpu)eN(H`6L5#+8A{~P;gZDYxUPZUmrAkHCH$P`3M zJ`8>M{eh%$v-8ecp5$@9??x*%7EFFwPxoCD-UFqSE#h0<{A-~4r3`X9K=zdFd?bIQ zP^4(2O>kq3gt}37W1J%Azw`ucP2mgY4ACWbuXA~Yyi7(;bGAY;cd_d z^&L!`=so@&D(MFL8QtLEeA3;z_notv#D2D@-$A7>h@Y|M(c<&;e%l&*-&vxowenPJ z7><5ka#;Em%HTmNz8xd#y=ehwSAF+9`x3*8QX>&C5=@KYA|f!I<^0mA>ETq>sr$+L z{;AsAOOd3Jl#$etbdd~^ERpPycOrQN(Y$NCC%jiJ$wwoflBq^oN7_X?F(;?mn`wET zagaE4NFu)dHGk}kaPkT-QM>hD6*{J`1nASqO3T{FddsHB*2pf&N_T56?q3NZx4c)x zk&1Zs<|AhWM`TCv<_%>vv5nxfH#$fP96jY3L7XmtLI5cR((0-Ir|Jr1qCA&l5Ns-lr#)9?EBa@)i#YbE!>TfmblNgXBu?zBG3@-=ND^ppnYW0kem40 zd)$@LkR_VFBB~V2sib@J*X~yV|AI>)st#mjkZEy4k&Nng{CRfo=M5o;LJP5+sK}DY zihr~5r++XP&y@UqVSEn3YS7a{W++Vfpv%A`o_Vr%ruM@PdCk!}1JjXX)>k`s&qu~Z zCV^bW?R)8|1w5b{{*AirX1EUa>~lP-JT zIOFxsv~l(zY2bo?5~49Vvbc%Vb%9>W(0U>vM6;r|@vkP&+=Vzpysh@t*=Co>yl}{o zal=tBEk^0v5gZj5;Nnj50;I;luV7aX2( z$Zg07y)pTG8xnpgewODaNBdO|;ME3FjO1jy-6{OcG4+q78t!D;W~9ejWIBW7{D>eQ zuaMaU_D0^n-{*%O^!ccy6aFDKKsS4mcAaAFTFVL};VPw?*oSlD%rSDAP__sQJ5Qz% z`7N?NvTJ_rwL1km>wiAlKWCeNMd&Bco;#T^iiztX7w*8O-QJ0Ms&<+SaYmQlwz*kA zA+9XmW&8cyOj)a%*}E#0t2dhd{X*(QKn`w8t62UO48~Q$U>O;btMS(+eKI8c^a&7z zAT15CeJBV3p#(OFf=0(wAcyblH|8L+7`DVeJyW!^g!NEz405NOkVLDgZfT#|Fs{Q) zcS!y|gpLMY%fRoy#rJaKowL!uAL0#sgm`MsIm*8pK|w4VI!@-!wW9Chz+zcDJ@H0N z7)pbCPJRcjk$4vJ8L^+I8hN|%E(tGk{c>|rhw)#}ViN)lAXVxFaoZWQK&YWoH$K?E z6LG&?T~XFh8Q)l}br6g!g`V=6`+Vd~H9LQCnkDB<1LT{ZE&T?{dEXE@Q2Bdlh>$DK z9B&!>R3(#jkPU-Qvk-yBfX!Tqo4NTE;~M{}qgiQSu;}CCLDn4Dt8Bub^DoUpUGT!) zrdx>EDe_mYi*t@N8$$AuL&96k-^kxfmjV+)vAzE@>~O}AR{>wmodY8jApO=8b}mqd zn+*ZR)R!T(%^ss>mHB=g^Tn{m-8jAevW~_&U`G#HNSzjlYR)~)t7nfGWcu>tN0n$= zs~mz=bMKCiX4MV}^tSq)=Vo5;Sy61A+Y0>mHW7f_N*_PC{^bL3qyP$uzcvJ7U#Q=f zV^;Jo%Gvx}%lZ@%co2)n5@#`tIzwFuJ zXhfd%2Wu$IgiZnWXaFWnSV~KM=09H>544^mm_9%Uu;3}xQ2v_Z3S?l_nbWXOV*wl13nR0uh8i`v;KH^t~UI87dUN0?(^N$ z9bYi_3bHj_)%7S-`ThoIQdmfHtkH+l!XWjtD2AUywE?*#UTGxKK|3l%*Q52(q%>`q z4NVJmr2m5PL`9;XCYJg9nc+&ro4+zoT8Kzi8^{2U6=`bx*HimsAiDS%+ZI8r&Pa{l zO0{7XCHIJN^0sTCbqH&LL**fu=4K?%m=n&ihSe(TYStcsD%xP@y)77p15B`~RZ6!7 zFU_U4#4G;QY0Hq>a6k4MdT>SnOTudgEe7_mNw&C6jw?Iym-foRsl=we`}ok>MnD_OR3fzCo}L2b z7g9I%?6WJZ`*t~)!;R2{+o@GomHZ_)zi6QRN1h1z_V5YWjEM3u%6lQGn9+_em;Jp9rSC`Mc1l}LxO@L-J1E!G`PmmAk*j7@aH{scX2wrwCC*T`G-WT<8Xr&=?*PAIYH?2ApuX2)9occ zU5yjCGT5oa1Ci*I8n}k$i44C$VFHp?JlEV$e!z*Wg zH=0BRKSboF(=U-E(QL+F=hzYO`>B30s^MIzgY|;e&X#=XXheP�{qy5q4 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 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalTests/__Snapshots__/NetworkButtonSnapshotTests/test_snapshots.1.png b/Tests/Web3ModalTests/__Snapshots__/NetworkButtonSnapshotTests/test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..7ed37c9e67803068dceba7d87632af66666952ba GIT binary patch literal 138687 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 dUVNBtG=s#45~3$Wf_wO?XBc=-|g?;*&5 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%0A8^g{Z(-_y@)00w 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%0AKCAJAI|AJk(S~Kfmqig1d%3=WpIu2SfEx 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 E0K3+KRR910 literal 0 HcmV?d00001 diff --git a/Tests/Web3ModalTests/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.1.png b/Tests/Web3ModalTests/__Snapshots__/QRCodeViewSnapshotTests/test_snapshots.1.png new file mode 100644 index 0000000000000000000000000000000000000000..bab3e30e473783abebac9fa5ec3aa92d4438c0df GIT binary patch literal 442684 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ⓈL(Ibipb`#&gaMyI_LzHB(_TjT4n|y{ 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%0AIuU9kgJ) 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/Contents.json new file mode 100644 index 000000000..96435ba4c --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageDaoL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageDaoL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageDaoL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..e9ee4f19cc8a46421c60a2a8a2ea1fab98d6c3a8 GIT binary patch literal 2311 zcmV+i3HbJjP)m}qNEG@?+D%Y!d$H6}z} zAW_r=!^IaBmF0!-0E)C~cn~%rF@aE8XluLOxp=;RE}h-Z%+79imdlq+_TQb$&i9}5 zpY#1^{*fpk`nRQ*$x&LZ>6DU)QaU~*YQa7opSsZw4H6AWIt_{c(-1_nvf1RHJSt))kSYmUvX6h%EC)6p>`&rT{)9Nun^JGfT~EtK91ve^>bj zRn=)i(RiPp_6!Phr#lQTk9a9_eUq zh=lH@VFB)bXH22Iq8)1Ao!#u*SLCO#Y$6uvn30U$w`2hs(e$Ah@o?SfQw&zrW zc$CEw3n!r#Wt~=sCMt&6qDSB6PPk%|E*Arwuw0q`?Gx7knxB7{szHoZA}hnyGPH3t zOmTrRcXFF;X#~C?z)%pbj84P(j%#3FrHHaoHHlI%?J_@iE{jK&5UtxswD}vNt=}8% z1y2_r1Jb86q6rr*XJxpuP3nieuGgq|ct|283Bpvh##r&PK@g-Z5@@gKHugCIx8zMq zG))FU4>YguF&dYDHe!PF8ht0kHJYBQ%(Y=u%V9JBnf- z$UA{x#_$U~=#1!`d4?;W|9a{H_>El~*9e*_0jMuFaZB~l%5>Y&(+31$?iKeCe{5Bt z+$WBVTEUo97^wyu zzT0kA>Xwk5WK1xeu;n92^qr)@xO75vD$a%M41($j!+PhBh$bc%t#5rNw#lG#WGZ3S z)_`-|7s*G63pc=_2{)6{v77L`=NVaCf(0iQgAI zW6Msz>1g<+NQ*4HB!ZQ7Gp_Q{4Im45#&uS`?tV-KvNK%5$km%Z75NxsF( zASCLNb(6ortygVvPj?tf>}lm>XCRk`f)ZgLJzXwk;203a&6(oFB5S#_Eg!wkXZI9D z-H0t+Zv;OKfty$D^yoa+lAX2yazNq&mp*q!g8Ts2t7b}ujvBjgOl($Z1{Rpr@wr{a z2n%|Cgl>J&QB)GTekUKy!WehfEGI}2Pq}eLMB?%OpImEDJZlLZ+PJ$C3}oR41+ehF z{lF*$RGo+6+70c`a)4OE0cgHGCc~&p*Af*I22o5Hyo&O*u1nV%6%n?I;&y~JbD#LM z(p8P?(zQn5pjAW`Qc!5S)Yl zN-LA-0Bjh)<~&uvs!Q`e1Ti6|r$x^z7tV}+Yu&Gel2SNM38b4u3RVx^!Tw-4lbQj zea0|uPKX36zdBKax^%r@j$yViXIR1B1E>u_840zurpwUL&VV(Ix^z9Ef+Ch1W4&=f z(|iv`nh}AZ^@gHq{A`$AT9fEZLGe#Zu(Cb1LvG#F>;0_937@)jy#bDF z*E8awY5$J&;H+e<1?!poFlD_J^fe@>vpyW4E?sY6$le^8$hGgzwizq&h%#dZb!R!k zxZ%Nr9g}tHwv~3|b%R@7`fgw(ufUzfvlu~mLZV(>(Ylk0R@TY@#v!6NCIJu`u(-2` zSFSEyPr$n41ua)7&UPNd6UgMPj+nkT@ z&1SeaGQ;C4Jt(+6rf@paGZtCE^%a0bOzxO@AFqnn#VY_R! z21X0yCrIv9;FTV@@wlR9O34DACcLyQ-6=EY;~nE!}D(`f3Ed1O+vrh!?l; z=2~WAgnF^m-|ISo?@}xzS7|kt;PTgH=E*5>10-I<3-?t#p3Cz8S+C*^asTEp4}e_M hB6OyGSFl&{{s*q~I7j2p(zyTt002ovPDHLkV1h4GR)GKj literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDao.imageset/imageDaoL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..e33e9a6f6a9c77c4109d72402c3b5fa187489af1 GIT binary patch literal 4669 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/Contents.json new file mode 100644 index 000000000..fd8075427 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageDeFiL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageDeFiL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageDeFiL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..1a559a5c5fc3681a8b6b6042971be421e9704f1f GIT binary patch literal 2052 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 Ef_z2ab^rhX literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@3x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDeFi.imageset/imageDeFiL@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..711902f39769a9f4d9fc3581c8c7d47b08b7b1b0 GIT binary patch literal 5969 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 y literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@3x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageDefiAlt.imageset/imageDefiAltL@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..8cb79c0fbd5371c1ac937df4625987273a9e63b1 GIT binary patch literal 7180 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 O0000}^6Vp9yZY|GM0t6k-Mzr3DG-;a3 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 FV1i0GEBF8a literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/Contents.json new file mode 100644 index 000000000..cd0ac63bc --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageLayersL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageLayersL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageLayersL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLayers.imageset/imageLayersL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..e879b9c10edac54baca96b331e5b3dc99c7bcb24 GIT binary patch literal 1932 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 P00000NkvXXu0mjfAMuLr literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLock.imageset/imageLockL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..ddc550f8ee4db87fbb21749d7e4ed4c3ca4b8a03 GIT binary patch literal 2711 zcmZuzX*d*&7M>W{_hoEj%~JLhvW?wXqG1e5GE7;ri)0^b_MI%#C?rc`ibM#>ma%5C zd|ASbJq97`)sOq!=RWuTIOja)egB*v?|Gj$@s@=#GXp;Z003Y%ff`ty&)~mBck#U6 zK&gzL4|-pyeEpb&+@Rpf`2uv+y{QWTyiI33M$!NP46-H$ zy71r&8yHJZ0UM#7$Wu;@_utgKb6)2r#+LBKTh^=4Mz8yC}QatspV8KD(?RGHBTln9ujhdHCx| z?-}lUFAG>Rp(Avg%B%0-YIXb-CN!wixPu8P#oQKnjh4S zcVu?1wQ6c@Jr)V`S28K+V!{N^14CKGHa&k0|LT@6h}xslA67oo)?aD5mI!D|=+Ph2 zHh_d3#O&!kl<~be>{eiRDv3KEVP01%-o&<}* zEEb&~r2Ks9>c!GEWB81;b=^c63`)2p-CS7ivXmAWj`-(|yTmqT6}(qNRHP^RXEY9+ zNN%)}_M#Pp(`4n3!28Vysn~l*O>2+wL*-}kzt=OXlMqy;1Eem)%GRAdu*dO)2u#Pp zLGithhM7#rKNV*Yg^%DA3}d24`)vn~HrMy%nwHrs@~o~s3Caq59v9Lo)N92PogD0P|#J}Ex3(&Nx&*Uf=F6e;Auk!a))H#Q?fLU z*BaUImXVwMJ!LWNUu{Qtc_>~&rVeaus%PoPI`iA8(=6m{mk+RGld~t*#TrbaA$N5x z8rF^`XC<2?!#W;UAYM^HIWK>k2TCV@Gii95ipb|xD(H&^4!O`6hum2q=y&JnYd zU9y#F+f?1 zxjbspcr7fGnu^$H=_QK~-3t{!U}_;ODmK@#tI&KQtXSq$fn z{ybr4us&({8rFg@o4YPZQFC%j zA2Nl{$bQ4?EFbUu!8vK~){DMNSyktv4!#Gejh?5Xvui@Eghayq&`YZ1H?NTgspa&7 z4OrVtZ8c|~9TJ3I`x$YMQ-?DgZy=BUQn^@LF1E?idYBlj-DkZmILf^3Ef?CDvQu@@ z^9o^^?D&i*V8an-n{^T#;lc-H59Wo`e$`q03gYHqjz@%P3}KaFbfCZJ>a_-btpV=^ zjz!fxC0YdsC&Ji42mR>VT`Jz`kb>!M8k_5zs@k7qBW%nMBszx>ed@X~968l489xNu zi*9Dq9Cx2i${(cew@pc9(t)0-8X8OZwmE=f$m9&>P1U?i4!vORfe+&ErtlF=+0_dX zO*c@ZQ=2uSs2Y4C$PTU3gbWDW?H>^3{6s%j$M;mHu|3gzDXf}6ENMSUe^y<3&zl9K zBrhLQ>;P`{4_Hpg@xx>B3DAYb)#cnGaoPH1l;MC{lX?h=Jk0m-u9DyaP^iM>sWVhc zU;#+Z4rbLKtMk5!r#c!Agp~<*(-ZOzaLjFAY)@NiHeNy@DeEZa&?Rnm(Hm9HW$li6 zd%7cXQz+gPuq4uCSlE`xXkb=ocRiF>i^b>;L80oX!}S$nK&adD(e4^wa!MYYdx3@w zBA&eF4^!aKuyOzQ2l%1`TY9|VTm9Kr2QhLT=VqRkVeqLAsBxcCZ9iYVJU!?kndA$9 zUg8d&)ZHi*>7Usy7+3`BfW%v z;V+mzE&=xAUS(Hg5gwLts!1VpoPJW3f`1zFJXz=!vGcAnYz2~s=(q1|gW>E@KFJNw z^+zp6|441mL~G)!mQfnIE2IF|K2tww!@22!Y24swkFBh6s+tz|pbz4(f22ZQJS1Y%`(Vba$`U8KPWR$^qMuA2eE#ZO93tBl1 zKLTzbCHPceXMK9Ly9e3x3S#VYKJksc$t$i$*coE?zt$FW8GOXxY?E2 zFGk%5kDgb~)!9)x`s_I_cj4Cc1;M^ceiT;Fz0XFHmruzYZ;XBT5r(kd5l^g!Q2FK#EMujWs z?Ybw0_MoxE_Dq289P7Lx(#7a;4I@m+?nn_UF#n>5Q$L%5#O!H&b^qeyTBwQFv#QR;pE>?_J1gf=6{~~ zg@)LapJwtq>lb#o!|L*sO-sT^=TFsy7t=*AK$%OL&Qf2(*Tb8Pc_1gjz?IzPn67bo ziP?5huX_5WbL&C#AZi&X$2#2eogci|<%X7>qV_9#LtdS# zco>&Pw<}|LuW6BI4KzK_)B94q$ju*uAc3D6 zLT}QgDk5<8-nkEF&UrWwyF1@EJNvdf-?y>GhFUaKoK!?aL^L|u8m510!{4AF`;(PM z$nO6sl%(JR==|MVi%-Y@+E8NV`a2hC9z^X(ujycouJh7fi@IWkc;*FHT zMd(fbH+m@(Uz=Ynb_86&BDtZm_3mx3+UvWfuXD>NoMI8)g@!|?+96p_PkLs#oNIvu z?kAz{tAxb&=GYqP{d~}?v0VAd>36Z)1ifjPb$!7c+sR7nK57+|&5 z=0@$P#A-Nw17c7|asA}3J=tU0ajRY+t4VSz4?<%kcyX1shR>S)6FpEdni7N+?hnWLIX=-EZ&Xs3)<5A4wokU-Vjm!LVCHq{bRGIJWVRrjYK{^9p_vrd z9G_o0uj=Pz6&153`I>)n!(irT z#h&jkZt4^Q+{uv(Zwq%tt(@#x7mE>%ue*J7^Fx1Zg|J0=ydo99VG(dvZM7`1b2C!u zVnfW}s}bWW^#zWWyWL&Cg&kIrxoy^JS$LG`^iH|L)TvV-zi%W_TSN^jD0$faqV4ss zx{wt=(WN0HyWBDjd42-@Ml=RZ7xqX&fW3OAz4Nw4$Hlpu-l2SWH+D+gqr1+cP;Hfb z#qdg6XKQnuxxkZ`liM9LQ+4p3@mNXh8>l0OLv6td&meHZ71MDNphIAsC7~(cWwm(x z>eAL~VzCc(MccyRX8&r&_o`8S;F`ITZ7J;hY;vcW~QHCeVHQ>V8AXW zm-^=*U5z4o+c!PX;4oDn{YCndwMmA`#zDVYW|4-j7DL4C6BF9V9zuTt<>E$rj&A?6 zh|y5@^BYz_#I{`BUo9u|0Id77oFtJk92u>tIt7aqCUzf^@SXXXr|KdaPoU!{1rL9s>*6*#Rzd-1HPIT~^3l!YacpTs_t`@B>L9Nt8Q$x;Ju@CFiLkKmXGOV0i zIQJqq_z1)23D7N9a+{N%3KUEL>8MhaGeYoJieifQV_OXiIFuBqn@QYNHY~rnFq&dX zFUZp_J=OF!@0-e`QE?_@ASjTOJd6o5F29aGd1Fi!Xz$j07@+Z>qlU;HOPpcev@}LJ zW@grLdtnX`t%y+AMW;T0dP&m6iN8EF6`Bqr{KQ zC&w0Z{Op8@e?x>-*cgc2I8x3P;Bi-Q?{t`<$U~Et<&krgyGckoQ;ZnNsFM+159?K5 z!XpotMC2GCD)Qbao_r49V4f=%QMjaJzz$0c++WV$(K+M9`v*b5mNF0R6i-|C*<9+A z`The~@Dr;FiAxdy-rw=6p3P4^3f&n=GJmAd3;9VR{#pCD4!!L3WGF5O#f!*W; z^z6H4-Qx0qnkYj<^k{!Sj3K{y1Yw`GoTxgeaCv1RQ->cQvEhQe#b- zj{caRF2nlV$0;VR%Df}AY0kHO-4jZYi1ye92KZ{UDfx)3pKU6M+qozA1~a?gq2uel>9CDx|RT{iYY{Ez8k=0u=o zvuEA6@^pQx=Pxe?rE8mATMH*F<#WoG3uwHUfRrx8mMyku0-K!3!d+93YT-y8v+SH{ za`~hv{Bw*VeeHWB@K{#XW_d~x5sBgdUTxGY-2J8;%_s}*V{|B5oiar|;bkWwU|#G& z^11Z5n5A#7d#d)&#?Knd3~b#3Gx*jIF;IZ}*dTOWm?kS@n#j(hUsUM_%{2wpC?wdG zw@H0&Wwse%j4zPyX~;gLT%@^afE+9f80coe*G-9=9MjlVe-HM$lu@*p zH)bk)*q_1lh|&ZxG5V$KEL3&gC5^I4J>+atU@dy_=QFF@)e-Rh`yn3Lj9ZcJ>fV|* znZ$QrWe&>NFS(^__ITFPy!0j!(96>|`Nfv!M-k=%;APXWY4fFp2J_HXT%}&-_tO*v zp5~d4lkWBT!uqL)A~sUNtR7OBqNp5F5%Ek7Q7Vbvr(_p`*P&g-`_1$!fsIQUpFl1@ ze`8!jW0W4s$KoOF>1r(;-*cScn+LzWqIp73lAq2!xKG1h^QxlKFkdtAYxB8lfE_`2 z_mMYoU(hLVhp8&f5IwJ1a#*ZB+!j!3EDE6EZ$BUY9__Q&vnPX@f`8B42R8E|FB(H{ zn)Ib}1^8$@t(LS%SBsiro7Q1#i1p-?-UK0ke#tp-d!;t~kY2Lq;`M|&v%tk13uvYtjuL*QYpnl0a8Q0R z`g^ZcJLX}ByNy0>WaJs|b+-BmB$bd#^gQS1syekcfym&hwaV4!%_#;D$&7biZfR83 zzM6GZypj}rDw@&hV-d&B`hBSOcEh5r2!M zEjI^NDpgR5Rucy`pK%NFKp8DL_KeRy--=&h?p#ra3#Y;D{$PG)K_ z>qG6+3(fff9I=vlf9K8{`BvKSS!QohvwBB=7~LC8fAA?~W1J?h52Z{ZY`5b)m{oB= zh&Y0Q{t|9cmh$0%9c~`h6aJobkQ<9yC+f#i)jS;?08j4t2aQ+h79qk&_lWDL3SnR$ zbKeKQ!%6p;V)Xo0jQU>CZb$XV_oB`iT4?qnk0Pr)Qf+Be5a0`HwE!4+&vnoaic==G zn~6_v;m;O5Z44>{GuHy-PNMBD2M9{?# z|EzfIfHTB_Yda{DhYr90Qs44@OaWIbvkm?-`;*zNYUt1cNgHpcU`L;=m_qFsUmtO`WKg)Y6TwOaA9-?;gibS`Y?=abc-LP%bv z&hIl>Ig^g+uY7lC=Hz_1qTJiY+Sf2}q6k>?tdXNF*^*o2cr;mSdhY76yMi~dz3)?E zZVSf{_>pLy-Q_;HE@|iKR>tZveUe)U1ovnlk|Ke3iCRR#=J};xyjhVMPBz=AtATgk z>XL+jgdY8L7D$Acp@riq?lK|IzsV8nw?Rbos_q_ z6ed6Lm&vV)vY%eT*o*EFNjfY#Q0IQ&@LfM;87F;CV!I&x&wTe{y4yix#j zD`C5SR2723Ht-MX$_N0C0T;6m9V#WqqgHEynQ?6#6ESm_{+YUV8S;iMsDihl%Hr=$ z%Ttv~5{f2m=-Z*QDO|Nxh4jbU3RNY5oYIlY3p^Dkcc*(=lCA8<`KhoxZG7U1J_U8` ziJ?IBt)vsJGxD*6d)%}&U-sgJ@iA#8ELjm}YPhS_E3MZ9*9$Xb%e_(RR4xkSk_75` zF|T@bqoLu4B=xa3#ocnchv8FpEWH!_kX-o`MwwJqX?3lFb3VND9K0w-s4PncDJ)lL z#|mRtwOF%!@v_uhS{=eS{t+Xn(tg5`Sir+}mjci(6Jt&gb;XNi`|}&0C(mG8u$Xp$ z#Z|I&)74nuQruIr`#saFzDSUI@o0kS|GKci(j2nHUhD9q>!J8y&FrgcwpGd*5JWzn1AkXlQ;InuUX0H=bBFJl>Hz`5gY+@B7`g7ua_deI&-Bh|WBv4~VZ08agR@(k0Y4bh0dMaxP)G;X zZSSJ)1%?N}#zairB$_2Q$mS-keQ5p8b}H`X+bCMqKh>jY4~b+4$v)HC8EZY?IUe%I z@HXXiKkVjiUMbHm=AkZ@lc|2^^MzH){k`{PPpyi-Bn0b~NV)oXurKwGE63eyp|M>k k;k-QEO{~9GZaKdOePr*2!qQFtd_ahFGz~Rs)ZnQ90d$>D2mk;8 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/Contents.json new file mode 100644 index 000000000..e32898827 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageLoginL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageLoginL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageLoginL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..18adb0347e1d5bccf3f8458e1bed1f7c5f88c90e GIT binary patch literal 2012 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 Z{U6fiP^I;_hfe?i002ovPDHLkV1mlUo=X4# literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@3x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageLogin.imageset/imageLoginL@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..0953b4aaddfcfcc30c1f836c33a3dbf3f5bc053f GIT binary patch literal 6067 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/Contents.json new file mode 100644 index 000000000..0595c3fd1 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageNetworkL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageNetworkL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageNetworkL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..171579ec1bb4a17478a71353231bec1e4c5757a9 GIT binary patch literal 3605 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 b{S@#2Wh9o(M$-9U00000NkvXXu0mjf)bHvF literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..e0912ae659f462b5be0a147e118d51453e1fb305 GIT binary patch literal 7433 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 Hu0mjffP-OP literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@3x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNetwork.imageset/imageNetworkL@3x.png new file mode 100644 index 0000000000000000000000000000000000000000..c64e8643cbac609528b142f583e833c4e1610563 GIT binary patch literal 11524 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 literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@2x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageNoun.imageset/imageNounL@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..a645ac6f8eff3c86cad7832cf07891acaa904cae GIT binary patch literal 865 zcmeAS@N?(olHy`uVBq!ia0vp^6(G#P1|%(0%q{^b&H|6fVg?3oVGw3ym^DWND9BhG z+qIsWng=NSH!Nk=8- z^p!VsuWs)=cJ%JVgGV?M%L)n#?AU~4DtYye9VyUnEI+{Ok`&XSR`hgT?VI8b#kPeP znzQSF*0E)rzVu{v{cW2s=WfQ&zT14XCNIyJ<^K(x65ig&XTBLfueu#StxR7=`;ndf zt0$E=xDQ&jJu5bo_*qi={PU*-p&w^A=d&BGE7zUvFLrkKHp}NcXN}IaO-r-aZOIYZ zSvt!uXRW<$jP|!{Nq1Vm*?zWD%yT|kmb*XUaZSXX)Wb>dZacp}lYhkioN76z_5sWM z@~+h%ZkE0Hm9R~yT*yBE!h_hNeK)_dSr&Gk7mSc;JW6ds)l6C5PSUI5_aUvsCWz^0 z-^l&h-~WE!ZJj-J_5UwDF14QjIteN#7!i{zw@EMfTVwK9$DN^*r>~cb6a^|U(qc_B zUG;B=OSkd{3#RVbubi)~39Da~@yIfsRamF*z#|S2kyoR-`pql;|9X2QeL%{JC}a@}e<>I9^zg|&Mb*|>pCA3+B7b4ks@p$f z#HVKfC4nl8ce988{U$NxFbk%!*sLN+Y)5^gGY6ZkVS#<#lf;w@2Iu_L_IFRb`(1HI z-5t;4$9*<7+%Py>H#hhBy62NW7Mz~R`)R_>lP}x@>oYRuNtm4u{vB(=<9hl~!td9Y z)^$hEzPs4(9$)p*KV>{zY>NYT?YbN``W z$lZxy-8q?;Kn_c~qpu?a!^VE@KZ&eB?sHEU$B+ufw|CEH%cRO2|M>p1kJ(mVe(pt! z-YR~KNnHG>a=O`rwYICKD{(ljd=&rSVDt8QTCV=N`rk5+b_+N?iY;7URmg7|+Pz_c z;Tyj+xpcFexl!BfBdlgu+U<$oa5G(P@?n*Hxp}f_o6jxVQS&bEw&m^!n_G%4smxi2 zW|lU$=AC$ZTi?v@?z~Tbf7@05epfW@X6fb&W((fU`5I*ZqUPsculN7fF;BntZi~?8 z*+(~II+!@wZ@#c|TivecyxyjJ^JgADUna0w`L&7TZr&fM$$#^o_N=(g|s$ijz7TV$QCeLVO3^J8YIlZ8ocCa12t9M<>U z*8Ev~@8%0q?=`NUb?_0Y&oTP;?AE>+Yt$X9wB5A;i8dt&TK!(9 z7$m)YO;91*-+78bq3mZTF$Zx-LD8a`z#kg+dH=FER&Fl-)Omcxyl~MaP5&~Bk0*UL zsjs;Dc@>j4pNC=w3Yxep=etFI$+Wb6Q%WA6(l7gbYQ0&v@%s5vwyPFZ#cf`t^J41t zGjX=b2Vz3SN+gZ9S0>$yaCYW$grZY-^l#_>H{0^|-h~bN$D*BI=lpXNH#}Zpof7&Z z)+SoVQlWK$A~IT9w!OdZ$4zgu)$8s4UIsesx%A^oS}oPuXX2wEP%Qmf+k>37IKJ>>QYvyH>eqC7biMd2%B{*E{ zR`L6+pY^ITw9(XLi2w|_{9IJxj(%)qjbS{LvA=r)a?x5IPZ z^2vn;uYWx{eXYV>jE(I`%8a)@$IdwkmfYBFd2eFc|45FRjD{z=!@hsIdvY81$=q;0 zyQtgubmrZ9dSmyIKJ$6z;Wo^rp~v>j{#RSU^e#5GJ~j2rA_LF6zmEpj*E~4)L0@{w z-=sNG0qT)<8y?=XcRll+@Aw`6%Z|%sc6^-Yon0Q)`Lk$Qo|Hg;U0UVyTfbiB?KIq( z6aG#k?bX#qALcO%ava>&HM6o*rud|<^@qpB^>g_3VmQR2jxy>pzgj%~dE)8n`p2(+ gowm36bM`-DX9mxMf0nmXfkhyLr>mdKI;Vst04d^sw*UYD literal 0 HcmV?d00001 diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/Contents.json b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/Contents.json new file mode 100644 index 000000000..3dfbc3d98 --- /dev/null +++ b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/Contents.json @@ -0,0 +1,23 @@ +{ + "images" : [ + { + "filename" : "imageProfileL@1x.png", + "idiom" : "universal", + "scale" : "1x" + }, + { + "filename" : "imageProfileL@2x.png", + "idiom" : "universal", + "scale" : "2x" + }, + { + "filename" : "imageProfileL@3x.png", + "idiom" : "universal", + "scale" : "3x" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@1x.png b/Sources/Web3ModalUI/Resources/Assets.xcassets/Images/imageProfile.imageset/imageProfileL@1x.png new file mode 100644 index 0000000000000000000000000000000000000000..f48d7569dbc4b9e8fe350b605cc57817ba57af05 GIT binary patch literal 2530 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