Kuidas käivitada mikro-makse oma rakenduses

Eelmisel nädalal töötasin oma esimese avaliku rakenduse kallal – Telegrami-boti, mis toimib Bitcoin-rahakotina ja võimaldab "visata münte" teistele rühmachatide liikmetele ning teha väliseid Bitcoin-makse endale või teistele nn "Lightning Apps"-ile. Eeldan, et lugeja on üldiselt tuttav Bitcoin'i ja Telegram'i kontseptsioonidega, kuna püüan kirjutada lühidalt, ilma detailidesse süübimata. Bitcoin'i ressurside valik on saadaval siit, Telegram on aga mobiilseadmetes ja arvutites kasutatav kohese sõnumiveo rakendus, mis võimaldab platvormil luua oma väikesi rakendusi (chat-bote).

Millised on selle rakenduse peamised omadused?

• See võimaldab tänada või premeerida vestluspartnerit tõeliselt materiaalse väärtusega, mitte lihtsalt "virtuaalse meeldimise", see viib elektroonilise suhtluse täiesti uuele tasemele
• Reaalne näide rakendusest, mis suudab finantsiliselt suhelda teiste rakendustega, kasutades avatud makseprotokolli.
• Kogu rakenduse komponentideks on avatud lähtekoodiga projektid, mida saab muuta ja oma eesmärkideks kasutada. Rakendus ei kasuta suletud ega kommertsilahendusi, isegi kui see sobib e-kaubanduse valdkonda, mida on tänapäeval raske nimetada avatud.

Kuidas seda praktikas rakendada?

niimoodi…

või nii…

Mida need numbrid tähendavad? See on bitcoini üksused — satoshid. 2019. aasta keskpaiga börsihindade järgi on 1000 satoshit umbes 0,06 $. Satoshisid saab veebis kulutada või lihtsalt kohaliku valuuta vastu vahetada. Just sellepärast (likviidsuse tõttu) ei ole see lihtsalt järjekordne «kande andmebaasis» või «punkte, mida saate kulutada meie partnerite kauplustes», ja tõelised interneti raha.
*tahan kohe märkida, et mõningaid sõnu või väljendeid üritan teadlikult mitte vene keeles kirjutada — kas ei tea kontekstuaalset tõlget või arvan, et selline tõlge kõlab pigem eksitavalt kui õigesti.

Võib tekkida küsimus, kuidas sellist rakendust kasutada, kui bitcoine pole. Neid on lihtne osta vähestes kogustes ühel mitmest börsist või vahetusest, või saada sõbralt-bitcoini omanikult, või isegi saada münte praegustelt botikasutajatelt. Paljud telefonikoti rahakotid pakuvad võimalust osta bitcoine otse „äri tegemise kohalt”.

Kui oleme bitcoine (või pigem satoshis-ides(?)) omandanud — käivita @atomic_tipbot ja tee /deposit.

Bot küsib vastuseks, kui palju satoshit tasakaalu lisada ja saadab tasumiseks arve, mille saab mobiilirahakotiga maksta, skaneerides QR-koodi või vajutades nuppu („ava rahakotis”) arve lehel.

Kui oled makse oma rahakotis kinnitanud, saadab bot peaaegu kohe kinnituse makse kohta ja see kuvatakse visuaalselt arve raamis.

Kuni selle hetkeni oleme käsitlenud kahte rakenduse komponenti — back-end telegrami boti ja krüptovaluuta maksesüsteemi (peamiselt selle front-endi).

Telegrami boti loomiseks kasutasin Python Telegram Bot. Ja muidugi, bot ise on avatud lähtekoodiga.

Maksesüsteemi ja UX-ülesannete lahenduse valik langes (tõeliselt, valikut peaaegu pole) BTCPayServer, millele leidub dokumentatsioon sellel lingil.

Kui otsite maksesündmuste töötlemise lahendusi otse, tuleks tähelepanu pöörata Electrum CLI käsiraamatule niisuguste on-chain maksete jaoks, ja kiirete mikro-maksete (Lightning) jaoks lahendustele nagu Lightning-charge või Sparko.

