go-salamoonder

Go library for working with Salamoonder API.

Installation

go get -u github.com/juanbrotenelle/go_salamoonder

Error Handling (NEW)

The library defines two error types and two sentinel values.

Type / Sentinel	When returned
*APIError	API responded with error_code != 0 (HTTP 200) or HTTP 400
*MethodError	CreateTask received an unsupported options type
ErrNoApiKey	New called with an empty API key
ErrUnsupportedTaskOptionsType	same as *MethodError, usable with errors.Is

APIError

*APIError carries the HTTP status code, task ID (when available), and the error message from the API.

• StatusCode == 200 — the request was valid, but the API service reported an internal failure (error_code == 1 in the response body).
• StatusCode == 400 — the request itself was invalid (wrong task parameters).

result, err := client.CreateTask(ctx, salamoonder.KasadaStandardOptions{Pjs: pjs})
if err != nil {
    var apiErr *salamoonder.APIError
    if errors.As(err, &apiErr) {
        switch apiErr.StatusCode {
        case 400:
            // Bad request — check your task parameters.
            log.Fatalf("invalid request: %s", apiErr.Msg)
        case 200:
            // Internal API error — safe to retry.
            log.Fatalf("api error for task %s: %s", apiErr.TaskId, apiErr.Msg)
        }
    }
    log.Fatal(err)
}

MethodError

Returned when an unsupported type is passed to CreateTask. Use errors.Is for a quick check and errors.As to inspect the actual type that was passed.

_, err := client.CreateTask(ctx, "oops")
if err != nil {
    if errors.Is(err, salamoonder.ErrUnsupportedTaskOptionsType) {
        var methodErr *salamoonder.MethodError
        if errors.As(err, &methodErr) {
            log.Fatalf("unsupported options type: %T", methodErr.OptionsValue)
        }
    }
}

Usage Examples

Get account balance

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/juanbrotenelle/go_salamoonder"
)

func main() {
	client, err := salamoonder.New("sr-YOUR-API-KEY", nil)
	if err != nil {
		log.Fatal(err)
	}

	balance, err := client.Balance(context.Background())
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(balance.Wallet) // 499.81070
}

Extract p.js from website

package main

import (
	"fmt"
	"log"

	"github.com/juanbrotenelle/go_salamoonder"
)

func main() {
	pjs, err := salamoonder.FindPJS("https://nike.com")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(pjs)
	// https://www.nike.com/149e9513-01fa-4fb0-aad4-566afd725d1b/2d206a39-8ed7-437e-a3be-862e0f06eea3/p.js
}

Create task and get result

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"

	"github.com/juanbrotenelle/go_salamoonder"
)

func main() {
	client, err := salamoonder.New("sr-YOUR-API-KEY", nil)
	if err != nil {
		log.Fatal(err)
	}

	result, err := client.CreateTask(context.Background(), salamoonder.KasadaOptions{
		Pjs:    "https://example.com/p.js",
		CdOnly: true,
	})
	if err != nil {
		log.Fatal(err)
	}

	taskResult, err := client.Task(context.Background(), result.TaskId)
	if err != nil {
		log.Fatal(err)
	}

	var solution salamoonder.KasadaSolution
	if err := json.Unmarshal(taskResult.Solution, &solution); err != nil {
		log.Fatal(err)
	}

	fmt.Println(solution.UserAgent) // Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
}

Polling task result

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"time"

	"github.com/juanbrotenelle/go_salamoonder"
)

func main() {
	client, err := salamoonder.New("sr-YOUR-API-KEY", nil)
	if err != nil {
		log.Fatal(err)
	}

	result, err := client.CreateTask(context.Background(), salamoonder.KasadaOptions{
		Pjs:    "https://example.com/p.js",
		CdOnly: true,
	})
	if err != nil {
		log.Fatal(err)
	}

	for {
		taskResult, err := client.Task(context.Background(), result.TaskId)
		if err != nil {
			log.Fatal(err)
		}

		if taskResult.Status == "ready" {
			var solution salamoonder.KasadaSolution
			if err := json.Unmarshal(taskResult.Solution, &solution); err != nil {
				log.Fatal(err)
			}
			fmt.Println(solution) // {xxx xxx xxx xx xxx xxx xxx 1704673650160}
			break
		}

		time.Sleep(2 * time.Second)
	}
}

Get result with generics

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/juanbrotenelle/go_salamoonder"
)

func main() {
	client, err := salamoonder.New("sr-YOUR-API-KEY", nil)
	if err != nil {
		log.Fatal(err)
	}

	result, err := client.CreateTask(context.Background(), salamoonder.KasadaOptions{
		Pjs:    "https://example.com/p.js",
		CdOnly: true,
	})
	if err != nil {
		log.Fatal(err)
	}

	taskResult, err := salamoonder.GetTaskResult[salamoonder.KasadaSolution](
		client,
		context.Background(),
		result.TaskId,
	)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(taskResult.Solution.UserAgent) // Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
}