feat: solana-tools

Author: bjoerndotsol

commands/developer-utils/solana/images/solana-logo.png

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Required parameters:
+# @raycast.schemaVersion 1
+# @raycast.title Extract Transaction from Blink Response
+# @raycast.mode silent
+# @raycast.packageName Solana
+
+# Optional parameters:
+# @raycast.icon ./images/solana-logo.png
+
+# Documentation:
+# @raycast.description Extract transaction from Blink endpoint in clipboard and replaces with the transaction
+# @raycast.author bjoerndotsol
+# @raycast.authorURL https://github.com/bjoerndotsol
+
+# Get clipboard content
+input=$(pbpaste)
+
+# Check if "transactions" (plural) exists
+if echo "$input" | grep -q '"transactions"'; then
+    echo "❌ Error: Multiple transactions detected. This script only works with a single transaction."
+    exit 1
+fi
+
+# Extract transaction value using grep and sed
+transaction=$(echo "$input" | grep -o '"transaction"\s*:\s*"[^"]*"' | sed 's/"transaction"\s*:\s*"\([^"]*\)"/\1/')
+
+# Check if transaction was found
+if [ -z "$transaction" ]; then
+    echo "❌ Error: No transaction property found in the input."
+    exit 1
+fi
+
+# Copy transaction to clipboard
+echo "$transaction" | pbcopy
+
+# Show success message
+echo "✅ Transaction copied to clipboard!"

commands/developer-utils/solana/solana-tx-blink-extract.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+
+# Required parameters:
+# @raycast.schemaVersion 1
+# @raycast.title View Solana Transaction
+# @raycast.mode silent
+# @raycast.packageName Solana
+
+# Optional parameters:
+# @raycast.icon ./images/solana-logo.png
+# @raycast.argument1 { "type": "text", "placeholder": "Transaction Signature" }
+# @raycast.argument2 { "type": "text", "placeholder": "Network", "optional": true }
+
+# Documentation:
+# @raycast.description Opens a Solana transaction in Solscan. Network: empty/mainnet, d/dev/devnet, t/test/testnet
+# @raycast.author bjoerndotsol
+# @raycast.authorURL https://github.com/bjoerndotsol
+
+# Get transaction signature from first argument
+SIGNATURE="$1"
+
+# Get network parameter (optional, defaults to mainnet)
+NETWORK_PARAM=$(echo "$2" | tr '[:upper:]' '[:lower:]') # Convert to lowercase
+
+# Determine the network cluster based on the parameter
+if [[ -z "$NETWORK_PARAM" ]]; then
+    # Empty or not provided = mainnet
+    CLUSTER=""
+elif [[ "$NETWORK_PARAM" == d* ]]; then
+    # Starts with 'd' = devnet
+    CLUSTER="?cluster=devnet"
+elif [[ "$NETWORK_PARAM" == t* ]]; then
+    # Starts with 't' = testnet
+    CLUSTER="?cluster=testnet"
+else
+    # Default to mainnet for unrecognized input
+    CLUSTER=""
+fi
+
+# Construct the Solscan URL
+URL="https://solscan.io/tx/${SIGNATURE}${CLUSTER}"
+
+# Open the URL in the default browser
+open "$URL"
+
+echo "Opening transaction in Solscan: $URL"

commands/developer-utils/solana/solana-tx-details.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+
+# Required parameters:
+# @raycast.schemaVersion 1
+# @raycast.title Open in Solana Inspector
+# @raycast.mode silent
+# @raycast.packageName Solana
+
+# Optional parameters:
+# @raycast.icon ./images/solana-logo.png
+# @raycast.argument1 { "type": "text", "placeholder": "Signed transaction (base64)" }
+
+# Documentation:
+# @raycast.description Extracts the message from a signed Solana transaction and opens Explorer's Inspector with it.
+# @raycast.author bjoerndotsol
+# @raycast.authorURL https://github.com/bjoerndotsol
+
+# This script decodes a full signed Solana transaction (base64)
+# and reconstructs a Solana Explorer Inspector link.
+# Supports both legacy and versioned transactions.
+
+TX_BASE64=$(printf "%s" "$1" | tr -d '[:space:]')
+
+if [[ -z "$TX_BASE64" ]]; then
+  echo "❌ Please provide a base64-encoded transaction."
+  exit 1
+fi
+
+# Use Python to extract the message portion (skip signatures)
+MESSAGE_BASE64=$(python3 - "$TX_BASE64" <<'PY'
+import sys, base64, binascii, urllib.parse
+
+try:
+    tx_b64 = sys.argv[1]
+    b = base64.b64decode(tx_b64)
+except (binascii.Error, ValueError) as e:
+    print(f"Error decoding base64: {e}", file=sys.stderr)
+    sys.exit(1)
+
+# Transaction format:
+# [u8: num_signatures] [signatures * 64 bytes] [message...]
+# The message may start with a version byte (0x80 | version) for versioned transactions
+if not b or len(b) < 2:
+    print("Transaction too short", file=sys.stderr)
+    sys.exit(1)
+
+num_signatures = b[0]
+offset = 1 + num_signatures * 64
+
+if offset >= len(b):
+    print(f"Invalid transaction: offset {offset} >= length {len(b)}", file=sys.stderr)
+    sys.exit(1)
+
+# Extract message (includes version byte if present)
+msg = b[offset:]
+msg_b64 = base64.b64encode(msg).decode()
+
+# URL encode (double encoding for Explorer)
+encoded = urllib.parse.quote(msg_b64, safe='')
+print(encoded)
+PY
+)
+
+# Check if extraction failed
+if [[ $? -ne 0 ]] || [[ -z "$MESSAGE_BASE64" ]]; then
+  echo "❌ Could not extract transaction message."
+  exit 1
+fi
+
+# Dummy signature array for Inspector (Explorer only needs valid JSON)
+DUMMY_SIGS='["1111111111111111111111111111111111111111111111111111111111111111"]'
+ENCODED_SIGS=$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1]))" "$DUMMY_SIGS")
+
+URL="https://explorer.solana.com/tx/inspector?signatures=${ENCODED_SIGS}&message=${MESSAGE_BASE64}"
+
+open "$URL"
+echo "✅ Opening Solana Explorer Inspector"