Nii et kas see on isehostitud või mitte!?

Jah, nii on. Oma rakenduses kasutan tasuta BTCPayServeri hostimist — BTCPayJungle, kuid seda on täiesti võimalik teha ja see ei nõua palju aega, et käivitada oma maksesüsteem. Siiski tuleks arvestada, et teil on vaja umbes 500 GB vaba ruumi kõvakettal Bitcoin (ja Litecoin) plokkide salvestamiseks. Samuti on vajalikud arvutus- ja võrguresursside ajutine kasutamine sünkroonimise ajal ning sõltuvalt teie vajadustest vajalikud „ümbrikud” plokkide jaoks, et nendega mugavalt suhelda. BTCPayServer ei sisalda disaini tõttu privaatsüsteeme ega mingit muud teavet, mis võimaldaks teie rahakotti kontrollida.

On-chain (tavaliste) maksete jaoks on vaja lisada BTCPayServerisse rahakoti xpub-võti, et genereerida vastuvõtu aadresse (avalikke võtmeid). See muudab BTCPayServeri kasutamise isegi „jagatud” kujul võimalikkuks ja ohutuks. Kõik need xpub-võtmed ja aadressid on hõlpsasti kättesaadavad heades rahakottides nagu Electrum, et edasise töötlemise seadistamiseks.

Kõik, kes on Bitcoiniga kokku puutunud, on kuulnud, et Bitcoin on aeglane ja tehingud on kallid, eriti hype ajal; seetõttu on kohesteks mikro-makseteks mõistlik kasutada (off-chain) Lightning Networki tehinguid.

Mis on Lightning Network?

See on midagi nagu Bitcoini plugin, mis lisab täiendava abstraktsioonikihi ja võimaldab Bitcoinis teostada kohe ja praktiliselt tasuta tehinguid. Kõik see on võimalik tänu krüptograafilisele maagiale mitme allkiri, mida sageli nimetatakse nutikaks lepinguks. Lightning Networki protokolli on mitu teostust, mina kasutan c-lightning C keele teostust.

Peamine erinevus on-chain ja off-chain (Lightning) maksete vahel seisneb selles, kuidas need salvestatakse. Kõik on-chain tehingud edastatakse kõigi võrgu sõlmede kaudu, kuni üks Bitcoin node kuulutab need välja. uus kaevandatud blokk koos selles olevate tehingutega. (Habr's on isegi BitFury, nad toodavad kaevandamiseks vajalikku riistvara). Just sellepärast nimetame me selliseid tehinguid on-chain. Sellised tehingud kantakse üldisse plokiahelasse ja salvestatakse sinna senikaua, kuni see eksisteerib. Samuti on need tehingud avalikult kättesaadavad ja neid on võimalik jälgida, monitoorida ja analüüsida.

Juhul kui off-chain (Lightning) tehingud käivad kõik teisiti. Igal Lightning-võrgu sõlmel on üks (või rohkem) on-chain aadress — need on need tavalised Bitcoin'i aadressid, millest kõik algab. Kui sellisel aadressil ilmnevad Bitcoini, on võimalik avada nn. lightning kanal teise sõlme, mis tähendab, et nende kahe sõlme vahel on kokkulepe vahendite kättesaadavuse kohta kasutades krüptograafia tehnikaid. Hiljem salvestatakse kõik tehingud (nii oma kui ka kolmandate osapoolte sõlmede omanduses), mis käivad läbi sellise kanali, ainult tehingu osaliste sõlmedes (ja vahendajate sõlmedes). Ainsad tehingud, mis pannakse plokiahelasse, on kanalite avamise või sulgemise tehingud. Suuremas ulatuses moodustub selline omavahel ühendatud sõlmede võrgustik, mis loob osaliste vahel tuhandeid erinevaid teid, et „kanda“ vahendeid ühest sõlmest teise kindlate reeglite alusel. Peaaegu kõik sellised tehingud salvestatakse ainult sõlmede andmefailidesse. Just sellepärast nimetame me neid off-chain.

Diagrammil on visualiseeritud kõik rakenduse komendid.

Lühidalt:

1) Kasutaja saadab käsu botile Telegram

