pow

README

redpwnpow

A non-parallelizable proof of work challenge system

Install

To download, cache, and execute a binary to solve a PoW challenge in a single command, use:

curl -sSfL https://pwn.red/pow | sh -s challenge

Static binaries for Linux, Windows, and macOS are also available in GitHub releases.

If Go and libgmp are available, you can compile, install, and run with:

go install github.com/redpwn/pow/cmd/redpwnpow@latest
redpwnpow challenge

kCTF

redpwnpow can be used as a drop-in replacement for kCTF's proof of work solver.

Go module

Challenge example

package main

import (
	"bufio"
	"fmt"
	"os"

	"github.com/redpwn/pow"
)

func main() {
	c := pow.GenerateChallenge(5000)
	fmt.Printf("proof of work: curl -sSfL https://pwn.red/pow | sh -s %s\nsolution: ", c)
	s, _ := bufio.NewReader(os.Stdin).ReadString('\n')
	if good, err := c.Check(s); err == nil && good {
		fmt.Println("good")
	} else {
		fmt.Println("bad")
	}
}

Documentation

Index

• type Challenge
  • func DecodeChallenge(v string) (*Challenge, error)
  • func GenerateChallenge(d uint32) *Challenge
  • func (c *Challenge) Check(s string) (bool, error)
  • func (c *Challenge) Solve() string
  • func (c *Challenge) String() string

Types

type Challenge

type Challenge struct {
	// contains filtered or unexported fields
}

func DecodeChallenge

func DecodeChallenge(v string) (*Challenge, error)

DecodeChallenge decodes a redpwnpow challenge produced by String.

func GenerateChallenge

func GenerateChallenge(d uint32) *Challenge

GenerateChallenge creates a new random challenge.

func (*Challenge) Check

func (c *Challenge) Check(s string) (bool, error)

Check verifies that a solution proof from Solve is correct.

func (*Challenge) Solve

func (c *Challenge) Solve() string

Solve solves the challenge and returns a solution proof that can be checked by Check.

func (*Challenge) String

func (c *Challenge) String() string

String encodes the challenge in a format that can be decoded by DecodeChallenge.