solana actions server powered by node & express js
provides modular action endpoints for solana blinks
support: contact @SolDapper or McDegens Discord
featured at: Awesome Solana Blinks
our live mint blink: On Dialect
the default action for this repo is a usdc (or other spl) donation blink. however there is a sol donation action included as well.
installs and starts the server
*this command creates the your-projects/solana-action-express working directory
git clone https://github.com/McDegens-DAO/solana-action-express.git && cd solana-action-express && npm install && npm run actions
npm run actions
- create your new action file
touch src/actions/my_new_action.js
- include the new file into your actions.js
// *********************************************************************************
// include actions
import { my_new_action } from './actions/my_new_action.js';
app.use("/", my_new_action);
import { donation_sol } from './actions/donation_sol.js';
app.use("/", donation_sol);
import { donation_usdc } from './actions/donation_usdc.js';
app.use("/", donation_usdc);
// include actions
// *********************************************************************************
- build your new action module
src/actions/my_new_action.js
'use strict';
// *********************************************************************************
// sol donation action
import {rpc,host} from '../config.js';
import Express from 'express';
const my_new_action = Express.Router();
my_new_action.get('/my-new-action-config',(req,res)=>{
const obj = {}
obj.icon = "";
obj.title = "";
obj.description = "";
obj.label = "donate";
obj.links = {
"actions": [
{
"label": "Send",
"href": host+"/my-new-action-build?amount={amount}",
"parameters": [
{
"name": "amount", // input field name
"label": "SOL Amount", // text input placeholder
"required": true
}
]
}
]
}
res.json(obj);
});
// *********************************************************************************
// *********************************************************************************
// sol donation tx
my_new_action.route('/my-new-action-build').post(async function(req,res){
let error = false;
let message = false;
// validate inputs
if(typeof req.body.account=="undefined"){
error = true;
message = "user wallet missing";
}
else if(typeof req.query.amount=="undefined" || req.query.amount=="<amount>" || isNaN(req.query.amount)){
error = true;
message = "no amount defined";
}
if(error === true){
res.status(400).json({"message":message});
}
else{
try{
// create instructions
const lamports = req.query.amount * 1000000000;
const from = new PublicKey(req.body.account);
const to = new PublicKey("GUFxwDrsLzSQ27xxTVe4y9BARZ6cENWmjzwe8XPy7AKu");
const donateIx = SystemProgram.transfer({fromPubkey:from, lamports:lamports, toPubkey:to});
// build transaction
const _tx_ = {};
_tx_.rpc = rpc; // string : required
_tx_.account = req.body.account; // string : required
_tx_.instructions = [ donateIx ]; // array : required
_tx_.signers = false; // array : default false
_tx_.serialize = true; // bool : default false
_tx_.encode = true; // bool : default false
_tx_.table = false; // array : default false
_tx_.tolerance = 1.2; // int : default 1.1
_tx_.compute = false; // bool : default true
_tx_.fees = false; // bool : default true : helius rpc required when true
_tx_.priority = req.query.priority; // string : VeryHigh,High,Medium,Low,Min : default Medium
const tx = await mcbuild.tx(_tx_); // package the tx
tx.message = "You sent "+req.query.amount+" SOL!";
res.json(tx); // output
} catch (err) {
console.error(err);
res.status(500).json({ message: err.message });
}
}
});
export {my_new_action};
// *********************************************************************************
by default your "host" is localhost. when deploying your server live you must update the host setting in src/config.js to your live domain.
var host = "https://your-domain-name.com";
var auto = "donate-usdc-config";
heroku hosting conviennently allows you to auto deploy or manually deploy from your github repo with one click.
Although you can test locally on Dial.to and other tools, it's important to note that in order for a blink to render on x.com you must have:
- your actions deployed live on a fully qualified domain name.
- blinks must be enabled in your wallet settings.
- the page you're sharing must have twitter-card metatags.
we use the following metatags
<title>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="" />
<link rel="apple-touch-icon" href="" type="image/png">
<link rel="icon" href="" type="image/png">
you can test that your page is twitter-card enabled using this tool:
https://www.bannerbear.com/tools/twitter-card-preview-tool/
It is currently necessary to register the domain of your actions server or else your blinks will not render on x.
Dialect Action Registration: https://dial.to/register
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
phantom wallet (enable in settings under "experimental features") web store
solflare wallet web store
backpack wallet web store
dialect blinks web store
if the twitter-card metatags for your blink are located on a non-node website, blog, one the many oss ecom platforms, anything running on apache, you can use this php file in place of your actions.json to allow public access from blink clients without opening up cross domain requests to other files on your system. you will also need to add a RewriteRule in your your .htaccess file to route all requests for actions.json to the actions.php file.
actions.php
<?php header("Access-Control-Allow-Origin:*");header('Access-Control-Max-Age:86400');header('Content-Type:application/json');
header("Access-Control-Allow-Methods:GET");if(isset($_SERVER['HTTP_ACCESS_CONTROL_REQUEST_HEADERS'])){header("Access-Control-Allow-Headers:{$_SERVER['HTTP_ACCESS_CONTROL_REQUEST_HEADERS']}");}$response=new stdClass;$rules=array();$rule=new stdClass;
// define rules below
// ***************************************************************
// repeat for each rule
$rule->pathPattern = "/donate*";
$rule->apiPath = "https://www.your-domain.com/my-new-action-config";
$rules[] = $rule;
// ***************************************************************
// output data
$response->rules=$rules;echo json_encode($response);exit();
.htaccess
RewriteRule ^actions.json$ actions.php [L]
testing a request to yourwebsite.com/actions.json should respond with these headers
Date: Fri, 28 Jun 2024 00:21:13 GMT
Server: Apache
Access-Control-Allow-Origin: *
Access-Control-Max-Age: 86400
Access-Control-Allow-Methods: GET
Transfer-Encoding: chunked
Content-Type: application/json