2) Telegram saadab sündmuse teate python rakendusele boti

3) python-rakendus saadab päringu BTCPayServer

4) BTCPayServer genereerib sisenevad BTC ja LTC aadressid ning saadab ka arve päringu lightning-charge, mis omakorda suhtleb deemoniga c-lightning. Me saame kauni HTML-pangemakse vormi

5) Kasutaja maksab arve ja näeb kinnitust

6) BTCPayServer saadetud arve makse teadet (IPN) määratud callback_url-ile, meie puhul callbacks.py (teine python rakendus teadete vastuvõtmiseks)

7) Tuginend saadud andmetele muutub kasutaja saldo

… ja kui kasutaja soovib raha välja võtta (sendi, mida ta teistelt sai) …

8) Python-rakendus bot ootab QR-koodi teksti või pilti ning kui kehtivad andmed saavad, toimub makse utiliidigapaylightning.py*, mis algatab tehingu c-lightning RPC kaudu.

*Õigusemõistmise nimel tuleb märkida, et minu paylightning.py wrapper ei ole täiesti lõpuni viidud ning võib anda vale-negatiivse tulemuse spetsiifilistes stsenaariumites. Soovitan kasutada hästi testitud wrapperit juhtudel, mis on lähedased tootmisreklaamile

Mida me saame? Meie boti kasutajad saavad rühmachat'is või otse edastada materiaalset väärtust ilma piiranguteta. Ja see ei ole veel kõik — tänu Lightning Network protokollile, mis teatud mõttes on ühtne ja lihtsustatud maksevõrk, on võimalik saata samu rahasid, mis on saadud vestluses, täiesti välistesse rakendustesse. Näiteks on Telegramis juba esmakordselt boti rakendatud bitcoini maksete jaoks — @lntxbot. "Üksikult saldo" võimaldab kasutada ükskõik millist roboti sõltuvalt konkreetse grupivestluse eelistustest (jah, probleem on täiesti tobe ja lahendus ei ole eriti kasulik, aga asi on olemuses). Üle kanda saldo ühest botist teise ei maksa midagi ja võtab vaid sekundeid! Oluline on märkida, et nende botide loojad ei ole kunagi omavahel suhtlenud.

On piisav lihtsalt edastada sõnum deposiidi taotlusega @lntxbot'ilt @atomic_tipbot'ile ja voila!

See ei ole enam lihtsalt „numbrite ülekandmine andmebaasidesse”, vaid makse kahe erineva, omavahel mitte seotud andmebaasi vahel. Seega on botisse integreeritud juba mitu „LAppi”, sealhulgas: sat2.io ja lnsms.world.

Mis tähendab LAppi integreerimine?

Iga Lightning Network Node on oma olemuselt Bitcoin-rahakott. Tal on kaks taset: on-chain ja off-chain. On-chain saldo on vajalik uute kanalite avamiseks ja vahendite hoidmiseks suletud kanalitest. Off-chain saldo on aga see, mis liigub kanalite vahel. Peamised nõuded nodedele on maksete vastuvõtmine ja saatmine, seega on igal nodil tarkvarana funktsioonid makse ja arve. Näitan, kuidas see toimub:

user@ln-node:/ % lightning-cli invoice 1000000000 internal_description external_description
{
   "payment_hash" : "64c0c8f5f8f708b08487ad1376f3d256f92ccb9606987ba395c2b4193efde5a0",
   "expires_at" : 1558709834,
   "bolt11" : "lnbc10m1pwdaj72pp5vnqv3a0c7uytppy845fhdu7j2mujejukq6v8hgu4c26pj0hauksqdpqv4u8getjdeskchmyv4ekxunfwp6xjmmwxqyjw5qcqp2rzjqw3qcrp2u3ggke56wrjlstcg76drmfw680cvjum88sl7ja7mpas7xzxz8sqqfecqqyqqqqlgqqqqqqgqjqn8e3ml733dkms2txxldnuwsllwhhkldss73268hdka3e7f083vjhjqurwqrndqd2rcd85pw7vkywnr4dq7yfd59r0g2mw4wzztwr6dcprxzej6"
}

