fluent-pad/services

Use proto-distributor to upload and test services.

Build

Step-by-step:

• install fce if needed. Documentation
• build scripts and copy fresh artifacts to artifacts directory by a script:

cd services
./build.sh

Deploy

$ cd services
$ ./build.sh
$ cd artifacts
$ fldist new_service --modules history.wasm:history.json --name pad-history
    client seed: Fs6nQaGEsM5EgnprUbUtoLYWhUC8o6QK1gseP9pfhzUm
    client peerId: 12D3KooWH2hc6NAE2t6EE5SjmhTtce8VieUiKYNw4ynVCqV6jf6w
    node peerId: 12D3KooWBUJifCTgaxAUrcM9JysqCcS4CS8tiYH5hExbdWCAoNwb
    ...
    service id: 64ea579e-b863-4a42-b80c-e7b5ec1ab7fa
    service created successfully

$ fldist new_service --modules user-list.wasm:user-list.json --name pad-user-list
    client seed: HaBkus2i7bg6DmvxxSwizcxeo3xhvVJA9wLjyQji4mWc
    client peerId: 12D3KooWR4WGTieeectXFtJxgVqB8vvk3kn531rTdk4pwt4mBn5x
    node peerId: 12D3KooWBUJifCTgaxAUrcM9JysqCcS4CS8tiYH5hExbdWCAoNwb
    ...
    service id: 91041afe-0c3c-451a-9003-6bb92a570aae
    service created successfully

Service ids change on every service creation.

Set authorization info

We need to set tetraplet so history service knows which instance of user-list to trust.

script

(xor
    (seq
        (call relay ("op" "identity") [])
        (seq
            (call relay (history "set_tetraplet") [node userlist "is_authenticated" json_path] auth_result)
            (call %init_peer_id% (returnService "run") [auth_result])
        )
    )
    (call %init_peer_id% (returnService "run") [%last_error%])
)

Command:

fldist run_air -p scripts/set_tetraplet.air -d '{"node":"12D3KooWBUJifCTgaxAUrcM9JysqCcS4CS8tiYH5hExbdWCAoNwb", "userlist":"91041afe-0c3c-451a-9003-6bb92a570aae","history":"64ea579e-b863-4a42-b80c-e7b5ec1ab7fa", "json_path":"$.[\"is_authenticated\"]"}' -s Fs6nQaGEsM5EgnprUbUtoLYWhUC8o6QK1gseP9pfhzUm

Test

Let's create a new keypair of some user.

public  key a.k.a peer id = 12D3KooWSaSTAV7ftrN8f5UXkB9MYnFtdpAJpgUZbV7r2XpfVsF2
private key a.k.a seed    = G2r9BEsuaBHaDyMxGb2Bxv61PpH6r8UjKT564CdeU4BD

Let's add that user to userlist service: join script

(xor
    (seq
        (call relay ("op" "identity") [])
        (seq
            (call relay (userlist "join") [user] result)
            (call %init_peer_id% (returnService "run") [result])
        )
    )
    (call %init_peer_id% (returnService "run") [%last_error%])
)

Let's execute it, specifying user in -d as a JSON object

fldist run_air -p scripts/join.air -d '{"user":{"peer_id":"12D3KooWSaSTAV7ftrN8f5UXkB9MYnFtdpAJpgUZbV7r2XpfVsF2","relay_id":"","name":"some_name"}, "userlist":"91041afe-0c3c-451a-9003-6bb92a570aae"}' -s 7sHe8vxCo4BkdPNPdb8f2T8CJMgTmSvBTmeqtH9QWrar

That user can now be authorized and send messages! Let's try it

add message script

(xor
    (seq
        (call relay ("op" "identity") [])
        (seq
            (call relay (userlist "is_authenticated") [] status)
            (seq
                (call relay (history "add") [msg status.$.["is_authenticated"]!] auth_result)
                (call %init_peer_id% (returnService "run") [auth_result])
            )
        )
    )
    (call %init_peer_id% (returnService "run") [%last_error%])
)

Note that we provide private key via -s:

fldist -s G2r9BEsuaBHaDyMxGb2Bxv61PpH6r8UjKT564CdeU4BD run_air -p scripts/add_message.air -d '{"msg":"Hi there!", "userlist":"91041afe-0c3c-451a-9003-6bb92a570aae", "history":"64ea579e-b863-4a42-b80c-e7b5ec1ab7fa"}'

You can learn more about Aquamarine in the doc.