It's my pleasure to announce I'm working on a tool named EZ-stellarshare that will assist anyone in the process of paying "lumen dividend" to known or unknown investors using the Stellar network!

Following the creation of two custom assets (GTT and GTTpresale1, check my previous posts) both backed by real EUR, I realized that all Stellar users could benefit from new software tools aimed at ICO creators, asset issuers, entrepreneurs, etc.

What will the service look like? Three simple steps:

  1. you designate a custom asset existing on the Stellar network; its units will play the role of shares, just like in a company. Optionally you specify an ignore list (1…N stellar accounts to be ignored)
  2. you provide a temporary Stellar account containing funds (lumen) you wish to distribute
  3. the software takes care of paying the lumen dividend, that is the lumen amount ought to be paid to each custom asset owner based on how much he/she owns

Placeholder for additional explanation / source-code:
https://github.com/wkta/ez-stellarshare

8 days later

Hello, I'm curious, I was looking at how to give dividends to tokens holders, as far as I know, there is no way to do that with the horizon API right?
I got confused with that: https://www.stellar.org/blog/using-stellar-for-ico/
"Stellar offers built-in token capabilities that can support multi-signature authorizations, generate dividends, limit who can hold tokens, and more."
But it seems most of these feature are not native and need to be built, am I right?

Thx! ?

  • wkta replied to this.

    arvi89 Thx for your comment.
    Brief answer > you are right!

    My answer is not 100% sure but here are several arguments that support it:
    1. I checked the Horizon API Reference doc for a substantial amount of time and found nothing about a built-in dividend payment mechanism
    2. if you read the same page https://www.stellar.org/blog/using-stellar-for-ico/ a bit further, in part 3) titled "create custom ICOs"
    the author reformulates:
    "For instance, issuing dividends, bonds, escrow, collateralized debt, inflation, and the Lightning network are all possible on the Stellar network."
    "are all possible" expresses more clearly the fact that it can be built in theory, but that it isn't built-in and ready-to-use now…
    3. rumors exist that some assets circulating on the Stellar Network already feature a dividend payment mechanism but I found no proof of this claim after looking up numerous custom assets using Stellar.expert (an example: the project "eSACCO Plus" that won the 5th build challenge introduces a token named ESDT for eSACCO Dividend Token but its creators admit that first dividends will be paid only
    "on 27 July 2019 and then annually thereafter",
    source: https://stellar.expert/explorer/public/asset/ESDT-GDPQRGW5VNJU63L6R573S65DW4XSJZEXPH4IG5EMJBQD3QUCXSLVFW7A )
    4. The word "dividend" doesn't appear once in this post by @jed
    https://galactictalk.org/d/14-projects-built-on-stellar

    In conclusion:
    automated or semi-automated dividend XLM payment has probably never been performed via Stellar at this point. The community simply lacks a convenient tool to do it!
    I hope I will manage to fill this gap ?

    6 days later

    Hello ?

    With a friend we have a project where we might want something like that, maybe we can help you with the development?

    Thx! ?

    • wkta replied to this.

      arvi89 hey, the tool has already been coded!

      I invite you to test it and share your thoughts. Would you? ?
      Test procedure:
      1/ go to: https://gaudia-tech.com/ez-stellarshare
      2/ grab all examples: https://github.com/wkta/ez-stellarshare/tree/master/example
      Two text files are required as inputs for the software. Typically, you list every asset holder in the 1st file and ignore some of them in the 2nd. The 2nd file can be empty and often is. Account lists can be easily copied-paste from the stellar.expert website (lookup a custom asset then click asset holders).
      3/ create (manually) a temporary Stellar account with a small amount on it (try 4 XLM). You can use the Stellar laboratory to do so.
      4/ give access to that temporary account that will be "consumed" by the software. Check how EZ-stellarshare splits the amount, and if the distribution looks good to you (small fees included) click YES.
      Here go the "dividends"! (slow process though, be patient)

      Important update: EZ-stellarshare has been successfully submitted for the 6th SBC!

      The 1st token in the world to harness the power of the EZ-stellarshare tool is the GTshare.
      (issuer: GBOTNDWSQLVKI4RARHVIYMBM4FBJJXSQ7FH6EGJWQU24M2SBFH7CAR7A)

      That unique token, tradable via the SDEX, generates on the 1st day of each month some XLM dividends shared among all GTshare owners. Check my other post GTshare token AirDrop to learn more / get a free GTshare unit!

      I actually need something more automated, that gets data directly (where I don't need to input addresses in txt files by myself).

      But it's ok, by getting directly from the database I can get everything I can and I can build a small API for the dividends things ?

      a year later