Me saame «arve» spetsifikatsioonid BOLT11 selles juhul, mis on makseformaat Bitcoin (ja Litecoin, muide, ka) võrgust. See rida sisaldab teavet saaja, tehingu summa, päringu aegumisaeg jne, rohkem teavet saab, käivitades decodepay sellele reale:

user@ln-node:/ % lightning-cli decodepay lnbc10m1pwdaj72pp5vnqv3a0c7uytppy845fhdu7j2mujejukq6v8hgu4c26pj0hauksqdpqv4u8getjdeskchmyv4ekxunfwp6xjmmwxqyjw5qcqp2rzjqw3qcrp2u3ggke56wrjlstcg76drmfw680cvjum88sl7ja7mpas7xzxz8sqqfecqqyqqqqlgqqqqqqgqjqn8e3ml733dkms2txxldnuwsllwhhkldss73268hdka3e7f083vjhjqurwqrndqd2rcd85pw7vkywnr4dq7yfd59r0g2mw4wzztwr6dcprxzej6
{
   "currency" : "bc",
   "created_at" : 1558105034,
   "expiry" : 604800,
   "payee" : "025a14b8ed40583d67aec92da19453e0b2d1fbbf75f96f85d3dd0ff61a51ee0490",
   "msatoshi" : 1000000000,
   "amount_msat" : "1000000000msat",
   "description" : "external_description",
   "min_final_cltv_expiry" : 10,
   "routes" : [
      [
         {
            "pubkey" : "03a20c0c2ae4508b669a70e5f82f08f69a3da5da3bf0c973673c3fe977db0f61e3",
            "short_channel_id" : "574012x1255x1",
            "fee_base_msat" : 1000,
            "fee_proportional_millionths" : 1,
            "cltv_expiry_delta" : 144
         }
      ]
   ],
   "payment_hash" : "64c0c8f5f8f708b08487ad1376f3d256f92ccb9606987ba395c2b4193efde5a0",
   "signature" : "304502210099f31dffd18b6db8296637db3e3a1ffbaf7b7db087a2ad1eedb7639f25e78b25022079038370073681aa1e1a7a05de6588e98ead078896d0a37a15b755c212dc3d37"
}

Kuid selle «arve» tasumiseks on meil vaja c-lightning'i maksefunktsiooni:

user@ln-node:/ % lightning-cli pay lnbc2u1pwdana3pp5c0nyfgq974hr8huflt9uutyalj4maaw3q5594xp89jkvw74jme3sdql2pshjgr5dus8q6r0dejjqampd3kx2aqcqzpgwjgn45gy80jwjhgm3tpsxg33j6h6pehdus0mnjerrad943cz3vs83g30lyhlhfjxtqvtl76vttkuhs5jekuxpsqmf98l8265pwmm76gp4e7z6j
{
   "id" : 163,
   "payment_hash" : "c3e644a005f56e33df89facbce2c9dfcabbef5d105285a98272cacc77ab2de63",
   "destination" : "03021c5f5f57322740e4ee6936452add19dc7ea7ccf90635f95119ab82a62ae268",
   "msatoshi" : 200000,
   "amount_msat" : "200000msat",
   "msatoshi_sent" : 200003,
   "amount_sent_msat" : "200003msat",
   "created_at" : 1558106072,
   "status" : "complete",
   "payment_preimage" : "1a9552b9f4e9199e26839353f870b12cc85b7674a2fb134e78aa370032611019",
   "bolt11" : "lnbc2u1pwdana3pp5c0nyfgq974hr8huflt9uutyalj4maaw3q5594xp89jkvw74jme3sdql2pshjgr5dus8q6r0dejjqampd3kx2aqcqzpgwjgn45gy80jwjhgm3tpsxg33j6h6pehdus0mnjerrad943cz3vs83g30lyhlhfjxtqvtl76vttkuhs5jekuxpsqmf98l8265pwmm76gp4e7z6j"
}

