EVE Technology Lab

The previous thread closed, so I'm opening this one to announce the release of iveeCore 3.0!

Purpose and target audience

The goal of this project is to provide its users with a simple but powerful API to calculate industrial activities in EVE Online and get data such as bill of materials, activity costs and profits or skill requirements. iveeCore helps developers to quickly prototype their own scripts or develop full blown (web) applications without having to directly deal with the complexities and quirks of EvE's Static Data Export and CREST API.

iveeCore will likely be most useful for developers with at least basic PHP knowledge creating their own industry related or CREST powered tools.

These are a few example questions that can be answered with a few lines of code using iveeCore:

• "What is the profit of buying this item in Jita and selling in Dodixie?"
• "What do these items reprocess to? And what is it's volume sell value in Jita?"
• "How much does this EFT fit cost? How much is this scanned cargo worth?"
• "What is the job cost for building this item in this system? And if built in a POS in low sec?"
• "What is the total bill of materials and the minimum required skills to build these Jump Freighters?"
• "Is it more profitable to build the components myself or buy off the market?"
• "What is the total profit for copying this Blueprint, inventing with it, building from the resulting T2 BPC and selling the result?"
• "How do different Decryptors affect ISK/hour?"
• "How do Blueprint ME levels impact capital ship manufacturing profits?"
• "How much is a month of Unrefined Ferrofluid Reaction worth?"

The iveeCrest portion of the engine allows you to do things like:

• Access CREST endpoints for universe data (regions, constellations, systems, planets), inventory (types, groups, categories), live market data (orders and history), alliances, sovereignty, wars & killmails, alliance tournaments and industry related data.
• Read and write to the private character endpoints for fittings, contacts and navigation.

Technical features

• An API that strives to be "good", with high power-to-weight ratio
• Strong object oriented design and class model for inventory types
• Classes for representing manufacturing, copying, T2 & T3 invention, research and reaction activities, with recursive component building
• Realistic price estimation (based on CREST market order data), profit calculation & DB persistence
• Parsers for EFT-style and EvE XML ship fittings descriptions as well as cargo and ship scanning results
• Caching support for Memcached or Redis (via PhpRedis)
• Extensible via configurable subclassing
• A well documented and mostly PSR compliant codebase
• CLI tool for automated bulk market data updates

The CREST portion of the engine (formerly the iveeCrest library) can be used in conjunction with iveeCore or independently. Some of its features include:

• Aims to be feature-complete and do things "the CREST way" as much as possible
• Support for public and authenticated CREST including write access
• Object oriented model for navigating the CREST endpoint tree, mapping CREST responses to specific classes
• Gathering and re-indexing of multipage responses
• Supports parallel GET requests with asynchronous response processing
• Multilayer cache design
• Includes a self-contained web-script to retrieve a refresh token

DOWNLOAD
The repository with more information and documentation can be found here
https://github.com/aineko-m/iveeCore

Packagist:
https://packagist.org/packages/aineko-m/ivee-core

Feedback welcome!

Alright, 3.0.1 is out with the first set of changes to adapt to the Citadel release. Note that CREST is currently still exhibiting all sorts of ailments. In the coming weeks I'll be adding functionality to use all those new CREST capabilities.

Release notes for 3.0.1:

• Removed the distinction between public and authenticated CREST domains. Minor iveeCrest\Client API change.
• Implemented and started using the combined buy & sell market order CREST endpoint.
• Added all new authentication scopes to getrefreshtoken.php
• Minor fixes.

Hello

I posted an issue in github related 2016-06-14 EvE patch. Below copy of an issue.

https://github.com/aineko-m/iveeCore/issues/7



o/

After I took a development break due to RL, I'm back with the 3.0.3 release. The most important changes are the fixes for the recent CREST API breakage and support for the combined region-wide market order collection. The latter allows you to run complete eve-wide price update batches in about 12 minutes , but it is not enabled by default as it is quite memory intensive.

Version 3.0.3 - June 15th, 2016

---

This release adds support for new CREST endpoints and fixes issues that cropped up.

• Fixes for the June 14th CREST update.
• Added MarketOrderCollectionSlim for the new combined region-wide market order collection endpoint.
• The batch price update can use MarketOrderCollectionSlim, but since it is a memory intensive feature, it must manually be enabled in Config.
• Added classes for Stargate, Moon, Station, InsurancePrices, LoyaltyPoints, LoyaltyStoreOffers, NPCCorporations as well as Opportunity endpoints.
• Remove redundant CREST attributes from JSON ("_str") via regex before decode, which is much faster.
• Adapt getrefreshtoken to new login domain, warn about requesting too many auth scopes.
• A number of small fixes, improvements and removal of obsolete stuff.

I hadn't announced the 3.0.2 release, so here are the release notes for completeness:

Version 3.0.2 - April 30th, 2016

---

Release with bugfixes and minor improvements. The initial CREST issues post-Citadel release have been fixed by CCP. The current SDE is still missing industry data for some of the new items.

• Use new broker fee and transaction tax formulas.
• When no global price data is available for calculating product base cost (for instance new item) in Blueprint activities, use Jita buy price as approximation.
• Auto retry logic in CurlWrapper::asyncMultiget(), with abort on too many errors; also stop using the error callback. Some exception handling improvements.
• Fix multipage gathering for Collections where pageCount=0.
• Don't forget to mention DoctrineCacheWrapper in documentation.

I don't know the code in iveeCore but tend to keep everything Eve related as strings except when I have to use a number just because of PHP's lack of/spotty record for 64bit integers until very recently. Also better to treat anything ending in ID from CCP like 20 digit unsigned integer in DB until proven otherwise I've had many painful encounters during work with XML APIs when I've ignored that in Yapeal

RL is keeping me from working more on iveeCore, but here's a small update:

Version 3.0.4 - September 25th, 2016

---

• Added Corporation and CorporationStructuresCollection response classes.
• Minor changes that make iveeCore compatible with PHP 7.
• Reenable tournament scene data tests as CCP fixed the endpoints.
• Added new authentication scopes to getrefreshtoken script.
• Improved the logic behind the "huge" batch price update.