solana-action-express

solana actions server powered by node & express

this server package provides solana actions endpoints for solana blinks

official solana actions docs here:

https://solana.com/docs/advanced/actions

https://github.com/solana-developers/solana-actions

support for this repo: https://discord.gg/Z9bUEf8gYb

live example mcdegens donation blink powered by solana-action-express

https://actions.dialect.to/?action=solana-action:https://actions.mcdegen.xyz:8444/donate-config

install

please note this repo needs to run on a deployed server and will not run on localhost due to its ssl requirements.

clone the repo

git clone https://github.com/McDegens-DAO/solana-action-express.git

move the files

mv solana-action-express/* .

install dependencies

npm install

rpc

open the rpcs/helius.json file to configure

[
  {
    "name": "Helius 1",
    "wallet": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "url": "https://mainnet.helius-rpc.com/?api-key=bbbbbbbbbbbbbbbbbbbbbbbbbb"
  }
]

Move the rpcs folder somewhere safe. i.e. server root directory.

config

open the src/actions.js file to configure

// server settings
const https_port = 8444; //~ port 
const primary_app = ""; //~ https://mcdegen.xyz
const server_host = ""; //~ https://actions.mcdegen.xyz
const rpc_file = ""; //~ ../../../rpcs/helius.json
const rpc_id = 0; //~ default rpc selection from the file above
const ssl_crt = ""; //~ ../../../ssl/certs/YOUR_CERT_FILE.crt
const ssl_key = ""; //~ ../../../ssl/keys/YOUR_KEY_FILE.key
let tolerance = 1.2; //~ adds cu to txs in case the estimates are too low
let priority = "High"; //~ default tx priority

start

using node

node src/actions.js

using pm2

first time start
pm2 start src/actions.js

pm2 start actions

pm2 restart actions

pm2 stop actions

activate

actions.json

In the root of your primary app domain, create a file named: actions.json

Website: yourwebsite.xyz

Actions: yourwebsite.xyz/actions.json

Add the following:

{
  "rules": [
    {
      "pathPattern": "*",
      "apiPath": "https://{YOUR.SERVER.XYZ}:8444/donate-config"
    }
  ]
}

test

test with a rest client

// GET
https://{YOUR.SERVER.XYZ}:8444/donate-config

// RESPONSE
{
  "icon": "https://mcdegen.xyz/images/pfp-416.png",
  "title": "Donate to McDegens DAO",
  "description": "Enter an amount of SOL and click Send",
  "label": "donate",
  "links": {
    "actions": [
      {
        "label": "Send",
        "href": "https://{YOUR.SERVER.XYZ}:8444/donate-build?amount={amount}",
        "parameters": [
          {
            "name": "amount",
            "label": "SOL Amount"
          }
        ]
      }
    ]
  }
}

// POST
https://{YOUR.SERVER.XYZ}:8444/donate-build?amount=0.0001
// HEADER
Content-Type: application/json
// BODY
{
  "account": "7Z3LJB2rxV4LiRBwgwTcufAWxnFTVJpcoCMiCo8Z5Ere"
}

// RESPONSE
{
  "message": "success",
  "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQACBBnGd+L8/U/m08fITPXQGOahmsUckU1+h1l1w6wdS1fV5drn8eMSYo01r/hXR9BqB3/xXIqdxkHLJz9+Dyj5qLwDBkZv5SEXMv/srbpyw5vnvIzlu8X3EmssQ5s6QAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAL0icV3qd6kbI9BQYxRF5R0IpsALS3nvw4VClgV//oUQDAgAJA0CcAAAAAAAAAgAFAlgCAAADAgABDAIAAACghgEAAAAAAAA="
}

test on dialect

https://dial.to/?action=solana-action:https://{YOUR.SERVER.XYZ}:8444/donate-config

unfurling test

go to: https://dial.to

search: yourwebsite.xyz

if your blink is active it will load!

if not, use the browsers code inspector to debug

render on x

it's important to note that in order for a blink to render on x the page you are sharing on X (i.e. https://yourwebsite.xyz) must have twitter-card metatags. we use the following tags:

  <title>Page Title</title>
  <meta name="description" content="" />
  <meta name="twitter:card" content="summary_large_image" />
  <meta name="twitter:site" content="@xHandle" />
  <meta name="twitter:creator" content="@xHandle" />
  <meta name="twitter:title" content="" />
  <meta name="twitter:description" content="" />
  <meta name="twitter:image" content="" />
  <meta property="og:title" content="" />
  <meta property="og:image" content="" />
  <meta property="og:url" content="" />
  <meta property="og:description" content="" />

you can test that your page is twitter-card enabled using this tool:

https://www.bannerbear.com/tools/twitter-card-preview-tool/

actions registration

It is currently necessary to register the domain of your actions server or else your blinks will not render on x.

This is dialect's google form to request approval:

https://docs.google.com/forms/d/1YWt44VzqvSjJsvoqoOElPXnLmynABY2DS45UTVcm2a8/viewform

x users

users on x need to have a supporting wallet or the dialect extension to see the blinks. otherwise the post will default to the normal twitter-card.

supporting wallets/extensions

backpack

phantom (enable in settings under "experimental features")

solflare (soon)

dialect

kanema20 / solana-action-express