satkas 0.1.0__tar.gz

satkas-0.1.0/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

satkas-0.1.0/MANIFEST.in

@@ -0,0 +1,28 @@
+# Files needed to build / describe the source distribution
+include LICENSE
+include README.md
+include requirements.txt
+include pyproject.toml
+include setup.py
+
+# UI assets (also listed via setup.py package_data)
+recursive-include satkas *.kv
+recursive-include satkas *.png
+
+# Secrets and local artifacts
+exclude satkas/core/klib/wallet.proto
+exclude satkas/core/klib/wallet_pb2.py
+global-exclude *.env
+global-exclude *hidden_service_key*
+global-exclude satkas.db
+global-exclude *.db
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.egg-info
+global-exclude .DS_Store
+
+prune build
+prune dist
+prune venv
+prune .venv
+prune .cursor

satkas-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: satkas
+Version: 0.1.0
+Summary: Bitcoin-Kaspa Atomic Swap Utility
+Home-page: https://github.com/LordStapy/satkas
+Author: LordStapy
+License: LGPLv3
+Keywords: btc kas atomic-swap kivy p2p
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp==3.14.3
+Requires-Dist: aiohttp_socks==0.12.0
+Requires-Dist: asynckivy==0.6.4
+Requires-Dist: bip44==0.1.6
+Requires-Dist: bitcoin-utils==0.8.5
+Requires-Dist: bolt11==2.2.0
+Requires-Dist: certifi==2026.7.22
+Requires-Dist: coincurve==20.0.0
+Requires-Dist: grpcio==1.68.1
+Requires-Dist: inputimeout==1.0.4
+Requires-Dist: kivy==2.3.1
+Requires-Dist: materialyoucolor==3.0.4
+Requires-Dist: peewee==4.5.0
+Requires-Dist: pillow==12.3.0
+Requires-Dist: protobuf==5.28.1
+Requires-Dist: python-socks[asyncio]==2.5.1
+Requires-Dist: qrcode[pil]==8.0
+Requires-Dist: stem==1.8.2
+Provides-Extra: kivymd
+Requires-Dist: kivymd==2.0.0; extra == "kivymd"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+## 🔄 SatKas - a BTC-KAS Atomic Swap Platform
+
+### *Bridging Bitcoin and Kaspa Without Boundaries*
+
+---
+
+### Getting Started:
+
+**Requirements:** 
+
+- `tor` is required 
+- any LN wallet for receiving sats. **For sending payments, make sure the wallet displays the payment preimage**.
+- any Kaspa / Bitcoin wallet can be used. One-click payments are available for go-kaspawallet and bitcoind users.
+
+
+
+**Install:**
+
+Note: kivymd has a dependency on the [cairo graphics library](https://cairographics.org/), SatKas doesn't use widgets requiring cairo rendering and we can bypass it with the following commands:
+
+```
+# It's recommended to use a virtual environment
+python3 -m venv venv
+source venv/bin/activate
+# Install kivymd without dependencies
+pip3 install kivymd==2.0.0 --no-deps
+pip3 install satkas
+# The error complaining about the missing materialshapes is expected, it's the cairo one we bypassed
+```
+
+If you have cairo installed, you can directly run:
+
+```
+pip3 install 'satkas[kivymd]'
+```
+
+
+
+#### Start the UI app:
+
+```
+satkas
+```
+
+**SatKas is experimental software, test it with small amounts of KAS and sats!**
+
+Missing / limitations:
+
+- Example scripts were not updated, they are most likely broken.
+- P2P layer is not exposed to UI yet, makers are hardcoded.
+- UI is Taker only, Maker interface TBD.
+- DB is NOT encrypted, all configs (including passwords) are stored in plaintext.
+
+Swaps work in **both directions**, users can exchange:
+
+- Bitcoin (on-chain or LN) ---> KAS 
+- KAS ---> Bitcoin (on-chain or LN)
+
+---
+
+For feedback and suggestions: tag me in Kaspa Official Discord server or drop a message on Telegram (@LordStapy)

satkas-0.1.0/README.md

@@ -0,0 +1,61 @@
+## 🔄 SatKas - a BTC-KAS Atomic Swap Platform
+
+### *Bridging Bitcoin and Kaspa Without Boundaries*
+
+---
+
+### Getting Started:
+
+**Requirements:** 
+
+- `tor` is required 
+- any LN wallet for receiving sats. **For sending payments, make sure the wallet displays the payment preimage**.
+- any Kaspa / Bitcoin wallet can be used. One-click payments are available for go-kaspawallet and bitcoind users.
+
+
+
+**Install:**
+
+Note: kivymd has a dependency on the [cairo graphics library](https://cairographics.org/), SatKas doesn't use widgets requiring cairo rendering and we can bypass it with the following commands:
+
+```
+# It's recommended to use a virtual environment
+python3 -m venv venv
+source venv/bin/activate
+# Install kivymd without dependencies
+pip3 install kivymd==2.0.0 --no-deps
+pip3 install satkas
+# The error complaining about the missing materialshapes is expected, it's the cairo one we bypassed
+```
+
+If you have cairo installed, you can directly run:
+
+```
+pip3 install 'satkas[kivymd]'
+```
+
+
+
+#### Start the UI app:
+
+```
+satkas
+```
+
+**SatKas is experimental software, test it with small amounts of KAS and sats!**
+
+Missing / limitations:
+
+- Example scripts were not updated, they are most likely broken.
+- P2P layer is not exposed to UI yet, makers are hardcoded.
+- UI is Taker only, Maker interface TBD.
+- DB is NOT encrypted, all configs (including passwords) are stored in plaintext.
+
+Swaps work in **both directions**, users can exchange:
+
+- Bitcoin (on-chain or LN) ---> KAS 
+- KAS ---> Bitcoin (on-chain or LN)
+
+---
+
+For feedback and suggestions: tag me in Kaspa Official Discord server or drop a message on Telegram (@LordStapy)

satkas-0.1.0/pyproject.toml

@@ -0,0 +1,8 @@
+# Build backend only. Project metadata still lives in setup.py / satkas/__init__.py.
+# Do not add a [project] table here: it would duplicate (and conflict with) setup().
+# Do not add [tool.setuptools] either: current setuptools then validates an empty
+# [project] and fails with "project must contain ['version']".
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

satkas-0.1.0/requirements.txt

@@ -0,0 +1,20 @@
+aiohttp==3.14.3
+aiohttp_socks==0.12.0
+asynckivy==0.6.4
+bip44==0.1.6
+bitcoin-utils==0.8.5
+bolt11==2.2.0
+certifi==2026.7.22
+coincurve==20.0.0
+grpcio==1.68.1
+inputimeout==1.0.4
+kivy==2.3.1
+#kivymd==2.0.0  # kivymd is installed separately with --no-deps to avoid pycairo dependency
+materialyoucolor==3.0.4
+peewee==4.5.0
+#pexpect==4.9.0  # pexpect is only used by RustyKaspaWallet which is not really used
+pillow==12.3.0
+protobuf==5.28.1
+python-socks[asyncio]==2.5.1
+qrcode[pil]==8.0
+stem==1.8.2

satkas-0.1.0/satkas/__init__.py

@@ -0,0 +1,30 @@
+
+__name__ = 'satkas'
+__version__ = '0.1.0'
+__author__ = 'LordStapy'
+__license__ = 'LGPLv3'
+__url__ = 'https://github.com/LordStapy/satkas'
+__description__ = 'Bitcoin-Kaspa Atomic Swap Utility'
+__keywords__ = 'btc kas atomic-swap kivy p2p'
+__classifiers__ = [
+    'Development Status :: 3 - Alpha',
+    'Intended Audience :: Developers',
+    'License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3 :: Only',
+    'Programming Language :: Python :: 3.10',
+]
+__all__ = [
+    'main',
+    'core',
+    'ui',
+    'cli',
+    __name__,
+    __version__,
+    __author__,
+    __license__,
+    __url__,
+    __description__,
+    __keywords__,
+    __classifiers__
+]

satkas-0.1.0/satkas/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

satkas-0.1.0/satkas/cli/__init__.py

@@ -0,0 +1 @@
+from .cli import main

satkas-0.1.0/satkas/cli/cli.py

@@ -0,0 +1,41 @@
+# satkas/cli/cli.py
+"""Console entry point for the SatKas GUI.
+
+Supports:
+  satkas
+  satkas --peer <onion>
+  MAKER_ENDPOINT=<onion> satkas
+"""
+import os
+import sys
+
+# Before logging.basicConfig and before importing satkas.main / Kivy.
+os.environ["KIVY_NO_CONSOLELOG"] = "1"
+os.environ["KCFG_KIVY_LOG_LEVEL"] = "error"
+
+import argparse
+import logging
+
+logging.basicConfig(level=logging.INFO)
+
+
+def main():
+    # Must run before importing satkas.main — Kivy parses sys.argv at
+    # import time and rejects unknown options like --peer.
+    parser = argparse.ArgumentParser(prog="satkas")
+    parser.add_argument(
+        "--peer",
+        default=None,
+        help="Force a maker onion endpoint (sets MAKER_ENDPOINT)",
+    )
+    args, remaining = parser.parse_known_args()
+    if args.peer:
+        os.environ["MAKER_ENDPOINT"] = args.peer
+    sys.argv = [sys.argv[0]] + remaining
+
+    from satkas.main import main as satkas_main
+    satkas_main()
+
+
+if __name__ == "__main__":
+    main()

satkas-0.1.0/satkas/core/__init__.py

@@ -0,0 +1,9 @@
+
+__all__ = [
+    'blib',
+    'db',
+    'klib',
+    'p2p',
+    'services',
+    'swapper'
+]

satkas-0.1.0/satkas/core/blib/baddress.py

@@ -0,0 +1,12 @@
+
+import os
+
+from bitcoinutils.keys import PublicKey
+from bitcoinutils.setup import setup as btc_network_setup
+
+
+def p2wpkh_address(pubkey):
+    assert len(pubkey) == 33  # only compressed keys for P2WPKH
+    btc_network_setup(os.getenv('BTC_NETWORK', 'mainnet'))
+    pubkey = PublicKey(hex_str=pubkey.hex())
+    return pubkey.get_segwit_address()