Kõik tehingute staatused töödeldakse kogu võrgu ja teie enda node'i poolt. Ei ole vajalik (kuigi see on võimalik) suhelda makset vastuvõtteva rakenduse autoritega või nende API-dega teabe saamiseks makse seisundi kohta. Ei ole vaja kontrollida makse staatust vahendaja töötlemissektoris. Teie tehingu heakskiitu pangast või valitsusasutusest oodata ei tule. Lõppude lõpuks ei eksisteeri siin tagasimakseid ja muid väliseid tegureid, mis võivad mõjutada teie konto saldo. See on lahendus väärtuste edastamiseks interneti kaudu, ilma vajaduseta kolmanda osalise kohta, kes otsustab, kas tehing vastab reeglitele (mõnikord isegi sisemistele reeglitele, millest kõik osalised pole eelnevalt teavitatud) või mitte. Bitcoini puhul ei ole „sisemisi reegleid”. Ainsad reeglid, millele tuleb järgida, on võrgu reeglid - avatud ja kõigile tuntud.

See teeb võimalikuks otse, peaaegu tasuta ja hetkede rahalised tehingud inimeste või programmide vahel täielikult autonoomsel viisil.

Kui teil on võimalus saada makseandmeid kolmandalt rakenduselt, siis on teil võimalus selle rakendusega finantsiliselt suhelda. Näiteks võib tuua teenuse lnsms.world, mis võimaldab saata SMS-sõnumeid mis tahes numbrile, makstes selle eest bitcoiinidega. Selle rakenduse integreerimiseks peame lihtsalt edastama andmed veebivormist otse SMS-i saatmise skriptile — emuleerides kasutaja toiminguid veebisaidil:

payload = {                                                                                                                           
        'number': phone_number,
        'text': text,
        'force_unicode': 0
    }

    send_req = requests.post('https://lnsms.world/invoice', data=payload)
    if send_req.status_code == 201:
        plain_invoice = str(send_req.text)

Ma ei tea, mis põhjusel, kuid lnsms vastab 201 HTTP staatuse koodiga ja tagastab BOLT11 formaadis arve. See on piisav, et botikasutajad saaksid oma saldo eest, mis on saadud vestlusringides, SMS-sendimise eest maksta. Kasutaja ei tea isegi, mis toimub, ta lihtsalt maksab paar senti SMSi saatmise eest. Mina, kui arendaja, ei süvene SMS-teenuste töödetailidesse. Ma lihtsalt edastasin makse ja sain teenuse. Võin võtta tasu juurde, aga ei pruugi — see on minu vaba valik. Ei mingeid kontosid, lepinguid ega järgmisi APIsid tühiste ülesannete, nagu SMSide saatmine, jaoks.

Kujutame nüüd hetkeks, et meie rakendus on midagi kasulikumat kui juturobot ja teostab makseid mitte teisele botile, vaid teisele rakendusele või seadmele, mis on Internetiga ühendatud. Või isegi kümneid või isegi sadu tühiseid makseid iga sekundi jooksul seadmete, teenuste, poodide või mingite teenusepakkujate vahel. See on mikro-maksetes peituv tugevus, selline peaks olema asjade internet. Olemas on juba projektid nagu Althea mis transformatsioonide elluviimiseks, ja peagi näeme, minu arvates, suuri muutusi valdkonnas, mida praegu nimetame elektrooniliseks kaubanduseks.

Kui see postitus meeldis ja soovite proovida bitcoine tegevuses — saada mulle kruus õlut ja pehmeid prantsuse saiakesi..

Ainult registreeritud kasutajad saavad küsitluses osaleda. Logige sisse, palun.

Kas teid huvitavad puhtalt tehnilised artiklid bitcoini ja sellega seotud tarkvara kohta?

• Jah

• Ei

• Mind huvitavad rohkem krüptovaluutade turu aspektid.

Hääletas 8 kasutajat. 4 kasutajat ei hääletanud.

Allikas: habr.com