readme.md

#!/bin/bash
echo "***Adi release for developers***"

git clone --branch v3.1.1 --depth 1 --single-branch https://code.prasaga.com/sagachain/configs.git
git clone --branch v3.1.1 --depth 1 --single-branch https://code.prasaga.com/sagachain/databases.git
git clone --branch v3.1.1 --depth 1 --single-branch https://code.prasaga.com/sagachain/sagascan-ui.git
git clone --branch v3.1.1 --depth 1 --single-branch https://code.prasaga.com/sagachain/sagascan-server.git
git clone --branch v3.1.1 --depth 1 --single-branch https://code.prasaga.com/sagachain/saga-bootstrap-node.git
SagaScan-UI
SagaChain viewer, offers a streaming display of latest blocks and transactions.
Block detail view with included transactions,
transaction details including executed script and results.
Blocks and transactions can be searched by hash.
Display overall statics and charts with blocks/s and transactions/s
Connects to the SagaScan-server web and websocket api.
In the future it will be expanded to display and modify accounts
and individual objects, submit transaction scripts and display node information
as well as additional statistics.

Run with Docker
To run the SagaScan-UI with Docker, please pull both this repo and sagascan-server
next to each other in the same directory.
Adjust the environment variables in the docker-compose.yml file to match your setup, especially the SAGA_NODE
which should point to the SagaChain node you want to connect to and the VITE_API variable to point to your SagaScan-server instance.
It will then be available on port 3000, e.g. http://localhost:3000 with the sagascan-server being called on http://localhost:3001 .

docker compose build

docker compose up


Installation
Alternatively you can run the SagaScan-UI directly on your server using the following commands.
Copy the default.env file to .env and adjust the VITE_API variable to point to your SagaScan-server instance.

npm install

npm run build

pm2 start .output/server/index.mjs


uses port 3000
Copy .env.default to .env and adjust VITE_API for the SagaScan-server URL

Example nginx config section for reverse proxy


        location / {
                proxy_pass http://localhost:3000;
                proxy_redirect     off;
                proxy_set_header   Host $host;
                proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header  X-Real-IP       $remote_addr;
        }
        location /_nuxt {
                root /home/ec2-user/sagascan-ui/.output/public/;
        }
        location /api {
                rewrite ^/api(.*)$ $1 break;

                proxy_pass http://localhost:3001;
                proxy_redirect     off;
                proxy_set_header   Host $host;
                proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header  X-Real-IP       $remote_addr;
        }
        location /api/ws {
                rewrite ^/api(.*)$ $1 break;

                proxy_pass http://localhost:3001;
                proxy_redirect     off;
                proxy_set_header   Host $host;
                proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header  X-Real-IP       $remote_addr;

                proxy_set_header Upgrade $http_upgrade;
                proxy_set_header Connection "upgrade";
        }
Web and websocket api server for the SagaScan-UI and as basis for external projects to access SagaChain. Streams recent blocks and contained transactions via websocket by connecting to a SagaChain Node via GRPC. Also stores the data in a mongoDb database for indexing and later retrieval via hash or block id.
In the future additional elements will be made available, e.g. nodes, accounts, objects, as well as the ability to filter by account, etc. Also the ability to submit transactions will be added.
API documentation to follow. Client library reference implementations will be provided.
The .proto files are copied from the repo saga-pbtypes.
Environment variables (.env file)
SAGA_NODE defaults to localhost:5080
Uses mongodb with DB_URL defaulting to mongodb://localhost:27017/sagachain. Set USE_DB=0 to disable mongodb, useful for debugging. While debugging nodes to handle block resets set DETECT_RESTARTS=1
To init the db see mongo.txt , to reset db use mongosh \< resetDb.js
For example nginx setup see the frontend repo sagascan-ui.
npm install
npm run dev
ec2-user@50.18.65.58     Node1
#ec2-user@54.215.87.20    Node2
ec2-user@54.176.27.64    Node3
ec2-user@3.101.67.251    Node4
localhost        Node2
ec2-user@3.101.86.194   Node5
Node1
Node2 1 2 3 5 6
Node3
Node4 9 10 11 13 14 15
Node5 4 7 8 12 16
# command to retrieve the hosts externally visible IP address
# if using AWS ec2, following command works. Replace for other platforms
export EXT=$(ec2-metadata -v --quiet)":$p4"
export LOC=$(ec2-metadata -R --quiet)
echo "- $EXT $LOC"
__main__.py - usage:

--help                      display this help message
--first-operand             <filename of transaction script> is required, plus optional switches
-o ARG --outfile ARG        processes transaction script output file
-s ARG --sig ARG            signing key
-p ARG --SPIMPORTPATH ARG   Set import path for sagapython doimport(). default uses environment variable by same name
Usage of ./saga-outside-client:
-address string
    domain or ip with port of server listener. eg:127.0.0.1:50051
-file string
    file path
def __hdr():
    newacct = doimport('newaccountloid.py')
    CMIImport('newacct', 'newacct', '*')

    hdr = { 'accts': NewAccountLOID,
            'seq': 1000,        # whatever the next sequence number is
                'maxGU': 10,
                'feePerGU': 1,
                'extraPerGU': 2,
        'primaryAccount': NewAccountLOID,
        'nonce': 0,
        }
    return hdr