From d7911791255ddc69f9a9a6fb076e6c0bb7b61f58 Mon Sep 17 00:00:00 2001 From: Pierre-Marie Padiou Date: Fri, 8 Mar 2024 18:44:24 +0100 Subject: [PATCH] Initial commit --- .gitignore | 46 +++ CONTRIBUTING.md | 152 +++++++ LICENSE | 201 ++++++++++ README.md | 1 + build.gradle.kts | 119 ++++++ gradle.properties | 9 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 63721 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 249 ++++++++++++ gradlew.bat | 92 +++++ settings.gradle.kts | 9 + .../kotlin/fr/acinq/lightning/bin/Api.kt | 185 +++++++++ .../kotlin/fr/acinq/lightning/bin/Expects.kt | 9 + .../acinq/lightning/bin/InMemoryPaymentsDb.kt | 135 +++++++ .../kotlin/fr/acinq/lightning/bin/Main.kt | 339 ++++++++++++++++ .../fr/acinq/lightning/bin/conf/ConfFile.kt | 19 + .../kotlin/fr/acinq/lightning/bin/conf/Lsp.kt | 79 ++++ .../fr/acinq/lightning/bin/conf/Seed.kt | 24 ++ .../lightning/bin/db/SqliteChannelsDb.kt | 70 ++++ .../lightning/bin/db/SqlitePaymentsDb.kt | 289 ++++++++++++++ .../acinq/lightning/bin/db/WalletPaymentId.kt | 119 ++++++ .../payments/ChannelCloseOutgoingQueries.kt | 95 +++++ .../bin/db/payments/DbTypesHelper.kt | 40 ++ .../db/payments/InboundLiquidityLeaseType.kt | 103 +++++ .../db/payments/InboundLiquidityQueries.kt | 87 ++++ .../bin/db/payments/IncomingOriginType.kt | 91 +++++ .../bin/db/payments/IncomingQueries.kt | 201 ++++++++++ .../db/payments/IncomingReceivedWithType.kt | 169 ++++++++ .../bin/db/payments/LinkTxToPaymentQueries.kt | 51 +++ .../bin/db/payments/OutgoingDetailsType.kt | 80 ++++ .../db/payments/OutgoingPartClosingType.kt | 48 +++ .../bin/db/payments/OutgoingPartStatusType.kt | 72 ++++ .../bin/db/payments/OutgoingQueries.kt | 373 ++++++++++++++++++ .../bin/db/payments/OutgoingStatusType.kt | 110 ++++++ .../db/payments/SpliceCpfpOutgoingQueries.kt | 83 ++++ .../bin/db/payments/SpliceOutgoingQueries.kt | 89 +++++ .../v1/AbstractStringSerializer.kt | 40 ++ .../db/serializers/v1/ByteVectorSerializer.kt | 41 ++ .../serializers/v1/MilliSatoshiSerializer.kt | 42 ++ .../db/serializers/v1/OutpointSerializer.kt | 30 ++ .../db/serializers/v1/SatoshiSerializer.kt | 37 ++ .../bin/db/serializers/v1/UUIDSerializer.kt | 42 ++ .../lightning/bin/json/JsonSerializers.kt | 92 +++++ .../acinq/lightning/bin/logs/FileLogWriter.kt | 32 ++ .../fr/acinq/lightning/cli/PhoenixCli.kt | 194 +++++++++ .../fr/acinq/phoenix/db/ChannelsDatabase.sq | 48 +++ .../db/ChannelCloseOutgoingPayments.sq | 38 ++ .../phoenix/db/InboundLiquidityOutgoing.sq | 34 ++ .../fr/acinq/phoenix/db/IncomingPayments.sq | 98 +++++ .../fr/acinq/phoenix/db/LinkTxToPayment.sq | 29 ++ .../fr/acinq/phoenix/db/OutgoingPayments.sq | 228 +++++++++++ .../phoenix/db/SpliceCpfpOutgoingPayments.sq | 32 ++ .../phoenix/db/SpliceOutgoingPayments.sq | 32 ++ .../kotlin/fr/acinq/lightning/bin/Actuals.kt | 24 ++ .../kotlin/fr/acinq/lightning/bin/Actuals.kt | 27 ++ 55 files changed, 4985 insertions(+) create mode 100644 .gitignore create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE create mode 100644 README.md create mode 100644 build.gradle.kts create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 settings.gradle.kts create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/Api.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/Expects.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/InMemoryPaymentsDb.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/Main.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/conf/ConfFile.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Lsp.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Seed.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqliteChannelsDb.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqlitePaymentsDb.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/WalletPaymentId.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/ChannelCloseOutgoingQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/DbTypesHelper.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityLeaseType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingOriginType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingReceivedWithType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/LinkTxToPaymentQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingDetailsType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartClosingType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartStatusType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingStatusType.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceCpfpOutgoingQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceOutgoingQueries.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/AbstractStringSerializer.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/ByteVectorSerializer.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/MilliSatoshiSerializer.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/OutpointSerializer.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/SatoshiSerializer.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/UUIDSerializer.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/json/JsonSerializers.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/bin/logs/FileLogWriter.kt create mode 100644 src/commonMain/kotlin/fr/acinq/lightning/cli/PhoenixCli.kt create mode 100644 src/commonMain/sqldelight/channelsdb/fr/acinq/phoenix/db/ChannelsDatabase.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/ChannelCloseOutgoingPayments.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/InboundLiquidityOutgoing.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/IncomingPayments.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/LinkTxToPayment.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/OutgoingPayments.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceCpfpOutgoingPayments.sq create mode 100644 src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceOutgoingPayments.sq create mode 100644 src/jvmMain/kotlin/fr/acinq/lightning/bin/Actuals.kt create mode 100644 src/nativeMain/kotlin/fr/acinq/lightning/bin/Actuals.kt diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a6d3486 --- /dev/null +++ b/.gitignore @@ -0,0 +1,46 @@ +.gradle +build/ +.cxx + +# this file is local to the dev environment and must not be pushed! +local.properties + +# Ignore specific Mac files +.DS_Store +# Non relevant Xcode files +xcuserdata/ +# HPROF +*.hprof + +# Ignore Gradle GUI config +gradle-app.setting + +# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored) +!gradle-wrapper.jar + +# Cache of project +.gradletasknamecache + +*.class +*.log + +# sbt specific +.cache/ +.history/ +.lib/ +dist/* +target/ +lib_managed/ +src_managed/ +project/boot/ +project/plugins/project/ + +# Scala-IDE specific +.scala_dependencies +.worksheet + +.idea +*.iml +target/ +project/target +DeleteMe*.scala diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..1f0fdf1 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,152 @@ +# Contributing to the lightning-kmp project + +ACINQ welcomes contributions in the form of peer review, testing and patches. +This document explains the practical process and guidelines for contributing. + +While developing a Lightning implementation is an exciting project that spans many domains +(cryptography, peer-to-peer networking, databases, etc), contributors must keep in mind that this +represents real money and introducing bugs or security vulnerabilities can have far more dire +consequences than in typical projects. In the world of cryptocurrencies, even the smallest bug in +the wrong area can cost users a significant amount of money. + +If you're looking for somewhere to start contributing, check out the [good first issue](https://github.com/ACINQ/lightning-kmp/issues?q=is%3Aopen+is%3Aissue+label%3A"good+first+issue") list. + +Another way to start contributing is by adding tests or improving them. +This will help you understand the different parts of the codebase and how they work together. + +## Communicating + +We recommend using our Gitter [developers channel](https://gitter.im/ACINQ/developers). +Introducing yourself and explaining what you'd like to work on is always a good idea: you will get +some pointers and feedback from experienced contributors. It will also ensure that you're not +duplicating work that someone else is doing. + +We use Github issues only for, well, issues (mostly bugs that need to be investigated). +You can also use Github issues for [feature requests](https://github.com/ACINQ/lightning-kmp/issues?q=is%3Aissue+label%3A"feature+request"). + +## Recommended Reading + +- [Bitcoin Whitepaper](https://bitcoin.org/bitcoin.pdf) +- [Lightning Network Whitepaper](https://lightning.network/lightning-network-paper.pdf) +- [Deployable Lightning](https://github.com/ElementsProject/lightning/raw/master/doc/deployable-lightning.pdf) +- [Understanding the Lightning Network](https://bitcoinmagazine.com/articles/understanding-the-lightning-network-part-building-a-bidirectional-payment-channel-1464710791) +- [Lightning Network Specification](https://github.com/lightningnetwork/lightning-rfc) +- [High Level Lightning Network Specification](https://medium.com/@rusty_lightning/the-bitcoin-lightning-spec-part-1-8-a7720fb1b4da) + +## Recommended Skillset + +lightning-kmp uses [Kotlin Multiplatform](https://kotlinlang.org/docs/reference/multiplatform.html) with [Kotlin Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html). +Good understanding of these technologies is required to contribute. +There are a lot of good resources online to learn about them. + +## Contributor Workflow + +To contribute a patch, the workflow is as follows: + +1. [Fork repository](https://help.github.com/en/github/getting-started-with-github/fork-a-repo) (only the first time) +2. Create a topic branch +3. Add commits +4. Open a pull request + +### Pull Request Philosophy + +Pull requests should always be focused. For example, a pull request could add a feature, fix a bug, +or refactor code; but not a mixture. +Please also avoid super pull requests which attempt to do too much, are overly large, or overly +complex as this makes review difficult. + +You should try your best to make reviewers' lives as easy as possible: a lot more time will be +spent reading your code than the time you spent writing it. +The quicker your changes are merged to master, the less time you will need to spend rebasing and +otherwise trying to keep up with the master branch. + +Pull request should always include a clean, detailed description of what they fix/improve, why, +and how. +Even if you think that it is obvious, don't be shy and add explicit details and explanations. + +When fixing a bug, please start by adding a failing test that reproduces the issue. +Create a first commit containing that test without the fix: this makes it easy to verify that the +test corcrectly failed. You can then fix the bug in additional commits. + +When adding a new feature, thought must be given to the long term technical debt and maintenance +that feature may require after inclusion. Before proposing a new feature that will require +maintenance, please consider if you are willing to maintain it (including bug fixing). + +When addressing pull request comments, we recommend using [fixup commits](https://robots.thoughtbot.com/autosquashing-git-commits). +The reason for this is two fold: it makes it easier for the reviewer to see what changes have been +made between versions (since Github doesn't easily show prior versions) and it makes it easier on +the PR author as they can set it to auto-squash the fixup commits on rebase. + +It's recommended to take great care in writing tests and ensuring the entire test suite has a +stable successful outcome; lightning-kmp uses continuous integration techniques and having a stable build +helps the reviewers with their job. + +Contributors should follow the default Kotlin coding style guide. If you use IntelliJ: + +- File > Settings > Editor > Code Style + - In the "Formatter Control" tab, check "Enable formatter markers in comments" +- File > Settings > Editor > Code Style > Kotlin + - select "Set from..." and choose "Kotline style guide" + - set "Hard wrap at" to 240 + +### Signed Commits + +We ask contributors to sign their commits. +You can find setup instructions [here](https://help.github.com/en/github/authenticating-to-github/signing-commits). + +### Commit Message + +lightning-kmp keeps a clean commit history on the master branch with well-formed commit messages. + +Here is a model Git commit message: + +```text +Short (50 chars or less) summary of changes + +More detailed explanatory text, if necessary. Wrap it to about 72 +characters or so. In some contexts, the first line is treated as the +subject of an email and the rest of the text as the body. The blank +line separating the summary from the body is critical (unless you omit +the body entirely); tools like rebase can get confused if you run the +two together. + +Write your commit message in the present tense: "Fix bug" and not +"Fixed bug". This convention matches up with commit messages generated +by commands like git merge and git revert. + +Further paragraphs come after blank lines. + +- Bullet points are okay, too +- Typically a hyphen or asterisk is used for the bullet, preceded by a + single space, with blank lines in between, but conventions vary here +- Use a hanging indent +``` + +### Dependencies + +We try to minimize our dependencies (libraries and tools). Introducing new dependencies increases +package size, attack surface and cognitive overhead. + +If your contribution is adding a new dependency, please detail: + +- why you need it +- why you chose this specific library/tool (a thorough analysis of alternatives will be + appreciated) + +Contributions that add new dependencies may take longer to approve because a detailed audit of the +dependency may be required. + +### IntelliJ Tips + +If you're using [IntelliJ](https://www.jetbrains.com/idea/), here are some useful commands: + +- Ctrl+Alt+L: format file (ensures consistency in the codebase) +- Ctrl+Alt+o: optimize imports (removes unused imports) + +### Contribution Checklist + +- The code being submitted is accompanied by tests which exercise both the positive and negative + (error paths) conditions (if applicable) +- The code being submitted is correctly formatted +- The code being submitted has a clean, easy-to-follow commit history +- All commits are signed diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..d565dcd --- /dev/null +++ b/LICENSE @@ -0,0 +1,201 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2018 ACINQ SAS + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/README.md b/README.md new file mode 100644 index 0000000..e947f2c --- /dev/null +++ b/README.md @@ -0,0 +1 @@ +# phoenixd \ No newline at end of file diff --git a/build.gradle.kts b/build.gradle.kts new file mode 100644 index 0000000..37d2081 --- /dev/null +++ b/build.gradle.kts @@ -0,0 +1,119 @@ +import org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTargetWithHostTests + +buildscript { + dependencies { + classpath("app.cash.sqldelight:gradle-plugin:2.0.1") + } + repositories { + google() + mavenCentral() + } +} + +plugins { + kotlin("multiplatform") version "1.9.23" + kotlin("plugin.serialization") version "1.9.23" + id("app.cash.sqldelight") version "2.0.1" +} + +allprojects { + group = "fr.acinq.lightning" + version = "0.1-SNAPSHOT" + + repositories { + // using the local maven repository with Kotlin Multi Platform can lead to build errors that are hard to diagnose. + // uncomment this only if you need to experiment with snapshot dependencies that have not yet be published. + mavenLocal() + maven("https://oss.sonatype.org/content/repositories/snapshots") + mavenCentral() + google() + } +} + +kotlin { + jvm() + + fun KotlinNativeTargetWithHostTests.phoenixBinaries() { + binaries { + executable("phoenixd") { + entryPoint = "fr.acinq.lightning.bin.main" + optimized = false // without this, release mode throws 'Index 0 out of bounds for length 0' in StaticInitializersOptimization.kt + } + executable("phoenix-cli") { + entryPoint = "fr.acinq.lightning.cli.main" + optimized = false // without this, release mode throws 'Index 0 out of bounds for length 0' in StaticInitializersOptimization.kt + } + } + } + + val currentOs = org.gradle.internal.os.OperatingSystem.current() + if (currentOs.isLinux) { + linuxX64 { + phoenixBinaries() + } + } + + if (currentOs.isMacOsX) { + macosX64 { + phoenixBinaries() + } + } + + val ktorVersion = "2.3.8" + fun ktor(module: String) = "io.ktor:ktor-$module:$ktorVersion" + + sourceSets { + commonMain { + dependencies { + implementation("fr.acinq.lightning:lightning-kmp:1.6.2-SNAPSHOT") + // ktor serialization + implementation(ktor("serialization-kotlinx-json")) + // ktor server + implementation(ktor("server-core")) + implementation(ktor("server-content-negotiation")) + implementation(ktor("server-cio")) + implementation(ktor("server-websockets")) + implementation(ktor("server-auth")) + implementation(ktor("server-status-pages")) // exception handling + // ktor client (needed for webhook) + implementation(ktor("client-core")) + implementation(ktor("client-content-negotiation")) + implementation(ktor("client-cio")) + implementation(ktor("client-auth")) + implementation(ktor("client-json")) + + implementation("com.squareup.okio:okio:3.8.0") + implementation("com.github.ajalt.clikt:clikt:4.2.2") + implementation("app.cash.sqldelight:coroutines-extensions:2.0.1") + } + } + jvmMain { + dependencies { + implementation("app.cash.sqldelight:sqlite-driver:2.0.1") + } + } + nativeMain { + dependencies { + implementation("app.cash.sqldelight:native-driver:2.0.1") + } + } + } +} + +// forward std input when app is run via gradle (otherwise keyboard input will return EOF) +tasks.withType { + standardInput = System.`in` +} + +sqldelight { + databases { + create("ChannelsDatabase") { + packageName.set("fr.acinq.phoenix.db") + srcDirs.from("src/commonMain/sqldelight/channelsdb") + } + create("PaymentsDatabase") { + packageName.set("fr.acinq.phoenix.db") + srcDirs.from("src/commonMain/sqldelight/paymentsdb") + } + } +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..c069fca --- /dev/null +++ b/gradle.properties @@ -0,0 +1,9 @@ +# gradle +org.gradle.jvmargs=-Xmx1536m +org.gradle.parallel=true +# kotlin +kotlin.code.style=official +kotlin.incremental.multiplatform=true +kotlin.mpp.stability.nowarn=true +kotlin.mpp.enableCInteropCommonization=true +kotlin.native.ignoreDisabledTargets=true \ No newline at end of file diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..7f93135c49b765f8051ef9d0a6055ff8e46073d8 GIT binary patch literal 63721 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鯊%1Et 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⁢ zv5o9#E7!G0XmdzfsS{efPNi`1b44~SZ4Z8fuX!I}#8g+(wxzQwUT#Xb2(tbY1+EUhGKoT@KEU9Ktl>_0 z%bjDJg;#*gtJZv!-Zs`?^}v5eKmnbjqlvnSzE@_SP|LG_PJ6CYU+6zY6>92%E+ z=j@TZf-iW4(%U{lnYxQA;7Q!b;^brF8n0D>)`q5>|WDDXLrqYU_tKN2>=#@~OE7grMnNh?UOz-O~6 z6%rHy{#h9K0AT+lDC7q4{hw^|q6*Ry;;L%Q@)Ga}$60_q%D)rv(CtS$CQbpq9|y1e zRSrN4;$Jyl{m5bZw`$8TGvb}(LpY{-cQ)fcyJv7l3S52TLXVDsphtv&aPuDk1OzCA z4A^QtC(!11`IsNx_HnSy?>EKpHJWT^wmS~hc^p^zIIh@9f6U@I2 zC=Mve{j2^)mS#U$e{@Q?SO6%LDsXz@SY+=cK_QMmXBIU)j!$ajc-zLx3V60EXJ!qC zi<%2x8Q24YN+&8U@CIlN zrZkcT9yh%LrlGS9`G)KdP(@9Eo-AQz@8GEFWcb7U=a0H^ZVbLmz{+&M7W(nXJ4sN8 zJLR7eeK(K8`2-}j(T7JsO`L!+CvbueT%izanm-^A1Dn{`1Nw`9P?cq;7no+XfC`K(GO9?O^5zNIt4M+M8LM0=7Gz8UA@Z0N+lg+cX)NfazRu z5D)~HA^(u%w^cz+@2@_#S|u>GpB+j4KzQ^&Wcl9f z&hG#bCA(Yk0D&t&aJE^xME^&E-&xGHhXn%}psEIj641H+Nl-}boj;)Zt*t(4wZ5DN z@GXF$bL=&pBq-#vkTkh>7hl%K5|3 z{`Vn9b$iR-SoGENp}bn4;fR3>9sA%X2@1L3aE9yTra;Wb#_`xWwLSLdfu+PAu+o3| zGVnpzPr=ch{uuoHjtw7+_!L_2;knQ!DuDl0R`|%jr+}jFzXtrHIKc323?JO{l&;VF z*L1+}JU7%QJOg|5|Tc|D8fN zJORAg=_vsy{ak|o);@)Yh8Lkcg@$FG3k@ep36BRa^>~UmnRPziS>Z=`Jb2x*Q#`%A zU*i3&Vg?TluO@X0O;r2Jl6LKLUOVhSqg1*qOt^|8*c7 zo(298@+r$k_wQNGHv{|$tW(T8L+4_`FQ{kEW5Jgg{yf7ey4ss_(SNKfz(N9lx&a;< je(UuV8hP?p&}TPdm1I$XmG#(RzlD&B2izSj9sl%y5~4qc literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..3fa8f86 --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip +networkTimeout=10000 +validateDistributionUrl=true +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..1aa94a4 --- /dev/null +++ b/gradlew @@ -0,0 +1,249 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036) +APP_HOME=$( cd "${APP_HOME:-./}" > /dev/null && pwd -P ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + if ! command -v java >/dev/null 2>&1 + then + die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command: +# * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments, +# and any embedded shellness will be escaped. +# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be +# treated as '${Hostname}' itself on the command line. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..93e3f59 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,92 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..b5fd019 --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,9 @@ +rootProject.name = "phoenixd" + +pluginManagement { + repositories { + gradlePluginPortal() + maven("https://dl.bintray.com/kotlin/kotlin-eap") + } +} + diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/Api.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/Api.kt new file mode 100644 index 0000000..67fcfe2 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/Api.kt @@ -0,0 +1,185 @@ +package fr.acinq.lightning.bin + +import fr.acinq.bitcoin.Bitcoin +import fr.acinq.bitcoin.ByteVector +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.Script +import fr.acinq.bitcoin.utils.Either +import fr.acinq.bitcoin.utils.toEither +import fr.acinq.lightning.Lightning.randomBytes32 +import fr.acinq.lightning.NodeParams +import fr.acinq.lightning.bin.json.ApiType.* +import fr.acinq.lightning.blockchain.fee.FeeratePerByte +import fr.acinq.lightning.blockchain.fee.FeeratePerKw +import fr.acinq.lightning.channel.ChannelCommand +import fr.acinq.lightning.channel.states.ChannelStateWithCommitments +import fr.acinq.lightning.channel.states.ClosingFeerates +import fr.acinq.lightning.io.Peer +import fr.acinq.lightning.io.WrappedChannelCommand +import fr.acinq.lightning.payment.Bolt11Invoice +import fr.acinq.lightning.utils.sat +import fr.acinq.lightning.utils.sum +import fr.acinq.lightning.utils.toByteVector +import fr.acinq.lightning.utils.toMilliSatoshi +import io.ktor.client.* +import io.ktor.client.request.* +import io.ktor.http.* +import io.ktor.serialization.kotlinx.* +import io.ktor.serialization.kotlinx.json.* +import io.ktor.server.application.* +import io.ktor.server.auth.* +import io.ktor.server.engine.* +import io.ktor.server.plugins.* +import io.ktor.server.plugins.contentnegotiation.* +import io.ktor.server.plugins.statuspages.* +import io.ktor.server.request.* +import io.ktor.server.response.* +import io.ktor.server.routing.* +import io.ktor.server.websocket.* +import kotlinx.coroutines.flow.SharedFlow +import kotlinx.coroutines.launch +import kotlinx.serialization.json.Json + +class Api(private val nodeParams: NodeParams, private val peer: Peer, private val eventsFlow: SharedFlow, private val password: String, private val webhookUrl: Url?) { + + fun Application.module() { + + val json = Json { + prettyPrint = true + isLenient = true + serializersModule = fr.acinq.lightning.json.JsonSerializers.json.serializersModule + } + + install(ContentNegotiation) { + json(json) + } + install(WebSockets) { + contentConverter = KotlinxWebsocketSerializationConverter(json) + timeoutMillis = 10_000 + pingPeriodMillis = 10_000 + } + install(StatusPages) { + exception { call, cause -> + call.respondText(text = cause.message ?: "", status = defaultExceptionStatusCode(cause) ?: HttpStatusCode.InternalServerError) + } + } + install(Authentication) { + basic { + validate { credentials -> + if (credentials.password == password) { + UserIdPrincipal(credentials.name) + } else { + null + } + } + } + } + + routing { + authenticate { + get("getinfo") { + val info = NodeInfo( + nodeId = nodeParams.nodeId, + channels = peer.channels.values.map { Channel.from(it) } + ) + call.respond(info) + } + get("getbalance") { + val balance = peer.channels.values + .filterIsInstance() + .map { it.commitments.active.first().availableBalanceForSend(it.commitments.params, it.commitments.changes) } + .sum().truncateToSatoshi() + call.respond(Balance(balance, nodeParams.feeCredit.value)) + } + get("listchannels") { + call.respond(peer.channels.values.toList()) + } + post("createinvoice") { + val formParameters = call.receiveParameters() + val amount = formParameters.getLong("amountSat").sat + val description = formParameters.getString("description") + val invoice = peer.createInvoice(randomBytes32(), amount.toMilliSatoshi(), Either.Left(description)) + call.respond(GeneratedInvoice(invoice.amount?.truncateToSatoshi(), invoice.paymentHash, serialized = invoice.write())) + } + post("payinvoice") { + val formParameters = call.receiveParameters() + val overrideAmount = formParameters["amountSat"]?.let { it.toLongOrNull() ?: invalidType("amountSat", "integer") }?.sat?.toMilliSatoshi() + val invoice = formParameters.getInvoice("invoice") + val amount = (overrideAmount ?: invoice.amount) ?: missing("amountSat") + when (val event = peer.sendLightning(amount, invoice)) { + is fr.acinq.lightning.io.PaymentSent -> call.respond(PaymentSent(event)) + is fr.acinq.lightning.io.PaymentNotSent -> call.respond(PaymentFailed(event)) + } + } + post("sendtoaddress") { + val res = kotlin.runCatching { + val formParameters = call.receiveParameters() + val amount = formParameters.getLong("amountSat").sat + val scriptPubKey = formParameters.getAddressAndConvertToScript("address") + val feerate = FeeratePerKw(FeeratePerByte(formParameters.getLong("feerateSatByte").sat)) + peer.spliceOut(amount, scriptPubKey, feerate) + }.toEither() + when (res) { + is Either.Right -> when (val r = res.value) { + is ChannelCommand.Commitment.Splice.Response.Created -> call.respondText(r.fundingTxId.toString()) + is ChannelCommand.Commitment.Splice.Response.Failure -> call.respondText(r.toString()) + else -> call.respondText("no channel available") + } + is Either.Left -> call.respondText(res.value.message.toString()) + } + } + post("closechannel") { + val formParameters = call.receiveParameters() + val channelId = formParameters.getByteVector32("channelId") + val scriptPubKey = formParameters.getAddressAndConvertToScript("address") + val feerate = FeeratePerKw(FeeratePerByte(formParameters.getLong("feerateSatByte").sat)) + peer.send(WrappedChannelCommand(channelId, ChannelCommand.Close.MutualClose(scriptPubKey, ClosingFeerates(feerate)))) + call.respondText("ok") + } + webSocket("/websocket") { + try { + eventsFlow.collect { sendSerialized(it) } + } catch (e: Throwable) { + println("onError ${closeReason.await()}") + } + } + } + } + + webhookUrl?.let { url -> + val client = HttpClient(io.ktor.client.engine.cio.CIO) { + install(io.ktor.client.plugins.contentnegotiation.ContentNegotiation) { + json(json = Json { + prettyPrint = true + isLenient = true + }) + } + } + launch { + eventsFlow.collect { event -> + client.post(url) { + contentType(ContentType.Application.Json) + setBody(event) + } + } + } + } + } + + private fun missing(argName: String): Nothing = throw MissingRequestParameterException(argName) + + private fun invalidType(argName: String, typeName: String): Nothing = throw ParameterConversionException(argName, typeName) + + private fun Parameters.getString(argName: String): String = (this[argName] ?: missing(argName)) + + private fun Parameters.getByteVector32(argName: String): ByteVector32 = getString(argName).let { hex -> kotlin.runCatching { ByteVector32.fromValidHex(hex) }.getOrNull() ?: invalidType(argName, "hex32") } + + private fun Parameters.getAddressAndConvertToScript(argName: String): ByteVector = Script.write(Bitcoin.addressToPublicKeyScript(nodeParams.chainHash, getString(argName)).right ?: error("invalid address")).toByteVector() + + private fun Parameters.getInvoice(argName: String): Bolt11Invoice = getString(argName).let { invoice -> Bolt11Invoice.read(invoice).getOrElse { invalidType(argName, "bolt11invoice") } } + + private fun Parameters.getLong(argName: String): Long = ((this[argName] ?: missing(argName)).toLongOrNull()) ?: invalidType(argName, "integer") + +} + + diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/Expects.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/Expects.kt new file mode 100644 index 0000000..3a129de --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/Expects.kt @@ -0,0 +1,9 @@ +package fr.acinq.lightning.bin + +import app.cash.sqldelight.db.SqlDriver +import okio.Path + +expect val homeDirectory: Path + +expect fun createAppDbDriver(dir: Path): SqlDriver +expect fun createPaymentsDbDriver(dir: Path): SqlDriver diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/InMemoryPaymentsDb.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/InMemoryPaymentsDb.kt new file mode 100644 index 0000000..1b03567 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/InMemoryPaymentsDb.kt @@ -0,0 +1,135 @@ +package fr.acinq.lightning.bin + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.Crypto +import fr.acinq.bitcoin.TxId +import fr.acinq.bitcoin.utils.Either +import fr.acinq.lightning.channel.ChannelException +import fr.acinq.lightning.db.* +import fr.acinq.lightning.payment.FinalFailure +import fr.acinq.lightning.payment.OutgoingPaymentFailure +import fr.acinq.lightning.utils.UUID +import fr.acinq.lightning.utils.toByteVector32 +import fr.acinq.lightning.wire.FailureMessage + +class InMemoryPaymentsDb : PaymentsDb { + private val incoming = mutableMapOf() + private val outgoing = mutableMapOf() + private val outgoingParts = mutableMapOf>() + override suspend fun setLocked(txId: TxId) {} + + override suspend fun addIncomingPayment(preimage: ByteVector32, origin: IncomingPayment.Origin, createdAt: Long): IncomingPayment { + val paymentHash = Crypto.sha256(preimage).toByteVector32() + require(!incoming.contains(paymentHash)) { "an incoming payment for $paymentHash already exists" } + val incomingPayment = IncomingPayment(preimage, origin, null, createdAt) + incoming[paymentHash] = incomingPayment + return incomingPayment + } + + override suspend fun getIncomingPayment(paymentHash: ByteVector32): IncomingPayment? = incoming[paymentHash] + + override suspend fun receivePayment(paymentHash: ByteVector32, receivedWith: List, receivedAt: Long) { + when (val payment = incoming[paymentHash]) { + null -> Unit // no-op + else -> incoming[paymentHash] = run { + payment.copy( + received = IncomingPayment.Received( + receivedWith = (payment.received?.receivedWith ?: emptySet()) + receivedWith, + receivedAt = receivedAt + ) + ) + } + } + } + + fun listIncomingPayments(count: Int, skip: Int): List = + incoming.values + .asSequence() + .sortedByDescending { it.createdAt } + .drop(skip) + .take(count) + .toList() + + override suspend fun listExpiredPayments(fromCreatedAt: Long, toCreatedAt: Long): List = + incoming.values + .asSequence() + .filter { it.createdAt in fromCreatedAt until toCreatedAt } + .filter { it.isExpired() } + .filter { it.received == null } + .sortedByDescending { it.createdAt } + .toList() + + override suspend fun removeIncomingPayment(paymentHash: ByteVector32): Boolean { + val payment = getIncomingPayment(paymentHash) + return when (payment?.received) { + null -> incoming.remove(paymentHash) != null + else -> false // do nothing if payment already partially paid + } + } + + override suspend fun addOutgoingPayment(outgoingPayment: OutgoingPayment) { + require(!outgoing.contains(outgoingPayment.id)) { "an outgoing payment with id=${outgoingPayment.id} already exists" } + when (outgoingPayment) { + is LightningOutgoingPayment -> { + outgoingPayment.parts.forEach { require(!outgoingParts.contains(it.id)) { "an outgoing payment part with id=${it.id} already exists" } } + outgoing[outgoingPayment.id] = outgoingPayment.copy(parts = listOf()) + outgoingPayment.parts.forEach { outgoingParts[it.id] = Pair(outgoingPayment.id, it) } + } + is OnChainOutgoingPayment -> {} // we don't persist on-chain payments + } + } + + override suspend fun getLightningOutgoingPayment(id: UUID): LightningOutgoingPayment? { + return outgoing[id]?.let { payment -> + val parts = outgoingParts.values.filter { it.first == payment.id }.map { it.second } + return when (payment.status) { + is LightningOutgoingPayment.Status.Completed.Succeeded -> payment.copy(parts = parts.filter { it.status is LightningOutgoingPayment.Part.Status.Succeeded }) + else -> payment.copy(parts = parts) + } + } + } + + override suspend fun completeOutgoingPaymentOffchain(id: UUID, preimage: ByteVector32, completedAt: Long) { + require(outgoing.contains(id)) { "outgoing payment with id=$id doesn't exist" } + val payment = outgoing[id]!! + outgoing[id] = payment.copy(status = LightningOutgoingPayment.Status.Completed.Succeeded.OffChain(preimage = preimage, completedAt = completedAt)) + } + + override suspend fun completeOutgoingPaymentOffchain(id: UUID, finalFailure: FinalFailure, completedAt: Long) { + require(outgoing.contains(id)) { "outgoing payment with id=$id doesn't exist" } + val payment = outgoing[id]!! + outgoing[id] = payment.copy(status = LightningOutgoingPayment.Status.Completed.Failed(reason = finalFailure, completedAt = completedAt)) + } + + override suspend fun addOutgoingLightningParts(parentId: UUID, parts: List) { + require(outgoing.contains(parentId)) { "parent outgoing payment with id=$parentId doesn't exist" } + parts.forEach { require(!outgoingParts.contains(it.id)) { "an outgoing payment part with id=${it.id} already exists" } } + parts.forEach { outgoingParts[it.id] = Pair(parentId, it) } + } + + override suspend fun completeOutgoingLightningPart(partId: UUID, failure: Either, completedAt: Long) { + require(outgoingParts.contains(partId)) { "outgoing payment part with id=$partId doesn't exist" } + val (parentId, part) = outgoingParts[partId]!! + outgoingParts[partId] = Pair(parentId, part.copy(status = OutgoingPaymentFailure.convertFailure(failure, completedAt))) + } + + override suspend fun completeOutgoingLightningPart(partId: UUID, preimage: ByteVector32, completedAt: Long) { + require(outgoingParts.contains(partId)) { "outgoing payment part with id=$partId doesn't exist" } + val (parentId, part) = outgoingParts[partId]!! + outgoingParts[partId] = Pair(parentId, part.copy(status = LightningOutgoingPayment.Part.Status.Succeeded(preimage, completedAt))) + } + + override suspend fun getLightningOutgoingPaymentFromPartId(partId: UUID): LightningOutgoingPayment? { + return outgoingParts[partId]?.let { (parentId, _) -> + require(outgoing.contains(parentId)) { "parent outgoing payment with id=$parentId doesn't exist" } + getLightningOutgoingPayment(parentId) + } + } + + override suspend fun listLightningOutgoingPayments(paymentHash: ByteVector32): List { + return outgoing.values.filter { it.paymentHash == paymentHash }.map { payment -> + val parts = outgoingParts.values.filter { it.first == payment.id }.map { it.second } + payment.copy(parts = parts) + } + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/Main.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/Main.kt new file mode 100644 index 0000000..a02e288 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/Main.kt @@ -0,0 +1,339 @@ +package fr.acinq.lightning.bin + +import co.touchlab.kermit.CommonWriter +import co.touchlab.kermit.Severity +import co.touchlab.kermit.StaticConfig +import com.github.ajalt.clikt.core.CliktCommand +import com.github.ajalt.clikt.core.context +import com.github.ajalt.clikt.core.terminal +import com.github.ajalt.clikt.output.MordantHelpFormatter +import com.github.ajalt.clikt.parameters.groups.OptionGroup +import com.github.ajalt.clikt.parameters.groups.provideDelegate +import com.github.ajalt.clikt.parameters.options.* +import com.github.ajalt.clikt.parameters.types.choice +import com.github.ajalt.clikt.parameters.types.int +import com.github.ajalt.clikt.parameters.types.restrictTo +import com.github.ajalt.clikt.sources.MapValueSource +import com.github.ajalt.mordant.rendering.TextColors.* +import com.github.ajalt.mordant.rendering.TextStyles.bold +import com.github.ajalt.mordant.rendering.TextStyles.underline +import fr.acinq.bitcoin.Chain +import fr.acinq.lightning.* +import fr.acinq.lightning.Lightning.randomBytes32 +import fr.acinq.lightning.bin.conf.LSP +import fr.acinq.lightning.bin.conf.getOrGenerateSeed +import fr.acinq.lightning.bin.conf.readConfFile +import fr.acinq.lightning.bin.db.SqliteChannelsDb +import fr.acinq.lightning.bin.db.SqlitePaymentsDb +import fr.acinq.lightning.bin.json.ApiType +import fr.acinq.lightning.bin.logs.FileLogWriter +import fr.acinq.lightning.blockchain.electrum.ElectrumClient +import fr.acinq.lightning.blockchain.electrum.ElectrumConnectionStatus +import fr.acinq.lightning.blockchain.electrum.ElectrumWatcher +import fr.acinq.lightning.crypto.LocalKeyManager +import fr.acinq.lightning.db.ChannelsDb +import fr.acinq.lightning.db.Databases +import fr.acinq.lightning.db.PaymentsDb +import fr.acinq.lightning.io.Peer +import fr.acinq.lightning.io.TcpSocket +import fr.acinq.lightning.logging.LoggerFactory +import fr.acinq.lightning.payment.LiquidityPolicy +import fr.acinq.lightning.utils.Connection +import fr.acinq.lightning.utils.ServerAddress +import fr.acinq.lightning.utils.msat +import fr.acinq.lightning.utils.sat +import io.ktor.http.* +import io.ktor.server.application.* +import io.ktor.server.cio.* +import io.ktor.server.engine.* +import kotlinx.coroutines.* +import kotlinx.coroutines.flow.* +import okio.FileSystem +import okio.buffer +import okio.use +import kotlin.system.exitProcess +import kotlin.time.Duration.Companion.milliseconds +import kotlin.time.Duration.Companion.seconds + + +fun main(args: Array) = Phoenixd().main(args) + +class LiquidityOptions : OptionGroup(name = "Liquidity Options") { + val autoLiquidity by option("--auto-liquidity", help = "Amount automatically requested when inbound liquidity is needed").choice( + "off" to 0.sat, + "2m" to 2_000_000.sat, + "5m" to 5_000_000.sat, + "10m" to 10_000_000.sat, + ).default(2_000_000.sat) + val maxAbsoluteFee by option("--max-absolute-fee", help = "Max absolute fee for on-chain operations. Includes mining fee and service fee for auto-liquidity.") + .int().convert { it.sat } + .restrictTo(5_000.sat..100_000.sat) + .default(40_000.sat) // with a default auto-liquidity of 2m sat, that's a max total fee of 2% + val maxRelativeFeeBasisPoint by option("--max-relative-fee-percent", help = "Max relative fee for on-chain operations in percent.", hidden = true) + .int() + .restrictTo(1..50) + .default(30) + val maxFeeCredit by option("--max-fee-credit", help = "Max fee credit, if reached payments will be rejected.", hidden = true) + .int().convert { it.sat } + .restrictTo(0.sat..100_000.sat) + .default(100_000.sat) +} + +class Phoenixd : CliktCommand() { + //private val datadir by option("--datadir", help = "Data directory").convert { it.toPath() }.default(homeDirectory / ".phoenix", defaultForHelp = "~/.phoenix") + private val datadir = homeDirectory / ".phoenix" + private val confFile = datadir / "phoenix.conf" + private val chain by option("--chain", help = "Bitcoin chain to use").choice( + "mainnet" to Chain.Mainnet, "testnet" to Chain.Testnet + ).default(Chain.Testnet, defaultForHelp = "testnet") + private val customElectrumServer by option("--electrum-server", "-e", help = "Custom Electrum server") + .convert { it.split(":").run { ServerAddress(first(), last().toInt(), TcpSocket.TLS.DISABLED) } } + private val httpBindIp by option("--http-bind-ip", help = "Bind ip for the http api").default("127.0.0.1") + private val httpBindPort by option("--http-bind-port", help = "Bind port for the http api").int().default(9740) + private val httpPassword by option("--http-password", help = "Password for the http api").defaultLazy { + // the additionalValues map already contains values in phoenix.conf, so if we are here then there are no existing password + terminal.print(yellow("Generating default api password...")) + val value = randomBytes32().toHex() + val confFile = datadir / "phoenix.conf" + FileSystem.SYSTEM.createDirectories(datadir) + FileSystem.SYSTEM.appendingSink(confFile, mustExist = false).buffer().use { it.writeUtf8("\nhttp-password=$value\n") } + terminal.println(white("done")) + value + } + private val webHookUrl by option("--webhook", help = "Webhook http endpoint for push notifications (alternative to websocket)") + .convert { Url(it) } + + private val liquidityOptions by LiquidityOptions() + + private val verbose: Boolean by option("--verbose", help = "Verbose mode").flag(default = false) + private val silent: Boolean by option("--silent", "-s", help = "Silent mode").flag(default = false) + + init { + context { + valueSource = MapValueSource(readConfFile(confFile)) + helpFormatter = { MordantHelpFormatter(it, showDefaultValues = true) } + } + } + + @OptIn(DelicateCoroutinesApi::class) + override fun run() { + FileSystem.SYSTEM.createDirectories(datadir) + val (seed, new) = getOrGenerateSeed(datadir) + if (new) { + runBlocking { + terminal.print(yellow("Generating new seed...")) + delay(500.milliseconds) + terminal.println(white("done")) + terminal.println() + terminal.println(green("Backup")) + terminal.println("This software is self-custodial, you have full control and responsibility over your funds.") + terminal.println("Your 12-words seed is located in ${FileSystem.SYSTEM.canonicalize(datadir)}, ${bold(red("make sure to do a backup or you risk losing your funds"))}.") + terminal.println() + terminal.println(green("How does it work?")) + terminal.println( + """ + When receiving a Lightning payment that doesn't fit within your existing channel, then: + - If the payment amount is large enough to cover mining fees and service fees for automated liquidity, then your channel will be created or enlarged right away. + - If the payment is too small, then the full amount is added to your fee credit. This credit will be used later to pay for future fees. ${bold(red("The fee credit is non-refundable"))}. + """.trimIndent() + ) + terminal.println() + terminal.println( + gray( + """ + Examples: + With the default settings, and assuming that current mining fees are 10k sat. The total fee for a + liquidity operation will be 10k sat (mining fee) + 20k sat (service fee for the 2m sat liquidity) = 30k sat. + + ${(underline + gray)("scenario A")}: you receive a continuous stream of tiny 100 sat payments + a) the first 299 incoming payments will be added to your fee credit + b) when receiving the 300th payment, a 2m sat channel will be created, with balance 0 sat on your side + c) the next 20 thousands payments will be received in your channel + d) back to a) + + ${(underline + gray)("scenario B")}: you receive a continuous stream of 50k sat payments + a) when receiving the first payment, a 1M sat channel will be created with balance 50k-30k=20k sat on your side + b) the next next 40 payments will be received in your channel, at that point balance is 2m sat + c) back to a) + + In both scenarios, the total average fee is the same: 30k/2m = 1.5%. + You can reduce this average fee further, by choosing a higher liquidity amount (option ${bold(white("--auto-liquidity"))}), + in exchange for higher upfront costs. The higher the liquidity amount, the less significant the cost of + mining fee in relative terms. + """.trimIndent() + ) + ) + terminal.println() + terminal.prompt("Please confirm by typing", choices = listOf("I understand that if I do not make a backup I risk losing my funds"), invalidChoiceMessage = "Please type those exact words:") + terminal.prompt( + "Please confirm by typing", + choices = listOf("I must not share the same seed with other phoenix instances (mobile or server) or I risk force closing my channels"), + invalidChoiceMessage = "Please type those exact words:" + ) + terminal.prompt("Please confirm by typing", choices = listOf("I accept that the fee credit is non-refundable"), invalidChoiceMessage = "Please type those exact words:") + terminal.println() + + } + } + echo(cyan("datadir: ${FileSystem.SYSTEM.canonicalize(datadir)}")) + echo(cyan("chain: $chain")) + echo(cyan("autoLiquidity: ${liquidityOptions.autoLiquidity}")) + + val scope = GlobalScope + val loggerFactory = LoggerFactory( + StaticConfig(minSeverity = Severity.Info, logWriterList = buildList { + // always log to file + add(FileLogWriter(datadir / "phoenix.log", scope)) + // only log to console if verbose mode is enabled + if (verbose) add(CommonWriter()) + }) + ) + val electrumServer = customElectrumServer ?: when (chain) { + Chain.Mainnet -> ServerAddress("electrum.acinq.co", 50001, TcpSocket.TLS.DISABLED) + Chain.Testnet -> ServerAddress("testnet1.electrum.acinq.co", 51001, TcpSocket.TLS.DISABLED) + else -> error("unsupported chain") + } + val lsp = LSP.from(chain) + val liquidityPolicy = LiquidityPolicy.Auto( + maxAbsoluteFee = liquidityOptions.maxAbsoluteFee, + maxRelativeFeeBasisPoints = liquidityOptions.maxRelativeFeeBasisPoint, + skipAbsoluteFeeCheck = false, + maxAllowedCredit = liquidityOptions.maxFeeCredit + ) + val keyManager = LocalKeyManager(seed, chain, lsp.swapInXpub) + val nodeParams = NodeParams(chain, loggerFactory, keyManager) + .run { + copy( + zeroConfPeers = setOf(lsp.walletParams.trampolineNode.id), + liquidityPolicy = MutableStateFlow(liquidityPolicy), + features = features.copy( + activated = buildMap { + putAll(features.activated) + put(Feature.FeeCredit, FeatureSupport.Optional) + } + ) + ) + } + echo(cyan("nodeid: ${nodeParams.nodeId}")) + + val electrum = ElectrumClient(scope, loggerFactory) + val paymentsDb = SqlitePaymentsDb(loggerFactory, createPaymentsDbDriver(datadir)) + val peer = Peer( + nodeParams = nodeParams, walletParams = lsp.walletParams, watcher = ElectrumWatcher(electrum, scope, loggerFactory), db = object : Databases { + override val channels: ChannelsDb + get() = SqliteChannelsDb(createAppDbDriver(datadir)) + override val payments: PaymentsDb + get() = paymentsDb + }, socketBuilder = TcpSocket.Builder(), scope + ) + + val eventsFlow: SharedFlow = MutableSharedFlow().run { + scope.launch { + launch { + nodeParams.nodeEvents + .collect { + when { + it is PaymentEvents.PaymentReceived && it.amount > 0.msat -> emit(ApiType.PaymentReceived(it)) + else -> {} + } + } + } + launch { + peer.eventsFlow + .collect { + when { + it is fr.acinq.lightning.io.PaymentSent -> emit(ApiType.PaymentSent(it)) + else -> {} + } + } + } + } + asSharedFlow() + } + + val listeners = scope.launch { + launch { + // drop initial CLOSED event + electrum.connectionStatus.dropWhile { it is ElectrumConnectionStatus.Closed }.collect { + when (it) { + is ElectrumConnectionStatus.Connecting -> echo(yellow("connecting to electrum server...")) + is ElectrumConnectionStatus.Connected -> echo(yellow("connected to electrum server")) + is ElectrumConnectionStatus.Closed -> echo(yellow("disconnected from electrum server")) + } + } + } + launch { + // drop initial CLOSED event + peer.connectionState.dropWhile { it is Connection.CLOSED }.collect { + when (it) { + Connection.ESTABLISHING -> echo(yellow("connecting to lightning peer...")) + Connection.ESTABLISHED -> echo(yellow("connected to lightning peer")) + is Connection.CLOSED -> echo(yellow("disconnected from lightning peer")) + } + } + } + launch { + nodeParams.nodeEvents + .filterIsInstance() + .filter { it.amount > 0.msat } + .collect { + echo("received lightning payment: ${it.amount.truncateToSatoshi()} (${it.receivedWith.joinToString { part -> part::class.simpleName.toString().lowercase() }})") + } + } + launch { + nodeParams.nodeEvents + .filterIsInstance() + .collect { + echo(yellow("lightning payment rejected: amount=${it.amount.truncateToSatoshi()} fee=${it.fee.truncateToSatoshi()} maxFee=${liquidityPolicy.maxAbsoluteFee}")) + } + } + launch { + nodeParams.feeCredit + .drop(1) // we drop the initial value which is 0 sat + .collect { feeCredit -> echo("fee credit: $feeCredit") } + } + } + + runBlocking { + electrum.connect(electrumServer, TcpSocket.Builder()) + peer.connect(connectTimeout = 10.seconds, handshakeTimeout = 10.seconds) + peer.connectionState.first { it == Connection.ESTABLISHED } + peer.registerFcmToken("super-${randomBytes32().toHex()}") + peer.setAutoLiquidityParams(liquidityOptions.autoLiquidity) + } + + val server = embeddedServer(CIO, port = httpBindPort, host = httpBindIp, + configure = { + reuseAddress = true + }, + module = { + Api(nodeParams, peer, eventsFlow, httpPassword, webHookUrl).run { module() } + } + ) + val serverJob = scope.launch { + try { + server.start(wait = true) + } catch (t: Throwable) { + if (t.cause?.message?.contains("Address already in use") == true) { + echo(t.cause?.message, err = true) + } else throw t + } + } + + server.environment.monitor.subscribe(ServerReady) { + echo("listening on http://$httpBindIp:$httpBindPort") + } + server.environment.monitor.subscribe(ApplicationStopPreparing) { + echo(brightYellow("shutting down...")) + electrum.stop() + peer.disconnect() + server.stop() + listeners.cancel() + exitProcess(0) + } + server.environment.monitor.subscribe(ApplicationStopped) { echo(brightYellow("http server stopped")) } + + runBlocking { serverJob.join() } + } + +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/ConfFile.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/ConfFile.kt new file mode 100644 index 0000000..9549f49 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/ConfFile.kt @@ -0,0 +1,19 @@ +package fr.acinq.lightning.bin.conf + +import okio.FileSystem +import okio.Path + +fun readConfFile(confFile: Path): Map = try { + buildMap { + if (FileSystem.SYSTEM.exists(confFile)) { + FileSystem.SYSTEM.read(confFile) { + while (true) { + val line = readUtf8Line() ?: break + line.split("=").run { put(first(), last()) } + } + } + } + } +} catch (t: Throwable) { + emptyMap() +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Lsp.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Lsp.kt new file mode 100644 index 0000000..24ecf23 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Lsp.kt @@ -0,0 +1,79 @@ +package fr.acinq.lightning.bin.conf + +import fr.acinq.bitcoin.Chain +import fr.acinq.bitcoin.PublicKey +import fr.acinq.lightning.* +import fr.acinq.lightning.utils.msat +import fr.acinq.lightning.utils.sat + + +data class LSP(val walletParams: WalletParams, val swapInXpub: String) { + + companion object { + + private val trampolineFees = listOf( + TrampolineFees( + feeBase = 4.sat, + feeProportional = 4_000, + cltvExpiryDelta = CltvExpiryDelta(576) + ) + ) + + private val invoiceDefaultRoutingFees = InvoiceDefaultRoutingFees( + feeBase = 1_000.msat, + feeProportional = 100, + cltvExpiryDelta = CltvExpiryDelta(144) + ) + + private val swapInParams = SwapInParams( + minConfirmations = DefaultSwapInParams.MinConfirmations, + maxConfirmations = DefaultSwapInParams.MaxConfirmations, + refundDelay = DefaultSwapInParams.RefundDelay, + ) + + fun from(chain: Chain) = when (chain) { + is Chain.Mainnet -> LSP( + swapInXpub = "xpub69q3sDXXsLuHVbmTrhqmEqYqTTsXJKahdfawXaYuUt6muf1PbZBnvqzFcwiT8Abpc13hY8BFafakwpPbVkatg9egwiMjed1cRrPM19b2Ma7", + walletParams = WalletParams( + trampolineNode = NodeUri(PublicKey.fromHex("03864ef025fde8fb587d989186ce6a4a186895ee44a926bfc370e2c366597a3f8f"), "3.33.236.230", 9735), + trampolineFees, + invoiceDefaultRoutingFees, + swapInParams + ) + ) + is Chain.Testnet -> LSP( + swapInXpub = "tpubDAmCFB21J9ExKBRPDcVxSvGs9jtcf8U1wWWbS1xTYmnUsuUHPCoFdCnEGxLE3THSWcQE48GHJnyz8XPbYUivBMbLSMBifFd3G9KmafkM9og", + walletParams = WalletParams( + trampolineNode = NodeUri(PublicKey.fromHex("03933884aaf1d6b108397e5efe5c86bcf2d8ca8d2f700eda99db9214fc2712b134"), "13.248.222.197", 9735), + trampolineFees, + invoiceDefaultRoutingFees, + swapInParams + ) + ) + else -> error("unsupported chain $chain") + } + +// fun liquidityLeaseRate(amount: Satoshi): LiquidityAds.LeaseRate { +// // WARNING : THIS MUST BE KEPT IN SYNC WITH LSP OTHERWISE FUNDING REQUEST WILL BE REJECTED BY PHOENIX +// val fundingWeight = if (amount <= 100_000.sat) { +// 271 * 2 // 2-inputs (wpkh) / 0-change +// } else if (amount <= 250_000.sat) { +// 271 * 2 // 2-inputs (wpkh) / 0-change +// } else if (amount <= 500_000.sat) { +// 271 * 4 // 4-inputs (wpkh) / 0-change +// } else if (amount <= 1_000_000.sat) { +// 271 * 4 // 4-inputs (wpkh) / 0-change +// } else { +// 271 * 6 // 6-inputs (wpkh) / 0-change +// } +// return LiquidityAds.LeaseRate( +// leaseDuration = 0, +// fundingWeight = fundingWeight, +// leaseFeeProportional = 100, // 1% +// leaseFeeBase = 0.sat, +// maxRelayFeeProportional = 100, +// maxRelayFeeBase = 1_000.msat +// ) +// } + } +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Seed.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Seed.kt new file mode 100644 index 0000000..f5adb04 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/conf/Seed.kt @@ -0,0 +1,24 @@ +package fr.acinq.lightning.bin.conf + +import fr.acinq.bitcoin.ByteVector +import fr.acinq.bitcoin.MnemonicCode +import fr.acinq.lightning.Lightning.randomBytes +import fr.acinq.lightning.utils.toByteVector +import okio.FileSystem +import okio.Path + +/** + * @return a pair with the seed and a boolean indicating whether the seed was newly generated + */ +fun getOrGenerateSeed(dir: Path): Pair { + val file = dir / "seed.dat" + val (mnemonics, new) = if (FileSystem.SYSTEM.exists(file)) { + FileSystem.SYSTEM.read(file) { readUtf8() } to false + } else { + val entropy = randomBytes(16) + val mnemonics = MnemonicCode.toMnemonics(entropy).joinToString(" ") + FileSystem.SYSTEM.write(file) { writeUtf8(mnemonics) } + mnemonics to true + } + return MnemonicCode.toSeed(mnemonics, "").toByteVector() to new +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqliteChannelsDb.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqliteChannelsDb.kt new file mode 100644 index 0000000..fc61922 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqliteChannelsDb.kt @@ -0,0 +1,70 @@ +package fr.acinq.lightning.bin.db + +import app.cash.sqldelight.db.SqlDriver +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.lightning.CltvExpiry +import fr.acinq.lightning.channel.states.PersistedChannelState +import fr.acinq.lightning.db.ChannelsDb +import fr.acinq.lightning.serialization.Serialization +import fr.acinq.phoenix.db.ChannelsDatabase +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext + +internal class SqliteChannelsDb(private val driver: SqlDriver) : ChannelsDb { + + private val database = ChannelsDatabase(driver) + private val queries = database.channelsDatabaseQueries + + override suspend fun addOrUpdateChannel(state: PersistedChannelState) { + val channelId = state.channelId.toByteArray() + val data = Serialization.serialize(state) + withContext(Dispatchers.Default) { + queries.transaction { + queries.getChannel(channelId).executeAsOneOrNull()?.run { + queries.updateChannel(channel_id = this.channel_id, data_ = data) + } ?: run { + queries.insertChannel(channel_id = channelId, data_ = data) + } + } + } + } + + override suspend fun removeChannel(channelId: ByteVector32) { + withContext(Dispatchers.Default) { + queries.deleteHtlcInfo(channel_id = channelId.toByteArray()) + queries.closeLocalChannel(channel_id = channelId.toByteArray()) + } + } + + override suspend fun listLocalChannels(): List = withContext(Dispatchers.Default) { + val bytes = queries.listLocalChannels().executeAsList() + bytes.mapNotNull { + when (val res = Serialization.deserialize(it)) { + is Serialization.DeserializationResult.Success -> res.state + is Serialization.DeserializationResult.UnknownVersion -> null + } + } + } + + override suspend fun addHtlcInfo(channelId: ByteVector32, commitmentNumber: Long, paymentHash: ByteVector32, cltvExpiry: CltvExpiry) { + withContext(Dispatchers.Default) { + queries.insertHtlcInfo( + channel_id = channelId.toByteArray(), + commitment_number = commitmentNumber, + payment_hash = paymentHash.toByteArray(), + cltv_expiry = cltvExpiry.toLong()) + } + } + + override suspend fun listHtlcInfos(channelId: ByteVector32, commitmentNumber: Long): List> { + return withContext(Dispatchers.Default) { + queries.listHtlcInfos(channel_id = channelId.toByteArray(), commitment_number = commitmentNumber, mapper = { payment_hash, cltv_expiry -> + ByteVector32(payment_hash) to CltvExpiry(cltv_expiry) + }).executeAsList() + } + } + + override fun close() { + driver.close() + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqlitePaymentsDb.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqlitePaymentsDb.kt new file mode 100644 index 0000000..390fbe3 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/SqlitePaymentsDb.kt @@ -0,0 +1,289 @@ +/* + * Copyright 2020 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db + +import app.cash.sqldelight.EnumColumnAdapter +import app.cash.sqldelight.db.SqlDriver +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.Crypto +import fr.acinq.bitcoin.TxId +import fr.acinq.bitcoin.utils.Either +import fr.acinq.lightning.bin.db.payments.* +import fr.acinq.lightning.bin.db.payments.LinkTxToPaymentQueries +import fr.acinq.lightning.channel.ChannelException +import fr.acinq.lightning.db.* +import fr.acinq.lightning.logging.LoggerFactory +import fr.acinq.lightning.payment.FinalFailure +import fr.acinq.lightning.utils.* +import fr.acinq.lightning.wire.FailureMessage +import fr.acinq.phoenix.db.* +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.flow.Flow +import kotlinx.coroutines.withContext + +class SqlitePaymentsDb( + loggerFactory: LoggerFactory, + private val driver: SqlDriver, +) : PaymentsDb { + + private val log = loggerFactory.newLogger(this::class) + + private val database = PaymentsDatabase( + driver = driver, + outgoing_payment_partsAdapter = Outgoing_payment_parts.Adapter( + part_routeAdapter = OutgoingQueries.hopDescAdapter, + part_status_typeAdapter = EnumColumnAdapter() + ), + outgoing_paymentsAdapter = Outgoing_payments.Adapter( + status_typeAdapter = EnumColumnAdapter(), + details_typeAdapter = EnumColumnAdapter() + ), + incoming_paymentsAdapter = Incoming_payments.Adapter( + origin_typeAdapter = EnumColumnAdapter(), + received_with_typeAdapter = EnumColumnAdapter() + ), + outgoing_payment_closing_tx_partsAdapter = Outgoing_payment_closing_tx_parts.Adapter( + part_closing_info_typeAdapter = EnumColumnAdapter() + ), + channel_close_outgoing_paymentsAdapter = Channel_close_outgoing_payments.Adapter( + closing_info_typeAdapter = EnumColumnAdapter() + ), + inbound_liquidity_outgoing_paymentsAdapter = Inbound_liquidity_outgoing_payments.Adapter( + lease_typeAdapter = EnumColumnAdapter() + ) + ) + + internal val inQueries = IncomingQueries(database) + internal val outQueries = OutgoingQueries(database) + private val spliceOutQueries = SpliceOutgoingQueries(database) + private val channelCloseQueries = ChannelCloseOutgoingQueries(database) + private val cpfpQueries = SpliceCpfpOutgoingQueries(database) + private val linkTxToPaymentQueries = LinkTxToPaymentQueries(database) + private val inboundLiquidityQueries = InboundLiquidityQueries(database) + + override suspend fun addOutgoingLightningParts( + parentId: UUID, + parts: List + ) { + withContext(Dispatchers.Default) { + outQueries.addLightningParts(parentId, parts) + } + } + + override suspend fun addOutgoingPayment( + outgoingPayment: OutgoingPayment + ) { + withContext(Dispatchers.Default) { + database.transaction { + when (outgoingPayment) { + is LightningOutgoingPayment -> { + outQueries.addLightningOutgoingPayment(outgoingPayment) + } + is SpliceOutgoingPayment -> { + spliceOutQueries.addSpliceOutgoingPayment(outgoingPayment) + linkTxToPaymentQueries.linkTxToPayment( + txId = outgoingPayment.txId, + walletPaymentId = outgoingPayment.walletPaymentId() + ) + } + is ChannelCloseOutgoingPayment -> { + channelCloseQueries.addChannelCloseOutgoingPayment(outgoingPayment) + linkTxToPaymentQueries.linkTxToPayment( + txId = outgoingPayment.txId, + walletPaymentId = outgoingPayment.walletPaymentId() + ) + } + is SpliceCpfpOutgoingPayment -> { + cpfpQueries.addCpfpPayment(outgoingPayment) + linkTxToPaymentQueries.linkTxToPayment(outgoingPayment.txId, outgoingPayment.walletPaymentId()) + } + is InboundLiquidityOutgoingPayment -> { + inboundLiquidityQueries.add(outgoingPayment) + linkTxToPaymentQueries.linkTxToPayment(outgoingPayment.txId, outgoingPayment.walletPaymentId()) + } + } + } + } + } + + override suspend fun completeOutgoingPaymentOffchain( + id: UUID, + preimage: ByteVector32, + completedAt: Long + ) { + withContext(Dispatchers.Default) { + outQueries.completePayment(id, LightningOutgoingPayment.Status.Completed.Succeeded.OffChain(preimage, completedAt)) + } + } + + override suspend fun completeOutgoingPaymentOffchain( + id: UUID, + finalFailure: FinalFailure, + completedAt: Long + ) { + withContext(Dispatchers.Default) { + outQueries.completePayment(id, LightningOutgoingPayment.Status.Completed.Failed(finalFailure, completedAt)) + } + } + + override suspend fun completeOutgoingLightningPart( + partId: UUID, + preimage: ByteVector32, + completedAt: Long + ) { + withContext(Dispatchers.Default) { + outQueries.updateLightningPart(partId, preimage, completedAt) + } + } + + override suspend fun completeOutgoingLightningPart( + partId: UUID, + failure: Either, + completedAt: Long + ) { + withContext(Dispatchers.Default) { + outQueries.updateLightningPart(partId, failure, completedAt) + } + } + + override suspend fun getLightningOutgoingPayment(id: UUID): LightningOutgoingPayment? = withContext(Dispatchers.Default) { + outQueries.getPaymentStrict(id) + } + + override suspend fun getLightningOutgoingPaymentFromPartId(partId: UUID): LightningOutgoingPayment? = withContext(Dispatchers.Default) { + outQueries.getPaymentFromPartId(partId) + } + + // ---- list outgoing + + override suspend fun listLightningOutgoingPayments( + paymentHash: ByteVector32 + ): List = withContext(Dispatchers.Default) { + outQueries.listLightningOutgoingPayments(paymentHash) + } + + // ---- incoming payments + + override suspend fun addIncomingPayment( + preimage: ByteVector32, + origin: IncomingPayment.Origin, + createdAt: Long + ): IncomingPayment { + val paymentHash = Crypto.sha256(preimage).toByteVector32() + + return withContext(Dispatchers.Default) { + database.transactionWithResult { + inQueries.addIncomingPayment(preimage, paymentHash, origin, createdAt) + inQueries.getIncomingPayment(paymentHash)!! + } + } + } + + override suspend fun receivePayment( + paymentHash: ByteVector32, + receivedWith: List, + receivedAt: Long + ) { + withContext(Dispatchers.Default) { + database.transaction { + inQueries.receivePayment(paymentHash, receivedWith, receivedAt) + // if one received-with is on-chain, save the tx id to the db + receivedWith.filterIsInstance().firstOrNull()?.let { + linkTxToPaymentQueries.linkTxToPayment(it.txId, WalletPaymentId.IncomingPaymentId(paymentHash)) + } + } + } + } + + override suspend fun setLocked(txId: TxId) { + database.transaction { + val lockedAt = currentTimestampMillis() + linkTxToPaymentQueries.setLocked(txId, lockedAt) + linkTxToPaymentQueries.listWalletPaymentIdsForTx(txId).forEach { walletPaymentId -> + when (walletPaymentId) { + is WalletPaymentId.IncomingPaymentId -> { + inQueries.setLocked(walletPaymentId.paymentHash, lockedAt) + } + is WalletPaymentId.LightningOutgoingPaymentId -> { + // LN payments need not be locked + } + is WalletPaymentId.SpliceOutgoingPaymentId -> { + spliceOutQueries.setLocked(walletPaymentId.id, lockedAt) + } + is WalletPaymentId.ChannelCloseOutgoingPaymentId -> { + channelCloseQueries.setLocked(walletPaymentId.id, lockedAt) + } + is WalletPaymentId.SpliceCpfpOutgoingPaymentId -> { + cpfpQueries.setLocked(walletPaymentId.id, lockedAt) + } + is WalletPaymentId.InboundLiquidityOutgoingPaymentId -> { + inboundLiquidityQueries.setLocked(walletPaymentId.id, lockedAt) + } + } + } + } + } + + suspend fun setConfirmed(txId: TxId) = withContext(Dispatchers.Default) { + database.transaction { + val confirmedAt = currentTimestampMillis() + linkTxToPaymentQueries.setConfirmed(txId, confirmedAt) + linkTxToPaymentQueries.listWalletPaymentIdsForTx(txId).forEach { walletPaymentId -> + when (walletPaymentId) { + is WalletPaymentId.IncomingPaymentId -> { + inQueries.setConfirmed(walletPaymentId.paymentHash, confirmedAt) + } + is WalletPaymentId.LightningOutgoingPaymentId -> { + // LN payments need not be confirmed + } + is WalletPaymentId.SpliceOutgoingPaymentId -> { + spliceOutQueries.setConfirmed(walletPaymentId.id, confirmedAt) + } + is WalletPaymentId.ChannelCloseOutgoingPaymentId -> { + channelCloseQueries.setConfirmed(walletPaymentId.id, confirmedAt) + } + is WalletPaymentId.SpliceCpfpOutgoingPaymentId -> { + cpfpQueries.setConfirmed(walletPaymentId.id, confirmedAt) + } + is WalletPaymentId.InboundLiquidityOutgoingPaymentId -> { + inboundLiquidityQueries.setConfirmed(walletPaymentId.id, confirmedAt) + } + } + } + } + } + + override suspend fun getIncomingPayment( + paymentHash: ByteVector32 + ): IncomingPayment? = withContext(Dispatchers.Default) { + inQueries.getIncomingPayment(paymentHash) + } + + override suspend fun listExpiredPayments( + fromCreatedAt: Long, + toCreatedAt: Long + ): List = withContext(Dispatchers.Default) { + inQueries.listExpiredPayments(fromCreatedAt, toCreatedAt) + } + + override suspend fun removeIncomingPayment( + paymentHash: ByteVector32 + ): Boolean = withContext(Dispatchers.Default) { + inQueries.deleteIncomingPayment(paymentHash) + } + +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/WalletPaymentId.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/WalletPaymentId.kt new file mode 100644 index 0000000..7e50b5a --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/WalletPaymentId.kt @@ -0,0 +1,119 @@ +package fr.acinq.lightning.bin.db + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.lightning.db.* +import fr.acinq.lightning.utils.UUID + +/** + * Helper class that helps to link an actual payment to a unique string. This is useful to store a reference + * to a payment in a single TEXT sql column. + * + * e.g.: incoming|b50ccb7e52ecc6f25b21eb23c2efdd1cfdb973ca12c7db9eef3d818dcc9b437c + * This is a unique identifier for an [IncomingPayment] with paymentHash=b50ccb7...b437c. + * + * It is common to reference these rows in other database tables via [dbType] or [dbId]. + * + * @param dbType Long representing either incoming or outgoing/splice-outgoing/... + * @param dbId String representing the appropriate id for either table (payment hash or UUID). + */ +sealed class WalletPaymentId { + + abstract val dbType: DbType + abstract val dbId: String + + /** Use this to get a single (hashable) identifier for the row, for example within a hashmap or Cache. */ + abstract val identifier: String + + data class IncomingPaymentId(val paymentHash: ByteVector32) : WalletPaymentId() { + override val dbType: DbType = DbType.INCOMING + override val dbId: String = paymentHash.toHex() + override val identifier: String = "incoming|$dbId" + + companion object { + fun fromString(id: String) = IncomingPaymentId(paymentHash = ByteVector32(id)) + fun fromByteArray(id: ByteArray) = IncomingPaymentId(paymentHash = ByteVector32(id)) + } + } + + data class LightningOutgoingPaymentId(val id: UUID) : WalletPaymentId() { + override val dbType: DbType = DbType.OUTGOING + override val dbId: String = id.toString() + override val identifier: String = "outgoing|$dbId" + + companion object { + fun fromString(id: String) = LightningOutgoingPaymentId(id = UUID.fromString(id)) + } + } + + data class SpliceOutgoingPaymentId(val id: UUID) : WalletPaymentId() { + override val dbType: DbType = DbType.SPLICE_OUTGOING + override val dbId: String = id.toString() + override val identifier: String = "splice_outgoing|$dbId" + + companion object { + fun fromString(id: String) = SpliceOutgoingPaymentId(id = UUID.fromString(id)) + } + } + + data class ChannelCloseOutgoingPaymentId(val id: UUID) : WalletPaymentId() { + override val dbType: DbType = DbType.CHANNEL_CLOSE_OUTGOING + override val dbId: String = id.toString() + override val identifier: String = "channel_close_outgoing|$dbId" + + companion object { + fun fromString(id: String) = ChannelCloseOutgoingPaymentId(id = UUID.fromString(id)) + } + } + + data class SpliceCpfpOutgoingPaymentId(val id: UUID) : WalletPaymentId() { + override val dbType: DbType = DbType.SPLICE_CPFP_OUTGOING + override val dbId: String = id.toString() + override val identifier: String = "splice_cpfp_outgoing|$dbId" + + companion object { + fun fromString(id: String) = SpliceCpfpOutgoingPaymentId(id = UUID.fromString(id)) + } + } + + data class InboundLiquidityOutgoingPaymentId(val id: UUID) : WalletPaymentId() { + override val dbType: DbType = DbType.INBOUND_LIQUIDITY_OUTGOING + override val dbId: String = id.toString() + override val identifier: String = "inbound_liquidity_outgoing|$dbId" + + companion object { + fun fromString(id: String) = InboundLiquidityOutgoingPaymentId(id = UUID.fromString(id)) + } + } + + enum class DbType(val value: Long) { + INCOMING(1), + OUTGOING(2), + SPLICE_OUTGOING(3), + CHANNEL_CLOSE_OUTGOING(4), + SPLICE_CPFP_OUTGOING(5), + INBOUND_LIQUIDITY_OUTGOING(6), + } + + companion object { + fun create(type: Long, id: String): WalletPaymentId? { + return when (type) { + DbType.INCOMING.value -> IncomingPaymentId.fromString(id) + DbType.OUTGOING.value -> LightningOutgoingPaymentId.fromString(id) + DbType.SPLICE_OUTGOING.value -> SpliceOutgoingPaymentId.fromString(id) + DbType.CHANNEL_CLOSE_OUTGOING.value -> ChannelCloseOutgoingPaymentId.fromString(id) + DbType.SPLICE_CPFP_OUTGOING.value -> SpliceCpfpOutgoingPaymentId.fromString(id) + DbType.INBOUND_LIQUIDITY_OUTGOING.value -> InboundLiquidityOutgoingPaymentId.fromString(id) + else -> null + } + } + } +} + +fun WalletPayment.walletPaymentId(): WalletPaymentId = when (this) { + is IncomingPayment -> WalletPaymentId.IncomingPaymentId(paymentHash = this.paymentHash) + is LightningOutgoingPayment -> WalletPaymentId.LightningOutgoingPaymentId(id = this.id) + is SpliceOutgoingPayment -> WalletPaymentId.SpliceOutgoingPaymentId(id = this.id) + is ChannelCloseOutgoingPayment -> WalletPaymentId.ChannelCloseOutgoingPaymentId(id = this.id) + is SpliceCpfpOutgoingPayment -> WalletPaymentId.SpliceCpfpOutgoingPaymentId(id = this.id) + is InboundLiquidityOutgoingPayment -> WalletPaymentId.InboundLiquidityOutgoingPaymentId(id = this.id) +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/ChannelCloseOutgoingQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/ChannelCloseOutgoingQueries.kt new file mode 100644 index 0000000..62a38c5 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/ChannelCloseOutgoingQueries.kt @@ -0,0 +1,95 @@ +/* + * Copyright 2023 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.db.ChannelCloseOutgoingPayment +import fr.acinq.lightning.utils.UUID +import fr.acinq.lightning.utils.sat +import fr.acinq.lightning.utils.toByteVector32 +import fr.acinq.phoenix.db.PaymentsDatabase + +class ChannelCloseOutgoingQueries(val database: PaymentsDatabase) { + private val channelCloseQueries = database.channelCloseOutgoingPaymentsQueries + + fun getChannelCloseOutgoingPayment(id: UUID): ChannelCloseOutgoingPayment? { + return channelCloseQueries.getChannelCloseOutgoing(id.toString(), Companion::mapChannelCloseOutgoingPayment).executeAsOneOrNull() + } + + fun addChannelCloseOutgoingPayment(payment: ChannelCloseOutgoingPayment) { + val (closingInfoType, closingInfoBlob) = payment.mapClosingTypeToDb() + database.transaction { + channelCloseQueries.insertChannelCloseOutgoing( + id = payment.id.toString(), + recipient_amount_sat = payment.recipientAmount.sat, + address = payment.address, + is_default_address = if (payment.isSentToDefaultAddress) 1 else 0, + mining_fees_sat = payment.miningFees.sat, + tx_id = payment.txId.value.toByteArray(), + created_at = payment.createdAt, + confirmed_at = payment.confirmedAt, + locked_at = payment.lockedAt, + channel_id = payment.channelId.toByteArray(), + closing_info_type = closingInfoType, + closing_info_blob = closingInfoBlob, + ) + } + } + + fun setConfirmed(id: UUID, confirmedAt: Long) { + database.transaction { + channelCloseQueries.setConfirmed(confirmed_at = confirmedAt, id = id.toString()) + } + } + + fun setLocked(id: UUID, lockedAt: Long) { + database.transaction { + channelCloseQueries.setLocked(locked_at = lockedAt, id = id.toString()) + } + } + + companion object { + fun mapChannelCloseOutgoingPayment( + id: String, + amount_sat: Long, + address: String, + is_default_address: Long, + mining_fees_sat: Long, + tx_id: ByteArray, + created_at: Long, + confirmed_at: Long?, + locked_at: Long?, + channel_id: ByteArray, + closing_info_type: OutgoingPartClosingInfoTypeVersion, + closing_info_blob: ByteArray + ): ChannelCloseOutgoingPayment { + return ChannelCloseOutgoingPayment( + id = UUID.fromString(id), + recipientAmount = amount_sat.sat, + address = address, + isSentToDefaultAddress = is_default_address == 1L, + miningFees = mining_fees_sat.sat, + txId = TxId(tx_id), + createdAt = created_at, + confirmedAt = confirmed_at, + lockedAt = locked_at, + channelId = channel_id.toByteVector32(), + closingType = OutgoingPartClosingInfoData.deserialize(closing_info_type, closing_info_blob), + ) + } + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/DbTypesHelper.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/DbTypesHelper.kt new file mode 100644 index 0000000..3947f46 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/DbTypesHelper.kt @@ -0,0 +1,40 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.json.Json +import kotlinx.serialization.modules.SerializersModule +import kotlinx.serialization.modules.polymorphic +import kotlinx.serialization.modules.subclass + +object DbTypesHelper { + /** Decode a byte array and apply a deserialization handler. */ + fun decodeBlob(blob: ByteArray, handler: (String, Json) -> T) = handler(String(bytes = blob, charset = Charsets.UTF_8), Json) + + val module = SerializersModule { + polymorphic(IncomingReceivedWithData.Part::class) { + subclass(IncomingReceivedWithData.Part.Htlc.V0::class) + subclass(IncomingReceivedWithData.Part.NewChannel.V2::class) + subclass(IncomingReceivedWithData.Part.SpliceIn.V0::class) + subclass(IncomingReceivedWithData.Part.FeeCredit.V0::class) + } + } + + val polymorphicFormat = Json { serializersModule = module } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityLeaseType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityLeaseType.kt new file mode 100644 index 0000000..2801eb9 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityLeaseType.kt @@ -0,0 +1,103 @@ +/* + * Copyright 2023 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +@file:UseSerializers( + ByteVectorSerializer::class, + ByteVector32Serializer::class, + ByteVector64Serializer::class, + SatoshiSerializer::class, + MilliSatoshiSerializer::class +) + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.ByteVector +import fr.acinq.bitcoin.ByteVector64 +import fr.acinq.bitcoin.Satoshi +import fr.acinq.lightning.MilliSatoshi +import fr.acinq.lightning.db.InboundLiquidityOutgoingPayment +import fr.acinq.lightning.wire.LiquidityAds +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector32Serializer +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector64Serializer +import fr.acinq.lightning.bin.db.serializers.v1.ByteVectorSerializer +import fr.acinq.lightning.bin.db.serializers.v1.MilliSatoshiSerializer +import fr.acinq.lightning.bin.db.serializers.v1.SatoshiSerializer +import io.ktor.utils.io.charsets.Charsets +import io.ktor.utils.io.core.toByteArray +import kotlinx.serialization.Serializable +import kotlinx.serialization.UseSerializers +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json + +enum class InboundLiquidityLeaseTypeVersion { + LEASE_V0, +} + +sealed class InboundLiquidityLeaseData { + + @Serializable + data class V0( + val amount: Satoshi, + val miningFees: Satoshi, + val serviceFee: Satoshi, + val sellerSig: ByteVector64, + val witnessFundingScript: ByteVector, + val witnessLeaseDuration: Int, + val witnessLeaseEnd: Int, + val witnessMaxRelayFeeProportional: Int, + val witnessMaxRelayFeeBase: MilliSatoshi + ) : InboundLiquidityLeaseData() + + companion object { + /** Deserializes a json-encoded blob containing data for an [LiquidityAds.Lease] object. */ + fun deserialize( + typeVersion: InboundLiquidityLeaseTypeVersion, + blob: ByteArray, + ): LiquidityAds.Lease = DbTypesHelper.decodeBlob(blob) { json, format -> + when (typeVersion) { + InboundLiquidityLeaseTypeVersion.LEASE_V0 -> format.decodeFromString(json).let { + LiquidityAds.Lease( + amount = it.amount, + fees = LiquidityAds.LeaseFees(miningFee = it.miningFees, serviceFee = it.serviceFee), + sellerSig = it.sellerSig, + witness = LiquidityAds.LeaseWitness( + fundingScript = it.witnessFundingScript, + leaseDuration = it.witnessLeaseDuration, + leaseEnd = it.witnessLeaseEnd, + maxRelayFeeProportional = it.witnessMaxRelayFeeProportional, + maxRelayFeeBase = it.witnessMaxRelayFeeBase, + ) + ) + } + } + } + } +} + +fun InboundLiquidityOutgoingPayment.mapLeaseToDb() = InboundLiquidityLeaseTypeVersion.LEASE_V0 to + InboundLiquidityLeaseData.V0( + amount = lease.amount, + miningFees = lease.fees.miningFee, + serviceFee = lease.fees.serviceFee, + sellerSig = lease.sellerSig, + witnessFundingScript = lease.witness.fundingScript, + witnessLeaseDuration = lease.witness.leaseDuration, + witnessLeaseEnd = lease.witness.leaseEnd, + witnessMaxRelayFeeProportional = lease.witness.maxRelayFeeProportional, + witnessMaxRelayFeeBase = lease.witness.maxRelayFeeBase, + ).let { + Json.encodeToString(it).toByteArray(Charsets.UTF_8) + } diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityQueries.kt new file mode 100644 index 0000000..798ca68 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/InboundLiquidityQueries.kt @@ -0,0 +1,87 @@ +/* + * Copyright 2023 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.db.InboundLiquidityOutgoingPayment +import fr.acinq.lightning.utils.UUID +import fr.acinq.lightning.utils.sat +import fr.acinq.lightning.utils.toByteVector32 +import fr.acinq.phoenix.db.PaymentsDatabase + +class InboundLiquidityQueries(val database: PaymentsDatabase) { + private val queries = database.inboundLiquidityOutgoingQueries + + fun add(payment: InboundLiquidityOutgoingPayment) { + database.transaction { + val (leaseType, leaseData) = payment.mapLeaseToDb() + queries.insert( + id = payment.id.toString(), + mining_fees_sat = payment.miningFees.sat, + channel_id = payment.channelId.toByteArray(), + tx_id = payment.txId.value.toByteArray(), + lease_type = leaseType, + lease_blob = leaseData, + created_at = payment.createdAt, + confirmed_at = payment.confirmedAt, + locked_at = payment.lockedAt, + ) + } + } + + fun get(id: UUID): InboundLiquidityOutgoingPayment? { + return queries.get(id = id.toString(), mapper = Companion::mapPayment) + .executeAsOneOrNull() + } + + fun setConfirmed(id: UUID, confirmedAt: Long) { + database.transaction { + queries.setConfirmed(confirmed_at = confirmedAt, id = id.toString()) + } + } + + fun setLocked(id: UUID, lockedAt: Long) { + database.transaction { + queries.setLocked(locked_at = lockedAt, id = id.toString()) + } + } + + private companion object { + fun mapPayment( + id: String, + mining_fees_sat: Long, + channel_id: ByteArray, + tx_id: ByteArray, + lease_type: InboundLiquidityLeaseTypeVersion, + lease_blob: ByteArray, + created_at: Long, + confirmed_at: Long?, + locked_at: Long? + ): InboundLiquidityOutgoingPayment { + return InboundLiquidityOutgoingPayment( + id = UUID.fromString(id), + miningFees = mining_fees_sat.sat, + channelId = channel_id.toByteVector32(), + txId = TxId(tx_id), + lease = InboundLiquidityLeaseData.deserialize(lease_type, lease_blob), + createdAt = created_at, + confirmedAt = confirmed_at, + lockedAt = locked_at + ) + } + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingOriginType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingOriginType.kt new file mode 100644 index 0000000..2539c79 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingOriginType.kt @@ -0,0 +1,91 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +@file:UseSerializers( + OutpointSerializer::class, + ByteVector32Serializer::class, +) + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.OutPoint +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.bin.db.payments.DbTypesHelper.decodeBlob +import fr.acinq.lightning.db.IncomingPayment +import fr.acinq.lightning.payment.Bolt11Invoice +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector32Serializer +import fr.acinq.lightning.bin.db.serializers.v1.OutpointSerializer +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.* +import kotlinx.serialization.json.Json + + +enum class IncomingOriginTypeVersion { + KEYSEND_V0, + INVOICE_V0, + SWAPIN_V0, + ONCHAIN_V0, +} + +sealed class IncomingOriginData { + + sealed class KeySend : IncomingOriginData() { + @Serializable + @SerialName("KEYSEND_V0") + object V0 : KeySend() + } + + sealed class Invoice : IncomingOriginData() { + @Serializable + data class V0(val paymentRequest: String) : Invoice() + } + + sealed class SwapIn : IncomingOriginData() { + @Serializable + data class V0(val address: String?) : SwapIn() + } + + sealed class OnChain : IncomingOriginData() { + @Serializable + data class V0(@Serializable val txId: ByteVector32, val outpoints: List<@Serializable OutPoint>) : SwapIn() + } + + companion object { + fun deserialize(typeVersion: IncomingOriginTypeVersion, blob: ByteArray): IncomingPayment.Origin = decodeBlob(blob) { json, format -> + when (typeVersion) { + IncomingOriginTypeVersion.KEYSEND_V0 -> IncomingPayment.Origin.KeySend + IncomingOriginTypeVersion.INVOICE_V0 -> format.decodeFromString(json).let { IncomingPayment.Origin.Invoice(Bolt11Invoice.read(it.paymentRequest).get()) } + IncomingOriginTypeVersion.SWAPIN_V0 -> format.decodeFromString(json).let { IncomingPayment.Origin.SwapIn(it.address) } + IncomingOriginTypeVersion.ONCHAIN_V0 -> format.decodeFromString(json).let { + IncomingPayment.Origin.OnChain(TxId(it.txId), it.outpoints.toSet()) + } + } + } + } +} + +fun IncomingPayment.Origin.mapToDb(): Pair = when (this) { + is IncomingPayment.Origin.KeySend -> IncomingOriginTypeVersion.KEYSEND_V0 to + Json.encodeToString(IncomingOriginData.KeySend.V0).toByteArray(Charsets.UTF_8) + is IncomingPayment.Origin.Invoice -> IncomingOriginTypeVersion.INVOICE_V0 to + Json.encodeToString(IncomingOriginData.Invoice.V0(paymentRequest.write())).toByteArray(Charsets.UTF_8) + is IncomingPayment.Origin.SwapIn -> IncomingOriginTypeVersion.SWAPIN_V0 to + Json.encodeToString(IncomingOriginData.SwapIn.V0(address)).toByteArray(Charsets.UTF_8) + is IncomingPayment.Origin.OnChain -> IncomingOriginTypeVersion.ONCHAIN_V0 to + Json.encodeToString(IncomingOriginData.OnChain.V0(txId.value, localInputs.toList())).toByteArray(Charsets.UTF_8) +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingQueries.kt new file mode 100644 index 0000000..2c04335 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingQueries.kt @@ -0,0 +1,201 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import app.cash.sqldelight.coroutines.asFlow +import app.cash.sqldelight.coroutines.mapToList +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.byteVector32 +import fr.acinq.lightning.db.IncomingPayment +import fr.acinq.lightning.utils.msat +import fr.acinq.phoenix.db.PaymentsDatabase +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.IO +import kotlinx.coroutines.flow.Flow + +class IncomingQueries(private val database: PaymentsDatabase) { + + private val queries = database.incomingPaymentsQueries + + fun addIncomingPayment( + preimage: ByteVector32, + paymentHash: ByteVector32, + origin: IncomingPayment.Origin, + createdAt: Long + ) { + val (originType, originData) = origin.mapToDb() + queries.insert( + payment_hash = paymentHash.toByteArray(), + preimage = preimage.toByteArray(), + origin_type = originType, + origin_blob = originData, + created_at = createdAt + ) + } + + fun receivePayment( + paymentHash: ByteVector32, + receivedWith: List, + receivedAt: Long + ) { + database.transaction { + val paymentInDb = queries.get( + payment_hash = paymentHash.toByteArray(), + mapper = Companion::mapIncomingPayment + ).executeAsOneOrNull() ?: throw IncomingPaymentNotFound(paymentHash) + val existingReceivedWith = paymentInDb.received?.receivedWith ?: emptySet() + val newReceivedWith = existingReceivedWith + receivedWith + val (receivedWithType, receivedWithBlob) = newReceivedWith.mapToDb() ?: (null to null) + queries.updateReceived( + received_at = receivedAt, + received_with_type = receivedWithType, + received_with_blob = receivedWithBlob, + payment_hash = paymentHash.toByteArray() + ) + } + } + + fun setLocked(paymentHash: ByteVector32, lockedAt: Long) { + database.transaction { + val paymentInDb = queries.get( + payment_hash = paymentHash.toByteArray(), + mapper = Companion::mapIncomingPayment + ).executeAsOneOrNull() + val newReceivedWith = paymentInDb?.received?.receivedWith?.map { + when (it) { + is IncomingPayment.ReceivedWith.NewChannel -> it.copy(lockedAt = lockedAt) + is IncomingPayment.ReceivedWith.SpliceIn -> it.copy(lockedAt = lockedAt) + else -> it + } + } + val (newReceivedWithType, newReceivedWithBlob) = newReceivedWith?.mapToDb() + ?: (null to null) + queries.updateReceived( + // we override the previous received_at timestamp to trigger a refresh of the payment's cache data + // because the list-all query feeding the cache uses `received_at` for incoming payments + received_at = lockedAt, + received_with_type = newReceivedWithType, + received_with_blob = newReceivedWithBlob, + payment_hash = paymentHash.toByteArray() + ) + } + } + + fun setConfirmed(paymentHash: ByteVector32, confirmedAt: Long) { + database.transaction { + val paymentInDb = queries.get( + payment_hash = paymentHash.toByteArray(), + mapper = Companion::mapIncomingPayment + ).executeAsOneOrNull() + val newReceivedWith = paymentInDb?.received?.receivedWith?.map { + when (it) { + is IncomingPayment.ReceivedWith.NewChannel -> it.copy(confirmedAt = confirmedAt) + is IncomingPayment.ReceivedWith.SpliceIn -> it.copy(confirmedAt = confirmedAt) + else -> it + } + } + val (newReceivedWithType, newReceivedWithBlob) = newReceivedWith?.mapToDb() + ?: (null to null) + queries.updateReceived( + received_at = paymentInDb?.received?.receivedAt, + received_with_type = newReceivedWithType, + received_with_blob = newReceivedWithBlob, + payment_hash = paymentHash.toByteArray() + ) + } + } + + fun getIncomingPayment(paymentHash: ByteVector32): IncomingPayment? { + return queries.get(payment_hash = paymentHash.toByteArray(), Companion::mapIncomingPayment).executeAsOneOrNull() + } + + fun getOldestReceivedDate(): Long? { + return queries.getOldestReceivedDate().executeAsOneOrNull() + } + + fun listAllNotConfirmed(): Flow> { + return queries.listAllNotConfirmed(Companion::mapIncomingPayment).asFlow().mapToList(Dispatchers.IO) + } + + fun listExpiredPayments(fromCreatedAt: Long, toCreatedAt: Long): List { + return queries.listAllWithin(fromCreatedAt, toCreatedAt, Companion::mapIncomingPayment).executeAsList().filter { + it.received == null + } + } + + /** Try to delete an incoming payment ; return true if an element was deleted, false otherwise. */ + fun deleteIncomingPayment(paymentHash: ByteVector32): Boolean { + return database.transactionWithResult { + queries.delete(payment_hash = paymentHash.toByteArray()) + queries.changes().executeAsOne() != 0L + } + } + + companion object { + fun mapIncomingPayment( + @Suppress("UNUSED_PARAMETER") payment_hash: ByteArray, + preimage: ByteArray, + created_at: Long, + origin_type: IncomingOriginTypeVersion, + origin_blob: ByteArray, + @Suppress("UNUSED_PARAMETER") received_amount_msat: Long?, + received_at: Long?, + received_with_type: IncomingReceivedWithTypeVersion?, + received_with_blob: ByteArray?, + ): IncomingPayment { + return IncomingPayment( + preimage = ByteVector32(preimage), + origin = IncomingOriginData.deserialize(origin_type, origin_blob), + received = mapIncomingReceived(received_at, received_with_type, received_with_blob), + createdAt = created_at + ) + } + + private fun mapIncomingReceived( + received_at: Long?, + received_with_type: IncomingReceivedWithTypeVersion?, + received_with_blob: ByteArray?, + ): IncomingPayment.Received? { + return when { + received_at == null && received_with_type == null && received_with_blob == null -> null + received_at != null && received_with_type != null && received_with_blob != null -> { + IncomingPayment.Received( + receivedWith = IncomingReceivedWithData.deserialize(received_with_type, received_with_blob), + receivedAt = received_at + ) + } + received_at != null -> { + IncomingPayment.Received( + receivedWith = emptyList(), + receivedAt = received_at + ) + } + else -> throw UnreadableIncomingReceivedWith(received_at, received_with_type, received_with_blob) + } + } + + private fun mapTxIdPaymentHash( + tx_id: ByteArray, + payment_hash: ByteArray + ): Pair { + return tx_id.byteVector32() to payment_hash.byteVector32() + } + } +} +class IncomingPaymentNotFound(paymentHash: ByteVector32) : RuntimeException("missing payment for payment_hash=$paymentHash") +class UnreadableIncomingReceivedWith(receivedAt: Long?, receivedWithTypeVersion: IncomingReceivedWithTypeVersion?, receivedWithBlob: ByteArray?) : + RuntimeException("unreadable received with data [ receivedAt=$receivedAt, receivedWithTypeVersion=$receivedWithTypeVersion, receivedWithBlob=$receivedWithBlob ]") \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingReceivedWithType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingReceivedWithType.kt new file mode 100644 index 0000000..9e58443 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/IncomingReceivedWithType.kt @@ -0,0 +1,169 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +@file:UseSerializers( + SatoshiSerializer::class, + MilliSatoshiSerializer::class, + ByteVector32Serializer::class, + UUIDSerializer::class, +) + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.Satoshi +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.MilliSatoshi +import fr.acinq.lightning.db.IncomingPayment +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector32Serializer +import fr.acinq.lightning.bin.db.serializers.v1.MilliSatoshiSerializer +import fr.acinq.lightning.bin.db.serializers.v1.UUIDSerializer +import fr.acinq.lightning.bin.db.serializers.v1.SatoshiSerializer +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.* +import kotlinx.serialization.builtins.SetSerializer + + +enum class IncomingReceivedWithTypeVersion { + MULTIPARTS_V1, +} + +sealed class IncomingReceivedWithData { + + @Serializable + sealed class Part : IncomingReceivedWithData() { + sealed class Htlc : Part() { + @Serializable + data class V0( + @Serializable val amount: MilliSatoshi, + @Serializable val channelId: ByteVector32, + val htlcId: Long + ) : Htlc() + } + + sealed class NewChannel : Part() { + /** V2 supports dual funding. New fields: service/miningFees, channel id, funding tx id, and the confirmation/lock timestamps. Id is removed. */ + @Serializable + data class V2( + @Serializable val amount: MilliSatoshi, + @Serializable val serviceFee: MilliSatoshi, + @Serializable val miningFee: Satoshi, + @Serializable val channelId: ByteVector32, + @Serializable val txId: ByteVector32, + @Serializable val confirmedAt: Long?, + @Serializable val lockedAt: Long?, + ) : NewChannel() + } + + sealed class SpliceIn : Part() { + @Serializable + data class V0( + @Serializable val amount: MilliSatoshi, + @Serializable val serviceFee: MilliSatoshi, + @Serializable val miningFee: Satoshi, + @Serializable val channelId: ByteVector32, + @Serializable val txId: ByteVector32, + @Serializable val confirmedAt: Long?, + @Serializable val lockedAt: Long?, + ) : SpliceIn() + } + + sealed class FeeCredit : Part() { + @Serializable + data class V0( + val amount: MilliSatoshi + ) : FeeCredit() + } + } + + companion object { + /** Deserializes a received-with blob from the database using the given [typeVersion]. */ + fun deserialize( + typeVersion: IncomingReceivedWithTypeVersion, + blob: ByteArray, + ): List = DbTypesHelper.decodeBlob(blob) { json, _ -> + when (typeVersion) { + IncomingReceivedWithTypeVersion.MULTIPARTS_V1 -> DbTypesHelper.polymorphicFormat.decodeFromString(SetSerializer(PolymorphicSerializer(Part::class)), json).map { + when (it) { + is Part.Htlc.V0 -> IncomingPayment.ReceivedWith.LightningPayment( + amount = it.amount, + channelId = it.channelId, + htlcId = it.htlcId + ) + is Part.NewChannel.V2 -> IncomingPayment.ReceivedWith.NewChannel( + amount = it.amount, + serviceFee = it.serviceFee, + miningFee = it.miningFee, + channelId = it.channelId, + txId = TxId(it.txId), + confirmedAt = it.confirmedAt, + lockedAt = it.lockedAt, + ) + is Part.SpliceIn.V0 -> IncomingPayment.ReceivedWith.SpliceIn( + amount = it.amount, + serviceFee = it.serviceFee, + miningFee = it.miningFee, + channelId = it.channelId, + txId = TxId(it.txId), + confirmedAt = it.confirmedAt, + lockedAt = it.lockedAt, + ) + is Part.FeeCredit.V0 -> IncomingPayment.ReceivedWith.FeeCreditPayment( + amount = it.amount + ) + } + } + } + } + } +} + +/** Only serialize received_with into the [IncomingReceivedWithTypeVersion.MULTIPARTS_V1] type. */ +fun List.mapToDb(): Pair? = map { + when (it) { + is IncomingPayment.ReceivedWith.LightningPayment -> IncomingReceivedWithData.Part.Htlc.V0( + amount = it.amount, + channelId = it.channelId, + htlcId = it.htlcId + ) + is IncomingPayment.ReceivedWith.NewChannel -> IncomingReceivedWithData.Part.NewChannel.V2( + amount = it.amount, + serviceFee = it.serviceFee, + miningFee = it.miningFee, + channelId = it.channelId, + txId = it.txId.value, + confirmedAt = it.confirmedAt, + lockedAt = it.lockedAt, + ) + is IncomingPayment.ReceivedWith.SpliceIn -> IncomingReceivedWithData.Part.SpliceIn.V0( + amount = it.amount, + serviceFee = it.serviceFee, + miningFee = it.miningFee, + channelId = it.channelId, + txId = it.txId.value, + confirmedAt = it.confirmedAt, + lockedAt = it.lockedAt, + ) + is IncomingPayment.ReceivedWith.FeeCreditPayment -> IncomingReceivedWithData.Part.FeeCredit.V0( + amount = it.amount + ) + } +}.takeIf { it.isNotEmpty() }?.toSet()?.let { + IncomingReceivedWithTypeVersion.MULTIPARTS_V1 to DbTypesHelper.polymorphicFormat.encodeToString( + SetSerializer(PolymorphicSerializer(IncomingReceivedWithData.Part::class)), it + ).toByteArray(Charsets.UTF_8) +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/LinkTxToPaymentQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/LinkTxToPaymentQueries.kt new file mode 100644 index 0000000..43062b2 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/LinkTxToPaymentQueries.kt @@ -0,0 +1,51 @@ +/* + * Copyright 2023 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import app.cash.sqldelight.coroutines.asFlow +import app.cash.sqldelight.coroutines.mapToList +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.bin.db.WalletPaymentId +import fr.acinq.phoenix.db.PaymentsDatabase +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.IO +import kotlinx.coroutines.flow.* + +class LinkTxToPaymentQueries(val database: PaymentsDatabase) { + private val linkTxQueries = database.linkTxToPaymentQueries + + fun listUnconfirmedTxs(): Flow> { + return linkTxQueries.listUnconfirmed().asFlow().mapToList(Dispatchers.IO) + } + + fun listWalletPaymentIdsForTx(txId: TxId): List { + return linkTxQueries.getPaymentIdForTx(tx_id = txId.value.toByteArray()).executeAsList() + .mapNotNull { WalletPaymentId.create(it.type, it.id) } + } + + fun linkTxToPayment(txId: TxId, walletPaymentId: WalletPaymentId) { + linkTxQueries.linkTxToPayment(tx_id = txId.value.toByteArray(), type = walletPaymentId.dbType.value, id = walletPaymentId.dbId) + } + + fun setConfirmed(txId: TxId, confirmedAt: Long) { + linkTxQueries.setConfirmed(tx_id = txId.value.toByteArray(), confirmed_at = confirmedAt) + } + + fun setLocked(txId: TxId, lockedAt: Long) { + linkTxQueries.setLocked(tx_id = txId.value.toByteArray(), locked_at = lockedAt) + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingDetailsType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingDetailsType.kt new file mode 100644 index 0000000..a6b5029 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingDetailsType.kt @@ -0,0 +1,80 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +@file:UseSerializers( + SatoshiSerializer::class, + ByteVector32Serializer::class, +) + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.Satoshi +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector32Serializer +import fr.acinq.lightning.bin.db.serializers.v1.SatoshiSerializer +import fr.acinq.lightning.db.LightningOutgoingPayment +import fr.acinq.lightning.payment.Bolt11Invoice +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.Serializable +import kotlinx.serialization.UseSerializers +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json + + +enum class OutgoingDetailsTypeVersion { + NORMAL_V0, + KEYSEND_V0, + SWAPOUT_V0, +} + +sealed class OutgoingDetailsData { + + sealed class Normal : OutgoingDetailsData() { + @Serializable + data class V0(val paymentRequest: String) : Normal() + } + + sealed class KeySend : OutgoingDetailsData() { + @Serializable + data class V0(@Serializable val preimage: ByteVector32) : KeySend() + } + + sealed class SwapOut : OutgoingDetailsData() { + @Serializable + data class V0(val address: String, val paymentRequest: String, @Serializable val swapOutFee: Satoshi) : SwapOut() + } + + companion object { + /** Deserialize the details of an outgoing payment. Return null if the details is for a legacy channel closing payment (see [deserializeLegacyClosingDetails]). */ + fun deserialize(typeVersion: OutgoingDetailsTypeVersion, blob: ByteArray): LightningOutgoingPayment.Details? = DbTypesHelper.decodeBlob(blob) { json, format -> + when (typeVersion) { + OutgoingDetailsTypeVersion.NORMAL_V0 -> format.decodeFromString(json).let { LightningOutgoingPayment.Details.Normal(Bolt11Invoice.read(it.paymentRequest).get()) } + OutgoingDetailsTypeVersion.KEYSEND_V0 -> format.decodeFromString(json).let { LightningOutgoingPayment.Details.KeySend(it.preimage) } + OutgoingDetailsTypeVersion.SWAPOUT_V0 -> format.decodeFromString(json).let { LightningOutgoingPayment.Details.SwapOut(it.address, Bolt11Invoice.read(it.paymentRequest).get(), it.swapOutFee) } + } + } + } +} + +fun LightningOutgoingPayment.Details.mapToDb(): Pair = when (this) { + is LightningOutgoingPayment.Details.Normal -> OutgoingDetailsTypeVersion.NORMAL_V0 to + Json.encodeToString(OutgoingDetailsData.Normal.V0(paymentRequest.write())).toByteArray(Charsets.UTF_8) + is LightningOutgoingPayment.Details.KeySend -> OutgoingDetailsTypeVersion.KEYSEND_V0 to + Json.encodeToString(OutgoingDetailsData.KeySend.V0(preimage)).toByteArray(Charsets.UTF_8) + is LightningOutgoingPayment.Details.SwapOut -> OutgoingDetailsTypeVersion.SWAPOUT_V0 to + Json.encodeToString(OutgoingDetailsData.SwapOut.V0(address, paymentRequest.write(), swapOutFee)).toByteArray(Charsets.UTF_8) +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartClosingType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartClosingType.kt new file mode 100644 index 0000000..4ba01bf --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartClosingType.kt @@ -0,0 +1,48 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.lightning.db.ChannelCloseOutgoingPayment +import fr.acinq.lightning.db.ChannelClosingType +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.Serializable +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json + + +enum class OutgoingPartClosingInfoTypeVersion { + // basic type, containing only a [ChannelClosingType] field + CLOSING_INFO_V0, +} + +sealed class OutgoingPartClosingInfoData { + + @Serializable + data class V0(val closingType: ChannelClosingType) + + companion object { + fun deserialize(typeVersion: OutgoingPartClosingInfoTypeVersion, blob: ByteArray): ChannelClosingType = DbTypesHelper.decodeBlob(blob) { json, format -> + when (typeVersion) { + OutgoingPartClosingInfoTypeVersion.CLOSING_INFO_V0 -> format.decodeFromString(json).closingType + } + } + } +} + +fun ChannelCloseOutgoingPayment.mapClosingTypeToDb() = OutgoingPartClosingInfoTypeVersion.CLOSING_INFO_V0 to + Json.encodeToString(OutgoingPartClosingInfoData.V0(this.closingType)).toByteArray(Charsets.UTF_8) diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartStatusType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartStatusType.kt new file mode 100644 index 0000000..801a489 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingPartStatusType.kt @@ -0,0 +1,72 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +@file:UseSerializers( + ByteVector32Serializer::class, +) + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector32Serializer +import fr.acinq.lightning.db.LightningOutgoingPayment +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.Serializable +import kotlinx.serialization.UseSerializers +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json + + +enum class OutgoingPartStatusTypeVersion { + SUCCEEDED_V0, + FAILED_V0, +} + +sealed class OutgoingPartStatusData { + + sealed class Succeeded : OutgoingPartStatusData() { + @Serializable + data class V0(@Serializable val preimage: ByteVector32) : Succeeded() + } + + sealed class Failed : OutgoingPartStatusData() { + @Serializable + data class V0(val remoteFailureCode: Int?, val details: String) : Failed() + } + + companion object { + fun deserialize( + typeVersion: OutgoingPartStatusTypeVersion, + blob: ByteArray, completedAt: Long + ): LightningOutgoingPayment.Part.Status = DbTypesHelper.decodeBlob(blob) { json, format -> + when (typeVersion) { + OutgoingPartStatusTypeVersion.SUCCEEDED_V0 -> format.decodeFromString(json).let { + LightningOutgoingPayment.Part.Status.Succeeded(it.preimage, completedAt) + } + OutgoingPartStatusTypeVersion.FAILED_V0 -> format.decodeFromString(json).let { + LightningOutgoingPayment.Part.Status.Failed(it.remoteFailureCode, it.details, completedAt) + } + } + } + } +} + +fun LightningOutgoingPayment.Part.Status.Succeeded.mapToDb() = OutgoingPartStatusTypeVersion.SUCCEEDED_V0 to + Json.encodeToString(OutgoingPartStatusData.Succeeded.V0(preimage)).toByteArray(Charsets.UTF_8) + +fun LightningOutgoingPayment.Part.Status.Failed.mapToDb() = OutgoingPartStatusTypeVersion.FAILED_V0 to + Json.encodeToString(OutgoingPartStatusData.Failed.V0(remoteFailureCode, details)).toByteArray(Charsets.UTF_8) diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingQueries.kt new file mode 100644 index 0000000..2b2db72 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingQueries.kt @@ -0,0 +1,373 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import app.cash.sqldelight.ColumnAdapter +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.PublicKey +import fr.acinq.bitcoin.utils.Either +import fr.acinq.lightning.MilliSatoshi +import fr.acinq.lightning.ShortChannelId +import fr.acinq.lightning.channel.ChannelException +import fr.acinq.lightning.db.ChannelCloseOutgoingPayment +import fr.acinq.lightning.db.HopDesc +import fr.acinq.lightning.db.LightningOutgoingPayment +import fr.acinq.lightning.db.OutgoingPayment +import fr.acinq.lightning.payment.OutgoingPaymentFailure +import fr.acinq.lightning.utils.* +import fr.acinq.lightning.wire.FailureMessage +import fr.acinq.phoenix.db.PaymentsDatabase +import fr.acinq.secp256k1.Hex + +class OutgoingQueries(val database: PaymentsDatabase) { + + private val queries = database.outgoingPaymentsQueries + + fun addLightningParts(parentId: UUID, parts: List) { + if (parts.isEmpty()) return + database.transaction { + parts.map { + // This will throw an exception if the sqlite foreign-key-constraint is violated. + queries.insertLightningPart( + part_id = it.id.toString(), + part_parent_id = parentId.toString(), + part_amount_msat = it.amount.msat, + part_route = it.route, + part_created_at = it.createdAt + ) + } + } + } + + fun addLightningOutgoingPayment(payment: LightningOutgoingPayment) { + val (detailsTypeVersion, detailsData) = payment.details.mapToDb() + database.transaction(noEnclosing = false) { + queries.insertPayment( + id = payment.id.toString(), + recipient_amount_msat = payment.recipientAmount.msat, + recipient_node_id = payment.recipient.toString(), + payment_hash = payment.details.paymentHash.toByteArray(), + created_at = payment.createdAt, + details_type = detailsTypeVersion, + details_blob = detailsData + ) + payment.parts.map { + queries.insertLightningPart( + part_id = it.id.toString(), + part_parent_id = payment.id.toString(), + part_amount_msat = it.amount.msat, + part_route = it.route, + part_created_at = it.createdAt + ) + } + } + } + + fun completePayment(id: UUID, completed: LightningOutgoingPayment.Status.Completed): Boolean { + var result = true + database.transaction { + val (statusType, statusBlob) = completed.mapToDb() + queries.updatePayment( + id = id.toString(), + completed_at = completed.completedAt, + status_type = statusType, + status_blob = statusBlob + ) + if (queries.changes().executeAsOne() != 1L) { + result = false + } + } + return result + } + + fun updateLightningPart( + partId: UUID, + preimage: ByteVector32, + completedAt: Long + ): Boolean { + var result = true + val (statusTypeVersion, statusData) = LightningOutgoingPayment.Part.Status.Succeeded(preimage).mapToDb() + database.transaction { + queries.updateLightningPart( + part_id = partId.toString(), + part_status_type = statusTypeVersion, + part_status_blob = statusData, + part_completed_at = completedAt + ) + if (queries.changes().executeAsOne() != 1L) { + result = false + } + } + return result + } + + fun updateLightningPart( + partId: UUID, + failure: Either, + completedAt: Long + ): Boolean { + var result = true + val (statusTypeVersion, statusData) = OutgoingPaymentFailure.convertFailure(failure).mapToDb() + database.transaction { + queries.updateLightningPart( + part_id = partId.toString(), + part_status_type = statusTypeVersion, + part_status_blob = statusData, + part_completed_at = completedAt + ) + if (queries.changes().executeAsOne() != 1L) { + result = false + } + } + return result + } + + /** This method will ignore any parts that are not proper [LightningOutgoingPayment]. */ + fun getPaymentFromPartId(partId: UUID): LightningOutgoingPayment? { + return queries.getLightningPart(part_id = partId.toString()).executeAsOneOrNull()?.let { part -> + queries.getPayment(id = part.part_parent_id, Companion::mapLightningOutgoingPayment).executeAsList() + }?.filterIsInstance()?.let { + // first ignore any legacy channel closing, then group by parent id + groupByRawLightningOutgoing(it).firstOrNull() + }?.let { + filterUselessParts(it) + // resulting payment must contain the request part id, or should be null + .takeIf { p -> p.parts.map { it.id }.contains(partId) } + } + } + + fun getPaymentWithoutParts(id: UUID): LightningOutgoingPayment? { + return queries.getPaymentWithoutParts( + id = id.toString(), + mapper = Companion::mapLightningOutgoingPaymentWithoutParts + ).executeAsOneOrNull() + } + + /** + * Returns a [LightningOutgoingPayment] for this id - if instead we find legacy converted to a new type (such as + * [ChannelCloseOutgoingPayment], this payment is ignored and we return null instead. + */ + fun getPaymentStrict(id: UUID): LightningOutgoingPayment? = queries.getPayment( + id = id.toString(), + mapper = Companion::mapLightningOutgoingPayment + ).executeAsList().let { parts -> + // only take regular LN payments parts, and group them + parts.filterIsInstance().let { + groupByRawLightningOutgoing(it).firstOrNull() + }?.let { + filterUselessParts(it) + } + } + + /** + * May return a [ChannelCloseOutgoingPayment] instead of the expected [LightningOutgoingPayment]. That's because + * channel closing used to be stored as [LightningOutgoingPayment] with special closing parts. We convert those to + * the propert object type. + */ + fun getPaymentRelaxed(id: UUID): OutgoingPayment? = queries.getPayment( + id = id.toString(), + mapper = Companion::mapLightningOutgoingPayment + ).executeAsList().let { parts -> + // this payment may be a legacy channel closing - otherwise, only take regular LN payment parts, and group them + parts.firstOrNull { it is ChannelCloseOutgoingPayment } ?: parts.filterIsInstance().let { + groupByRawLightningOutgoing(it).firstOrNull() + }?.let { + filterUselessParts(it) + } + } + + fun getOldestCompletedDate(): Long? { + return queries.getOldestCompletedDate().executeAsOneOrNull() + } + + fun listLightningOutgoingPayments(paymentHash: ByteVector32): List { + return queries.listPaymentsForPaymentHash(paymentHash.toByteArray(), Companion::mapLightningOutgoingPayment).executeAsList() + .filterIsInstance() + .let { groupByRawLightningOutgoing(it) } + } + + /** Group a list of outgoing payments by parent id and parts. */ + private fun groupByRawLightningOutgoing(payments: List) = payments + .takeIf { it.isNotEmpty() } + ?.groupBy { it.id } + ?.values + ?.map { group -> group.first().copy(parts = group.flatMap { it.parts }) } + ?: emptyList() + + /** Get a payment without its failed/pending parts. */ + private fun filterUselessParts(payment: LightningOutgoingPayment): LightningOutgoingPayment = when (payment.status) { + is LightningOutgoingPayment.Status.Completed.Succeeded.OffChain -> { + payment.copy(parts = payment.parts.filter { + it.status is LightningOutgoingPayment.Part.Status.Succeeded + }) + } + else -> payment + } + + companion object { + @Suppress("UNUSED_PARAMETER") + fun mapLightningOutgoingPaymentWithoutParts( + id: String, + recipient_amount_msat: Long, + recipient_node_id: String, + payment_hash: ByteArray, + details_type: OutgoingDetailsTypeVersion, + details_blob: ByteArray, + created_at: Long, + completed_at: Long?, + status_type: OutgoingStatusTypeVersion?, + status_blob: ByteArray? + ): LightningOutgoingPayment { + val details = OutgoingDetailsData.deserialize(details_type, details_blob) + return if (details != null) { + LightningOutgoingPayment( + id = UUID.fromString(id), + recipientAmount = MilliSatoshi(recipient_amount_msat), + recipient = PublicKey.parse(Hex.decode(recipient_node_id)), + details = details, + parts = listOf(), + status = mapPaymentStatus(status_type, status_blob, completed_at), + createdAt = created_at + ) + } else throw IllegalArgumentException("cannot handle closing payment at this stage, use LegacyChannelCloseHelper") + } + + @Suppress("UNUSED_PARAMETER") + fun mapLightningOutgoingPayment( + id: String, + recipient_amount_msat: Long, + recipient_node_id: String, + payment_hash: ByteArray, + details_type: OutgoingDetailsTypeVersion, + details_blob: ByteArray, + created_at: Long, + completed_at: Long?, + status_type: OutgoingStatusTypeVersion?, + status_blob: ByteArray?, + // lightning parts data, may be null + lightning_part_id: String?, + lightning_part_amount_msat: Long?, + lightning_part_route: List?, + lightning_part_created_at: Long?, + lightning_part_completed_at: Long?, + lightning_part_status_type: OutgoingPartStatusTypeVersion?, + lightning_part_status_blob: ByteArray?, + // closing tx parts data, may be null + closingtx_part_id: String?, + closingtx_part_tx_id: ByteArray?, + closingtx_part_amount_sat: Long?, + closingtx_part_closing_info_type: OutgoingPartClosingInfoTypeVersion?, + closingtx_part_closing_info_blob: ByteArray?, + closingtx_part_created_at: Long? + ): OutgoingPayment { + + val parts = if (lightning_part_id != null && lightning_part_amount_msat != null && lightning_part_route != null && lightning_part_created_at != null) { + listOf( + mapLightningPart( + id = lightning_part_id, + amountMsat = lightning_part_amount_msat, + route = lightning_part_route, + createdAt = lightning_part_created_at, + completedAt = lightning_part_completed_at, + statusType = lightning_part_status_type, + statusBlob = lightning_part_status_blob + ) + ) + } else emptyList() + + return mapLightningOutgoingPaymentWithoutParts( + id = id, + recipient_amount_msat = recipient_amount_msat, + recipient_node_id = recipient_node_id, + payment_hash = payment_hash, + details_type = details_type, + details_blob = details_blob, + created_at = created_at, + completed_at = completed_at, + status_type = status_type, + status_blob = status_blob + ).copy( + parts = parts + ) + } + + private fun mapLightningPart( + id: String, + amountMsat: Long, + route: List, + createdAt: Long, + completedAt: Long?, + statusType: OutgoingPartStatusTypeVersion?, + statusBlob: ByteArray? + ): LightningOutgoingPayment.Part { + return LightningOutgoingPayment.Part( + id = UUID.fromString(id), + amount = MilliSatoshi(amountMsat), + route = route, + status = mapLightningPartStatus( + statusType = statusType, + statusBlob = statusBlob, + completedAt = completedAt + ), + createdAt = createdAt + ) + } + + private fun mapPaymentStatus( + statusType: OutgoingStatusTypeVersion?, + statusBlob: ByteArray?, + completedAt: Long?, + ): LightningOutgoingPayment.Status = when { + completedAt == null && statusType == null && statusBlob == null -> LightningOutgoingPayment.Status.Pending + completedAt != null && statusType != null && statusBlob != null -> OutgoingStatusData.deserialize(statusType, statusBlob, completedAt) + else -> throw UnhandledOutgoingStatus(completedAt, statusType, statusBlob) + } + + private fun mapLightningPartStatus( + statusType: OutgoingPartStatusTypeVersion?, + statusBlob: ByteArray?, + completedAt: Long?, + ): LightningOutgoingPayment.Part.Status = when { + completedAt == null && statusType == null && statusBlob == null -> LightningOutgoingPayment.Part.Status.Pending + completedAt != null && statusType != null && statusBlob != null -> OutgoingPartStatusData.deserialize(statusType, statusBlob, completedAt) + else -> throw UnhandledOutgoingPartStatus(statusType, statusBlob, completedAt) + } + + val hopDescAdapter: ColumnAdapter, String> = object : ColumnAdapter, String> { + override fun decode(databaseValue: String): List = when { + databaseValue.isEmpty() -> listOf() + else -> databaseValue.split(";").map { hop -> + val els = hop.split(":") + val n1 = PublicKey.parse(Hex.decode(els[0])) + val n2 = PublicKey.parse(Hex.decode(els[1])) + val cid = els[2].takeIf { it.isNotBlank() }?.run { ShortChannelId(this) } + HopDesc(n1, n2, cid) + } + } + + override fun encode(value: List): String = value.joinToString(";") { + "${it.nodeId}:${it.nextNodeId}:${it.shortChannelId ?: ""}" + } + } + } +} + +data class UnhandledOutgoingStatus(val completedAt: Long?, val statusTypeVersion: OutgoingStatusTypeVersion?, val statusData: ByteArray?) : + RuntimeException("cannot map outgoing payment status data with completed_at=$completedAt status_type=$statusTypeVersion status=$statusData") + +data class UnhandledOutgoingPartStatus(val status_type: OutgoingPartStatusTypeVersion?, val status_blob: ByteArray?, val completedAt: Long?) : + RuntimeException("cannot map outgoing part status data [ completed_at=$completedAt status_type=$status_type status_blob=$status_blob]") \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingStatusType.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingStatusType.kt new file mode 100644 index 0000000..d44ef4d --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/OutgoingStatusType.kt @@ -0,0 +1,110 @@ +/* + * Copyright 2021 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +@file:UseSerializers( + SatoshiSerializer::class, + ByteVector32Serializer::class, +) + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.Satoshi +import fr.acinq.lightning.bin.db.payments.DbTypesHelper.decodeBlob +import fr.acinq.lightning.bin.db.serializers.v1.ByteVector32Serializer +import fr.acinq.lightning.bin.db.serializers.v1.SatoshiSerializer +import fr.acinq.lightning.db.LightningOutgoingPayment +import fr.acinq.lightning.payment.FinalFailure +import io.ktor.utils.io.charsets.* +import io.ktor.utils.io.core.* +import kotlinx.serialization.Serializable +import kotlinx.serialization.UseSerializers +import kotlinx.serialization.decodeFromString +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json + +enum class OutgoingStatusTypeVersion { + SUCCEEDED_OFFCHAIN_V0, + FAILED_V0, +} + +sealed class OutgoingStatusData { + + sealed class SucceededOffChain : OutgoingStatusData() { + @Serializable + data class V0(@Serializable val preimage: ByteVector32) : SucceededOffChain() + } + + sealed class SucceededOnChain : OutgoingStatusData() { + @Serializable + data class V0( + val txIds: List<@Serializable ByteVector32>, + @Serializable val claimed: Satoshi, + val closingType: String + ) : SucceededOnChain() + + @Serializable + object V1 : SucceededOnChain() + } + + sealed class Failed : OutgoingStatusData() { + @Serializable + data class V0(val reason: String) : Failed() + } + + companion object { + + /** Extract valuable data from old outgoing payments status that represent closing transactions. */ + fun deserializeLegacyClosingStatus(blob: ByteArray): SucceededOnChain.V0 = decodeBlob(blob) { json, format -> + val data = format.decodeFromString(json) + data + } + + fun deserialize(typeVersion: OutgoingStatusTypeVersion, blob: ByteArray, completedAt: Long): LightningOutgoingPayment.Status = decodeBlob(blob) { json, format -> + @Suppress("DEPRECATION") + when (typeVersion) { + OutgoingStatusTypeVersion.SUCCEEDED_OFFCHAIN_V0 -> format.decodeFromString(json).let { + LightningOutgoingPayment.Status.Completed.Succeeded.OffChain(it.preimage, completedAt) + } + OutgoingStatusTypeVersion.FAILED_V0 -> format.decodeFromString(json).let { + LightningOutgoingPayment.Status.Completed.Failed(deserializeFinalFailure(it.reason), completedAt) + } + } + } + + internal fun serializeFinalFailure(failure: FinalFailure): String = failure::class.simpleName ?: "UnknownError" + + private fun deserializeFinalFailure(failure: String): FinalFailure = when (failure) { + FinalFailure.InvalidPaymentAmount::class.simpleName -> FinalFailure.InvalidPaymentAmount + FinalFailure.InvalidPaymentId::class.simpleName -> FinalFailure.InvalidPaymentId + FinalFailure.NoAvailableChannels::class.simpleName -> FinalFailure.NoAvailableChannels + FinalFailure.InsufficientBalance::class.simpleName -> FinalFailure.InsufficientBalance + FinalFailure.NoRouteToRecipient::class.simpleName -> FinalFailure.NoRouteToRecipient + FinalFailure.RecipientUnreachable::class.simpleName -> FinalFailure.RecipientUnreachable + FinalFailure.RetryExhausted::class.simpleName -> FinalFailure.RetryExhausted + FinalFailure.WalletRestarted::class.simpleName -> FinalFailure.WalletRestarted + else -> FinalFailure.UnknownError + } + } +} + +fun LightningOutgoingPayment.Status.Completed.mapToDb(): Pair = when (this) { + is LightningOutgoingPayment.Status.Completed.Succeeded.OffChain -> OutgoingStatusTypeVersion.SUCCEEDED_OFFCHAIN_V0 to + Json.encodeToString(OutgoingStatusData.SucceededOffChain.V0(preimage)).toByteArray(Charsets.UTF_8) + is LightningOutgoingPayment.Status.Completed.Failed -> OutgoingStatusTypeVersion.FAILED_V0 to + Json.encodeToString(OutgoingStatusData.Failed.V0(OutgoingStatusData.serializeFinalFailure(reason))).toByteArray(Charsets.UTF_8) +} + diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceCpfpOutgoingQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceCpfpOutgoingQueries.kt new file mode 100644 index 0000000..b675991 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceCpfpOutgoingQueries.kt @@ -0,0 +1,83 @@ +/* + * Copyright 2023 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.db.SpliceCpfpOutgoingPayment +import fr.acinq.lightning.utils.UUID +import fr.acinq.lightning.utils.sat +import fr.acinq.lightning.utils.toByteVector32 +import fr.acinq.phoenix.db.PaymentsDatabase + +class SpliceCpfpOutgoingQueries(val database: PaymentsDatabase) { + private val cpfpQueries = database.spliceCpfpOutgoingPaymentsQueries + + fun addCpfpPayment(payment: SpliceCpfpOutgoingPayment) { + database.transaction { + cpfpQueries.insertCpfp( + id = payment.id.toString(), + mining_fees_sat = payment.miningFees.sat, + channel_id = payment.channelId.toByteArray(), + tx_id = payment.txId.value.toByteArray(), + created_at = payment.createdAt, + confirmed_at = payment.confirmedAt, + locked_at = payment.lockedAt + ) + } + } + + fun getCpfp(id: UUID): SpliceCpfpOutgoingPayment? { + return cpfpQueries.getCpfp( + id = id.toString(), + mapper = Companion::mapCpfp + ).executeAsOneOrNull() + } + + fun setConfirmed(id: UUID, confirmedAt: Long) { + database.transaction { + cpfpQueries.setConfirmed(confirmed_at = confirmedAt, id = id.toString()) + } + } + + fun setLocked(id: UUID, lockedAt: Long) { + database.transaction { + cpfpQueries.setLocked(locked_at = lockedAt, id = id.toString()) + } + } + + private companion object { + fun mapCpfp( + id: String, + mining_fees_sat: Long, + channel_id: ByteArray, + tx_id: ByteArray, + created_at: Long, + confirmed_at: Long?, + locked_at: Long? + ): SpliceCpfpOutgoingPayment { + return SpliceCpfpOutgoingPayment( + id = UUID.fromString(id), + miningFees = mining_fees_sat.sat, + channelId = channel_id.toByteVector32(), + txId = TxId(tx_id), + createdAt = created_at, + confirmedAt = confirmed_at, + lockedAt = locked_at + ) + } + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceOutgoingQueries.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceOutgoingQueries.kt new file mode 100644 index 0000000..7d8c632 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/payments/SpliceOutgoingQueries.kt @@ -0,0 +1,89 @@ +/* + * Copyright 2023 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.payments + +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.db.SpliceOutgoingPayment +import fr.acinq.lightning.utils.UUID +import fr.acinq.lightning.utils.sat +import fr.acinq.lightning.utils.toByteVector32 +import fr.acinq.phoenix.db.PaymentsDatabase + +class SpliceOutgoingQueries(val database: PaymentsDatabase) { + private val spliceOutQueries = database.spliceOutgoingPaymentsQueries + + fun addSpliceOutgoingPayment(payment: SpliceOutgoingPayment) { + database.transaction { + spliceOutQueries.insertSpliceOutgoing( + id = payment.id.toString(), + recipient_amount_sat = payment.recipientAmount.sat, + address = payment.address, + mining_fees_sat = payment.miningFees.sat, + channel_id = payment.channelId.toByteArray(), + tx_id = payment.txId.value.toByteArray(), + created_at = payment.createdAt, + confirmed_at = payment.confirmedAt, + locked_at = payment.lockedAt + ) + } + } + + fun getSpliceOutPayment(id: UUID): SpliceOutgoingPayment? { + return spliceOutQueries.getSpliceOutgoing( + id = id.toString(), + mapper = Companion::mapSpliceOutgoingPayment + ).executeAsOneOrNull() + } + + fun setConfirmed(id: UUID, confirmedAt: Long) { + database.transaction { + spliceOutQueries.setConfirmed(confirmed_at = confirmedAt, id = id.toString()) + } + } + + fun setLocked(id: UUID, lockedAt: Long) { + database.transaction { + spliceOutQueries.setLocked(locked_at = lockedAt, id = id.toString()) + } + } + + companion object { + fun mapSpliceOutgoingPayment( + id: String, + recipient_amount_sat: Long, + address: String, + mining_fees_sat: Long, + tx_id: ByteArray, + channel_id: ByteArray, + created_at: Long, + confirmed_at: Long?, + locked_at: Long? + ): SpliceOutgoingPayment { + return SpliceOutgoingPayment( + id = UUID.fromString(id), + recipientAmount = recipient_amount_sat.sat, + address = address, + miningFees = mining_fees_sat.sat, + txId = TxId(tx_id), + channelId = channel_id.toByteVector32(), + createdAt = created_at, + confirmedAt = confirmed_at, + lockedAt = locked_at + ) + } + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/AbstractStringSerializer.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/AbstractStringSerializer.kt new file mode 100644 index 0000000..369e0c4 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/AbstractStringSerializer.kt @@ -0,0 +1,40 @@ +/* + * Copyright 2024 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.serializers.v1 + +import kotlinx.serialization.KSerializer +import kotlinx.serialization.descriptors.PrimitiveKind +import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor +import kotlinx.serialization.descriptors.SerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder + +abstract class AbstractStringSerializer( + name: String, + private val toString: (T) -> String, + private val fromString: (String) -> T +) : KSerializer { + override val descriptor: SerialDescriptor = PrimitiveSerialDescriptor(name, PrimitiveKind.STRING) + + override fun serialize(encoder: Encoder, value: T) { + encoder.encodeString(toString(value)) + } + + override fun deserialize(decoder: Decoder): T { + return fromString(decoder.decodeString()) + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/ByteVectorSerializer.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/ByteVectorSerializer.kt new file mode 100644 index 0000000..9d2f793 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/ByteVectorSerializer.kt @@ -0,0 +1,41 @@ +/* + * Copyright 2024 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.serializers.v1 + +import fr.acinq.bitcoin.ByteVector +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.ByteVector64 +import fr.acinq.lightning.bin.db.serializers.v1.AbstractStringSerializer + + +object ByteVector32Serializer : AbstractStringSerializer( + name = "ByteVector32", + toString = ByteVector32::toHex, + fromString = ::ByteVector32 +) + +object ByteVector64Serializer : AbstractStringSerializer( + name = "ByteVector64", + toString = ByteVector64::toHex, + fromString = ::ByteVector64 +) + +object ByteVectorSerializer : AbstractStringSerializer( + name = "ByteVector", + toString = ByteVector::toHex, + fromString = ::ByteVector +) diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/MilliSatoshiSerializer.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/MilliSatoshiSerializer.kt new file mode 100644 index 0000000..4dbac14 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/MilliSatoshiSerializer.kt @@ -0,0 +1,42 @@ +/* + * Copyright 2024 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.serializers.v1 + +import fr.acinq.lightning.MilliSatoshi +import kotlinx.serialization.KSerializer +import kotlinx.serialization.Serializable +import kotlinx.serialization.descriptors.SerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder + +object MilliSatoshiSerializer : KSerializer { + // we are using a surrogate for legacy reasons. + @Serializable + private data class MilliSatoshiSurrogate(val msat: Long) + + override val descriptor: SerialDescriptor = MilliSatoshiSurrogate.serializer().descriptor + + override fun serialize(encoder: Encoder, value: MilliSatoshi) { + val surrogate = MilliSatoshiSurrogate(msat = value.msat) + return encoder.encodeSerializableValue(MilliSatoshiSurrogate.serializer(), surrogate) + } + + override fun deserialize(decoder: Decoder): MilliSatoshi { + val surrogate = decoder.decodeSerializableValue(MilliSatoshiSurrogate.serializer()) + return MilliSatoshi(msat = surrogate.msat) + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/OutpointSerializer.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/OutpointSerializer.kt new file mode 100644 index 0000000..16a775a --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/OutpointSerializer.kt @@ -0,0 +1,30 @@ +/* + * Copyright 2024 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.serializers.v1 + +import fr.acinq.bitcoin.OutPoint +import fr.acinq.bitcoin.TxHash + +class OutpointSerializer : AbstractStringSerializer( + name = "Outpoint", + fromString = { serialized -> + serialized.split(":").let { + OutPoint(hash = TxHash(it[0]), index = it[1].toLong()) + } + }, + toString = { outpoint -> "${outpoint.hash}:${outpoint.index}" } +) diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/SatoshiSerializer.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/SatoshiSerializer.kt new file mode 100644 index 0000000..1af0b9b --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/SatoshiSerializer.kt @@ -0,0 +1,37 @@ +/* + * Copyright 2024 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.serializers.v1 + +import fr.acinq.bitcoin.Satoshi +import kotlinx.serialization.KSerializer +import kotlinx.serialization.descriptors.PrimitiveKind +import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor +import kotlinx.serialization.descriptors.SerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder + +object SatoshiSerializer : KSerializer { + override val descriptor: SerialDescriptor = PrimitiveSerialDescriptor("Satoshi", PrimitiveKind.LONG) + + override fun serialize(encoder: Encoder, value: Satoshi) { + encoder.encodeLong(value.toLong()) + } + + override fun deserialize(decoder: Decoder): Satoshi { + return Satoshi(decoder.decodeLong()) + } +} diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/UUIDSerializer.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/UUIDSerializer.kt new file mode 100644 index 0000000..bd60493 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/db/serializers/v1/UUIDSerializer.kt @@ -0,0 +1,42 @@ +/* + * Copyright 2024 ACINQ SAS + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package fr.acinq.lightning.bin.db.serializers.v1 + +import fr.acinq.lightning.utils.UUID +import kotlinx.serialization.KSerializer +import kotlinx.serialization.Serializable +import kotlinx.serialization.descriptors.SerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder + + +object UUIDSerializer : KSerializer { + @Serializable + private data class UUIDSurrogate(val mostSignificantBits: Long, val leastSignificantBits: Long) + + override val descriptor: SerialDescriptor = UUIDSurrogate.serializer().descriptor + + override fun serialize(encoder: Encoder, value: UUID) { + val surrogate = UUIDSurrogate(value.mostSignificantBits, value.leastSignificantBits) + return encoder.encodeSerializableValue(UUIDSurrogate.serializer(), surrogate) + } + + override fun deserialize(decoder: Decoder): UUID { + val surrogate = decoder.decodeSerializableValue(UUIDSurrogate.serializer()) + return UUID(surrogate.mostSignificantBits, surrogate.leastSignificantBits) + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/json/JsonSerializers.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/json/JsonSerializers.kt new file mode 100644 index 0000000..b45bb1f --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/json/JsonSerializers.kt @@ -0,0 +1,92 @@ +@file:UseSerializers( + // This is used by Kotlin at compile time to resolve serializers (defined in this file) + // in order to build serializers for other classes (also defined in this file). + // If we used @Serializable annotations directly on the actual classes, Kotlin would be + // able to resolve serializers by itself. It is verbose, but it allows us to contain + // serialization code in this file. + JsonSerializers.SatoshiSerializer::class, + JsonSerializers.MilliSatoshiSerializer::class, + JsonSerializers.ByteVector32Serializer::class, + JsonSerializers.PublicKeySerializer::class, + JsonSerializers.TxIdSerializer::class, +) + +package fr.acinq.lightning.bin.json + +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.bitcoin.PublicKey +import fr.acinq.bitcoin.Satoshi +import fr.acinq.bitcoin.TxId +import fr.acinq.lightning.channel.states.ChannelState +import fr.acinq.lightning.channel.states.ChannelStateWithCommitments +import fr.acinq.lightning.db.LightningOutgoingPayment +import fr.acinq.lightning.json.JsonSerializers +import kotlinx.serialization.SerialName +import kotlinx.serialization.Serializable +import kotlinx.serialization.UseSerializers + +sealed class ApiType { + + @Serializable + data class Channel internal constructor( + val state: String, + val channelId: ByteVector32? = null, + val balanceSat: Satoshi? = null, + val inboundLiquiditySat: Satoshi? = null, + val capacitySat: Satoshi? = null, + val fundingTxId: TxId? = null + ) { + companion object { + fun from(channel: ChannelState) = when { + channel is ChannelStateWithCommitments -> Channel( + state = channel.stateName, + channelId = channel.channelId, + balanceSat = channel.commitments.availableBalanceForSend().truncateToSatoshi(), + inboundLiquiditySat = channel.commitments.availableBalanceForReceive().truncateToSatoshi(), + capacitySat = channel.commitments.active.first().fundingAmount, + fundingTxId = channel.commitments.active.first().fundingTxId + ) + else -> Channel(state = channel.stateName) + } + } + } + + @Serializable + data class NodeInfo( + val nodeId: PublicKey, + val channels: List + ) + + @Serializable + data class Balance(@SerialName("amountSat") val amount: Satoshi, @SerialName("feeCreditSat") val feeCredit: Satoshi) : ApiType() + + @Serializable + data class GeneratedInvoice(@SerialName("amountSat") val amount: Satoshi?, val paymentHash: ByteVector32, val serialized: String) : ApiType() + + @Serializable + sealed class ApiEvent : ApiType() + + @Serializable + @SerialName("payment_received") + data class PaymentReceived(@SerialName("amountSat") val amount: Satoshi, val paymentHash: ByteVector32) : ApiEvent() { + constructor(event: fr.acinq.lightning.PaymentEvents.PaymentReceived) : this(event.amount.truncateToSatoshi(), event.paymentHash) + } + + @Serializable + @SerialName("payment_sent") + data class PaymentSent(@SerialName("recipientAmountSat") val recipientAmount: Satoshi, @SerialName("routingFeeSat") val routingFee: Satoshi, val paymentHash: ByteVector32, val paymentPreimage: ByteVector32) : ApiEvent() { + constructor(event: fr.acinq.lightning.io.PaymentSent) : this( + event.payment.recipientAmount.truncateToSatoshi(), + event.payment.routingFee.truncateToSatoshi(), + event.payment.paymentHash, + (event.payment.status as LightningOutgoingPayment.Status.Completed.Succeeded.OffChain).preimage + ) + } + + @Serializable + @SerialName("payment_failed") + data class PaymentFailed(val paymentHash: ByteVector32, val reason: String) : ApiType() { + constructor(event: fr.acinq.lightning.io.PaymentNotSent) : this(event.request.paymentHash, event.reason.reason.toString()) + } + +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/bin/logs/FileLogWriter.kt b/src/commonMain/kotlin/fr/acinq/lightning/bin/logs/FileLogWriter.kt new file mode 100644 index 0000000..8a95b26 --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/bin/logs/FileLogWriter.kt @@ -0,0 +1,32 @@ +package fr.acinq.lightning.bin.logs + +import co.touchlab.kermit.* +import kotlinx.coroutines.CoroutineScope +import kotlinx.coroutines.channels.Channel +import kotlinx.coroutines.flow.consumeAsFlow +import kotlinx.coroutines.launch +import okio.FileSystem +import okio.Path +import okio.buffer + +class FileLogWriter(private val logFile: Path, scope: CoroutineScope, private val messageStringFormatter: MessageStringFormatter = DefaultFormatter) : LogWriter() { + private val mailbox: Channel = Channel(Channel.BUFFERED) + + override fun log(severity: Severity, message: String, tag: String, throwable: Throwable?) { + mailbox.trySend(messageStringFormatter.formatMessage(severity, Tag(tag), Message(message))) + throwable?.run { mailbox.trySend(stackTraceToString()) } + } + + init { + scope.launch { + val sink = FileSystem.SYSTEM.appendingSink(logFile).buffer() + mailbox.consumeAsFlow().collect { logLine -> + val sb = StringBuilder() + sb.append(logLine) + sb.appendLine() + sink.writeUtf8(sb.toString()) + sink.flush() + } + } + } +} \ No newline at end of file diff --git a/src/commonMain/kotlin/fr/acinq/lightning/cli/PhoenixCli.kt b/src/commonMain/kotlin/fr/acinq/lightning/cli/PhoenixCli.kt new file mode 100644 index 0000000..954e05f --- /dev/null +++ b/src/commonMain/kotlin/fr/acinq/lightning/cli/PhoenixCli.kt @@ -0,0 +1,194 @@ +package fr.acinq.lightning.cli + +import com.github.ajalt.clikt.core.CliktCommand +import com.github.ajalt.clikt.core.context +import com.github.ajalt.clikt.core.requireObject +import com.github.ajalt.clikt.core.subcommands +import com.github.ajalt.clikt.output.MordantHelpFormatter +import com.github.ajalt.clikt.parameters.options.* +import com.github.ajalt.clikt.parameters.types.int +import com.github.ajalt.clikt.parameters.types.long +import com.github.ajalt.clikt.sources.MapValueSource +import fr.acinq.bitcoin.Base58Check +import fr.acinq.bitcoin.Bech32 +import fr.acinq.bitcoin.ByteVector32 +import fr.acinq.lightning.bin.conf.readConfFile +import fr.acinq.lightning.bin.homeDirectory +import fr.acinq.lightning.payment.Bolt11Invoice +import io.ktor.client.* +import io.ktor.client.engine.cio.* +import io.ktor.client.plugins.auth.* +import io.ktor.client.plugins.auth.providers.* +import io.ktor.client.plugins.contentnegotiation.* +import io.ktor.client.request.* +import io.ktor.client.request.forms.* +import io.ktor.client.statement.* +import io.ktor.http.* +import io.ktor.serialization.kotlinx.json.* +import io.ktor.server.util.* +import kotlinx.coroutines.runBlocking +import kotlinx.serialization.json.Json + +fun main(args: Array) = + PhoenixCli() + .subcommands(GetInfo(), GetBalance(), ListChannels(), CreateInvoice(), PayInvoice(), SendToAddress(), CloseChannel()) + .main(args) + +data class HttpConf(val baseUrl: Url, val httpClient: HttpClient) + +class PhoenixCli : CliktCommand() { + private val datadir = homeDirectory / ".phoenix" + private val confFile = datadir / "phoenix.conf" + + private val httpBindIp by option("--http-bind-ip", help = "Bind ip for the http api").default("127.0.0.1") + private val httpBindPort by option("--http-bind-port", help = "Bind port for the http api").int().default(9740) + private val httpPassword by option("--http-password", help = "Password for the http api").required() + + init { + context { + valueSource = MapValueSource(readConfFile(confFile)) + helpFormatter = { MordantHelpFormatter(it, showDefaultValues = true) } + } + } + + override fun run() { + currentContext.obj = HttpConf( + baseUrl = Url( + url { + protocol = URLProtocol.HTTP + host = httpBindIp + port = httpBindPort + } + ), + httpClient = HttpClient(CIO) { + install(ContentNegotiation) { + json(json = Json { + prettyPrint = true + isLenient = true + }) + } + install(Auth) { + basic { + credentials { + BasicAuthCredentials("phoenix-cli", httpPassword) + } + } + } + } + ) + } +} + +class GetInfo : CliktCommand(name = "getinfo", help = "Show basic info about your node") { + private val commonOptions by requireObject() + override fun run() { + runBlocking { + val res = commonOptions.httpClient.get( + url = commonOptions.baseUrl / "getinfo" + ) + echo(res.bodyAsText()) + } + } +} + +class GetBalance : CliktCommand(name = "getbalance", help = "Returns your current balance") { + private val commonOptions by requireObject() + override fun run() { + runBlocking { + val res = commonOptions.httpClient.get( + url = commonOptions.baseUrl / "getbalance" + ) + echo(res.bodyAsText()) + } + } +} + +class ListChannels : CliktCommand(name = "listchannels", help = "List all channels") { + private val commonOptions by requireObject() + override fun run() { + runBlocking { + val res = commonOptions.httpClient.get( + url = commonOptions.baseUrl / "listchannels" + ) + echo(res.bodyAsText()) + } + } +} + +class CreateInvoice : CliktCommand(name = "createinvoice", help = "Create a Lightning invoice", printHelpOnEmptyArgs = true) { + private val commonOptions by requireObject() + private val amountSat by option("--amountSat").long() + private val description by option("--description", "--desc").required() + override fun run() { + runBlocking { + val res = commonOptions.httpClient.submitForm( + url = (commonOptions.baseUrl / "createinvoice").toString(), + formParameters = parameters { + amountSat?.let { append("amountSat", amountSat.toString()) } + append("description", description) + } + ) + echo(res.bodyAsText()) + } + } +} + +class PayInvoice : CliktCommand(name = "payinvoice", help = "Pay a Lightning invoice", printHelpOnEmptyArgs = true) { + private val commonOptions by requireObject() + private val amountSat by option("--amountSat").long() + private val invoice by option("--invoice").required().check { Bolt11Invoice.read(it).isSuccess } + override fun run() { + runBlocking { + val res = commonOptions.httpClient.submitForm( + url = (commonOptions.baseUrl / "payinvoice").toString(), + formParameters = parameters { + amountSat?.let { append("amountSat", amountSat.toString()) } + append("invoice", invoice) + } + ) + echo(res.bodyAsText()) + } + } +} + +class SendToAddress : CliktCommand(name = "sendtoaddress", help = "Send to a Bitcoin address", printHelpOnEmptyArgs = true) { + private val commonOptions by requireObject() + private val amountSat by option("--amountSat").long().required() + private val address by option("--address").required().check { runCatching { Base58Check.decode(it) }.isSuccess || runCatching { Bech32.decodeWitnessAddress(it) }.isSuccess } + private val feerateSatByte by option("--feerateSatByte").int().required() + override fun run() { + runBlocking { + val res = commonOptions.httpClient.submitForm( + url = (commonOptions.baseUrl / "sendtoaddress").toString(), + formParameters = parameters { + append("amountSat", amountSat.toString()) + append("address", address) + append("feerateSatByte", feerateSatByte.toString()) + } + ) + echo(res.bodyAsText()) + } + } +} + +class CloseChannel : CliktCommand(name = "closechannel", help = "Close all channels", printHelpOnEmptyArgs = true) { + private val commonOptions by requireObject() + private val channelId by option("--channelId").convert { ByteVector32.fromValidHex(it) }.required() + private val address by option("--address").required().check { runCatching { Base58Check.decode(it) }.isSuccess || runCatching { Bech32.decodeWitnessAddress(it) }.isSuccess } + private val feerateSatByte by option("--feerateSatByte").int().required() + override fun run() { + runBlocking { + val res = commonOptions.httpClient.submitForm( + url = (commonOptions.baseUrl / "closechannel").toString(), + formParameters = parameters { + append("channelId", channelId.toHex()) + append("address", address) + append("feerateSatByte", feerateSatByte.toString()) + } + ) + echo(res.bodyAsText()) + } + } +} + +operator fun Url.div(path: String) = Url(URLBuilder(this).appendPathSegments(path)) \ No newline at end of file diff --git a/src/commonMain/sqldelight/channelsdb/fr/acinq/phoenix/db/ChannelsDatabase.sq b/src/commonMain/sqldelight/channelsdb/fr/acinq/phoenix/db/ChannelsDatabase.sq new file mode 100644 index 0000000..222f689 --- /dev/null +++ b/src/commonMain/sqldelight/channelsdb/fr/acinq/phoenix/db/ChannelsDatabase.sq @@ -0,0 +1,48 @@ +import kotlin.Boolean; + +PRAGMA foreign_keys = 1; + +-- channels table +-- note: boolean are stored as INTEGER, with 0=false +CREATE TABLE IF NOT EXISTS local_channels ( + channel_id BLOB NOT NULL PRIMARY KEY, + data BLOB NOT NULL, + is_closed INTEGER AS Boolean DEFAULT 0 NOT NULL +); + +-- htlcs info table +CREATE TABLE IF NOT EXISTS htlc_infos ( + channel_id BLOB NOT NULL, + commitment_number INTEGER NOT NULL, + payment_hash BLOB NOT NULL, + cltv_expiry INTEGER NOT NULL, + FOREIGN KEY(channel_id) REFERENCES local_channels(channel_id) +); + +CREATE INDEX IF NOT EXISTS htlc_infos_idx ON htlc_infos(channel_id, commitment_number); + +-- channels queries +getChannel: +SELECT * FROM local_channels WHERE channel_id=?; + +updateChannel: +UPDATE local_channels SET data=? WHERE channel_id=?; + +insertChannel: +INSERT INTO local_channels VALUES (?, ?, 0); + +closeLocalChannel: +UPDATE local_channels SET is_closed=1 WHERE channel_id=?; + +listLocalChannels: +SELECT data FROM local_channels WHERE is_closed=0; + +-- htlcs info queries +insertHtlcInfo: +INSERT INTO htlc_infos VALUES (?, ?, ?, ?); + +listHtlcInfos: +SELECT payment_hash, cltv_expiry FROM htlc_infos WHERE channel_id=? AND commitment_number=?; + +deleteHtlcInfo: +DELETE FROM htlc_infos WHERE channel_id=?; \ No newline at end of file diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/ChannelCloseOutgoingPayments.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/ChannelCloseOutgoingPayments.sq new file mode 100644 index 0000000..b495f3e --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/ChannelCloseOutgoingPayments.sq @@ -0,0 +1,38 @@ +import fr.acinq.lightning.bin.db.payments.OutgoingPartClosingInfoTypeVersion; + +-- Store in a flat row outgoing payments standing for channel-closing. +-- There are no complex json columns like in the outgoing_payments table. +-- This table replaces the legacy outgoing_payment_closing_tx_parts table. +CREATE TABLE IF NOT EXISTS channel_close_outgoing_payments ( + id TEXT NOT NULL PRIMARY KEY, + recipient_amount_sat INTEGER NOT NULL, + address TEXT NOT NULL, + is_default_address INTEGER NOT NULL, + mining_fees_sat INTEGER NOT NULL, + tx_id BLOB NOT NULL, + created_at INTEGER NOT NULL, + confirmed_at INTEGER DEFAULT NULL, + locked_at INTEGER DEFAULT NULL, + channel_id BLOB NOT NULL, + closing_info_type TEXT AS OutgoingPartClosingInfoTypeVersion NOT NULL, + closing_info_blob BLOB NOT NULL +); + +insertChannelCloseOutgoing: +INSERT INTO channel_close_outgoing_payments ( + id, recipient_amount_sat, address, is_default_address, mining_fees_sat, tx_id, created_at, confirmed_at, locked_at, channel_id, closing_info_type, closing_info_blob +) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?); + +setConfirmed: +UPDATE channel_close_outgoing_payments SET confirmed_at=? WHERE id=?; + +setLocked: +UPDATE channel_close_outgoing_payments SET locked_at=? WHERE id=?; + +getChannelCloseOutgoing: +SELECT id, recipient_amount_sat, address, is_default_address, mining_fees_sat, tx_id, created_at, confirmed_at, locked_at, channel_id, closing_info_type, closing_info_blob +FROM channel_close_outgoing_payments +WHERE id=?; + +deleteChannelCloseOutgoing: +DELETE FROM channel_close_outgoing_payments WHERE id=?; diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/InboundLiquidityOutgoing.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/InboundLiquidityOutgoing.sq new file mode 100644 index 0000000..89b28e0 --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/InboundLiquidityOutgoing.sq @@ -0,0 +1,34 @@ +import fr.acinq.lightning.bin.db.payments.InboundLiquidityLeaseTypeVersion; + +-- Stores in a flat row payments standing for an inbound liquidity request (which are done through a splice). +-- The lease data are stored in a complex column, as a json-encoded blob. See InboundLiquidityLeaseType file. +CREATE TABLE IF NOT EXISTS inbound_liquidity_outgoing_payments ( + id TEXT NOT NULL PRIMARY KEY, + mining_fees_sat INTEGER NOT NULL, + channel_id BLOB NOT NULL, + tx_id BLOB NOT NULL, + lease_type TEXT AS InboundLiquidityLeaseTypeVersion NOT NULL, + lease_blob BLOB NOT NULL, + created_at INTEGER NOT NULL, + confirmed_at INTEGER DEFAULT NULL, + locked_at INTEGER DEFAULT NULL +); + +insert: +INSERT INTO inbound_liquidity_outgoing_payments ( + id, mining_fees_sat, channel_id, tx_id, lease_type, lease_blob, created_at, confirmed_at, locked_at +) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?); + +setConfirmed: +UPDATE inbound_liquidity_outgoing_payments SET confirmed_at=? WHERE id=?; + +setLocked: +UPDATE inbound_liquidity_outgoing_payments SET locked_at=? WHERE id=?; + +get: +SELECT id, mining_fees_sat, channel_id, tx_id, lease_type, lease_blob, created_at, confirmed_at, locked_at +FROM inbound_liquidity_outgoing_payments +WHERE id=?; + +delete: +DELETE FROM inbound_liquidity_outgoing_payments WHERE id=?; diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/IncomingPayments.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/IncomingPayments.sq new file mode 100644 index 0000000..c069c70 --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/IncomingPayments.sq @@ -0,0 +1,98 @@ +import fr.acinq.lightning.bin.db.payments.IncomingOriginTypeVersion; +import fr.acinq.lightning.bin.db.payments.IncomingReceivedWithTypeVersion; + +-- incoming payments +CREATE TABLE IF NOT EXISTS incoming_payments ( + payment_hash BLOB NOT NULL PRIMARY KEY, + preimage BLOB NOT NULL, + created_at INTEGER NOT NULL, + -- origin + origin_type TEXT AS IncomingOriginTypeVersion NOT NULL, + origin_blob BLOB NOT NULL, + -- this field is legacy, the amount received is the sum of the received-with parts + received_amount_msat INTEGER DEFAULT NULL, + -- timestamp when the payment has been received + received_at INTEGER DEFAULT NULL, + -- received-with parts + received_with_type TEXT AS IncomingReceivedWithTypeVersion DEFAULT NULL, + received_with_blob BLOB DEFAULT NULL +); + +-- Create indexes to optimize the queries in AggregatedQueries. +-- Tip: Use "explain query plan" to ensure they're actually being used. +CREATE INDEX IF NOT EXISTS incoming_payments_filter_idx + ON incoming_payments(received_at) + WHERE received_at IS NOT NULL; + +-- queries + +insert: +INSERT INTO incoming_payments ( + payment_hash, + preimage, + created_at, + origin_type, + origin_blob) +VALUES (?, ?, ?, ?, ?); + +updateReceived: +UPDATE incoming_payments +SET received_at=?, + received_with_type=?, + received_with_blob=? +WHERE payment_hash = ?; + +insertAndReceive: +INSERT INTO incoming_payments ( + payment_hash, + preimage, + created_at, + origin_type, origin_blob, + received_at, + received_with_type, + received_with_blob) +VALUES (?, ?, ?, ?, ?, ?, ?, ?); + +get: +SELECT payment_hash, preimage, created_at, origin_type, origin_blob, received_amount_msat, received_at, received_with_type, received_with_blob +FROM incoming_payments +WHERE payment_hash=?; + +getOldestReceivedDate: +SELECT received_at +FROM incoming_payments AS r +WHERE received_at IS NOT NULL +ORDER BY r.received_at ASC +LIMIT 1; + +listAllWithin: +SELECT payment_hash, preimage, created_at, origin_type, origin_blob, received_amount_msat, received_at, received_with_type, received_with_blob +FROM incoming_payments +WHERE created_at BETWEEN :from AND :to +ORDER BY + coalesce(received_at, created_at) DESC, + payment_hash DESC; + +listAllNotConfirmed: +SELECT incoming_payments.payment_hash, preimage, created_at, origin_type, origin_blob, received_amount_msat, received_at, received_with_type, received_with_blob +FROM incoming_payments +LEFT OUTER JOIN link_tx_to_payments + ON link_tx_to_payments.type = 1 + AND link_tx_to_payments.confirmed_at IS NULL + AND link_tx_to_payments.id = incoming_payments.payment_hash +WHERE received_at IS NOT NULL +; + +scanCompleted: +SELECT payment_hash, + received_at +FROM incoming_payments +WHERE received_at IS NOT NULL; + +delete: +DELETE FROM incoming_payments +WHERE payment_hash = ?; + +-- use this in a `transaction` block to know how many rows were changed after an UPDATE +changes: +SELECT changes(); diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/LinkTxToPayment.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/LinkTxToPayment.sq new file mode 100644 index 0000000..ad91f6a --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/LinkTxToPayment.sq @@ -0,0 +1,29 @@ +-- This table links an on-chain transaction to one/many incoming or outgoing payment +-- * tx_id => hex identifier of an on-chain transaction +-- * type => tracks the type of a payment. The value is an int as defined in the DbType enum +-- * id => the identifier of the payment, can be a payment hash (incoming) or a UUID (outgoing) +CREATE TABLE IF NOT EXISTS link_tx_to_payments ( + tx_id BLOB NOT NULL, + type INTEGER NOT NULL, + id TEXT NOT NULL, + confirmed_at INTEGER DEFAULT NULL, + locked_at INTEGER DEFAULT NULL, + PRIMARY KEY (tx_id, type, id) +); + +CREATE INDEX IF NOT EXISTS link_tx_to_payments_txid ON link_tx_to_payments(tx_id); + +listUnconfirmed: +SELECT DISTINCT(tx_id) FROM link_tx_to_payments WHERE confirmed_at IS NULL; + +getPaymentIdForTx: +SELECT tx_id, type, id FROM link_tx_to_payments WHERE tx_id=?; + +linkTxToPayment: +INSERT INTO link_tx_to_payments(tx_id, type, id) VALUES (?, ?, ?); + +setConfirmed: +UPDATE link_tx_to_payments SET confirmed_at=? WHERE tx_id=?; + +setLocked: +UPDATE link_tx_to_payments SET locked_at=? WHERE tx_id=?; diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/OutgoingPayments.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/OutgoingPayments.sq new file mode 100644 index 0000000..5221061 --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/OutgoingPayments.sq @@ -0,0 +1,228 @@ +import fr.acinq.lightning.db.HopDesc; +import fr.acinq.lightning.bin.db.payments.OutgoingDetailsTypeVersion; +import fr.acinq.lightning.bin.db.payments.OutgoingPartClosingInfoTypeVersion; +import fr.acinq.lightning.bin.db.payments.OutgoingPartStatusTypeVersion; +import fr.acinq.lightning.bin.db.payments.OutgoingStatusTypeVersion; +import kotlin.collections.List; + +PRAGMA foreign_keys = 1; + +-- outgoing payments +-- Stores an outgoing payment in a flat row. Some columns can be null. +CREATE TABLE IF NOT EXISTS outgoing_payments ( + id TEXT NOT NULL PRIMARY KEY, + recipient_amount_msat INTEGER NOT NULL, + recipient_node_id TEXT NOT NULL, + payment_hash BLOB NOT NULL, + created_at INTEGER NOT NULL, + -- details + details_type TEXT AS OutgoingDetailsTypeVersion NOT NULL, + details_blob BLOB NOT NULL, + -- status + completed_at INTEGER DEFAULT NULL, + status_type TEXT AS OutgoingStatusTypeVersion DEFAULT NULL, + status_blob BLOB DEFAULT NULL +); + +-- Create indexes to optimize the queries in AggregatedQueries. +-- Tip: Use "explain query plan" to ensure they're actually being used. +CREATE INDEX IF NOT EXISTS outgoing_payments_filter_idx + ON outgoing_payments(completed_at); + +-- Stores the lightning parts that make up a lightning payment +CREATE TABLE IF NOT EXISTS outgoing_payment_parts ( + part_id TEXT NOT NULL PRIMARY KEY, + part_parent_id TEXT NOT NULL, + part_amount_msat INTEGER NOT NULL, + part_route TEXT AS List NOT NULL, + part_created_at INTEGER NOT NULL, + -- status + part_completed_at INTEGER DEFAULT NULL, + part_status_type TEXT AS OutgoingPartStatusTypeVersion DEFAULT NULL, + part_status_blob BLOB DEFAULT NULL, + + FOREIGN KEY(part_parent_id) REFERENCES outgoing_payments(id) +); + +-- !! This table is legacy, and will only contain old payments. See ChannelCloseOutgoingPayment.sq for the new table. +-- Stores the transactions that close a channel +CREATE TABLE IF NOT EXISTS outgoing_payment_closing_tx_parts ( + part_id TEXT NOT NULL PRIMARY KEY, + part_parent_id TEXT NOT NULL, + part_tx_id BLOB NOT NULL, + part_amount_sat INTEGER NOT NULL, + part_closing_info_type TEXT AS OutgoingPartClosingInfoTypeVersion NOT NULL, + part_closing_info_blob BLOB NOT NULL, + part_created_at INTEGER NOT NULL, + + FOREIGN KEY(part_parent_id) REFERENCES outgoing_payments(id) +); + +-- A FOREIGN KEY does NOT create an implicit index. +-- One would expect it to, but it doesn't. +-- As per the docs (https://sqlite.org/foreignkeys.html): +-- > Indices are not required for child key columns but they are almost always beneficial. +-- > [...] So, in most real systems, an index should be created on the child key columns +-- > of each foreign key constraint. +CREATE INDEX IF NOT EXISTS parent_id_idx ON outgoing_payment_parts(part_parent_id); +CREATE INDEX IF NOT EXISTS parent_id_idx ON outgoing_payment_closing_tx_parts(part_parent_id); + +-- queries for outgoing payments + +hasPayment: +SELECT COUNT(*) FROM outgoing_payments +WHERE id = ?; + +insertPayment: +INSERT INTO outgoing_payments ( + id, + recipient_amount_msat, + recipient_node_id, + payment_hash, + created_at, + details_type, + details_blob) +VALUES (?, ?, ?, ?, ?, ?, ?); + +updatePayment: +UPDATE outgoing_payments SET completed_at=?, status_type=?, status_blob=? WHERE id=?; + +scanCompleted: +SELECT id, completed_at +FROM outgoing_payments +WHERE completed_at IS NOT NULL; + +deletePayment: +DELETE FROM outgoing_payments WHERE id = ?; + +-- queries for lightning parts + +countLightningPart: +SELECT COUNT(*) FROM outgoing_payment_parts WHERE part_id = ?; + +insertLightningPart: +INSERT INTO outgoing_payment_parts ( + part_id, + part_parent_id, + part_amount_msat, + part_route, + part_created_at) +VALUES (?, ?, ?, ?, ?); + +updateLightningPart: +UPDATE outgoing_payment_parts +SET part_status_type=?, + part_status_blob=?, + part_completed_at=? +WHERE part_id=?; + +getLightningPart: +SELECT * FROM outgoing_payment_parts WHERE part_id=?; + +deleteLightningPartsForParentId: +DELETE FROM outgoing_payment_parts WHERE part_parent_id = ?; + +-- queries for closing tx parts + +countClosingTxPart: +SELECT COUNT(*) FROM outgoing_payment_closing_tx_parts WHERE part_id = ?; + +insertClosingTxPart: +INSERT INTO outgoing_payment_closing_tx_parts ( + part_id, + part_parent_id, + part_tx_id, + part_amount_sat, + part_closing_info_type, + part_closing_info_blob, + part_created_at +) VALUES (:id, :parent_id, :tx_id, :amount_msat, :closing_info_type, :closing_info_blob, :created_at); + +-- queries mixing outgoing payments and parts + +getPaymentWithoutParts: +SELECT id, + recipient_amount_msat, + recipient_node_id, + payment_hash, + details_type, + details_blob, + created_at, + completed_at, + status_type, + status_blob +FROM outgoing_payments +WHERE id=?; + +getOldestCompletedDate: +SELECT completed_at +FROM outgoing_payments AS o +WHERE completed_at IS NOT NULL +ORDER BY o.completed_at ASC +LIMIT 1; + +getPayment: +SELECT parent.id, + parent.recipient_amount_msat, + parent.recipient_node_id, + parent.payment_hash, + parent.details_type, + parent.details_blob, + parent.created_at, + parent.completed_at, + parent.status_type, + parent.status_blob, + -- lightning parts + lightning_parts.part_id AS lightning_part_id, + lightning_parts.part_amount_msat AS lightning_part_amount_msat, + lightning_parts.part_route AS lightning_part_route, + lightning_parts.part_created_at AS lightning_part_created_at, + lightning_parts.part_completed_at AS lightning_part_completed_at, + lightning_parts.part_status_type AS lightning_part_status_type, + lightning_parts.part_status_blob AS lightning_part_status_blob, + -- closing tx parts + closing_parts.part_id AS closingtx_part_id, + closing_parts.part_tx_id AS closingtx_tx_id, + closing_parts.part_amount_sat AS closingtx_amount_sat, + closing_parts.part_closing_info_type AS closingtx_info_type, + closing_parts.part_closing_info_blob AS closingtx_info_blob, + closing_parts.part_created_at AS closingtx_created_at +FROM outgoing_payments AS parent +LEFT OUTER JOIN outgoing_payment_parts AS lightning_parts ON lightning_parts.part_parent_id = parent.id +LEFT OUTER JOIN outgoing_payment_closing_tx_parts AS closing_parts ON closing_parts.part_parent_id = parent.id +WHERE parent.id=?; + +listPaymentsForPaymentHash: +SELECT parent.id, + parent.recipient_amount_msat, + parent.recipient_node_id, + parent.payment_hash, + parent.details_type, + parent.details_blob, + parent.created_at, + parent.completed_at, + parent.status_type, + parent.status_blob, + -- lightning parts + lightning_parts.part_id AS lightning_part_id, + lightning_parts.part_amount_msat AS lightning_part_amount_msat, + lightning_parts.part_route AS lightning_part_route, + lightning_parts.part_created_at AS lightning_part_created_at, + lightning_parts.part_completed_at AS lightning_part_completed_at, + lightning_parts.part_status_type AS lightning_part_status_type, + lightning_parts.part_status_blob AS lightning_part_status_blob, + -- closing tx parts + closing_parts.part_id AS closingtx_part_id, + closing_parts.part_tx_id AS closingtx_tx_id, + closing_parts.part_amount_sat AS closingtx_amount_sat, + closing_parts.part_closing_info_type AS closingtx_info_type, + closing_parts.part_closing_info_blob AS closingtx_info_blob, + closing_parts.part_created_at AS closingtx_created_at +FROM outgoing_payments AS parent +LEFT OUTER JOIN outgoing_payment_parts AS lightning_parts ON lightning_parts.part_parent_id = parent.id +LEFT OUTER JOIN outgoing_payment_closing_tx_parts AS closing_parts ON closing_parts.part_parent_id = parent.id +WHERE payment_hash=?; + +-- use this in a `transaction` block to know how many rows were changed after an UPDATE +changes: +SELECT changes(); diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceCpfpOutgoingPayments.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceCpfpOutgoingPayments.sq new file mode 100644 index 0000000..77de7da --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceCpfpOutgoingPayments.sq @@ -0,0 +1,32 @@ +import fr.acinq.lightning.bin.db.payments.OutgoingPartClosingInfoTypeVersion; + +-- Store in a flat row the outgoing payments standing for a CPFP (which are done throuh a splice). +-- There are no complex json columns like in the outgoing_payments table. +CREATE TABLE IF NOT EXISTS splice_cpfp_outgoing_payments ( + id TEXT NOT NULL PRIMARY KEY, + mining_fees_sat INTEGER NOT NULL, + channel_id BLOB NOT NULL, + tx_id BLOB NOT NULL, + created_at INTEGER NOT NULL, + confirmed_at INTEGER DEFAULT NULL, + locked_at INTEGER DEFAULT NULL +); + +insertCpfp: +INSERT INTO splice_cpfp_outgoing_payments ( + id, mining_fees_sat, channel_id, tx_id, created_at, confirmed_at, locked_at +) VALUES (?, ?, ?, ?, ?, ?, ?); + +setConfirmed: +UPDATE splice_cpfp_outgoing_payments SET confirmed_at=? WHERE id=?; + +setLocked: +UPDATE splice_cpfp_outgoing_payments SET locked_at=? WHERE id=?; + +getCpfp: +SELECT id, mining_fees_sat, channel_id, tx_id, created_at, confirmed_at, locked_at +FROM splice_cpfp_outgoing_payments +WHERE id=?; + +deleteCpfp: +DELETE FROM splice_cpfp_outgoing_payments WHERE id=?; diff --git a/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceOutgoingPayments.sq b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceOutgoingPayments.sq new file mode 100644 index 0000000..52880e1 --- /dev/null +++ b/src/commonMain/sqldelight/paymentsdb/fr/acinq/phoenix/db/SpliceOutgoingPayments.sq @@ -0,0 +1,32 @@ +-- store a splice-out payment in a flat row +-- there are no complex json columns like in the outgoing_payments table +CREATE TABLE IF NOT EXISTS splice_outgoing_payments ( + id TEXT NOT NULL PRIMARY KEY, + recipient_amount_sat INTEGER NOT NULL, + address TEXT NOT NULL, + mining_fees_sat INTEGER NOT NULL, + tx_id BLOB NOT NULL, + channel_id BLOB NOT NULL, + created_at INTEGER NOT NULL, + confirmed_at INTEGER DEFAULT NULL, + locked_at INTEGER DEFAULT NULL +); + +insertSpliceOutgoing: +INSERT INTO splice_outgoing_payments ( + id, recipient_amount_sat, address, mining_fees_sat, tx_id, channel_id, created_at, confirmed_at, locked_at +) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?); + +setConfirmed: +UPDATE splice_outgoing_payments SET confirmed_at=? WHERE id=?; + +setLocked: +UPDATE splice_outgoing_payments SET locked_at=? WHERE id=?; + +getSpliceOutgoing: +SELECT id, recipient_amount_sat, address, mining_fees_sat, tx_id, channel_id, created_at, confirmed_at, locked_at +FROM splice_outgoing_payments +WHERE id=?; + +deleteSpliceOutgoing: +DELETE FROM splice_outgoing_payments WHERE id=?; diff --git a/src/jvmMain/kotlin/fr/acinq/lightning/bin/Actuals.kt b/src/jvmMain/kotlin/fr/acinq/lightning/bin/Actuals.kt new file mode 100644 index 0000000..0578e6b --- /dev/null +++ b/src/jvmMain/kotlin/fr/acinq/lightning/bin/Actuals.kt @@ -0,0 +1,24 @@ +package fr.acinq.lightning.bin + +import app.cash.sqldelight.db.SqlDriver +import app.cash.sqldelight.driver.jdbc.sqlite.JdbcSqliteDriver +import fr.acinq.phoenix.db.ChannelsDatabase +import fr.acinq.phoenix.db.PaymentsDatabase +import okio.Path +import okio.Path.Companion.toPath + +actual val homeDirectory: Path = System.getProperty("user.home").toPath() + +actual fun createAppDbDriver(dir: Path): SqlDriver { + val path = dir / "phoenix.db" + val driver = JdbcSqliteDriver("jdbc:sqlite:$path") + ChannelsDatabase.Schema.create(driver) + return driver +} + +actual fun createPaymentsDbDriver(dir: Path): SqlDriver { + val path = dir / "payments.db" + val driver = JdbcSqliteDriver("jdbc:sqlite:$path") + PaymentsDatabase.Schema.create(driver) + return driver +} diff --git a/src/nativeMain/kotlin/fr/acinq/lightning/bin/Actuals.kt b/src/nativeMain/kotlin/fr/acinq/lightning/bin/Actuals.kt new file mode 100644 index 0000000..ea24629 --- /dev/null +++ b/src/nativeMain/kotlin/fr/acinq/lightning/bin/Actuals.kt @@ -0,0 +1,27 @@ +package fr.acinq.lightning.bin + +import app.cash.sqldelight.db.SqlDriver +import app.cash.sqldelight.driver.native.NativeSqliteDriver +import fr.acinq.phoenix.db.ChannelsDatabase +import fr.acinq.phoenix.db.PaymentsDatabase +import kotlinx.cinterop.ExperimentalForeignApi +import kotlinx.cinterop.toKString +import okio.Path +import okio.Path.Companion.toPath +import platform.posix.getenv +import platform.posix.setenv + +@OptIn(ExperimentalForeignApi::class) +actual val homeDirectory: Path = setenv("KTOR_LOG_LEVEL", "WARN", 1).let { getenv("HOME")?.toKString()!!.toPath() } + +actual fun createAppDbDriver(dir: Path): SqlDriver { + return NativeSqliteDriver(ChannelsDatabase.Schema, "phoenix.db", + onConfiguration = { it.copy(extendedConfig = it.extendedConfig.copy(basePath = dir.toString())) } + ) +} + +actual fun createPaymentsDbDriver(dir: Path): SqlDriver { + return NativeSqliteDriver(PaymentsDatabase.Schema, "payments.db", + onConfiguration = { it.copy(extendedConfig = it.extendedConfig.copy(basePath = dir.toString())) } + ) +} \ No newline at end of file